Testimonials
Social-proof sections — grids, a single hero quote, a masonry wall, marquees and a carousel.
Preview
@props([
'eyebrow' => 'Trusted at scale',
'heading' => 'Numbers our customers stand behind',
'subheading' => 'A UI system teams own outright — measured by the work it ships, not the lock-in it adds.',
'stats' => null,
'testimonials' => null,
])
@php
$stats ??= [
['value' => '10k+', 'label' => 'Teams shipping'],
['value' => '4.9/5', 'label' => 'Average rating'],
['value' => '99.9%', 'label' => 'Uptime'],
['value' => '2M+', 'label' => 'Requests per day'],
];
$testimonials ??= [
[
'quote' => 'We replaced three half-finished design systems with this in a weekend. Re-theming is now a config change, not a refactor.',
'name' => 'Avery Mitchell',
'role' => 'Head of Design',
'company' => 'Northwind',
'initials' => 'AM',
'rating' => 5,
],
[
'quote' => 'Owning the source is the whole game. No runtime lock-in, no upgrade anxiety — just plain Blade we can read and edit.',
'name' => 'Jordan Lee',
'role' => 'Staff Engineer',
'company' => 'Lumen',
'initials' => 'JL',
'rating' => 5,
],
[
'quote' => 'Accessibility used to be a backlog item. Now keyboard support and focus states ship by default with every block.',
'name' => 'Priya Nair',
'role' => 'Product Lead',
'company' => 'Cadence',
'initials' => 'PN',
'rating' => 5,
],
];
@endphp
<x-ui.section space="xl" {{ $attributes }}>
<x-ui.container gutter="sm">
<x-ui.section-heading align="center" overline-style="label" :overline="$eyebrow" :title="$heading" :subtitle="$subheading" />
@if ($stats)
<x-ui.card class="mt-12 p-0 sm:mt-16">
<div class="grid grid-cols-2 lg:grid-cols-4">
@foreach ($stats as $i => $stat)
<x-ui.stat
variant="plain"
size="lg"
:value="__($stat['value'])"
:label="__($stat['label'])"
@class([
'items-center px-6 py-8 text-center',
'border-t border-border sm:border-t-0' => $i >= 2,
'border-s border-border' => $i % 2 !== 0,
'lg:border-s lg:border-border' => $i % 2 === 0 && $i !== 0,
'lg:border-t-0' => $i >= 2,
])
/>
@endforeach
</div>
</x-ui.card>
@endif
<div class="mt-12 grid grid-cols-1 gap-6 sm:mt-16 sm:grid-cols-2 lg:grid-cols-3">
@foreach ($testimonials as $testimonial)
<x-ui.quote-card
glyph="none"
:quotes="false"
:rating="$testimonial['rating'] ?? null"
:quote="__($testimonial['quote'])"
:name="__($testimonial['name'])"
:role="__($testimonial['role'])"
:company="! empty($testimonial['company']) ? __($testimonial['company']) : null"
:initials="$testimonial['initials']"
/>
@endforeach
</div>
</x-ui.container>
</x-ui.section>
Installation
php artisan ui:add blocks/testimonials-stats
Registry contract
Install confidence
php artisan ui:add blocks/testimonials-stats
writes only the generated targets below. The CLI validates each file hash before writing and
prompts before replacing local changes unless --force is used.
- Version
- 1.0.6
- License
- open
- Stability
- stable
- Contract
- v1
- Foundation
- ≥ 1.0.0
| Type | Generated target |
|---|---|
| blade | resources/views/blocks/testimonials-stats.blade.php |
Registry dependencies
Package dependencies
composer: jml/brok:^0.2
Use with AI
A brief for your coding agent: what the block is, the install command, how to render it, its props and the rules. Copy it, or open a prompt about this block in an assistant.
# Brok UI block: Testimonials Stats (`testimonials-stats`)
A social-proof section pairing a metric stats band (big numbers in a definition list) with a grid of featured testimonial cards, each a starred blockquote with an avatar, name, and company.
Brok UI is a Laravel Blade registry. `ui:add` copies this block into the app as plain Blade the app owns; it composes installed `<brok:*>` primitives and semantic design tokens.
## Install
```bash
php artisan ui:add blocks/testimonials-stats
```
## Render it
```blade
<x-blocks.testimonials-stats />
```
## Props
- `eyebrow` (string, default `Trusted at scale`) — Small label shown above the heading.
- `heading` (string, default `Numbers our customers stand behind`) — Section heading.
- `subheading` (string, default `A UI system teams own outright — measured by the work it ships, not the lock-in it adds.`) — Supporting copy under the heading.
- `stats` (mixed|null, default `null`) — Headline stat pairs shown above the quotes; null falls back to sample data.
- `testimonials` (mixed|null, default `null`) — Quote entries with quote text, name, role, company, initials and rating; null falls back to sample data.
## Use when
- Pairing a metrics stats band with a grid of featured testimonial cards for combined quantitative and qualitative proof.
- Wanting numbers and quotes to reinforce each other in one section.
## Avoid when
- Wanting quotes only, without a stats band; use testimonials-grid instead.
## Rules
- Render the installed block with `<x-blocks.testimonials-stats />` and pass data through its props; edit the copied file only for structural changes.
- Keep the semantic design tokens (`bg-background`, `text-muted-foreground`); never swap in raw colour utilities.
- Keep the `data-slot` attributes and the logical (start/end) spacing so the markup still mirrors under `dir="rtl"`.
## Links
- Docs: https://brokui.dev/blocks/testimonials-stats
- Registry JSON (files, props, contract): https://brokui.dev/r/open/blocks/testimonials-stats.json
Working in Claude Code, Cursor or Codex? Give the agent the whole registry through the MCP server or the Brok UI skill.
Guidance
Use when
- Pairing a metrics stats band with a grid of featured testimonial cards for combined quantitative and qualitative proof.
- Wanting numbers and quotes to reinforce each other in one section.
Avoid when
- Wanting quotes only, without a stats band; use testimonials-grid instead.
Anti-patterns
- Do not replace semantic props with conflicting utility classes.
- Do not remove labels, focus styles, or state attributes.
Usage
Render the block as a component, passing data where useful:
<x-blocks.testimonials-stats />
Built from primitives
This block composes installed <brok:*> primitives and semantic design
tokens only — it does not reimplement any primitive. Re-theme it (light, dark, admin, customer) by
editing CSS variables; flip the preview to RTL to confirm it mirrors.
Source
The exact, editable file ui:add writes
into your app. The preview above renders this same source — there are no preview-only blocks.
@props([
'eyebrow' => 'Trusted at scale',
'heading' => 'Numbers our customers stand behind',
'subheading' => 'A UI system teams own outright — measured by the work it ships, not the lock-in it adds.',
'stats' => null,
'testimonials' => null,
])
@php
$stats ??= [
['value' => '10k+', 'label' => 'Teams shipping'],
['value' => '4.9/5', 'label' => 'Average rating'],
['value' => '99.9%', 'label' => 'Uptime'],
['value' => '2M+', 'label' => 'Requests per day'],
];
$testimonials ??= [
[
'quote' => 'We replaced three half-finished design systems with this in a weekend. Re-theming is now a config change, not a refactor.',
'name' => 'Avery Mitchell',
'role' => 'Head of Design',
'company' => 'Northwind',
'initials' => 'AM',
'rating' => 5,
],
[
'quote' => 'Owning the source is the whole game. No runtime lock-in, no upgrade anxiety — just plain Blade we can read and edit.',
'name' => 'Jordan Lee',
'role' => 'Staff Engineer',
'company' => 'Lumen',
'initials' => 'JL',
'rating' => 5,
],
[
'quote' => 'Accessibility used to be a backlog item. Now keyboard support and focus states ship by default with every block.',
'name' => 'Priya Nair',
'role' => 'Product Lead',
'company' => 'Cadence',
'initials' => 'PN',
'rating' => 5,
],
];
@endphp
<x-ui.section space="xl" {{ $attributes }}>
<x-ui.container gutter="sm">
<x-ui.section-heading align="center" overline-style="label" :overline="$eyebrow" :title="$heading" :subtitle="$subheading" />
@if ($stats)
<x-ui.card class="mt-12 p-0 sm:mt-16">
<div class="grid grid-cols-2 lg:grid-cols-4">
@foreach ($stats as $i => $stat)
<x-ui.stat
variant="plain"
size="lg"
:value="__($stat['value'])"
:label="__($stat['label'])"
@class([
'items-center px-6 py-8 text-center',
'border-t border-border sm:border-t-0' => $i >= 2,
'border-s border-border' => $i % 2 !== 0,
'lg:border-s lg:border-border' => $i % 2 === 0 && $i !== 0,
'lg:border-t-0' => $i >= 2,
])
/>
@endforeach
</div>
</x-ui.card>
@endif
<div class="mt-12 grid grid-cols-1 gap-6 sm:mt-16 sm:grid-cols-2 lg:grid-cols-3">
@foreach ($testimonials as $testimonial)
<x-ui.quote-card
glyph="none"
:quotes="false"
:rating="$testimonial['rating'] ?? null"
:quote="__($testimonial['quote'])"
:name="__($testimonial['name'])"
:role="__($testimonial['role'])"
:company="! empty($testimonial['company']) ? __($testimonial['company']) : null"
:initials="$testimonial['initials']"
/>
@endforeach
</div>
</x-ui.container>
</x-ui.section>
Ownership & lifecycle
Owner, release state, review evidence and adoption for this item.
- Owner
- Platform UI (@JoshJML)
- Current version
-
1.0.6 - Status
- Stable
- License
-
open - Deprecation
- Not deprecated
- Contract
-
v1 - Foundation
-
≥ 1.0.0