Lakebed Native [alpha]

CLI Reference

npx lakebed-native new [name] [--template todo] [--no-git]   # suggests agent-device when missing
npx lakebed-native create [name] [--template todo] [--no-git]
npx lakebed-native dev [capsule-dir] [--port 3000] [--native-port 3100]
npx lakebed-native auth as <name>
npx lakebed-native auth reset
npx lakebed-native db list [deploy-id-or-url] [--port 3000] [--json]
npx lakebed-native db dump [deploy-id-or-url] [--port 3000] [--json]
npx lakebed-native logs [deploy-id-or-url] [--port 3000] [--json]
npx lakebed-native inspect [deploy-id-or-url] [--port 3000] [--json]
npx lakebed-native devices [--json]
npx lakebed-native open [--device <id>] [--url <url>]
npx lakebed-native screenshot [--device <id>] [--out screenshot.png]
npx lakebed-native tree [--device <id>] [--json]
npx lakebed-native build [capsule-dir] --target native-preview [--out path] [--json]
npx lakebed-native deploy [capsule-dir] [--api url] [--public-inspect] [--json]
npx lakebed-native pack [capsule-dir] [--platform android|ios] [--device] [--cloud] [--shell-ipa path] [--shell-apk path] [--shell-app path] [--api url] [--no-deploy]
npx lakebed-native apple setup | status | guide | fetch-shell-ipa | build [--cloud|--local] [--wait]
npx lakebed-native apple devices register | list
npx lakebed-native cloud status | build --platform ios [--wait] [--local] [--force]
npx lakebed-native claim [capsule-dir] [--api url] [--json]
npx lakebed-native build-native --platform ios|android|all [--profile preview|production] [--json]
npx lakebed-native submit --platform ios|android|all [--profile preview|production] [--json]
npx lakebed-native shell build --platform ios|android [--profile simulator|development|production] [--json]
npx lakebed-native shell install --platform ios|android [--device id] [--json]
npx lakebed-native shell fetch [--platform android|ios|all] [--json]

Standalone pack (recommended)

Swap a capsule JS bundle into the universal shell — seconds, not minutes:

# Download universal shell (recommended):
npx lakebed-native shell fetch

# Or build from source (maintainers):
npm run shell:android
npm run shell:ios

npx lakebed-native pack demo-todo --platform android --api http://localhost:4000
adb install -r demo-todo/.lakebed-native/artifacts/todo-standalone.apk

npx lakebed-native pack demo-todo --platform ios --api http://localhost:4000
xcrun simctl install booted demo-todo/.lakebed-native/artifacts/todo-standalone.app

# Physical iPhone — register ALL devices before first cloud build (36h cooldown)
npx lakebed-native apple setup
npx lakebed-native apple devices register
npx lakebed-native cloud build --platform ios --wait && npx lakebed-native apple fetch-shell-ipa
npx lakebed-native pack demo-todo --platform ios --device --api $LAKEBED_HOSTED_API

Set LAKEBED_HOSTED_API for production Lakebed hosted (shared backend with web apps).

Local dev workflow

  1. npx lakebed-native new my-app --template todo
  2. cd my-app && npx lakebed-native dev
  3. Build shell: cd shell && npx expo run:ios
  4. Open capsule: npx lakebed-native open --url "lakebed-native://capsule?server=http://localhost:3000&bundle=http://localhost:3100"

Auth presets

alice, bob, guest — for local multi-user testing.