Skip to content

Getting Started

Arie J. Godschalk edited this page Nov 15, 2026 · 1 revision

Getting started

Home › Getting started

Before you start

  • 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 and read your first JSON

  1. Make a test Flow with a manual start.
  2. Add Build JSON (1*3 arguments). Leave Existing JSON blank.
  3. Set Property Path Text 1 to room and Text 1 to Kitchen.
  4. Set Property Path Number 1 to temperature and Number 1 to 21. Leave the Yes/No path empty.
  5. Add Read JSON (1*3 arguments) after it. Select the Build card's JSON token for Existing JSON.
  6. Enter room in Property Path Text 1 and temperature in 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.

Next steps

Try more examples, learn what a path means, or consult the individual card references.

Clone this wiki locally