Measured entry

reui-timeline

cardminimal-flat

A composable React timeline for vertical or horizontal sequences, shipped as shadcn registry source rather than a packaged widget. It provides wrappers for items, dates, titles, content, indicators, and separators, with active-state styling. It depends on React, the Radix Slot export, Tailwind utility classes and a local cn helper.

Specimen
Harness screenshot of reui-timeline at 375 pixels wide
Harness screenshot at 375 pixels wide. This viewport scrolled sideways.
Harness screenshot of reui-timeline at 768 pixels wide
Harness screenshot at 768 pixels wide. No horizontal overflow recorded.
Harness screenshot of reui-timeline 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 reui-timeline
BuildOK
MountOK
Console errors0
Uncaught page errors0
Horizontal overflowflagged at 375
Axe critical0
Axe serious0
Axe moderate0
Axe minor0
Gzip marginal32.3 KB (97.8 KB build, 65.5 KB baseline)
Bare modeOK
Provider requiredNO
Demo usedwritten from the component source API

Verdict

A solid set of styling primitives for teams already inside the shadcn ecosystem, but it is not a finished card and the default export alone appears empty. It needs a shadcn-style setup to build and mount, and active-step changes must be driven from outside the component.

Use it if

  • You need a presentational history, status trail, or milestone sequence assembled from small primitives.
  • Your app already uses shadcn conventions, Tailwind theme tokens, and the local cn utility.
  • You want controlled or initial active-step styling and need both vertical and horizontal layouts.

Skip it if

  • You want a complete drop-in timeline with sample events or card content included.
  • You need built-in step interaction, keyboard behavior, or an exported hook for changing the active item.
  • Your styling stack cannot process its Tailwind data, group, arbitrary-value, and descendant variants.
  • You need semantic list markup without adapting the supplied div-based primitives.

Install

Installation record for reui-timeline
Declared dependenciesradix-ui, clsx, tailwind-merge
Missing on installnone
Bare installbuilds and mounts without the shadcn-style helpers
Providerno provider required in the harness

In a non-shadcn project, add React and radix-ui, provide the aliased local cn class-merging helper, and configure Tailwind with the theme tokens and variant syntax used by the source. Copy the registry component into your source tree, preserve client-component handling where applicable, and compose TimelineItem children explicitly.

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.

Alternatives

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