qwik.dev

DESIGN.md

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

---
version: alpha
name: qwik.dev
description: "Light product system built on #ffffff with #ebedf0 as the primary CTA accent. Type anchored in Poppins at 64px / weight 600. Extracted automatically from https://qwik.dev/ — rendered styles via getComputedStyle() + CSS custom properties (token-only values may not be painted)."
narrative: |
  qwik.dev is built on a pure-white canvas (rgb(255,255,255)).
  The system uses rgb(235, 237, 240) as a near-neutral accent (low saturation).
  Generously rounded CTAs (40px) suggest approachable, content-first design alongside Poppins as the primary typeface.
  Depth comes from borders and surface contrast rather than shadows — a flat, structural elevation model.
  Motion is minimal — a few targeted transitions, no decorative animation.

colors:
  background: "#ffffff"
  surface-1: "#ebedf0"
  surface-2: "#ebedf0"
  ink: "#0e201a"
  ink-muted: "rgba(14, 32, 26, 0.65)"
  ink-subtle: "#969faf"
  primary: "#ebedf0"
  on-primary: "#111111"
  primary-hover: "#0084ff"
  hairline: "rgba(229, 231, 235, 0.38)"
  semantic-warning: "#d9d900"

typography:
  display-xl:
    fontFamily: "Poppins, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif"
    fontSize: 80px
    fontWeight: 600
    lineHeight: 1.13
    letterSpacing: -2.4px
  body:
    fontFamily: "Poppins, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif"
    fontSize: 14px
    fontWeight: 500
    lineHeight: 1.5
    letterSpacing: 0
  body-sm:
    fontFamily: "Poppins, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif"
    fontSize: 19.2px
    fontWeight: 400
    lineHeight: normal
    letterSpacing: 0
  button:
    fontFamily: "Poppins, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif"
    fontSize: 16px
    fontWeight: 500
    lineHeight: 1.5
    letterSpacing: 0

rounded:
  none: 0px
  xs: 6px
  sm: 8px
  md: 16px
  lg: 17px
  xl: 40px
  pill: 9999px

spacing:
  xxs: 2px
  xs: 12px
  sm: 16px
  md: 40px
  lg: 48px
  xl: 56px
  xxl: 72px

components:
  button-light--invert:
    backgroundColor: "{colors.primary}"
    textColor: "#006ce9"
    typography: "{typography.button}"
    rounded: "{rounded.xl}"
    padding: 12px
  button-icon-button:
    backgroundColor: "transparent"
    textColor: "{colors.background}"
    typography: "{typography.body}"
    rounded: "{rounded.xs}"
  button-secondary:
    backgroundColor: "#1d2023"
    textColor: "{colors.background}"
    typography: "{typography.button}"
    rounded: "{rounded.sm}"
    padding: 14px 25px

extracted_at: "2026-06-11T06:15:47.040Z"
completeness: 69
scoreVersion: "v2"

---

# Design System — qwik.dev
> Extracted automatically by Prism from https://qwik.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**: subtle  |  **Weight**: medium  |  **Aesthetic**: soft-rounded

| Dimension | Value | Signal |
|---|---|---|
| Canvas | neutral | `#ffffff` |
| Type posture | sans-led (Poppins) | "Qwik" |
| Color assertion | dual-accent | #ebedf0 |
| Whitespace | sparse | section rhythm 64px |
| Interaction | subtle | 2 keyframes, 4 transitions |
| Radius language | soft-pill | from token scale |

**Prism fingerprint**: `neutral-canvas · sans-display · dual-accent · soft-pill · 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(235, 237, 240)` 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: 48px.
> - **Default radius**: 8px on buttons/inputs. Pills (`9999px`) only for icon-buttons or status chips.
> - **Forbidden**: Do NOT introduce heavy box-shadows — this system relies on borders for separation
>
> **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

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

Typography is anchored in **Poppins**. Headlines use weight 600 for confident, assertive presence — the brand wants to be heard. Negative letter-spacing at display sizes (-2.4px at 80px) compresses headlines into engineered blocks, dense and precise. 

