Skip to content

Case study with a client quote

Story, figures and the client's own words, in that order.

Contentstartercase-studyquoteoutcomenarrative

Live preview

full widthLive preview — open it in a new tab for the full-height version.
Open the preview in a new tab

Source

This exact file renders the preview above.

import { Container } from '@/components/ui/layout'
import { Avatar } from '@/components/ui/avatar'
import { Badge } from '@/components/ui/badge'
import { caseStudies, testimonials } from '@/content/demo'

/**
 * Case study with a client quote
 *
 * The story, the numbers and the client's own words in one block. The quote
 * comes last deliberately — it lands harder after the evidence than before it.
 */
export default function QuoteOutcomeCaseStudy() {
  const study = caseStudies[1]
  const quote = testimonials[1]
  if (!study) return null

  return (
    <section className="border-b border-line bg-canvas py-section">
      <Container size="narrow">
        <div className="flex flex-wrap items-center gap-2">
          <Badge tone="accent">{study.client}</Badge>
          <Badge>{study.sector}</Badge>
          <Badge>{study.year}</Badge>
        </div>

        <h2 className="display-type mt-5 text-2xl leading-tight font-semibold text-ink-strong sm:text-3xl">
          {study.title}
        </h2>
        <p className="mt-4 text-md leading-relaxed text-ink-muted">{study.summary}</p>

        <dl className="mt-8 grid grid-cols-3 gap-4 border-y border-line py-6">
          {study.metrics.map((metric) => (
            <div key={metric.label}>
              <dd className="display-type text-2xl font-semibold text-ink-strong tabular-nums">
                {metric.value}
              </dd>
              <dt className="label-caps mt-1 text-ink-subtle">{metric.label}</dt>
            </div>
          ))}
        </dl>

        <figure className="mt-8">
          <blockquote className="text-md leading-relaxed text-ink italic">
            “{quote?.quote}”
          </blockquote>
          <figcaption className="mt-4 flex items-center gap-3">
            <Avatar name={quote?.name ?? 'Anonymous'} size="sm" decorative />
            <span className="text-sm text-ink-muted">
              <span className="font-medium text-ink-strong">{quote?.name}</span> — {quote?.role},{' '}
              {quote?.company}
            </span>
          </figcaption>
        </figure>
      </Container>
    </section>
  )
}

components/blocks/sections/case-studies/quote-outcome.tsx

import { Container } from '@/components/ui/layout'
import { Avatar } from '@/components/ui/avatar'
import { Badge } from '@/components/ui/badge'
import { caseStudies, testimonials } from '@/content/demo'

/**
 * Case study with a client quote
 *
 * The story, the numbers and the client's own words in one block. The quote
 * comes last deliberately — it lands harder after the evidence than before it.
 */
export default function QuoteOutcomeCaseStudy() {
  const study = caseStudies[1]
  const quote = testimonials[1]
  if (!study) return null

  return (
    <section className="border-b border-line bg-canvas py-section">
      <Container size="narrow">
        <div className="flex flex-wrap items-center gap-2">
          <Badge tone="accent">{study.client}</Badge>
          <Badge>{study.sector}</Badge>
          <Badge>{study.year}</Badge>
        </div>

        <h2 className="display-type mt-5 text-2xl leading-tight font-semibold text-ink-strong sm:text-3xl">
          {study.title}
        </h2>
        <p className="mt-4 text-md leading-relaxed text-ink-muted">{study.summary}</p>

        <dl className="mt-8 grid grid-cols-3 gap-4 border-y border-line py-6">
          {study.metrics.map((metric) => (
            <div key={metric.label}>
              <dd className="display-type text-2xl font-semibold text-ink-strong tabular-nums">
                {metric.value}
              </dd>
              <dt className="label-caps mt-1 text-ink-subtle">{metric.label}</dt>
            </div>
          ))}
        </dl>

        <figure className="mt-8">
          <blockquote className="text-md leading-relaxed text-ink italic">
            “{quote?.quote}”
          </blockquote>
          <figcaption className="mt-4 flex items-center gap-3">
            <Avatar name={quote?.name ?? 'Anonymous'} size="sm" decorative />
            <span className="text-sm text-ink-muted">
              <span className="font-medium text-ink-strong">{quote?.name}</span> — {quote?.role},{' '}
              {quote?.company}
            </span>
          </figcaption>
        </figure>
      </Container>
    </section>
  )
}

