bmw.com

DESIGN.md

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

---
version: alpha
name: bmw.com
description: "Light product system built on #ffffff with #1c69d4 as the primary CTA accent. Type anchored in bmwTypeNextWeb at 43px / weight 300. Extracted automatically from https://bmw.com/ — every value from getComputedStyle(), no approximation."
narrative: |
  bmw.com is built on a pure-white canvas (rgb(255,255,255)).
  The system uses #1c69d4 as the high-saturation accent for primary actions.
  Sharp 0px corners on CTAs — architectural restraint, engineering precision alongside bmwTypeNextWeb as the primary typeface.

colors:
  background: "#ffffff"
  surface-1: "rgba(221, 232, 249, 0.5)"
  surface-2: "#f2f2f2"
  ink: "#262626"
  primary: "#1c69d4"
  on-primary: "#ffffff"
  primary-hover: "#1c69d4"
  hairline: "#666666"
  semantic-error: "#d20000"
  semantic-success: "#3db014"
  semantic-warning: "#ffad1f"

typography:
  display-xl:
    fontFamily: "bmwTypeNextWeb"
    fontSize: 43px
    fontWeight: 300
    lineHeight: 1.4
    letterSpacing: 0
  display-md:
    fontFamily: "bmwTypeNextWeb"
    fontSize: 23px
    fontWeight: 300
    lineHeight: 1.57
    letterSpacing: 0
  body:
    fontFamily: "bmwTypeNextWeb"
    fontSize: 15px
    fontWeight: 300
    lineHeight: 1.6
    letterSpacing: 0
  button:
    fontFamily: "bmwTypeNextWeb"
    fontSize: 20px
    fontWeight: 300
    lineHeight: 1.5
    letterSpacing: 0

rounded:
  none: 0px
  xs: 3px
  sm: 3px
  md: 3px
  lg: 3px
  xl: 3px
  xxl: 24px
  pill: 9999px

spacing:
  xxs: 2px
  xs: 6px
  sm: 8px
  md: 12px
  lg: 24px
  xl: 40px
  xxl: 64px
  section: 80px

components:
  button-light--invert:
    backgroundColor: "#efefef"
    textColor: "#000000"
    typography: "{typography.body}"
    rounded: "{rounded.none}"
    padding: 1px 6px
  button-ghost:
    backgroundColor: "transparent"
    textColor: "{colors.on-primary}"
    typography: "{typography.body}"
    rounded: "{rounded.none}"
    padding: 0px 12px
  button-light--invert:
    backgroundColor: "{colors.on-primary}"
    textColor: "{colors.ink}"
    typography: "{typography.body}"
    rounded: "{rounded.none}"
  navigation-main-nav:
    backgroundColor: "transparent"
    typography: "{typography.body}"
    rounded: "{rounded.none}"

extracted_at: "2026-05-30T20:38:36.165Z"
completeness: 67
scoreVersion: "v2"

---

# Design System — bmw.com
> Extracted automatically by Clone Architect from https://bmw.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**: `#1c69d4` for primary CTAs ONLY. Never decorative.
> - **Body type**: 15px (token: `typography.body`). Default for ALL text not in a heading role.
> - **Section rhythm**: 96px between major bands. Card padding: 24px.
> - **Default radius**: 3px 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

bmw.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 **bmwTypeNextWeb**. Headlines run at a remarkably light weight (300) — restraint over assertion, creating an editorial calm that invites reading rather than demanding it. 

Body text reads in Warm Brown (`#262626`) — softened from pure black, a small but deliberate detail that lowers reading friction. **Link Cta** (`#1c69d4`) 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: Pure White (`#ffffff`)
- Primary typeface: bmwTypeNextWeb
- Primary text: Warm Brown (`#262626`)
- Accent: Link Cta (`#1c69d4`)
- Display: 43px weight 300
- Shadow system: 5 distinct elevation levels
- Custom fonts loaded: bmwTypeNextWeb

## 2. Color Palette & Roles

### Background & Surface
- **Pure White** (`#ffffff`): Page background (primary)
- **Surface Background Primary** (`#f6f6f6`): Surface / elevated background (CSS var)
- **Translucent Light Gray (50%)** (`rgba(221, 232, 249, 0.5)`): Surface / elevated background
- **Light Gray** (`#f2f2f2`): Surface / elevated background
- **Light Gray** (`#e6e6e6`): Surface / elevated background

