Code-sample hero
A developer hero pairing the pitch with a real, valid code sample in a window frame.
Live preview
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.
Related
All sectionsEditorial split hero
An asymmetric seven-and-four column hero where the statement and the note sit at different weights.
starterFeatured3 variantsDocumentation starter
A developer documentation site with six article routes, a guide index, an API reference and a working search page.
intermediateFeatured4 variantsAPI-first integrations
A valid request sample and an endpoint list instead of a partner wall.
intermediate3 variants