{
  "markdown": "---\ntype: \"Repository Guide\"\ntitle: \"Custom Zone\"\ndescription: \"Documents Custom Zone for the homeassistant-customzones repository.\"\ntimestamp: 2026-07-28T21:55:36Z\nauthority: canonical\nverification: untested\nowner: polaralias\ntags:\n  - homeassistant-customzones\n  - repository-guide\nnavigation:\n  role: entry-point\n  order: 10\n---\n<p align=\"center\">\n  <img src=\"CustomZones%20Banner.png\" alt=\"CustomZones banner\" width=\"960\" />\n</p>\n\n# Custom Zone\n\nCustom Zone is a Home Assistant custom integration for polygon-based presence zones.\n\n## What It Does\n\nThe integration lets you define a polygon in the Home Assistant UI, attach one or more `person` or `device_tracker` entities to it, and expose an aggregate sensor that reports how many tracked entities are currently inside the zone.\n\n## Core Features\n\n- polygon-based zone definition from the Home Assistant UI\n- one or more tracked entities per zone\n- aggregate zone sensor output\n- options flow for renaming the zone, changing trackers, and editing the polygon\n- in-repo geometry rules and tracker-confidence handling\n\n## Installation\n\n### Preferred: HACS\n\n1. Go to **HACS -> Integrations**.\n2. Open the three-dot menu and choose **Custom repositories**.\n3. Add this repository URL.\n4. Choose **Integration** as the category.\n5. Install **Custom Zone**.\n6. Restart Home Assistant.\n\n### Fallback: Manual\n\n1. Copy `custom_components/custom_zone` into your Home Assistant `config/custom_components/` directory.\n2. Restart Home Assistant.\n\n## How To Use It\n\n1. Add the **Custom Zone** integration.\n2. Enter a unique zone name.\n3. Select one or more `person` or `device_tracker` entities.\n4. Add at least three polygon points.\n5. Use the created sensor to track how many entities are currently inside the zone.\n\n## Documentation\n\nStart with:\n\n- [docs/product-specs/custom-zone-contract.md](docs/product-specs/custom-zone-contract.md)\n- [ARCHITECTURE.md](ARCHITECTURE.md)\n- [docs/RELIABILITY.md](docs/RELIABILITY.md)\n\nFor repository workflow and agent-focussed context, read [AGENTS.md](AGENTS.md).\n\n## Repository knowledge\n\n- [Documentation map](docs/knowledge/documentation-map.md) — RKE-managed reading order and relationship hub.\n",
  "bytes": 2183,
  "sha": "39f1df0c86099cdefdfef5d1f87e4947e751f5619a95562dc9cb83d78a92c38f",
  "repo_slug": "polaralias/homeassistant-customzones",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/okf_polaralias_homeassistant_customzones_doc_e4aaeaf2/readme"
}