Ship your SaaS in days, not months.

Surge is a production-ready Next.js SaaS starter kit with authentication, payments, an admin dashboard, a blog engine, and a premium dark glassmorphism UI. Clone it, configure it, and start building your product.

• Authentication - NextAuth v5 with credentials provider, JWT sessions, registration toggle, forgot/reset password, account deletion, and rate limiting
• Stripe Payments - Checkout sessions, customer portal, webhook handling, tier-based feature gating, and configurable pricing
• Admin Dashboard - User stats, MRR tracking, growth charts, user management, blog content inventory, and system health monitoring
• Blog Engine - Markdown with frontmatter, reading progress bar, table of contents, social sharing, OG image generation, and tag organization
• Dark Glassmorphism Theme - Premium dark UI with mobile-first responsive layout, bottom nav (mobile) + sidebar (desktop), and dark/light toggle
• Prisma ORM - SQLite for local development, PostgreSQL for production, with migrations and seed data
• Docker Ready - Docker Compose setup with PostgreSQL, Nginx, and Certbot SSL out of the box
• CI/CD - GitHub Actions workflows for testing, building, and deploying on push to main
• Testing - 135+ tests with Vitest
• PWA Support - Installable on mobile devices

• Node.js 18+ (or Bun)
• Stripe CLI (optional, for webhook testing)

# Clone the repository
git clone https://github.com/The-DevOps-Daily/surge.git
cd surge

# Install dependencies
npm install
# or: bun install

# Configure environment
cp .env.example .env
# Edit .env with your values (see Environment Variables below)

# Set up the database
npx prisma migrate dev --name init
npx prisma db seed

# Start the development server
npm run dev

Open http://localhost:3000 and log in with the seed credentials (admin@example.com / changeme123).

stripe listen --forward-to localhost:3000/api/stripe/webhook

Copy .env.example to .env and fill in your values:

src/
  app/
    (admin)/        # Admin dashboard (role-gated)
    (app)/          # Authenticated app pages
    (marketing)/    # Public pages (blog, tools, legal)
    api/            # API routes (auth, stripe, admin, user)
    landing/        # Landing page
    login/          # Login page
    register/       # Registration page
  components/
    admin/          # Admin sidebar and mobile nav
    layout/         # App shell, sidebar, mobile nav
    ui/             # Reusable UI components
    blog/           # Blog components (progress bar, TOC, share)
  lib/              # Utilities (auth, prisma, stripe, email, rate-limit)
prisma/             # Database schema, migrations, seed
content/blog/       # Markdown blog posts
public/             # Static assets, manifest, favicon
scripts/            # Server setup and deployment scripts
.github/workflows/  # CI/CD pipeline

# Development (builds locally)
docker compose up -d

# Production (uses pre-built image)
docker compose -f docker-compose.prod.yml up -d

This starts the app, PostgreSQL, Nginx, and Certbot for SSL.

1. Create a droplet with Ubuntu 22.04+ (minimum 1 GB RAM)
2. Run the setup script:

   scp scripts/setup-server.sh root@your-server:/root/
   ssh root@your-server bash setup-server.sh

3. Configure GitHub Actions secrets (DEPLOY_HOST, DEPLOY_USER, DEPLOY_SSH_KEY)
4. Push to main to trigger automatic deployment

Deploy with one click or connect your GitHub repository. Set the environment variables in the Vercel dashboard and use a hosted PostgreSQL provider (e.g., Neon, Supabase) for the database.

This project is licensed under the MIT License. See LICENSE for details.

Copyright 2026 The DevOps Daily