I have created FlowPolish, a new Homey Pro app that tidies existing Advanced Flows without changing their cards, settings or connections. The app is currently available in the Test channel and I would appreciate feedback before submitting it for certification.
Test version:
The app ID is nl.nobrainerhomey.FlowPolish.
Main features
Select and search your existing Advanced Flows
Arrange cards horizontally or vertically
Choose compact, comfortable or spacious spacing
Preserve and arrange existing notes
Optionally add a localized summary note
Compare the current and proposed layouts in a visual preview
Available in English, Dutch and German
Safe copy workflow
FlowPolish never modifies the selected source flow directly.
Select a flow and create a preview.
Compare the current and proposed layouts.
FlowPolish creates a separate copy with the polished layout.
The new copy is always left disabled.
Check and test the copy in Advanced Flow.
Enable it yourself and only then decide whether to remove the original.
If the source flow changes after the preview was generated, FlowPolish refuses to create the copy and asks you to generate a new preview.
API key
Listing and previewing flows uses the app’s Homey permissions. Creating a copy requires a personal Homey API key with full Flow access. You can create one under Homey Settings → API Keys.
The key is stored locally in the app settings on your Homey, reused automatically and can be replaced at any time. It is never displayed again after saving.
Privacy and layout processing
Flow layouts are calculated locally and deterministically. Flow data is not sent to an AI service or another third party. FlowPolish changes coordinates and optional note placement only; flow logic and card configuration remain untouched.
Requirements
Homey Pro with firmware 12.0.0 or newer
At least one Advanced Flow
A Homey API key with full Flow access when creating a copy
Feedback wanted
I would especially appreciate feedback about:
Horizontal and vertical layouts on small and very large flows
Spacing and connection visibility
Placement of short and long notes
The three-step preview and copy workflow
Creating the disabled copy
Saving and replacing the API key
English, Dutch and German translations
When reporting an issue, please include the FlowPolish version, the selected direction and spacing, the approximate number of cards and notes, and a screenshot if possible. Please do not post API keys or other credentials.
I was trying out version 2026.7.6 on one of my existing flows using the horizontal mode (17 cards, comfortable spacing).
If I understand correctly the cards are either all arranged horizontally of vertically, but not a combination of both.
I normally use the horizontal method as a basis, but often, for presentation purposes, I combine it with the vertical method. Also for large flows using only a horizontal method would cause very long flows. Further I try to minimize cards overlapping connecting lines for readability.
As an example, part of a horizontal flow that contains vertical parts, to prevent cards from covering connecting lines.
Would it be possible for FlowPolish to consider (prevent) flow cards overlapping connectors and consider - to an extent - a combination of horizontal and vertical flows?
Nice initiative!
I would add an “any” block to “gather” all trigger output lines close to their right hand sides, and then draw just one line across the canvas to the “Amina EV is connected” card.
Compact spacing is now the default. Comfortable and spacious spacing remain available.
Every band in the balanced 16:9 layout now reads from left to right.
The layout engine chooses smarter wrap points, minimizing connections that have to cross between bands.
Direct one-to-one card chains are protected and no longer split at a wrap point when this can be avoided.
Vertical decision ladders, such as descending threshold checks, remain together in their logical top-to-bottom order.
Actions are placed to the right of those decisions, followed by their shared continuation card.
The optional connection-overlap optimization no longer changes the logical order of decision ladders.
The safe workflow is unchanged: FlowPolish only creates a separate, disabled copy. The original Advanced Flow remains untouched.
This update was tested against an 83-card / 97-connection Advanced Flow. I would especially appreciate feedback on large flows, the balanced 16:9 layout, spacing and connection visibility. Please mention version 2026.7.10 and include a screenshot when reporting a layout issue.
Hi Brian, I applied the new version 2026.7.10 to the same flow of my prior post and I indeed see a difference with the new ‘Balanced 16:9’-mode Part of my flow is now also moved downward instead of after each other .
The behavior of cards overlapping connectors is the same though:
To my humble opinion Athom should update the advanced flow editor to never have lines getting drawn under cards at all times.
I often use “any” block to force lines to be drawn around cards, but that’s a kind of weird workaround.
Thanks @SunBeech and @Peter_Kawa for the detailed feedback about connector lines and card placement. A new test build is now available:
Genuinely compact spacing
The Compact preset was still too close to the previous Comfortable spacing. It is now substantially tighter:
Column gap: 80 px → 40 px
Lane gap: 42 px → 24 px
Comfortable and Spacious remain unchanged.
On the large regression flow, Compact is approximately 22% narrower and 19% lower than Comfortable. Additional safety clearance is still retained where branches, vertical layouts or error paths require it.
Visible normal/error paths
When both the normal output and error output of a card connect to the same next card, FlowPolish now detects that pattern automatically. Each continuation is placed one step lower, producing a visible staircase instead of overlapping lines and cards.
New When-card workaround
There is a new optional setting: Place When cards near their continuation.
This is a layout-only alternative to adding an Any block. When a When card has a long direct connection, FlowPolish can move it to the column immediately before its next card. Multiple When cards are placed in separate lanes. This shortens the connector lines and reduces the chance that they disappear underneath intermediate cards, without adding cards or changing the flow logic.
The existing Reduce crossing connections option still optimizes crossings between routes. The new When-card option specifically targets long trigger lines that pass through occupied parts of the canvas.
As always, FlowPolish creates a separate disabled copy and leaves the original Advanced Flow untouched. Please mention version 2026.7.12, the selected layout and enabled options when reporting a result.
Tried compact looks like comfortable on horizontal layout. Cards are too far apart, around the hight of 4 cards. Oh and all comment cards are top row and not original pos. Version 7.12
Feedback and difficult Advanced Flows remain very welcome!
Ideas and feature requests are very welcome too. For example, would you like an option that rearranges an existing flow as little as possible, or one that generates Compact, Comfortable and Spacious variants in a single run?
I think this would be a practical option for users that already have spent time on rearranging flowcards, but just want to polish the final part or get inspiration for an alternative that improves readability.
FlowPolish v2026.7.21 is now available in Test — the app can now polish flows from inside a Flow too. Yes, apparently FlowPolish has found another surface to polish.
This update includes the improved Minimum mode for flows that are already arranged reasonably well and only need a light touch:
preserves the existing structure as much as possible;
straightens cards that already form approximate rows or columns;
recognises matching stages across parallel routes;
aligns near-horizontal one-to-one continuations on one clean line;
leaves branches and merges alone when moving them would change the visual structure.
New: FlowPolish Controller and Flow cards
You can now add a virtual FlowPolish Controller device and automate FlowPolish with action cards:
polish one selected Advanced Flow;
polish several source flows from a Flow folder, with a configurable limit of up to 25;
polish a selected flow using the Controller’s stored quick settings;
Polish this Advanced Flow: polish the enabled Advanced Flow that contains the card itself.
The last option does not require selecting a flow. Homey does not pass the parent Flow ID to an action card, so the card asks for a short recognition name. This name must be unique across enabled Advanced Flows. FlowPolish stops safely if it cannot identify exactly one matching flow.
The Controller settings store the default layout, spacing, output mode and the optional improvements for connection crossings, When-card lines, notes and summary notes.
The safe default remains unchanged: FlowPolish creates a separate, disabled copy for inspection and testing. Updating the original is an advanced opt-in setting on the Controller, remains locked by default and has no automatic undo.
Please create a new FlowPolish copy when testing layout improvements; previously generated copies are not changed retroactively.
The result isn’t satisfying yet for the vertical gaps;
I used Vertical + minimum (15x18) with “Reduce..” and “Reorder..” boxes unticked.
I think the highest cards (being the notification cards) should be used to determine the gap between horizontal aligned cards
I don’t understand the different gap sizes between the “And” cards, and the moving down of the two notification cards attached to the push notification cards:
!
.
:
15 px is now an option.
for the vertical gaps;
