Skip to content
Brok UI

Loading…

No results

About

Open source

About-us sections — a story column with a values list paired with a card collage and a stat grid.

Preview

resources/views/blocks/about-split.blade.php Blade
@props([
    'eyebrow' => 'About us',
    'heading' => 'We build the tools we wished we had',
    'story' => null,
    'values' => null,
    'mission' => null,
    'stats' => null,
    'ctaLabel' => 'Meet the team',
    'ctaHref' => '#',
])

@php
    $story ??= [
        'Founded by a small group of engineers tired of rebuilding the same interfaces, we set out to make beautiful, accessible software the default — not an afterthought you bolt on at the end.',
        'Today we partner with teams in every timezone, shipping a design system they own outright. No lock-in, no upgrade anxiety: just code that reads clearly and bends to your brand.',
    ];

    $values ??= [
        'Own your code — nothing is hidden behind a runtime',
        'Accessibility and dark mode ship by default',
        'Semantic tokens make re-theming a config change',
    ];

    $mission ??= [
        'label' => 'Our mission',
        'title' => 'Make great interfaces the path of least resistance.',
        'body' => 'Every primitive is keyboard-friendly, mirrors under RTL, and respects reduced motion — so doing the right thing is also the easy thing.',
    ];

    $stats ??= [
        ['label' => 'Founded', 'value' => '2019', 'description' => 'Bootstrapped, profitable'],
        ['label' => 'Team', 'value' => '120+', 'description' => 'Across product & eng'],
        ['label' => 'Countries', 'value' => '30', 'description' => 'Fully remote-first'],
        ['label' => 'Avg. rating', 'value' => '4.9', 'description' => 'From 2,400 reviews'],
    ];
@endphp

<x-ui.section space="xl" {{ $attributes }}>
    <div class="mx-auto grid max-w-6xl grid-cols-1 items-center gap-12 px-4 lg:grid-cols-2 lg:gap-16">
        {{-- Left column: story --}}
        <div class="max-w-xl">
            @if ($eyebrow)
                <x-ui.badge variant="secondary" class="mb-6">{{ __($eyebrow) }}</x-ui.badge>
            @endif

            <h2 class="text-balance text-3xl font-bold tracking-tight sm:text-4xl">{{ __($heading) }}</h2>

            <div class="mt-6 space-y-4 text-pretty text-sm leading-relaxed text-muted-foreground">
                @foreach ($story as $paragraph)
                    <p>{{ __($paragraph) }}</p>
                @endforeach
            </div>

            <x-ui.check-list marker="chip" class="mt-8 font-medium">
                @foreach ($values as $value)
                    <x-ui.check-list.item>{{ __($value) }}</x-ui.check-list.item>
                @endforeach
            </x-ui.check-list>

            <x-ui.button :href="$ctaHref" class="mt-8">
                {{ __($ctaLabel) }}
                <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="size-4 rtl:-scale-x-100" aria-hidden="true">
                    <path d="M5 12h14M13 5l7 7-7 7" />
                </svg>
            </x-ui.button>
        </div>

        {{-- Right column: card collage --}}
        <div class="flex flex-col gap-4 sm:gap-6">
            <x-ui.card class="relative overflow-hidden bg-primary p-8 text-primary-foreground sm:p-8">
                <div class="absolute -end-10 -top-10 size-40 rounded-full bg-primary-foreground/10" aria-hidden="true"></div>
                <div class="relative">
                    <p class="text-sm font-semibold uppercase tracking-wide text-primary-foreground">{{ __($mission['label']) }}</p>
                    <p class="mt-4 text-balance text-xl font-semibold leading-snug sm:text-2xl">{{ __($mission['title']) }}</p>
                    <p class="mt-4 text-pretty text-sm leading-relaxed text-primary-foreground">{{ __($mission['body']) }}</p>
                </div>
            </x-ui.card>

            <div class="grid grid-cols-2 gap-4 sm:gap-6">
                @foreach ($stats as $stat)
                    <x-ui.stat
                        :label="__($stat['label'])"
                        :value="$stat['value']"
                        :description="__($stat['description'])"
                    />
                @endforeach
            </div>
        </div>
    </div>
</x-ui.section>

Installation

terminal
php artisan ui:add blocks/about-split

Installs these dependencies automatically:

Registry contract

Install confidence

php artisan ui:add blocks/about-split 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.5
License
open
Stability
stable
Contract
v1
Foundation
≥ 1.0.0
Type Generated target
blade resources/views/blocks/about-split.blade.php

Registry dependencies

badge button card check-list section stat

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.

about-split.md
# Brok UI block: About (`about-split`)

A split About Us section with an eyebrow, heading, story paragraphs, a check-icon values list and a primary CTA on the left, beside a card collage of a large mission card and a 2-up stat grid on the right.

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/about-split
```

## Render it

```blade
<x-blocks.about-split />
```

## Props

- `eyebrow` (string, default `About us`)
- `heading` (string, default `We build the tools we wished we had`)
- `story` (mixed|null, default `null`)
- `values` (mixed|null, default `null`)
- `mission` (mixed|null, default `null`)
- `stats` (mixed|null, default `null`)
- `cta-label` (string, default `Meet the team`)
- `cta-href` (string, default `#`)

