Horizontal Bar Ranking

A ranked top-N list — top pages, top referrers, top SKUs — where bar length shows magnitude and every label and value stays fully legible outside the fill, never clipped or reversed on dark mode. Auto-sorts descending, prints the rank number on every row, and ships an exact-value table fallback for anyone who can’t read the bars visually.

Stats & Numbers · Astro · Subscription · commercial licence · v1.0.1 · updated 2026-10-15 · Live demo

Install

velocityx add horizontal-bar-ranking

Subscription component. Run velocityx login with your key first — get one.

---
import HorizontalBarRanking from '../components/velocity/horizontal-bar-ranking/HorizontalBarRanking.astro';
---
<HorizontalBarRanking />

Props

Prop	Type	Default	Description
title	string	'Top referrers'	—
rows	RankingRow[]	[ { label: 'google.com', value: 18420 }, { labe…	—
preserveOrder	boolean	false	Skip the built-in descending sort — caller has already ordered rows.
limit	number	—	Cap the number of rows rendered.
className	string	''	—

Files written

velocityx drops these into your project:

• components/velocity/horizontal-bar-ranking/HorizontalBarRanking.astro

Peer dependencies

None.

Theming

Colours come from the primary-* / accent-* Tailwind scales, so this drops into a project that is not Velocity without dragging our brand in. Install the contract once:

velocityx theme

Then set your whole brand in one place — raw RGB channels, not hex (a hex here silently breaks every opacity variant):

:root {
  --vx-brand: custom;
  --vx-primary-600: 220 38 38;
}

There is no component-level font-family anywhere in the library — your font cascade wins.

Licence

Commercial, for the duration of an active Velocity X subscription. The source is served by the licence-gated endpoint, never by the public CDN.