--- 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) |
`rgba(0, 0, 0, 0.1) 0px 4px 6px -1px`,
`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 ``` _Source pattern detected: padding `6px` · radius `6px` · weight `500`_ ### Generic Card ```html
``` _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 `