Prerequisites
System requirements for self-hosting Supasheet
Required Software
Node.js 20+ (recommended) — 18 minimum
Vite 7 and TanStack Router require a current Node release. Node 20 LTS is the recommended runtime.
node --version # Should print v20.x.x or higher (v18.0+ is the floor)Install via nodejs.org, nvm, fnm, or your distribution's package manager.
Supabase CLI
Used to run a local stack, apply migrations, and generate types.
npm install -g supabase # or: brew install supabase/tap/supabase
supabase --versionDocker
Only required if you want to run Supabase locally (npx supabase start). Skip if you'll connect to Supabase Cloud directly.
docker --versionInstall Docker Desktop on macOS/Windows, or Docker Engine on Linux.
Git
To clone the repo:
git --versionRequired Accounts
- Supabase account — Sign up at supabase.com (free tier is enough to get started)
- A hosting provider for the static SPA — Vercel, Netlify, Cloudflare Pages, Render, your own VPS, etc.
Next Steps
- Environment Variables — Configure the app
- Database Setup — Apply migrations and expose the
supasheetschema - Deployment — Build and deploy