vibecodng.com

Free MCP betaIndex and tools live

Measured entry

magicui-scroll-progress

progressdark-futuristicmotion on file

A client-side React bar that tracks document scroll with Motion's useScroll hook and animates horizontal scale. It ships as a shadcn registry TypeScript component, styled with Tailwind utilities, and imports both motion/react and the usual @/lib/utils cn helper.

Specimen
Motion capture of the mounted demo, recorded by the harness. No audio track.
Harness screenshot of magicui-scroll-progress at 375 pixels wide
Harness screenshot at 375 pixels wide. No horizontal overflow recorded.
Harness screenshot of magicui-scroll-progress at 768 pixels wide
Harness screenshot at 768 pixels wide. No horizontal overflow recorded.
Harness screenshot of magicui-scroll-progress at 1440 pixels wide
Harness screenshot at 1440 pixels wide. No horizontal overflow recorded.

Measured

Every value below was written by the harness on the run that produced the frames above. None of it is derived from the prose.

Harness measurements recorded for magicui-scroll-progress
BuildOK
MountOK
Console errors0
Uncaught page errors0
Horizontal overflowclean at 375, 768, 1440
Axe critical0
Axe serious0
Axe moderate0
Axe minor0
Gzip marginal69.0 KB (134.4 KB build, 65.4 KB baseline)
Bare modeFAIL
Provider requiredNO
Demo usedwritten from the component source API

What the harness recorded

BARE BUILD

✗ Build failed in 35.34s
error during build:
[vite:load-fallback] Could not load <sandbox>/src/lib/utils (imported by src/cut/scroll-progress.tsx): ENOENT: no such file or directory, open '<sandbox>/src/lib/utils'

Verdict

A focused, clean indicator for long-form pages, but it is decorative and carries Motion for a very small visual. The packaged source needs a shadcn-style setup because the bare project cannot resolve its shared cn utility.

Use it if

  • You want a fixed, decorative reading-progress strip at the top of a long page.
  • Your app already uses Motion and can absorb another client component.
  • Your design system supports Tailwind utility classes and easy className overrides.

Skip it if

  • You need an accessible progress indicator that exposes a value to assistive technology.
  • Your top navigation or status chrome already occupies the same fixed edge.
  • You want to avoid Motion for a single lightweight scroll effect.
  • Your project does not use Tailwind and you do not want to translate the bundled styling.

Install

Installation record for magicui-scroll-progress
Declared dependenciesmotion
Missing on installnone
Bare installfails once the shadcn-style helpers are removed, so it needs that setup
Providerno provider required in the harness

In a non-shadcn project, install Motion, provide a cn class-merging helper or replace that call, configure the @ alias if keeping the import, and recreate the Tailwind gradient, positioning, stacking, and transform-origin styles in your own styling system. Keep the component on the client side.

Source and credit

This page is a review, not a copy. The component source lives with its author and this site does not republish it. Read the license before you use anything.

Author repository

github.com/magicuidesign/magicui
License
MIT
Record published
2026-08-14

Alternatives

Other published entries for the progress pattern, ordered by what they measured: mounts first, then clean axe scans, then bare-mode passes, then the smaller bundle.