yazio.com

DESIGN.md

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

---
version: alpha
name: yazio.com
description: "Light product system built on #ffffff with #005c46 as the primary CTA accent. Type anchored in Rubik at 80px / weight 800. Extracted automatically from https://yazio.com/ — every value from getComputedStyle(), no approximation."
narrative: |
  yazio.com is built on a pure-white canvas (rgb(255, 255, 255)).
  The system uses rgb(0, 92, 70) as the accent for primary actions and brand signals.
  Moderately rounded CTAs (8px) — modern SaaS standard, neither sharp nor pill alongside Rubik as the primary typeface.

colors:
  background: "#ffffff"
  surface-1: "#d3fce7"
  surface-2: "#ffedac"
  ink: "#384250"
  ink-subtle: "#6b7280"
  primary: "#005c46"
  on-primary: "#ffffff"
  primary-hover: "#00ffc3"
  hairline: "#384250"
  primary-focus: "#101010"

typography:
  display-xl:
    fontFamily: "Yazio Sans"
    fontSize: 80px
    fontWeight: 800
    lineHeight: 1
    letterSpacing: -1.2px
  display-md:
    fontFamily: "Rubik"
    fontSize: 16px
    fontWeight: 600
    lineHeight: 1.5
    letterSpacing: 0
  body:
    fontFamily: "Rubik"
    fontSize: 16px
    fontWeight: 400
    lineHeight: 1.5
    letterSpacing: 0
  caption:
    fontFamily: "Yazio Sans"
    fontSize: 64px
    fontWeight: 800
    lineHeight: 1
    letterSpacing: -0.9px
  button:
    fontFamily: "Yazio Sans"
    fontSize: 20px
    fontWeight: 800
    lineHeight: 1.4
    letterSpacing: 0

rounded:
  none: 0px
  xs: 6.4px
  sm: 8px
  md: 12px
  lg: 16px
  xl: 24px
  pill: 9999px

spacing:
  xxs: 2px
  xs: 10px
  sm: 12px
  md: 16px
  lg: 24px
  xl: 32px
  xxl: 64px
  section: 80px

components:
  button-secondary:
    backgroundColor: "#262828"
    textColor: "{colors.on-primary}"
    typography: "{typography.display-md}"
    rounded: "{rounded.lg}"
    padding: 12px 24px
  button-ghost:
    backgroundColor: "transparent"
    textColor: "#262828"
    typography: "{typography.display-md}"
    rounded: "{rounded.sm}"
    padding: 16px 24px
  button-light--invert:
    backgroundColor: "{colors.surface-1}"
    textColor: "#262828"
    typography: "{typography.button}"
    rounded: "{rounded.sm}"
    padding: 16px
  card-standard-card:
    backgroundColor: "{colors.on-primary}"
    typography: "{typography.display-md}"
    rounded: "{rounded.lg}"
    padding: 20px 24px
  navigation-main-nav:
    backgroundColor: "transparent"
    typography: "{typography.display-md}"
    rounded: "{rounded.none}"
    padding: 20px 0px

extracted_at: "2026-05-30T20:40:29.103Z"
completeness: 80
scoreVersion: "v2"

---

# Design System — yazio.com
> Extracted automatically by Clone Architect from https://yazio.com
> Date: 2026-05-30
> Viewport: Desktop 1440x900 + Mobile 390x844
> Every value in this file comes from real getComputedStyle() — no approximation.

> **🤖 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(0, 92, 70)` for primary CTAs ONLY. Never decorative.
> - **Body type**: 16px (token: `typography.body`). Default for ALL text not in a heading role.
> - **Section rhythm**: 48px between major bands. Card padding: 24px.
> - **Default radius**: 8px on buttons/inputs. Pills (`9999px`) only for icon-buttons or status chips.
>
> **Before generating UI**: import this DESIGN.md, scan §2 (Color Palette) + §4 (Components) + §10 (Agent Guide). Skip §11–12 unless extending.

## 1. Visual Theme & Atmosphere

yazio.com adopts the classic pure-white canvas (`#ffffff`) — a deliberate choice that recedes into transparency, letting typography, color and product imagery carry the entire visual weight. 

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

