pealdevDOCS
Back to peal.dev

SAAS STARTER · GETTING STARTED

Getting started

Clone the repo, copy the env file, run two commands. That's the whole setup.

Prerequisites

Node 20+ and bun. That's it. We use bun because npm install is slow and we're impatient.

1. Clone your repo

After purchase you get an invite to your private GitHub repo. Yours forever — fork it, modify it, ship it. No license check, no phone-home.

Terminal
git clone git@github.com:peal-dev/your-template.git
cd your-template
bun install

2. Set up your env

Copy .env.example to .env.local and fill in the values marked REQUIRED. Required: DATABASE_URL, AUTH_SECRET, STRIPE_SECRET_KEY, RESEND_API_KEY. Optional providers can wait.

Terminal
cp .env.example .env.local

3. Run it

One command. Open http://localhost:3000.

Terminal
bun dev

The bug we hit

If bun dev crashes with a Postgres error, your DATABASE_URL is pointing somewhere that doesn't exist yet. Spin up a Postgres on Neon or Supabase free tier in 30 seconds and re-run.