### Text & Content
- **Warm Brown** (`#262626`): Primary body text
- **Pure Black** (`#000000`): Secondary text
- **#0000ee** (`#0000ee`): Secondary text

### Accent & Interactive
- **Link Cta** (`#1c69d4`): Interactive / accent
- **#009640** (`#009640`): Interactive / accent
- **#4eae32** (`#4eae32`): Interactive / accent
- **#c7d301** (`#c7d301`): Interactive / accent
- **Gold** (`#ffed00`): Interactive / accent
- **Amber** (`#fbb900`): Interactive / accent
- **Bright Orange** (`#ec6607`): Interactive / accent

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

- `#e30613` — Red
- `#efefef` — Light Gray
- `#666666` — Dim Gray
- `#8e8e8e` — Medium Gray
- `#3db014` — Success
- `#e8f2eb` — Light Gray
- `#d20000` — Error
- `#ffad1f` — Warning
- `#fbedc9` — Vibrant Yellow
- `#4d4d4d` — Dark Gray
- `#0653b6` — Link Active
- `#bbd2f3` — Light Blue
- `#f7e7e9` — Light Gray

### Gradients & Decorative Fills

- `linear-gradient(0,#0000,#0006)` — (--navigation-gradient)

### CSS Custom Properties (Design Tokens)

**Font Size Token**
- `--headline-2-font-size`: `2.1875rem`
- `--stage-zone-1-large-font-size`: `3rem`
- `--body-3-font-size`: `.75rem`
- `--label-1-font-size`: `.75rem`

**Font Weight Token**
- `--default-font-weight`: `300`
- `--input-font-weight`: `400`
- `--price-font-weight`: `700`
- `--link-font-weight`: `500`

**Spacing Token**
- `--iconization-1-letter-spacing`: `.6em`
- `--grid-addtional-spacing`: `4rem`

**Other tokens**
- `--input-text-hover`: `#262626`
- `--ol-light-text-disabled`: `#8e8e8e`
- `--input-placeholder-color`: `#666`
- `--ol-text-disabled`: `#bbb`
- `--compare-dropdown-label-color`: `#666`
- `--cta-text-hover`: `#fff`
- `--cta-text`: `#fff`
- `--swiper-theme-color`: `$gs0`

## 3. Typography Rules

### Font Families
- **Primary**: `bmwTypeNextWeb`
- **Secondary**: `bmw_next_icons`

### Custom Fonts Loaded
- **bmwTypeNextWeb** weight 300 (normal)
- **bmwTypeNextWeb** weight 400 (normal)
- **bmwTypeNextWeb** weight 500 (normal)
- **bmwTypeNextWeb** weight 700 (normal)
- **bmw_next_icons** weight 300 (normal)
- **bmw_next_icons** weight 400 (normal)

### Typography Hierarchy

| Role | Font | Size | Weight | Line Height | Letter Spacing | Notes |
|------|------|------|--------|-------------|----------------|-------|
| Display Hero | bmwTypeNextWeb | 43px | 300 | 1.4 | normal | Main headline (h1) |
| Sub-heading | bmwTypeNextWeb | 23px | 300 | 1.57 | normal | Third-level heading (h3) |
| Button Large | bmwTypeNextWeb | 20px | 300 | 1.5 | normal | Button label (20px) |
| Body | bmwTypeNextWeb | 15px | 300 | 1.6 | normal | Standard reading text |
| Button | bmwTypeNextWeb | 15px | 500 | 1.15 | normal | Button label (15px) |

### Font Weight Scale

CSS custom properties define 5 explicit weight steps:
- `--default-font-weight`: `300` — Light
- `--input-font-weight`: `400` — Regular
- `--link-font-weight`: `500` — Medium
- `--clickable-font-weight`: `500` — Medium
- `--price-font-weight`: `700` — Bold

### Full Font Size Scale

Sizes detected in the design (descending): `48px`, `43px`, `35px`, `24px`, `23px`, `20px`, `18px`, `17.25px`, `16px`, `15px`, `14px`, `13.50px`, `12px`, `9px`

> 10 size(s) detected outside the sampled hierarchy (48px, 35px, 24px, 18px, 17.25px, 16px, 14px, 13.5px, 12px, 9px). 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:

