Documentation

Practical setup and implementation guides for the Sushi SaaS starter.

Authentication & Admin Architecture

Deep dive into how this template handles Better Auth sessions, OAuth, RBAC, and business data modeling for credits and quota.

  • auth
  • admin
  • oauth

Accounts, Orders & Credits

Understand how users, orders, and the credits ledger work together in the Sushi SaaS template. Learn the balance formula, expiry handling, and the APIs/services to grant, consume, and inspect credits.

  • credits
  • orders
  • ledger

Logging & Observability

Structured logging for Node, Edge and Workers with request IDs, redaction and per-route examples. Works on Vercel, Cloudflare and Node servers.

  • logging
  • observability
  • Node

Notifications - Slack Alerts

Set up simple Slack notifications for uploads and payments, wire them into Stripe webhooks and storage errors, and customize alerts with a tiny server helper.

  • notifications
  • Slack
  • webhooks

Credits-Based Tasks — Text to Video

Add usage-based monetization with a generic tasks table, a credit ledger, and a pluggable text-to-video generator. Learn the schema, APIs, config constants, and a minimal UI to ship paid AI features fast.

  • credits
  • tasks
  • ai

Private File Uploads (S3 / R2)

A step‑by‑step, beginner‑friendly guide to adding user‑private uploads with S3‑compatible storage. Includes concepts, setup, env, API, UI, errors, and S3↔R2 migration.

  • storage
  • uploads
  • S3

Database Setup

Configure Postgres and Drizzle ORM — the backbone for auth, billing, storage, tasks, and app tables.

  • database
  • Drizzle
  • Postgres

Email Service (Resend)

Integrate transactional email with Resend. Verify your domain, create API keys, render welcome and payment emails on the server, and send through Resend with environment-based configuration.

  • email
  • Resend
  • templates

Quick Start

Get the Sushi SaaS template running locally with pnpm, explore i18n routes and health checks, and learn where to configure auth and billing.

  • setup
  • i18n
  • MDX

Reservations Feature — Availability, Deposits, Google Calendar

Enable a modular reservations feature with business-hours availability, Stripe Checkout deposits, webhook confirmation, ICS attachments, and Google Calendar links.

  • reservations
  • Stripe
  • calendar

Stripe Setup

Use Stripe Checkout for payments and finalize via webhooks to grant credits. Configure environment variables, create sessions, handle callbacks, and process signed webhook events.

  • Stripe
  • payments
  • webhook
Documentation · Sushi SaaS