## Use when

- Introducing a company with a founding story, a values checklist and a mission statement beside a stat grid.
- Closing an About page with a primary call-to-action (e.g. 'Meet the team') next to social-proof numbers.

## Avoid when

- Use about-stats for a stats-led about section or about-timeline for a milestone timeline instead.

## Rules

- Render the installed block with `<x-blocks.about-split />` 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/about-split
- Registry JSON (files, props, contract): https://brokui.dev/r/open/blocks/about-split.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

  • Introducing a company with a founding story, a values checklist and a mission statement beside a stat grid.
  • Closing an About page with a primary call-to-action (e.g. 'Meet the team') next to social-proof numbers.

Avoid when

  • Use about-stats for a stats-led about section or about-timeline for a milestone timeline 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:

resources/views/welcome.blade.php Blade
<x-blocks.about-split />

Built from primitives

Composes <brok:*> Semantic tokens Re-themeable RTL-ready

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.

resources/views/blocks/about-split.blade.php Blade
@props([
    'eyebrow' => 'About us',
    'heading' => 'We build the tools we wished we had',
    'story' => null,
    'values' => null,
    'mission' => null,
    'stats' => null,
    'ctaLabel' => 'Meet the team',
    'ctaHref' => '#',
])

@php
    $story ??= [
        'Founded by a small group of engineers tired of rebuilding the same interfaces, we set out to make beautiful, accessible software the default — not an afterthought you bolt on at the end.',
        'Today we partner with teams in every timezone, shipping a design system they own outright. No lock-in, no upgrade anxiety: just code that reads clearly and bends to your brand.',
    ];

    $values ??= [
        'Own your code — nothing is hidden behind a runtime',
        'Accessibility and dark mode ship by default',
        'Semantic tokens make re-theming a config change',
    ];

    $mission ??= [
        'label' => 'Our mission',
        'title' => 'Make great interfaces the path of least resistance.',
        'body' => 'Every primitive is keyboard-friendly, mirrors under RTL, and respects reduced motion — so doing the right thing is also the easy thing.',
    ];

    $stats ??= [
        ['label' => 'Founded', 'value' => '2019', 'description' => 'Bootstrapped, profitable'],
        ['label' => 'Team', 'value' => '120+', 'description' => 'Across product & eng'],
        ['label' => 'Countries', 'value' => '30', 'description' => 'Fully remote-first'],
        ['label' => 'Avg. rating', 'value' => '4.9', 'description' => 'From 2,400 reviews'],
    ];
@endphp

<x-ui.section space="xl" {{ $attributes }}>
    <div class="mx-auto grid max-w-6xl grid-cols-1 items-center gap-12 px-4 lg:grid-cols-2 lg:gap-16">
        {{-- Left column: story --}}
        <div class="max-w-xl">
            @if ($eyebrow)
                <x-ui.badge variant="secondary" class="mb-6">{{ __($eyebrow) }}</x-ui.badge>
            @endif

            <h2 class="text-balance text-3xl font-bold tracking-tight sm:text-4xl">{{ __($heading) }}</h2>

            <div class="mt-6 space-y-4 text-pretty text-sm leading-relaxed text-muted-foreground">
                @foreach ($story as $paragraph)
                    <p>{{ __($paragraph) }}</p>
                @endforeach
            </div>

            <x-ui.check-list marker="chip" class="mt-8 font-medium">
                @foreach ($values as $value)
                    <x-ui.check-list.item>{{ __($value) }}</x-ui.check-list.item>
                @endforeach
            </x-ui.check-list>

            <x-ui.button :href="$ctaHref" class="mt-8">
                {{ __($ctaLabel) }}
                <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="size-4 rtl:-scale-x-100" aria-hidden="true">
                    <path d="M5 12h14M13 5l7 7-7 7" />
                </svg>
            </x-ui.button>
        </div>

        {{-- Right column: card collage --}}
        <div class="flex flex-col gap-4 sm:gap-6">
            <x-ui.card class="relative overflow-hidden bg-primary p-8 text-primary-foreground sm:p-8">
                <div class="absolute -end-10 -top-10 size-40 rounded-full bg-primary-foreground/10" aria-hidden="true"></div>
                <div class="relative">
                    <p class="text-sm font-semibold uppercase tracking-wide text-primary-foreground">{{ __($mission['label']) }}</p>
                    <p class="mt-4 text-balance text-xl font-semibold leading-snug sm:text-2xl">{{ __($mission['title']) }}</p>
                    <p class="mt-4 text-pretty text-sm leading-relaxed text-primary-foreground">{{ __($mission['body']) }}</p>
                </div>
            </x-ui.card>

            <div class="grid grid-cols-2 gap-4 sm:gap-6">
                @foreach ($stats as $stat)
                    <x-ui.stat
                        :label="__($stat['label'])"
                        :value="$stat['value']"
                        :description="__($stat['description'])"
                    />
                @endforeach
            </div>
        </div>
    </div>
</x-ui.section>

Ownership & lifecycle

Owner, release state, review evidence and adoption for this item.
Owner
Platform UI (@JoshJML)
Current version
1.0.5
Status
Stable
License
open
Deprecation
Not deprecated
Contract
v1
Foundation
≥ 1.0.0