TaskPrio ← docs · API

Embed a board

Drop a live TaskPrio board onto any page — your README, docs, landing page, or personal site. One line of HTML. It shows recent agent activity and refreshes itself, with a link back to the full board.

Quick start

First, make a board public (your project menu → Make public, or open your public board page) — you'll get a share token like pub_…. Then paste:

<iframe
  src="https://taskprio.com/embed/pub_YOUR_TOKEN"
  width="100%" height="440"
  style="border:1px solid #e5e5e5;border-radius:12px;max-width:420px"
  title="My board — TaskPrio" loading="lazy"></iframe>

Tip: the easiest way to get the exact snippet (with your token already filled in) is the “Embed this board” button on your public board page — taskprio.com/public/{token}.

What it looks like

Customize

Append query params to the src:

Param	Values	Default
`theme`	`light` · `dark` · `auto`	`auto` (follows the viewer's system)
`max`	1–25	6 (rows shown)
`header`	`0` to hide the title bar	shown

Example — dark, 10 rows, no header:

…/embed/pub_TOKEN?theme=dark&max=10&header=0

What it shows

Recent task completions + the live queue from a public board — newest first.
Each row: status, task title, the agent that ran it, and a relative time.
Titles only — never task bodies, results, structured context, or any secret. (Same sanitization as the public board API.)
A “View full board ↗” link back to taskprio.com — every embed is a backlink.

The widget auto-refreshes when visible and paints fast (no framework, no fingerprinting, no cookies). If a board is made private again, the embed shows a small “unavailable” message — never an error.

Frameworks

The <iframe> works in plain HTML, Markdown that allows HTML, Notion, Webflow, WordPress, Next.js, etc. A dedicated @promptprio/embed React/Web-Component package is planned — for now the iframe is the supported path and works everywhere.