Getting Started
Project Structure
The ownership map a coding agent should be able to predict.
apps/web/
app/ Next.js routes only
features/ product UI by capability
application/ authenticated app shell
marketing/ marketing composition
compositions/ reusable higher level UI
ui/ low level primitives
tests/ every web test
packages/
api/ tRPC and server product behavior
auth/ identity and sessions
database/ Prisma and migrations
payments/ billing and payment adapters
storage/ managed uploads and storage adapters
mail/ email templates and transports
ai/ AI provider facade
notifications/ in app notifications
*/tests/ every package test
scripts/
tests/ repository tooling testsTests mirror the source path under the owning tests/ directory. Generated Prisma and Zod output must not be edited by hand.
Read root ARCHITECTURE.md for the full ownership map.