revolut.com

DESIGN.md

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

---
version: alpha
name: revolut.com
description: "Light product system built on #ffffff with #4f55f1 as the primary CTA accent. Type anchored in Inter at 89.216px / weight 500. Extracted automatically from https://revolut.com/ — every value from getComputedStyle(), no approximation."
narrative: |
  revolut.com is built on a pure-white canvas (rgb(255, 255, 255)).
  The system uses #4f55f1 as the high-saturation accent for primary actions.
  Moderately rounded CTAs (12px) — modern SaaS standard, neither sharp nor pill alongside Inter as the primary typeface.

colors:
  background: "#ffffff"
  surface-1: "#ebebf0"
  surface-2: "#edeefd"
  ink: "#191c1f"
  ink-muted: "rgba(25, 28, 31, 0.65)"
  primary: "#4f55f1"
  on-primary: "#ffffff"
  primary-hover: "#494fdf"
  hairline: "#505a63"
  semantic-error: "#e23b4a"
  semantic-success: "#00b88b"
  semantic-warning: "#ec7e00"

typography:
  display-xl:
    fontFamily: "Aeonik Pro"
    fontSize: 89.216px
    fontWeight: 500
    lineHeight: 1
    letterSpacing: -2.08px
  display-md:
    fontFamily: "Aeonik Pro"
    fontSize: 18px
    fontWeight: 400
    lineHeight: 1.33
    letterSpacing: 0
  body:
    fontFamily: "Inter"
    fontSize: 16px
    fontWeight: 400
    lineHeight: normal
    letterSpacing: 0
  button:
    fontFamily: "Aeonik Pro"
    fontSize: 16px
    fontWeight: 500
    lineHeight: 1.38
    letterSpacing: 0

rounded:
  none: 0px
  xs: 12px
  sm: 12px
  md: 12px
  lg: 20px
  xl: 22.5px
  xxl: 24px
  pill: 9999px

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

components:
  button-icon-button:
    backgroundColor: "transparent"
    textColor: "{colors.hairline}"
    typography: "{typography.body}"
    rounded: "{rounded.xs}"
  button-light--invert:
    backgroundColor: "{colors.surface-1}"
    textColor: "{colors.ink-muted}"
    typography: "{typography.body}"
    rounded: "{rounded.xs}"
    padding: 8px
  button-icon-button:
    backgroundColor: "{colors.ink-muted}"
    textColor: "{colors.on-primary}"
    typography: "{typography.body}"
    rounded: "{rounded.pill}"
    padding: 0px 16px
  navigation-main-nav:
    backgroundColor: "transparent"
    typography: "{typography.body}"
    rounded: "{rounded.none}"
  tab-ghost-tab:
    backgroundColor: "transparent"
    textColor: "#f4f4f4"
    typography: "{typography.body}"
    rounded: "{rounded.none}"
    padding: 0px 20px
  tab-pill-tab:
    backgroundColor: "#f4f4f4"
    textColor: "#000000"
    typography: "{typography.body}"
    rounded: "{rounded.pill}"
    padding: 10px 26px

extracted_at: "2026-05-30T20:39:47.255Z"
completeness: 53
scoreVersion: "v2"

---

# Design System — revolut.com
> Extracted automatically by Clone Architect from https://revolut.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**: `#4f55f1` 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**: 12px 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

revolut.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 **Inter**. Negative letter-spacing at display sizes (-2.08px at 89.216px) compresses headlines into engineered blocks, dense and precise. 

Body text reads in Near Black (`#191c1f`) — softened from pure black, a small but deliberate detail that lowers reading friction. **Brand Indigo** (`#4f55f1`) provides interactive distinction without visual aggression. Shadow is absent by design — depth is conveyed through borders, spacing, and color differentiation rather than light simulation. 
Border radius varies from pill-shaped (fully rounded) to moderately rounded elements, creating visual rhythm. Motion design uses smooth easing curves for polished state transitions. 

**Key Characteristics:**
- Background: Pure White (`#ffffff`)
- Primary typeface: Inter
- Primary text: Near Black (`#191c1f`)
- Accent: Brand Indigo (`#4f55f1`)
- Display: 89.216px weight 500, letter-spacing -2.08px
- Custom fonts loaded: Inter, Aeonik Pro, Aeonik Pro Capitalised

## 2. Color Palette & Roles

