Onboarding checklist

A checklist for an engineer joining NXT. Roughly two hours end-to-end.

Access

• GitHub: write access to wearenxt/nxt-app. SSH key signed.
• Bitwarden: shared into nxt-app@outlook.com collection.
• Convex: dashboard access.
• Vercel: team access on the marketing + docs projects.
• Expo / EAS: org member.
• PostHog: project member.

Environment

• Clone repo: git clone git@github.com-nxt:wearenxt/nxt-app.git
• pnpm install
• Copy .env.example → .env.local; fill from Bitwarden.
• Drop key files from Bitwarden into apps/mobile/keys/ (see Credentials).
• pnpm check runs clean (typecheck + lint + format + boundaries + i18n).
• pnpm ios boots the dev client on simulator.
• pnpm dev:web opens marketing site at http://localhost:3000.
• pnpm --filter @app/docs dev opens this site at http://localhost:3001.

Reading

• README.md + CLAUDE.md + AGENTS.md at repo root.
• Overview
• System overview
• AI and matching — the V1→V2 decision is here.
• Engineering conventions — six conventions to keep the codebase healthy.
• Status + Roadmap — what's done, what's deferred.
• At least one runbook in Runbooks.

Verification

• Open Convex dashboard → confirm cron list shows nine entries.
• Open PostHog → confirm events arriving from your simulator session (e.g. app_opened).
• Open EAS dashboard → review last build.
• Make a no-op PR (e.g. fix a typo in this checklist) → verify pre-push gate runs, Vercel preview deploys.

Once comfortable

• Pick one item from Status — Recommended next priorities and scope it.