# 🚀 Introducing HomeyScriptKit - A Framework for Building Better HomeyScript Scripts

**URL:** <https://community.homey.app/t/introducing-homeyscriptkit-a-framework-for-building-better-homeyscript-scripts/137744>\
**Category:** Developers\
**Tags:** homeyscript, homey-pro\
**Created:** [June 6, 2025, 5:41pm UTC](https://community.homey.app/t/introducing-homeyscriptkit-a-framework-for-building-better-homeyscript-scripts/137744 "2025-06-06T17:41:41Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![indieisaconcept](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/indieisaconcept/32/134895_2.png) [@indieisaconcept](https://community.homey.app/u/indieisaconcept)\
**Post date:** [June 6, 2025, 5:41pm UTC](https://community.homey.app/t/introducing-homeyscriptkit-a-framework-for-building-better-homeyscript-scripts/137744/1 "2025-06-06T17:41:41Z")

</div>

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](https://github.com/indieisaconcept/homeyscriptkit)

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.

---

<div class="post-metadata">

**Author:** ![Techniman](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/techniman/32/8654_2.png) [@Techniman](https://community.homey.app/u/Techniman)\
**Post date:** [June 9, 2025, 8:08pm UTC](https://community.homey.app/t/introducing-homeyscriptkit-a-framework-for-building-better-homeyscript-scripts/137744/2 "2025-06-09T20:08:42Z")

</div>

Sounds interesting, well done

---

<div class="post-metadata">

**Author:** ![indieisaconcept](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/indieisaconcept/32/134895_2.png) [@indieisaconcept](https://community.homey.app/u/indieisaconcept)\
**Post date:** [June 15, 2025, 3:17am UTC](https://community.homey.app/t/introducing-homeyscriptkit-a-framework-for-building-better-homeyscript-scripts/137744/3 "2025-06-15T03:17:57Z")

</div>

FYI I have added experimental support so you can sync scripts directly to your homey via companion CLI tool. Full details below.

> <https://github.com/indieisaconcept/homeyscriptkit/blob/main/HSK_CLI.md>