Inspiration

Most SaaS starters either skip email entirely or leave it half-wired, leaving developers to figure out transactional email the hard way on top of everything else. This starter exists to close that gap — Mailtrap is wired in as the email layer from day one, right alongside auth and billing.

What it does

Next.js Mailtrap SaaS Starter is open-source, blank-slate SaaS scaffolding — not a working product. It ships with:

  • A marketing landing page (hero, pricing, FAQ, footer)
  • Full auth flows: signup, login, magic link, password reset
  • A user dashboard (account status, plan, billing portal link)
  • User settings (profile, password, email, delete account)
  • Minimal multi-tenancy: one org per user, invite members by email
  • Stripe billing across 3 tiers (Free / Pro $19 / Team $99)
  • Mailtrap wiring: Sending API, hosted templates, email-event webhooks
  • An admin email logs view powered by those Mailtrap webhooks

How it's built

Next.js 15 (App Router, Server Actions, strict TypeScript), Supabase for auth and Postgres, Drizzle ORM, Stripe for subscriptions and the customer portal, Tailwind CSS + shadcn/ui, and Vitest + Playwright for testing. It deploys to Vercel with a one-click button and all environment variables pre-wired.

Challenges

Keeping the codebase genuinely "blank-slate" is harder than it sounds — every feature needs to be complete enough to serve as a real reference, but generic enough that a learner can drop their own product logic on top without fighting scaffolding decisions.

Who it's for

Learners, indie hackers, weekend builders, and juniors copying patterns — not production-grade engineering teams. The goal is simple: clone it, and go from git clone to your own product logic within an hour.

What's next

Keeping the boilerplate current with the latest Next.js and Mailtrap features, and expanding the docs so it stays approachable for beginners.

Built With

Share this project:

Updates