Body text reads in Dark Gray (`#384250`). **#005c46** (`#005c46`) provides interactive distinction without visual aggression. Elevation is built from multi-layer shadow stacks — each level combines several blurred layers at varying offsets to simulate the way light actually falls on stacked surfaces, not the simulated drop-shadow of cheap interfaces. 
Motion design uses smooth easing curves for polished state transitions. 

**Key Characteristics:**
- Background: White (`#ffffff`)
- Primary typeface: Rubik
- Primary text: Dark Gray (`#384250`)
- Accent: #005c46 (`#005c46`)
- Display: 80px weight 800, letter-spacing -1.2px
- Shadow system: 2 distinct elevation levels
- Custom fonts loaded: Rubik, Yazio Sans

## 2. Color Palette & Roles

### Background & Surface
- **White** (`#ffffff`): Page background (primary)
- **Light Gray** (`#d3fce7`): Surface / elevated background
- **Vibrant Yellow** (`#ffedac`): Surface / elevated background
- **Light Gray** (`#d5f1ff`): Surface / elevated background
- **#b7ffee** (`#b7ffee`): Surface / elevated background

### Text & Content
- **Dark Gray** (`#384250`): Primary body text
- **Black** (`#000000`): Secondary text
- **#005c46** (`#005c46`): Secondary text
- **Warm Brown** (`#262828`): Secondary text
- **Jet Black** (`#0f1111`): Secondary text

### Accent & Interactive
- **#00ffc3** (`#00ffc3`): Interactive / accent
- **Emerald** (`#00ad85`): Interactive / accent
- **#ffd033** (`#ffd033`): Interactive / accent
- **Slate Gray** (`#6b7280`): Interactive / accent
- **#0288d1** (`#0288d1`): Interactive / accent
- **#155dfc** (`#155dfc`): Interactive / accent
- **Slate Gray** (`#6a7282`): Interactive / accent

### Border & Divider
- **Light Gray** (`#dadce2`): Borders / dividers
- **Light Gray** (`#dce1e4`): Borders / dividers

### Full Extracted Palette
29 distinct colors detected on the live page (19 categorized above + 10 additional below). Every value is a real `getComputedStyle()` color — no approximation.

- `#181617` — Near Black
- `#65696a` — Dim Gray
- `#080c12` — Jet Black
- `#929799` — Cool Gray
- `#595f60` — Dim Gray
- `#1a1a1a` — Near Black
- `#f3f4f6` — Light Gray
- `#ebeff1` — Light Gray
- `#0277bd` — #0277bd
- `#f9fafb` — Off-White

### 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`

**Border Radius Token**
- `--cc-pm-toggle-border-radius`: `4em`
- `--cc-modal-border-radius`: `.5rem`
- `--cc-btn-border-radius`: `.4rem`
- `--radius-2xl`: `1rem`

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

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

**Font Weight Token**
- `--font-weight-bold`: `700`
- `--font-weight-extralight`: `200`
- `--font-weight-semibold`: `600`
- `--font-weight-extrabold`: `800`

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

**Success**
- `--color-green-600`: `oklch(62.7% .194 149.214)`
- `--color-green-50`: `oklch(98.2% .018 155.826)`

**Spacing Token**
- `--spacing`: `.25rem`
- `--tw-space-y-reverse`: `0`

**Z-Index Token**
- `--cc-z-index`: `2147480000`

**Other tokens**
- `--cc-btn-primary-hover-border-color`: `#0277bd`
- `--text-2xl`: `1.5rem`
- `--cc-webkit-scrollbar-bg`: `#f9fafb`
- `--cc-toggle-readonly-bg`: `#f3f4f6`
- `--cc-overlay-bg`: `#000000a6`
- `--text-lg`: `1.125rem`
- `--color-neutral-600`: `oklch(43.9% 0 0)`
- `--color-neutral-500`: `oklch(55.6% 0 0)`

## 3. Typography Rules

### Font Families
- **Primary**: `Rubik`
- **Secondary**: `Yazio Sans`
- **Font 3**: `Noto Sans`
- **Font 4**: `-apple-system`

