vuejs.org

DESIGN.md

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

---
version: alpha
name: vuejs.org
description: "Light product system built on #ffffff with #42b883 as the primary CTA accent. Type anchored in Inter var experimental at 76px / weight 900. Extracted automatically from https://vuejs.org/ — rendered styles via getComputedStyle() + CSS custom properties (token-only values may not be painted)."
narrative: |
  vuejs.org is built on a pure-white canvas (rgb(255, 255, 255)).
  The system uses rgb(66, 184, 131) as the accent for primary actions and brand signals.
  Generously rounded CTAs (40px) suggest approachable, content-first design alongside Inter var experimental as the primary typeface.
  Inter var experimental is paired with Inter var for secondary roles.
  A restrained elevation system (2 distinct shadows) — shadows reserved for the few elements that must lift off the page.
  Motion is a first-class concern — 5 keyframe animations plus transition-driven interactions.

colors:
  background: "#ffffff"
  surface-1: "#f1f1f1"
  surface-2: "#f9f9f9"
  ink: "#213547"
  ink-subtle: "#969faf"
  primary: "#42b883"
  on-primary: "#111111"
  primary-hover: "#476582"
  hairline: "rgba(60, 60, 60, 0.7)"
  primary-focus: "#101010"

typography:
  display-xl:
    fontFamily: "Inter var experimental, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif"
    fontSize: 76px
    fontWeight: 900
    lineHeight: 1.25
    letterSpacing: -1.5px
  headline:
    fontFamily: "Inter var experimental, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif"
    fontSize: 16px
    fontWeight: 500
    lineHeight: 1.5
    letterSpacing: 0.2px
  body:
    fontFamily: "Inter var experimental, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif"
    fontSize: 16px
    fontWeight: 400
    lineHeight: 1.5
    letterSpacing: 0.2px
  body-sm:
    fontFamily: "Inter var experimental, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif"
    fontSize: 14.4px
    fontWeight: 700
    lineHeight: 1.67
    letterSpacing: 0.2px
  button:
    fontFamily: "Inter var experimental, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif"
    fontSize: 14px
    fontWeight: 400
    lineHeight: 1.71
    letterSpacing: 0.2px

rounded:
  none: 0px
  xs: 4px
  sm: 8px
  md: 11px
  lg: 40px
  xl: 48px
  pill: 9999px

spacing:
  xxs: 2px
  xs: 8px
  sm: 10px
  md: 12px
  lg: 24px
  xl: 32px
  xxl: 96px

components:
  button-pill:
    backgroundColor: "transparent"
    textColor: "{colors.hairline}"
    typography: "{typography.headline}"
    rounded: "{rounded.lg}"
    padding: 0px 8px
  button-ghost:
    backgroundColor: "transparent"
    textColor: "{colors.ink}"
    typography: "{typography.headline}"
    rounded: "{rounded.none}"
    padding: 0px 12px
  button-pill-2:
    backgroundColor: "{colors.surface-1}"
    textColor: "{colors.ink}"
    typography: "{typography.headline}"
    rounded: "{rounded.md}"

extracted_at: "2026-06-11T06:20:27.899Z"
completeness: 59
scoreVersion: "v2"

---

# Design System — vuejs.org
> Extracted automatically by Prism from https://vuejs.org
> 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**: subtle  |  **Weight**: heavy  |  **Aesthetic**: product-neutral

| Dimension | Value | Signal |
|---|---|---|
| Canvas | neutral | `#ffffff` |
| Type posture | sans-led (Inter var experimental) | "The JavaScript Framework" |
| Color assertion | dual-accent | #42b883 |
| Whitespace | moderate | section rhythm 42px |
| Interaction | subtle | 5 keyframes, 19 transitions |
| Radius language | 11px-rounded | from token scale |

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

> **🤖 TL;DR for AI agents** (read this first — saves you scanning the full doc):
>
> - **Canvas**: `rgb(255, 255, 255)` is the page background. Every component composits against this.
> - **Accent**: `rgb(66, 184, 131)` for primary CTAs ONLY. Never decorative.
> - **Body type**: 16px (token: `typography.body`). Default for ALL text not in a heading role.
> - **Section rhythm**: 42px 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

vuejs.org uses a pure-white canvas (`#ffffff`), letting typography, color and imagery carry the visual weight. 

Typography is anchored in **Inter var experimental**. Headlines use weight 900 for confident, assertive presence — the brand wants to be heard. Negative letter-spacing at display sizes (-1.5px at 76px) compresses headlines into engineered blocks, dense and precise. 

