Ecommerce Pro 15: related products carouselPRO
A scroll-snap row of products with previous and next buttons that disable at the edges, arrow-key paging and a quick add on each card.
The normal view. Pick a state to see what the block shows while it loads, is empty or fails.
The source is part of Ballmac UI Pro.
Log in with your licence key to read and copy it here, or install it through the shadcn CLI or the MCP server. You own the code once it is in your project.
$49 once regular price $99for this and every other Pro item. Tax included.Money back if it does not work.
Installation
Get a Pro licence key.
The source is part of Ballmac UI Pro.
Log in with your licence key to read and copy it here, or install it through the shadcn CLI or the MCP server. You own the code once it is in your project.
$49 once
regular price $99for this and every other Pro item. Tax included.Money back if it does not work.Once per project: add the Pro registry and your licence key.
components.json{ "registries": { "@ballmac": "https://ui.ballmac.com/r/{name}.json", "@ballmac-pro": { "url": "https://ui.ballmac.com/r/pro/{name}.json", "headers": { "Authorization": "Bearer ${BALLMAC_LICENSE_KEY}" } } } }.env.localBALLMAC_LICENSE_KEY=your-licence-keyAdd it.
$ pnpm dlx shadcn@latest add @ballmac-pro/ecommerce-pro-15
Usage
import { EcommercePro15 } from "@/components/ballmac/blocks/ecommerce-pro-15/ecommerce-pro-15"States
Pass state and the block does the rest: skeletons that match its layout, a clear empty message, an error you can retry, and announcements for screen readers.
Loading
A skeleton shaped like the block under the real heading, announced as loading.
state="loading"Empty
No suggestions yet: a panel under the heading (emptyState sets the copy and an action).
state="empty"Could not load
Could not load suggestions, with a retry button when onRetry is passed (errorState sets the copy).
state="error"
Quality scorecard
Every applicable check passes
Measured in Chromium 153.0.8010.12 on October 19, 2026, on version 1.1.0, across 4 examples.
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.
Passed: Right to left
Mirrors correctly in Arabic, Hebrew, Persian and Urdu layouts (0% of elements off the mirror, limit 15%).
Passed: Clean console
No console errors or React hydration errors while loading.
Passed: Keyboard
20 tab stops, each showing a visible change when it takes focus.
Passed: Loading, empty and error
Ships loading, empty, error states, each with an example.
Passed: Automated tests
Covered by ecommerce-pro.test.tsx, shop-states-pro.test.tsx.
For information: Footprint
3.8 KB of source (gzip) in 1 file. Installs lucide-react.
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.
Dependencies
- npm
- lucide-react
Use with AI
Native scroll-snap carousel that is right-to-left aware. Each slide is labelled with its position. With the shadcn MCP server set up (guide), ask your agent:
Add the Ballmac UI Ecommerce Pro 15: related products carousel (@ballmac-pro/ecommerce-pro-15) to this project with the shadcn MCP, then use it where it fits.
Use it for
- Under product pages and carts
Not for
- Primary listings
Registry JSON (needs your licence key): https://ui.ballmac.com/r/pro/ecommerce-pro-15.json
Covered by the Ballmac UI Pro license.
More ecommerce blocks
Ecommerce 1: product listing with filters
A product grid that sells: price, sale and rating on each card, color choices, a bag button that says what it did, filters with counts and removable chips, sorting, and results counted aloud.
Ecommerce 2: product page
A product page that closes the sale: a gallery you step through with arrow keys, price and rating, named color and option choices, a quantity stepper, an add-to-bag button that reports back, fine print one tap away, and reviews.
Ecommerce 3: shopping bag
A shopping bag that is hard to get wrong: quantities change at once and go back with the reason, removing leaves an Undo, a promo code says why it failed, and a bar shows how far you are from free shipping.
Ecommerce 4: checkout
A three-step checkout on one page: contact, delivery, payment. Finished steps fold into a summary with Edit, mistakes are named beside their field with focus on the first, and a declined card says so and charges nothing.