Skip to content

Contributing

Thank you for your interest in contributing to HAFO!

How to Contribute

Reporting Bugs

  1. Check existing issues first
  2. Use the bug report template
  3. Include debug logs and steps to reproduce

Suggesting Features

  1. Check existing feature requests
  2. Use the feature request template
  3. Explain the use case and benefits

Code Contributions

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Write tests
  5. Ensure linting passes
  6. Submit a pull request

Development Guidelines

Code Style

  • Follow the existing code patterns
  • Use type hints everywhere
  • Write docstrings for public functions
  • Keep functions focused and small

Commits

  • Use clear, descriptive commit messages
  • Reference issues where applicable
  • Keep commits atomic and focused

Pull Requests

  • Describe what changed and why
  • Link to related issues
  • Ensure CI passes
  • Respond to review feedback

Code of Conduct

Be respectful and constructive in all interactions. We're building something useful for the Home Assistant community.