SaaSyBase Documentation
Welcome to the SaaSyBase knowledge base. Whether you're a developer building from scratch or a vibecoder using AI tools like Cursor or Windsurf, these guides walk you through every part of the platform — from your first npm run dev to production deployment, including the current Clerk, NextAuth, Better Auth, SEO, and content-management lanes.
Get Started
Getting Started
Install, point DATABASE_URL at PostgreSQL, run the baseline migrations, seed, and understand the shipped repo structure.
Admin Setup
Promote your first admin safely in development, during seed flows, or directly in production.
Local PostgreSQL
Choose between Docker and hosted Postgres for development, wire DATABASE_URL, and stay on the shared PostgreSQL migration lane.
Core Infrastructure
Authentication
Configure Clerk, Better Auth, or NextAuth, including GitHub and Google OAuth, and use the auth abstraction safely.
Payments
Configure Stripe, Paystack, Paddle, or Razorpay, understand catalog sync, pricing reality, and billing behavior.
Adding Payment Providers
Extend the payment abstraction with a new provider implementation, webhook handling, and tests.
Webhooks
Centralized payment ingress, provider-specific webhook aliases, Clerk sync, and signature verification.
Deployment
Deploy to Vercel, Coolify, or a VPS with webhook setup, cron, health checks, storage guidance, and optional Sentry setup.
Updates & Upgrades
Safely apply upstream SaaSyBase updates to a customized live install with staging, backups, migrations, rollback planning, and post-deploy checks.
Secrets & Providers
Default env-driven deployment guidance plus optional Infisical or Doppler bootstrap for centralized secret loading.
Product & Monetization
Pricing & Coupons
Recurring versus one-time plans, proration, top-ups, discounts, and the actual plan-management workflow.
Tokens & Features
Personal and organization token buckets, paid-token reset settings, caps, and feature gating.
Teams
Organization provisioning, invites, workspace switching, team token strategies, and member management.
Design & Customization
Content & Communication
SEO & Discoverability
Homepage metadata, title templates, social fallbacks, sitemap and robots generation, verification tags, and indexing defaults.
Content Management
Blog CMS, editable site pages, and unified image/file storage management.
Email & Notifications
Email templates, in-app notifications, support tickets, reply flows, and the public contact form.
Insights & Operations
Advanced
New to SaaSyBase?
Start with the Getting Started guide to install, run, and explore the project locally. Then check out Local PostgreSQL if you want database parity earlier, then Admin Setup so you can reach the control surface, then move into Authentication and Payments to configure your core infrastructure. After that, most teams branch into either monetization or SEO and discoverability planning, then into content management and branding work.
If you are using AI coding tools, feed them the same sequence: getting started, admin setup, authentication, payments, then deployment. That keeps generated changes aligned with the abstractions already used in the codebase.