Skip to main content

​
Setup in 5 Steps

1

Clone and Install

Clone the repo and install dependencies:
Terminal
# Clone the repo
git clone git@github.com:mahdijafaridev/shipfast-so.git [YOUR_APP_NAME]
    
# Navigate to project
cd [YOUR_APP_NAME]
    
# Install dependencies
npm i
    
# Remove git origin
git remote remove origin
2

Create Environment File

Copy the example file:
Terminal
cp .env.example .env.local
You’ll fill in .env.local in the next steps.
3

Create Supabase Project

Set up your database:
  1. Go to supabase.com/dashboard
  2. Click “New project”
  3. Fill in:
    • Name: your-app-name
    • Password: strong password (save it!)
    • Region: closest to you
  4. Click “Create new project”
Takes 1-3 minutes to spin up.
4

Get Your API Keys

Once your project is ready:
  1. Go to Settings → API Keys
  2. Create and copy these three values into .env.local:
  3. Publishable key (NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY)
  4. Secret key (SUPABASE_SECRET_KEY)
  5. Project ID (NEXT_PUBLIC_SUPABASE_URL): Project Settings > General settings > Project ID
Never commit .env.local or share the secret role key.
Your .env.local should look like this:
.env.local
NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY=sb_publishable_...
SUPABASE_SECRET_KEY=sb_secret_...
NEXT_PUBLIC_SUPABASE_URL=https://asdfawefasdflajfewjf.supabase.co
Leave other variables empty for now. You’ll fill them during auth, payments, and email setup.
5

Start Development Server

Fire it up:
Terminal
npm run dev
Open localhost:3000 🎉