🚀 Introducing HomeyScriptKit - A Framework for Building Better HomeyScript Scripts

indieisaconcept
Fri, 06 Jun 2025 17:41:41 +0000
Developers

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.

Repository: GitHub - indieisaconcept/homeyscriptkit: Extend your Homey's capabilities with custom HomeyScript automation scripts

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.

3 posts - 2 participants