zod.dev

DESIGN.md

Narrative design system document — paste directly into Claude Code, Cursor, or Bolt.

---
version: alpha
name: zod.dev
description: "Light product system built on #fafafa with #f5f5f5 as the primary CTA accent. Type anchored in Inter at 30px / weight 700. Extracted automatically from https://zod.dev/ — rendered styles via getComputedStyle() + CSS custom properties (token-only values may not be painted)."
narrative: |
  zod.dev is built on a pure-white canvas (rgb(250, 250, 250)).
  The system uses rgb(245, 245, 245) as the singular interactive color.
  Inter as the primary typeface.
  Inter is paired with Inter Fallback for secondary roles.
  A restrained elevation system (1 distinct shadow) — shadows reserved for the few elements that must lift off the page.
  Motion is a first-class concern — 17 keyframe animations plus transition-driven interactions.

colors:
  background: "#fafafa"
  surface-1: "#f5f5f5"
  surface-2: "#fefefe"
  ink: "#0a0a0a"
  ink-muted: "rgba(10, 10, 10, 0.65)"
  ink-subtle: "#737373"
  primary: "#f5f5f5"
  on-primary: "#111111"
  primary-hover: "#b81481"
  hairline: "#e5e5e5"
  primary-focus: "#737373"

typography:
  display-xl:
    fontFamily: "Inter, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif"
    fontSize: 30px
    fontWeight: 700
    lineHeight: 1.2
    letterSpacing: 0
  display-md:
    fontFamily: "Inter, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif"
    fontSize: 20px
    fontWeight: 600
    lineHeight: 1.6
    letterSpacing: 0
  body:
    fontFamily: "Inter, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif"
    fontSize: 16px
    fontWeight: 400
    lineHeight: 1.5
    letterSpacing: 0
  body-sm:
    fontFamily: "Inter, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif"
    fontSize: 15px
    fontWeight: 500
    lineHeight: 1.43
    letterSpacing: 0
  button:
    fontFamily: "Inter, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif"
    fontSize: 14px
    fontWeight: 500
    lineHeight: 1.43
    letterSpacing: 0

rounded:
  none: 0px
  xs: 5px
  sm: 8px
  md: 14px
  lg: 20px
  xl: 32px
  pill: 9999px

spacing:
  xxs: 2px
  xs: 6px
  sm: 8px
  md: 12px
  lg: 24px
  xl: 27px
  xxl: 64px

components:
  button-icon-button:
    backgroundColor: "transparent"
    textColor: "{colors.primary-focus}"
    typography: "{typography.button}"
    rounded: "{rounded.xs}"
    padding: 6px
  button-ghost:
    backgroundColor: "transparent"
    textColor: "{colors.ink-muted}"
    typography: "{typography.button}"
    rounded: "{rounded.sm}"
    padding: 6px 16px 6px 8px
  button-light--invert:
    backgroundColor: "{colors.primary}"
    textColor: "{colors.primary-focus}"
    typography: "{typography.button}"
    rounded: "{rounded.sm}"
    padding: 6px
  navigation-main-nav:
    backgroundColor: "transparent"
    typography: "{typography.body}"
    rounded: "{rounded.none}"
    padding: 0px 16px
  code-block-inline-code--pre:
    backgroundColor: "#e3e3e3"
    textColor: "{colors.ink-muted}"
    typography: "{typography.button}"
    rounded: "{rounded.xs}"
    padding: 3px 6px

extracted_at: "2026-06-11T06:21:16.200Z"
completeness: 74
scoreVersion: "v2"

---

# Design System — zod.dev
> Extracted automatically by Prism from https://zod.dev
> Date: 2026-06-11
> Viewport: Desktop 1440x900 + Mobile 390x844
> Values are extracted, not hand-written: rendered styles via getComputedStyle() + colors declared in CSS custom properties (token-only values are marked `(token)` and may not be painted).


## 0. Design DNA

**Density**: moderate  |  **Motion**: expressive  |  **Weight**: heavy  |  **Aesthetic**: product-neutral

| Dimension | Value | Signal |
|---|---|---|
| Canvas | neutral | `#fafafa` |
| Type posture | sans-led (Inter) | "Zod" |
| Color assertion | dual-accent | #f5f5f5 |
| Whitespace | moderate | section rhythm 48px |
| Interaction | expressive | 17 keyframes, 11 transitions |
| Radius language | 8px-rounded | from token scale |

**Prism fingerprint**: `neutral-canvas · sans-display · dual-accent · 8px-rounded · expressive-motion`

> **🤖 TL;DR for AI agents** (read this first — saves you scanning the full doc):
>
> - **Canvas**: `rgb(250, 250, 250)` is the page background. Every component composits against this.
> - **Accent**: `rgb(245, 245, 245)` for primary CTAs ONLY. Never decorative.
> - **Body type**: 16px (token: `typography.body`). Default for ALL text not in a heading role.
> - **Section rhythm**: 48px between major bands. Card padding: 24px.
> - **Default radius**: 8px on buttons/inputs. Pills (`9999px`) only for icon-buttons or status chips.
>
> **Before generating UI**: import this DESIGN.md, scan §2 (Color Palette) + §4 (Components) + §10 (Agent Guide). Skip §11–12 unless extending.

## 1. Visual Theme & Atmosphere

zod.dev sits on a off-white canvas (`#fafafa`), a neutral foundation calibrated for sustained reading and component contrast. 

Typography is anchored in **Inter**. Headlines use weight 700 for confident, assertive presence — the brand wants to be heard. 