- **ligatures** — common letter pairs replaced with refined glyphs (fi, fl, etc.)

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

## 4. Component Stylings

### Buttons

**Light / Invert**
- Background: `#efefef`
- Text: `#000000`
- Padding: 1px 6px
- Radius: 0px
- Border: 2px outset rgb(0, 0, 0)
- Font: 15px weight 500
- Use: Bright CTA on dark sections

**Ghost**
- Background: `transparent`
- Text: `#ffffff` `{colors.on-primary}`
- Padding: 0px 12px
- Radius: 0px
- Font: 15px weight 500
- Use: Subtle action, toolbar, nav button

**Light / Invert**
- Background: `#ffffff` `{colors.on-primary}`
- Text: `#262626` `{colors.ink}`
- Padding: 0px
- Radius: 50%
- Shadow: `rgba(0, 0, 0, 0.16) 0px 6px 20px 0px, rgba(0, 0, 0, 0.24) 0px 0px 1px 0px`
- Font: 15px weight 500
- Use: Bright CTA on dark sections

**Subtle**
- Background: `rgba(221, 232, 249, 0.5)` `{colors.surface-1}`
- Text: `#262626` `{colors.ink}`
- Padding: 12px 20px
- Radius: 3px
- Font: 15px weight 500
- Use: Quiet action against page bg

**Light / Invert**
- Background: `#ffffff` `{colors.on-primary}`
- Text: `#262626` `{colors.ink}`
- Padding: 12px 20px
- Radius: 3px
- Font: 15px weight 300
- Use: Bright CTA on dark sections

**Primary Brand**
- Background: `#1c69d4` `{colors.primary-hover}`
- Text: `#ffffff` `{colors.on-primary}`
- Padding: 4px
- Radius: 3px
- Font: 15px weight 500
- Use: Primary CTA / brand action

**Ghost**
- Background: `transparent`
- Text: `#f2f2f2` `{colors.surface-2}`
- Padding: 4px
- Radius: 3px
- Shadow: `rgb(242, 242, 242) 0px 0px 0px 1px inset`
- Font: 15px weight 500
- Use: Subtle action, toolbar, nav button

### Navigation

**Main Nav**
- Background: `transparent`
- Padding: 0px
- Radius: none
- Font: 15px weight 300
- Use: Static flex nav — N/A items


## 4b. Component Behaviors (State Matrix)

### Interaction State Narrative

- **FooterLink**:
  - **hover:** text #262626 → #1c69d4, border changes

*State transitions extracted via Playwright simulation — exact values in the YAML matrix below.*

```yaml
component-behaviors:
  button:
    default:
      bg: "rgb(239, 239, 239)"
      fg: "rgb(0, 0, 0)"
      border: "2px outset rgb(0, 0, 0)"
  link:
    default:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(0, 0, 238)"
  navLink:
    default:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(0, 0, 238)"
  footerLink:
    default:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(38, 38, 38)"
    hover:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(28, 105, 212)"
```

**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: `Light / Invert`, `Ghost`, `Light / Invert`, `Subtle`, `Light / Invert`
- **DO NOT introduce new buttons variants** without justification

### Navigation
- **1 shape(s)** in this system: `Main Nav`
- **DO NOT introduce new navigation variants** without justification

## 5. Layout Principles

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

### Grid
Single column, centered content

### Max Width
calc(100vw - 0px - 6rem*2)

### Spacing System
Compact spacing — information density prioritized

| Token | Value |
|-------|-------|
| xxs | 2px |
| xs | 6px |
| sm | 8px |
| md | 12px |
| base | 16px |
| lg | 24px |
| xl | 40px |
| 2xl | 96px |
| 3xl | 64px |

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

### Shape Language

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

**Shape Personality**: Sharp & Angular — No rounding. Precise, editorial, enterprise feel.

