Home Assistant Configuration

This repository contains the configuration files, custom components, and resources for a Home Assistant instance. It is designed to be modular, maintainable, and easy to extend for smart home automation and monitoring.

Features

• Modular YAML configuration (split by domain)
• Custom components and integrations
• Device and area organization
• Automations, scripts, and scenes
• Backup and recovery files
• Community and custom Lovelace UI resources

Directory Structure

• configuration.yaml — Main entry point for Home Assistant
• automations.yaml — All automations (or automation/ folder if split)
• custom_components/ — Custom integrations
• www/ — Lovelace UI resources (cards, icons, images)
• sensors/, switches.yaml, scenes.yaml, etc. — Domain-specific configs
• secrets.yaml — Sensitive credentials (not for public sharing)
• backups/ — Backup files
• .storage/ — Home Assistant internal storage (do not edit manually)

Setup

1. Clone this repository:

   git clone https://github.com/maximunited/hass.git

2. Copy the example secrets file and fill in your own values:

   cp secrets.yaml.sample secrets.yaml
   # Then edit secrets.yaml and provide your real credentials and secrets

3. Review and adjust configuration.yaml for your environment.
4. Place custom resources in custom_components/ and www/ as needed.
5. Start Home Assistant (Docker, venv, or supervised).

Pre-commit Hooks

This repository includes pre-commit hooks to validate and format YAML files before commits.

Installation

1. Install pre-commit and dependencies:

   pip install -r requirements-dev.txt
   # Or install individually:
   pip install pre-commit yamllint

2. Install the git hooks:

   pre-commit install

Usage

Pre-commit hooks will automatically run on git commit. They will:

• Check YAML syntax
• Lint YAML files for style issues
• Remove trailing whitespace
• Ensure files end with newlines
• Validate Home Assistant configuration (if hass command is available)
• Check for merge conflicts and private keys

To run hooks manually on all files:

pre-commit run --all-files

To skip hooks for a specific commit:

git commit --no-verify

Contributing

Pull requests are welcome! Please:

• Follow the existing file structure and naming conventions
• Test your changes before submitting
• Do not include sensitive information

License

See LICENSE for details.

Credits

• Home Assistant
• Community custom components and card authors

---

For questions or suggestions, open an issue or contact the repository maintainer.