Body text reads in Pure Black (`#0a0a0a`) — softened from pure black, a small but deliberate detail that lowers reading friction. **Off-White** (`#f5f5f5`) provides interactive distinction without visual aggression. Elevation comes from a small, deliberate set of shadows (1 distinct), each a multi-layer stack — several blurred layers at varying offsets — used sparingly rather than across the whole UI. 
Motion design uses smooth easing curves for polished state transitions. 

**Key Characteristics:**
- Background: Off-White (`#fafafa`)
- Primary typeface: Inter
- Primary text: Pure Black (`#0a0a0a`)
- Accent: Off-White (`#f5f5f5`)
- Shadow system: 1 distinct elevation levels
- Custom fonts loaded: Inter, Inter Fallback

## 2. Color Palette & Roles

### Background & Surface
- **Off-White** (`#fafafa`): Page background (primary)
- **Whitesmoke** (`#e5e5e5`): Surface / elevated background
- **Off-White** (`#f5f5f5`): Surface / elevated background
- **Pure White** (`#fefefe`): Surface / elevated background
- **Off-White** (`#f0f0f0`): Surface / elevated background

### Text & Content
- **Pure Black** (`#0a0a0a`): Primary body text
- **Black** (`#000000`): Secondary text
- **Near-Black** (`#171717`): Secondary text
- **Near-Black** (`#24292e`): Secondary text
- **#032f62** (`#032f62`): Secondary text

### Accent & Interactive
- **#b81481** (`#b81481`): Interactive / accent
- **Vermillion** (`#d73a49`): Interactive / accent
- **M Tricolor Blue** (`#005cc5`): Interactive / accent
- **Slate Blue** (`#6f42c1`): Interactive / accent

### Border & Divider
- **Whitesmoke** (`#e3e3e3`): Borders / dividers

### Full Extracted Palette
**18 colors rendered on the page** + **3** more declared in design tokens (CSS custom properties — not necessarily painted). (15 categorized above + 6 additional below.)
Rendered values are read via `getComputedStyle()`; token values come from CSS variable declarations. Third-party logo colors are filtered out.

- `#737373` — Slate Grey
- `#6a737d` — Slate Gray
- `#ffffff` — White
- `#e60a64` — Ruby *(token)*
- `#0ac864` — Emerald *(token)*
- `#a3a3a3` — Grey *(token)*

### CSS Custom Properties (Design Tokens)

**Shadow Token**
- `--tw-inset-shadow-alpha`: `100%`
- `--tw-ring-shadow`: `0 0 #0000`
- `--tw-drop-shadow-alpha`: `100%`
- `--tw-inset-ring-shadow`: `0 0 #0000`

**Font Weight Token**
- `--font-weight-bold`: `700`
- `--font-weight-light`: `300`
- `--font-weight-semibold`: `600`
- `--font-weight-extrabold`: `800`

**Error / Destructive**
- `--color-red-500`: `oklch(63.7% .237 25.331)`

**Spacing Token**
- `--spacing-fd-container`: `1400px`
- `--spacing`: `.25rem`

**Motion Token**
- `--default-transition-duration`: `.15s`
- `--default-transition-timing-function`: `cubic-bezier(.4,0,.2,1)`

**Border Radius Token**
- `--radius-2xl`: `1rem`
- `--radius-md`: `.375rem`
- `--radius-lg`: `.5rem`
- `--radius-xl`: `.75rem`

**Other tokens**
- `--text-2xl`: `1.5rem`
- `--text-7xl`: `4.5rem`
- `--text-lg`: `1.125rem`
- `--text-8xl--line-height`: `1`
- `--color-fd-secondary`: `#f5f5f5`
- `--color-blue-700`: `oklch(48.8% .243 264.376)`
- `--text-5xl--line-height`: `1`
- `--text-base--line-height`: `calc(1.5 / 1)`

## 3. Typography Rules

### Font Families
- **Primary**: `Inter`
- **Secondary**: `Inter Fallback`
- **Font 3**: `ui-sans-serif`
- **Font 4**: `ui-monospace`

### Custom Fonts Loaded
- **Inter** weight 100 900 (normal)
- **Inter Fallback** weight normal (normal)

### Typography Hierarchy

| Role | Font | Size | Weight | Line Height | Letter Spacing | Notes |
|------|------|------|--------|-------------|----------------|-------|
| Display Hero | Inter | 30px | 700 | 1.2 | normal | Main headline (h1) |
| Sub-heading | Inter | 20px | 600 | 1.6 | normal | Third-level heading (h3) |
| Body | Inter | 16px | 400 | 1.5 | normal | Standard reading text |
| Link | Inter | 15px | 500 | 1.43 | normal | Link (15px) — Decoration: none |
| Card Title | Inter | 14px | 400 | 1.43 | normal | Card headings |
| Button | Inter | 14px | 500 | 1.43 | normal | Button label (14px) |
| Button | Inter | 14px | 200 | 1.43 | normal | Button label (14px) |

### Font Weight Scale

CSS custom properties define 6 explicit weight steps:
- `--font-weight-light`: `300` — Light
- `--font-weight-normal`: `400` — Regular
- `--font-weight-medium`: `500` — Medium
- `--font-weight-semibold`: `600` — SemiBold
- `--font-weight-bold`: `700` — Bold
- `--font-weight-extrabold`: `800` — ExtraBold

### Full Font Size Scale

