Skip to main content

Flow Cards

The Upstairs Smart Stairs app provides Flow Action Cards for controlling motion lighting and Flow Condition Cards for building automations based on stair activity.

Action Cards​

The following action cards extend Homey's default light controls, allowing you to control your stairs more precisely in combination with motion detection.

warning

Important: All three Flow Action Cards will override or remove any motion light schemas previously configured in the official Upstairs app. Use these actions when you want Homey to fully control motion-triggered lighting behavior.

Set motion color and dim​

This allows you to set a specific color and brightness for your Smart Stairs when motion is detected. Using the color picker, you can choose any color to be applied dynamically during motion events.

Upstairs Smart Stairs
Set motion color to color and dim level to dim
i
Set light color and brightness when motion is detected. This will override any motion light schemas.

Set motion temperature and dim​

This lets you define a specific light temperature and brightness for your stairs when motion is detected. Whenever this action runs, the stairs adopt the chosen temperature and brightness.

Upstairs Smart Stairs
Set motion temperature to temperature and dim level to dim
i
Set light temperature and brightness when motion is detected. This will override any motion light schemas.

Disable motion light​

This completely disables motion-triggered lighting on the stairs. The stairs will no longer animate or respond to motion events.

Upstairs Smart Stairs
Disable motion light
i
Disable motion light. This will remove all motion schemas.

Condition Cards​

The following condition cards let you gate your automations based on stair activity data. All condition cards support inversion in Advanced Flow (e.g., "haven't been used" instead of "have been used").

info

Condition cards fetch fresh data from the Upstairs API each time they are evaluated. See Capabilities for more details on polling and data freshness.

Stairs used more than X times today​

Checks whether the total number of stair uses today exceeds the given count. Use this to trigger automations based on daily activity levels.

Upstairs Smart Stairs
Stairs have been used more than Times times today
i
Checks whether the total number of stair uses today exceeds the given count. Updated every 60 seconds.

Last stair direction​

Checks whether the most recent stair activity was in the given direction (up or down).

Upstairs Smart Stairs
Last stair direction is direction
i
Checks whether the most recent stair activity was in the given direction. Updated every 60 seconds.

How to Use These Cards​

  1. In the Homey app, go to Flows.
  2. Either edit an existing Flow or create a new Flow:
    • Mobile App: Tap the + icon in the top-right corner, then select New Flow.
    • Web App: Click New Flow to start a new flow (basic or advanced).
  3. For Action Cards, go to Then → Action. For Condition Cards, go to And → Condition.
  4. Search for your Smart Stairs device name (the name you assigned when adding the stairs).
  5. Select the Flow Card you want and configure the parameters.
  6. Combine it with any trigger (motion sensor, time, or other device) to complete your automation.