Project Structure
How the Handlet monorepo is organized.
Handlet is a Turborepo monorepo with a Next.js web app, Supabase schema, shared packages, and QA documentation.
apps/ ├── web └── e2e packages/ ├── ui ├── supabase ├── next ├── cms ├── n8n ├── unipile └── vapi documents/ └── qa
Web app routes
apps/web/ ├── app/(marketing) ├── app/(auth) ├── app/home/(user) ├── app/home/[account] ├── app/admin └── app/api
Code organization
- Route-specific components live in
_components. - Route-specific server logic lives in
_lib/server. - Shared UI should use
@kit/uiprimitives. - Tenant-scoped product data uses
account_id.
Finding your way
| Looking for... | Location |
|---|---|
| Public content | apps/web/content |
| App routes | apps/web/app |
| Config | apps/web/config |
| Supabase schemas | apps/web/supabase/schemas |
| Migrations | apps/web/supabase/migrations |
| Shared UI | packages/ui |
| QA route docs | documents/qa |