components/ui/avatar.tsx

import type { ReactNode } from 'react'
import { cn } from '@/lib/cn'
import { initials as toInitials } from '@/lib/format'

/**
 * Avatar / AvatarGroup
 *
 * Foundry ships no photography, so avatars render deterministic initials on a
 * tinted surface. The tint is derived from the name's character codes, which
 * keeps the same person the same colour on every page without a colour field
 * in the data.
 *
 * A decorative avatar next to a visible name is `aria-hidden`; a standalone
 * one exposes the name as its label.
 */
export interface AvatarProps {
  name: string
  size?: 'xs' | 'sm' | 'md' | 'lg' | 'xl'
  /** Suppresses the accessible name when the name is already on screen. */
  decorative?: boolean
  /** Small badge anchored bottom-right, e.g. a presence dot. */
  indicator?: ReactNode
  shape?: 'circle' | 'square'
  className?: string
}

const sizes = {
  xs: 'size-5 text-2xs',
  sm: 'size-7 text-2xs',
  md: 'size-9 text-xs',
  lg: 'size-12 text-sm',
  xl: 'size-16 text-lg',
} as const

const tints = [
  'bg-accent-soft text-accent-soft-ink',
  'bg-success-soft text-success',
  'bg-warning-soft text-warning',
  'bg-info-soft text-info',
  'bg-danger-soft text-danger',
  'bg-surface-sunken text-ink-muted',
] as const

function tintFor(name: string): string {
  let hash = 0
  for (let i = 0; i < name.length; i += 1) hash = (hash * 31 + name.charCodeAt(i)) % 997
  return tints[hash % tints.length] ?? tints[0]
}

export function Avatar({
  name,
  size = 'md',
  decorative = false,
  indicator,
  shape = 'circle',
  className,
}: AvatarProps) {
  return (
    <span className={cn('relative inline-flex shrink-0', className)}>
      <span
        role={decorative ? undefined : 'img'}
        aria-label={decorative ? undefined : name}
        aria-hidden={decorative || undefined}
        className={cn(
          'inline-flex items-center justify-center border border-line font-semibold select-none',
          shape === 'circle' ? 'rounded-full' : 'rounded-md',
          sizes[size],
          tintFor(name),
        )}
      >
        {toInitials(name)}
      </span>
      {indicator ? <span className="absolute -right-0.5 -bottom-0.5">{indicator}</span> : null}
    </span>
  )
}

export interface AvatarGroupProps {
  names: string[]
  size?: AvatarProps['size']
  /** Names beyond this count collapse into a "+n" chip. */
  max?: number
  className?: string
  label?: string
}

export function AvatarGroup({ names, size = 'sm', max = 4, className, label }: AvatarGroupProps) {
  const visible = names.slice(0, max)
  const overflow = names.length - visible.length

  return (
    <span
      className={cn('flex items-center', className)}
      role="group"
      aria-label={label ?? `${names.length} people`}
    >
      {visible.map((name) => (
        <span
          key={name}
          className="-ml-2 first:ml-0 ring-2 ring-[var(--color-surface)] rounded-full"
        >
          <Avatar name={name} size={size} decorative />
        </span>
      ))}
      {overflow > 0 ? (
        <span
          className={cn(
            '-ml-2 inline-flex items-center justify-center rounded-full border border-line bg-surface-sunken font-semibold text-ink-muted ring-2 ring-[var(--color-surface)]',
            sizes[size],
          )}
        >
          +{overflow}
        </span>
      ) : null}
      <span className="sr-only">{names.join(', ')}</span>
    </span>
  )
}

Demo source — adapt to your project. Foundry is not published as a package.

Usage

The quote comes last deliberately — it lands harder after the evidence than before it.

  • Use a quote from the same engagement, not a generic testimonial.
  • Keep the narrative to one paragraph; the figures carry the argument.

Variants and states

Every entry below is a genuine difference in behaviour or layout, and every one of them is visible in the preview above.

  • Narrative block
  • Three-figure rule
  • Closing quote

Accessibility

Figure semantics
The quote is a figure with blockquote and figcaption.
Metric pairing
Figures use a description list rather than styled spans.

Foundry implements published ARIA patterns and is tested against them. No WCAG certification is claimed — see the accessibility documentation for what is and is not covered.