Reading Progress Bar — A2UI Atomic Catalog

Renders a horizontal visual bar tracking the reader's scroll completion depth within the article.

Surfaces

webapps-script-web

Degraded on

Surface	Note
meet-stage	High frequency scroll monitoring triggers suffer from visual frame latency.
googlechat	Dynamic scroll tracking layout elements are completely stripped.
email	Script-driven viewport position tracking fails in client readers.

Fields

Field	Type
color	string. Hexadecimal or design utility color token for the bar.	required

Example payload

{
  "type": "reading_progress_bar",
  "color": "#6366f1"
}

ARD catalog entry

{
  "identifier": "urn:air:a2uicatalog.ai:atom:reading_progress_bar",
  "displayName": "Reading Progress Bar",
  "type": "application/vnd.a2ui.atom+json",
  "url": "https://a2uicatalog.ai/atoms/reading_progress_bar",
  "capabilities": [
    "web",
    "apps-script-web"
  ],
  "description": "Renders a horizontal visual bar tracking the reader's scroll completion depth within the article.",
  "representativeQueries": [
    "show a track and display article reading progress completion status",
    "renders a horizontal visual bar tracking the reader's scroll completion depth within the article.",
    "render a reading progress bar"
  ]
}

Deploy your own renderer

The renderer is open source. Deploy your own instance in 4 commands — you own the URL, no dependency on the demo endpoint.

git clone https://github.com/a2uicatalog/a2ui
cd apps-script-surface/gas-schema-renderer
clasp push && clasp deploy

Full deploy guide →