**Full Radius Spectrum**: 0px, 3px, 8px, 10px (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** | `40px` | Between major bands (color change, content shift) |
| **subsection** | `24px` | Within a section, between content groups |
| **card** | `12px` | Card padding, list-item spacing |
| **compact** | `8px` | Form fields, tight clusters, badge padding |
| **micro** | `6px` | Icon-text gap, tag inner padding |

**Agent rule**: NEVER hardcode raw pixel values for spacing in generated UI. Always reference these named tokens (`spacing-rhythm.section`, etc.).

## 5c. Widget & Structure Library

Structural patterns extracted from the page DOM — these are the **blueprints** an agent should follow to reproduce the page architecture (not just CSS values).

**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:** full-viewport hero (≥70% screen height)
- **Heading:** "Bienvenue sur le site officiel BMW France - Le plaisir de conduire." — 43px left-aligned
- **Subheading:** "Jusqu’au 31 Mai 2026, profitez d’un crédit à un taux exceptionnel de 2,90%, sur une sélection de BMW d'occasion.3"
- **Media:** present, positioned top
- **CTAs:** 8 (primary: "Découvrez-la")
- **Clone instruction:** Reproduce the **centered** layout. Use the heading font-size token at the documented size. Place media top of text.

### Navigation Pattern

- **Position:** static (scrolls with page)
- **Layout:** logo-left-links-left — Logo and links both on the left (CTAs typically right)
- **Height:** 84px
- **Logo:** ✓ present
- **Nav links:** 2 primary items
- **CTAs in nav:** 0 (no buttons — links only)
- **Clone instruction:** Build a static logo left links left navigation. Link-only — no button styling needed.

### Card Grid Pattern

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

### Footer Pattern

- **Columns:** 6
- **Links:** 68 total
- **Height:** 1399px
- **Includes:** ✗ no newsletter | ✓ social icons |  ✓ copyright
- **Clone instruction:** Build a 6-column footer with ~11 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.16) 0px 5px 40px 0px` | Cards, elevated surfaces |
| Layered (Level 2) | <br>`rgba(0, 0, 0, 0.16) 0px 6px 20px 0px`,<br>`rgba(0, 0, 0, 0.24) 0px 0px 1px 0px` | Cards, elevated surfaces |
| Layered (Level 3) | <br>`rgba(0, 0, 0, 0.5) 0px -1px 8px 0px` | Cards, elevated surfaces |
| Inset (Level 4) | <br>`rgb(242, 242, 242) 0px 0px 0px 1px 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

### Dominant Easing Curves

| Curve | Semantic Name |
|-------|---------------|
| `ease` | CSS ease — Default |
| `ease-in-out` | Ease In-Out — Symmetric |
| `ease-in` | Ease In — Accelerating |

### Duration Scale

| Value | Tier | Typical Use |
|-------|------|-------------|
| `50ms` | Instant | State toggles, instant feedback |
| `150ms` | Fast | Hover states, micro-interactions |
| `200ms` | Normal | Panel open/close, navigation |
| `250ms` | Normal | Panel open/close, navigation |
| `500ms` | Slow | Hero animations, page transitions |

### Copy-Paste Transition Snippets

**Background**
```css
transition: background 0.05s ease-in-out;
```

**Transform**
```css
transition: transform 0.25s ease-in-out;
```

**All Props**
```css
transition: left 0.15s cubic-bezier(0, 0.5, 0.5, 1);
```

**Transform**
```css
transition: transform 0.25s cubic-bezier(0.5, 0, 0.5, 1) 0.5s, opacity 0.15s cubic-bezier(0.5, 0, 1, 0.5);
```

### Keyframe Animation Catalog

| Animation Name | Type | Animated Props | Use Hint |
|----------------|------|----------------|----------|
| `fade-in` | Color Pulse | background-color | Element entrance |
| `spin` | Rotate / Spin | transform | Loading indicator |
| `grow` | Custom | height, width | UI transition |
| `cmp-search__loading-indicator-spin` | Rotate / Spin | transform | Loading indicator |
| `grow-up` | Scale | transform | UI transition |
| `label-fade-in` | Fade | opacity | Element entrance |
| `label-arrows-left-fade-out` | Fade + Move | opacity, transform | Element exit |
| `label-arrows-right-fade-out` | Fade + Move | opacity, transform | Element exit |
| `pulse-single` | Fade + Move | opacity, transform | Attention / status |
| `pulse-double` | Fade + Move | opacity, transform | Attention / status |
| `grow-icon` | Custom | height, width | UI transition |
| `fade-icon` | Fade | opacity | UI transition |
| `spin-icon` | Rotate / Spin | transform | Loading indicator |
| `effect-grow` | Fade + Move | opacity, transform | UI transition |
| `effect-shrink` | Fade + Move | opacity, transform | UI transition |
| `effect-enter` | Fade + Move | opacity, transform | Element entrance |
| `effect-exit` | Fade + Move | opacity, transform | Element exit |
| `fade-in-out` | Fade | opacity, translate | Element entrance |
| `scroll` | Slide | transform | UI transition |
| `popover-backdrop-fade-in` | Fade | opacity | Element entrance |