### Background & Surface
- **Pure White** (`#ffffff`): Page background (primary)
- **Light Gray** (`#ebebf0`): Surface / elevated background
- **Light Gray** (`#edeefd`): Surface / elevated background
- **Warm Cream** (`#f4f4f4`): Surface / elevated background
- **Off-Cream** (`#f7f7f7`): Surface / elevated background

### Text & Content
- **Near Black** (`#191c1f`): Primary body text
- **Pure Black** (`#000000`): Secondary text

### Border & Divider
- **Translucent Silver (60%)** (`rgba(201, 201, 205, 0.6)`): Borders / dividers

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

- `#505a63` — Slate
- `#717173` — Stone
- `#8d969e` — Cool Gray
- `#f1f2f4` — Light Gray
- `#efefef` — Light Gray
- `#376cd5` — Royal Blue
- `#006400` — #006400
- `#b09000` — #b09000
- `#4f55f1` — Brand Indigo
- `#e23b4a` — Vermillion
- `#494fdf` — Royal Blue
- `#8b0000` — #8b0000
- `#e61e49` — Crimson
- `#936d62` — Stone
- `#fde5e3` — Soft Pink
- `#00a87e` — Emerald
- `#dfe3e7` — Light Gray
- `#428619` — Forest Green
- `#ec7e00` — #ec7e00
- `#007bc2` — #007bc2
- `#00b88b` — Emerald
- `#75808a` — Medium Gray
- `#6262d3` — Indigo
- `#fef6f5` — Snow
- `#ca4f12` — #ca4f12
- `#b73ccd` — #b73ccd
- `#08a4af` — #08a4af
- `#067f44` — #067f44
- `#e91f0c` — M Tricolor Red
- `#0b6ef9` — #0b6ef9
- `#7c57f4` — Brand Indigo
- `#fbc70a` — Amber
- *…+13 more in `raw-css.json` (`desktop.allColors`).*

### Gradients & Decorative Fills

- `linear-gradient(180deg,#99a2b3 -6.25%,#2c3c61 100%)` — (--website-premium-button-gradient)
- `radial-gradient(50% 50% at 50% 50%,hsl(235 98% 53%/0.15) 0%,hsl(235 98% 53%/0) 100%),radial-gradient…` — (--rui-gradient-glow)

### CSS Custom Properties (Design Tokens)

**Font Weight Token**
- `--rui-font-weight-heading1`: `800`
- `--rui-font-weight-body3`: `500`
- `--rui-font-weight-marketing-display2`: `900`
- `--rui-font-weight-emphasis4`: `700`

**Border Radius Token**
- `--rui-radius-round`: `9999px`
- `--rui-radius-widget`: `1rem`
- `--rui-radius-r2`: `0.125rem`
- `--rui-radius-r12`: `0.75rem`

**Spacing Token**
- `--rui-letter-spacing-heading3`: `calc(-0.27em / 20)`
- `--rui-letter-spacing-heading1`: `calc(-0.35em / 32)`
- `--rui-space-none`: `0`
- `--rui-letter-spacing-emphasis3`: `0`

**Font Size Token**
- `--rui-font-size-marketing-display3`: `2rem`
- `--rui-font-size-heading1`: `2rem`
- `--rui-font-size-emphasis1`: `1rem`
- `--rui-font-size-marketing-display1`: `3.5rem`

**Success**
- `--website-color-green-text`: `#006400`
- `--rui-color-green`: `#067f44`
- `--rui-color-success`: `#00b88b`

**Warning**
- `--rui-color-yellow`: `#b09000`
- `--rui-color-warning`: `#ec7e00`

**Shadow Token**
- `--rui-timing-shadow`: `200ms cubic-bezier(0.4,0.3,0.8,0.6)`
- `--rui-shadow-level3`: `0 0.1875rem 1.875rem rgb(25 28 31/0.08)`
- `--rui-shadow-level1`: `0 0.125rem 0.1875rem rgb(25 28 31/0.05)`
- `--rui-shadow-level2`: `0 0.1875rem 0.5rem rgb(25 28 31/0.1)`

**Text Color**
- `--rui-color-foreground`: `#191c1f`

**Motion Token**
- `--rui-duration-xl`: `900ms`
- `--rui-duration-sm`: `200ms`
- `--rui-easing-toast`: `cubic-bezier(0.175,0.885,0.21,1.65)`

