AGENTS.md

Studyflash v2 is a Turborepo monorepo for a learning platform that generates and studies flashcards, quizzes, and summaries.

Package manager: pnpm (v10.12.1). Do not use npm or yarn.

Before editing, read the relevant AGENTS.md and any linked docs (docs/agents/*).

Apps overview (boundaries):

• apps/portal: Student-facing web app (Nuxt).
• apps/core-api: Hono API service and AI generation.
• apps/supabase: Supabase schemas, migrations, seeds, legacy functions.
• apps/landing-page: Marketing site (Nuxt).
• apps/mobile-app: Expo / React Native app.
• apps/email-previews: Transactional email previews.
• apps/marketing-emails-preview: Marketing email previews/build.
• apps/wrapped: Studyflash Wrapped microsite.
• apps/mountain-max: Landing page + game.
• apps/learning-api: Python API for AI-powered content generation (flashcards, quizzes, summaries).

Per-app guidance lives in apps/*/AGENTS.md where present.

Build order

Internal packages (packages/*) must be built before type-checking or running apps that depend on them. Run pnpm turbo build or target specific packages:

pnpm turbo build --filter=@studyflash-ai/types --filter=@studyflash-ai/common --filter=@studyflash-ai/api-client --filter=@studyflash-ai/learning-service --filter=@studyflash-ai/marketing-emails

If you see type errors referencing @studyflash-ai/* packages, build them first.