> *38 additional animations omitted (repetitive variants). See raw keyframes in `raw-css.json`.*

### Motion Fingerprint

- **Speed Character**: Balanced Pacing (median duration: `200ms`)
- **Dominant Easing**: custom cubic-bezier curves
- **Animation Library**: 58 unique animations (58 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 Warm Brown (`#262626`) for text — not pure black, it's warmer and more readable
- Use bmwTypeNextWeb as the primary typeface — it defines the brand personality
- Use the extracted shadow patterns for elevation — they are tuned to match the brand palette
- Use Link Cta (`#1c69d4`) as the primary accent — it's the brand's signature interactive color
- Use small 3px radius for buttons — this design system uses subtle rounding, not pill shapes
- Maintain nav height at 84px — consistent vertical space for the navigation bar
- Make the hero full-viewport (≥70% screen height) — this design uses an immersive hero, not a tall navbar
- Include exactly 8 CTAs in the hero (primary + secondary) — this design pattern is multi-action, not single-purpose
- Use a 3-column grid on desktop — density matters for this content type
- Build a content-dense footer (6 columns, ~68 links) — this site treats the footer as a sitemap, not an afterthought

### 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 invent new shadow values — use only the extracted shadow levels
- Don't introduce additional saturated accent colors — the palette is intentionally controlled
- Don't over-round buttons with pill or large radius — the system uses restrained, sharp-ish corners
- 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(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 `#1c69d4` for primary CTAs and brand-mark signals only"
    why: "Single chromatic assertion device — overuse dilutes meaning"
    test: "querySelectorAll('[style*=\"#1c69d4\"]').length <= 3 per fold"
```

## 9. Responsive Behavior

### Breakpoints
| Name | Width | Key Changes |
|------|-------|-------------|
| Mobile | 480px | Single column, compact spacing |
| Mobile Large | 599px | Expanded mobile layout |
| Mobile Large | 767px | Expanded mobile layout |
| Tablet | 992px | Multi-column grids begin |
| Tablet | 1023px | Multi-column grids begin |
| Desktop | 1279px | Full feature layout |

### Token Diff — Desktop vs Mobile

| Element | Property | Desktop | Mobile |
|---------|----------|---------|--------|
| heading | font-size | `43px` | `33px` |
| heading | line-height | `60px` | `46px` |
| body | font-size | `15px` | `14px` |
| body | line-height | `24px` | `22px` |
| nav | padding | `0px 96px` | `0px 24px` |
| nav | height | `84px` | `68px` |
| button | font-size | `15px` | `14px` |
| sidebar | width | `314px` | `300px` |

### Collapsing Strategy
- Headlines: 43px → 33px 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: 1px 6px padding
- Navigation: adequate spacing between items
- Interactive elements: minimum 44px touch target recommended

### Collapsing Narrative

How the structural patterns adapt from desktop to mobile (extracted from both viewport extractions):

- **Hero CTAs:** 8 on desktop → 3 on mobile (secondary CTAs dropped on small screens).
- **Navigation collapses to hamburger** — 2 links visible on desktop, 0 on mobile (the rest hide behind a menu toggle).
- **Card grid: 3-up → 1-up** — cards stack as viewport narrows, becoming a vertical list on mobile.
- **Footer columns collapse:** 6 columns (desktop) → 4 columns (mobile).

## 9b. Visual Tone & Photography

**Tone:** Mixed photography + illustration

A balanced mix of photographic content and vector graphics. Photos likely carry product/lifestyle context while SVG handles icons, logos, and decorative accents.

**Canonical Brand Image (OG):**
- https://www.bmw.fr
  *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: 2.29:1 (landscape (16:9-ish))
- Rendered size: 1440×630px
- Alt text: "BMW X1 M Sport"
- *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): 1 (20%)
- Portrait (<0.87): 0 (0%)
- Square (0.87–1.15): 1 (20%)
- Ultra-wide (>2.3): 3 (60%)

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

**Average rendered image size:** 1162×424px
**Above-fold image count:** 2 / 5

**Decorative Patterns Detected:**
- 4 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:**
- Mix photography and illustration intentionally: photos for product/context, vectors for icons + decorative accents.
- Respect the format split — replacing JPGs with illustrations (or vice versa) will shift the brand tone.

## 10. Agent Prompt Guide

### Quick Reference
- Background: Pure White (`#ffffff`)
- Primary text: Warm Brown (`#262626`)
- Accent: Link Cta (`#1c69d4`)
- Border: Dim Gray (`#666666`)
- Font: bmwTypeNextWeb
- Body: 15px weight 300

### Example Component Prompts
- "Create a hero section on Pure White background (#ffffff). Headline at 43px bmwTypeNextWeb weight 300, line-height 1.4, color #262626."
- "Create the primary CTA button: `#1c69d4` background, `#ffffff` text, 3px border-radius, 4px padding, 500 weight, bmwTypeNextWeb font."
- "Build navigation: relative on `#ffffff`. bmwTypeNextWeb 15px weight 300 for links."

### Iteration Guide
1. **Canvas**: Set the light canvas to Pure White (`#ffffff`) — every component is composited against this exact base.
2. **Typography**: All type in bmwTypeNextWeb, weight range 300–700. Never exceed 700 — heavier weights break the brand's tonal restraint.
3. **Accent**: Link Cta (`#1c69d4`) is the sole interactive color. On hover → Link Cta (`#1c69d4`). Use CSS transitions, not opacity/brightness filters.
4. **Motion**: All transitions use `cubic-bezier(0,0.5,0.5,1)`. Never use linear for UI transitions — preserve the brand's easing personality.
5. **Shape**: CTAs at `0px`. Apply border-radius from the extracted scale only — don't invent intermediate values.
6. **Spacing**: Use the `--ca-space-*` token scale (6px–40px). 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: #dde8f9;
  --ca-surface-2: #f2f2f2;
  --ca-ink: #262626;
  --ca-primary-hover: #1c69d4;
  --ca-hairline: #666666;
  --ca-semantic-error: #d20000;
  --ca-semantic-success: #3db014;
  --ca-semantic-warning: #ffad1f;
}

/* Typography */
:root {
  --ca-font-primary: "bmwTypeNextWeb", system-ui, sans-serif;
  --ca-text-display: 43px;
  --ca-text-body: 15px;
  --ca-text-button: 20px;
}

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


## 13. Page Structure Skeleton

*The actual layout the source site uses. Reproduce these sections in order to match the site structure.*

```yaml
page-skeleton:
  - section: unknown
    tag: div
    classes: ["root", "container", "responsivegrid", "style-container--disable-hscroll"]
    height: 2934px
    width: full-bleed
    layout: block
    children: 1
  - section: navigation
    tag: nav
    height: 84px
    width: full-bleed
    layout: flex-row justify=normal
    children: 3
    padding: "0px 96px"
  - section: main-content
    tag: main
    height: 2934px
    width: 1272px
    layout: block
    children: 1
  - section: unknown
    tag: div
    height: 2934px
    width: full-bleed
    layout: block
    children: 1
  - section: unknown
    tag: div
    classes: ["container", "responsivegrid", "style-container--fixed"]
    height: 2934px
    width: 1272px
    layout: block
    children: 1
  - section: unknown
    tag: div
    classes: ["container", "responsivegrid", "aem-GridColumn--default--12"]
    height: 630px
    width: 1272px
    layout: block
    children: 1
  - section: unknown
    tag: div
    height: 630px
    width: 1272px
    layout: block
    children: 1
  - section: unknown
    tag: div
    height: 630px
    width: 1248px
    layout: block
    children: 1
  - section: unknown
    tag: div
    height: 630px
    width: full-bleed
    layout: block
    children: 3
  - section: unknown
    tag: div
    classes: ["container", "responsivegrid", "style-container--start", "aem-GridColumn--small--none"]
    height: 220px
    width: 624px
    layout: block
    children: 1
  - section: unknown
    tag: div
    height: 220px
    width: 624px
    layout: block
    children: 1
  - section: unknown
    tag: div
    classes: ["container", "responsivegrid", "aem-GridColumn--xlarge--7", "aem-GridColumn--medium--none"]
    height: 136px
    width: 624px
    layout: block
    children: 1
  - section: unknown
    tag: div
    height: 136px
    width: 624px
    layout: block
    children: 1
  - section: sidebar
    tag: div
    height: 260px
    width: 314px
    layout: flex-column-reverse justify=normal
    children: 2
  - section: unknown
    tag: div
    classes: ["container", "responsivegrid", "style-common--cmp-spacing-top-12", "aem-GridColumn--default--12"]
    height: 340px
    width: 1272px
    layout: block
    children: 1
  - section: unknown
    tag: div
    height: 340px
    width: 1272px
    layout: block
    children: 1
  - section: unknown
    tag: div
    height: 340px
    width: 1272px
    layout: block
    children: 1
  - section: unknown
    tag: div
    classes: ["container", "responsivegrid", "style-common--cmp-spacing-top-12", "aem-GridColumn--default--12"]
    height: 300px
    width: 1272px
    layout: block
    children: 1
  - section: unknown
    tag: div
    height: 300px
    width: 1272px
    layout: block
    children: 1
  - section: unknown
    tag: div
    classes: ["container", "responsivegrid", "aem-GridColumn--default--12"]
    height: 210px
    width: 1272px
    layout: block
    children: 1
  - section: unknown
    tag: div
    height: 210px
    width: 1272px
    layout: block
    children: 1
  - section: unknown
    tag: div
    classes: ["container", "responsivegrid", "aem-GridColumn--small--none", "aem-GridColumn--medium--none"]
    height: 206px
    width: 636px
    layout: block
    children: 1
  - section: unknown
    tag: div
    height: 206px
    width: 636px
    layout: block
    children: 1
  - section: unknown
    tag: div
    classes: ["container", "responsivegrid", "aem-GridColumn--small--none", "aem-GridColumn--medium--none"]
    height: 206px
    width: 318px
    layout: block
    children: 1
  - section: unknown
    tag: div
    height: 206px
    width: 318px
    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:
    - "BMW X1 M Sport."
    - "Trouvez votre BMW."
    - "Nouvelle BMW 7."
    - "Jusqu’au 31 Mai 2026, profitez d’un crédit à un taux exceptionnel de 2,90%, sur une sélection de BMW"
  sub-headings:
    - "440 €/mois sans apport.1
Entretien inclus."
    - "BMW Neuves."
    - "Contact et informations"
  ctas:
    - "Gamme électrique"
    - "Découvrez-la"
    - "Demandez une offre"
    - "Trouvez votre BMW"
    - "Découvrez les modèles disponibles"
    - "Configuration & Prix"
  navigation:
    - "Skip to main content"
    - "Modèles & Configurateur"
    - "Offres exclusives"
    - "L’électrique par BMW"
    - "Véhicules électriques BMW d’occasion"
    - "Les avantages de l’électrique"
    - "Le coût"
    - "L’Hybride Rechargeable par BMW"
    - "La recharge à domicile"
    - "La recharge publique"
  footer-links:
    - "Inscrivez-vous"
    - "Service à la clientèle"
```

**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: 1
    avg-ratio: 1.60
    common-aspect: "~16:9 landscape"
  hero:
    count: 4
    avg-ratio: 2.82
    common-aspect: "~16:6 banner"
    sample-alts:
      - "BMW X1 M Sport"
      - "Vidéo de conduite dynamique présentant le véhicule sous tous"
      - "A BMW i3 Sedan is driving on a curvy serpentine road through"
  thumbnail:
    count: 5
    avg-ratio: 1.00
    common-aspect: "~1:1 square"
    sample-alts:
      - "Facebook"
      - "Instagram"
```

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

**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: 67/100 (C)

| Category | Score | Max | Detail |
|----------|-------|-----|--------|
| Colors & Palette | 21 | 25 | 15 named colors |
| Typography | 13 | 20 | 5 roles defined |
| Components | 8 | 20 | 2 specs extracted |
| Motion & Interaction | 12 | 15 | Keyframes present |
| CSS Custom Properties | 8 | 10 | 167 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.

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

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