Welcome! This guide will walk you through setting up your local development environment using Cursor, GitHub, and Supabase. Each step includes a hand-picked YouTube tutorial to make the process even easier.
We have linked to video tutorials for each section below.
1. Download and Install Cursor
- Go to cursor.com and click Download.
- Choose your operating system (Windows, Mac, or Linux) and download the installer.
- Run the installer and follow the prompts to complete installation.
- Open Cursor after installation is finished.
2. Fork and Clone the GitHub Repository
Fork the Repo:
- Visit the GitHub page for the project you want to build.
- Click the Fork button (top right) to create your own copy.
Clone in Cursor:
- In your forked repo, click the green Code button and copy the HTTPS or SSH URL.
- Open Cursor.
- Use the “Clone Repository” option (usually under File > Clone Repository or via the welcome screen).
- Paste the repo URL and choose a local folder to save the project.
- Click Clone. The code will be downloaded to your machine and opened in Cursor.
3. Create a Supabase Account and Project
- Go to supabase.com and sign up or log in.
- Click New Project.
- Enter a project name, password, and select a database region.
- Wait for the project to initialize (this may take a minute).
- In your project dashboard, go to Settings > API.
- Copy your Project URL and anon key (these are your environment variables).
4. Add Environment Variables in Cursor
- In Cursor, right-click your project folder and select New File.
- Name the file .env (include the dot at the start).
- Paste the following, replacing the values with your Supabase credentials:
VITE_SUPABASE_URL=your-project-url-here
VITE_SUPABASE_ANON_KEY=your-anon-key-here
5. Run the Project Locally
- Open a new terminal in Cursor (usually via Terminal > New Terminal).
- Install dependencies if needed (e.g., pnpm install).
- Start the development server:
pnpm run dev