Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Development Setup

Prerequisites

  • Rust (nightly toolchain for formatting and clippy; rust-version = "1.85" edition 2024)
  • mise — tool version manager
  • just — command runner
  • direnv — environment setup
  • sops — secrets encryption
  • Node.js 24+ (managed by mise, used for Tailwind CSS)

One-time Setup

Install and update all required tools:

just install-tools

This installs the nightly toolchain, wasm32 target, cargo extensions, and any other project tools.

Secrets Configuration

just config

This opens the encrypted config.sops.env file for editing. See Configuration Reference for all available settings.

Building

just build

Running

just run

The application will be available at http://localhost:8080 by default.

Integration Tests

Integration tests require Docker via Colima:

colima start
just test
colima stop

See Commands for the full list of test commands.