Body text reads in Near Black (`#0e201a`) — softened from pure black, a small but deliberate detail that lowers reading friction. **Whitesmoke** (`#ebedf0`) provides interactive distinction without visual aggression. Shadow is absent by design — depth is conveyed through translucent borders and luminance steps rather than light simulation. 
Motion design uses smooth easing curves for polished state transitions. 

**Key Characteristics:**
- Background: White (`#ffffff`)
- Primary typeface: Poppins
- Primary text: Near Black (`#0e201a`)
- Accent: Whitesmoke (`#ebedf0`)
- Display: 80px weight 600, letter-spacing -2.4px
- Custom fonts loaded: Poppins

## 2. Color Palette & Roles

### Background & Surface
- **White** (`#ffffff`): Page background (primary)
- **Panel Toggle Background Color** (`#daf0ff`): Surface / elevated background (CSS var)
- **Bg Secondary Color** (`#f7f8fb`): Surface / elevated background (CSS var)
- **Whitesmoke** (`#ebedf0`): Surface / elevated background
- **Translucent Light Gray (38%)** (`rgba(229, 231, 235, 0.38)`): Surface / elevated background

### Text & Content
- **Near Black** (`#0e201a`): Primary body text
- **Black** (`#000000`): Secondary text
- **Deep Navy** (`#151934`): Secondary text
- **Near-Black** (`#1d2023`): Secondary text

### Accent & Interactive
- **Sky Bright** (`#18b6f6`): Interactive / accent
- **#ac7ef4** (`#ac7ef4`): Interactive / accent
- **M Tricolor Blue** (`#006ce9`): Interactive / accent
- **Sky Bright** (`#19b6f6`): Interactive / accent
- **Sky Bright** (`#01b9ff`): Interactive / accent
- **Sky Bright** (`#18b4f4`): Interactive / accent
- **Coral** (`#fd6b3c`): Interactive / accent

### Border & Divider
- **Translucent Light Gray (16%)** (`rgba(230, 230, 230, 0.16)`): Borders / dividers

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

- `#a97ff2` — #a97ff2
- `#31adf6` — Sky Bright
- `#976ae2` — Amethyst
- `#ac7ff4` — #ac7ff4
- `#e0e0e0` — Whitesmoke *(token)*
- `#dfdede` — Whitesmoke *(token)*
- `#6000ff` — #6000ff *(token)*
- `#78fa83` — #78fa83 *(token)*
- `#0093ee` — Sky Bright *(token)*
- `#171a19` — Near-Black *(token)*
- `#555a64` — Slate *(token)*
- `#cdcde6` — Light Blue *(token)*
- `rgba(30, 35, 90, 0.4)` — Translucent #1e235a (40%) *(token)*
- `#e2ebff` — Light Gray *(token)*
- `#d4d9e1` — #d4d9e1 *(token)*
- `#e0e3e8` — Whitesmoke *(token)*
- `rgba(69, 98, 155, 0.12)` — Translucent #45629b (12%) *(token)*
- `#009dfd` — Sky Bright *(token)*
- `#5468ff` — Brand Indigo *(token)*
- `#444950` — Dark Gray *(token)*
- `#f5f6f7` — Off-White *(token)*
- `#e3e3e3` — Whitesmoke *(token)*
- `#f7f7f7` — Off-White *(token)*
- `#f4f4f4` — Off-White *(token)*
- `#ff0090` — Rose *(token)*
- `#d9d900` — #d9d900 *(token)*
- `#f3f4cb` — Beige *(token)*
- `#494949` — Charcoal *(token)*
- `#d5dbe4` — #d5dbe4 *(token)*
- `#f8f8f8` — Off-White *(token)*
- `#e3e400` — Gold *(token)*
- `#bfbfbf` — Light Grey *(token)*
- *…+5 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**
- `--tw-inset-shadow-alpha`: `100%`
- `--tw-ring-shadow`: `0 0 #0000`
- `--tw-drop-shadow-alpha`: `100%`
- `--tw-inset-ring-shadow`: `0 0 #0000`

