--- version: alpha name: vitejs.dev description: "Dark-canvas product system built on #16171d with #ffffff as the single brand accent. Type anchored in APK Protocol at 60px / weight 500. Extracted automatically from https://vitejs.dev/ — rendered styles via getComputedStyle() + CSS custom properties (token-only values may not be painted)." narrative: | vitejs.dev is built on a near-black canvas (rgb(22, 23, 29)). The system uses rgb(255, 255, 255) as the singular interactive color. Sharp 0px corners on CTAs — architectural restraint, engineering precision alongside APK Protocol as the primary typeface. APK Protocol is paired with KH Teka Mono 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 — 8 keyframe animations plus transition-driven interactions. colors: canvas: "#16171d" surface-2: "#08060d" ink: "#ffffff" ink-muted: "#98989f" ink-subtle: "#808080" primary: "#ffffff" on-primary: "#111111" primary-hover: "#414853" hairline: "#6a6a71" primary-focus: "#b39aff" semantic-error: "#ef5350" semantic-success: "#3dd68c" semantic-warning: "#f9b44e" typography: display-xl: fontFamily: "APK Protocol, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif" fontSize: 60px fontWeight: 500 lineHeight: 1.12 letterSpacing: -3px display-md: fontFamily: "APK Protocol, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif" fontSize: 40px fontWeight: 500 lineHeight: 1.33 letterSpacing: -1px headline: fontFamily: "APK Protocol, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif" fontSize: 24px fontWeight: 500 lineHeight: 1.17 letterSpacing: 0 body: fontFamily: "Inter, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif" fontSize: 14px fontWeight: 400 lineHeight: 1 letterSpacing: 0 body-sm: fontFamily: "APK Protocol, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif" fontSize: 16px fontWeight: 400 lineHeight: 1.5 letterSpacing: 0 button: fontFamily: "Inter, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif" fontSize: 16px fontWeight: 500 lineHeight: 1.4 letterSpacing: 0 rounded: none: 0px xs: 4px sm: 8px md: 14px lg: 20px xl: 32px pill: 9999px spacing: xxs: 2px xs: 8px sm: 20px md: 24px lg: 40px xl: 60px xxl: 96px components: button-icon-button: backgroundColor: "transparent" textColor: "{colors.primary}" typography: "{typography.button}" rounded: "{rounded.none}" padding: 8px button-ghost: backgroundColor: "transparent" textColor: "{colors.primary}" typography: "{typography.button}" rounded: "{rounded.none}" padding: 8px 12px button-dark--solid: backgroundColor: "#14121a" textColor: "{colors.ink-muted}" typography: "{typography.body}" rounded: "{rounded.sm}" padding: 8px 12px card-standard-card: backgroundColor: "transparent" typography: "{typography.button}" rounded: "{rounded.sm}" padding: 40px 32px navigation-main-nav: backgroundColor: "{colors.canvas}" typography: "{typography.button}" rounded: "{rounded.none}" padding: 20px 24px testimonial-quote-card: backgroundColor: "transparent" textColor: "{colors.primary}" typography: "{typography.button}" rounded: "{rounded.sm}" padding: 40px 32px tab-pill-tab: backgroundColor: "#14121a" textColor: "{colors.primary}" typography: "{typography.button}" rounded: "{rounded.sm}" padding: 0px 12px code-block-inline-code--pre: backgroundColor: "transparent" textColor: "{colors.primary}" typography: "{typography.button}" rounded: "{rounded.none}" padding: 20px 0px extracted_at: "2026-06-11T06:20:36.904Z" completeness: 87 scoreVersion: "v2" --- # Design System — vitejs.dev > Extracted automatically by Prism from https://vitejs.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**: sparse  |  **Motion**: animated  |  **Weight**: light  |  **Aesthetic**: dark-premium | Dimension | Value | Signal | |---|---|---| | Canvas | dark | `#16171d` | | Type posture | sans-led (Inter) | "The Build Tool for the Web" | | Color assertion | dual-accent | #ffffff | | Whitespace | sparse | section rhythm 64px | | Interaction | animated | 8 keyframes, 10 transitions | | Radius language | 8px-rounded | from token scale | **Prism fingerprint**: `dark-canvas · sans-display · dual-accent · 8px-rounded · animated-motion` > **🤖 TL;DR for AI agents** (read this first — saves you scanning the full doc): > > - **Canvas**: `rgb(22, 23, 29)` is the page background. Every component composits against this. > - **Accent**: `rgb(255, 255, 255)` for primary CTAs ONLY. Never decorative. > - **Body type**: 16px (token: `typography.body`). Default for ALL text not in a heading role. > - **Section rhythm**: 64px between major bands. Card padding: 40px. > - **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 vitejs.dev commits fully to dark-mode as the native medium, not as a toggled alternative. The canvas is a dark surface (`#16171d`) where surfaces are layered through stepped luminance — each elevated level is slightly less dark than the one beneath it, creating depth without color shifts. Headlines are set in **APK Protocol**, a sans-serif display face (the dominant type signature, e.g. "The Build Tool for the Web" at 60px). Body text is set in **Inter**. Negative letter-spacing at display sizes (-3px at 60px) compresses headlines into engineered blocks, dense and authoritative. Body text reads in White (`#ffffff`). **White** (`#ffffff`) provides interactive distinction without visual aggression. 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. Motion design uses smooth easing curves for polished state transitions. **Key Characteristics:** - Background: Near-Black (`#16171d`) - Primary typeface: APK Protocol - Primary text: White (`#ffffff`) - Accent: White (`#ffffff`) - Display: 60px weight 500, letter-spacing -3px - Shadow system: 2 distinct elevation levels - Custom fonts loaded: APK Protocol, KH Teka Mono, Inter, Punctuation SC ## 2. Color Palette & Roles ### Background & Surface - **Primary** (`#16171d`): Page background (primary) - **Pure Black** (`#000000`): Surface / elevated background - **Pure Black** (`#08060d`): Surface / elevated background - **Nickel** (`#3b3440`): Surface / elevated background - **Slate** (`#14121a`): Surface / elevated background ### Text & Content - **White** (`#ffffff`): Primary body text - **Grey** (`#98989f`): Secondary text - **Grey** (`#867e8e`): Secondary text - **Light Grey** (`#cccccc`): Secondary text ### Accent & Interactive - **Brand** (`#b39aff`): Accent / interactive (CSS var) ### Border & Divider - **Stroke** (`#e5e4e7`): Border (CSS var) - **Charcoal** (`#2e2e32`): Borders / dividers ### Full Extracted Palette **13 colors rendered on the page** + **38** more declared in design tokens (CSS custom properties — not necessarily painted). (12 categorized above + 39 additional below.) Rendered values are read via `getComputedStyle()`; token values come from CSS variable declarations. Third-party logo colors are filtered out. - `#370a7f` — #370a7f - `#6a6a71` — Slate Grey - `#f9b44e` — #f9b44e *(token)* - `#32363f` — Charcoal *(token)* - `#3772cf` — Royal Blue *(token)* - `#3dd68c` — #3dd68c *(token)* - `#22ff73` — Zest *(token)* - `#5c73e7` — Brand Indigo *(token)* - `#a879e6` — #a879e6 *(token)* - `#140033` — Wine *(token)* - `#db2777` — Cherry *(token)* - `#f14158` — Warm Rose *(token)* - `#8e5cd9` — Amethyst *(token)* - `#808080` — Slate Grey *(token)* - `#bbd1ff` — Light Blue *(token)* - `#da8b17` — #da8b17 *(token)* - `#ef5350` — Vermillion *(token)* - `#6c3bff` — Electric *(token)* - `#a46a0a` — #a46a0a *(token)* - `#a8b1ff` — Lavender *(token)* - `#414853` — Dark Gray *(token)* - `#f66f81` — #f66f81 *(token)* - `#c8abfa` — Lavender *(token)* - `#298459` — Teal *(token)* - `#c37d0d` — Honey *(token)* - `#d45656` — Terracotta *(token)* - `#515c67` — Slate *(token)* - `#b62a3c` — #b62a3c *(token)* - `#e0e3e8` — Whitesmoke *(token)* - `#3c3f44` — Charcoal *(token)* - `#30a46c` — Teal *(token)* - `#1ba673` — Emerald *(token)* - *…+7 more in `raw-css.json` (`desktop.allColors`).* ### CSS Custom Properties (Design Tokens) **Shadow Token** - `--tw-inset-shadow-alpha`: `100%` - `--vp-shadow-5`: `0 18px 56px #00000029, 0 4px 12px #00000029` - `--tw-inset-ring-shadow`: `0 0 #0000` - `--tw-inset-shadow`: `0 0 #0000` **Font Family Token** - `--vp-font-family-mono`: `"KH Teka Mono", monospace` - `--vp-font-family-base`: `Inter, sans-serif` - `--default-font-family`: `Inter, sans-serif` - `--default-mono-font-family`: `"KH Teka Mono", monospace` **Spacing Token** - `--docsearch-spacing`: `12px` - `--spacing`: `.25rem` - `--tw-space-y-reverse`: `0` - `--color-space`: `#103` **Border Radius Token** - `--radius-sm`: `.25rem` - `--radius-md`: `.375rem` - `--radius-lg`: `.5rem` - `--docsearch-border-radius`: `4px` **Font Size Token** - `--vp-code-font-size`: `.875em` - `--twoslash-code-font-size`: `1em` - `--vp-custom-block-font-size`: `14px` - `--vp-custom-block-code-font-size`: `13px` **Motion Token** - `--default-transition-duration`: `.15s` - `--default-transition-timing-function`: `cubic-bezier(.4, 0, .2, 1)` **Z-Index Token** - `--vp-z-index-sidebar`: `25` - `--vp-z-index-backdrop`: `50` - `--vp-z-index-footer`: `10` - `--vp-z-index-nav`: `30` **Border** - `--color-stroke`: `#e5e4e7` **Font Weight Token** - `--font-weight-semibold`: `600` - `--font-weight-medium`: `500` **Primary Brand Color** - `--color-brand`: `#b39aff` - `--color-primary`: `#16171d` **Other tokens** - `--vp-local-nav-bg-color`: `#16171d` - `--vp-c-text-3`: `#6a6a71` - `--twoslash-tag-bg`: `#3772cf20` - `--docsearch-background-color`: `#14121a` - `--docsearch-sidepanel-hit-color`: `#fff` - `--vp-badge-info-bg`: `#65758529` - `--vp-code-line-number-color`: `#98989f` - `--twoslash-docs-color`: `#fff` ## 3. Typography Rules ### Font Families - **Primary**: `Inter` - **Secondary**: `APK Protocol` - **Font 3**: `KH Teka Mono` - **Font 4**: `Punctuation SC` ### Custom Fonts Loaded - **APK Protocol** weight 500 (normal) - **APK Protocol** weight 700 (normal) - **KH Teka Mono** weight 400 (normal) - **KH Teka Mono** weight 500 (normal) - **Inter** weight 100 900 (normal) - **Punctuation SC** weight 400 (normal) - **Punctuation SC** weight 500 (normal) - **Punctuation SC** weight 600 (normal) - **Punctuation SC** weight 700 (normal) ### Typography Hierarchy | Role | Font | Size | Weight | Line Height | Letter Spacing | Notes | |------|------|------|--------|-------------|----------------|-------| | Display Hero | APK Protocol | 60px | 500 | 1.12 | -3px | Main headline (h1) | | Sub-heading | APK Protocol | 40px | 500 | 1.33 | -1px | Third-level heading (h3) | | Label Heading | APK Protocol | 24px | 500 | 1.17 | normal | Small heading (H5) | | Label Heading | APK Protocol | 20px | 500 | 1.4 | normal | Small heading (H6) | | Card Title | Inter | 16px | 400 | 1.4 | normal | Card headings | | Button Large | Inter | 16px | 500 | 1.4 | normal | Button label (16px) | | Nav Link | APK Protocol | 16px | 400 | 1.5 | normal | Navigation anchor | | Button | Inter | 14px | 400 | 1 | normal | Button label (14px) | ### Font Weight Scale CSS custom properties define 2 explicit weight steps: - `--font-weight-medium`: `500` — Medium - `--font-weight-semibold`: `600` — SemiBold ### Full Font Size Scale Sizes detected in the design (descending): `60px`, `48px`, `40px`, `24px`, `20px`, `18px`, `16px`, `14px`, `13px`, `12px` > 4 size(s) detected outside the sampled hierarchy (48px, 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: `#ffffff` `{colors.primary}` - Padding: 8px - Radius: 0px - Font: 16px weight 400 - Use: Toolbar/UI icons - Focus: outline: `rgb(16, 16, 16) auto 4px` **Ghost** - Background: `transparent` - Text: `#ffffff` `{colors.primary}` - Padding: 8px 12px - Radius: 0px - Font: 16px weight 400 - Use: Subtle action, toolbar, nav button - Focus: outline: `rgb(16, 16, 16) auto 4px` **Dark / Solid** - Background: `#14121a` - Text: `#98989f` `{colors.ink-muted}` - Padding: 8px 12px - Radius: 8px - Font: 14px weight 400 - Use: Solid dark CTA - Focus: outline: `rgb(16, 16, 16) auto 4px` **Ghost** - Background: `transparent` - Text: `#ffffff` `{colors.primary}` - Padding: 8px 16px - Radius: 8px - Font: 16px weight 500 - Use: Subtle action, toolbar, nav button - Focus: outline: `rgb(16, 16, 16) auto 4px` **Icon Button** - Background: `#14121a` - Text: `#ffffff` `{colors.primary}` - Padding: 0px - Radius: 4px - Border: 1px solid rgb(46, 46, 50) - Font: 16px weight 400 - Use: Toolbar/UI icons - Focus: outline: `rgb(16, 16, 16) auto 4px` **Light / Invert** - Background: `#ffffff` `{colors.primary}` - Text: `#16171d` `{colors.canvas}` - Padding: 8px 16px - Radius: 8px - Font: 16px weight 500 - Use: Bright CTA on dark sections - Focus: outline: `rgb(16, 16, 16) auto 4px` ### Cards & Containers **Standard Card** - Background: `transparent` - Padding: 40px 32px - Radius: 8px - Use: Content containers, listing items ### Navigation **Main Nav** - Background: `#16171d` `{colors.canvas}` - Padding: 20px 24px - Radius: none - Font: 16px weight 400 - Use: Fixed/sticky flex nav — N/A items ### Testimonials **Quote Card** - Background: `transparent` - Text: `#ffffff` `{colors.primary}` - Padding: 40px 32px - Radius: 8px - Font: 16px weight 400 - Use: Customer quote with avatar + company attribution ### Tabs **Pill Tab** - Background: `#14121a` - Text: `#ffffff` `{colors.primary}` - Padding: 0px 12px - Radius: 8px 8px 0px 0px - Font: 16px weight 400 - Use: Navigation tabs, filter tabs ### Code Blocks **Inline Code / Pre** - Background: `transparent` - Text: `#ffffff` `{colors.primary}` - Padding: 20px 0px - Radius: 0px - Font: 16px weight 400 — "KH Teka Mono" - Use: Code samples, CLI commands, syntax highlighting blocks ## 4b. Component Behaviors (State Matrix) ### Interaction State Narrative - **FooterLink**: - **hover:** shadow added *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(255, 255, 255)" focus: bg: "transparent" fg: "inherit" link: default: bg: "rgba(0, 0, 0, 0)" fg: "rgb(255, 255, 255)" card: default: bg: "rgba(0, 0, 0, 0)" fg: "rgb(255, 255, 255)" navLink: default: bg: "rgba(0, 0, 0, 0)" fg: "rgb(255, 255, 255)" footerLink: default: bg: "rgb(255, 255, 255)" fg: "rgb(22, 23, 29)" hover: bg: "transparent" fg: "inherit" ``` **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`, `Dark / Solid`, `Light / Invert` - **DO NOT introduce new buttons variants** without justification ### Cards & Containers - **1 shape(s)** in this system: `Standard Card` - **DO NOT introduce new cards & containers variants** without justification ### Navigation - **1 shape(s)** in this system: `Main Nav` - **DO NOT introduce new navigation variants** without justification ### Testimonials - **1 shape(s)** in this system: `Quote Card` - **DO NOT introduce new testimonials variants** without justification ### Tabs - **1 shape(s)** in this system: `Pill Tab` - **DO NOT introduce new tabs 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 **top-nav + content** ### Grid Single column, centered content ### Max Width 1440px ### Spacing System Generous spacing — editorial breathing room | Token | Value | |-------|-------| | xxs | 2px | | xs | 8px | | sm | 20px | | md | 24px | | base | 32px | | lg | 40px | | xl | 60px | | 2xl | 64px | | 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 | 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 | `0px` | | Cards & Containers | `8px` | | Navigation | `none` | | Testimonials | `8px` | | Tabs | `8px 8px 0px 0px` | | Code Blocks | `0px` | | Page Body | `0px` | **Shape Personality**: Moderate Rounding — Medium corners (4–12px). Modern SaaS standard, neither sharp nor pill. **Full Radius Spectrum**: 0px, 4px, 6px, 8px (from `allBorderRadii` scan) ## 5b. Spacing Rhythm Names **Measured section padding**: bands use ~112px internal vertical padding (up to 120px) — **very airy / premium**. (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** | `60px` | Between major bands (color change, content shift) | | **subsection** | `40px` | Within a section, between content groups | | **card** | `24px` | Card padding, list-item spacing | | **compact** | `20px` | 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). **5/8 structural patterns detected.** ### Hero Pattern - **Composition:** left-aligned — - **Viewport coverage:** 337px tall (not full-viewport) - **Heading:** "The Build Tool for the Web" — 60px left-aligned - **Subheading:** "Vite is a blazing fast frontend build tool powering the next generation of web applications." - **CTAs:** 2 (primary: "Get Started") - **Clone instruction:** Reproduce the **left-aligned** 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:** 40px - **Logo:** ✗ absent - **Nav links:** 3 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:** 4 cards detected - **Columns (desktop):** 2-up grid - **Card dimensions:** 719×554px (aspect 1.3:1) - **Gap:** 0px between cards - **Content:** ✓ image - **Image position:** top - **Clone instruction:** Build a 2-column grid (desktop) with cards at ~1.3:1 aspect ratio. Each card has an image at the top. ### Testimonial Pattern - **Count:** 9 testimonial blocks - **Layout:** grid - **Avg quote length:** 126 chars (medium quote) - **Includes:** ✓ avatars | ✗ no logos | ✗ no ratings - **Clone instruction:** Build a grid of 9 testimonials. Each includes an avatar. ### Footer Pattern - **Columns:** 1 - **Links:** 18 total - **Height:** 1044px - **Includes:** ✗ no newsletter | ✓ social icons | ✓ copyright - **Clone instruction:** Build a 1-column footer with ~18 links per column, social media links, and a copyright line. ## 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 10px 15px -3px`,
`rgba(0, 0, 0, 0.1) 0px 4px 6px -4px` | Cards, elevated surfaces | | Inset (Level 2) |
`rgb(0, 0, 0) 0px -1px 0px 0px inset` | Buttons, pressed-state elements | **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 | | `--ease-out` | `cubic-bezier(0, 0, .2, 1)` | Ease Out — Decelerating | | `--ease-smooth` | `cubic-bezier(.25,.8,.4,1)` | Custom Ease — Balanced | | `--ease-fast` | `cubic-bezier(.45,.15,.6,.9)` | Custom Ease — Balanced | | `--ease-in-out` | `cubic-bezier(.4, 0, .2, 1)` | Ease Out — Decelerating | ### Duration Scale | CSS Variable | Value | Tier | |--------------|-------|------| | `--default-transition-duration` | `.15s` | Fast | ### Copy-Paste Transition Snippets **Transform** ```css transition: transform 0.2s cubic-bezier(0.4, 0, 0.2, 1), translate 0.2s cubic-bezier(0.4, 0, 0.2, 1), scale 0.2s cubic-bezier(0.4...; ``` **Opacity** ```css transition: opacity 0.15s cubic-bezier(0.4, 0, 0.2, 1); ``` **Transform** ```css transition: transform 0.15s cubic-bezier(0.4, 0, 0.2, 1), translate 0.15s cubic-bezier(0.4, 0, 0.2, 1), scale 0.15s cubic-bezier(...; ``` **All Props** ```css transition: 0.15s cubic-bezier(0.4, 0, 0.2, 1); ``` ### Keyframe Animation Catalog | Animation Name | Type | Animated Props | Use Hint | |----------------|------|----------------|----------| | `fadeIn-d05aa6b7` | Fade | opacity | Element entrance | | `scroll-horizontal-0d857a7f` | Slide | transform | UI transition | | `event-card-hover` | Custom | background-position-x, background-position-y | UI transition | | `fade-in` | Fade | opacity | Element entrance | | `slideDown` | Fade + Move | opacity, transform | Panel / drawer enter | | `shimmerText` | Custom | background-position-x, background-position-y | Loading placeholder | | `fadeIn` | Fade | opacity | Element entrance | | `pulse` | Fade | opacity | Attention / status | ### Motion Fingerprint - **Speed Character**: Balanced Pacing (median duration: `250ms`) - **Dominant Easing**: custom cubic-bezier curves - **Animation Library**: 8 unique animations (8 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 dark background (`#16171d`) as the foundation — this is a dark-mode-native design - Use Inter as the primary typeface — it defines the brand personality - Keep font weights between 400-600 — the system uses a narrow weight range for subtle hierarchy - Use negative letter-spacing (-3px) at display sizes for compressed, editorial headlines - Use the extracted shadow patterns for elevation — they are tuned to match the brand palette - Use White (`#ffffff`) as the primary accent — it's the brand's signature interactive color - Use 8px border-radius on buttons — the standard corner rounding for interactive elements - Apply 40px 32px padding inside cards — matches the design system's content breathing room - Use 8px border-radius on cards — consistent with the grid card corners - Maintain nav height at 40px — consistent vertical space for the navigation bar - Include exactly 2 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 - Show person avatars with testimonials — social proof is human-centric here - Lay out testimonials in a grid (9+ items) — quantity signals scale and trust ### Don't - Don't use light backgrounds — the dark canvas is the native medium - Don't substitute with generic sans-serif or serif — the custom font carries the brand - Don't use weight 700 (bold) or above — 600 is the maximum weight in this system - 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 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 ## 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(22, 23, 29)` as the base canvas" why: "Every component is designed to composit against this exact tone" test: "document.body.style.backgroundColor === 'rgb(22, 23, 29)'" - id: brand-accent-001 type: do rule: "Reserve `rgb(255, 255, 255)` for primary CTAs and brand-mark signals only" why: "Single chromatic assertion device — overuse dilutes meaning" test: "querySelectorAll('[style*=\"rgb(255, 255, 255)\"]').length <= 3 per fold" ``` ## 9. Responsive Behavior ### Breakpoints | Name | Width | Key Changes | |------|-------|-------------| | Mobile | 375px | Single column, compact spacing | | Mobile Large | 639px | Expanded mobile layout | | Mobile Large | 767px | Expanded mobile layout | | Tablet | 1024px | Multi-column grids begin | | Desktop | 1280px | Full feature layout | | Large Desktop | 1440px | Maximum content width | ### Token Diff — Desktop vs Mobile | Element | Property | Desktop | Mobile | |---------|----------|---------|--------| | heading | font-size | `60px` | `36px` | | heading | line-height | `67.2px` | `40px` | | heading | letter-spacing | `-3px` | `-1.8px` | | nav | display | `flex` | `none` | | nav | height | `40px` | `auto` | | button | width | `36px` | `auto` | | card | padding | `40px 32px` | `24px` | | card | width | `439.328px` | `350px` | ### Collapsing Strategy - Headlines: 60px → 36px 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: 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): - **Hero collapses left-aligned → centered** — composition shifts (verify on actual mobile render). - **Card grid: 2-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.* - **Canvas / 2D rendering** — animated/interactive canvas (charts, graphs, particle fields). Reproduce as live data-viz (e.g. an animated SVG/Canvas line chart), NOT a static image. - **Mesh gradients** — 1 multi-stop organic color field(s) as background atmosphere. - **Clip-path shapes** — 1 non-rectangular cut(s). - **Blend modes** — 1 mix-blend layer(s). - **Scroll-driven reveals** — content animates in on scroll (CSS scroll-timeline). Build fade/translate reveal-on-scroll for below-fold bands. > **Motion fingerprint**: Canvas 2D, mesh gradients, non-rectangular shapes (1), blend modes, CSS scroll-driven animations ## 9b. Visual Tone & Photography **Tone:** Illustration-driven The site relies primarily on illustrations, vector art, and decorative SVG elements rather than photography. Use commissioned illustrations, icon sets, or generated graphics for clones — stock photos will feel off-brand. **Canonical Brand Image (OG):** - https://vite.dev/og-image.jpg *This is the image shown when the site is shared on social media — represents the brand visual essence.* **Aspect Ratio Distribution:** - Landscape (1.15–2.3): 9 (47%) - Portrait (<0.87): 0 (0%) - Square (0.87–1.15): 0 (0%) - Ultra-wide (>2.3): 10 (53%) **Media Format Mix:** - JPG: 4 (typically photographic content) - PNG: 8 (logos, transparent UI elements, mockups) - SVG: 7 (icons, illustrations, decorative geometry) **Average rendered image size:** 523×197px **Above-fold image count:** 0 / 19 **Decorative Patterns Detected:** - 2 multi-stop linear gradients (mesh-like, 3+ color stops) — the brand leans on rich color transitions for visual depth - 1 radial gradient — circular color blooms used for spotlight/glow effects - 5 background patterns (non-photo url() backgrounds) — textures/illustrations as backdrops **Clone instruction for decorative work:** Decorative details are subtle — don't over-style; the design relies on restraint. **Imagery Guidance for clones:** - Use vector illustration as the primary visual language — photos will read as off-brand. - Maintain consistent illustration style (line weight, color palette) across the site. ## 10. Agent Prompt Guide ### Quick Reference - Background: Near-Black (`#16171d`) - Primary text: White (`#ffffff`) - Accent: White (`#ffffff`) - Border: Slate Grey (`#6a6a71`) - Font: Inter - Body: 16px weight 400 ### Example Component Prompts - "Create a hero section on Near-Black background (#16171d). Headline at 60px Inter weight 500, line-height 1.12, letter-spacing -3px, color #ffffff." - "Create the primary CTA button: `#ffffff` background, `#ffffff` text, 9999px border-radius, 8px padding, 500 weight, Inter font." - "Design a card on `transparent` background. Border: none. Radius: 8px. Shadow: none. Padding: 40px 32px." - "Build navigation: static on `#16171d`. Inter 16px weight 400 for links." ### Iteration Guide 1. **Canvas**: Set the dark canvas to Near-Black (`#16171d`) — every component is composited against this exact base. 2. **Typography**: All type in Inter, weight range 400–600. Never exceed 600 — heavier weights break the brand's tonal restraint. 3. **Accent**: White (`#ffffff`) is the sole interactive color. On hover → Brand (`#b39aff`). Use CSS transitions, not opacity/brightness filters. 4. **Focus**: Render focus rings in Vite (`#b39aff`) — never hide focus outlines. The ring color is distinct from the accent to avoid ambiguity. 5. **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. 6. **Shape**: CTAs at `0px`, cards at `8px`. Apply border-radius from the extracted scale only — don't invent intermediate values. 7. **Spacing**: Use the `--ca-space-*` token scale (8px–60px). All padding, margin, and gap values are multiples from this scale — no magic numbers. 8. **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-canvas: #16171d; --ca-surface-2: #08060d; --ca-primary: #ffffff; --ca-ink-muted: #98989f; --ca-ink-subtle: #808080; --ca-on-primary: #111111; --ca-primary-hover: #414853; --ca-hairline: #6a6a71; --ca-primary-focus: #b39aff; --ca-semantic-error: #ef5350; --ca-semantic-success: #3dd68c; --ca-semantic-warning: #f9b44e; } /* Typography */ :root { --ca-font-primary: "APK Protocol", system-ui, sans-serif; --ca-text-display: 60px; --ca-text-body: 14px; --ca-text-small: 16px; --ca-text-button: 16px; } /* Spacing & Radius */ :root { --ca-space-xxs: 2px; --ca-space-xs: 8px; --ca-space-sm: 20px; --ca-space-md: 24px; --ca-space-base: 32px; --ca-space-lg: 40px; --ca-space-xl: 60px; --ca-space-2xl: 64px; --ca-space-3xl: 96px; --ca-radius-none: 0px; --ca-radius-xs: 4px; --ca-radius-sm: 8px; --ca-radius-md: 14px; --ca-radius-lg: 20px; --ca-radius-xl: 32px; --ca-radius-full: 9999px; } /* Motion */ :root { --ca-ease-out: cubic-bezier(0, 0, .2, 1); --ca-ease-smooth: cubic-bezier(.25,.8,.4,1); --ca-ease-fast: cubic-bezier(.45,.15,.6,.9); --ca-ease-in-out: cubic-bezier(.4, 0, .2, 1); } ``` ## 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: 8121px width: full-bleed layout: block children: 1 contains: chart/canvas (reproduce as live data-viz, not a flat image) - section: logo-strip tag: div classes: ["relative", "w-full", "z-50"] height: 81px width: full-bleed layout: block children: 2 - section: header tag: header classes: ["wrapper", "px-6", "py-5", "flex"] height: 81px width: full-bleed layout: flex-row justify=space-between children: 2 bg: "rgb(22, 23, 29)" tone: dark padding: "20px 24px" - section: hero tag: div classes: ["wrapper", "wrapper--ticks", "grid", "md:grid-cols-2"] height: 707px width: full-bleed layout: grid: 2-col gap=normal children: 2 vertical-padding: ~40px contains: chart/canvas (reproduce as live data-viz, not a flat image) - section: section tag: section classes: ["wrapper", "wrapper--ticks", "border-t", "px-10"] height: 93px width: full-bleed layout: flex-column justify=center children: 1 vertical-padding: ~32px padding: "32px 40px" - section: feature-section tag: section classes: ["wrapper", "border-t", "px-5", "sm:px-10"] height: 361px width: full-bleed layout: flex-column justify=center children: 2 vertical-padding: ~112px (airy) padding: "112px 40px" - section: card-grid tag: section classes: ["wrapper", "wrapper--ticks", "border-t", "grid"] height: 1110px width: full-bleed layout: grid: 2-col gap=normal children: 4 contains: chart/canvas (reproduce as live data-viz, not a flat image) - section: section tag: section classes: ["wrapper", "border-t", "px-5", "sm:px-10"] height: 321px width: full-bleed layout: flex-column justify=center children: 1 vertical-padding: ~112px (airy) padding: "112px 40px" - section: card-grid tag: section classes: ["wrapper", "wrapper--ticks", "border-t", "grid"] height: 1056px width: full-bleed layout: grid: 2-col gap=normal children: 4 vertical-padding: ~40px contains: chart/canvas (reproduce as live data-viz, not a flat image) - section: section tag: section classes: ["wrapper", "border-t", "px-5", "sm:px-10"] height: 321px width: full-bleed layout: flex-column justify=center children: 1 vertical-padding: ~112px (airy) padding: "112px 40px" - section: section tag: section classes: ["wrapper", "wrapper--ticks", "border-t", "py-8"] height: 277px width: full-bleed layout: block children: 2 vertical-padding: ~64px (generous) padding: "64px 40px" - section: feature-section tag: div classes: ["wrapper", "wrapper--ticks", "border-t", "pt-14"] height: 1042px width: full-bleed layout: block children: 2 vertical-padding: ~60px (generous) padding: "120px 40px 0px" - section: feature-section tag: div classes: ["wrapper", "wrapper--ticks", "border-t", "py-14"] height: 473px width: full-bleed layout: block children: 1 vertical-padding: ~120px (airy) padding: "120px 40px" - section: content-section tag: div classes: ["wrapper"] height: 1001px width: full-bleed layout: block children: 3 - section: section tag: section classes: ["wrapper", "wrapper--ticks", "border-t", "h-16"] height: 120px width: full-bleed layout: block children: 0 - section: footer tag: footer height: 1044px width: full-bleed layout: block children: 2 bg: "rgb(22, 23, 29)" tone: dark - section: feature-section tag: section classes: ["wrapper"] height: 442px width: full-bleed layout: block children: 1 - section: section tag: section classes: ["wrapper", "wrapper--ticks", "border-t"] height: 541px width: full-bleed layout: block children: 1 vertical-padding: ~112px (airy) ``` **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: - "Redefining developer experience" - "A shared foundation to build upon" - "80k+" sub-headings: - "Loved by the community" ctas: - "Resources" - "Search Ctrl K" - "Get Started" - "Become a Sponsor" navigation: - "Guide" - "Config" - "Plugins" footer-links: - "Get Started" - "Guide" - "GitHub" ``` **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: 17 avg-ratio: 3.57 common-aspect: "~16:6 banner" sample-alts: - "openai" - "shopify" - "stripe" hero: count: 2 avg-ratio: 22.59 common-aspect: "~16:6 banner" sample-alts: - "Frameworks powered by Vite" thumbnail: count: 10 avg-ratio: 1.00 common-aspect: "~1:1 square" sample-alts: - "Vite icon" - "Ryan Carniato" - "Rich Harris" ``` **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 `8px` · radius `0px` · weight `400`_ ### Generic Card ```html
``` _Source pattern detected: padding `40px 32px` · radius `8px` · 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** 6 · **cta** 1 · **docs** 2 · **blog** 2 · **social** 8 · **footer** 10 · **other** 20 **Primary actions (conversion path):** - Primary call-to-action — "Get Started" (the conversion path) → `https://vite.dev/guide/` **Projects / case studies detected** (clustered by URL + featured image): *Vitejs* — medium confidence, 2 items: | Title | Featured image | Link | |---|---|---| | Vite | — | https://github.com/vitejs/vite | | Releases | — | https://github.com/vitejs/vite/releases | **Signals:** 33/49 links carry a featured image · device mockups detected: laptop ×1 · dominant link roles: content-card (25), footer-link (14), navigation (6). --- ## Extraction Completeness: 87/100 (B) | Category | Score | Max | Detail | |----------|-------|-----|--------| | Colors & Palette | 17 | 25 | 12 named colors | | Typography | 20 | 20 | 8 roles defined | | Components | 20 | 20 | 6 specs extracted | | Motion & Interaction | 15 | 15 | Keyframes, easing vars | | CSS Custom Properties | 10 | 10 | 407 vars | | Responsive Breakpoints | 5 | 5 | 6 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 (APK Protocol, KH Teka Mono, Inter)** — detected but not downloaded. Substitute with your licensed copy or a close fallback (see Typography section for metrics). | Category | What's missing | Fallback strategy | |----------|----------------|-------------------| | **Hero imagery** | No dominant hero image detected above the fold | Use the canonical brand visual from §9b (OG image) for hero composition | | **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 | 407 CSS vars (semantic naming requires ≥20 for high) | | §3 Typography | High | 8 typography roles inferred | | §4 Components | High | 6 component variants captured | | §7 Motion | High | Keyframes + transitions | | §8 Do's/Don'ts | High | 23 rules generated; design-decisions.json has evidence per rule | | §9 Responsive | High | 6 breakpoints detected | | §9b Photography | Medium | 19 images, hero not detected | ## 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 `