I built a full Next.js SaaS boilerplate in a weekend — here's everything in it

Lorenzo — Sun, 24 May 2026 23:28:37 +0000

Every time I start a new project I spend the first two days on the same setup: auth, database, billing, UI components. Always from scratch, always the same code.

So I packaged it all into a clean, production-ready boilerplate.

Stack

Next.js 16 — App Router, Server Components, TypeScript
Supabase — auth + PostgreSQL with Row Level Security
Stripe — subscription billing with webhook handling
Tailwind CSS + shadcn/ui — polished UI out of the box
Zod + React Hook Form — type-safe form validation
Dark mode — built in via next-themes

What's included

Authentication

Full email/password auth flow — register, login, logout, reset password. Sessions managed server-side with Supabase SSR, protected routes handled at the proxy level.

// Protecting a route is one dependency
export default async function DashboardLayout({ children }) {
  const supabase = await createClient()
  const { data: { user } } = await supabase.auth.getUser()

  if (!user) redirect("/login")

  return <>{children}</>
}

Stripe subscriptions

Full billing flow: checkout session creation, success redirect, webhook handling for subscription lifecycle events.

const session = await stripe.checkout.sessions.create({
  customer: customerId,
  line_items: [{ price: process.env.STRIPE_PRICE_ID!, quantity: 1 }],
  mode: "subscription",
  success_url: `${process.env.NEXT_PUBLIC_APP_URL}/dashboard/billing?success=true`,
  cancel_url: `${process.env.NEXT_PUBLIC_APP_URL}/dashboard/billing?cancelled=true`,
  metadata: { user_id: user.id },
})

Webhooks handle: checkout.session.completed, customer.subscription.deleted, invoice.payment_failed.

Dashboard

Sidebar navigation, profile management, billing page with upgrade/cancel, settings page with password change. All server-rendered with real data.

Database

One SQL migration to run in Supabase — creates the profiles table, enables Row Level Security, and sets up a trigger to auto-create profiles on signup.

Project structure

src/
├── app/
│   ├── (auth)/          # Login, register, reset password
│   ├── (dashboard)/     # Protected dashboard pages
│   ├── api/stripe/      # Checkout, cancel, webhook
│   └── page.tsx         # Landing page
├── components/
│   ├── auth/            # Auth forms
│   ├── dashboard/       # Sidebar, billing card, settings form
│   └── ui/              # shadcn/ui components
└── lib/
    └── supabase/        # Client, server, middleware

Up and running in 5 minutes

git clone https://github.com/thask8lo/nextjs-saas-starter
cd nextjs-saas-starter
npm install
cp .env.example .env.local
# Fill in Supabase and Stripe keys
npm run dev

Live demo

You can see it running at: nextjs-saas-starter-full.onrender.com

Get it

GitHub preview: github.com/thask8lo/nextjs-saas-starter

Full package: available on Gumroad

Happy to answer questions in the comments.

I built a production-ready FastAPI SaaS boilerplate — here's what's in it

Lorenzo — Sat, 23 May 2026 17:12:13 +0000

Every time I start a new backend project I waste the first two days on the exact same things: JWT auth, Stripe subscriptions, database migrations, Docker setup.

So I stopped doing that and packaged everything into a clean, working boilerplate.

Here's what's in it and why I made the choices I did.

Stack

FastAPI — async, fast, auto-generates OpenAPI docs at /docs
SQLAlchemy 2.0 + Alembic — ORM with proper migration support
Pydantic v2 — request/response validation throughout
python-jose — JWT access and refresh tokens
passlib + bcrypt — password hashing
Stripe — subscription billing
SlowAPI — per-route rate limiting
Docker + docker-compose — runs anywhere

SQLite out of the box, one line to switch to Postgres.

Project structure

app/
├── api/routes/     # auth.py, users.py, billing.py
├── core/           # config, database, security
├── models/         # SQLAlchemy models
└── schemas/        # Pydantic v2 schemas

Clean, flat, easy to extend.

Auth

JWT with separate access and refresh tokens. Access tokens expire in 30 minutes, refresh tokens in 7 days. Rate limited at the route level — 5 requests/minute on register, 10 on login.

@router.post("/register", response_model=UserResponse, status_code=201)
@limiter.limit("5/minute")
def register(request: Request, user_data: UserCreate, db: Session = Depends(get_db)):
    if db.query(User).filter(User.email == user_data.email).first():
        raise HTTPException(status_code=400, detail="Email already registered")
    ...

Stripe subscriptions

Full subscription flow: checkout session creation, success redirect, webhook handling for cancellations and failed payments.

Protecting a route behind an active subscription is one dependency:

from app.core.security import get_current_active_subscriber

@router.get("/premium-feature")
def premium(current_user: User = Depends(get_current_active_subscriber)):
    return {"data": "only for paying customers"}

Returns 402 Payment Required automatically if the user has no active plan.

Database migrations

Alembic is wired up and the initial migration is included. Adding a new field to a model and generating a migration is one command:

alembic revision --autogenerate -m "add new field"
alembic upgrade head

Up and running in 5 minutes

git clone https://github.com/thask8lo/fastapi-saas-starter
cd fastapi-saas-starter

python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

pip install -r requirements.txt
cp .env.example .env
alembic upgrade head
uvicorn app.main:app --reload

Open http://localhost:8000/docs — every endpoint is there, ready to test.

Get it

GitHub: github.com/thask8lo/fastapi-saas-starter

If you want the full packaged version ready to drop into a project: available on Gumroad

Happy to answer questions in the comments.

DEV Community: Lorenzo

I built a full Next.js SaaS boilerplate in a weekend — here's everything in it

Stack

What's included

Authentication

Stripe subscriptions

Dashboard

Database

Project structure

Up and running in 5 minutes

Live demo

Get it

I built a production-ready FastAPI SaaS boilerplate — here's what's in it

Stack

Project structure

Auth

Stripe subscriptions

Database migrations

Up and running in 5 minutes

Get it