**Error / Destructive**
- `--rui-color-danger`: `#e23b4a`
- `--website-color-red-text`: `#8b0000`
- `--rui-color-red-action-background`: `#fef6f5`
- `--rui-color-red`: `#e91f0c`

**Primary Brand Color**
- `--rui-color-accent-neutral`: `#4f55f1`
- `--rui-color-accent`: `#494fdf`

**Background**
- `--rui-color-background`: `#fff`

**Other tokens**
- `--rui-color-grey-2`: `#f1f2f4`
- `--rui-color-grey-tone-20`: `#c9c9cd`
- `--rui-color-disabled`: `#efefef`
- `--rui-color-action-label`: `#fff`
- `--website-color-grouped-background`: `#f7f7f7`
- `--rui-color-channel-action-background-neutral`: `230 240 253`
- `--rui-color-action-background`: `#edeefd`
- `--website-color-blue-text`: `#376CD5`

## 3. Typography Rules

### Font Families
- **Primary**: `Inter`
- **Secondary**: `Aeonik Pro`
- **Font 3**: `Aeonik Pro Capitalised`

### Custom Fonts Loaded
- **Inter** weight 400 (normal)
- **Inter** weight 500 (normal)
- **Inter** weight 600 (normal)
- **Inter** weight 700 (normal)
- **Aeonik Pro** weight 900 (normal)
- **Aeonik Pro** weight 500 (normal)
- **Aeonik Pro** weight 700 (normal)
- **Aeonik Pro Capitalised** weight 900 (normal)

### Typography Hierarchy

| Role | Font | Size | Weight | Line Height | Letter Spacing | Notes |
|------|------|------|--------|-------------|----------------|-------|
| Display Hero | Aeonik Pro | 89.216px | 500 | 1 | -2.08px | Main headline (h1) |
| Sub-heading | Aeonik Pro | 18px | 400 | 1.33 | normal | Third-level heading (h3) |
| Body | Inter | 16px | 400 | normal | normal | Standard reading text |
| Button Large | Aeonik Pro | 16px | 500 | 1.38 | normal | Button label (16px) |

### Font Weight Scale

CSS custom properties define 18 explicit weight steps:
- `--rui-font-weight-body3`: `500` — Medium
- `--rui-font-weight-sm-subtitle-2`: `500` — Medium
- `--rui-font-weight-body1`: `500` — Medium
- `--rui-font-weight-sm-h6`: `500` — Medium
- `--rui-font-weight-body2`: `500` — Medium
- `--rui-font-weight-emphasis4`: `700` — Bold
- `--rui-font-weight-emphasis3`: `700` — Bold
- `--rui-font-weight-subheader`: `700` — Bold
- `--rui-font-weight-emphasis1`: `700` — Bold
- `--rui-font-weight-emphasis2`: `700` — Bold
- `--rui-font-weight-heading1`: `800` — ExtraBold
- `--rui-font-weight-heading3`: `800` — ExtraBold
- `--rui-font-weight-heading2`: `800` — ExtraBold
- `--rui-font-weight-display2`: `800` — ExtraBold
- `--rui-font-weight-display1`: `800` — ExtraBold
- `--rui-font-weight-marketing-display2`: `900` — Black
- `--rui-font-weight-marketing-display1`: `900` — Black
- `--rui-font-weight-marketing-display3`: `900` — Black

### Full Font Size Scale

Sizes detected in the design (descending): `89.22px`, `52.61px`, `40px`, `32px`, `24px`, `18px`, `16px`, `14px`, `13.33px`, `12px`

> 7 size(s) detected outside the sampled hierarchy (52.608px, 40px, 32px, 24px, 14px, 13.3333px, 12px). These appear on elements not in the sampled set — likely additional display sizes, marketing-section overrides, or third-party-widget styles.

## 4. Component Stylings

### Buttons

**Icon Button**
- Background: `transparent`
- Text: `#505a63` `{colors.hairline}`
- Padding: 0px
- Radius: 12px
- Font: 16px weight 400
- Use: Toolbar/UI icons

**Light / Invert**
- Background: `#ebebf0` `{colors.surface-1}`
- Text: `#191c1f` `{colors.ink-muted}`
- Padding: 8px
- Radius: 12px
- Font: 16px weight 400
- Use: Bright CTA on dark sections

**Icon Button**
- Background: `#191c1f` `{colors.ink-muted}`
- Text: `#ffffff` `{colors.on-primary}`
- Padding: 0px 16px
- Radius: 9999px
- Font: 16px weight 400
- Use: Toolbar/UI icons