Sizes detected in the design (descending): `30px`, `24px`, `20px`, `18px`, `16px`, `15px`, `14px`, `13px`, `12px`

> 4 size(s) detected outside the sampled hierarchy (24px, 18px, 13px, 12px). These appear on elements not in the sampled set — likely additional display sizes, marketing-section overrides, or third-party-widget styles.

## 4. Component Stylings

### Buttons

**Icon Button**
- Background: `transparent`
- Text: `#737373` `{colors.primary-focus}`
- Padding: 6px
- Radius: 6px
- Font: 14px weight 500
- Use: Toolbar/UI icons
- Focus: outline: `rgb(115, 115, 115) auto 1px`

**Ghost**
- Background: `transparent`
- Text: `#0a0a0a` `{colors.ink-muted}`
- Padding: 6px 16px 6px 8px
- Radius: 8px
- Font: 14px weight 400
- Use: Subtle action, toolbar, nav button
- Focus: outline: `rgb(115, 115, 115) auto 1px`

**Light / Invert**
- Background: `#f5f5f5` `{colors.primary}`
- Text: `#737373` `{colors.primary-focus}`
- Padding: 6px
- Radius: 8px
- Border: 1px solid rgb(229, 229, 229)
- Font: 14px weight 200
- Use: Bright CTA on dark sections
- Focus: outline: `rgb(115, 115, 115) auto 1px`

**Ghost**
- Background: `transparent`
- Text: `#737373` `{colors.primary-focus}`
- Padding: 6px 8px
- Radius: 6px
- Font: 14px weight 400
- Use: Subtle action, toolbar, nav button
- Focus: outline: `rgb(115, 115, 115) auto 1px`

**Outline**
- Background: `transparent`
- Text: `#0a0a0a` `{colors.ink-muted}`
- Padding: 0px
- Radius: 9999px
- Border: 1px solid rgb(229, 229, 229)
- Font: 14px weight 400
- Use: Secondary action with border
- Focus: outline: `rgb(115, 115, 115) auto 1px`

**Icon Button**
- Background: `transparent`
- Text: `#0a0a0a` `{colors.ink-muted}`
- Padding: 8px
- Radius: 6px
- Font: 14px weight 500
- Use: Toolbar/UI icons
- Focus: outline: `rgb(115, 115, 115) auto 1px`

**Outline**
- Background: `transparent`
- Text: `#0a0a0a` `{colors.ink-muted}`
- Padding: 16px
- Radius: 8px
- Border: 1px solid rgb(229, 229, 229)
- Font: 14px weight 400
- Use: Secondary action with border
- Focus: outline: `rgb(115, 115, 115) auto 1px`

### Navigation

**Main Nav**
- Background: `transparent`
- Padding: 0px 16px
- Radius: none
- Font: 16px weight 400
- Use: Fixed/sticky flex nav — N/A items

### Code Blocks

**Inline Code / Pre**
- Background: `#e3e3e3`
- Text: `#0a0a0a` `{colors.ink-muted}`
- Padding: 3px 6px
- Radius: 5px
- Font: 13px weight 300 — ui-monospace
- Use: Code samples, CLI commands, syntax highlighting blocks


## 4b. Component Behaviors (State Matrix)

### Interaction State Narrative


*State transitions extracted via Playwright simulation — exact values in the YAML matrix below.*

```yaml
component-behaviors:
  button:
    default:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(115, 115, 115)"
    focus:
      bg: "transparent"
      fg: "inherit"
  link:
    default:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(10, 10, 10)"
  card:
    default:
      bg: "rgb(254, 254, 254)"
      fg: "rgb(10, 10, 10)"
  navLink:
    default:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(10, 10, 10)"
```

**Agent usage**: Validate generated components against this matrix. If your output's `:hover` state changes properties not listed here, you are off-brand.


## 4c. Component Vocabulary (Closed System)

*This brand uses ONLY the following component vocabulary. Introducing new variants without justification breaks the system's tonal coherence.*

### Buttons
- **4 shape(s)** in this system: `Icon Button`, `Ghost`, `Light / Invert`, `Outline`
- **DO NOT introduce new buttons variants** without justification

### Navigation
- **1 shape(s)** in this system: `Main Nav`
- **DO NOT introduce new navigation variants** without justification

### Code Blocks
- **1 shape(s)** in this system: `Inline Code / Pre`
- **DO NOT introduce new code blocks variants** without justification

## 5. Layout Principles

### Layout Type
**sidebar + main content**

### Grid
Flexbox row

### Max Width
1200px

### Spacing System
Compact spacing — information density prioritized

| Token | Value |
|-------|-------|
| xxs | 2px |
| xs | 6px |
| sm | 8px |
| md | 12px |
| base | 16px |
| lg | 24px |
| xl | 27px |
| 2xl | 48px |
| 3xl | 64px |

### Border Radius Scale
| Name | Value | Use |
|------|-------|-----|
| None | 0px | No rounding |
| Xs | 5px | Tiny corners (badges, micro elements) |
| Sm | 8px | Buttons, inputs, small elements |
| Md | 14px | Cards, containers |
| Lg | 20px | Large rounded elements, pill segments |
| Xl | 32px | Category strips, featured containers |
| Full | 9999px | Pills, avatars, circular elements |

### Shape Language

| Component | Border Radius |
|-----------|---------------|
| Buttons | `6px` |
| Navigation | `none` |
| Code Blocks | `5px` |
| Page Body | `0px` |

**Shape Personality**: Moderate Rounding — Medium corners (4–12px). Modern SaaS standard, neither sharp nor pill.