**Spacing Token**
- `--tw-border-spacing-x`: `0px`
- `--docsearch-spacing`: `12px`
- `--tw-space-x-reverse`: `0`
- `--spacing`: `.25rem`

**Success**
- `--color-green-500`: `oklch(72.3% .219 149.579)`
- `--color-green-600`: `oklch(62.7% .194 149.214)`
- `--color-green-400`: `oklch(79.2% .209 151.711)`
- `--color-green-700`: `oklch(52.7% .154 150.069)`

**Error / Destructive**
- `--color-red-400`: `oklch(70.4% .191 22.216)`
- `--color-red-600`: `oklch(57.7% .245 27.325)`

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

**Font Weight Token**
- `--font-weight-bold`: `700`
- `--font-weight-semibold`: `600`
- `--font-weight-medium`: `500`

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

**Warning**
- `--color-yellow-500`: `oklch(79.5% .184 86.047)`

**Other tokens**
- `--code-bg-color`: `#e0e0e0`
- `--repl-log-text`: `#0e201a`
- `--text-2xl`: `1.5rem`
- `--color-purple-500`: `oklch(62.7% .265 303.9)`
- `--color-slate-200`: `oklch(92.9% .013 255.508)`
- `--repl-tab-button-hover-border-color`: `#0084ff75`
- `--color-sky-500`: `oklch(68.5% .169 237.323)`
- `--text-lg`: `1.125rem`

## 3. Typography Rules

### Font Families
- **Primary**: `Poppins`
- **Secondary**: `PT Mono`

### Custom Fonts Loaded
- **Poppins** weight 400 (normal)
- **Poppins** weight 500 (normal)
- **Poppins** weight 700 (normal)

### Typography Hierarchy

| Role | Font | Size | Weight | Line Height | Letter Spacing | Notes |
|------|------|------|--------|-------------|----------------|-------|
| Display Hero | Poppins | 80px | 600 | 1.13 | -2.4px | Main headline (div) |
| Link Large | Poppins | 19.2px | 400 | normal | normal | Link (19.2px) — Decoration: none |
| Card Title | Poppins | 16px | 400 | 1.5 | normal | Card headings |
| Button Large | Poppins | 16px | 500 | 1.5 | normal | Button label (16px) |
| Button | Poppins | 14px | 500 | 1.5 | normal | Button label (14px) |

### Font Weight Scale

CSS custom properties define 3 explicit weight steps:
- `--font-weight-medium`: `500` — Medium
- `--font-weight-semibold`: `600` — SemiBold
- `--font-weight-bold`: `700` — Bold

### Full Font Size Scale

Sizes detected in the design (descending): `80px`, `64px`, `48px`, `40px`, `24px`, `22px`, `20px`, `19.20px`, `17px`, `16px`, `14px`, `12px`

> 8 size(s) detected outside the sampled hierarchy (64px, 48px, 40px, 24px, 22px, 20px, 17px, 12px). These appear on elements not in the sampled set — likely additional display sizes, marketing-section overrides, or third-party-widget styles.

### OpenType & Variable Font Features

The typography uses these OpenType features intentionally — this is a sophisticated type system, not a default fallback:

- **contextual alternates** (`calt`) — connections between letters refined contextually
- **ligatures** — common letter pairs replaced with refined glyphs (fi, fl, etc.)

**Clone instruction:** Enable these in your CSS:
```css
body {
  font-feature-settings: "liga", "calt";
}
```

## 4. Component Stylings

### Buttons

**Light / Invert**
- Background: `#ebedf0` `{colors.primary}`
- Text: `#006ce9`
- Padding: 12px
- Radius: 40px
- Border: 2px solid rgb(0, 108, 233)
- Font: 16px weight 500
- Use: Bright CTA on dark sections

**Icon Button**
- Background: `transparent`
- Text: `#ffffff` `{colors.background}`
- Padding: 0px
- Radius: 6px
- Font: 14px weight 500
- Use: Toolbar/UI icons