**Pill**
- Background: `transparent`
- Text: `#ffffff` `{colors.on-primary}`
- Padding: 8px 20px
- Radius: 9999px
- Font: 16px weight 500
- Use: Status pills, tags, chips

**Pill**
- Background: `#f4f4f4`
- Text: `#000000`
- Padding: 10px 26px
- Radius: 9999px
- Font: 16px weight 500
- Use: Status pills, tags, chips

**Ghost**
- Background: `transparent`
- Text: `#8d969e`
- Padding: 0px
- Radius: 12px
- Font: 12px weight 400
- Use: Subtle action, toolbar, nav button

### Navigation

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

### Tabs

**Ghost Tab**
- Background: `transparent`
- Text: `#f4f4f4`
- Padding: 0px 20px
- Radius: 0px
- Font: 16px weight 400
- Use: Navigation tabs, filter tabs

**Pill Tab**
- Background: `#f4f4f4`
- Text: `#000000`
- Padding: 10px 26px
- Radius: 9999px
- Font: 16px weight 500
- Use: Navigation tabs, filter tabs


## 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: "rgba(0, 0, 0, 0)"
      fg: "rgb(80, 90, 99)"
  link:
    default:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(255, 255, 255)"
  navLink:
    default:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(255, 255, 255)"
  tab:
    default:
      bg: "rgb(141, 150, 158)"
      fg: "rgb(0, 0, 0)"
  footerLink:
    default:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(25, 28, 31)"
```

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

### Tabs
- **2 shape(s)** in this system: `Ghost Tab`, `Pill Tab`
- **DO NOT introduce new tabs variants** without justification

## 5. Layout Principles

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

### Grid
Single column, centered content

### Max Width
100%

### Spacing System
Compact spacing — information density prioritized

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

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

### Shape Language

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

**Shape Personality**: Moderate Rounding — Medium corners (4–12px). Modern SaaS standard, neither sharp nor pill.

**Full Radius Spectrum**: 12px, 20px, 22.5px, full/pill (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** | `12px` | Card padding, list-item spacing |
| **compact** | `8px` | Form fields, tight clusters, badge padding |
| **micro** | `40px` | 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:** 359px tall (not full-viewport)
- **Heading:** "Banking & Beyond" — 89px left-aligned
- **Subheading:** "This is your bank, redefined. Get powerful daily banking and global freedom. Sign up for free in a tap."
- **CTAs:** 1 (primary: "Download the app")
- **Clone instruction:** Reproduce the **centered** layout. Use the heading font-size token at the documented size. No imagery needed for hero — text-driven.

### Card Grid Pattern

- **Card count:** 3 cards detected
- **Columns (desktop):** 1-up grid
- **Card dimensions:** 1425×900px (aspect 1.58:1)
- **Gap:** 0px between cards
- **Content:** ✓ image + CTA
- **Image position:** top
- **Clone instruction:** Build a 1-column grid (desktop) with cards at ~1.58:1 aspect ratio. Each card has an image at the top.

### Pricing Table Pattern

- **Tier count:** 5 pricing tiers
- **Layout:** side-by-side (horizontal comparison)
- **Columns (desktop):** 5-up
- **Clone instruction:** Build a 5-column side-by-side pricing comparison.

### Footer Pattern

- **Columns:** 4
- **Links:** 93 total
- **Height:** 1965px
- **Includes:** ✗ no newsletter | ✓ social icons |  ✓ copyright
- **Clone instruction:** Build a 4-column footer with ~23 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 |
|--------------|-------|---------------|
| `--rui-easing-toast` | `cubic-bezier(0.175,0.885,0.21,1.65)` | Ease Out — Decelerating |
| `--rui-easing-shadow` | `cubic-bezier(0.4,0.3,0.8,0.6)` | Custom Ease — Balanced |
| `--rui-easing-default` | `cubic-bezier(0.15,0.5,0.5,1)` | Custom Ease — Balanced |

### Duration Scale

| CSS Variable | Value | Tier |
|--------------|-------|------|
| `--rui-duration-xl` | `900ms` | Cinematic |
| `--rui-duration-sm` | `200ms` | Normal |
| `--rui-duration-skeleton` | `1500ms` | Cinematic |
| `--rui-duration-xs` | `100ms` | Fast |
| `--rui-duration-md` | `300ms` | Normal |
| `--rui-duration-lg` | `450ms` | Slow |

### Copy-Paste Transition Snippets

**Shadow**
```css
transition: box-shadow 0.2s cubic-bezier(0.4, 0.3, 0.8, 0.6);
```

**Background**
```css
transition: background-color 0.3s cubic-bezier(0.15, 0.5, 0.5, 1), color 0.3s cubic-bezier(0.15, 0.5, 0.5, 1), opacity 0.3s cubic...;
```

**Background**
```css
transition: background-color 0.2s, top 0.2s, opacity 0.3s;
```

**Color / Background**
```css
transition: color 0.3s cubic-bezier(0.15, 0.5, 0.5, 1), background-color 0.3s cubic-bezier(0.15, 0.5, 0.5, 1);
```

### Motion Fingerprint

- **Speed Character**: Cinematic & Slow (median duration: `600ms`)
- **Dominant Easing**: custom cubic-bezier curves

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

## 8. Do's and Don'ts

### Do
- Use Near Black (`#191c1f`) for text — not pure black, it's warmer and more readable
- Use Inter as the primary typeface — it defines the brand personality
- Use negative letter-spacing (-2.08px) at display sizes for compressed, editorial headlines
- Use full-pill radius (9999px) only for specific elements (avatars, pills, toggles)
- Use Brand Indigo (`#4f55f1`) as the primary accent — it's the brand's signature interactive color
- Use 12px border-radius on buttons — the standard corner rounding for interactive elements
- 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
- Place 5 pricing tiers side-by-side on desktop — direct comparison is the value prop
- Build a content-dense footer (4 columns, ~93 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 increase letter-spacing on headings — the type is designed to run tight at scale
- Don't apply pill radius on rectangular buttons or cards — it's reserved for specific interactive elements
- Don't introduce additional saturated accent colors — the palette is intentionally controlled
- Don't add hero illustrations or photos — they'll break the typographic restraint


## 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 `#4f55f1` for primary CTAs and brand-mark signals only"
    why: "Single chromatic assertion device — overuse dilutes meaning"
    test: "querySelectorAll('[style*=\"#4f55f1\"]').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 | 320px | Single column, compact spacing |
| Mobile | 400px | Single column, compact spacing |
| Mobile Large | 719px | Expanded mobile layout |
| Tablet | 1023px | Multi-column grids begin |
| Desktop | 1280px | Full feature layout |
| Ultra-wide | 1920px | Maximum content width |

### Token Diff — Desktop vs Mobile

| Element | Property | Desktop | Mobile |
|---------|----------|---------|--------|
| heading | font-size | `89.216px` | `36px` |
| heading | line-height | `89.216px` | `36px` |
| heading | letter-spacing | `-2.08px` | `normal` |

### Collapsing Strategy
- Headlines: 89.216px → 36px 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: 0px 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):

