Skip to content

Code-sample hero

A developer hero pairing the pitch with a real, valid code sample in a window frame.

MarketingstarterFeaturedherodevelopercodeapi

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 { ArrowRight } from 'lucide-react'
import { ButtonLink } from '@/components/ui/button'
import { Container } from '@/components/ui/layout'

/**
 * Code-sample hero
 *
 * For developer products, where showing the API is more persuasive than
 * describing it. The sample is a real, syntactically valid snippet in a
 * window-chrome frame — never a screenshot, so it stays selectable, copyable
 * and legible at any zoom level.
 */
const sample = `import { Button, Card, Field, Input } from '@foundry/ui'

export function InviteCard() {
  return (
    <Card>
      <Field name="email" label="Invite a colleague" required>
        {(field) => <Input {...field} type="email" />}
      </Field>
      <Button className="mt-4">Send invitation</Button>
    </Card>
  )
}`

export default function CodeSampleHero() {
  return (
    <section className="border-b border-line bg-canvas py-section">
      <Container>
        <div className="grid items-center gap-10 lg:grid-cols-2 lg:gap-14">
          <div>
            <p className="label-caps text-accent">For developers</p>
            <h2 className="display-type mt-4 text-3xl leading-tight font-semibold text-ink-strong sm:text-4xl">
              Components you can read in one sitting.
            </h2>
            <p className="mt-5 max-w-lg text-md text-ink-muted">
              No configuration objects, no theme providers to nest, no runtime CSS. Import a
              component, pass props, ship.
            </p>
            <div className="mt-8 flex flex-wrap gap-3">
              <ButtonLink
                href="/docs/getting-started"
                trailingIcon={<ArrowRight className="size-4" />}
              >
                Read the guide
              </ButtonLink>
              <ButtonLink href="/components" variant="outline">
                See every component
              </ButtonLink>
            </div>
          </div>

          <div className="overflow-hidden rounded-xl border border-line bg-code-surface shadow-lg">
            <div className="flex items-center gap-2 border-b border-white/10 px-4 py-2.5">
              <span className="flex gap-1.5" aria-hidden="true">
                <span className="size-2.5 rounded-full bg-white/20" />
                <span className="size-2.5 rounded-full bg-white/20" />
                <span className="size-2.5 rounded-full bg-white/20" />
              </span>
              <span className="font-mono text-2xs text-white/50">invite-card.tsx</span>
            </div>
            <pre className="thin-scrollbar overflow-x-auto p-4 font-mono text-xs leading-relaxed text-code-ink">
              <code>{sample}</code>
            </pre>
          </div>
        </div>
      </Container>
    </section>
  )
}

components/blocks/sections/hero/code-sample.tsx

import { ArrowRight } from 'lucide-react'
import { ButtonLink } from '@/components/ui/button'
import { Container } from '@/components/ui/layout'

/**
 * Code-sample hero
 *
 * For developer products, where showing the API is more persuasive than
 * describing it. The sample is a real, syntactically valid snippet in a
 * window-chrome frame — never a screenshot, so it stays selectable, copyable
 * and legible at any zoom level.
 */
const sample = `import { Button, Card, Field, Input } from '@foundry/ui'

export function InviteCard() {
  return (
    <Card>
      <Field name="email" label="Invite a colleague" required>
        {(field) => <Input {...field} type="email" />}
      </Field>
      <Button className="mt-4">Send invitation</Button>
    </Card>
  )
}`

export default function CodeSampleHero() {
  return (
    <section className="border-b border-line bg-canvas py-section">
      <Container>
        <div className="grid items-center gap-10 lg:grid-cols-2 lg:gap-14">
          <div>
            <p className="label-caps text-accent">For developers</p>
            <h2 className="display-type mt-4 text-3xl leading-tight font-semibold text-ink-strong sm:text-4xl">
              Components you can read in one sitting.
            </h2>
            <p className="mt-5 max-w-lg text-md text-ink-muted">
              No configuration objects, no theme providers to nest, no runtime CSS. Import a
              component, pass props, ship.
            </p>
            <div className="mt-8 flex flex-wrap gap-3">
              <ButtonLink
                href="/docs/getting-started"
                trailingIcon={<ArrowRight className="size-4" />}
              >
                Read the guide
              </ButtonLink>
              <ButtonLink href="/components" variant="outline">
                See every component
              </ButtonLink>
            </div>
          </div>

          <div className="overflow-hidden rounded-xl border border-line bg-code-surface shadow-lg">
            <div className="flex items-center gap-2 border-b border-white/10 px-4 py-2.5">
              <span className="flex gap-1.5" aria-hidden="true">
                <span className="size-2.5 rounded-full bg-white/20" />
                <span className="size-2.5 rounded-full bg-white/20" />
                <span className="size-2.5 rounded-full bg-white/20" />
              </span>
              <span className="font-mono text-2xs text-white/50">invite-card.tsx</span>
            </div>
            <pre className="thin-scrollbar overflow-x-auto p-4 font-mono text-xs leading-relaxed text-code-ink">
              <code>{sample}</code>
            </pre>
          </div>
        </div>
      </Container>
    </section>
  )
}

components/ui/button.tsx

import type { ButtonHTMLAttributes, ReactNode } from 'react'
import Link from 'next/link'
import { cn } from '@/lib/cn'
import { variants } from '@/lib/variants'
import { Spinner } from './spinner'

