Skip to main content

Home Assistant Pack documentation

Welcome to the documentation for the home-assistant-pack monorepo. This site is the single place to learn how the system is structured, how its apps and packages fit together, the operational processes (releases, CI/CD, registry), and the HTTP API.

What's here​

  • Architecture — how the system is composed and how the pieces relate.
  • Apps — the deployable applications in the monorepo.
  • Packages — the shared libraries.
  • Processes — releases, deploys, and CI/CD setup.
  • API Reference — interactive reference generated from the API's OpenAPI spec (rendered with Scalar).

How this site is built​

  • Docusaurus — the docs site.
  • The API reference is generated from apps/api/docs/openapi.json, which is regenerated on every build, so it stays in sync with the API.
  • Search runs fully offline (no external service).
Work in progress

The per-app and per-package pages are currently placeholders. They will be filled in incrementally. See the planning doc at .plans/2026-06-17_documentation-site-docusaurus-scalar.md.