- **Pricing collapses to vertical stack** — desktop comparison becomes scrollable tier-by-tier on mobile.
- **Footer columns collapse:** 4 columns (desktop) → 1 column (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://assets.revolut.com/website/images/img-og-retail.png (1200×630px)
  *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.58:1 (landscape (16:9-ish))
- Rendered size: 2375×1500px
- *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): 10 (50%)
- Portrait (<0.87): 3 (15%)
- Square (0.87–1.15): 0 (0%)
- Ultra-wide (>2.3): 7 (35%)

**Media Format Mix:**
- PNG: 20 (logos, transparent UI elements, mockups)

**Average rendered image size:** 915×566px
**Above-fold image count:** 7 / 20

**Decorative Patterns Detected:**
- **Glassmorphism** detected (`backdrop-filter: blur`) — layered transparent surfaces with blur, modern OS-like aesthetic

**Clone instruction for decorative work:** Glassmorphism is a brand signature — use `backdrop-filter: blur(20px)` on overlapping surfaces.

**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: Near Black (`#191c1f`)
- Accent: Brand Indigo (`#4f55f1`)
- Border: Slate (`#505a63`)
- Font: Inter
- Body: 16px weight 400

### Example Component Prompts
- "Create a hero section on Pure White background (#ffffff). Headline at 89.216px Inter weight 500, line-height 1, letter-spacing -2.08px, color #191c1f."
- "Create the primary CTA button: `#4f55f1` background, `#505a63` text, 12px border-radius, 12px 24px padding, 700 weight, Inter font."
- "Build navigation: sticky on `#ffffff`. Inter 16px weight 400 for links."

