A table of contents that turns into a floating pill as you read. At rest it is an inline list of section links. Once that list scrolls away, a compact pill appears at the top centre (bottom on phones) with a progress ring, the current section title, a 3/7 count and the estimated time left from the words still unread. Clicking the pill opens every section with the current one marked and a small progress bar each. At the end the ring turns into a check with an optional Back to top action. Headings are found automatically (h2 and h3) or passed in, and it works with the page or a scrolling container. Navigation landmarks, aria-current on the active link, an expandable button, Escape to close and focus moved to the heading after a jump; reduced motion scrolls instantly with no fades.
Components
Components
Progress steps
FreeA stepper for multi-step flows with complete, current and upcoming states. It is horizontal in wide containers and switches to a vertical rail in narrow ones using container queries, or can be fixed to either orientation. The current step has aria-current="step", each step's state is spelled out for screen readers, and completed steps can be made clickable to go back.
Reasoning trace
FreeA vertical step trace for showing what an assistant or automated job is doing. Each step has a type icon, a title, a status (pending, running, done, error or skipped), a live duration and a collapsible card with its input and output as key/value pairs or preformatted text. The rail fills down as steps finish, the running step pulses and its title shimmers. Steps can nest with their own sub-rail, and a header shows the step count, elapsed time and a segmented progress bar whose segments jump to and open their step. Failed steps offer a retry, status is always written as text, completions are announced politely, and motion stops when reduced motion is on.
A button that runs a whole async action in place: idle, pending, success and error, without ever changing width, because every label is stacked invisibly in one grid cell. Labels crossfade upward between states and icons change with them: a ring spinner (or a determinate arc when progress is given), a check that draws itself and an X with a small shake. While pending a hairline bar runs along the bottom edge, and success briefly floods the button green before it eases back. It keeps focus throughout, is busy rather than disabled while pending, announces each state politely, and simply swaps icons when reduced motion is requested. A status prop can force any state.
A two-column hero: headline, one supporting sentence, primary and secondary actions and a trust row (avatar stack plus a compliance note) on the left, and a cropped app window on the right built in HTML, with a sidebar, a progress bar, a transactions table with status pills and a floating stat card. Every colour comes from theme tokens; on phones the window stacks under the copy and stays cropped instead of shrinking.
useCountdown
FreeA React hook that counts down to a date or timestamp and returns days, hours, minutes, seconds and milliseconds left, with pause, resume and reset. Ticks align to whole seconds and read the clock each time, so slow or background tabs do not drift; onComplete fires once per run. The preview has a launch countdown with pause and reset and a one-time-code form whose resend link unlocks when its 30-second timer ends.
A sign-up flow in one card with three steps (account, workspace, invite teammates), a labelled progress bar that marks the current and finished steps, Back and Continue, and validation for each step before moving on. The workspace address fills itself from the name until edited, team size uses native radio buttons, invites can be added, removed or skipped, focus moves to each step's heading, and the last step shows a creating state and a summary.
SSR-safe React hooks for CSS media queries, built on useSyncExternalStore so they hydrate without mismatches and follow live changes. useMediaQuery takes any query and a server default, usePrefersReducedMotion reads the motion preference, and useBreakpoint returns the current Tailwind breakpoint. Falls back to the old listener API on older Safari. The preview shows the live breakpoint on a ruler and readouts for motion, colour scheme, contrast, hover, pointer and orientation.
Cart drawer
FreeA slide-over shopping cart. It lists line items with a thumbnail, variant, line total, quantity stepper (respecting a maximum) and remove button, shows progress toward a free-shipping threshold, and ends with the subtotal, shipping and a checkout button. As a modal dialog it traps focus, closes on Escape or a backdrop click, locks page scroll, restores focus on close and announces quantity changes. Includes an empty state; currency and locale are configurable.
A complete store analytics page in self-contained files: an app shell with sidebar, search and a mobile drawer; a date-range switch that rescopes the page; four KPIs with deltas and sparklines; a revenue chart comparing this period with the previous one, with crosshair tooltip, keyboard reading and a table view; sales by channel as a segmented bar and ranked list; a filterable, sortable, paginated orders table; and an activity list. Fictional data sits in data.ts, ready to swap for your API.
Kanban board
FreeA task board with columns, work-in-progress limits and cards showing a tag, priority, due date, comment count and assignees. Cards move by pointer drag (mouse anywhere on the card, touch from the handle) with a drop placeholder and edge auto-scroll, or by keyboard: focus a card's handle, press Space to pick it up, use the arrow keys, Space to drop and Escape to cancel. Move buttons and live-region announcements cover the same moves. Works controlled or uncontrolled, with an optional inline add-card field and custom card bodies.
Drop-off funnel
FreeA conversion funnel of horizontal stages whose widths shrink with their value, joined by curved bridges so it reads as one flowing shape filled with a gradient from the theme's chart colours. Each stage shows its label, count and share of the first stage, and a chip between stages shows the loss. The largest drop is found automatically and marked in the destructive tone. An optional earlier period draws as a dashed ghost shape with up or down deltas per stage. Stages grow in when scrolled into view, it can lay out horizontally on wide containers, labels move above the bars on phones, and every number is available as text for screen readers.
