MuscleOS
Strength-training log (Expo React Native) with a Next.js landing site. Monorepo managed with pnpm + Turborepo.
Prerequisites
- Node.js ≥ 24 (see
.nvmrc)
- pnpm 9.x
Quick start
pnpm install
pnpm dev # mobile + landing
pnpm dev:landing # landing only (port 3001)
pnpm check # biome + typecheck + tests (also runs in GitHub Actions)
Mobile app: cd apps/mobile && pnpm dev
CI (GitHub Actions on main and PRs) runs the same pnpm check pipeline: Biome, TypeScript, Vitest and Jest via Turbo.
Expo login
cd apps/mobile
pnpx expo login
Credentials: username twaxter (password in team vault).
Expo MCP (optional)
cd apps/mobile
EXPO_UNSTABLE_MCP_SERVER=1 npx expo start
Environment variables
Copy from each directory's .env.example where present.
Specs & docs
Product and engineering specs live in docs/. That folder is the source of truth for what
the app does — not scattered READMEs in app directories. Start at
docs/README.md.
Changing a feature? Update its spec in the same change — see
keeping docs in sync.
Troubleshooting
Sign-in times out on Android emulator
If email sign-in hangs ~15s then fails, the emulator often has broken DNS (IPs work but hostnames do not).
- Device Manager → emulator dropdown → Cold Boot Now
- Or wipe emulator data and restart
- Or start the AVD with explicit DNS:
emulator -avd YOUR_AVD -dns-server 8.8.8.8,8.8.4.4
- Or test auth on iOS simulator or a physical device on the same Wi‑Fi
Verify: host machine can reach Supabase (curl https://YOUR_PROJECT.supabase.co/auth/v1/health should return quickly).
Agent guide
Code conventions and monorepo patterns: AGENTS.md