### Iteration Guide
1. **Canvas**: Set the light canvas to Pure White (`#ffffff`) — every component is composited against this exact base.
2. **Typography**: All type in Inter, weight range 400–900. Never exceed 900 — heavier weights break the brand's tonal restraint.
3. **Accent**: Brand Indigo (`#4f55f1`) is the sole interactive color. On hover → Royal Blue (`#494fdf`). Use CSS transitions, not opacity/brightness filters.
4. **Motion**: All transitions use `cubic-bezier(0.4,0.3,0.8,0.6)`. Timing: 100ms for micro-interactions, 450ms for layout changes. Never use linear for UI transitions — preserve the brand's easing personality.
5. **Shape**: CTAs at `12px`. Apply border-radius from the extracted scale only — don't invent intermediate values.
6. **Spacing**: Use the `--ca-space-*` token scale (40px–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: #ebebf0;
  --ca-surface-2: #edeefd;
  --ca-ink-muted: #191c1f;
  --ca-primary: #4f55f1;
  --ca-primary-hover: #494fdf;
  --ca-hairline: #505a63;
  --ca-semantic-error: #e23b4a;
  --ca-semantic-success: #00b88b;
  --ca-semantic-warning: #ec7e00;
}

/* Typography */
:root {
  --ca-font-primary: "Aeonik Pro", system-ui, sans-serif;
  --ca-text-display: 89.216px;
  --ca-text-body: 16px;
  --ca-text-button: 16px;
}

