📖 Overview

SaaS Forge is a production-ready, full-stack SaaS boilerplate built with modern technologies. Launch your SaaS product in days, not months. Built with scalability, performance, and developer experience in mind.

Why SaaS Forge?

• ⚡ Lightning Fast Setup - Get up and running in minutes with automated CLI
• 🏗️ Production Ready - Battle-tested architecture used in real products
• 🎨 Beautiful UI - Pre-built components with shadcn/ui and Tailwind CSS
• 🔐 Enterprise Auth - Complete authentication with social logins and email verification
• 💳 Payment Integration - Built-in payment handling with webhooks
• 📱 Responsive Design - Mobile-first approach with modern aesthetics
• 🚀 Optimized Performance - Redis caching, React Query, and Next.js 15 optimizations
• 🧪 Type Safe - End-to-end type safety with TypeScript and tRPC
• 📦 Monorepo Architecture - Organized with Turborepo for scalability
• 🎯 Developer Experience - Hot reload, ESLint, Prettier, and comprehensive tooling

✨ Features

📄 Content Management

• Notion CMS Integration - Manage content directly from Notion
• Dynamic landing pages
• Documentation system
• Legal pages (Terms, Privacy, Refund Policy)
• Newsletter & support forms
• n8n webhook automation

📊 Observability & Monitoring

• Centralized logging with Winston
• Logtail integration for log aggregation
• Request/response logging for Notion API
• Performance monitoring hooks

🚀 Quick Start

Using CLI (Recommended)

npx saas-forge my-saas-app
cd my-saas-app
pnpm install
pnpm dev

Manual Installation

# Clone the repository
git clone https://github.com/anoopkarnik/saas-forge.git
cd saas-forge

# Install dependencies
pnpm install

# Copy environment variables
cp apps/web/.env.example apps/web/.env

# Generate Prisma client
pnpm run generate

# Run development server
pnpm dev

Visit http://localhost:3000 to see your app! 🎉

📚 Documentation

Environment Configuration

Create a apps/web/.env file with the following variables:

# Database
DATABASE_URL="postgresql://..."

# Redis (Upstash)
UPSTASH_REDIS_REST_URL="https://..."
UPSTASH_REDIS_REST_TOKEN="..."

# Better Auth
BETTER_AUTH_SECRET="..."
BETTER_AUTH_URL="http://localhost:3000"

# OAuth Providers
AUTH_GITHUB_ID="..."
AUTH_GITHUB_SECRET="..."
AUTH_GOOGLE_ID="..."
AUTH_GOOGLE_SECRET="..."
AUTH_LINKEDIN_ID="..."
AUTH_LINKEDIN_SECRET="..."

# Email (Resend)
RESEND_API_KEY="..."

# Notion CMS
NOTION_API_KEY="..."
LANDING_DATABASE_ID="..."
DOCUMENTATION_DATABASE_ID="..."

# Payments (Dodo)
DODO_API_KEY="..."
DODO_WEBHOOK_SECRET="..."

# Observability
BETTERSTACK_TELEMETRY_SOURCE_TOKEN="..."
BETTERSTACK_TELEMETRY_INGESTING_HOST="..."

# Webhooks (n8n)
N8N_SUPPORT_WEBHOOK="..."
N8N_NEWSLETTER_WEBHOOK="..."
N8N_CHATBOT_WEBHOOK="..."

See apps/web/.env.example for a complete list.

🏗️ Tech Stack

Tooling & DevOps

• Monorepo: Turborepo + pnpm workspaces
• Testing: Vitest
• Linting: ESLint 9 + Prettier
• CI/CD: GitHub Actions
• Deployment: Vercel (recommended)

📦 Project Structure

saas-forge/
├── apps/
│   └── web/                    # Main Next.js application
│       ├── app/                # App router pages
│       │   ├── (auth)/        # Authentication pages
│       │   ├── (home)/        # Protected home pages
│       │   ├── landing/       # Public landing pages
│       │   └── api/           # API routes
│       ├── blocks/            # Page-level components
│       ├── components/        # Feature components
│       ├── lib/               # Utility functions
│       ├── server/            # Server-side utilities
│       └── trpc/              # tRPC configuration
│
├── packages/
│   ├── ui/                    # Shared UI components
│   ├── auth/                  # Authentication logic
│   ├── database/              # Prisma schema & client
│   ├── email/                 # Email templates
│   ├── cms/                   # Notion CMS integration
│   ├── observability/         # Logging utilities
│   ├── eslint-config/         # Shared ESLint config
│   └── typescript-config/     # Shared TS config
│
├── scripts/
│   └── cli.js                 # CLI for project scaffolding
│
└── templates/
    └── saas-boilerplate/      # Template for new projects

