Skip navigation

Documentation

Guides for running a private, open-source smart home — how to lay out your Home Assistant config repo, which integrations and devices fit your stack, and how the management catalog connects to your instance.

Config repository structure

Recommended layout for a Home Assistant config repo: which files are required, which are conventional, and what each one does. Read more →

Custom components via vendir

How vendir.yml drives the custom-component catalog: declare GitHub releases, sync into custom_components/, track versions. Read more →

Onboarding an instance

Connect a Home Assistant instance to Craftama Smart Home: URL + long-lived token, Git deploy key, optional Pangolin proxy, subscription tier. Open the HA Config dashboard →

Browsing the catalogs

The device catalog (Blakadder Zigbee + ESPHome) and the integrations index (HA core + custom components) — what's in each, and how to filter by vendor / category / domain / kind.

theme