Project Structure

.
├── apps/
│   └── launchsaas/             # Main Next.js application
├── packages/
│   ├── auth/                   # Auth utilities & safe-action clients
│   ├── cache/                  # Cache providers (Redis, Upstash, Cloudflare KV)
│   ├── config/                 # Feature configuration & product config
│   ├── cron/                   # Scheduled jobs (QStash)
│   ├── db/                     # Database client & table schemas
│   ├── email/                  # Email providers (Resend, Nodemailer)
│   ├── errors/                 # Shared error definitions
│   ├── newsletter/             # Newsletter providers (Resend)
│   ├── payment/                # Payment providers (Stripe, Creem)
│   ├── storage/                # Storage providers (S3)
│   └── utils/                  # Shared utilities
├── drizzle/                    # Database migrations (committed to git)
├── 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)
├── 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/
├── ui/                         # shadcn/ui components (DO NOT edit directly)
├── layout/                     # Layout components
│   ├── site-header.tsx
│   ├── site-footer.tsx
│   ├── app-sidebar.tsx
│   └── ...
├── landing/                    # Landing page sections
├── blog/                       # Blog components
├── shared/                     # Shared components
└── email/                      # Email templates

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)
├── fotoer.ts                   # Footer links and badges
└── social-links.ts             # Social media links

src/lib/
├── auth/                       # Better Auth instance configuration
├── env/
│   ├── server.ts               # Server-only environment variables
│   └── client.ts               # Client-safe environment variables
├── session.ts                  # Session helpers
└── safe-action.ts              # Re-exports from @launchsaas/auth

packages/config/src/
├── features/                   # Feature flags & provider selection
│   ├── index.ts                # Selects production vs development config
│   ├── development.ts          # Development feature config
│   └── production.ts           # Production feature config
└── product/                    # Pricing plans and products (per payment provider)
    ├── index.ts
    ├── development.ts
    └── production.ts

packages/db/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

packages/{name}/src/
├── provider.ts                 # Interface definition
├── factory.ts                  # Provider factory
├── index.ts                    # Public exports
└── providers/
    └── {provider-name}.ts

content/
├── blog/                       # Blog posts (MDX)
├── docs/                       # Documentation (MDX)
└── changelog/                  # Changelog entries (MDX)