NeoSaaS 🚀
Full-stack multi-tenant SaaS boilerplate — authentication, user management, payments, and transactional emails out of the box.
Features
- 🔐 Full authentication — sign-up, login, JWT
- 🌐 Social OAuth login — GitHub & Google (100% database-driven config)
- 👥 User management — multi-tenant, roles and permissions
- 💳 Stripe + Lago billing — subscriptions and invoicing
- 📧 Transactional emails — Resend, Scaleway TEM, AWS SES
- 🎨 Modern UI — Tailwind CSS + shadcn/ui
- 📞 Contact form — email-based support
- ⚙️ API Manager — centralised third-party service configuration
- 🤖 MCP agent API — JSON-RPC control plane for AI agents (
POST /api/mcp)
Quick Start
# Install dependencies
pnpm install
# Set up environment variables
cp .env.example .env
# Edit .env with your values
# Initialise the database
pnpm db:push && pnpm db:seed
# Start the dev server
pnpm dev
Open http://localhost:3000
Automated Versioning
Releases on release-live are fully automated by semantic-release (.github/workflows/release-live.yml, config in .releaserc.json) — no manual version bump, no release PR to merge. Every push with a releasable Conventional Commit publishes immediately, since release-live is the trigger point that propagates updates to every client site (scripts/release-sync-boilerplate.sh). See CHANGELOG.md's Versioning Policy for the patch/minor/major rule.
Vidéo et chaîne (FR)
Tech Stack
| Category | Technology |
|---|
| Framework | Next.js 15 (App Router) + React 19 |
| Language | TypeScript 5.7 |
| Database | PostgreSQL (Drizzle ORM) |
| UI | Tailwind CSS 3.4 + shadcn/ui |
| Auth | JWT + OAuth (Google, GitHub, Microsoft, Facebook) |
| Payments | Stripe + Lago |
| Email | Scaleway TEM / AWS SES / Resend |
| Package manager | pnpm |
| Deployment | Vercel / Docker |
Documentation
Full developer reference: docs/PROJECT.md
OAuth Configuration
No environment variables required — everything is configured through the admin UI:
- Create an OAuth app on GitHub or Google
- Go to Admin → API Manager → configure GitHub / Google
- Copy the callback URL (copy button available)
- Run the automatic configuration test
- Social login buttons appear automatically on the login / register pages
Database
Auto-reset enabled on each deployment
Each deployment runs the full build sequence:
- Schema migrations (no-op if already up to date)
- Base data seed (roles, permissions, VAT rates, platform config)
- Email template seed
- Page permission sync
In demo / preview environments the database is reset on each deploy, so all user-created data is lost. This is intentional for clean, predictable preview environments.
Script: scripts/build-with-db.sh
Security
Never commit .env — it contains sensitive credentials.
Security headers enforced on all responses (via next.config.ts):
Strict-Transport-Security — forces HTTPS, includes subdomains and preloadContent-Security-Policy — baseline policy (self, Stripe, inline styles for Tailwind)X-Content-Type-Options: nosniffX-Frame-Options: DENYX-DNS-Prefetch-Control: on
License
MIT — see LICENSE.
Author: Charles Van den Driessche (neosaas.tech) — [email protected] / [email protected]