Body text reads in Charcoal (`#213547`) — softened from pure black, a small but deliberate detail that lowers reading friction. **#42b883** (`#42b883`) is the single high-saturation color in the system — it earns its presence only on interactive elements, making CTAs and links the unmistakable focal points against the otherwise neutral palette. Elevation comes from a small, deliberate set of shadows (2 distinct), each a multi-layer stack — several blurred layers at varying offsets — used sparingly rather than across the whole UI. 


**Key Characteristics:**
- Background: Pure White (`#ffffff`)
- Primary typeface: Inter
- Primary text: Charcoal (`#213547`)
- Accent: #42b883 (`#42b883`)
- Display: 76px weight 900, letter-spacing -1.5px
- Shadow system: 2 distinct elevation levels
- Custom fonts loaded: Inter, Inter4CJK

## 2. Color Palette & Roles

### Background & Surface
- **Pure White** (`#ffffff`): Page background (primary)
- **Off-White** (`#f1f1f1`): Surface / elevated background
- **Off-White** (`#f9f9f9`): Surface / elevated background

### Text & Content
- **Charcoal** (`#213547`): Primary body text
- **Pure Black** (`#000000`): Secondary text
- **Translucent Dark Gray (70%)** (`rgba(60, 60, 60, 0.7)`): Secondary text

### Accent & Interactive
- **Branding** (`#42d392`): Accent / interactive (CSS var)
- **Branding Dark** (`#89ddff`): Accent / interactive (CSS var)
- **#42b883** (`#42b883`): Interactive / accent
- **Slate** (`#35495e`): Interactive / accent
- **Slate** (`#476582`): Interactive / accent

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

- `#aac8e4` — Sage *(token)*
- `#242424` — Near-Black *(token)*
- `#636363` — Slate Grey *(token)*
- `#ffff17` — #ffff17 *(token)*
- `#aeaeae` — Grey *(token)*
- `#e5e5e5` — Whitesmoke *(token)*
- `#3a3a3a` — Charcoal *(token)*
- `#33a06f` — Teal *(token)*
- `#202020` — Near-Black *(token)*
- `#50a2ff` — Cornflower Blue *(token)*
- `#555a64` — Slate *(token)*
- `#fd1d7c` — Ruby *(token)*
- `#823c83` — #823c83 *(token)*
- `#2f2f2f` — Charcoal *(token)*
- `#cdcde6` — Light Blue *(token)*
- `#1a1a1a` — Near-Black *(token)*
- `#602960` — #602960 *(token)*
- `#d4d9e1` — #d4d9e1 *(token)*
- `#e0e3e8` — Whitesmoke *(token)*
- `#ffc517` — Amber *(token)*
- `#5468ff` — Brand Indigo *(token)*
- `#ebedf0` — Whitesmoke *(token)*
- `#d1d1d1` — Light Grey *(token)*
- `#444950` — Dark Gray *(token)*
- `#f5f6f7` — Off-White *(token)*
- `#e0ad15` — #e0ad15 *(token)*
- `#3b8eed` — Ring Blue *(token)*
- `#484848` — Charcoal *(token)*
- `#f43771` — Warm Rose *(token)*
- `#3468a3` — #3468a3 *(token)*
- `#e936eb` — #e936eb *(token)*
- `#ab2131` — #ab2131 *(token)*
- *…+27 more in `raw-css.json` (`desktop.allColors`).*

### Gradients & Decorative Fills

- `linear-gradient(-225deg,#d5dbe4,#f8f8f8)` — (--docsearch-key-gradient)

### CSS Custom Properties (Design Tokens)

**Shadow Token**
- `--vt-shadow-5`: `0 18px 56px #00000029, 0 4px 12px #00000029`
- `--vt-shadow-1`: `0 1px 2px #0000000a, 0 1px 2px #0000000f`
- `--vt-shadow-3`: `0 12px 32px #0000001a, 0 2px 6px #00000014`
- `--vt-shadow-4`: `0 14px 44px #0000001f, 0 3px 9px #0000001f`

**Spacing Token**
- `--docsearch-spacing`: `12px`

**Z-Index Token**
- `--vp-z-index-banner`: `30`
- `--vp-z-index-sidebar`: `50`
- `--vp-z-index-nav`: `20`
- `--vp-z-index-local-nav`: `10`

**Primary Brand Color**
- `--color-branding`: `#42d392`
- `--color-branding-dark`: `#89ddff`

**Other tokens**
- `--vt-c-text-2`: `#3c3c3cb3`
- `--vt-c-text-inverse-3`: `#ebebeb61`
- `--vt-c-text-dark-3`: `#ebebeb61`
- `--vt-c-text-light-1`: `#213547`
- `--vp-code-tab-hover-text-color`: `#ffffffde`
- `--vt-c-text-1`: `#213547`
- `--vt-c-text-dark-4`: `#ebebeb2e`
- `--vt-c-text-light-code`: `#476582`

