---
name: run-tests
description: Runs backend (Go) and frontend (Vitest) tests for the hnh-map monorepo. Use when the user asks to run tests, verify tests, or after making code changes that should be validated.
---

# Run tests

## When to run

- User asks to run tests, run the test suite, or verify tests pass.
- After implementing or changing code that should be validated by tests.

## What to run

Tests run **in Docker** via the Makefile; no local Go or Node is required.

From the repo root, use:

- **Both backend and frontend:** `make test` (runs backend then frontend tests in Docker).
- **Backend only:** `make test-backend`
- **Frontend only:** `make test-frontend`

These use `docker-compose.tools.yml`; the first run may build the backend-tools image.

## Scope

- **Backend-only changes** (e.g. `internal/`, `cmd/`): run `make test-backend`.
- **Frontend-only changes** (e.g. `frontend-nuxt/`): run `make test-frontend`.
- **Both or unclear**: run `make test`.

Report pass/fail and any failing test names or errors.