Ship in 5 minutes

The express path from a fresh clone to a running app. Each step links to the full reference if you need more detail.

Before you start

Node.js 18.18 or newer (Node 20 LTS recommended).
A package manager: npm, pnpm or yarn.
Free accounts for Supabase, Stripe and Mailgun. Test tiers are enough to build and ship.

Clone and install

Grab the code and install dependencies.

git clone <your-repo> shipveryfast
cd shipveryfast
npm install

Configure your environment

Copy the example env file and fill in your keys. The app validates env at startup, so a missing variable fails fast with a clear message. See Environment variables for where each value comes from.

cp .env.example .env.local

Set up the database

Apply the included migration to your Supabase project. It creates every table, RLS policy and trigger in a single step. Use the Supabase CLI, or paste the file into the dashboard SQL editor.

terminal

# Option A, Supabase CLI
supabase db push

# Option B, paste this file into the dashboard SQL editor
# supabase/migrations/0001_initial_schema.sql

Run it

npm run dev

Open http://localhost:3000. Without Mailgun credentials, magic-link sign-in URLs print to your terminal, so you can test auth immediately.

Deploy

Push to GitHub, import the repo in Vercel, add your env vars, and ship. The full walkthrough and pre-launch checklist are in Deployment.

Going to production?

Walk the pre-launch checklist before you switch Stripe and Mailgun to live keys.

Next steps

Explore the featuresAuth, payments, database, email and AI.ConfigurationConnect Supabase, Stripe and Mailgun.Security modelRate limiting, CSRF and audit logging.Project structureSee where everything lives.