Skip to content
Back

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-progress

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.

The code is part of Oxyn Pro

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.

Get Pro

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.

Terminal
oxyn add toc-progress

Usage

Dioxus · rust
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

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 code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

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 code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Bar

A compact progress bar for narrow screens (Oxyn plus).

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 code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

API reference

TocProgress

PropTypeDefaultDescription
sectionsrequiredVec<TocSection>—Sections.
titleString"On this page"Title.
reading_timef32Default::default()Reading time minutes (0 = estimate).
show_time_leftbooltrueShow time left.
offsetf3248.0Reached offset px.
heightf32360.0Height of the article viewport px.
sideString"right"`right` · `left` · `bar`.
on_active_changeEventHandler<String>—Current heading changed.

Read from the Rust signature and doc comments.

Keyboard interactions

KeyAction
TabThrough the headings
EnterScroll 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
TransitionDurationEasingReduced motion
Fillfollows scrolllinearsame
Colour240 mslinearinstant
Time roll240 msease.outswap

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, TocSection from oxyn_dioxus and include PRIMITIVES_CSS plus the token stylesheet once.
  • A GPUI version exists: TocProgressEl in oxyn_gpui.
  • Props to set first: sections.
  • Keep its states and timings as they ship; restyle it through the CSS variables rather than by hand.

Guides

Oxyn · 74 free components · 264 Pro components · 96 screens · 20 blocks · Dioxus and GPUI