**Full Radius Spectrum**: 5px, 6px, 7px, 8px (from `allBorderRadii` scan)


## 5b. Spacing Rhythm Names

*Named spacing tokens with explicit use cases. Use these names in YOUR code instead of raw pixels for consistency.*

| Name | Value | Use case |
|------|-------|----------|
| **hero** | `64px` | Top/bottom of full-bleed hero sections |
| **section** | `27px` | Between major bands (color change, content shift) |
| **subsection** | `24px` | Within a section, between content groups |
| **card** | `12px` | Card padding, list-item spacing |
| **compact** | `8px` | Form fields, tight clusters, badge padding |
| **micro** | `6px` | Icon-text gap, tag inner padding |

**Agent rule**: NEVER hardcode raw pixel values for spacing in generated UI. Always reference these named tokens (`spacing-rhythm.section`, etc.).

## 5c. Widget & Structure Library

Structural patterns extracted from the page DOM — these are the **blueprints** an agent should follow to reproduce the page architecture (not just CSS values).

**3/8 structural patterns detected.**

### Hero Pattern

- **Composition:** centered — Centered composition — heading + subheading + CTAs stacked vertically, content centered horizontally. Common for SaaS marketing pages.
- **Viewport coverage:** 442px tall (not full-viewport)
- **Heading:** "Zod" — 30px center-aligned
- **Subheading:** "TypeScript-first schema validation with static type inferenceby @colinhacks"
- **Media:** present, positioned top
- **CTAs:** none detected in hero (unusual — agent should verify)
- **Clone instruction:** Reproduce the **centered** layout. Use the heading font-size token at the documented size. Place media top of text.

### Card Grid Pattern

- **Card count:** 3 cards detected
- **Columns (desktop):** 4-up grid
- **Card dimensions:** 381×143px (aspect 2.66:1)
- **Gap:** 0px between cards
- **Content:** ✓ image
- **Image position:** top
- **Clone instruction:** Build a 4-column grid (desktop) with cards at ~2.66:1 aspect ratio. Each card has an image at the top.

### Footer Pattern

- **Columns:** 2
- **Links:** 0 total
- **Height:** 20px
- **Includes:** ✗ no newsletter | ✗ no social |  
- **Clone instruction:** Build a 2-column footer with ~0 links per column.

## 6. Depth & Elevation

| Level | Treatment | Use |
|-------|-----------|-----|
| Flat (Level 0) | No shadow | Page background, content blocks |
| Layered (Level 1) | <br>`rgba(0, 0, 0, 0.1) 0px 4px 6px -1px`,<br>`rgba(0, 0, 0, 0.1) 0px 2px 4px -2px` | Cards, elevated surfaces |

**Shadow Philosophy**: Multi-layered shadow system creating natural, atmospheric depth. Each shadow level combines multiple layers for realistic elevation.

## 7. Motion & Interaction

### Easing System

| CSS Variable | Curve | Semantic Name |
|--------------|-------|---------------|
| `--default-transition-timing-function` | `cubic-bezier(.4,0,.2,1)` | Ease Out — Decelerating |

### Duration Scale

| CSS Variable | Value | Tier |
|--------------|-------|------|
| `--default-transition-duration` | `.15s` | Fast |

### Copy-Paste Transition Snippets

**Color / Background**
```css
transition: color 0.1s cubic-bezier(0.4, 0, 0.2, 1), background-color 0.1s cubic-bezier(0.4, 0, 0.2, 1), border-color 0.1s cubic-...;
```

**Color / Background**
```css
transition: color 0.15s cubic-bezier(0.4, 0, 0.2, 1), background-color 0.15s cubic-bezier(0.4, 0, 0.2, 1), border-color 0.15s cub...;
```

**Opacity**
```css
transition: opacity 0.3s cubic-bezier(0.4, 0, 0.2, 1);
```

**All Props**
```css
transition: 0.15s cubic-bezier(0.4, 0, 0.2, 1);
```

### Keyframe Animation Catalog

| Animation Name | Type | Animated Props | Use Hint |
|----------------|------|----------------|----------|
| `spin` | Rotate / Spin | transform | Loading indicator |
| `fd-collapsible-down` | Fade | opacity, height | UI transition |
| `fd-collapsible-up` | Fade | height, opacity | UI transition |
| `fd-accordion-down` | Fade | opacity, height | UI transition |
| `fd-accordion-up` | Fade | height, opacity | UI transition |
| `fd-dialog-in` | Fade + Move | opacity, transform | UI transition |
| `fd-dialog-out` | Fade + Move | transform, opacity | UI transition |
| `fd-popover-in` | Fade + Move | opacity, transform | UI transition |
| `fd-popover-out` | Fade + Move | opacity, transform | UI transition |
| `fd-fade-in` | Fade | opacity | Element entrance |
| `fd-fade-out` | Fade | opacity | Element exit |
| `fd-enterFromRight` | Fade + Move | opacity, transform | Element entrance |
| `fd-enterFromLeft` | Fade + Move | opacity, transform | Element entrance |
| `fd-exitToRight` | Fade + Move | opacity, transform | Element exit |
| `fd-exitToLeft` | Fade + Move | opacity, transform | Element exit |
| `fd-nav-menu-in` | Fade | opacity, height | UI transition |
| `fd-nav-menu-out` | Fade | opacity, height | UI transition |

### Motion Fingerprint