## 3. Typography Rules

### Font Families
- **Primary**: `Inter var experimental`
- **Secondary**: `Inter`
- **Font 3**: `Inter4CJK`

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

### Typography Hierarchy

| Role | Font | Size | Weight | Line Height | Letter Spacing | Notes |
|------|------|------|--------|-------------|----------------|-------|
| Display Hero | Inter var experimental | 76px | 900 | 1.25 | -1.5px | Main headline (h1) |
| Label Heading | Inter var experimental | 16px | 500 | 1.5 | 0.2px | Small heading (H4) |
| Body | Inter var experimental | 16px | 400 | 1.5 | 0.2px | Standard reading text |
| Link | Inter var experimental | 14.4px | 700 | 1.67 | 0.2px | Link (14.4px) — Decoration: none |
| Button | Inter var experimental | 14px | 400 | 1.71 | 0.2px | Button label (14px) |
| Link | Inter var experimental | 13px | 400 | 2.15 | 0.2px | Link (13px) — Decoration: none |
| Link | Inter var experimental | 13px | 500 | 4.15 | 0.2px | Link (13px) — Decoration: none |

### Full Font Size Scale

Sizes detected in the design (descending): `76px`, `22px`, `20px`, `16px`, `15px`, `14.40px`, `14px`, `13px`, `12px`, `11px`, `10px`

> 6 size(s) detected outside the sampled hierarchy (22px, 20px, 15px, 12px, 11px, 10px). 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

**Pill**
- Background: `transparent`
- Text: `rgba(60, 60, 60, 0.7)` `{colors.hairline}`
- Padding: 0px 8px
- Radius: 40px
- Font: 16px weight 500
- Use: Status pills, tags, chips
- Hover: color: `#213547`, border: `0px none rgb(33, 53, 71)`, borderColor: `#213547`
- Focus: color: `rgb(33, 53, 71)`, border: `0px none rgb(33, 53, 71)`, borderColor: `rgb(33, 53, 71)`

**Ghost**
- Background: `transparent`
- Text: `#213547` `{colors.ink}`
- Padding: 0px 12px
- Radius: 0px
- Font: 16px weight 400
- Use: Subtle action, toolbar, nav button
- Hover: color: `#213547`, border: `0px none rgb(33, 53, 71)`, borderColor: `#213547`
- Focus: color: `rgb(33, 53, 71)`, border: `0px none rgb(33, 53, 71)`, borderColor: `rgb(33, 53, 71)`

**Pill**
- Background: `#f1f1f1` `{colors.surface-1}`
- Text: `#213547` `{colors.ink}`
- Padding: 0px
- Radius: 11px
- Border: 1px solid rgba(60, 60, 60, 0.29)
- Font: 16px weight 400
- Use: Status pills, tags, chips
- Hover: color: `#213547`, border: `0px none rgb(33, 53, 71)`, borderColor: `#213547`
- Focus: color: `rgb(33, 53, 71)`, border: `0px none rgb(33, 53, 71)`, borderColor: `rgb(33, 53, 71)`

**Light / Invert**
- Background: `#ffffff` `{colors.background}`
- Text: `#42b883` `{colors.primary}`
- Padding: 10.4px 24px
- Radius: 8px
- Shadow: `rgba(0, 0, 0, 0.1) 0px 12px 32px 0px, rgba(0, 0, 0, 0.08) 0px 2px 6px 0px`
- Font: 14.4px weight 700
- Use: Bright CTA on dark sections
- Hover: color: `#213547`, border: `0px none rgb(33, 53, 71)`, borderColor: `#213547`
- Focus: color: `rgb(33, 53, 71)`, border: `0px none rgb(33, 53, 71)`, borderColor: `rgb(33, 53, 71)`


## 4b. Component Behaviors (State Matrix)

### Interaction State Narrative

- **Button**:
  - **hover:** text rgba(60, 60, 60, 0.7) → #213547, border changes
  - **focus:** text rgba(60, 60, 60, 0.7) → #213547, border changes

*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: "rgba(60, 60, 60, 0.7)"
    hover:
      bg: "transparent"
      fg: "rgb(33, 53, 71)"
    focus:
      bg: "transparent"
      fg: "rgb(33, 53, 71)"
  link:
    default:
      bg: "rgb(255, 255, 255)"
      fg: "rgb(66, 184, 131)"
      shadow: "rgba(0, 0, 0, 0.1) 0px 12px 32px 0px, rgba(0, 0, 0, 0.08) 0p"
  navLink:
    default:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(33, 53, 71)"
  badge:
    default:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(33, 53, 71)"
