Skip to main content
Clever Ops

Horizontal Gallery

A vertical-scroll-driven horizontal track inside a sticky clipped viewport, translateX mapped to section progress, focusable cards, and a plain scrollable rail under reduced motion.

Preview & code

Loading Horizontal Gallery preview

Installation

pnpm dlx shadcn@latest add @cleverui/scroll-horizontal-gallery

Requires the @cleverui registry in your components.json, a one-off, two-line setup.

Usage

tsx
import { ScrollHorizontalGallery } from '@/components/blocks/scroll-horizontal-gallery'
Exampletsx
import { ScrollHorizontalGallery } from '@/components/blocks/scroll-horizontal-gallery'

export default function ScrollHorizontalGalleryDemo() {
  return (
    <ScrollHorizontalGallery
      eyebrow="Product tour · Meridian Close"
      heading="Four beats from intake to sealed pack."
      items={[
        {
          kicker: '01',
          title: 'Intake board',
          body: 'Invoices, POs, and packing slips land in one queue. Fields extract against your chart of accounts, 2,400 lines a month without re-keying.',
        },
        {
          kicker: '02',
          title: 'Policy match',
          body: 'Tolerance bands and dual-approval thresholds travel with every line. Controllers stop hunting the spreadsheet that defined “close enough.”',
        },
        {
          kicker: '03',
          title: 'Exception age',
          body: 'Unmatched lines get an owner overnight. Median age fell from 41 hours to under six. The morning board shows judgment only.',
        },
        {
          kicker: '04',
          title: 'Audit seal',
          body: 'Export a signed pack for any close window: decisions, overrides, and source hashes. External auditors stop asking for screenshots.',
        },
        {
          kicker: '05',
          title: 'Nightly board',
          body: 'Stand-ups read the exception list, not status slides. Quiet mismatches surface before Friday fire drills begin.',
        },
        {
          kicker: '06',
          title: 'Three-day close',
          body: 'Nine calendar days became three. The controller’s only remaining complaint: the board is almost too quiet.',
        },
      ]}
    />
  )
}

API reference

ScrollHorizontalGallery accepts the following props.

PropTypeDefaultDescription
eyebrowstring
heading*string
items*HorizontalGalleryItem[]4–8 gallery cards traversed by the track

…plus everything from React.HTMLAttributes<HTMLElement>: className, event handlers, aria attributes and the rest pass straight through.

Referenced types

Typestsx
export interface HorizontalGalleryItem {
  kicker?: string
  title: string
  body: string
}

Frequently asked questions

How do I install the Horizontal Gallery component?

Register the @cleverui registry in your components.json ("@cleverui": "https://cleverops.com.au/r/{name}.json"), then run `npx shadcn@latest add @cleverui/scroll-horizontal-gallery`. The shadcn CLI copies the source into your project, you own the code from that point. You can also copy the source directly from this page.

What dependencies does Horizontal Gallery require?

Horizontal Gallery uses motion on top of React and Tailwind CSS. You don't need to install it manually, the shadcn CLI resolves and installs npm dependencies automatically when you add the component.

Can I theme Horizontal Gallery to match my brand?

Yes. The component is styled entirely with Tailwind utilities over standard design tokens (primary, background, muted, border), so it inherits your existing shadcn/ui theme automatically. Change your CSS variables and the component follows, no source edits needed for palette, radius, or fonts.

Want this built for you?

CleverUI is built by the Clever Ops web team. If you'd rather ship a hand-coded, fast, custom website than assemble one, we build them for Australian businesses every week.

Explore web development services