Lakebed Native Cloud

Lakebed Native Cloud is maintainer infrastructure only — not a replacement for Lakebed hosted.

What runs where

Concern	Where	Command
Capsule API + DB + deploy	Lakebed hosted (normal Lakebed)	`lakebed-native deploy --api $LAKEBED_HOSTED_API`
Dev / hot reload	Your machine	`lakebed-native dev`
Simulator `.app` / Android APK pack	Your machine (template shell)	`lakebed-native pack`
Physical iPhone IPA	Lakebed Native Cloud	`lakebed-native cloud build --platform ios`
Apple certs & profiles	Your Apple Developer + Lakebed Native signing	`lakebed-native apple setup`

Cloud API (this deployment)

GET  /api/health
POST /api/builds          { "platform": "ios", "profile": "device-preview" }
GET  /api/builds/:id      poll build status + artifact URL

Set LAKEBED_NATIVE_CLOUD=https://lakebednative.xyz in CLI (default).

Cloud device build policy

Builds the universal shell only (~12 min). Capsule UI updates are deploy + OTA — not native rebuilds.
36-hour cooldown per Apple team (EXPO_APPLE_TEAM_ID / EAS project).
Register all devices first with lakebed-native apple devices register before cloud build.
If your registered device set is unchanged, the CLI refuses a rebuild — reinstall the previous IPA or run apple fetch-shell-ipa.
--force bypasses the cooldown when you added UDIDs and must rebuild sooner.

Physical iPhone flow

Deploy capsule to Lakebed hosted (not Native Cloud):

npx lakebed-native deploy --api https://hosted.lakebed.dev

Configure your Apple credentials:

npx lakebed-native apple setup
npx lakebed-native apple devices register

Cloud build:

npx lakebed-native cloud build --platform ios

Install IPA from the build artifact URL when finished.

Environment (Vercel — maintainers)

Secret	Purpose
`EXPO_TOKEN`	Internal build service account (not exposed to capsule authors)
`NATIVE_CLOUD_BUILD_SECRET`	Shared secret; CLI sends `Authorization: Bearer …` via `LAKEBED_NATIVE_CLOUD_BUILD_SECRET`

Users do not send Apple passwords to Lakebed Cloud. Apple auth goes through apple setup during CLI onboarding.

Docs & agents

/llms.txt — compact index
/docs/* — human docs