```

**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
- **3 shape(s)** in this system: `Pill`, `Ghost`, `Light / Invert`
- **DO NOT introduce new buttons variants** without justification

## 5. Layout Principles

### Layout Type
**top-nav + content**

### Grid
Single column, centered content

### Max Width
1376px

### Spacing System
Compact spacing — information density prioritized

| Token | Value |
|-------|-------|
| xxs | 2px |
| xs | 8px |
| sm | 10px |
| md | 12px |
| base | 15px |
| lg | 24px |
| xl | 32px |
| 2xl | 42px |
| 3xl | 96px |

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

### Shape Language

| Component | Border Radius |
|-----------|---------------|
| Buttons | `40px` |
| Page Body | `0px` |
| Navigation | `0px` |

**Shape Personality**: Generously Rounded — Soft, friendly corners (8px+). Approachable, consumer-facing feel.

**Full Radius Spectrum**: 0px, 2px, 3px, 4px, 8px, 11px, 40px (from `allBorderRadii` scan)


## 5b. Spacing Rhythm Names

**Measured section padding**: bands use ~42px internal vertical padding (up to 96px) — **standard**. (Distinct from the gap *between* sections above.) Reproduce this generous vertical breathing room; cramped spacing is the #1 tell of a cheap clone.

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

| Name | Value | Use case |
|------|-------|----------|
| **hero** | `96px` | Top/bottom of full-bleed hero sections |
| **section** | `32px` | Between major bands (color change, content shift) |
| **subsection** | `24px` | Within a section, between content groups |
| **card** | `12px` | Card padding, list-item spacing |
| **compact** | `10px` | Form fields, tight clusters, badge padding |
| **micro** | `8px` | 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).

**4/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:** 523px tall (not full-viewport)
- **Heading:** "The ProgressiveJavaScript Framework" — 76px center-aligned
- **Subheading:** "An approachable, performant and versatile framework for building web user interfaces."
- **CTAs:** 4 (primary: "Play icon Why Vue")
- **Clone instruction:** Reproduce the **centered** layout. Use the heading font-size token at the documented size. Pair the centered text with the hero’s decorative visual (gradient / SVG / hero image — see §9b), not bare text.

### Navigation Pattern

- **Position:** static (scrolls with page)
- **Layout:** unknown — Layout not classified
- **Height:** 55px
- **Logo:** ✓ present
- **Nav links:** 1 primary items
- **CTAs in nav:** 0 (no buttons — links only)
- **Clone instruction:** Build a static unknown navigation. Link-only — no button styling needed.

### Card Grid Pattern

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

### Footer Pattern

- **Columns:** 1
- **Links:** 1 total
- **Height:** 88px
- **Includes:** ✗ no newsletter | ✗ no social |  ✓ copyright
- **Clone instruction:** Build a 1-column footer with ~1 links per column, and a copyright line.

## 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 12px 32px 0px`,<br>`rgba(0, 0, 0, 0.08) 0px 2px 6px 0px` | Cards, elevated surfaces |
| Layered (Level 2) | <br>`rgba(0, 0, 0, 0.04) 0px 1px 2px 0px`,<br>`rgba(0, 0, 0, 0.06) 0px 1px 2px 0px` | 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

### Duration Scale

| Value | Tier | Typical Use |
|-------|------|-------------|
| `200ms` | Normal | Panel open/close, navigation |
| `250ms` | Normal | Panel open/close, navigation |
| `500ms` | Slow | Hero animations, page transitions |

### Copy-Paste Transition Snippets

**Color / Background**
```css
transition: color 0.5s, background-color 0.5s;
```

**Background**
```css
transition: background-color 0.5s;
```

**Border**
```css
transition: border-color 0.5s, background-color 0.5s;
```

**Opacity**
```css
transition: opacity 0.25s;
```

### Keyframe Animation Catalog

| Animation Name | Type | Animated Props | Use Hint |
|----------------|------|----------------|----------|
| `fade-in` | Fade | opacity | Element entrance |
| `lds-ring` | Rotate / Spin | transform | UI transition |
| `bounce-in` | Scale | transform | Playful feedback |
| `shake` | Slide | transform | Error feedback |
| `blink` | Color Pulse | background-color | Attention / status |

### Motion Fingerprint

- **Speed Character**: Balanced Pacing (median duration: `250ms`)
- **Dominant Easing**: standard CSS easings
- **Animation Library**: 5 unique animations (5 total including variants)

