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

# Quickstart

> Run DealDash locally and verify baseline health in under 15 minutes.

## Prerequisites

* Node.js 24+
* `pnpm` 10+
* local Postgres/Supabase credentials
* `.env` based on project environment template

## Install and Run

```bash theme={null}
pnpm install
pnpm dev:full
```

`pnpm dev:full` runs backend and frontend together.

## Verify Baseline

```bash theme={null}
pnpm check
pnpm test:unit
pnpm test:integration
pnpm docs:check
```

Run `pnpm test:e2e` for UI/auth/public route changes.

## Common Local URLs

* app: `http://localhost:5173` (Vite default)
* API: `http://localhost:3333/api`
* health: `http://localhost:3333/api/health`

## First-Day Safety Rules

* keep PR scope narrow
* do not ship behavior changes without docs updates
* do not touch auth/public routes without tests