Project Structure

.
├── apps/
│   └── launchsaas/             # Main Next.js application
├── packages/
│   ├── cache/                  # Cache provider interface
│   ├── cache-redis/            # Redis cache provider
│   ├── cache-upstash/          # Upstash Redis cache provider
│   ├── cache-cloudflare-kv/    # Cloudflare KV cache provider
│   ├── cron/                   # Cron provider interface
│   ├── cron-qstash/            # QStash cron provider
│   ├── db-pg/                  # PostgreSQL DB provider & Drizzle table definitions
│   ├── db-mysql/               # MySQL DB provider & Drizzle table definitions
│   ├── db-sqlite/              # SQLite DB provider & Drizzle table definitions
│   ├── email/                  # Email provider interface
│   ├── email-resend/           # Resend email provider
│   ├── email-nodemailer/       # Nodemailer (SMTP) email provider
│   ├── newsletter/             # Newsletter provider interface
│   ├── newsletter-resend/      # Resend newsletter provider
│   ├── payment/                # Payment provider interface
│   ├── payment-stripe/         # Stripe payment provider
│   ├── payment-creem/          # Creem payment provider
│   ├── storage/                # Storage provider interface
│   └── storage-s3/             # S3-compatible storage provider
├── biome.json                  # Lint + format configuration
├── pnpm-workspace.yaml         # Workspace configuration
└── package.json                # Root workspace scripts

apps/launchsaas/
├── src/                        # Application source code
├── content/                    # MDX content (blog, docs, changelog)
├── drizzle/                    # Database migrations (committed to git)
├── public/                     # Static assets
├── scripts/                    # Utility scripts
├── .env                        # Environment variables (not in git)
├── package.json                # App dependencies
└── next.config.mjs             # Next.js configuration

src/app/
└── [locale]/
    ├── layout.tsx              # Root locale layout
    │
    ├── (marketing)/            # Public pages with header/footer layout
    │   ├── layout.tsx
    │   ├── blog/
    │   ├── pricing/
    │   └── ...
    │
    ├── (protected)/            # Authenticated pages (require login)
    │   ├── (common)/           # User-accessible features
    │   │   ├── billing/
    │   │   └── settings/
    │   └── admin/              # Admin-only features
    │       ├── users/
    │       ├── orders/
    │       └── entitlements/
    │
    ├── auth/[path]/            # Better Auth dynamic routes
    ├── docs/[[...slug]]/       # Fumadocs documentation
    └── api/                    # API routes

src/components/
├── layout/                     # Layout components
│   ├── site-header.tsx
│   ├── site-footer.tsx
│   ├── app-sidebar.tsx
│   └── ...
├── landing/                    # Landing page sections
├── blog/                       # Blog components
└── shared/                     # Shared components

packages/design-system/ui/
├── src/components/             # Shared source-vendored UI components
│   ├── auth/                   # Better Auth UI source components
│   ├── settings/               # Better Auth settings source components
│   ├── ui/                     # Canonical shadcn primitive source installed by the registry
│   └── user/                   # Better Auth user menu/avatar source components
├── src/lib/utils.ts            # Shared package `cn()` helper source
└── src/hooks/                  # Hooks required by shared components

packages/design-system/email-templates/
├── src/transactional-email.tsx # Shared transactional email layout
├── src/email-styles.tsx        # Email-specific styles and colors
└── src/index.ts                # `@launchsaas/email-templates` export entrypoint

src/actions/
├── billing.ts                  # Payment and subscription actions
├── newsletter.ts               # Newsletter subscription actions
├── storage.ts                  # File storage actions
└── user.ts                     # User management actions

src/configuration/
├── metadata.ts                 # Site name, title, description, SEO
├── navbar.ts                   # Navigation bar items and actions
├── sidebar.ts                  # Dashboard/Admin sidebar (role-based)
├── user-button.tsx             # User dropdown menu (role-based)
├── footer.ts                   # Footer links and badges
└── social-links.ts             # Social media links

src/lib/
├── auth/                       # Better Auth server/client wiring
├── env/
│   ├── server.ts               # Server-only environment variables
│   └── client.ts               # Client-safe environment variables
├── session.ts                  # App-owned session policy and helpers
└── safe-action.ts              # App-owned role/action wiring

apps/launchsaas/src/configuration/
├── metadata.ts                 # SEO / branding metadata
├── navbar.ts                   # Marketing navigation
├── sidebar.ts                  # Protected area sidebar
├── social-links.ts             # Social links
├── user-button.tsx             # User menu config
├── footer.ts                   # Footer config
├── types.ts                    # App-owned config types
└── product/                    # App-owned payment product catalog and helpers
    ├── index.ts
    ├── products.ts
    └── types.ts

packages/databases/db-pg/src/
├── tables/                     # Drizzle table definitions
│   ├── auth.ts                 # Auth tables (auto-generated, DO NOT edit)
│   ├── order.ts                # Immutable payment records
│   ├── entitlement.ts          # Mutable user access/subscription status
│   └── index.ts
├── db.ts                       # Database client
└── index.ts                    # Public exports

apps/launchsaas/
├── src/db/index.ts             # App binding to the selected provider package
├── drizzle.config.ts           # App-owned Drizzle config
└── src/db/tables/              # App-specific extra tables

packages/capabilities/{name}/src/
├── provider.ts                 # Interface definition
└── index.ts                    # Public exports

packages/capabilities/{name}-{provider}/src/
├── provider.ts                 # Concrete provider implementation
├── keys.ts                     # Env var validation for this provider
└── index.ts                    # Public exports

content/
├── blog/                       # Blog posts (MDX)
├── docs/                       # Documentation (MDX)
├── changelog/                  # Changelog entries (MDX)
└── pages/                      # Static pages (terms, privacy, license, etc.)