## Load testing

This folder contains lightweight load test scaffolding to validate API performance regressions.

### k6 (recommended)

1. Install k6 (macOS):

```bash
brew install k6
```

2. Run the smoke test against a running stack:

```bash
BASE_URL=http://localhost:8000 k6 run loadtest/k6/api-smoke.js
```

### Notes

- The scripts assume the FastAPI backend is reachable at `BASE_URL` and the API prefix is `/api/v1`.
- For authenticated endpoints, extend the script to login first and replay the cookie.


