Cluster

Flex layout primitive that wraps children in a row with vertical centering and a numeric gap on the 4px scale. Great for tags, buttons and meta rows.

src/registry/ui/cluster.tsx/r/cluster.json

Installation#

bash

npx shadcn@latest add @minidev/cluster

MiniDev UI is in the shadcn registry directory, so the short form works with no setup. Older CLI versions can use the full URL: npx shadcn@latest add https://ui.minidev.pro/r/cluster.json

Usage#

tsx

import { Cluster } from "@/components/ui/cluster"

export function Example() {
  return (
    <Cluster gap={2}>
      <span className="rounded-md border border-border px-2 py-1 text-xs">One</span>
      <span className="rounded-md border border-border px-2 py-1 text-xs">Two</span>
      <span className="rounded-md border border-border px-2 py-1 text-xs">Three</span>
    </Cluster>
  )
}

API reference#

Cluster props
Prop	Type	Default
`gap`	`number`	`2`

Also accepts every prop of <div>, passed through to the root element.

Examples#

LayoutShells & grids

AccordionAccessible React accordion on Base UI, with bordered items, a rotating chevron and animated panels. Keyboard navigable, with one or many items open at once.App ShellTailwind app shell layout with a fixed width sidebar slot, a topbar slot and a scrolling main area. The sidebar hides below the md breakpoint for mobile.Aspect RatioShadcn compatible aspect ratio wrapper that locks media to a ratio such as 16:9 or 1:1 using CSS aspect-ratio, with overflow clipped for images and video.CardShadcn compatible card with header, title, description, action, content and footer slots, a compact size and edge to edge images. Built for Tailwind v4.CenterLayout helper that centers content horizontally and vertically in a narrow, text-centered column. Handy for empty states, auth screens and simple heroes.CollapsibleShadcn compatible collapsible on Base UI: a full width trigger that shows or hides a panel of content. Accessible expanded state and keyboard support.

All layout components

Learn more

What is Logical properties?Glossary