/**
 * Button
 *
 * The whole action surface of Foundry in one component. It is intentionally a
 * *shared* component (no `'use client'`): rendered from a Server Component it
 * ships zero JavaScript, and it upgrades to a client island automatically when
 * a Client Component imports it.
 *
 * Height, padding and radius resolve from density and radius tokens, so a
 * button restyles itself when the density or palette axis changes. Focus is
 * handled once, globally, by the `:focus-visible` rule in `globals.css`.
 */
const buttonVariants = variants(
  cn(
    'relative inline-flex items-center justify-center gap-2 whitespace-nowrap font-medium',
    'transition-colors duration-150 ease-standard select-none',
    'disabled:pointer-events-none disabled:opacity-50',
    'aria-disabled:pointer-events-none aria-disabled:opacity-50',
  ),
  {
    variants: {
      variant: {
        primary: 'bg-accent text-accent-ink hover:bg-accent-hover active:bg-accent-active',
        secondary: 'bg-surface-inverse text-ink-inverse hover:opacity-90 active:opacity-80',
        outline: 'border border-line-strong bg-surface text-ink hover:bg-surface-sunken',
        ghost: 'text-ink hover:bg-surface-sunken active:bg-surface-sunken',
        destructive: 'bg-danger text-white hover:opacity-90 active:opacity-80',
        success: 'bg-success text-white hover:opacity-90 active:opacity-80',
        warning: 'bg-warning text-white hover:opacity-90 active:opacity-80',
        link: 'text-accent underline underline-offset-4 hover:text-accent-hover',
        soft: 'bg-accent-soft text-accent-soft-ink border border-accent-line hover:brightness-[0.97]',
      },
      size: {
        sm: 'h-control-sm px-3 text-xs rounded-md',
        md: 'h-control px-[var(--density-control-padding-x)] text-sm rounded-md',
        lg: 'h-control-lg px-5 text-base rounded-md',
        icon: 'h-control w-control p-0 rounded-md',
        'icon-sm': 'h-control-sm w-control-sm p-0 rounded-sm',
      },
      block: { true: 'w-full', false: '' },
    },
    defaultVariants: { variant: 'primary', size: 'md', block: false },
    compound: [
      { variant: 'link', size: 'sm', class: 'h-auto px-0' },
      { variant: 'link', size: 'md', class: 'h-auto px-0' },
      { variant: 'link', size: 'lg', class: 'h-auto px-0' },
    ],
  },
)

export type ButtonVariant =
  | 'primary'
  | 'secondary'
  | 'outline'
  | 'ghost'
  | 'destructive'
  | 'success'
  | 'warning'
  | 'link'
  | 'soft'

export type ButtonSize = 'sm' | 'md' | 'lg' | 'icon' | 'icon-sm'

export interface ButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
  variant?: ButtonVariant
  size?: ButtonSize
  block?: boolean
  /** Swaps content for a spinner while preserving the button's measured width. */
  loading?: boolean
  /** Announced by assistive tech while `loading` is true. */
  loadingLabel?: string
  leadingIcon?: ReactNode
  trailingIcon?: ReactNode
}

export function Button({
  variant = 'primary',
  size = 'md',
  block = false,
  loading = false,
  loadingLabel = 'Working',
  leadingIcon,
  trailingIcon,
  className,
  children,
  disabled,
  type = 'button',
  ...props
}: ButtonProps) {
  return (
    <button
      type={type}
      className={buttonVariants({ variant, size, block, className })}
      disabled={disabled ?? loading}
      aria-busy={loading || undefined}
      {...props}
    >
      {loading ? (
        <>
          {/* Label stays in the DOM but hidden so the control never collapses
              to spinner width halfway through an interaction. */}
          <span className="invisible flex items-center gap-2" aria-hidden="true">
            {leadingIcon}
            {children}
            {trailingIcon}
          </span>
          <span className="absolute inset-0 flex items-center justify-center">
            <Spinner size="sm" />
            <span className="sr-only">{loadingLabel}</span>
          </span>
        </>
      ) : (
        <>
          {leadingIcon}
          {children}
          {trailingIcon}
        </>
      )}
    </button>
  )
}

export interface ButtonLinkProps {
  href: string
  variant?: ButtonVariant
  size?: ButtonSize
  block?: boolean
  className?: string
  children?: ReactNode
  leadingIcon?: ReactNode
  trailingIcon?: ReactNode
  'aria-label'?: string
  'aria-current'?: 'page' | 'step' | 'true' | undefined
  target?: string
  rel?: string
  prefetch?: boolean
}

/** Anchor styled as a button, for when the action is really navigation. */
export function ButtonLink({
  href,
  variant = 'primary',
  size = 'md',
  block = false,
  className,
  children,
  leadingIcon,
  trailingIcon,
  ...props
}: ButtonLinkProps) {
  return (
    <Link href={href} className={buttonVariants({ variant, size, block, className })} {...props}>
      {leadingIcon}
      {children}
      {trailingIcon}
    </Link>
  )
}

export { buttonVariants }

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

Usage

For developer products, where showing the API is more persuasive than describing it. The sample is real text, never a screenshot, so it stays selectable and legible at any zoom.

  • Keep the sample under fifteen lines — a hero is not documentation.
  • The code block scrolls horizontally rather than wrapping, so indentation survives.

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.

  • Window chrome
  • Selectable code
  • Two actions

Accessibility

Real text
The sample is a pre element, so it can be selected, copied and read by a screen reader.
Decorative chrome
The window dots are aria-hidden.

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.