**Secondary**
- Background: `#1d2023`
- Text: `#ffffff` `{colors.background}`
- Padding: 14px 25px
- Radius: 8px
- Font: 16px weight 500
- Use: Secondary action

**Primary Brand**
- Background: `#ac7ef4`
- Text: `#ffffff` `{colors.background}`
- Padding: 15px 35px
- Radius: 8px
- Font: 16px weight 600
- Use: Primary CTA / brand action

**Primary Brand**
- Background: `#31adf6`
- Text: `#ffffff` `{colors.background}`
- Padding: 15px 35px
- Radius: 8px
- Font: 16px weight 400
- Use: Primary CTA / brand action

**Primary Brand**
- Background: `#18b6f6`
- Text: `#ffffff` `{colors.background}`
- Padding: 15px 35px
- Radius: 8px
- Font: 16px weight 400
- Use: Primary CTA / brand action


## 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: "rgb(235, 237, 240)"
      fg: "rgb(0, 108, 233)"
      border: "2px solid rgb(0, 108, 233)"
  link:
    default:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(255, 255, 255)"
    hover:
      bg: "transparent"
      fg: "inherit"
  card:
    default:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(14, 32, 26)"
  navLink:
    default:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(255, 255, 255)"
    hover:
      bg: "transparent"
      fg: "inherit"
  footerLink:
    default:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(14, 32, 26)"