### Custom Fonts Loaded
- **Rubik** weight 400 (normal)
- **Rubik** weight 500 (normal)
- **Noto Sans** weight 100 900 (normal)
- **Yazio Sans** weight normal (normal)

### Typography Hierarchy

| Role | Font | Size | Weight | Line Height | Letter Spacing | Notes |
|------|------|------|--------|-------------|----------------|-------|
| Display Hero | Yazio Sans | 80px | 800 | 1 | -1.2px | Main headline (h1) |
| Caption / Badge | Yazio Sans | 64px | 800 | 1 | -0.9px | small text (64px) |
| Button Large | Yazio Sans | 20px | 800 | 1.4 | normal | Button label (20px) |
| Sub-heading | Rubik | 16px | 600 | 1.5 | normal | Third-level heading (h3) |
| Body | Rubik | 16px | 400 | 1.5 | normal | Standard reading text |
| Button Large | Rubik | 16px | 700 | 1.5 | normal | Button label (16px) |
| Caption / Badge | Rubik | 16px | 800 | 1.5 | normal | small text (16px) |

### Font Weight Scale

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

### Full Font Size Scale

Sizes detected in the design (descending): `80px`, `64px`, `40px`, `32px`, `28px`, `24px`, `20px`, `18px`, `17.60px`, `16.80px`, `16px`, `14.40px`, `14px`, `13.12px`, `12.80px`, `12px`

