Project Structure

my-saas/
├── src/                    # All application code
│   ├── app/                # Next.js App Router (pages + API)
│   ├── components/         # React components
│   ├── config/             # App configuration
│   └── lib/                # Core libraries (auth, db, payments, email)
├── content/                # MDX content (blog posts)
├── drizzle/                # Database migrations
├── tests/                  # E2E tests (Playwright)
├── public/                 # Static assets
├── .goon/                  # CLI manifest and AI rules
├── .env                    # Environment variables (never commit)
├── drizzle.config.ts       # Database config
├── next.config.ts          # Next.js config (security headers)
└── package.json            # Dependencies and scripts

src/app/
├── (app)/                  # Authenticated pages (requires login)
│   ├── dashboard/          # Main dashboard
│   ├── billing/            # Subscription management
│   ├── settings/           # User settings
│   ├── teams/              # Team management
│   ├── admin/              # Admin panel (restricted)
│   └── layout.tsx          # App shell (sidebar + header)
│
├── (auth)/                 # Auth pages (no chrome, centered layout)
│   ├── sign-in/
│   ├── sign-up/
│   ├── forgot-password/
│   ├── reset-password/
│   ├── verify-email/
│   └── layout.tsx          # Minimal auth layout
│
├── (marketing)/            # Public pages (navbar + footer)
│   ├── page.tsx            # Landing page
│   ├── pricing/
│   ├── blog/
│   ├── changelog/
│   ├── privacy/
│   ├── terms/
│   └── layout.tsx          # Marketing layout
│
├── api/                    # API routes
│   ├── auth/[...all]/      # Better Auth handler (catch-all)
│   ├── billing/            # Checkout, portal, invoices
│   ├── teams/              # Team CRUD + invitations
│   ├── webhooks/           # Payment webhooks
│   ├── lead/               # Email lead capture
│   └── og/                 # Dynamic OG image generation
│
├── layout.tsx              # Root layout (fonts, metadata)
├── globals.css             # Design tokens + theme
└── not-found.tsx           # 404 page

src/lib/
├── auth/
│   ├── index.ts            # Better Auth server config
│   └── client.ts           # Client-side auth hooks
│
├── db/
│   ├── index.ts            # Drizzle connection (Neon HTTP)
│   └── schema/
│       ├── auth.ts         # users, sessions, accounts, verifications
│       ├── subscriptions.ts # subscriptions table
│       ├── teams.ts        # teams, members, invitations
│       ├── leads.ts        # email leads
│       └── index.ts        # Barrel export
│
├── payments/
│   ├── index.ts            # Provider factory (reads PAYMENT_PROVIDER env)
│   ├── types.ts            # PaymentProvider interface
│   ├── sync.ts             # Webhook → database subscription sync
│   └── providers/
│       ├── stripe.ts
│       ├── polar.ts
│       ├── lemon.ts
│       └── dodo.ts
│
├── email/
│   ├── index.ts            # Provider factory (reads EMAIL_PROVIDER env)
│   ├── types.ts            # EmailProvider interface
│   ├── templates/
│   │   └── auth.ts         # Verify, reset, welcome, magic link emails
│   └── providers/
│       ├── resend.ts
│       ├── postmark.ts
│       ├── sendgrid.ts
│       ├── mailgun.ts
│       └── nodemailer.ts
│
├── teams/
│   └── index.ts            # Team CRUD, invitations, roles
│
├── admin/
│   └── index.ts            # Admin stats, user management
│
├── i18n/
│   ├── config.ts           # Supported locales
│   ├── index.ts            # Server-side translations
│   ├── client.tsx          # React context + hooks
│   └── locales/            # JSON translation files
│
├── seo/
│   ├── metadata.ts         # buildMeta() helper
│   └── structured-data.tsx # JSON-LD generators
│
├── blog.ts                 # MDX reader + frontmatter parser
└── utils.ts                # Shared utilities (cn, formatDate, etc.)

src/components/
├── ui/                     # Primitives (button, card, input, dialog...)
├── layout/                 # App shell (sidebar, header)
├── sections/               # Marketing page sections (hero, pricing, FAQ...)
└── blog/                   # Blog components (MDX, code copy, callouts)

{
  "framework": "next",
  "tier": "pro",
  "database": "neon",
  "features": ["blog", "admin"],
  "providers": {
    "payments": "stripe",
    "email": "resend"
  }
}