Skip to content
Arie J. Godschalk edited this page Nov 15, 2026 · 7 revisions

Better Logic Library manual

Better Logic Library (BLL) adds named variables, Flow cards, reusable expressions, formatting tools, and shared libraries to Homey. The app ID remains net.i-dev.betterlogic.

I want to... Start here
Install the app and make my first variable Getting started
Create, edit, export, or restore variables Variables
Browse every current Flow card Flows
See app trigger, condition, and action indexes Flow triggers · Flow conditions · Flow actions
Pair a BitFlip, NumSlide, or Trigger device Devices
Write a calculation or dynamic text BLL coding and expressions
Find a reproducible example Example collections
Format a date, duration, or number Formatting
Configure functions, exports, or the file server App settings
Use BLL from another app or HomeyScript API · Developer guide
Connect BLL with supported Homey apps Supported apps
Diagnose a problem Troubleshooting

What can I build?

  • Count events with a number variable and react only when it changes.
  • Keep a virtual switch, slider, or button connected to a BLL variable.
  • Build a dynamically formatted date, message, or filename.
  • Use Math.js, Lodash, and reusable custom functions in supported BLL fields.
  • Export variables or pass JSON/CSV/Excel output to another Flow card.
  • Share temporary downloads with supported apps through BLL’s file server.

For Homey app developers

The betterlogiclibrary npm package connects another Homey app to BLL. Install it with npm install betterlogiclibrary and add the homey:app:net.i-dev.betterlogic permission. See the npm package, its documentation and examples, and the developer guide. The package is a client; the BLL app supplies shared functionality.

Before you start

Install Better Logic Library on Homey. The current manifest requires compatibility >=5.0.0; Flow labels can vary by language and installed app version. This manual is based on app source version 4.2.3.

For user help and current examples, see the users community topic. Developers can also read the developer topic.

Troubleshooting

Symptom First check
A Flow cannot find a variable Check its exact name, type, and whether the Flow was saved. See Variables.
A Flow does not start Check the trigger, selected value, Flow enabled state, and card behavior.
An expression fails Check whether the card expects Math.js, a BLL expression, or {[ ... ]} text coding. See BLL coding.
A device no longer updates Confirm its linked variable still exists and has the right type. See Devices.
A file link has expired Generate a fresh download. See App settings.

Canonical links

Clone this wiki locally