Skip to content
Design System
GitHub

Route progress

v0.23.1

A thin blue bar while the next page loads: shows after 300 ms, never reaches the end, gives up after 10 s.

The bar appears after 300 ms and only while the page is on its way.

Route progress slow page

Install
npx shadcn add @syncrobotic/route-progress

Also installs: @syncrobotic/cn

Overview

A thin bar at the top while the next page loads, after 300 ms and gone when it arrives.

When to use

  • Page changes in an app that loads data as you navigate.

Use something else

More examples

States and real uses. Each example is also a Storybook story and a visual regression test.

Loading Catalog…

Route progress shown

Usage rules

  • For a page that takes long to arrive; it shows after 300 ms, so a quick page never flashes it.
  • Blue: a process someone is waiting on. It never reaches the end until the page is in.
  • Drive active from your router; it gives up after 10 s if the navigation never reports back.

Changelog

  • 0.23.12026-11-21The bar leaves in the same render active turns false instead of an effect later, so it is safe under the React Compiler.
  • 0.23.02026-11-20Every word it says can be translated without editing the source: labels.loading; label still works and wins.
  • 0.10.02026-11-18New.

How to upgrade