# manifest.domain.matches_directory

> **Generated from `RuleDefinition` metadata.** Edit only the section below the
> "HANDWRITTEN BELOW" marker; everything above is regenerated by
> `hasscheck docs-render`.

## Summary

manifest.json domain matches integration directory

## Why

The manifest domain must match the name of the integration directory under custom_components/. A mismatch causes Home Assistant to silently misidentify the integration, breaking HACS discovery and core platform loading. Note: this rule cannot be overridden via hasscheck.yaml.

## Status behavior

| Field | Value |
|---|---|
| Category | manifest_metadata |
| Severity | required |
| Overridable | False |
| Version | 1.0.0 |

## Source

- https://developers.home-assistant.io/docs/creating_integration_manifest
- `source_checked_at`: 2026-05-01

<!-- HANDWRITTEN BELOW THIS LINE -->

## Examples

### Passing

```json
// custom_components/my_sensor/manifest.json
{
  "domain": "my_sensor",
  "name": "My Sensor"
}
```

The directory is `my_sensor/` and the manifest domain is `"my_sensor"` — they agree.

### Failing

```json
// custom_components/my_sensor/manifest.json
{
  "domain": "wrong_domain",
  "name": "My Sensor"
}
```

The directory is `my_sensor/` but the manifest domain is `"wrong_domain"` — HassCheck reports FAIL.