> This design moves with balanced pacing timing using standard CSS easings, creating a UI that feels natural and fluid.

## 8. Do's and Don'ts

### Do
- Use Charcoal (`#213547`) for text — not pure black, it's warmer and more readable
- Use Inter var experimental as the primary typeface — it defines the brand personality
- Use negative letter-spacing (-1.5px) at display sizes for compressed, editorial headlines
- Use the extracted shadow patterns for elevation — they are tuned to match the brand palette
- Use #42b883 (`#42b883`) as the primary accent — it's the brand's signature interactive color
- Use 40px border-radius on primary buttons — the brand uses generously-rounded CTAs
- Maintain nav height at 55px — consistent vertical space for the navigation bar
- Include exactly 4 CTAs in the hero (primary + secondary) — this design pattern is multi-action, not single-purpose
- Each card includes a top image — imagery is part of the card identity, not optional
- Use a 5-column grid on desktop — density matters for this content type

### Don't
- 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 increase letter-spacing on headings — the type is designed to run tight at scale
- 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 use sharp-cornered or pill buttons — 40px is the CTA border-radius standard
- Don't collapse or hide the nav on scroll without an explicit scroll-triggered animation — the design uses fixed nav presence
- Don't make the nav sticky — this design lets it scroll away to maximize content focus
- Don't put a CTA button in the nav — this design uses links only at the top
- Don't over-build the footer — this design keeps it minimal (1 cols, 1 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(255, 255, 255)` as the base canvas"
    why: "Every component is designed to composit against this exact tone"
    test: "document.body.style.backgroundColor === 'rgb(255, 255, 255)'"
  - id: brand-accent-001
    type: do
    rule: "Reserve `rgb(66, 184, 131)` for primary CTAs and brand-mark signals only"
    why: "Single chromatic assertion device — overuse dilutes meaning"
    test: "querySelectorAll('[style*=\"rgb(66, 184, 131)\"]').length <= 3 per fold"
```

## 9. Responsive Behavior

### Breakpoints
| Name | Width | Key Changes |
|------|-------|-------------|
| Mobile | 370px | Single column, compact spacing |
| Mobile | 463px | Single column, compact spacing |
| Mobile Large | 639px | Expanded mobile layout |
| Mobile Large | 720px | Expanded mobile layout |
| Tablet | 768px | Multi-column grids begin |
| Tablet | 1024px | Multi-column grids begin |
| Desktop | 1280px | Full feature layout |
| Large Desktop | 1439px | Maximum content width |

### Token Diff — Desktop vs Mobile

| Element | Property | Desktop | Mobile |
|---------|----------|---------|--------|
| heading | font-size | `76px` | `48px` |
| heading | line-height | `95px` | `60px` |
| heading | letter-spacing | `-1.5px` | `-0.5px` |
| nav | display | `flex` | `none` |
| nav | height | `55px` | `auto` |
| button | width | `141px` | `48px` |

### Collapsing Strategy
- Headlines: 76px → 48px on mobile
- Navigation: flex → none on mobile
- Cards: multi-column → stacked vertical on mobile
- Footer: multi-column → stacked single column on mobile

### Touch Targets
- Buttons: 0px 8px 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: 5-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.*

- **Clip-path shapes** — 8 non-rectangular cut(s).

> **Motion fingerprint**: non-rectangular shapes (9)

## 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://vuejs.org/images/logo.png
  *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: 3.89:1 (ultra-wide cinematic)
- Rendered size: 210×54px
- Alt text: "Vue.js Amsterdam"
- *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): 4 (13%)
- Portrait (<0.87): 0 (0%)
- Square (0.87–1.15): 20 (65%)
- Ultra-wide (>2.3): 7 (23%)

**Media Format Mix:**
- PNG: 29 (logos, transparent UI elements, mockups)
- SVG: 2 (icons, illustrations, decorative geometry)

**Average rendered image size:** 102×68px
**Above-fold image count:** 0 / 31

**Decorative Patterns Detected:**
- 1 multi-stop linear gradient (mesh-like, 3+ color stops) — the brand leans on rich color transitions for visual depth

**Clone instruction for decorative work:** Decorative details are subtle — don't over-style; the design relies on restraint.

**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: Pure White (`#ffffff`)
- Primary text: Charcoal (`#213547`)
- Accent: #42b883 (`#42b883`)
- Border: Translucent Dark Gray (70%) (`rgba(60, 60, 60, 0.7)`)
- Font: Inter var experimental
- Body: 16px weight 400

