Table of contents progressPro
Contents that read along with you: a line fills through the headings, a marker rides to the current section and the time left rolls down to Finished.
oxyn add toc-progressIntroduction
Oxyn gives agent apps the parts users actually look at: the composer, the transcript, approvals and run state.
Agents keep a transcript of every tool call, so you can see what changed and why. Each step records its inputs, its output and the time it took, and anything that touched the outside world asks first.
Long runs stream their progress; you can steer, pause or rewind at any point.
Install
Add oxyn-core and the renderer you use, then include the token stylesheet once.
Agents keep a transcript of every tool call, so you can see what changed and why. Each step records its inputs, its output and the time it took, and anything that touched the outside world asks first.
Long runs stream their progress; you can steer, pause or rewind at any point.
Dioxus
Components hold their own state in signals and report changes through events.
Agents keep a transcript of every tool call, so you can see what changed and why. Each step records its inputs, its output and the time it took, and anything that touched the outside world asks first.
Long runs stream their progress; you can steer, pause or rewind at any point.
GPUI
Elements are RenderOnce; the host owns the model and the clock.
Agents keep a transcript of every tool call, so you can see what changed and why. Each step records its inputs, its output and the time it took, and anything that touched the outside world asks first.
Long runs stream their progress; you can steer, pause or rewind at any point.
Theming
Monochrome by default, semantic colour only for status, risk and agent identity.
Agents keep a transcript of every tool call, so you can see what changed and why. Each step records its inputs, its output and the time it took, and anything that touched the outside world asks first.
Long runs stream their progress; you can steer, pause or rewind at any point.
Tokens
DTCG tokens compile to CSS variables and Rust constants.
Agents keep a transcript of every tool call, so you can see what changed and why. Each step records its inputs, its output and the time it took, and anything that touched the outside world asks first.
Long runs stream their progress; you can steer, pause or rewind at any point.
Next steps
Browse the components, then build your first agent screen.
Agents keep a transcript of every tool call, so you can see what changed and why. Each step records its inputs, its output and the time it took, and anything that touched the outside world asks first.
Long runs stream their progress; you can steer, pause or rewind at any point.
The preview stays free for everyone. Pro opens the code of every Pro component, screen, agent-app template, block and kit, plus the Pro CLI.
Rendered from Rust at build time · goes live when visible
When to use
- Long answers, research reports and docs: where you are and how much is left.
When not to use
- Markdown that renders correctly while it streams: use Streaming markdown instead.
- Native scrolling with thin overlay scrollbars and edge fades that grow with what's left: use Scroll area instead.
- An app sidebar: use Sidebar instead.
Installation
Table of contents progress is part of Oxyn Pro; the preview is free. Pro items install with the oxyn CLI once your licence is signed in; until then Pro members copy the code from this page.
oxyn add toc-progressUsage
The preview is free. Pro opens the code of every Pro component, screen and template.
Examples
Reading
Line fills as you scroll the article.
Introduction
Oxyn gives agent apps the parts users actually look at: the composer, the transcript, approvals and run state.
Agents keep a transcript of every tool call, so you can see what changed and why. Each step records its inputs, its output and the time it took, and anything that touched the outside world asks first.
Long runs stream their progress; you can steer, pause or rewind at any point.
Install
Add oxyn-core and the renderer you use, then include the token stylesheet once.
Agents keep a transcript of every tool call, so you can see what changed and why. Each step records its inputs, its output and the time it took, and anything that touched the outside world asks first.
Long runs stream their progress; you can steer, pause or rewind at any point.
Dioxus
Components hold their own state in signals and report changes through events.
Agents keep a transcript of every tool call, so you can see what changed and why. Each step records its inputs, its output and the time it took, and anything that touched the outside world asks first.
Long runs stream their progress; you can steer, pause or rewind at any point.
GPUI
Elements are RenderOnce; the host owns the model and the clock.
Agents keep a transcript of every tool call, so you can see what changed and why. Each step records its inputs, its output and the time it took, and anything that touched the outside world asks first.
Long runs stream their progress; you can steer, pause or rewind at any point.
Theming
Monochrome by default, semantic colour only for status, risk and agent identity.
Agents keep a transcript of every tool call, so you can see what changed and why. Each step records its inputs, its output and the time it took, and anything that touched the outside world asks first.
Long runs stream their progress; you can steer, pause or rewind at any point.
Tokens
DTCG tokens compile to CSS variables and Rust constants.
Agents keep a transcript of every tool call, so you can see what changed and why. Each step records its inputs, its output and the time it took, and anything that touched the outside world asks first.
Long runs stream their progress; you can steer, pause or rewind at any point.
Next steps
Browse the components, then build your first agent screen.
Agents keep a transcript of every tool call, so you can see what changed and why. Each step records its inputs, its output and the time it took, and anything that touched the outside world asks first.
Long runs stream their progress; you can steer, pause or rewind at any point.
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Left
Contents on the left.
Introduction
Oxyn gives agent apps the parts users actually look at: the composer, the transcript, approvals and run state.
Agents keep a transcript of every tool call, so you can see what changed and why. Each step records its inputs, its output and the time it took, and anything that touched the outside world asks first.
Long runs stream their progress; you can steer, pause or rewind at any point.
Install
Add oxyn-core and the renderer you use, then include the token stylesheet once.
Agents keep a transcript of every tool call, so you can see what changed and why. Each step records its inputs, its output and the time it took, and anything that touched the outside world asks first.
Long runs stream their progress; you can steer, pause or rewind at any point.
Dioxus
Components hold their own state in signals and report changes through events.
Agents keep a transcript of every tool call, so you can see what changed and why. Each step records its inputs, its output and the time it took, and anything that touched the outside world asks first.
Long runs stream their progress; you can steer, pause or rewind at any point.
GPUI
Elements are RenderOnce; the host owns the model and the clock.
Agents keep a transcript of every tool call, so you can see what changed and why. Each step records its inputs, its output and the time it took, and anything that touched the outside world asks first.
Long runs stream their progress; you can steer, pause or rewind at any point.
Theming
Monochrome by default, semantic colour only for status, risk and agent identity.
Agents keep a transcript of every tool call, so you can see what changed and why. Each step records its inputs, its output and the time it took, and anything that touched the outside world asks first.
Long runs stream their progress; you can steer, pause or rewind at any point.
Tokens
DTCG tokens compile to CSS variables and Rust constants.
Agents keep a transcript of every tool call, so you can see what changed and why. Each step records its inputs, its output and the time it took, and anything that touched the outside world asks first.
Long runs stream their progress; you can steer, pause or rewind at any point.
Next steps
Browse the components, then build your first agent screen.
Agents keep a transcript of every tool call, so you can see what changed and why. Each step records its inputs, its output and the time it took, and anything that touched the outside world asks first.
Long runs stream their progress; you can steer, pause or rewind at any point.
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Bar
A compact progress bar for narrow screens (Oxyn plus).
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
API reference
TocProgress
| Prop | Type | Default | Description |
|---|---|---|---|
sectionsrequired | Vec<TocSection> | — | Sections. |
title | String | "On this page" | Title. |
reading_time | f32 | Default::default() | Reading time minutes (0 = estimate). |
show_time_left | bool | true | Show time left. |
offset | f32 | 48.0 | Reached offset px. |
height | f32 | 360.0 | Height of the article viewport px. |
side | String | "right" | `right` · `left` · `bar`. |
on_active_change | EventHandler<String> | — | Current heading changed. |
Read from the Rust signature and doc comments.
Keyboard interactions
| Key | Action |
|---|---|
| Tab | Through the headings |
| Enter | Scroll the article to the heading |
Accessibility
- nav landmark named by the title, an ordered list of anchor links.
- aria-current=location on the current heading; contrast differs, not only the line.
- The line and marker are decorative.
From the spec
nav landmark named by the title with an ordered list of anchors; contrast marks state, not only the line; the line is decorative.
Motion & interaction
Each section fills the line from its heading to the next; the marker rides at the fill tip; heading colours change over 240 ms; the time left rolls.
Timing
| Transition | Duration | Easing | Reduced motion |
|---|---|---|---|
| Fill | follows scroll | linear | same |
| Colour | 240 ms | linear | instant |
| Time roll | 240 ms | ease.out | swap |
Responsive behaviour
- Below 560px of container width the contents move above the article.
Edge cases (spec)
Short last sections are still reached at the bottom. Below 560 px of container width the contents move above.
Notes for AI
- Import
TocProgress,TocSectionfromoxyn_dioxusand includePRIMITIVES_CSSplus the token stylesheet once. - A GPUI version exists:
TocProgressElinoxyn_gpui. - Props to set first:
sections. - Keep its states and timings as they ship; restyle it through the CSS variables rather than by hand.