> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/gsinghjay/astro-shadcn-sanity/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Get the YWCC Capstone project running locally in under 5 minutes.

<Steps>
  <Step title="Clone the repository">
    ```bash theme={null}
    git clone git@github.com:gsinghjay/astro-shadcn-sanity.git
    cd astro-shadcn-sanity
    ```

    <Note>You need a GitHub account with SSH keys configured. If you prefer HTTPS, use `https://github.com/gsinghjay/astro-shadcn-sanity.git` instead.</Note>
  </Step>

  <Step title="Install dependencies">
    ```bash theme={null}
    npm install
    ```

    This is an npm workspaces monorepo. A single `npm install` from the root installs dependencies for both the `astro-app` and `studio` packages.
  </Step>

  <Step title="Configure environment variables">
    Create a `.env` file inside the `astro-app/` directory:

    ```bash theme={null}
    cp astro-app/.env.example astro-app/.env
    ```

    Then open `astro-app/.env` and fill in your Sanity project credentials at minimum:

    ```bash theme={null}
    PUBLIC_SANITY_STUDIO_PROJECT_ID=your_project_id
    PUBLIC_SANITY_DATASET=production
    ```

    <Tip>Find your Sanity project ID at [sanity.io/manage](https://sanity.io/manage). Select your project — the ID is in the URL and on the project overview page.</Tip>

    See [Environment variables](/setup/environment) for the full list of available variables.
  </Step>

  <Step title="Start the development servers">
    ```bash theme={null}
    npm run dev
    ```

    This command starts both servers concurrently:

    | Server        | URL                                            | Description                 |
    | ------------- | ---------------------------------------------- | --------------------------- |
    | Astro app     | [http://localhost:4321](http://localhost:4321) | The frontend website        |
    | Sanity Studio | [http://localhost:3333](http://localhost:3333) | The CMS authoring interface |
  </Step>

  <Step title="Sign in to Sanity Studio">
    Open [http://localhost:3333](http://localhost:3333) and sign in with the same provider (Google, GitHub, or email) you used when creating your Sanity project.

    Once signed in, you can create and edit content that immediately reflects in the Astro app on the next build or hot reload.
  </Step>
</Steps>

## Next steps

<CardGroup cols={2}>
  <Card title="Prerequisites" icon="list-check" href="/setup/prerequisites">
    Verify you have all required accounts and tools installed.
  </Card>

  <Card title="Environment variables" icon="key" href="/setup/environment">
    Explore all configuration options including Visual Editing and multi-site support.
  </Card>

  <Card title="Local development" icon="terminal" href="/setup/local-development">
    Learn all available dev commands, test runners, and Storybook.
  </Card>

  <Card title="Block library" icon="blocks" href="/blocks/overview">
    Understand how pages are built from reusable content blocks.
  </Card>
</CardGroup>