Dev Environment Setup

Create accounts and install tools so you can develop, deploy, and collaborate using your GitHub identity.

Dev Environment Setup

Get your tools and accounts ready so you can develop, deploy, and collaborate.

This page walks you through setting up GitHub, Git, Node.js, Vercel, Supabase, and Cursor IDE. All other tools connect through GitHub, so we start there.


1. Create Your GitHub Account

All other tools will connect to GitHub, so start here.

  • Go to github.com and click Sign up
  • Create a username, email, and password
  • Verify your email (check your inbox and click the GitHub link)
  • (Optional) Add a profile photo and full name
  • Stay signed in—you'll use GitHub to log into other tools

2. Install Git

Git is version control software that tracks changes to your code and syncs with GitHub.

macOS

  • Open Terminal
  • If you don't have Homebrew, install it from brew.sh
  • Run:
brew install git
  • Verify installation:
git --version

Windows

git --version

Set Your Git Identity

Run these commands with your name and email (use the same email as your GitHub account):

git config --global user.name "Your Name"
git config --global user.email "you@example.com"

3. Install Node.js

Node.js is needed to run JavaScript tools like Next.js and various CLIs.

  • Download the LTS version (not Current)
  • Run the installer and accept defaults
  • Verify installation:
node --version
npm --version

4. Set Up Vercel

Vercel hosts your frontend and handles automatic deployments from GitHub.

  • Click Continue with GitHub
  • Approve GitHub access (so Vercel can see your repos)
  • In the dashboard, click New Project → Import Git Repository
  • Select your repo and click Deploy
  • Note your project URL once deployed

Optional: Vercel CLI

npm install -g vercel
vercel login

Follow the login prompt in your browser.


5. Set Up Supabase

Supabase provides your PostgreSQL database and authentication.

  • Click Start your project or Sign in, then Continue with GitHub
  • Approve GitHub access
  • In your dashboard, click New Project and give it a name
  • Choose the free tier and wait for project creation

Optional: Supabase CLI

macOS:

brew install supabase/tap/supabase

Windows:

npm install -g supabase

Verify installation:

supabase --version

For Local Development

If you plan to run Supabase locally, install Docker Desktop.


6. Install Cursor IDE

Cursor is an AI-powered code editor that will help you generate and refine code.

  • Click Download Cursor
  • Install the app (.dmg on Mac, .exe on Windows)
  • Open Cursor and Sign in with GitHub
  • Approve GitHub access to enable repo features
  • Create or open a new project folder

7. Verify Everything Works

Open Terminal (or Git Bash on Windows) and run these commands one by one:

git --version
node --version
npm --version
vercel --version    # if you installed Vercel CLI
supabase --version  # if you installed Supabase CLI

Then confirm:

  • Cursor is open and you're logged in
  • Vercel dashboard shows your GitHub profile
  • Supabase dashboard shows your GitHub profile

You're ready to build!


Ready to plan your project? Continue to Planning Worksheet.

Want to understand the workflow first? Read Finding Flow.