🎯 Commands

Development

# Start all workspaces in dev mode
pnpm dev

# Start only web app
pnpm --filter web dev

# Build all workspaces
pnpm build

# Build only web app
pnpm --filter web build

Code Quality

# Lint all workspaces
pnpm lint

# Lint with auto-fix
pnpm --filter web lint:fix

# Format code with Prettier
pnpm format

# Type check
pnpm --filter web typecheck

Database

# Generate Prisma client
pnpm --filter @workspace/database postgres:generate

# Run migrations
pnpm --filter @workspace/database postgres:migrate

# Reset database (⚠️ destroys data)
pnpm --filter @workspace/database postgres:reset

Testing

# Run all tests
pnpm --filter @workspace/cms test

# Run specific test file
pnpm --filter @workspace/cms test -- testing/index.test.ts

🎨 Adding UI Components

SaaS Forge uses shadcn/ui for components. To add a new component:

# Add a component (e.g., button)
pnpm dlx shadcn@latest add button -c apps/web

# Import in your code
import { Button } from "@workspace/ui/components/button"

Components are automatically placed in packages/ui/src/components and can be used across all apps.

🔧 Customization

Theming

Modify theme colors in apps/web/app/globals.css:

@layer base {
  :root {
    --primary: 222 47% 11%;
    --primary-foreground: 210 40% 98%;
    /* ... more variables */
  }
}

Content Management

All content is managed through Notion databases:

1. Landing Page: Configure in Notion database specified by LANDING_DATABASE_ID
2. Documentation: Configure in Notion database specified by DOCUMENTATION_DATABASE_ID
3. Legal Pages: Managed through the same landing database with filters

Update content in Notion, and it reflects automatically on your site!

Authentication Providers

Add/remove providers in packages/auth/src/better-auth/auth.ts:

socialProviders: {
  github: {
    clientId: process.env.AUTH_GITHUB_ID!,
    clientSecret: process.env.AUTH_GITHUB_SECRET!,
  },
  // Add more providers...
}

🚢 Deployment

Vercel (Recommended)

1. Push your code to GitHub
2. Import project in Vercel
3. Add environment variables
4. Deploy!

Other Platforms

SaaS Forge works with any platform that supports Next.js:

• Railway: Railway.app
• Fly.io: Fly.io
• AWS Amplify: AWS Amplify
• Digital Ocean: App Platform

🤝 Contributing

We love contributions! Please read our Contributing Guide before submitting a Pull Request.

Development Workflow

1. Fork the repository
2. Create a feature branch: git checkout -b feature/amazing-feature
3. Make your changes
4. Run tests: pnpm test
5. Commit changes: git commit -m 'Add amazing feature'
6. Push to branch: git push origin feature/amazing-feature
7. Open a Pull Request

Code Standards

• Write TypeScript with strict mode
• Follow ESLint rules
• Add tests for new features
• Update documentation
• Keep components small and focused
• Use semantic commit messages

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

Built with amazing open-source projects:

• Next.js - The React Framework
• shadcn/ui - Beautiful components
• Turborepo - Monorepo tooling
• tRPC - Type-safe APIs
• Prisma - Next-gen ORM
• Better Auth - Authentication solution
• Notion - Content management

💬 Support & Community

• 📧 Email: support@saasforge.dev
• 🐛 Issues: GitHub Issues
• 💡 Discussions: GitHub Discussions
• 🐦 Twitter: @anoopkarnik

🗺️ Roadmap

Current Focus

• ✅ Core authentication flows
• ✅ Payment integration
• ✅ Notion CMS integration
• ✅ Monorepo architecture

Upcoming Features

• 🔄 Multi-tenancy support
• 🔄 Advanced RBAC (Role-Based Access Control)
• 🔄 Team collaboration features
• 🔄 API key management
• 🔄 Advanced analytics dashboard
• 🔄 Email templates library
• 🔄 Mobile app support (React Native)
• 🔄 GraphQL support
• 🔄 i18n (Internationalization)
• 🔄 A/B testing framework

See our GitHub Projects for detailed progress.

⭐ Show Your Support

If you find SaaS Forge helpful, please consider:

• ⭐ Starring the repository
• 🐛 Reporting bugs
• 💡 Suggesting new features
• 📖 Improving documentation
• 🔀 Submitting pull requests