Contributing

Hauser is a personal open-source project. Focused contributions are welcome and reviewed as capacity allows.

Most useful right now

• Installation reports from real Linux, Docker, amd64 and arm64 environments.
• Home Assistant topology findings: Areas, entity names, reconnects.
• Small fixes for setup, migration, persistence and advertised controls.
• Documentation that removes ambiguity.
• Translation reviews by native speakers.
• Accessibility: keyboard, focus, contrast, reduced motion.

Before writing code

A small, self-contained fix can go straight to a pull request. Open a contribution proposal issue first for a new integration, a configuration-contract change, a redesign, new persistent data or a dependency with runtime impact.

Pull requests

Run npm test, npm run check and npm run build in app/. Run npm run build:demo when the UI changes. The workflow repeats them. Contributions need the CLA, which a bot asks for on the first pull request.

Issues

Use the issue chooser: bug report, installation report, documentation or translation, proposal. English or German.

Full text: CONTRIBUTING.md, CODE_OF_CONDUCT.md, SECURITY.md.