> 12 size(s) detected outside the sampled hierarchy (40px, 32px, 28px, 24px, 18px, 17.6px, 16.8px, 14.4px, 14px, 13.12px, 12.8px, 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

**Secondary**
- Background: `#262828`
- Text: `#ffffff` `{colors.on-primary}`
- Padding: 12px 24px
- Radius: 16px
- Font: 16px weight 700
- Use: Secondary action
- Focus: outline: `rgb(16, 16, 16) auto 1px`

**Ghost**
- Background: `transparent`
- Text: `#262828`
- Padding: 16px 24px
- Radius: 8px
- Font: 16px weight 700
- Use: Subtle action, toolbar, nav button
- Focus: outline: `rgb(16, 16, 16) auto 1px`

**Light / Invert**
- Background: `#d3fce7` `{colors.surface-1}`
- Text: `#262828`
- Padding: 16px
- Radius: 8px
- Font: 20px weight 800
- Use: Bright CTA on dark sections
- Focus: outline: `rgb(16, 16, 16) auto 1px`

**Icon Button**
- Background: `#ffffff` `{colors.on-primary}`
- Text: `#262828`
- Padding: 8px
- Radius: 24px
- Font: 20px weight 800
- Use: Toolbar/UI icons
- Focus: outline: `rgb(16, 16, 16) auto 1px`

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

**Primary Brand**
- Background: `#0288d1`
- Text: `#ffffff` `{colors.on-primary}`
- Padding: 6.56px 13.12px
- Radius: 6.4px
- Border: 1px solid rgb(2, 136, 209)
- Font: 13.12px weight 600
- Use: Primary CTA / brand action
- Focus: outline: `rgb(16, 16, 16) auto 1px`

**Light / Invert**
- Background: `#f3f4f6`
- Text: `#1a1a1a`
- Padding: 6.56px 13.12px
- Radius: 6.4px
- Border: 1px solid rgb(243, 244, 246)
- Font: 13.12px weight 600
- Use: Bright CTA on dark sections
- Focus: outline: `rgb(16, 16, 16) auto 1px`

### Cards & Containers

**Standard Card**
- Background: `#ffffff` `{colors.on-primary}`
- Padding: 20px 24px
- Radius: 16px
- Border: 2px solid rgb(220, 225, 228)
- Use: Content containers, listing items

### Navigation

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


## 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(38, 40, 40)"
      fg: "rgb(255, 255, 255)"
    focus:
      bg: "rgb(38, 40, 40)"
      fg: "rgb(255, 255, 255)"
  link:
    default:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(0, 92, 70)"
  card:
    default:
      bg: "rgb(255, 255, 255)"
      fg: "rgb(8, 12, 18)"
      border: "2px solid rgb(220, 225, 228)"
  navLink:
    default:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(0, 92, 70)"
  footerLink:
    default:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(0, 92, 70)"
```

**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
- **7 shape(s)** in this system: `Secondary`, `Ghost`, `Light / Invert`, `Icon Button`, `Ghost`
- **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

## 5. Layout Principles

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

### Grid
Flexbox column

### Max Width
1200px

### Spacing System
Compact spacing — information density prioritized

| Token | Value |
|-------|-------|
| xxs | 2px |
| xs | 10px |
| sm | 12px |
| md | 16px |
| base | 20px |
| lg | 24px |
| xl | 32px |
| 2xl | 48px |
| 3xl | 64px |

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

### Shape Language

| Component | Border Radius |
|-----------|---------------|
| Buttons | `16px` |
| Cards & Containers | `16px` |
| Navigation | `none` |
| Page Body | `0px` |

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

**Full Radius Spectrum**: 6.4px, 7px, 8px, 12px, 16px, 24px (from `allBorderRadii` scan)


## 5b. Spacing Rhythm Names

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

| Name | Value | Use case |
|------|-------|----------|
| **hero** | `64px` | Top/bottom of full-bleed hero sections |
| **section** | `32px` | Between major bands (color change, content shift) |
| **subsection** | `24px` | Within a section, between content groups |
| **card** | `16px` | Card padding, list-item spacing |
| **compact** | `12px` | Form fields, tight clusters, badge padding |
| **micro** | `10px` | 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:** 364px tall (not full-viewport)
- **Heading:** "Adoptez des habitudes saines au quotidien" — 80px center-aligned
- **Subheading:** "Obtenez votre programme personnalisé en quelques minutes"
- **CTAs:** 1 (primary: "Essayez maintenant")
- **Clone instruction:** Reproduce the **centered** layout. Use the heading font-size token at the documented size. No imagery needed for hero — text-driven.

### Navigation Pattern

- **Position:** static (scrolls with page)
- **Layout:** unknown — Layout not classified
- **Height:** 56px
- **Logo:** ✗ absent
- **Nav links:** 4 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:** 5 cards detected
- **Columns (desktop):** 5-up grid
- **Card dimensions:** 276×588px (aspect 0.47:1)
- **Gap:** 24px between cards
- **Content:** ✓ image
- **Image position:** top
- **Clone instruction:** Build a 5-column grid (desktop) with cards at ~0.47:1 aspect ratio. Each card has an image at the top.

### Footer Pattern

- **Columns:** 3
- **Links:** 19 total
- **Height:** 824px
- **Includes:** ✗ no newsletter | ✓ social icons |  ✓ copyright
- **Clone instruction:** Build a 3-column footer with ~6 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) | <br>`rgba(0, 0, 0, 0) 0px 0px 0px 0px`,<br>`rgba(0, 0, 0, 0) 0px 0px 0px 0px`,<br>`rgba(0, 0, 0, 0) 0px 0px 0px 0px`,<br>`rgba(0, 0, 0, 0) 0px 0px 0px 0px`,<br>`rgba(0, 0, 0, 0.1) 0px 10px 15px -3px`,<br>`rgba(0, 0, 0, 0.1) 0px 4px 6px -4px` | Cards, elevated surfaces |
| Layered (Level 2) | <br>`rgba(0, 0, 2, 0.3) 0px 10px 30px 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

### Easing System

| CSS Variable | Curve | Semantic Name |
|--------------|-------|---------------|
| `--ease-in` | `cubic-bezier(.4,0,1,1)` | Custom Ease — Balanced |
| `--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 |
| `--cc-modal-transition-duration` | `.25s` | Normal |

### Copy-Paste Transition Snippets

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

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

**Transform**
```css
transition: transform 0.075s cubic-bezier(0.4, 0, 0.2, 1), translate 0.075s cubic-bezier(0.4, 0, 0.2, 1), scale 0.075s cubic-bezi...;
```

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

### Keyframe Animation Catalog

| Animation Name | Type | Animated Props | Use Hint |
|----------------|------|----------------|----------|
| `reveal-bg-83cb6334` | Fade | opacity | UI transition |
| `ripple-scale` | Scale | transform | Focus / emphasis |
| `ripple-fade-out` | Fade | opacity | Element exit |
| `unblur-reveal-301ac4b6` | Fade | filter, opacity | UI transition |
| `pulse` | Fade | opacity | Attention / status |
| `zoom-in` | Fade + Move | opacity, transform | Focus / emphasis |
| `fade` | Fade | opacity | UI transition |
| `slide-fade-up` | Fade + Move | opacity, transform | UI transition |
| `shake` | Rotate / Spin | transform | Error feedback |
| `shadow-pulse` | Custom | box-shadow | Attention / status |
| `ios-dot-eb40666a` | Fade | opacity | UI transition |

### Motion Fingerprint

- **Speed Character**: Balanced Pacing (median duration: `200ms`)
- **Dominant Easing**: custom cubic-bezier curves
- **Animation Library**: 11 unique animations (11 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 Rubik as the primary typeface — it defines the brand personality
- Use negative letter-spacing (-1.2px) at display sizes for compressed, editorial headlines
- Use the extracted shadow patterns for elevation — they are tuned to match the brand palette
- Use #005c46 (`#005c46`) as the primary accent — it's the brand's signature interactive color
- Use 6.4px border-radius on buttons — the standard corner rounding for interactive elements
- Apply 20px 24px padding inside cards — matches the design system's content breathing room
- Use 16px border-radius on cards — consistent with the grid card corners
- Maintain nav height at 56px — consistent vertical space for the navigation bar
- Keep the hero centered and text-driven — no decorative media, typography carries the message
- Use a single primary CTA in the hero — the design intentionally avoids choice paralysis
- 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 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 collapse or hide the nav on scroll without an explicit scroll-triggered animation — the design uses fixed nav presence
- Don't add hero illustrations or photos — they'll break the typographic restraint
- 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(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(0, 92, 70)` for primary CTAs and brand-mark signals only"
    why: "Single chromatic assertion device — overuse dilutes meaning"
    test: "querySelectorAll('[style*=\"rgb(0, 92, 70)\"]').length <= 3 per fold"
```

## 9. Responsive Behavior

### Breakpoints
| Name | Width | Key Changes |
|------|-------|-------------|
| Mobile Large | 640px | Expanded mobile layout |
| Tablet | 1024px | Multi-column grids begin |
| Desktop | 1140px | Full feature layout |

### Token Diff — Desktop vs Mobile

| Element | Property | Desktop | Mobile |
|---------|----------|---------|--------|
| heading | font-size | `80px` | `40px` |
| heading | line-height | `80px` | `40px` |
| heading | letter-spacing | `-1.2px` | `-0.6px` |
| nav | height | `56px` | `auto` |
| button | width | `209px` | `100%` |
| card | width | `100%` | `360px` |

### Collapsing Strategy
- Headlines: 80px → 40px 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 24px 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.
- **Footer columns collapse:** 3 columns (desktop) → 1 column (mobile).

## 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://images.yazio-cdn.com/process/plain/frontend/web/general/yazio-og-image.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: 0.47:1 (portrait / vertical)
- Rendered size: 276×588px
- Alt text: "App ShowCase"
- *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): 12 (60%)
- Portrait (<0.87): 5 (25%)
- Square (0.87–1.15): 0 (0%)
- Ultra-wide (>2.3): 3 (15%)

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

**Average rendered image size:** 295×275px
**Above-fold image count:** 5 / 20

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

**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: Dark Gray (`#384250`)
- Accent: #005c46 (`#005c46`)
- Border: Dark Gray (`#384250`)
- Font: Rubik
- Body: 16px weight 400

### Example Component Prompts
- "Create a hero section on White background (#ffffff). Headline at 80px Rubik weight 800, line-height 1, letter-spacing -1.2px, color #384250."
- "Create the primary CTA button: `#005c46` background, `#ffffff` text, 6.4px border-radius, 6.56px 13.12px padding, 600 weight, Rubik font."
- "Design a card on `#ffffff` background. Border: 2px solid rgb(220, 225, 228). Radius: 16px. Shadow: none. Padding: 20px 24px."
- "Build navigation: static on `#ffffff`. Rubik 16px weight 700 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 Rubik, weight range 200–800. Never exceed 800 — heavier weights break the brand's tonal restraint.
3. **Accent**: #005c46 (`#005c46`) is the sole interactive color. On hover → #00ffc3 (`#00ffc3`). Use CSS transitions, not opacity/brightness filters.
4. **Motion**: All transitions use `cubic-bezier(0.4,0,0.2,1)`. Timing: 150ms for micro-interactions, 250ms for layout changes. Never use linear for UI transitions — preserve the brand's easing personality.
5. **Shape**: CTAs at `8px`, cards at `16px`. Apply border-radius from the extracted scale only — don't invent intermediate values.
6. **Spacing**: Use the `--ca-space-*` token scale (10px–32px). 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-on-primary: #ffffff;
  --ca-surface-1: #d3fce7;
  --ca-surface-2: #ffedac;
  --ca-hairline: #384250;
  --ca-ink-subtle: #6b7280;
  --ca-primary: #005c46;
  --ca-primary-hover: #00ffc3;
  --ca-primary-focus: #101010;
}

