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

Examples

Every example is a real, runnable haw.toml in the repo under examples/. Clone it (or copy the manifest), then haw sync and explore. The domain examples compose real public upstream repos, so haw sync needs network; a few build steps use Docker (noted per example).

Start with quickstart, then jump to whichever domain matches your fleet.

Learn-by-doing

ExampleWhat it shows
quickstartTwo octocat repos + a stack — the whole sync → status → lock → verify loop (the course walks it).
haw-helloA tiny plugin — the haw <name>haw-<name> contract in ~20 lines.
governance[plugins] lifecycle hooks — SBOM / provenance / gate wired to phases.

By domain

ExampleDomainWhat it shows
microservicesBackend4 services + a shared proto/lib; a feature branched, PR’d, and landed together in dependency order.
ml-platformML / dataModel + data-pipeline + serving-infra pinned as one reproducible baseline, with stacks + an overlay.
automotiveEmbedded / AUTOSARARXML config + shared HAL + two ECU apps, cross-toolchain builds, [plugins] misra + aspice.
automotive-pinnedEmbeddedA fully SHA-pinned automotive fleet — the reproducibility/audit baseline.
embedded-bspEmbeddedA shared BSP/HAL reused across ECU stacks via overlays.
embedded-realEmbeddedFive real upstreams (CoreMark, cJSON, Monocypher, libcanard, Mbed-TLS) — all build with one haw build -j4 (validated).
rpi-picoEmbedded / firmwareTwo real Raspberry Pi Pico (RP2040) firmwares (embassy blinky + rp-hal) cross-compiled to Cortex-M0+ with Rust’s built-in thumbv6m-none-eabi — no ARM toolchain — plus cJSON (ctest 19/19). Build+test validated; all three have active GitHub Actions CI.
devops-infraDevOps / InfraThree real upstreams — terraform-aws-vpc (init+validate), Prometheus helm-charts (helm lint), a Dockerfile app (docker build+hadolint) — build+test 3/3 (validated).
ml-aiML / AIReal from-source LLM runtime — llama.cpp compiled to llama-cli + nanoGPT parse-check, build+test 2/2 (validated).
mobileMobileApp+SDK pinned in lockstep — OkHttp SDK builds+tests for real via a JDK-21 Docker image; the Now-in-Android app half is a pattern (needs Android SDK).

Real build & emulation recipes

For copy-paste build/test wiring to real toolchains — Docker cross-compile (Cortex-M4), FreeRTOS booted under QEMU, and patterns for EB tresos / Vector / Green Hills / IAR / Tasking / Zephyr / Renode — see Integration recipes.