> ## Documentation Index
> Fetch the complete documentation index at: https://shipfast.so/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Getting Started

> Get your app running locally in 10 minutes

<Expandable title="Prerequisites">
  * Node.js 18.17+ (run `node -v` to check)
  * Code editor (VSCode, Cursor, etc.)
  * Terminal

  <Info>
    Old Node version? Update it first.
  </Info>
</Expandable>

## Setup in 5 Steps

<Steps>
  <Step title="Clone and Install">
    Clone the repo and install dependencies:

    ```bash Terminal theme={null}
    # 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
    ```
  </Step>

  <Step title="Create Environment File">
    Copy the example file:

    ```bash Terminal theme={null}
    cp .env.example .env.local
    ```

    You'll fill in `.env.local` in the next steps.
  </Step>

  <Step title="Create Supabase Project">
    Set up your database:

    1. Go to [supabase.com/dashboard](https://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"**

    <Note>
      Takes 1-3 minutes to spin up.
    </Note>
  </Step>

  <Step title="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`

    <Warning>
      Never commit `.env.local` or share the secret role key.
    </Warning>

    Your `.env.local` should look like this:

    ```bash .env.local theme={null}
    NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY=sb_publishable_...
    SUPABASE_SECRET_KEY=sb_secret_...
    NEXT_PUBLIC_SUPABASE_URL=https://asdfawefasdflajfewjf.supabase.co
    ```

    <Info>
      Leave other variables empty for now. You'll fill them during auth, payments, and email setup.
    </Info>
  </Step>

  <Step title="Start Development Server">
    Fire it up:

    ```bash Terminal theme={null}
    npm run dev
    ```

    Open [localhost:3000](http://localhost:3000) 🎉
  </Step>
</Steps>

***