saas-base
A starting point for building a Vite + Supabase + Stripe SaaS by handing the code to an AI. The folder rules from FSD’s six layers, a phase flow, and the automation entry points are all set up on top of the assumption that you work through Claude Code or Codex, which means the structure stops drifting after the first two or three prompts.
This page is just the fork. The single table below picks your row, then you jump straight to that spot.
Where to start
Section titled “Where to start”| If you are | Go to |
|---|---|
| Not a full-time developer — first time with a terminal, with git, with Supabase, with Stripe | Beginner manual |
| Comfortable with React and TS, first time with Supabase, Stripe, or FSD | Beginner manual, prerequisites through first-run, then Expert manual |
| Already shipped a SaaS on Supabase and Stripe | Expert manual, straight to architecture |
If none of the three rows is an obvious fit, pick the first one. The beginner manual moves one action per step, so anything that already feels familiar you can skim past.
How the two manuals differ
Section titled “How the two manuals differ”The expert manual reads as short reference. It assumes the words ADR, FSD’s six layers, adapter, RLS, and webhook already feel familiar, and it stays close to the reasoning behind each decision. Six sections — intro, architecture, verification, build-and-package, distribution, and updates.
The beginner manual moves step by step. It assumes you are comfortable with the idea of an AI writing code, but maybe new to a terminal, to git, to Node, to a Supabase account, or to a Stripe account. The text walks alongside you and tells you what the screen should look like when things are right. Index plus eleven steps.
Two halves of the same base, told in two paces. The tone differs but the code and commands stay the same.
What’s the same either way
Section titled “What’s the same either way”The first run only spins up the Vite dev server. No Supabase account, no Stripe account at that point. You watch pnpm dev paint a screen at http://localhost:5173, and the actual backend wiring waits until your SaaS has a shape worth wiring to. The phase flow is cut into one through six up front, and one phase has to finish before the next one starts.
The AI entry points are /start (one line in Claude Code) and AGENTS.md at the repo root for Codex. Both routes point at the same canonical doc, AI_AUTOMATION.md.
The license is All Rights Reserved with a commercial license model on top. Payment flow and a lawyer-reviewed COMMERCIAL-LICENSE.md are still in progress, which means actual sales wait on those two. The manual and the landing are public, so this page you are reading stays public as it is.
Once you picked your row, head straight to the Expert manual or the Beginner manual.