Testimonials
Prov1.0.0Customer quotes backed by before-and-after numbers, with portraits that wipe between stories.
Build for your project
Code/install build
Usage
Import it and pass your content. The props that matter most are listed next.
Example
import { Testimonials, type Testimonial } from "@/components/ui/notchset/blocks/testimonials";
export function Voices({ items }: { items: Testimonial[] }) {
return <Testimonials items={items} interval={8000} />;
}Props
items–{ id, name, role, company, quote, highlight?, proof, portrait }[]highlight is a phrase from the quote; proof rows are { label, before, after }; portrait { src, srcSet?, alt }.
interval–numberMilliseconds per quote (7000).
Anatomy
- Reduced motion stops auto-advance and every word animation.
- The portrait box keeps its 4:5 ratio at any width.
- The last story loops back to the first.
Testimonialsdata-slot="testimonials"Portrait, quote, proof rows and the carousel controls.
Source
components/ui/notchset/blocks/testimonials.tsx
This component is included with Pro.
Try the live preview above. Get Pro to install the source.
Build for your project
Code/install build
Installation
pnpm dlx shadcn@latest add @notchset-pro/testimonialsNeeds your registry key. Your components.json style picks the Base UI or Radix build: radix-*, new-york and default get Radix, base-* gets Base UI.
Styles didn't apply?
The CLI adds the styles to the CSS file named in components.json (tailwind.css). Check that it points at your global stylesheet, that the project uses Tailwind CSS v4, and that the file is imported in your root layout. Installed by hand: paste styles.css into that file.
For coding agents
Give your coding assistant the Markdown guide instead of screenshots.
Use it for
- A landing page's customer voices, each with a measurable result
- Leading into case studies
Use something else when
- Dozens of short quotes: use a grid
- Quotes without permission or numbers you can't stand behind
Mistakes to avoid
- Use real customer headshots, not stock
- Keep the highlight an exact phrase from the quote
Agents find it by
- testimonials, customer quotes, reviews, case study carousel, social proof, wall of love, Notchset
Where agents read it
- Guide for this component: https://notchset.dev/md/testimonials.md
- Every component, for tools without MCP: /llms.txt
- MCP server:
https://notchset.dev/api/mcp(setup)
Behaviour
Keyboard
- ← →
- Previous / next story
- Tab then Enter
- Jump to a story, pause
Accessibility
- A carousel (aria-roledescription) whose quote is a polite live region, read as plain text, not word by word
- Auto-advance stops on hover, focus and PAUSE; progress bars are buttons naming each story
- Portraits carry the person's name as alt text
Motion
- Next story
- The portrait wipes in from the direction of travel (720ms)
- Quote
- Words rise in 16ms apart; the key phrase's underline draws once they land
- Progress
- The bar fills over the interval, then advances
Responsive
- Under 720px (container width) the portrait sits above the quote, at most 320px wide.
Performance
- CSS animations only; two images in the DOM at a time.
Changelog
v1.0.0 · 2026-10-04
First release
Part of
Included with Pro
Pro is in early access.