- **Speed Character**: Balanced Pacing (median duration: `200ms`)
- **Dominant Easing**: custom cubic-bezier curves
- **Animation Library**: 17 unique animations (17 total including variants)

> This design moves with balanced pacing timing using custom cubic-bezier curves, creating a UI that feels natural and fluid.

## 8. Do's and Don'ts

### Do
- Use Off-White (`#fafafa`) as the page background — it's intentionally not pure white
- Use Pure Black (`#0a0a0a`) for text — not pure black, it's warmer and more readable
- Use Inter as the primary typeface — it defines the brand personality
- Use the extracted shadow patterns for elevation — they are tuned to match the brand palette
- Use Off-White (`#f5f5f5`) as the primary accent — it's the brand's signature interactive color
- Use 6px border-radius on buttons — the standard corner rounding for interactive elements
- Each card includes a top image — imagery is part of the card identity, not optional
- Use a 4-column grid on desktop — density matters for this content type

### Don't
- Don't use pure white (`#ffffff`) as a page background — the warm tone is part of the brand identity
- Don't use pure black (`#000000`) for text — the near-black adds warmth
- Don't substitute with generic sans-serif or serif — the custom font carries the brand
- Don't invent new shadow values — use only the extracted shadow levels
- Don't introduce additional saturated accent colors — the palette is intentionally controlled
- Don't over-build the footer — this design keeps it minimal (2 cols, 0 links)


## 7b. Enforceable Brand Rules

*Structured Do/Don't with reasoning and validation tests. Agents can programmatically verify generated UI.*

```yaml
rules:
  - id: brand-canvas-001
    type: do
    rule: "Always use the page background `rgb(250, 250, 250)` as the base canvas"
    why: "Every component is designed to composit against this exact tone"
    test: "document.body.style.backgroundColor === 'rgb(250, 250, 250)'"
  - id: brand-accent-001
    type: do
    rule: "Reserve `rgb(245, 245, 245)` for primary CTAs and brand-mark signals only"
    why: "Single chromatic assertion device — overuse dilutes meaning"
    test: "querySelectorAll('[style*=\"rgb(245, 245, 245)\"]').length <= 3 per fold"
```

## 9. Responsive Behavior

### Breakpoints
| Name | Width | Key Changes |
|------|-------|-------------|
| Mobile Large | 640px | Expanded mobile layout |
| Tablet | 768px | Multi-column grids begin |
| Tablet | 1024px | Multi-column grids begin |
| Desktop | 1280px | Full feature layout |
| Large Desktop | 1536px | Maximum content width |

### Token Diff — Desktop vs Mobile

| Element | Property | Desktop | Mobile |
|---------|----------|---------|--------|
| card | width | `286px` | `390px` |
| sidebar | width | `286px` | `390px` |

### Collapsing Strategy
- Navigation: horizontal links → hamburger menu on mobile
- Cards: multi-column → stacked vertical on mobile
- Footer: multi-column → stacked single column on mobile

### Touch Targets
- Buttons: 6px padding
- Navigation: adequate spacing between items
- Interactive elements: minimum 44px touch target recommended

### Collapsing Narrative

How the structural patterns adapt from desktop to mobile (extracted from both viewport extractions):

- **Card grid: 4-up → 1-up** — cards stack as viewport narrows, becoming a vertical list on mobile.


## 7c. Visual Effects & Dynamic Behavior

*The live/dynamic layer beyond static CSS — reproduce these, not flat substitutes. This is often what separates a faithful clone from a wireframe.*

- **Glassmorphism** — 5 frosted/blur layer(s) (e.g. `blur(16px)`).
- **CSS-variable animations** (3) — animated custom properties.

> **Motion fingerprint**: glassmorphism (5 layers)

## 9b. Visual Tone & Photography

**Tone:** Mixed photography + illustration

A balanced mix of photographic content and vector graphics. Photos likely carry product/lifestyle context while SVG handles icons, logos, and decorative accents.

**Canonical Brand Image (OG):**
- https://zod.dev/og.png?title=Intro&description=Introduction%20to%20Zod%20-%20TypeScript-first%20schema%20validation%20library%20with%20static%20type%20inference&path=zod.dev (1200×630px)
  *This is the image shown when the site is shared on social media — represents the brand visual essence.*

**Hero Image (above-fold dominant visual):**
- Aspect: 1.18:1 (landscape)
- Rendered size: 200×170px
- Alt text: "Zod logo"
- *Use this aspect ratio + composition for your clone's hero — mimicking the proportion preserves the visual hierarchy.*

**Aspect Ratio Distribution:**
- Landscape (1.15–2.3): 2 (67%)
- Portrait (<0.87): 0 (0%)
- Square (0.87–1.15): 0 (0%)
- Ultra-wide (>2.3): 1 (33%)

**Media Format Mix:**

**Average rendered image size:** 272×105px
**Above-fold image count:** 1 / 3

**Decorative Patterns Detected:**
- **Glassmorphism** detected (`backdrop-filter: blur`) — layered transparent surfaces with blur, modern OS-like aesthetic

**Clone instruction for decorative work:** Glassmorphism is a brand signature — use `backdrop-filter: blur(20px)` on overlapping surfaces.

**Imagery Guidance for clones:**
- Mix photography and illustration intentionally: photos for product/context, vectors for icons + decorative accents.
- Respect the format split — replacing JPGs with illustrations (or vice versa) will shift the brand tone.

## 10. Agent Prompt Guide