```

**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: `Light / Invert`, `Icon Button`, `Secondary`, `Primary Brand`
- **DO NOT introduce new buttons variants** without justification

## 5. Layout Principles

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

### Grid
Single column, centered content

### Max Width
1400px

### Spacing System
Generous spacing — editorial breathing room

| Token | Value |
|-------|-------|
| xxs | 2px |
| xs | 12px |
| sm | 16px |
| md | 40px |
| base | 43px |
| lg | 48px |
| xl | 56px |
| 2xl | 64px |
| 3xl | 72px |

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

### Shape Language

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

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

**Full Radius Spectrum**: 0px, 6px, 8px, 11px, 16px, 17px, 40px (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** | `72px` | Top/bottom of full-bleed hero sections |
| **section** | `56px` | Between major bands (color change, content shift) |
| **subsection** | `48px` | Within a section, between content groups |
| **card** | `40px` | Card padding, list-item spacing |
| **compact** | `16px` | Form fields, tight clusters, badge padding |
| **micro** | `12px` | 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.**

### Navigation Pattern

- **Position:** sticky (stays visible during scroll)
- **Layout:** logo-left-links-left — Logo and links both on the left (CTAs typically right)
- **Height:** 80px
- **Logo:** ✓ present
- **Nav links:** 9 primary items
- **CTAs in nav:** 0 (no buttons — links only)
- **Search:** ✓ search input visible in nav
- **Clone instruction:** Build a sticky logo left links left navigation. Link-only — no button styling needed.

### Card Grid Pattern

- **Card count:** 7 cards detected
- **Columns (desktop):** 1-up grid
- **Card dimensions:** 1432×769px (aspect 1.86:1)
- **Gap:** 0px between cards
- **Content:** ✗ no image
- **Clone instruction:** Build a 1-column grid (desktop) with cards at ~1.86:1 aspect ratio. Text/icon-only cards (no photography).

### Footer Pattern

- **Columns:** 1
- **Links:** 16 total
- **Height:** 255px
- **Includes:** ✗ no newsletter | ✓ social icons |  ✓ copyright
- **Clone instruction:** Build a 1-column footer with ~16 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 |

**Shadow Philosophy**: Flat design — no shadows used. Borders and spacing define structure.

## 7. Motion & Interaction

### Easing System

| CSS Variable | Curve | Semantic Name |
|--------------|-------|---------------|
| `--ease-in-out` | `cubic-bezier(.4,0,.2,1)` | Ease Out — Decelerating |
| `--default-transition-timing-function` | `cubic-bezier(.4,0,.2,1)` | Ease Out — Decelerating |
| `--ease-out` | `cubic-bezier(0,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, 0, 0.2, 1), translate 0.2s cubic-bezier(0, 0, 0.2, 1), scale 0.2s cubic-bezier(0, 0, 0...;
```

**Opacity**
```css
transition: opacity 0.4s ease-in-out;
```

**Color / Background**
```css
transition: color 0.3s cubic-bezier(0.37, 0.01, 0, 0.98);
```

### Keyframe Animation Catalog

| Animation Name | Type | Animated Props | Use Hint |
|----------------|------|----------------|----------|
| `indeterminate-progress-bar` | Custom | left | UI transition |
| `fade-in` | Fade | opacity | Element entrance |

### Motion Fingerprint

- **Speed Character**: Deliberate & Calm (median duration: `300ms`)
- **Dominant Easing**: custom cubic-bezier curves
- **Animation Library**: 2 unique animations (2 total including variants)

> This design moves with deliberate & calm timing using custom cubic-bezier curves, creating a UI that feels calm and controlled.

## 8. Do's and Don'ts

### Do
- Use Near Black (`#0e201a`) for text — not pure black, it's warmer and more readable
- Use Poppins as the primary typeface — it defines the brand personality
- Use negative letter-spacing (-2.4px) at display sizes for compressed, editorial headlines
- Use Whitesmoke (`#ebedf0`) 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
- Make the navigation sticky — it stays visible during scroll, signaling content depth
- Include a search input directly in the nav — discoverability is a primary UX value here

### 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 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 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(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(235, 237, 240)` for primary CTAs and brand-mark signals only"
    why: "Single chromatic assertion device — overuse dilutes meaning"
    test: "querySelectorAll('[style*=\"rgb(235, 237, 240)\"]').length <= 3 per fold"
  - id: brand-depth-001
    type: dont
    rule: "Do NOT introduce drop shadows on cards or sections"
    why: "Containment is achieved via borders, not elevation — adding shadows breaks the depth contract"
    test: "getComputedStyle(card).boxShadow === 'none'"
```

## 9. Responsive Behavior

### Breakpoints
| Name | Width | Key Changes |
|------|-------|-------------|
| Mobile Large | 540px | Expanded mobile layout |
| Mobile Large | 640px | Expanded mobile layout |
| Tablet | 768px | Multi-column grids begin |
| Tablet | 991px | Multi-column grids begin |
| Tablet | 1023px | Multi-column grids begin |
| Large Desktop | 1300px | Maximum content width |

### Token Diff — Desktop vs Mobile

| Element | Property | Desktop | Mobile |
|---------|----------|---------|--------|
| heading | font-size | `80px` | `48px` |
| heading | line-height | `90px` | `62.4px` |
| heading | letter-spacing | `-2.4px` | `-1.44px` |
| button | width | `auto` | `52px` |
| card | width | `650px` | `300px` |

### Collapsing Strategy
- Headlines: 80px → 48px on mobile
- 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: 12px 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):

- **Navigation collapses to hamburger** — 9 links visible on desktop, 1 on mobile (the rest hide behind a menu toggle).


## 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** — 1 frosted/blur layer(s) (e.g. `blur(23px) saturate(1)`).
- **Clip-path shapes** — 1 non-rectangular cut(s).

> **Motion fingerprint**: glassmorphism (1 layers), non-rectangular shapes (1)

## 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://qwik.dev/logos/social-card.jpg (800×418px)
  *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.82:1 (landscape (16:9-ish))
- Rendered size: 500×275px
- *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): 16 (76%)
- Portrait (<0.87): 0 (0%)
- Square (0.87–1.15): 4 (19%)
- Ultra-wide (>2.3): 1 (5%)

**Media Format Mix:**
- SVG: 16 (icons, illustrations, decorative geometry)

**Average rendered image size:** 475×291px
**Above-fold image count:** 0 / 21

**Decorative Patterns Detected:**
- 18 multi-stop linear gradients (mesh-like, 3+ color stops) — the brand leans on rich color transitions for visual depth
- 15 large decorative SVG shapes (≥200×200px, non-icon) — likely blob/illustration accents
- **Glassmorphism** detected (`backdrop-filter: blur`) — layered transparent surfaces with blur, modern OS-like aesthetic

**Clone instruction for decorative work:** This is a gradient-rich design — invest in multi-stop CSS gradients (3+ color stops), not solid backgrounds.

**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: White (`#ffffff`)
- Primary text: Near Black (`#0e201a`)
- Accent: Whitesmoke (`#ebedf0`)
- Border: Translucent Light Gray (38%) (`rgba(229, 231, 235, 0.38)`)
- Font: Poppins
- Body: 16px weight 400

### Example Component Prompts
- "Create a hero section on White background (#ffffff). Headline at 80px Poppins weight 600, line-height 1.13, letter-spacing -2.4px, color #0e201a."
- "Create the primary CTA button: `#ebedf0` background, `#006ce9` text, 40px border-radius, 12px padding, 500 weight, Poppins font."
- "Design a card on `transparent` background. Border: none. Radius: 0px. Shadow: none. Padding: 0px."
- "Build navigation: sticky on `#ffffff`. Poppins 16px weight 400 for links."

### Iteration Guide
1. **Canvas**: Set the light canvas to White (`#ffffff`) — every component is composited against this exact base.
2. **Typography**: All type in Poppins, weight range 400–700. Never exceed 700 — heavier weights break the brand's tonal restraint.
3. **Accent**: Whitesmoke (`#ebedf0`) is the sole interactive color. On hover → Sky Bright (`#18b6f6`). Use CSS transitions, not opacity/brightness filters.
4. **Motion**: All transitions use `cubic-bezier(0,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 `40px`, cards at `0px`. Apply border-radius from the extracted scale only — don't invent intermediate values.
6. **Spacing**: Use the `--ca-space-*` token scale (12px–56px). 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: #ffffff;
  --ca-primary: #ebedf0;
  --ca-ink-muted: #0e201a;
  --ca-ink-subtle: #969faf;
  --ca-on-primary: #111111;
  --ca-primary-hover: #0084ff;
  --ca-hairline: #e5e7eb;
  --ca-semantic-warning: #d9d900;
}

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

/* Spacing & Radius */
:root {
  --ca-space-xxs: 2px;
  --ca-space-xs: 12px;
  --ca-space-sm: 16px;
  --ca-space-md: 40px;
  --ca-space-base: 43px;
  --ca-space-lg: 48px;
  --ca-space-xl: 56px;
  --ca-space-2xl: 64px;
  --ca-space-3xl: 72px;
  --ca-radius-none: 0px;
  --ca-radius-xs: 6px;
  --ca-radius-sm: 8px;
  --ca-radius-md: 16px;
  --ca-radius-lg: 17px;
  --ca-radius-xl: 40px;
  --ca-radius-full: 9999px;
}

/* Motion */
:root {
  --ca-ease-in-out: cubic-bezier(.4,0,.2,1);
  --ca-ease-out: cubic-bezier(0,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: header
    tag: header
    classes: ["header-container", "home-page-header"]
    height: 80px
    width: full-bleed
    layout: block
    children: 3
  - section: content-section
    tag: main
    height: 6631px
    width: full-bleed
    layout: block
    children: 1
  - section: section
    tag: section
    classes: ["cz5wnof"]
    height: 643px
    width: 1200px
    layout: flex-column justify=normal
    children: 4
    vertical-padding: ~43px
  - section: content-section
    tag: section
    classes: ["cru0mak"]
    height: 775px
    width: 1400px
    layout: flex-column justify=normal
    children: 3
  - section: content-section
    tag: section
    classes: ["cz5wnof"]
    height: 836px
    width: 1200px
    layout: flex-column justify=normal
    children: 4
  - section: section
    tag: section
    classes: ["cru0mak"]
    height: 561px
    width: full-bleed
    layout: flex-column justify=normal
    children: 1
  - section: content-section
    tag: section
    classes: ["cru0mak"]
    height: 500px
    width: 1400px
    layout: flex-column justify=normal
    children: 1
  - section: section
    tag: section
    classes: ["cru0mak"]
    height: 395px
    width: 1400px
    layout: flex-column justify=normal
    children: 2
  - section: content-section
    tag: section
    classes: ["cz5wnof"]
    height: 749px
    width: 1200px
    layout: flex-column justify=normal
    children: 3
  - section: section
    tag: section
    classes: ["cz5wnof"]
    height: 464px
    width: 1200px
    layout: flex-column justify=normal
    children: 4
  - section: unknown
    tag: div
    classes: ["px-4"]
    height: 255px
    width: full-bleed
    layout: block
    children: 1
    padding: "0px 16px"
  - section: footer
    tag: footer
    classes: ["mb-12", "mt-10"]
    height: 255px
    width: 1408px
    layout: block
    children: 2
```

**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:
  ctas:
    - "Search"
  navigation:
    - "Qwik Homepage"
    - "GitHub"
    - "@QwikDev"
    - "Discord"
    - "Docs"
    - "Ecosystem"
    - "Tutorial"
    - "Qwik Sandbox"
    - "Blog"
  footer-links:
    - "Docs"
```

**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:
  hero:
    count: 1
    avg-ratio: 6.59
    common-aspect: "~16:6 banner"
    sample-alts:
      - "Showcase"
  product:
    count: 5
    avg-ratio: 1.02
    common-aspect: "~1:1 square"
  thumbnail:
    count: 8
    avg-ratio: 1.00
    common-aspect: "~1:1 square"
  icon:
    count: 4
    avg-ratio: 0.56
    common-aspect: "~9:16 portrait"
```

**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
</button>
```
_Source pattern detected: padding `12px` · radius `40px` · weight `500`_

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

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


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

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

**By purpose:** **nav** 5 · **docs** 5 · **blog** 1 · **project** 2 · **social** 11 · **footer** 10 · **other** 11

**Signals:** 23/45 links carry a featured image · device mockups detected: laptop ×12 · dominant link roles: content-card (17), footer-link (10), inline-link (8).


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

| Category | Score | Max | Detail |
|----------|-------|-----|--------|
| Colors & Palette | 24 | 25 | 17 named colors |
| Typography | 13 | 20 | 5 roles defined |
| Components | 4 | 20 | 1 specs extracted |
| Motion & Interaction | 15 | 15 | Keyframes, easing vars |
| CSS Custom Properties | 9 | 10 | 178 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:*

- **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 | 178 CSS vars (semantic naming requires ≥20 for high) |
| §3 Typography | High | 5 typography roles inferred |
| §4 Components | Low | 1 component variants captured |
| §7 Motion | High | Keyframes + transitions |
| §8 Do's/Don'ts | High | 13 rules generated; design-decisions.json has evidence per rule |
| §9 Responsive | High | 6 breakpoints detected |
| §9b Photography | High | 21 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.*

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

### Real Responsive Breakpoints
**8 breakpoints** read from the live `@media` rules (not guessed):
`540px` · `640px` · `768px` · `991px` · `999px` · `1023px` · `1024px` · `1300px`

### Measured Design Scale
**Type scale by usage** (× = paint count): `16px`×459 · `14px`×51 · `12px`×38 · `20px`×36 · `64px`×33 · `19.2px`×29 · `17px`×24 · `40px`×18

**Radius scale** (× = paint count): `8px`×17 · `11px`×14 · `16px`×9 · `100%`×7 · `50%`×3 · `40px`×1 · `6px`×1 · `17px`×1

**Weights** (× = paint count): `400`×513 · `600`×119 · `500`×102 · `700`×10 · `800`×4

**Layout gaps** (× = paint count): `6px`×8 · `16px`×4 · `25px`×3 · `40px`×2 · `32px`×1 · `20px`×1 · `16px normal`×1 · `32px 80px`×1

### 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
header { background:var(--bg-color) }
@media (min-width: 1024px) header { background:var(--bg-header-color) }
header { color:#fff; background:0 0!important; background-color:initial !important }
button { background:var(--docsearch-searchbox-background); border-radius:40px; color:var(--docsearch-muted-color); font-weight:500 }
```

> 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://qwik.dev | 2026-06-11T06:15:47.082Z*
*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.*