Workstream Board

Project cards and next steps board

0

Connections

Webhook

Workstream Board turns any list of projects, tasks or workstreams into a clean board on your TRMNL: a "next up" box for the few things that need attention, a strip of groups with item counts, and mosaic cards with a status line, owner, time and an optional progress bar.

The full screen shows up to 4 next-up lines, up to 6 groups and up to 12 cards (4 columns on TRMNL OG, 3 on TRMNL X, 2 in portrait). Half horizontal shows the first next-up line and 3 cards on OG or 6 on X. Half vertical shows 3 next-up lines and 3 or 4 cards. Quadrant shows one next-up line and 2 cards. Every heading comes from your payload, so it fits a team board, a side-project tracker or a home to-do wall. The preview uses invented demo projects 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:
• items (required) — an array of cards. The full layout shows the first 12.
• focus (optional) — an array of {text, when} next-up lines.
• title — title-bar text (default Workstreams). note — title-bar instance text, for example updated 09:30.
• date — shown top right of the next-up box.
• focus_title (default Next up), focus_empty (default Nothing waiting.), items_title (default In progress) and group_label (the word after each group count, default active).

Each item in items:
• name — card title
• group — short group or project label; groups are listed in the strip in first-seen order
• detail — one status or next-step line
• owner and when — shown on the meta line
• flag — optional short word shown first on the meta line, for example Blocked
• progress — optional 0 to 100; omit it to hide the bar
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":"Workstreams","note":"Demo data","focus":[{"text":"Approve launch copy","when":"today"}],"items":[{"group":"Alpha","name":"Launch site","detail":"Final QA pass","owner":"Sam","when":"09:30","progress":80}]}}'

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