### Quick Reference
- Background: Off-White (`#fafafa`)
- Primary text: Pure Black (`#0a0a0a`)
- Accent: Off-White (`#f5f5f5`)
- Border: Whitesmoke (`#e5e5e5`)
- Font: Inter
- Body: 16px weight 400

### Example Component Prompts
- "Create a hero section on Off-White background (#fafafa). Headline at 30px Inter weight 700, line-height 1.2, color #0a0a0a."
- "Create the primary CTA button: `#f5f5f5` background, `#b81481` text, 6px border-radius, 6px 8px padding, 700 weight, Inter font."
- "Design a card on `#fefefe` background. Border: none. Radius: 0px. Shadow: none. Padding: 0px."
- "Build navigation: sticky on `#fafafa`. Inter 16px weight 400 for links."

### Iteration Guide
1. **Canvas**: Set the light canvas to Off-White (`#fafafa`) — every component is composited against this exact base.
2. **Typography**: All type in Inter, weight range 300–800. Never exceed 800 — heavier weights break the brand's tonal restraint.
3. **Accent**: Off-White (`#f5f5f5`) is the sole interactive color. On hover → #b81481 (`#b81481`). Use CSS transitions, not opacity/brightness filters.
4. **Motion**: All transitions use `cubic-bezier(0.4,0,0.2,1)`. Timing: 150ms for micro-interactions, 150ms for layout changes. Never use linear for UI transitions — preserve the brand's easing personality.
5. **Shape**: CTAs at `6px`, cards at `0px`. Apply border-radius from the extracted scale only — don't invent intermediate values.
6. **Spacing**: Use the `--ca-space-*` token scale (6px–27px). All padding, margin, and gap values are multiples from this scale — no magic numbers.
7. **Tokens**: Import from §11 CSS Export (`--ca-*` vars). Never hardcode hex values — always reference a token so theming remains consistent.

## 11. CSS Design Tokens Raw Export

*Copy-paste ready `:root {}` block — all values extracted directly from the live site.*

```css
/* Colors */
:root {
  --ca-background: #fafafa;
  --ca-primary: #f5f5f5;
  --ca-surface-2: #fefefe;
  --ca-ink-muted: #0a0a0a;
  --ca-primary-focus: #737373;
  --ca-on-primary: #111111;
  --ca-primary-hover: #b81481;
  --ca-hairline: #e5e5e5;
}

/* Typography */
:root {
  --ca-font-primary: "Inter", system-ui, sans-serif;
  --ca-text-display: 30px;
  --ca-text-body: 16px;
  --ca-text-small: 15px;
  --ca-text-button: 14px;
}

/* Spacing & Radius */
:root {
  --ca-space-xxs: 2px;
  --ca-space-xs: 6px;
  --ca-space-sm: 8px;
  --ca-space-md: 12px;
  --ca-space-base: 16px;
  --ca-space-lg: 24px;
  --ca-space-xl: 27px;
  --ca-space-2xl: 48px;
  --ca-space-3xl: 64px;
  --ca-radius-none: 0px;
  --ca-radius-xs: 5px;
  --ca-radius-sm: 8px;
  --ca-radius-md: 14px;
  --ca-radius-lg: 20px;
  --ca-radius-xl: 32px;
  --ca-radius-full: 9999px;
}
```


## 13. Page Structure Skeleton

*The actual layout the source site uses. Reproduce these sections in order to match the site structure.*

```yaml
page-skeleton:
  - section: navigation
    tag: main
    classes: ["flex", "flex-1", "flex-row", "pe-(--fd-layout-offset)"]
    height: 4907px
    width: full-bleed
    layout: flex-row justify=normal
    children: 3
  - section: navigation
    tag: aside
    classes: ["fixed", "top-[calc(var(--fd-banner-height)+var(--fd-nav-height))]", "z-30", "bg-fd-card"]
    height: 852px
    width: 286px
    layout: block
    children: 1
    bg: "rgb(254, 254, 254)"
  - section: unknown
    tag: div
    classes: ["@container", "grid", "gap-4", "pb-6"]
    height: 106px
    width: 764px
    layout: grid: 1-col gap=16px
    children: 1
    padding: "0px 0px 24px"
```

**Agent rule**: rebuild sections in this order (sorted by vertical position). Match the layout primitive (grid N-col / flex direction / block).


## 14. Copy Library (Real Content from Source)

*Actual text content extracted from the live page. Use these strings verbatim when reproducing the site — they carry the brand voice.*

```yaml
copy:
  section-headings:
    - "Introduction"
  sub-headings:
    - "\"strict\""
    - "Platinum"
    - "On this page"
  ctas:
    - "Zod 4 The latest version of Zod"
    - "Search Ctrl K"
    - "Intro"
    - "Basic usage"
  navigation:
    - "Intro"
    - "Basic usage"
    - "Defining schemas"
    - "Customizing errors"
    - "Formatting errors"
    - "Metadata and registries"
    - "JSON Schema"
    - "Codecs"
    - "Ecosystem"
    - "For library authors"
```

**Agent rule**: reuse these exact strings when generating UI. Do NOT translate or rephrase — brand voice is preserved through the original wording.


## 15. Asset Inventory (Image Roles & Ratios)

*Image inventory classified by role and aspect ratio. When reproducing the site, allocate this number of assets per role.*

