Hi all,
I’ve been working on a small framework that makes it easier IMO to build custom HomeyScript scripts for use in flows. After using HomeyScript for a while, I found myself wanting more structured ways to pass parameters and handle results, so I built HomeyScriptKit to address this.
Key Features
URL-like Argument Passing
Pass parameters using intuitive URL-style strings
hsk://sonos/toggleSurround?ip=192.168.1.1&volume=50
Standardized Result Handling
Unlike standard HomeyScript cards that only make results available with inline scripts, HSK provides consistent result tagging that works with external scripts, enabling better flow chaining
Third-Party Package Bundling
Bundle npm packages directly into your scripts to leverage the JavaScript ecosystem for more powerful automation (your mileage may vary depending on package complexity - always test thoroughly!)
What’s Included:
- Complete development workflow with debug and production builds
- TypeScript support for better development experience
- Example scripts (including a Sonos home theater controller)
- Comprehensive documentation and step-by-step guides
- Testing framework integration
Perfect for:
- Creating reusable script libraries
- Building complex automation logic
- Sharing scripts with the community
- Developers who want more structure in their HomeyScript workflows
The framework handles all the boilerplate - you just focus on your script logic. Check out the repo for examples and detailed documentation on getting started.
Would love to hear your thoughts and see what scripts the community builds with it!
Note: This requires basic TypeScript/Node.js knowledge for development, but the compiled scripts work like any other HomeyScript.
