SaaSForge Core Documentation
Learn how to set up, configure, and customize SaaSForge Core.
New to SaaSForge Core?
Start with the Getting Started guide to have your multi-tenant SaaS running in minutes.
Get StartedGetting Started
Clone, configure, and run locally
Introduction
Orientation for SaaSForge Core: workspaces, billing, and what ships in the repo.
SaaS Core Overview
How a member signs in, picks a workspace, and lands on the main app routes.
Getting Started
Clone, env vars, migrations, first login, and a workspace you can click through.
Installation
Node version, package install, local Supabase or remote project, and first boot.
Configuration & Environment Variables
Every env key the app reads, with notes on what must stay server-only.
Core Concepts
Workspaces, auth, schema, and example features
Architecture Overview
Where server components, route handlers, Supabase clients, and Stripe webhooks meet.
Authentication & Security
Email and OAuth sign-in, TOTP, SAML hooks, login history, and session refresh patterns.
Workspaces & Teams
Workspace records, invites, roles, transfers, and where RLS enforces isolation.
Data Model
Core tables, enums, and the RLS policies copied from shipped migrations.
Database Schema & Setup
Schema layout, indexes worth keeping, and how policies map to workspace IDs.
Dashboard & Analytics
Dashboard widgets, activity feeds, and the shortcuts wired for new workspaces.
Products & Data Management
Example CRUD module scoped to a workspace: tables, filters, and trash patterns.
Adding Your Own Model
Swap the sample Products entity for your domain model without breaking RLS.
Routes Reference
Exported route helpers in src/config/routes.ts and where they are consumed.
Advanced Features
API keys, audit trails, impersonation, webhooks, and other operator-facing tools.
UI Components
Map of every shadcn primitive and higher-order component, with editing patterns.
Integrations
Supabase, Stripe, Resend, and HTTP APIs
Supabase Setup
Create the Supabase project, apply SQL migrations, and connect keys locally.
Stripe Setup
Stripe Dashboard setup: products, prices, webhook endpoint, and signing secret.
Stripe Integration
How checkout, portal, and webhook events map to rows in this codebase.
Billing & Subscriptions
Billing UI, plan changes, invoices, and the server handlers behind them.
Resend Setup
Resend API keys, domains, and the templates used for invites and mail.
Credits System
Metering credits in the Core template: tables, cron touchpoints, and UI hooks.
RAG Pipeline
Pointer doc: full RAG lives in SaaSForge AI. Read this before porting pieces over.
API Reference
Route handlers and server actions exposed as HTTP APIs with payloads and errors.
Deployment & Customization
Ship, theme, and debug in production
Customization Guide
Branding tokens, copy config, pricing tables, and safe places to fork behavior.
Content Editing
Where every piece of marketing copy and long-form content lives, and how to edit it.
Theming
OKLCH palette, CSS variables, fonts, dark mode, and how to swap the brand palette.
White-Label & Selling Checklist
Rename the product, swap assets, and ship under your own legal pages.
Testing
Vitest setup for units and Playwright flows for critical auth and billing paths.
Deployment Guide
Vercel-first deploy notes plus what to change for other Node hosts.
Deployment Guide (Long Form)
Pre-deploy checklist, Vercel + Docker + VPS paths, env reference, monitoring, backups.
Troubleshooting
Frequent Supabase, Stripe, and env mistakes with fixes we have seen in support.
Need Help?
Can't find what you're looking for? Check out the Troubleshooting guide or reach out to our support team.