### Example Component Prompts
- "Create a hero section on Pure White background (#ffffff). Headline at 76px Inter var experimental weight 900, line-height 1.25, letter-spacing -1.5px, color #213547."
- "Create the primary CTA button: `#42b883` background, `rgba(60, 60, 60, 0.7)` text, 40px border-radius, 0px 8px padding, 500 weight, Inter var experimental font."
- "Build navigation: static on `#ffffff`. Inter var experimental 16px weight 400 for links."

### Iteration Guide
1. **Canvas**: Set the light canvas to Pure White (`#ffffff`) — every component is composited against this exact base.
2. **Typography**: All type in Inter var experimental, weight range 400–900. Never exceed 900 — heavier weights break the brand's tonal restraint.
3. **Accent**: #42b883 (`#42b883`) — one accent, applied consistently to CTAs, active states, and links. Never introduce a second saturated color.
4. **Shape**: CTAs at `40px`. Apply border-radius from the extracted scale only — don't invent intermediate values.
5. **Spacing**: Use the `--ca-space-*` token scale (8px–32px). All padding, margin, and gap values are multiples from this scale — no magic numbers.
6. **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: #ffffff;
  --ca-surface-1: #f1f1f1;
  --ca-surface-2: #f9f9f9;
  --ca-ink: #213547;
  --ca-ink-subtle: #969faf;
  --ca-primary: #42b883;
  --ca-on-primary: #111111;
  --ca-primary-hover: #476582;
  --ca-hairline: #3c3c3c;
  --ca-primary-focus: #101010;
}

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

/* Spacing & Radius */
:root {
  --ca-space-xxs: 2px;
  --ca-space-xs: 8px;
  --ca-space-sm: 10px;
  --ca-space-md: 12px;
  --ca-space-base: 15px;
  --ca-space-lg: 24px;
  --ca-space-xl: 32px;
  --ca-space-2xl: 42px;
  --ca-space-3xl: 96px;
  --ca-radius-none: 0px;
  --ca-radius-xs: 4px;
  --ca-radius-sm: 8px;
  --ca-radius-md: 11px;
  --ca-radius-lg: 40px;
  --ca-radius-xl: 48px;
  --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: hero
    tag: div
    height: 3055px
    width: full-bleed
    layout: block
    children: 1
  - section: hero
    tag: section
    height: 523px
    width: full-bleed
    layout: block
    children: 4
    vertical-padding: ~96px (airy)
    padding: "96px 32px"
  - section: feature-section
    tag: main
    height: 2912px
    width: full-bleed
    layout: block
    children: 1
  - section: content-section
    tag: section
    height: 275px
    width: 960px
    layout: flex-row justify=space-between
    children: 3
    vertical-padding: ~42px
    padding: "42px 32px"
  - section: section
    tag: section
    height: 1444px
    width: 900px
    layout: block
    children: 4
    vertical-padding: ~42px
    padding: "42px 32px"
  - section: gallery-grid
    tag: div
    classes: ["spsr-container", "platinum", "landing"]
    height: 472px
    width: 836px
    layout: grid: 3-col gap=normal 4px
    children: 12
  - section: gallery-grid
    tag: div
    classes: ["spsr-container", "gold", "landing"]
    height: 704px
    width: 836px
    layout: grid: 4-col gap=normal 4px
    children: 30
  - section: content-section
    tag: section
    height: 620px
    width: full-bleed
    layout: block
    children: 1
    bg: "rgb(249, 249, 249)"
    vertical-padding: ~42px
    padding: "42px 32px"
  - section: content-section
    tag: div
    classes: ["container"]
    height: 536px
    width: 900px
    layout: block
    children: 8
    vertical-padding: ~24px
    padding: "24px 32px"
  - section: footer
    tag: div
    classes: ["VPFooter"]
    height: 88px
    width: full-bleed
    layout: block
    children: 2
    bg: "rgb(249, 249, 249)"
    vertical-padding: ~24px
    padding: "23px 24px 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:
    - "Approachable"
  ctas:
    - "Search Ctrl K"
    - "Docs"
  navigation:
    - "Vue.js"
    - "github"
    - "twitter"
    - "discord"
    - "Playground"
```

**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: 6
    avg-ratio: 3.13
    common-aspect: "~16:6 banner"
    sample-alts:
      - "Laravel"
      - "Fenêtre Online Solutions"
      - "Fathom Analytics"
  thumbnail:
    count: 20
    avg-ratio: 1.00
    common-aspect: "~1:1 square"
    sample-alts:
      - "Chrome Frameworks Fund"
      - "Quickbooks Tool Hub"
      - "Crisp"
```

**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">
  Search
Ctrl
K
</button>
```
_Source pattern detected: padding `0px 8px` · radius `40px` · weight `500`_

**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** 2 · **cta** 1 · **docs** 5 · **project** 37 · **social** 3 · **footer** 4 · **other** 8

**Primary actions (conversion path):**
- Primary call-to-action — "Get Started" (the conversion path) → `https://vuejs.org/guide/introduction`

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


---
## Extraction Completeness: 59/100 (D)

| Category | Score | Max | Detail |
|----------|-------|-----|--------|
| Colors & Palette | 15 | 25 | 11 named colors |
| Typography | 18 | 20 | 7 roles defined |
| Components | 4 | 20 | 1 specs extracted |
| Motion & Interaction | 10 | 15 | Keyframes |
| CSS Custom Properties | 8 | 10 | 153 vars |
| Responsive Breakpoints | 5 | 5 | 8 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, Inter4CJK)** — 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 |
|----------|----------------|-------------------|
| **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 | 153 CSS vars (semantic naming requires ≥20 for high) |
| §3 Typography | High | 7 typography roles inferred |
| §4 Components | Low | 1 component variants captured |
| §7 Motion | High | Keyframes + transitions |
| §8 Do's/Don'ts | High | 20 rules generated; design-decisions.json has evidence per rule |
| §9 Responsive | High | 8 breakpoints detected |
| §9b Photography | High | 31 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

