Getting Started
Get up and running with the boilerplate in minutes.
Overview
This guide walks you through setting up the project locally. By the end, you'll have:
- Next.js app running on
localhost:3000 - Local Supabase on
localhost:54321
Stripe forwarding is a separate billing step after the app runs locally.
Prerequisites
Before starting, ensure you have:
- Node.js 20+ for the current managed-deployment and hosted-test helpers
- Bun for dependency installation, the local app, and project CLIs
- Docker for local Supabase
- Stripe CLI for webhook testing
- Git for version control
Quick Start
Clone and Install
git clone <your-repo-url>
cd your-project
bun installStart Supabase
bunx supabase startThis starts PostgreSQL, Auth, and other Supabase services locally.
Do not run supabase init; this template already includes the Supabase config,
migrations, and local auth settings.
Configure Environment
./coremvp env syncThe template CLI creates .env.local, reads local Supabase status, and writes
the local runtime values.
Start Development
bun run devVisit http://localhost:3000 to see your app.
./coremvp env sync expects local Supabase to already be running. The app
itself runs with bun run dev.
Troubleshooting
If local Supabase fails with
template database "template1" has a collation version mismatch, recreate the
local Supabase data volume:
bunx supabase stop --no-backup
bunx supabase startThis deletes local Supabase data for this template checkout.
Next Steps
Project Structure
Understand the codebase
Configuration
Environment variables
Payments
Configure Stripe and test billing
Was this page helpful?