Cluster Primitive

Horizontal wrapping group primitive for tag lists, pills, and button groups using flex-wrap plus gap.

Bento & Layout · Astro · Free · MIT · v1.0.0 · updated 2026-10-15 · Live demo

Install

velocityx add cluster

Free tier — no licence key needed. MIT: copy it, own it, edit it.

---
import Cluster from '../components/velocity/cluster/Cluster.astro';
---
<Cluster />

Props

Prop	Type	Default	Description
as	'div' | 'ul'	'div'	—
space	1 | 2 | 3 | 4 | 5 | 6 | 8	2	—
align	'start' | 'center' | 'end' | 'baseline'	'center'	—
justify	'start' | 'center' | 'end' | 'between'	'start'	—
className	string	''	—

Files written

velocityx drops these into your project:

• components/velocity/cluster/Cluster.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

MIT. Once installed it is yours — no attribution, no revocation.