Build SaaS products faster
in React, Django and AWS
A complete SaaS starter kit based on a battle-tested stack with out-of-the-box features every SaaS should have. Supercharge your SaaS development and focus on innovation from day one.
npm init saas-boilerplate NAMEreplace NAME with your project name
Introduction to SaaS Boilerplate
Supercharge your SaaS development
Our comprehensive starter kit is designed to accelerate your project and save you valuable time and resources. Our battle-tested boilerplate eliminates the need for extensive configuration and development work, allowing you to focus on innovation from day one.
Complete Stack
Frontend, backend API, admin panel, and workers with a scalable AWS-based architecture and continuous deployment.
Ready-to-Use Features
Essential features every SaaS requires, eliminating weeks of setup and coding so you can focus on innovation.
Proven Stack
Battle-tested technologies with specific versions for optimal compatibility and reliability.
Multiple Environments
Easily deploy multiple environments representing different stages in your pipeline.
Getting started
Get up and running quickly with our CLI starter kit or manual setup
Requirements
- Install Docker
- Install Node.js version 20 or above (check with
node -v) - Install pnpm version 9 or above (check with
pnpm --version) - (Windows only) Install WSL 2
Optional:
- • Python 3.11 and PDM 2.3+ (for running backend/workers outside Docker)
- • Use nvm or n for managing multiple Node versions
- • Use pyenv for managing multiple Python versions
Fresh Installation
Setup using CLI starter kit:
Run the following command in the directory where you would like to create a new project:
npm init saas-boilerplate NAMEpnpm create saas-boilerplate NAMEyarn create saas-boilerplate NAMEReplace NAME with your desired project directory name (e.g., my-saas-app). The target directory must be empty or non-existent!
Manual setup:
Clone the repository and follow the steps in the Getting started guide.
Run Existing Project
Install dependencies:
pnpm installThe project uses pnpm workspaces, so a single command installs node_modules for all packages.
Start the app:
pnpm saas uppnpm saas backend uppnpm saas webapp uppnpm saas docs upWhat's Running Locally?
http://localhost:3000http://localhost:5001http://admin.localhost:5001http://localhost:1080http://localhost:3006http://localhost:3005Built on top of modern
and reliable tech_
Battle-tested technologies with specific versions for optimal compatibility
Front-end stack
Tailwind CSS is the primary styling solution. Use Tailwind utility classes with the cn() helper for conditional styling. styled-components is included for internal theme infrastructure and email template rendering, but developers should use Tailwind CSS for all new component styling.
Back-end stack
Infrastructure
3rd party services
Build with confidence_
SaaS Boilerplate includes plenty of ready-to-use features that you can adjust to your needs
Authentication and authorization
Comprehensive authentication system with modern security standards. Support for traditional methods, passwordless authentication, and enterprise SSO to meet any security requirement.
- User registration and login, including Facebook and Google OAuth
- WebAuthn/Passkeys for passwordless authentication
- Enterprise SSO (SAML 2.0, OIDC) with SCIM 2.0 directory sync
- Basic user data like name, surname, and user role for authorization
- User email address verification via a transactional email
- Password change and password recovery within the app flow
- User management panel in Django admin
- Two-factor authentication (2FA)
- Active session management across devices
Emails
Build beautiful, responsive email templates in React. Schedule emails, test them in Storybook, and communicate with your users professionally.
- A set of ready-to-send transactional emails (new user verification, password recovery, subscription renewals, errors, etc.)
- Ability to schedule emails at a given time
- Sending test emails directly from a Storybook
- Internationalization support out of the box
Subscriptions & Payments
Complete payment and subscription management system with Stripe integration. Support multiple payment methods, set up recurring payments, free trials, grace periods, and manage customer subscriptions from your admin panel.
- Integration with Stripe services and its dashboard
- No customer payment method data is stored locally
- Support for multiple payment methods and their management (storing for future use and removal)
- Ability to charge users immediately or to set up recurring payments
- Subscription plans support and ability to freely modify current plans
- Free trial subscription plan, a grace period for credit card issues
- Superadmin panel enables customer management (i.e. refunds) without the Stripe dashboard
Multi-tenancy
Built-in multi-tenant architecture with role-based access control. Manage multiple entities within a single account with secure data isolation.
- Start immediately with a default tenant provided upon account creation
- Add new tenants as needed to manage multiple entities within a single account
- Utilize three default roles "Owner, Admin, and Member" to control tenant activities and collaboration
- Securely invite and manage new members within each tenant
CMS integration (Contentful)
Seamlessly integrate with Contentful for content management. Pre-built content models and example implementations to accelerate your content strategy.
- Integration with Contentful service
- Example content model (image, title, and description)
- Ready to use CMS with a free plan
Notifications
Real-time in-app notifications with WebSocket support. Keep users engaged with instant updates and a comprehensive notification center.
- Real-time in-app notifications with WebSocket support
- Notification center UI with unread indicators
- Mark all as read functionality
- Easy to add new notification types
AI Integration
OpenAI integration ready for building AI-powered features. Example implementation included with easy extension to other AI providers.
- OpenAI integration ready for building AI-powered features
- Example implementation included
- Easy to extend with other AI providers
CRUD Generator
Plop-based generators for quickly scaffolding new features. Generate forms, tables, and GraphQL operations automatically with tenant-scoped data isolation.
- Plop-based generators for quickly scaffolding new features
- Example CRUD module included
- Tenant-scoped data isolation
- Generate forms, tables, and GraphQL operations automatically
Management Dashboard
Complete financial management module with AI-powered features. Track projects, iterations, revenue & costs with intelligent CSV import and forecasting.
- Complete financial management module (example module)
- Projects, iterations, revenue & cost tracking
- AI-powered CSV import with intelligent column mapping
- Financial forecasting with backtesting and scenarios
- Multi-currency support with FX rate management
- Excel-like timesheet with copy/paste and fill handle
- CFO Command Center with KPI dashboards
RBAC Permissions
Fine-grained role-based access control system. Create custom organization roles with color coding and enforce permissions on both frontend and backend.
- Fine-grained role-based access control
- Custom organization roles with color coding
- Permission categories (organization, members, security, billing, features)
- Frontend and backend permission enforcement
Activity Logs
Comprehensive audit trail for all actions. Track field-level changes, multiple actor types, and export to CSV for compliance.
- Comprehensive audit trail for all actions
- Field-level change tracking (old value → new value)
- Multiple actor types (User, AI Agent, System)
- Export to CSV for compliance
AI Agent (MCP)
Model Context Protocol integration for AI assistants. Natural language data queries and mutations with RBAC-aware tool execution.
- Model Context Protocol integration for AI assistants
- Natural language data queries and mutations
- RBAC-aware tool execution
- WebSocket streaming for real-time responses
Session Management
Advanced session management with cross-origin support. Safari/iOS authentication fallback and multi-device session tracking.
- Cross-origin cookie support for separate frontend/backend domains
- Safari/iOS authentication fallback with Authorization headers
- Multi-device session tracking and remote revocation
- Activity logging for authentication events
Storage Backends
Flexible file storage with multiple backend options. Dynamic backend selection, public and private storage separation, and CDN integration.
- Flexible file storage with AWS S3, Cloudflare R2, Backblaze B2
- Dynamic backend selection based on environment
- Public and private storage separation
- CDN integration for translations and assets
Kwame Nyanning - CEO, blkbx
"The Saas Boilerplate was a huge reason we were so successful, because all these little seemingly unrelated tasks and integrations needed to happen. If we had been working with anybody else, It would have probably taken months to do the same work."
KWAME NYANNING
•CEO, blkbx.
Let our experts help you
Get professional onboarding and support to accelerate your SaaS development