Processes
Operational runbooks for building, releasing, and deploying the system.
- Releases & deploys — how modules, dashboards, and
customers are released (git tags → GitHub Actions → R2 + registry), and the
guided
pnpm deploy:customer/deploy:module/deploy:dashboardwrappers. - CI/CD setup — first-time configuration: secrets, publisher tokens, and the GitHub Actions variables the release workflows need.
The three release "kinds"
| Kind | What ships | Tag pattern |
|---|---|---|
| Module | A reusable HA config module (authored under home-assistant/modules/) | module/<name>-v<semver> |
| Customer | A customer's config bundle (e.g. pisarna_ha) | customer/<key>-v<semver> |
| Dashboard | The dashboard SPA build | dashboard/v<semver> |
All three share the same backbone: a git tag triggers a build, the build is published to Cloudflare R2 and recorded in the API's registry, and devices pull the new version on check-in. See Releases & deploys for the full flow.