Logo Cloud
Trusted-by logo clouds — a bordered grid (with an optional cursor-spotlight reveal), a marquee, an inline-heading row and an animated group cycler.
Preview
@props([
'eyebrow' => 'Trusted by teams worldwide',
'heading' => 'Trusted by fast-moving teams everywhere',
'logos' => null,
'spotlight' => false,
])
@php
// A "trusted by" logo cloud, optionally with a cursor-spotlight reveal
// (spotlight=true). The base grid renders the wordmarks in a muted token;
// when spotlight is on, an aria-hidden overlay duplicates them in
// text-foreground and is clipped by a radial mask centred on the pointer
// (the --x/--y CSS vars written by the inline Alpine handler), so logos
// brighten as the spotlight passes over them. The mask uses the bare
// `black`/`transparent` keywords (token-safe — no raw colour) and defaults
// to the centre, so a static spotlight still shows with no pointer and for
// reduced-motion users (onMove bails on prefers-reduced-motion).
$logos ??= [
'Northwind',
'Acme Co',
'Globex',
'Initech',
'Umbrella',
'Soylent',
'Hooli',
'Vandelay',
'Stark',
'Wayne',
];
$gridClasses = 'grid grid-cols-2 overflow-hidden rounded-lg border border-border sm:grid-cols-3 lg:grid-cols-5';
$cellClasses = 'flex items-center justify-center border-b border-e border-border p-6 last:border-e-0 sm:p-8 [&:nth-child(2n)]:border-e-0 sm:[&:nth-child(2n)]:border-e sm:[&:nth-child(3n)]:border-e-0 lg:[&:nth-child(3n)]:border-e lg:[&:nth-child(5n)]:border-e-0';
$logoClasses = 'text-base font-semibold tracking-tight sm:text-lg';
@endphp
<x-ui.section data-slot="logo-cloud-01" space="xl" {{ $attributes }}>
<div class="mx-auto max-w-5xl px-4">
<div class="flex flex-col items-center text-center">
@if ($eyebrow)
<x-ui.badge variant="secondary" class="mb-6">{{ __($eyebrow) }}</x-ui.badge>
@endif
<h2 class="text-balance text-2xl font-semibold tracking-tight text-muted-foreground sm:text-3xl">
{{ __($heading) }}
</h2>
<x-ui.separator class="mt-8 max-w-xs" />
</div>
@if ($spotlight)
{{-- Spotlight stage: the pointer position is mirrored into --x/--y;
the reveal layer is masked to a soft circle around it. --}}
<div
x-data="{
reduced: window.matchMedia('(prefers-reduced-motion: reduce)').matches,
onMove(e) {
if (this.reduced) return;
const r = this.$el.getBoundingClientRect();
this.$el.style.setProperty('--x', (e.clientX - r.left) + 'px');
this.$el.style.setProperty('--y', (e.clientY - r.top) + 'px');
},
}"
@pointermove="onMove($event)"
style="--x:50%; --y:50%; --spot:260px;"
class="group relative mt-12"
>
{{-- Base layer: muted wordmarks (always legible, the accessible copy). --}}
<ul role="list" class="{{ $gridClasses }}">
@foreach ($logos as $logo)
<li class="{{ $cellClasses }}">
<span class="{{ $logoClasses }} text-muted-foreground">{{ __($logo) }}</span>
</li>
@endforeach
</ul>
{{-- Reveal layer: a brighter duplicate clipped to the spotlight. It is
purely decorative (the base layer already carries the names). --}}
<ul
role="presentation"
aria-hidden="true"
class="{{ $gridClasses }} pointer-events-none absolute inset-0 border-transparent"
style="-webkit-mask-image:radial-gradient(var(--spot) circle at var(--x) var(--y), black 0%, transparent 70%); mask-image:radial-gradient(var(--spot) circle at var(--x) var(--y), black 0%, transparent 70%);"
>
@foreach ($logos as $logo)
<li class="{{ $cellClasses }} border-transparent">
<span class="{{ $logoClasses }} text-foreground">{{ __($logo) }}</span>
</li>
@endforeach
</ul>
</div>
@else
<ul role="list" class="{{ $gridClasses }} mt-12">
@foreach ($logos as $logo)
<li class="{{ $cellClasses }}">
<span class="{{ $logoClasses }} text-muted-foreground transition-colors hover:text-foreground">
{{ __($logo) }}
</span>
</li>
@endforeach
</ul>
@endif
</div>
</x-ui.section>
Installation
php artisan ui:add blocks/logo-cloud-grid
Registry contract
Install confidence
php artisan ui:add blocks/logo-cloud-grid
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.1.2
- License
- open
- Stability
- stable
- Contract
- v1
- Foundation
- ≥ 1.0.0
| Type | Generated target |
|---|---|
| blade | resources/views/blocks/logo-cloud-grid.blade.php |
Registry dependencies
Package dependencies
composer: jml/brok:^0.2
npm: alpinejs
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: Logo Cloud Grid (`logo-cloud-grid`)
A trusted-by logo cloud with a centered muted heading and a bordered-cell grid of monochrome token wordmarks that brighten on hover, with an optional cursor-following spotlight reveal.
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/logo-cloud-grid
```
## Render it
```blade
<x-blocks.logo-cloud-grid spotlight="false" />
```
## Props
- `spotlight` (boolean, default `false`) (variant) — Adds a cursor-following spotlight overlay that brightens the logos beneath the pointer (reduced-motion safe).
## Use when
- Use it for a 'trusted by' logo wall shown as a bordered-cell grid of monochrome wordmarks that brighten on hover.
- Reach for it when you want the optional cursor-following spotlight variant (spotlight prop) that brightens logos as the pointer passes over them.
## Avoid when
- Avoid it when logos should scroll continuously instead of sitting in a static grid; use logo-cloud-marquee (marquee) instead.
## Rules
- Render the installed block with `<x-blocks.logo-cloud-grid />` 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/logo-cloud-grid
- Registry JSON (files, props, contract): https://brokui.dev/r/open/blocks/logo-cloud-grid.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
- Use it for a 'trusted by' logo wall shown as a bordered-cell grid of monochrome wordmarks that brighten on hover.
- Reach for it when you want the optional cursor-following spotlight variant (spotlight prop) that brightens logos as the pointer passes over them.
Avoid when
- Avoid it when logos should scroll continuously instead of sitting in a static grid; use logo-cloud-marquee (marquee) instead.
Anti-patterns
- Do not replace semantic props with conflicting utility classes.
- Do not remove labels, focus styles, or state attributes.
- Anatomy
Usage
Render the block as a component, passing data where useful:
<x-blocks.logo-cloud-grid />
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 by teams worldwide',
'heading' => 'Trusted by fast-moving teams everywhere',
'logos' => null,
'spotlight' => false,
])
@php
// A "trusted by" logo cloud, optionally with a cursor-spotlight reveal
// (spotlight=true). The base grid renders the wordmarks in a muted token;
// when spotlight is on, an aria-hidden overlay duplicates them in
// text-foreground and is clipped by a radial mask centred on the pointer
// (the --x/--y CSS vars written by the inline Alpine handler), so logos
// brighten as the spotlight passes over them. The mask uses the bare
// `black`/`transparent` keywords (token-safe — no raw colour) and defaults
// to the centre, so a static spotlight still shows with no pointer and for
// reduced-motion users (onMove bails on prefers-reduced-motion).
$logos ??= [
'Northwind',
'Acme Co',
'Globex',
'Initech',
'Umbrella',
'Soylent',
'Hooli',
'Vandelay',
'Stark',
'Wayne',
];
$gridClasses = 'grid grid-cols-2 overflow-hidden rounded-lg border border-border sm:grid-cols-3 lg:grid-cols-5';
$cellClasses = 'flex items-center justify-center border-b border-e border-border p-6 last:border-e-0 sm:p-8 [&:nth-child(2n)]:border-e-0 sm:[&:nth-child(2n)]:border-e sm:[&:nth-child(3n)]:border-e-0 lg:[&:nth-child(3n)]:border-e lg:[&:nth-child(5n)]:border-e-0';
$logoClasses = 'text-base font-semibold tracking-tight sm:text-lg';
@endphp
<x-ui.section data-slot="logo-cloud-01" space="xl" {{ $attributes }}>
<div class="mx-auto max-w-5xl px-4">
<div class="flex flex-col items-center text-center">
@if ($eyebrow)
<x-ui.badge variant="secondary" class="mb-6">{{ __($eyebrow) }}</x-ui.badge>
@endif
<h2 class="text-balance text-2xl font-semibold tracking-tight text-muted-foreground sm:text-3xl">
{{ __($heading) }}
</h2>
<x-ui.separator class="mt-8 max-w-xs" />
</div>
@if ($spotlight)
{{-- Spotlight stage: the pointer position is mirrored into --x/--y;
the reveal layer is masked to a soft circle around it. --}}
<div
x-data="{
reduced: window.matchMedia('(prefers-reduced-motion: reduce)').matches,
onMove(e) {
if (this.reduced) return;
const r = this.$el.getBoundingClientRect();
this.$el.style.setProperty('--x', (e.clientX - r.left) + 'px');
this.$el.style.setProperty('--y', (e.clientY - r.top) + 'px');
},
}"
@pointermove="onMove($event)"
style="--x:50%; --y:50%; --spot:260px;"
class="group relative mt-12"
>
{{-- Base layer: muted wordmarks (always legible, the accessible copy). --}}
<ul role="list" class="{{ $gridClasses }}">
@foreach ($logos as $logo)
<li class="{{ $cellClasses }}">
<span class="{{ $logoClasses }} text-muted-foreground">{{ __($logo) }}</span>
</li>
@endforeach
</ul>
{{-- Reveal layer: a brighter duplicate clipped to the spotlight. It is
purely decorative (the base layer already carries the names). --}}
<ul
role="presentation"
aria-hidden="true"
class="{{ $gridClasses }} pointer-events-none absolute inset-0 border-transparent"
style="-webkit-mask-image:radial-gradient(var(--spot) circle at var(--x) var(--y), black 0%, transparent 70%); mask-image:radial-gradient(var(--spot) circle at var(--x) var(--y), black 0%, transparent 70%);"
>
@foreach ($logos as $logo)
<li class="{{ $cellClasses }} border-transparent">
<span class="{{ $logoClasses }} text-foreground">{{ __($logo) }}</span>
</li>
@endforeach
</ul>
</div>
@else
<ul role="list" class="{{ $gridClasses }} mt-12">
@foreach ($logos as $logo)
<li class="{{ $cellClasses }}">
<span class="{{ $logoClasses }} text-muted-foreground transition-colors hover:text-foreground">
{{ __($logo) }}
</span>
</li>
@endforeach
</ul>
@endif
</div>
</x-ui.section>
Ownership & lifecycle
Owner, release state, review evidence and adoption for this item.
- Owner
- Platform UI (@JoshJML)
- Current version
-
1.1.2 - Status
- Stable
- License
-
open - Deprecation
- Not deprecated
- Contract
-
v1 - Foundation
-
≥ 1.0.0