3 font file(s) captured (223KB total). When running `prism add`, fonts are saved to `extractions/vuejs.org/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';
  /* src: url('/fonts/Inter.woff2') format('woff2'); */
  font-weight: 100 900;
  font-style: italic;
  font-display: swap;
}
@font-face {
  font-family: 'Inter4CJK';
  /* src: url('/fonts/Inter4CJK.woff2') format('woff2'); */
  font-weight: 100 900;
  font-style: normal;
  font-display: swap;
}
@font-face {
  font-family: 'Inter4CJK';
  /* src: url('/fonts/Inter4CJK.woff2') format('woff2'); */
  font-weight: 100 900;
  font-style: italic;
  font-display: swap;
}
```

### Keyframe Animations (Intercepted from CSS)

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

```
@keyframes fade-in { ... }
@keyframes lds-ring { ... }
@keyframes bounce-in { ... }
@keyframes shake { ... }
@keyframes blink { ... }
```

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

```css
@keyframes fade-in{0%{opacity:0}
@keyframes lds-ring{0%{transform:rotate(0)}
@keyframes bounce-in{0%{transform:scale(0)}50%{transform:scale(1.25)}
@keyframes shake{10%,90%{transform:translate(-1px)}20%,80%{transform:translate(2px)}30%,50%,70%{transform:translate(-4px)}40%,60%{transform:translate(4px)}}
@keyframes blink{0%{}50%{background-color:#0000}
```
</details>

### Hover State CSS (Intercepted)

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

