Installation#

Development with Dev Containers#

The easiest way to get started is using a Dev Container.

Prerequisites#

Steps#

  1. Clone the repository and open it in VS Code.

  2. VS Code will prompt “Reopen in Container” — click it.

  3. Wait for the container to build. The postCreate script will install Node.js, npm dependencies, Python dependencies, pre-commit hooks, and development tools (Claude Code CLI, just task runner, GitHub CLI).

  4. Copy .env.example to .env and fill in the required values:

    cp .env.example .env

  5. Start the dev server:

    npm run dev

  6. The app is available at http://localhost:5173.

Running Checks#

Before committing, run just check to lint, test, and build docs in parallel. See Developer Workflow for the full set of commands.

Production Deployment#

See Helm Deployment for Helm installation, configuration, and Ingress/TLS setup.