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.