```yaml
assets:
  logo:
    count: 3
    avg-ratio: 3.55
    common-aspect: "~16:6 banner"
    sample-alts:
      - "Zod CI status"
      - "License"
      - "Neon logo (light theme)"
  product:
    count: 1
    avg-ratio: 1.18
    common-aspect: "~1:1 square"
    sample-alts:
      - "Zod logo"
  thumbnail:
    count: 20
    avg-ratio: 1.00
    common-aspect: "~1:1 square"
    sample-alts:
      - "Sanity logo"
      - "Subtotal logo"
      - "Nitric logo"
  icon:
    count: 2
    avg-ratio: 1.22
    common-aspect: "~1:1 square"
    sample-alts:
      - "Zod logo"
      - "Zod 4"
```

**Agent rule**: when generating placeholder images, match these counts and aspect ratios. Use neutral placeholder backgrounds for `product` (e.g. `#f5f5f5`), full-color photography hints for `hero` and `editorial`.


## 16. Component HTML Templates

*Suggested HTML markup for reproducing the key components — based on what was detected in the source DOM.*

### Button (primary action)
```html
<button class="btn btn-primary">
  Action
</button>
```
_Source pattern detected: padding `6px` · radius `6px` · weight `500`_

### Generic Card
```html
<div class="card">
  <!-- content -->
</div>
```
_Source pattern detected: padding `0px` · radius `0px` · shadow `none`_

**Agent rule**: use these markup skeletons as the structural baseline. Apply tokens from §2-3 for visual styling.


## 17. Content Architecture & Resources (Links by Purpose)

*The page's links classified by purpose — the information architecture to reproduce. Categories, featured images, devices and projects are extracted from the rendered DOM, not guessed.*

**By purpose:** **nav** 18 · **docs** 2 · **social** 9 · **other** 31

**Projects / case studies detected** (clustered by URL + featured image):

*Packages* — medium confidence, 3 items:

| Title | Featured image | Link |
|---|---|---|
| Zod | `image?url=%2F_next%2Fstatic%2Fmedia%` | https://zod.dev/packages/zod |
| Zod Mini | `image?url=%2F_next%2Fstatic%2Fmedia%` | https://zod.dev/packages/mini |
| Zod Core | `image?url=%2F_next%2Fstatic%2Fmedia%` | https://zod.dev/packages/core |

*Colinhacks* — medium confidence, 3 items:

| Title | Featured image | Link |
|---|---|---|
| github logo | `image?url=%2F_next%2Fstatic%2Fmedia%` | https://github.com/colinhacks/zod |
| Zod logo | `image?url=%2Flogo%2Flogo-glow.png&w=` (ar 1.18) | https://github.com/colinhacks/zod/actions?query=branch%3Amain |
| zshy | — | https://github.com/colinhacks/zshy |

**Signals:** 44/60 links carry a featured image · dominant link roles: content-card (25), navigation (15), inline-link (11).


---
## Extraction Completeness: 74/100 (C)

| Category | Score | Max | Detail |
|----------|-------|-----|--------|
| Colors & Palette | 21 | 25 | 15 named colors |
| Typography | 18 | 20 | 7 roles defined |
| Components | 12 | 20 | 3 specs extracted |
| Motion & Interaction | 12 | 15 | Keyframes |
| CSS Custom Properties | 7 | 10 | 141 vars |
| Responsive Breakpoints | 5 | 5 | 5 breakpoints |
| Variable Fonts | 0 | 5 | None detected |

## 12. Known Gaps & Confidence

Explicit list of what this extraction could NOT capture. Agents should not invent values for these — either skip the feature or use the documented baseline + heuristic fallback.

*Auto-detected extraction limitations — understand before building:*

- **Licensed web fonts (Inter)** — detected but not downloaded. Substitute with your licensed copy or a close fallback (see Typography section for metrics).
- **Sparse component extraction** — fewer than 5 component types detected. Highly dynamic sections (modals, datepickers, carousels) require interaction to render and are not captured in a static pass.

| Category | What's missing | Fallback strategy |
|----------|----------------|-------------------|
| **Dark mode** | No dark-mode CSS variables or media queries detected | Light mode is canonical; do not generate dark-mode variants unless explicitly requested |
| **Form inputs** | No text input fields detected on this page | Use the documented border-radius + accent border on focus; 12-16px padding inside |

### Per-section confidence

| Section | Confidence | Reason |
|---------|------------|--------|
| §1 Visual Theme | High | Body bg extracted via getComputedStyle() |
| §2 Colors | High | 141 CSS vars (semantic naming requires ≥20 for high) |
| §3 Typography | High | 7 typography roles inferred |
| §4 Components | Medium | 3 component variants captured |
| §7 Motion | High | Keyframes + transitions |
| §8 Do's/Don'ts | High | 14 rules generated; design-decisions.json has evidence per rule |
| §9 Responsive | High | 5 breakpoints detected |
| §9b Photography | High | 3 images, hero present |

## 11.1 CSS Implementation Guide (CSS Interception Engine v2.15+)

*Ready-to-use CSS from Prism's CSS Interception Engine — intercepted directly from the site's CSS files (bypasses CORS). Copy-paste into your `<style>` block.*

### Font Loading

1 font file(s) captured (47KB total). When running `prism add`, fonts are saved to `extractions/zod.dev/fonts/` and embedded as base64 in the output HTML.

**@font-face declarations to use:**
```css
@font-face {
  font-family: 'Inter';
  /* src: url('/fonts/Inter.woff2') format('woff2'); */
  font-weight: 100 900;
  font-style: normal;
  font-display: swap;
}
@font-face {
  font-family: 'Inter Fallback';
  /* src: url('/fonts/Inter-Fallback.woff2') format('woff'); */
  font-weight: normal;
  font-style: normal;
  font-display: swap;
}
```

