Quick start

Generate

npx create-expojet@latest my-app
cd my-app
pnpm install

For a reviewed team baseline, replace the first command with npx create-expojet@0.8.0 my-app (or your team's approved release). This pins the generator, not all installed app dependencies. Commit the generated lockfile and use frozen-lockfile installs in CI; see Use a reviewed release.

Configure

Copy the generated examples. A standalone app has one example; a monorepo separates mobile and API configuration.

cp apps/mobile/.env.example apps/mobile/.env
cp apps/api/.env.example apps/api/.env

Only EXPO_PUBLIC_* values belong in mobile. Keep authentication secrets and both Neon URLs in apps/api/.env.

Verify

npx expojet doctor
pnpm typecheck
pnpm test

For a monorepo, migrate the database and start both workspaces:

pnpm db:migrate
pnpm dev

For a standalone app:

pnpm start --lan

Open the QR code in Expo Go. Clerk projects should complete hosted sign-in, return through the project deep link, retain the session after restart, and redirect to the public route after sign-out.