Getting started

Lakebed Native uses the same Lakebed hosted backend as web capsules. You write a capsule, deploy to api.lakebed.dev, and ship UI updates over the air — after a one-time universal shell install on device.

1. Create a capsule

npx lakebed-native new my-app --template todo
cd my-app

Agents: agent-device helps LLMs drive simulators and physical devices while coding (npm install -g agent-device). lakebed-native new suggests it when not installed.

2. Local dev

npx lakebed-native dev

Install a dev or standalone shell once, then open the deep link printed by dev (or use lakebed-native open --url …).

3. Deploy to Lakebed hosted (production)

npx lakebed-native build --target native-preview
npx lakebed-native deploy --api https://api.lakebed.dev

You get a *.lakebed.app URL. The native RN bundle is served as client.js — same OTA model as web Lakebed.

4. Standalone app (one-time shell)

Download the universal shell (no monorepo clone required):

npx lakebed-native shell fetch --platform android   # or ios
npx lakebed-native pack . --platform android --api https://api.lakebed.dev

Install the packed APK or simulator .app. After that, JS-only updates are build + deploy — no repack.

5. Physical iPhone (optional)

Requires Apple Developer Program + Lakebed Native Cloud for the device IPA.

The universal shell rarely needs rebuilding — capsule UI ships via deploy (JS OTA). Cloud device builds are limited to once every 36 hours per Apple team.

Before your first build: register every iPhone/iPad you need (apple devices register). Rebuilding without new UDIDs is unnecessary — your previous IPA still works.

npx lakebed-native apple setup
npx lakebed-native apple devices register   # repeat for each device
npx lakebed-native cloud build --platform ios --wait
npx lakebed-native pack . --platform ios --device --api https://api.lakebed.dev

Use --force only if you added devices and must rebuild before the cooldown ends.

Environment

Docs

• Site: https://lakebednative.xyz
• Agents: https://lakebednative.xyz/llms.txt