PRODUCTIVITY — SETUP GUIDE
==========================

Version 0.3.0 · Free · English interface
Trello directory approval is in progress.

1. After approval, open Power-Ups > Add Power-Ups on your board and choose
   “Productivity” by Timo Leiser. During review, members of the developer
   workspace can add it under Custom.

2. Open a list’s ... menu > Productivity · Time thresholds ...
   Choose Manage Trello connection > Connect to Trello.
   Approve read-only access to card history.
   No API key or separate account is needed.
   The token is stored privately in Trello and remains valid until revoked.
   Trello authorizes reading every board your account can access; Productivity
   requests card history only in the board context you are currently using.

3. Open the desired list’s ... menu > Productivity · Time thresholds ...
   Enter green, orange and red thresholds in days or hours, then choose Save.
   Empty field = that color is off. All three empty = show time without color.
   Enabled thresholds must increase in this order: green < orange < red.
   Defaults for a new phase: green from 0, orange from 2 and red from 5 days.
   Existing saved settings keep green off until you configure it.
   Settings are shared by everyone on the board.

HOW TIME IS MEASURED
- Every Trello list is treated as one workflow phase.
- Time starts at the most recent recorded entry into the current list.
- Moving a card back to a previous list starts a new stay.
- Comments, card edits and reordering within a list do not restart the timer.
- Calendar time includes nights and weekends and continues while Trello is closed.
- If Trello history cannot prove the entry time, Productivity shows “Phase time unknown”.

SUPPORT AND PRIVACY
Timo Leiser · timo@leiser.ai
https://productivity-trello-powerup.pages.dev/privacy