Developer environment setup (frontend + monorepo-aware)

This document explains how to set up a local development environment and how to avoid common “CI passed locally but failed on GitHub” issues.

For backend-specific setup and local API testing flows in the monorepo, also read:

https://github.com/jerdaw/healtharchive/blob/main/docs/development/dev-environment-setup.md
https://github.com/jerdaw/healtharchive/blob/main/docs/development/live-testing.md

Local setup (frontend)

From frontend/:

npm ci
npm run dev

Full checks (what CI runs):

npm run check

Node.js 20.19+ is required. Both the monorepo root and frontend/ include .nvmrc files pinning the expected version for frontend tasks.

This repo includes a .pre-commit-config.yaml with fast, mechanical checks (whitespace/EOF fixes, YAML validation, detecting private keys).

Install once:

pipx install pre-commit

Enable “run on commit”:

pre-commit install

Run on demand:

pre-commit run --all-files

Monorepo convenience: if the repo-root venv already exists, you can run:

../.venv/bin/pre-commit run --all-files

This runs automatically on every git push and prevents pushing broken main:

./scripts/install-pre-push-hook.sh

To bypass once (emergency only):