expo-architect

# Expo Architect Create **production-ready** Expo React Native apps with: - **Framework:** Expo SDK 54 + React Native 0.83 + TypeScript - **Navigation:** Expo Router (file-based routing) - **Auth:** Clerk authentication (optional) - **UI:** NativeWind (Tailwind for RN) or StyleSheet - **Quality:** Biome linting + TypeScript strict mode - **Package Manager:** bun ## What Makes This Different Generates **working mobile apps**, not empty scaffolds: - Complete navigation structure with working screens - Optional Clerk authentication flow - Real UI components with proper styling - API client integration ready - Runs immediately with `bun start` ## Workflow Summary 1. **PRD Brief Intake** - Extract app type, screens, features, auth needs 2. **Auth Setup** (if requested) - Clerk provider, sign-in/sign-up screens 3. **Screen Generation** - Tab or stack-based navigation 4. **Component Generation** - UI components, entity components, layouts 5. **Quality Setup** - Biome, TypeScript strict, path aliases 6. **Verification** - Run quality gate, report results ## Usage ```bash # Create app with PRD-style prompt python3 scripts/init-expo.py \ --root ~/www/myapp \ --name "My App" \ --brief "A fitness tracker where users can log workouts" # With specific options python3 scripts/init-expo.py \ --root ~/www/myapp \ --name "My App" \ --tabs "Home,Workouts,Profile" \ --auth ``` ## Generated Structure ``` myapp/ ├── app/ │ ├── _layout.tsx # Root layout │ ├── (tabs)/ # Tab navigator │ │ ├── _layout.tsx │ │ ├── index.tsx │ │ └── ... │ └── (auth)/ # Auth screens (if enabled) ├── components/ │ ├── ui/ # Base UI components │ ├── [entity]/ # Feature components │ └── layout/ # Layout components ├── lib/ │ ├── api.ts # API client │ └── auth.ts # Auth utilities ├── providers/ # Context providers ├── types/ # TypeScript types ├── app.json # Expo config ├── package.json ├── tsconfig.json └── biome.json ``` ## Development Commands ```bash bun start # Start Expo dev server bun run ios # iOS simulator bun run android # Android emulator bun run lint # Check code style bun run typecheck # Type checking ``` ## Environment Variables ``` EXPO_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_test_... EXPO_PUBLIC_API_URL=http://localhost:3001 ``` --- **For detailed patterns, code templates, and complete examples:** `references/full-guide.md`