README.md

---
title: Bolt Run Backend
emoji: 🏃
colorFrom: green
colorTo: blue
sdk: docker
app_port: 7860
pinned: false
---

# Bolt Run Backend

Express + Cloud Firestore API for the Bolt Run app, deployed as a Hugging Face Docker Space.

## Required Space secrets

Set these under **Settings → Variables and secrets** (as **Secrets**):

| Name | Value |
|------|-------|
| `FIREBASE_SERVICE_ACCOUNT_JSON` | The full contents of your `firebase-service-account.json` file (paste the whole JSON). |
| `JWT_SECRET` | Your JWT signing secret. |
| `JWT_EXPIRES_IN` | e.g. `7d`. |

The container listens on port `7860`. Health check: `GET /health`. API base: `/api`.