/* Typography */
:root {
  --ca-font-primary: "Yazio Sans", system-ui, sans-serif;
  --ca-text-display: 80px;
  --ca-text-body: 16px;
  --ca-text-caption: 64px;
  --ca-text-button: 20px;
}

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

/* Motion */
:root {
  --ca-ease-in: cubic-bezier(.4,0,1,1);
  --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: unknown
    tag: div
    height: 6716px
    width: full-bleed
    layout: block
    children: 1
  - section: header
    tag: header
    classes: ["landing-header", "fixed", "inset-x-0", "top-0"]
    height: 80px
    width: full-bleed
    layout: flex-row justify=normal
    children: 2
    padding: "20px 0px"
  - section: main-content
    tag: main
    classes: ["flex", "flex-1", "flex-col"]
    height: 5892px
    width: full-bleed
    layout: flex-column justify=normal
    children: 2
  - section: section-4
    tag: section
    height: 1472px
    width: full-bleed
    layout: block
    children: 1
  - section: navigation
    tag: div
    classes: ["absolute", "top-7", "right-0", "left-0"]
    height: 80px
    width: 1110px
    layout: flex-column justify=normal
    children: 2
    padding: "12px 15px"
  - section: section-5
    tag: section
    height: 364px
    width: full-bleed
    layout: block
    children: 1
  - section: unknown
    tag: div
    classes: ["container"]
    height: 364px
    width: 1140px
    layout: block
    children: 1
    padding: "0px 15px"
  - section: section-6
    tag: section
    classes: ["mt-2", "justify-center", "lg:mt-6", "lg:flex"]
    height: 828px
    width: full-bleed
    layout: flex-row justify=center
    children: 1
  - section: unknown
    tag: div
    classes: ["xl:cursor-default", "xl:justify-center", "xl:px-0", "cursor-grab"]
    height: 588px
    width: full-bleed
    layout: flex-row justify=center
    children: 5
  - section: section-7
    tag: section
    height: 418px
    width: full-bleed
    layout: block
    children: 1
  - section: unknown
    tag: div
    classes: ["container", "grid", "grid-flow-row", "items-center"]
    height: 418px
    width: 1140px
    layout: grid: 2-col gap=8px
    children: 2
    bg: "rgb(255, 255, 255)"
    padding: "48px 15px 20px"
  - section: section-8
    tag: section
    classes: ["py-yettie-xxl"]
    height: 685px
    width: full-bleed
    layout: block
    children: 1
    padding: "48px 0px"
  - section: unknown
    tag: div
    classes: ["container"]
    height: 589px
    width: 1140px
    layout: block
    children: 2
    padding: "0px 15px"
  - section: unknown
    tag: div
    classes: ["container"]
    height: 405px
    width: 1110px
    layout: block
    children: 1
  - section: unknown
    tag: div
    classes: ["cursor-grab", "snap-x", "snap-mandatory", "snap-always"]
    height: 298px
    width: 1110px
    layout: flex-row justify=normal
    children: 8
    padding: "0px 32px 24px"
  - section: section-9
    tag: section
    height: 642px
    width: full-bleed
    layout: block
    children: 1
  - section: unknown
    tag: div
    classes: ["container"]
    height: 370px
    width: 1140px
    layout: block
    children: 1
  - section: section-10
    tag: section
    height: 1506px
    width: full-bleed
    layout: block
    children: 1
  - section: unknown
    tag: div
    classes: ["gap-yettie-large", "container", "flex", "flex-col"]
    height: 1394px
    width: 1140px
    layout: flex-column justify=center
    children: 3
    padding: "0px 15px"
  - section: section-11
    tag: section
    height: 401px
    width: full-bleed
    layout: block
    children: 1
  - section: unknown
    tag: div
    classes: ["container", "flex", "flex-nowrap"]
    height: 233px
    width: 1140px
    layout: flex-row justify=normal
    children: 3
  - section: unknown
    tag: div
    classes: ["min-w-[83%]", "snap-start", "md:w-1/3", "md:min-w-0"]
    height: 233px
    width: 380px
    layout: block
    children: 1
    padding: "0px 15px"
  - section: unknown
    tag: div
    classes: ["min-w-[83%]", "snap-start", "md:w-1/3", "md:min-w-0"]
    height: 233px
    width: 380px
    layout: block
    children: 1
    padding: "0px 15px"
  - section: unknown
    tag: div
    classes: ["min-w-[83%]", "snap-start", "md:w-1/3", "md:min-w-0"]
    height: 233px
    width: 380px
    layout: block
    children: 1
    padding: "0px 15px"
  - section: section-12
    tag: section
    height: 712px
    width: full-bleed
    layout: block
    children: 1
```

**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:
    - "Vos objectifs à votre façon"
    - "Votre suivi tout en un : repas, activités et jeûne"
    - "+ de 100 millions de personnes font confiance à Yazio"
    - "Nous utilisons des cookies 🍪"
  sub-headings:
    - "À propos de nous"
  ctas:
    - "Témoignages"
    - "Essayez maintenant"
    - "Calcul IMC"
    - "Tout accepter
Tout refuser
Paramètres"
    - "Tout accepter
Tout refuser"
    - "Tout accepter"
    - "Tout refuser"
    - "Paramètres"
  navigation:
    - "Témoignages"
    - "Aliments"
    - "Calculateur"
    - "Aide"
    - "Calcul IMC"
    - "Calcul poids idéal"
    - "Calcul des calories journalières"
    - "Calcul calories brûlées"
  footer-links:
    - "À propos de nous"
    - "Contact"
    - "Annuler abonnement"
```

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


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

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

```yaml
assets:
  logo:
    count: 3
    avg-ratio: 3.50
    common-aspect: "~16:6 banner"
    sample-alts:
      - "YAZIO Logo"
      - "App Store"
      - "Play Store"
  hero:
    count: 1
    avg-ratio: 3.72
    common-aspect: "~16:6 banner"
    sample-alts:
      - "YAZIO Logo"
  editorial:
    count: 5
    avg-ratio: 0.47
    common-aspect: "~9:21 tall"
    sample-alts:
      - "App ShowCase"
      - "App ShowCase"
      - "App ShowCase"
  thumbnail:
    count: 3
    avg-ratio: 1.00
    common-aspect: "~1:1 square"
    sample-alts:
      - "Instagram"
      - "Facebook"
      - "TikTok"
```

**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">
  Témoignages
</button>
```
_Source pattern detected: padding `16px 24px` · radius `8px` · weight `700`_

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


## 12. Known Extraction Gaps

*Auto-detected limitations of this extraction — 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.


---
## Extraction Completeness: 80/100 (B)

| Category | Score | Max | Detail |
|----------|-------|-----|--------|
| Colors & Palette | 25 | 25 | 19 named colors |
| Typography | 18 | 20 | 7 roles defined |
| Components | 12 | 20 | 3 specs extracted |
| Motion & Interaction | 15 | 15 | Keyframes present, easing vars |
| CSS Custom Properties | 8 | 10 | 151 vars |
| Responsive Breakpoints | 3 | 5 | 3 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.

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

### Per-section confidence

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

---
*Generated by Clone Architect — automated Playwright extraction + design analysis.*
*Source: https://yazio.com | 2026-05-30T20:40:29.118Z*
*All values verified via getComputedStyle() — no approximation, no hallucination.*