/* Spacing & Radius */
:root {
  --ca-space-xxs: 2px;
  --ca-space-xs: 40px;
  --ca-space-sm: 8px;
  --ca-space-md: 12px;
  --ca-space-base: 16px;
  --ca-space-lg: 24px;
  --ca-space-xl: 32px;
  --ca-space-2xl: 48px;
  --ca-space-3xl: 64px;
  --ca-radius-none: 0px;
  --ca-radius-xs: 12px;
  --ca-radius-sm: 12px;
  --ca-radius-md: 12px;
  --ca-radius-lg: 20px;
  --ca-radius-xl: 22.5px;
  --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
    height: 8814px
    width: 1425px
    layout: block
    children: 4
  - section: main-content
    tag: main
    classes: ["Box-rui__sc-1g1k12l-0", "Position-rui__sc-nh2ik7-0", "Position__Relative-rui__sc-nh2ik7-3", "beawxF"]
    height: 6712px
    width: 1425px
    layout: block
    children: 8
  - section: section-3
    tag: section
    classes: ["Box-rui__sc-1g1k12l-0", "Position-rui__sc-nh2ik7-0", "Position__Relative-rui__sc-nh2ik7-3", "jlBlcU"]
    height: 900px
    width: 1425px
    layout: block
    children: 1
  - section: section-4
    tag: section
    classes: ["Box-rui__sc-1g1k12l-0", "grpyCC"]
    height: 359px
    width: 1000px
    layout: block
    children: 1
    padding: "48px 0px 24px"
  - section: section-5
    tag: section
    classes: ["Box-rui__sc-1g1k12l-0", "cQFxcA", "frTNlw"]
    height: 740px
    width: 1000px
    layout: flex-column justify=center
    children: 3
  - section: section-6
    tag: section
    classes: ["Box-rui__sc-1g1k12l-0", "cQFxcA"]
    height: 234px
    width: 1000px
    layout: block
    children: 1
  - section: section-7
    tag: section
    classes: ["Box-rui__sc-1g1k12l-0", "cQFxcA"]
    height: 169px
    width: 1000px
    layout: block
    children: 1
  - section: section-8
    tag: section
    classes: ["Box-rui__sc-1g1k12l-0", "Position-rui__sc-nh2ik7-0", "Position__Relative-rui__sc-nh2ik7-3", "kGgJZR"]
    height: 900px
    width: 1425px
    layout: flex-row justify=center
    children: 3
  - section: section-9
    tag: section
    classes: ["Box-rui__sc-1g1k12l-0", "Position-rui__sc-nh2ik7-0", "Position__Relative-rui__sc-nh2ik7-3", "kGgJZR"]
    height: 900px
    width: 1425px
    layout: flex-row justify=center
    children: 2
  - section: section-10
    tag: section
    classes: ["Box-rui__sc-1g1k12l-0", "Position-rui__sc-nh2ik7-0", "Position__Relative-rui__sc-nh2ik7-3", "kGgJZR"]
    height: 900px
    width: 1425px
    layout: flex-row justify=center
    children: 4
  - section: section-11
    tag: section
    classes: ["Box-rui__sc-1g1k12l-0", "Position-rui__sc-nh2ik7-0", "Position__Relative-rui__sc-nh2ik7-3", "kGgJZR"]
    height: 810px
    width: 1425px
    layout: flex-row justify=center
    children: 1
  - section: section-12
    tag: section
    classes: ["Box-rui__sc-1g1k12l-0", "Position-rui__sc-nh2ik7-0", "Position__Relative-rui__sc-nh2ik7-3", "kGgJZR"]
    height: 900px
    width: 1425px
    layout: flex-row justify=center
    children: 1
  - section: section-13
    tag: section
    classes: ["Box-rui__sc-1g1k12l-0", "cQFxcA", "jztmrV"]
    height: 127px
    width: 1000px
    layout: block
    children: 1
  - section: section-14
    tag: section
    classes: ["Box-rui__sc-1g1k12l-0", "cQFxcA", "jTezil"]
    height: 127px
    width: 1000px
    layout: flex-column justify=center
    children: 2
  - section: section-15
    tag: section
    classes: ["Box-rui__sc-1g1k12l-0", "iKFcoh", "dJGght"]
    height: 472px
    width: 1000px
    layout: block
    children: 1
    padding: "0px 0px 120px"
  - section: footer
    tag: footer
    classes: ["Box-rui__sc-1g1k12l-0", "cQFxcA", "exkJmb"]
    height: 1965px
    width: 1425px
    layout: flex-column justify=normal
    children: 7
    bg: "rgb(25, 28, 31)"
    padding: "40px 220px"
  - section: section-16
    tag: section
    classes: ["Box-rui__sc-1g1k12l-0", "cPFdEh"]
    height: 496px
    width: 985px
    layout: block
    children: 1
  - section: section-17
    tag: section
    classes: ["Box-rui__sc-1g1k12l-0", "iKFcoh", "dJGght"]
    height: 392px
    width: 985px
    layout: block
    children: 1
  - section: section-18
    tag: section
    classes: ["Box-rui__sc-1g1k12l-0", "iKFcoh", "dJGght"]
    height: 126px
    width: 985px
    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:
    - "Your salary, reimagined"
    - "Join 75+ million customers worldwide and 13 million in the UK"
    - "Elevate your spend"
    - "Your money’s safe space"
    - "Choose your plan"
    - "Standard"
  sub-headings:
    - "Free"
  ctas:
    - "France"
    - "Kids & Teens"
    - "Physical cards"
    - "Virtual cards"
    - "United Kingdom"
    - "Learn more and manage"
    - "Accept all"
    - "Reject non-essential cookies"
  navigation:
    - "Personal"
    - "Business"
    - "Company"
    - "Log in"
    - "Sign up"
  footer-links:
    - "Standard
Free

For the financial basics — everything you nee"
    - "Metal
£14.99/month

For the global travellers and traders — "
    - "FAQ page"
    - "International Money Transfers"
    - "International Transfers"
```

**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: 1.80
    common-aspect: "~16:9 landscape"
  thumbnail:
    count: 2
    avg-ratio: 1.00
    common-aspect: "~1:1 square"
    sample-alts:
      - "FR"
      - "GB"
```

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

**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: 53/100 (D)

| Category | Score | Max | Detail |
|----------|-------|-----|--------|
| Colors & Palette | 11 | 25 | 8 named colors |
| Typography | 10 | 20 | 4 roles defined |
| Components | 12 | 20 | 3 specs extracted |
| Motion & Interaction | 5 | 15 | No keyframes, easing vars |
| CSS Custom Properties | 10 | 10 | 300 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 |
|----------|----------------|-------------------|
| **Keyframe animations** | No @keyframes declarations found (transitions only) | Use CSS transitions for state changes; avoid complex scroll-based animations |
| **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 | 300 CSS vars (semantic naming requires ≥20 for high) |
| §3 Typography | Medium | 4 typography roles inferred |
| §4 Components | Medium | 3 component variants captured |
| §7 Motion | Medium | Transitions only |
| §8 Do's/Don'ts | High | 17 rules generated; design-decisions.json has evidence per rule |
| §9 Responsive | High | 6 breakpoints detected |
| §9b Photography | High | 20 images, hero present |

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