Ballmac UI home

Marquee

An endless horizontal or vertical scroller for logo rows and testimonials. Speed is in pixels per second, it pauses on hover and focus, and it fills any width.

Trusted by product teams

NorthwindAcmeLumenHalcyonMeridianParallaxQuantaTessellate

Installation

$ pnpm dlx shadcn@latest add @ballmac/marquee

Usage

import { Marquee } from "@/components/ballmac/marquee"

The full example is in the Code tab above.

Examples

Vertical testimonials

“We replaced three internal widgets in an afternoon.”
Priya N. · Frontend lead
“The motion is quiet enough for a finance dashboard.”
Tomás R. · Product designer
“Dark mode worked on the first try. That never happens.”
Mei L. · Staff engineer

API reference

PropTypeDefault
vertical

Scroll top to bottom instead of left to right. Give the marquee a height.

booleanfalse
reverse

Run the other way (right to left becomes left to right, up becomes down).

booleanfalse
speed

Speed in pixels per second, so long and short content move at the same pace.

number40
pauseOnHover

Pause while the pointer is over the marquee. Keyboard focus inside always pauses.

booleantrue
gap

Space between items and between loops. A number is pixels; strings are any CSS length.

number | string16
fade

Fade the leading and trailing edges into the background.

booleantrue

Also accepts the standard attributes of its root element.

Accessibility

KeyAction
TabMoves focus into the first copy of the content and pauses the scroll

Quality scorecard

5/5

Every applicable check passes

Measured in Chromium 153.0.8010.12 on October 19, 2026, on version 1.0.0, across 2 examples.

How we measure
  • Passed: Accessibility scan

    No serious or critical issues in light and dark, on a phone and a desktop (axe-core 4.13.0, WCAG 2.1 AA and best-practice rules).

  • Passed: Small screens

    No sideways scrolling at 360, 390 or 1280 px wide.

  • Passed: Reduced motion

    Every endless animation stops when the visitor asks for less motion.

  • Not applicable: Right to left

    Not mirrored by design: Scrolling strip; the direction prop is physical.

  • Passed: Clean console

    No console errors or React hydration errors while loading.

  • Not applicable: Keyboard

    Static content: nothing to focus.

  • Not applicable: Loading, empty and error

    Does not show data or take submissions.

  • Passed: Automated tests

    Covered by marquee.test.tsx.

  • For information: Footprint

    2.3 KB of source (gzip) in 1 file. Installs motion.

Automated checks find a subset of problems and do not replace testing with a screen reader and a keyboard in your own app. What they miss.

Use with AI

Put the items directly inside <Marquee>; it measures one copy, clones as many as the viewport needs (clones are aria-hidden and inert) and loops them with a GPU transform. Under reduced motion it renders a single copy in a scrollable row. With the shadcn MCP server set up (guide), ask your agent:

Add the Ballmac UI Marquee (@ballmac/marquee) to this project with the shadcn MCP, then use it where it fits.

Use it for

  • A row of customer or partner logos under a hero
  • A wall of short testimonials (vertical, several columns side by side)
  • A ticker of changelog items, integrations or stats

Not for

  • Content people must read or act on in full (use a grid or carousel with controls)
  • Critical navigation or calls to action

Registry JSON: https://ui.ballmac.com/r/marquee.json

Credits

Free to use in personal and commercial projects.

Registry
shadcn/utils

Ballmac UI Pro

Need the whole screen, not one piece?

311 premium blocks (dashboards, settings, calendars, mail, shops, onboarding), a private shadcn registry and Figma tokens. Blocks that show data come with loading, empty and error states built in.

Not ready? Try three Pro blocks free

Leave your email and the blocks appear right here, ready to copy. Yours to use in any project.