Skip to main content

Project Overview

Architecture​

  • Full-stack TypeScript with Next.js 15 and React 19
  • Monorepo structure using Turborepo
  • Supabase backend for database, auth, and storage
  • Multi-tenant architecture supporting personal and team accounts
  • Row Level Security (RLS) for data protection

Key Technologies​

  • Next.js 15 with App Router
  • React 19 with React Compiler
  • Supabase (PostgreSQL + Auth + Storage)
  • TypeScript with strict configuration
  • Tailwind CSS 4 for styling
  • Turborepo for monorepo management

Multi-Tenant Model​

Personal Accounts​

Individual user accounts where auth.users.id = accounts.id

Team Accounts​

Shared workspaces with:

  • Multiple members with roles
  • Permission-based access control
  • Separate billing and subscriptions

Development Workflow​

pnpm dev                    # Start all apps
pnpm --filter web dev       # Main app only
pnpm --filter dev-tool dev  # Dev tools only
pnpm --filter docs dev      # Docs only
pnpm build                  # Build all apps
pnpm lint && pnpm format    # Code quality

Route Structure​

  • (marketing)/ - Public pages (landing, blog)
  • (auth)/ - Authentication pages
  • home/(user)/ - Personal account context
  • home/[account]/ - Team account context
  • admin/ - Super admin section