Skip to content

A Flutter framework for real-time Zigbee2MQTT integration.

License

Notifications You must be signed in to change notification settings

alexander-zylla/zigbee_2_mqtt_flutter

Repository files navigation

zigbee_2_mqtt_flutter

A Flutter framework to integrate and interact with Zigbee devices through MQTT. This library simplifies the management and control of Zigbee devices in Flutter apps, providing an easy-to-use API for seamless device communication.


Features

  • 🏠 Zigbee Device Control: Effortlessly control Zigbee devices using MQTT.
  • 🚀 Modular and Extendable: Easily integrate with existing Flutter apps.
  • High Performance: Optimized for real-time device communication.
  • Conventional Commits and CI/CD: Integrated with tools like Husky for commit validation and Release Please for automated versioning.

Getting Started

Installation

Add the package to your pubspec.yaml file:

dependencies:
  zigbee_2_mqtt_flutter: ^1.0.0

Then run:

flutter pub get

Development

Commit Standards

This project uses Conventional Commits to ensure consistent commit messages. Husky is configured to validate commits locally before pushing.

Setting Up Husky

To add Husky for commit hooks in your Flutter project, run this command:

dart run husky install

Example Commit Messages:

  • feat: add new device control API
  • fix: resolve connection issue
  • docs: update README with usage instructions

To contribute, clone the repository and install dependencies:

git clone https://github.com/your-username/zigbee_2_mqtt_flutter.git
cd zigbee_2_mqtt_flutter
flutter pub get

Release Process

Automated releases are managed with Release Please. Push changes with proper commit messages, and the CI pipeline will handle versioning and changelogs.


Contributing

We welcome contributions! To get started:

  1. Clone the repository.
  2. Create a new branch for your feature or bugfix.
  3. Commit your changes following the Conventional Commits guidelines.
  4. Open a pull request with a clear description of your changes.

License

This project is licensed under the GNU General Public License v3.0.


Support

If you encounter any issues or have questions, feel free to open an issue or contact the maintainers.

Happy coding! 🎉

About

A Flutter framework for real-time Zigbee2MQTT integration.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published