Next.js SaaS starter documentation
Practical setup and implementation guides for the Sushi SaaS starter.
Account Export and Erasure
Configure privacy data inventory, authenticated exports, delayed account erasure, provider cleanup, pseudonymization, and cancellation safeguards.
Organization Credit Ledger
Understand pooled organization credits, append-only accounting, expiry, idempotent spending, and refunds.
Architecture and Error Contracts
Understand Sushi SaaS's enforced application layers, browser data flow, authorization boundary, and translated no-leak error system.
Authentication and Admin
Configure Better Auth, account identity, organization creation, and the separate MFA-protected admin application.
Database and Migrations
Work safely with the PostgreSQL schema, Drizzle migrations, test database, and production migration runner.
Deployment and Security Checklist
Deploy the web and admin apps with explicit migrations, cron, readiness, trusted networking, and production security controls.
Transactional Email
Configure Resend, React Email templates, safe local auth links, and durable delivery jobs.
Durable Jobs and Readiness
Operate the PostgreSQL job queue, cron runner, retries, deduplication, liveness and dependency-readiness probes.
Structured Logging
Operate Sushi SaaS with structured, correlated, redacted logs across Node and edge runtimes.
Slack Operations Notifications
Route operational events to Slack through the durable job queue without leaking sensitive data.
Organizations, Teams, and Tenancy
Configure personal workspaces, member roles, invitations, seat limits, tenant scoping, pooled credits, and organization billing.
Plans, Limits, and Entitlements
Customize Free, Plus, and Max capabilities, organization limits, Stripe mappings, grace periods, stacked subscriptions, and support overrides.
Quick Start
Run the Sushi SaaS web and admin apps locally with the supported Node, pnpm, PostgreSQL, and Redis setup.
Reservations Feature
Enable the opt-in reservation workflow with concurrency-safe holds, Stripe checkout, email, and calendars.
Private Storage Uploads
Configure private S3-compatible uploads with policy, entitlement, quota, checksum, and durable deletion controls.
Stripe Billing
Configure subscription prices, idempotent checkout, webhooks, credits, portal safety, and reconciliation.
Text-to-Video Task Pattern
Extend the opt-in text-to-video demo with organization entitlements, quotas, credits, idempotency, and refunds.