Integration Quality Scale
WoowTech uses a quality scale to rate every integration. The grade reflects how good the integration is across four dimensions: the experience it gives end users, the breadth of its features, how clean the underlying code is, and how pleasant it is for other developers to work on.
The Graded Tiers
Four ranked tiers make up the scale. An integration only earns a given tier once it satisfies every rule for that tier plus all the rules of the tiers beneath it — the requirements stack.
🥉 Bronze
The entry-level bar that every brand-new integration has to clear. It guarantees a floor on code quality, working functionality, and user experience.
What a Bronze integration delivers:
- Setup that happens entirely through the interface
- Compliance with the project's fundamental coding conventions
- Automated tests covering the configuration flow
- Documentation that gets an end user up and running
🥈 Silver
Silver takes the Bronze foundation and hardens it, focusing on dependability when things don't go perfectly.
What Silver adds on top of Bronze:
- Everything Bronze guarantees
- A consistent experience even under adverse conditions
- At least one engaged code owner maintaining it
- Self-healing behavior when a connection drops
- The ability to prompt for re-authentication automatically
- Richer documentation that includes troubleshooting guidance
🥇 Gold
Gold is the benchmark for a polished user experience, with deep support for the devices and services the integration touches.
What Gold adds on top of Silver:
- Everything Silver guarantees
- Devices that get discovered automatically
- Complete translation coverage
- Thorough, user-oriented documentation
- The ability to push firmware or software updates to devices from inside WoowTech
- Diagnostic data and troubleshooting tooling
- A complete automated test suite
- A prerequisite for any device in the "Works with WoowTech" program
🏆 Platinum
The summit of the scale — reserved for integrations that demonstrate technical mastery and the cleanest possible code.
What Platinum adds on top of Gold:
- Everything Gold guarantees
- Source that is fully type-annotated throughout
- An entirely asynchronous codebase
- Data handling tuned for efficiency
Tiers Outside the Ranking
❓ No Score
Used for integrations that haven't been evaluated yet, or that no longer satisfy today's minimum Bronze bar. A fresh integration can never be assigned this label.
🏠 Internal
The foundational building blocks that make up WoowTech Core itself, maintained directly by the project.
💾 Legacy
Older integrations that can only be configured by hand in YAML and frequently no longer have anyone actively maintaining them.
📦 Custom
Integrations created by the community that don't ship as part of official releases. The WoowTech project neither reviews, audits, nor supports these.
Integration Quality Scale
WoowTech uses a quality scale to rate every integration. The grade reflects how good the integration is across four dimensions: the experience it gives end users, the breadth of its features, how clean the underlying code is, and how pleasant it is for other developers to work on.
The Graded Tiers
Four ranked tiers make up the scale. An integration only earns a given tier once it satisfies every rule for that tier plus all the rules of the tiers beneath it — the requirements stack.
🥉 Bronze
The entry-level bar that every brand-new integration has to clear. It guarantees a floor on code quality, working functionality, and user experience.
What a Bronze integration delivers:
- Setup that happens entirely through the interface
- Compliance with the project's fundamental coding conventions
- Automated tests covering the configuration flow
- Documentation that gets an end user up and running
🥈 Silver
Silver takes the Bronze foundation and hardens it, focusing on dependability when things don't go perfectly.
What Silver adds on top of Bronze:
- Everything Bronze guarantees
- A consistent experience even under adverse conditions
- At least one engaged code owner maintaining it
- Self-healing behavior when a connection drops
- The ability to prompt for re-authentication automatically
- Richer documentation that includes troubleshooting guidance
🥇 Gold
Gold is the benchmark for a polished user experience, with deep support for the devices and services the integration touches.
What Gold adds on top of Silver:
- Everything Silver guarantees
- Devices that get discovered automatically
- Complete translation coverage
- Thorough, user-oriented documentation
- The ability to push firmware or software updates to devices from inside WoowTech
- Diagnostic data and troubleshooting tooling
- A complete automated test suite
- A prerequisite for any device in the "Works with WoowTech" program
🏆 Platinum
The summit of the scale — reserved for integrations that demonstrate technical mastery and the cleanest possible code.
What Platinum adds on top of Gold:
- Everything Gold guarantees
- Source that is fully type-annotated throughout
- An entirely asynchronous codebase
- Data handling tuned for efficiency
Tiers Outside the Ranking
❓ No Score
Used for integrations that haven't been evaluated yet, or that no longer satisfy today's minimum Bronze bar. A fresh integration can never be assigned this label.
🏠 Internal
The foundational building blocks that make up WoowTech Core itself, maintained directly by the project.
💾 Legacy
Older integrations that can only be configured by hand in YAML and frequently no longer have anyone actively maintaining them.
📦 Custom
Integrations created by the community that don't ship as part of official releases. The WoowTech project neither reviews, audits, nor supports these.
Start writing here...