docs/README.md

# docs/ — what's new & how to set it up fast

Reference for everything added on top of the base Chrome Space, so a fresh deploy (HF **or**
Docker) goes quick and error-free. Read in order:

| File | Covers |
|------|--------|
| [architecture.md](architecture.md) | One container: Chrome + extensions + monitor/gateway + 3 servers. Ports. |
| [persistence.md](persistence.md) | Staying logged in: Neon Postgres (HF) vs Docker volume (self-host). |
| [api-gateway.md](api-gateway.md) | The single gateway, `/gpt /gemini /flow` routing, `API_KEY` auth. |
| [deployment.md](deployment.md) | Deploy steps, required secrets, HF tokens, Docker build stages. |
| [troubleshooting.md](troubleshooting.md) | Every error we hit and its fix. **Check here first.** |

For **calling** the API see [`../HOWTOUSE.md`](../HOWTOUSE.md). For a quick start see
[`../SETUP.md`](../SETUP.md).

## Required secrets (set these or things silently break)

| Secret | Where | Without it |
|--------|-------|-----------|
| `DATABASE_URL` | HF only (Neon Postgres) | Logins lost on every restart |
| `API_KEY` | HF + Docker `.env` | All `/gpt /gemini /flow` return `503` |

Local credential notes live in gitignored files: `hf-token`, `neon-db`, `api-key`.