### Keyframe Animations (Intercepted from CSS)

**17 @keyframes found** — these are the real animation definitions:

```
@keyframes spin { ... }
@keyframes fd-collapsible-down { ... }
@keyframes fd-collapsible-up { ... }
@keyframes fd-accordion-down { ... }
@keyframes fd-accordion-up { ... }
@keyframes fd-dialog-in { ... }
@keyframes fd-dialog-out { ... }
@keyframes fd-popover-in { ... }
@keyframes fd-popover-out { ... }
@keyframes fd-fade-in { ... }
@keyframes fd-fade-out { ... }
@keyframes fd-enterFromRight { ... }
@keyframes fd-enterFromLeft { ... }
@keyframes fd-exitToRight { ... }
@keyframes fd-exitToLeft { ... }
@keyframes fd-nav-menu-in { ... }
@keyframes fd-nav-menu-out { ... }
```

<details><summary>Full keyframes CSS (17 animations)</summary>

```css
@keyframes spin{to{transform:rotate(1turn)}}
@keyframes fd-collapsible-down{0%{opacity:0;height:0}
@keyframes fd-collapsible-up{0%{height:var(--radix-collapsible-content-height)}
@keyframes fd-accordion-down{0%{opacity:.5;height:0}
@keyframes fd-accordion-up{0%{height:var(--radix-accordion-content-height)}
@keyframes fd-dialog-in{0%{opacity:0;transform:scale(.95)}
@keyframes fd-dialog-out{0%{transform:scale(1)}
@keyframes fd-popover-in{0%{opacity:0;transform:scale(.98)translateY(-4px)}
@keyframes fd-popover-out{0%{opacity:1;transform:translateY(0)}
@keyframes fd-fade-in{0%{opacity:0}
@keyframes fd-fade-out{0%{opacity:1}
@keyframes fd-enterFromRight{0%{opacity:0;transform:translate(200px)}
@keyframes fd-enterFromLeft{0%{opacity:0;transform:translate(-200px)}
@keyframes fd-exitToRight{0%{opacity:1;transform:translate(0)}
@keyframes fd-exitToLeft{0%{opacity:1;transform:translate(0)}
@keyframes fd-nav-menu-in{0%{opacity:0;height:0}
@keyframes fd-nav-menu-out{0%{opacity:1;height:var(--radix-navigation-menu-viewport-height)}
```
</details>

### Hover State CSS (Intercepted)

**1 hover rule lines** captured from CSS files. Key interactive transitions from real CSS (not inferred):

```css
.prose :where(a:not([data-card]):hover):not(:where([class~=not-prose],[class~=not-prose] *)){opacity:.8}
```

> **Note**: All values above are extracted from the live site's CSS files. The font files are saved locally by Prism and embedded in the output HTML. Use them as-is for maximum fidelity.

## 11.2 Measured Reality (CDP Engine)

Captured directly from Chrome's engine across **all 784 rendered nodes** — not a sample. These are the values the page *actually paints*, weighted by how often they appear.

### Real Responsive Breakpoints
**5 breakpoints** read from the live `@media` rules (not guessed):
`640px` · `768px` · `1024px` · `1280px` · `1536px`

### Measured Design Scale
**Type scale by usage** (× = paint count): `16px`×293 · `14px`×270 · `13px`×140 · `24px`×36 · `20px`×29 · `18px`×8 · `15px`×3 · `12px`×2

**Radius scale** (× = paint count): `6px`×25 · `5px`×14 · `8px`×9 · `9999px`×1

**Weights** (× = paint count): `400`×367 · `500`×197 · `300`×142 · `600`×65 · `200`×10 · `700`×2

**Layout gaps** (× = paint count): `8px`×33 · `6px`×3 · `10px`×2 · `4px`×2 · `2px`×1 · `24px`×1 · `16px`×1 · `12px`×1

**Elevation (real shadows)**:
```css
rgba(0, 0, 0, 0.25) 0px 25px 50px -12px
rgba(0, 0, 0, 0.1) 0px 4px 6px -1px, rgba(0, 0, 0, 0.1) 0px 2px 4px -2px
```

### Provenance — measured styles on key elements
Read from the live CSSOM (includes runtime-injected CSS). This is *what actually styles the page*, by element:

```css
body { color:var(--color-fd-foreground) }
body { background-color:var(--color-fd-background) }
h1 { color:var(--tw-prose-headings); font-size:2.25em; font-weight:800 }
h1 { font-size:var(--text-3xl) }
h1 { font-weight:var(--font-weight-bold) }
h1 { color:var(--color-fd-headings) }
h2 { color:var(--tw-prose-headings); font-size:1.5em; font-weight:600 }
h2 { gap:calc(var(--spacing) * 2) }
h2 { color:var(--color-fd-headings) }
button { border-radius:var(--radius-md) }
button { font-size:var(--text-sm) }
button { font-weight:var(--font-weight-medium) }
```

> Selectors normalised to their semantic element — source class names are often build-hashed (`.bgDIHX`) and not reusable. The declarations + CSS vars are the transferable part.

---
*Generated by Prism — automated Playwright extraction + design analysis.*
*Source: https://zod.dev | 2026-06-11T06:21:16.224Z*
*Values extracted via getComputedStyle() (rendered) + CSS custom properties (tokens, marked `(token)`). Token-only values may not be painted — verify against the live site before shipping.*