```css
.vt-doc h1:hover .header-anchor,.vt-doc h1 .header-anchor:focus,.vt-doc h2:hover .header-anchor,.vt-doc h2 .header-anchor:focus,.vt-doc h3:hover .header-anchor,.vt-doc h3 .header-anchor:focus,.vt-doc h4:hover .header-anchor,.vt-doc h4 .header-anchor:focus,.vt-doc h5:hover .header-anchor,.vt-doc h5 .header-anchor:focus,.vt-doc h6:hover .header-anchor,.vt-doc h6 .header-anchor:focus{opacity:1}

.vt-doc a:hover{color:var(--vt-c-brand-highlight)}

.vt-doc [class*=language-]:hover>button.copy,.vt-doc [class*=language-]>button.copy:focus{opacity:1}

.vt-doc [class*=language-]>button.copy:hover,.vt-doc [class*=language-]>button.copy.copied,.vt-doc [class*=language-]>button.copy:hover.copied,.vt-doc [class*=language-]>button.copy.copied:before,.vt-doc [class*=language-]>button.copy:hover.copied:before{background-color:#343848}

.dark .vt-doc [class*=language-]>button.copy:hover,.dark .vt-doc [class*=language-]>button.copy.copied,.dark .vt-doc [class*=language-]>button.copy:hover.copied,.dark .vt-doc [class*=language-]>button.copy.copied:before,.dark .vt-doc [class*=language-]>button.copy:hover.copied:before{background-color:#2f2f2f}

.vt-doc [class*=language-]>button.copy.copied,.vt-doc [class*=language-]>button.copy:hover.copied{background-image:url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' height='20' width='20' stroke='rgba(128,128,128,1)' stroke-width='2' viewBox='0 0 24 24'%3E%3Cpath stroke-linecap='round' stroke-linejoin='round' d='M9 5H7a2 2 0 0 0-2 2v12a2 2 0 0 0 2 2h10a2 2 0 0 0 2-2V7a2 2 0 0 0-2-2h-2M9 5a2 2 0 0 0 2 2h2a2 2 0 0 0 2-2M9 5a2 2 0 0 1 2-2h2a2 2 0 0 1 2 2m-6 9 2 2 4-4'/%3E%3C/svg%3E");border-radius:0 4px 4px 0}

.vt-doc [class*=language-]>button.copy.copied:before,.vt-doc [class*=language-]>button.copy:hover.copied:before{text-align:center;width:64px;height:40px;color:var(--vt-c-text-dark-2);white-space:nowrap;content:"Copied";border-radius:4px 0 0 4px;padding-top:10px;font-size:12px;font-weight:500;display:block;position:relative;left:-65px}

.vt-doc [class*=language-]:hover>button.copy+span.lang,.vt-doc [class*=language-]>button.copy:focus+span.lang{opacity:0}

.vt-flyout:hover{color:var(--vt-c-bland);transition:color .25s}

.vt-flyout:hover .vt-flyout-button-text{color:var(--vt-c-text-2)}

.vt-flyout:hover .vt-flyout-button-icon{fill:var(--vt-c-text-2)}

.vt-flyout:hover .vt-flyout-menu,.vt-flyout-button[aria-expanded=true]+.vt-flyout-menu{opacity:1;visibility:visible;transform:translateY(0)}

.vt-hamburger:hover .vt-hamburger-top{top:0;left:0;transform:translate(4px)}

.vt-hamburger:hover .vt-hamburger-middle{top:6px;left:0;transform:translate(0)}

.vt-hamburger:hover .vt-hamburger-bottom{top:12px;left:0;transform:translate(8px)}

.vt-hamburger.is-active:hover .vt-hamburger-top,.vt-hamburger.is-active:hover .vt-hamburger-middle,.vt-hamburger.is-active:hover .vt-hamburger-bottom{background-color:var(--vt-c-text-2);transition:top .25s,background-color .25s,transform .25s}

.vt-menu-link:hover{color:var(--vt-c-brand)}

.vt-locales-menu-item-text:hover{color:var(--vt-c-brand)}

.vt-social-link:hover{color:var(--vt-c-text-1);transition:color .25s}

.vt-switch:hover{border-color:var(--vt-c-gray)}
```

> **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 795 rendered nodes** — not a sample. These are the values the page *actually paints*, weighted by how often they appear.

### Real Responsive Breakpoints
**19 breakpoints** read from the live `@media` rules (not guessed) — 14 most relevant:
`370px` · `463px` · `480px` · `512px` · `576px` · `639px` · `640px` · `720px` · `721px` · `768px` · `794px` · `959px` · `960px` · `1024px` … (+5 more)

### Measured Design Scale
**Type scale by usage** (× = paint count): `16px`×344 · `13px`×149 · `14.4px`×128 · `14px`×123 · `12px`×12 · `10px`×10 · `20px`×10 · `76px`×6

**Radius scale** (× = paint count): `2px`×44 · `8px`×18 · `3px`×4 · `50%`×2 · `40px`×1 · `4px`×1 · `11px`×1

**Weights** (× = paint count): `400`×692 · `500`×70 · `600`×24 · `900`×6 · `700`×2

**Layout gaps** (× = paint count): `normal 4px`×2 · `2px`×1

**Elevation (real shadows)**:
```css
rgba(0, 0, 0, 0.1) 0px 12px 32px 0px, rgba(0, 0, 0, 0.08) 0px 2px 6px 0px
rgba(0, 0, 0, 0.04) 0px 1px 2px 0px, rgba(0, 0, 0, 0.06) 0px 1px 2px 0px
```

### 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 { font-family:var(--vt-font-family-base); color:var(--vt-c-text-1); background-color:var(--vt-c-bg); font-size:16px; font-weight:400; transition:color .5s,background-color .5s }
h1 { font-size:2em }
h1 { font-size:76px; font-weight:900 }
h2 { color:var(--vt-c-text-1); font-size:20px; font-weight:600; transition:color .5s }
button { font-family:inherit; font-size:100% }
button { background:var(--docsearch-searchbox-background); color:var(--docsearch-muted-color); border-radius:40px; font-weight:500 }
button { background:0 0; background-color:initial }
a { color:var(--vt-c-green); box-shadow:var(--vt-shadow-3); background-color:var(--vt-c-bg); border-radius:8px; font-size:.9em; font-weight:700 }
```

> 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://vuejs.org | 2026-06-11T06:20:27.944Z*
*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.*