Progress Tracker

KPI strip, status table, milestones

0

Connections

Webhook

Progress Tracker is a one-page status board for any project, campaign or goal: an optional black banner with a heading and date, a strip of up to four KPIs, a status table (item, now, next and owner, when) and two short panels such as Milestones and Waiting on you.

The full screen shows it all and trims table rows to fit, with an "and N more" line. Half horizontal shows the KPIs and a compact list (4 rows on TRMNL OG, up to 5 on TRMNL X landscape and up to 7 in portrait). Half vertical shows the KPIs in a 2-by-2 grid and the panels. Quadrant shows the four KPIs. Column names, panel titles and every label come from your payload. The preview uses invented demo data only.

This is a webhook recipe. After you install it, copy your unique URL from the Webhook URL field on this plugin's settings page (a click-to-copy field) and POST JSON to it. Put every field inside a merge_variables object. A push replaces the stored data. Each installer pushes their own data; the author's feed is never shared. Leave "Share pushed data with installs" off.

Using Grok Bot? Ask it for a routine that POSTs your data to the Webhook URL above on a schedule — no code needed.

Payload schema. Top-level keys:
• rows (required) — the table rows.
• kpis — up to 4 {value, label}.
• heading, subheading, date and date_sub — the banner; leave heading out to hide it.
• columns — four column names (default Item, Now, Next, When).
• panel_a_title with panel_a, and panel_b_title with panel_b — up to 3 {text, when} each; panel_a_empty and panel_b_empty are shown when a list is empty.
• footer_left and footer_right — one closing line. title (default Tracker) and note fill the title bar.

Each item in rows:
• name — the row name
• flag — optional short tag; set flag_strong to true for a filled tag
• status and optional progress (0 to 100, shown as a percentage)
• next and owner — the third column
• when — the last column
Extra keys are ignored.

Example curl. Replace the address below with the one from your Webhook URL field:
curl "trmnl.com/api/custom_plugins/YOUR_PLUGIN_UUID" -H "Content-Type: application/json" -X POST -d '{"merge_variables":{"title":"Tracker","note":"Demo data","heading":"PROJECT ALPHA","kpis":[{"value":"38","label":"Sign-ups"}],"columns":["Area","Now","Next","When"],"rows":[{"name":"Website","status":"Beta live","progress":80,"next":"Fix QA bugs","owner":"Sam","when":"today"}],"panel_a_title":"Milestones","panel_a":[{"text":"Launch day","when":"14 Apr"}]}}'

Limits. The stored payload may be 5 KB, or 10 KB on TRMNL+, measured on the stored merge variables. You may push 12 times an hour, or 30 on TRMNL+. Faster requests return 429. A push renders a new screen if the plugin has not rendered in the last 15 minutes; otherwise it waits for the next scheduled refresh.

Questions or improvements: hibimasu@mail.grokbot.com

Available settings

Webhook URL