Repository navigation
Getting Started
Arie J. Godschalk edited this page Nov 15, 2026
·
1 revision
Home › Getting started
- Use a compatible local Homey. The app manifest specifies Homey SDK 3, local platform and compatibility 5.0.0 or later. Check the Homey App Store listing for current availability and your Homey's compatibility.
- Install JSON Handler from that listing. Its cards appear under the app in the Flow editor; there is no device to add or app settings screen to configure in this version. Some examples use Advanced Flow; the loop action itself is marked Advanced in the manifest.
- A token is a value supplied by a card to a later card.
- Make a test Flow with a manual start.
- Add Build JSON (1*3 arguments). Leave Existing JSON blank.
- Set Property Path Text 1 to
roomand Text 1 toKitchen. - Set Property Path Number 1 to
temperatureand Number 1 to21. Leave the Yes/No path empty. - Add Read JSON (1*3 arguments) after it. Select the Build card's JSON token for Existing JSON.
- Enter
roomin Property Path Text 1 andtemperaturein Property Path Number 1. Leave the Yes/No path empty. Run the Flow.
The Build output is equivalent to:
{
"room": "Kitchen",
"temperature": 21
}The Read card supplies Text 1 = Kitchen, Number 1 = 21,
and the unused Yes/No 1 default = false. Connect the two outputs you
need to an action such as a notification. In Advanced Flow, connect success
to the next card; use error outputs for diagnostics.
Try more examples, learn what a path means, or consult the individual card references.
Support development - If JSON Handler is useful to you, you can support its
continued development through GitHub Sponsors,
Patreon,
PayPal, or
bunq.
Thank you!