x.ai

DESIGN.md

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

---
version: alpha
name: x.ai
description: "Light product system built on #ffffff with #46954a as the primary CTA accent. Type anchored in universalSans at 60px / weight 500. Extracted automatically from https://x.ai/ — every value from getComputedStyle(), no approximation."
narrative: |
  x.ai is built on a pure-white canvas (rgb(255, 255, 255)).
  The system uses #46954a as the singular interactive color.
  Fully-rounded CTAs (9999px) signal a friendly, tactile interaction model alongside universalSans as the primary typeface.

colors:
  background: "#ffffff"
  surface-1: "rgba(255, 255, 255, 0.85)"
  surface-2: "rgba(255, 255, 255, 0.2)"
  ink: "#0a0a0a"
  ink-muted: "rgba(10, 10, 10, 0.65)"
  ink-subtle: "#0a0a0a"
  primary: "#46954a"
  on-primary: "#ffffff"
  primary-hover: "#cf222e"
  hairline: "#d5d9e2"

typography:
  display-xl:
    fontFamily: "universalSansDisplay"
    fontSize: 60px
    fontWeight: 500
    lineHeight: 1
    letterSpacing: -1.5px
  display-md:
    fontFamily: "universalSans"
    fontSize: 14px
    fontWeight: 500
    lineHeight: 1.38
    letterSpacing: -0.35px
  body:
    fontFamily: "universalSans"
    fontSize: 16px
    fontWeight: 400
    lineHeight: 1.5
    letterSpacing: 0

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

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

components:
  button-icon-button:
    backgroundColor: "transparent"
    textColor: "{colors.on-primary}"
    typography: "{typography.body}"
    rounded: "{rounded.none}"
    padding: 0px 12px 0px 8px
  button-pill:
    backgroundColor: "transparent"
    textColor: "{colors.ink-subtle}"
    typography: "{typography.display-md}"
    rounded: "{rounded.pill}"
    padding: 8px 16px
  button-pill:
    backgroundColor: "transparent"
    textColor: "{colors.on-primary}"
    typography: "{typography.display-md}"
    rounded: "{rounded.pill}"
    padding: 8px 12px 8px 16px
  card-standard-card:
    backgroundColor: "#f9f8f6"
    typography: "{typography.body}"
    rounded: "{rounded.md}"
  navigation-main-nav:
    backgroundColor: "transparent"
    typography: "{typography.body}"
    rounded: "{rounded.none}"
  code-block-inline-code--pre:
    backgroundColor: "transparent"
    textColor: "#e1e4e8"
    typography: "{typography.display-md}"
    rounded: "{rounded.none}"
    padding: 12px 0px

extracted_at: "2026-05-30T20:40:27.454Z"
completeness: 74
scoreVersion: "v2"

---

# Design System — x.ai
> Extracted automatically by Clone Architect from https://x.ai
> 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**: `#46954a` 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

x.ai 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 **universalSans**. Negative letter-spacing at display sizes (-1.5px at 60px) compresses headlines into engineered blocks, dense and precise. 

Body text reads in Jet Black (`#0a0a0a`) — softened from pure black, a small but deliberate detail that lowers reading friction (contrast ratio 25.5:1, well above WCAG AA). **Success Green** (`#46954a`) 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. 
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: GeistMono
- Primary text: Jet Black (`#0a0a0a`)
- Accent: Success Green (`#46954a`)
- Display: 60px weight 500, letter-spacing -1.5px
- Shadow system: 4 distinct elevation levels
- Custom fonts loaded: GeistMono, universalSans, universalSans Fallback, universalSansDisplay, universalSansDisplay Fallback

## 2. Color Palette & Roles

### Background & Surface
- **Pure White** (`#ffffff`): Page background (primary)
- **#d5d9e2** (`#d5d9e2`): Surface / elevated background
- **Off-Cream** (`#f9f8f6`): Surface / elevated background
- **Light Gray** (`#f3eee7`): Surface / elevated background
- **Light Gray** (`#f2ede5`): Surface / elevated background

### Text & Content
- **Jet Black** (`#0a0a0a`): Primary body text
- **Pure Black** (`#000000`): Secondary text
- **Warm Brown** (`#1f2228`): Secondary text
- **Jet Black** (`#151515`): Secondary text
- **Warm Brown** (`#2a2825`): Secondary text

### Accent & Interactive
- **Bright Orange** (`#ff6308`): Interactive / accent
- **#ff5f57** (`#ff5f57`): Interactive / accent
- **#febc2e** (`#febc2e`): Interactive / accent
- **#28c840** (`#28c840`): Interactive / accent
- **#88a6ff** (`#88a6ff`): Interactive / accent
- **#91c17a** (`#91c17a`): Interactive / accent
- **#bc97ff** (`#bc97ff`): Interactive / accent

### Border & Divider
- **Silver** (`#d7d1c9`): Borders / dividers
- **Light Gray** (`#e1e1e1`): Borders / dividers
- **Light Gray** (`#e1e4e8`): Borders / dividers

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

- `#7d8187` — Medium Gray
- `#8d867e` — Medium Gray
- `#59534d` — Slate
- `#6c6c6c` — Dim Gray
- `#9ece6a` — #9ece6a
- `#202a16` — Warm Brown
- `#f7768e` — #f7768e
- `#32181c` — Warm Brown
- `#93adff` — Sage
- `#29c6be` — #29c6be
- `#121212` — Jet Black
- `#f97583` — #f97583
- `#ffab70` — Tangerine
- `#9ecbff` — Baby Blue
- `#79b8ff` — Baby Blue
- `#999999` — Cool Gray
- `#1a1a1a` — Near Black
- `#2e3033` — Charcoal
- `#202020` — Near Black
- `#5c5c5c` — Dim Gray
- `#a4cb92` — #a4cb92
- `#cfb47c` — #cfb47c
- `#d59556` — #d59556
- `#d7766c` — Warm Terracotta
- `#46954a` — Success Green
- `#cf222e` — Crimson

### CSS Custom Properties (Design Tokens)

**Shadow Token**
- `--tw-ring-offset-shadow`: `0 0 #0000`
- `--tw-ring-shadow`: `0 0 #0000`
- `--tw-drop-shadow`: ``
- `--tw-shadow`: `0 0 #0000`

**Spacing Token**
- `--tw-numeric-spacing`: ``
- `--tw-border-spacing-x`: `0`
- `--home-hero-pt-gap`: `2.25rem`
- `--tw-border-spacing-y`: `0`

**Border Radius Token**
- `--radius`: `.5rem`

**Other tokens**
- `--accent`: `22 100% 51.6%`
- `--color-ink`: `213 11% 16%`
- `--site-header-bg`: `hsl(0 0% 100% / .85)`
- `--color-nimbus`: `228 21.74% 95.49%`
- `--color-breeze`: `214 48.9% 73.9%`
- `--color-steel`: `216 4% 22%`
- `--color-ivory`: `40 18% 97%`
- `--color-codeblock`: `0 0% 7%`

## 3. Typography Rules

### Font Families
- **Primary**: `universalSans`
- **Secondary**: `universalSansDisplay`
- **Font 3**: `GeistMono`
- **Font 4**: `universalSans Fallback`
- **Font 5**: `universalSansDisplay Fallback`

### Custom Fonts Loaded
- **GeistMono** weight 100 900 (normal)
- **universalSans** weight 400 (normal)
- **universalSans** weight 550 (normal)
- **universalSans Fallback** weight normal (normal)
- **universalSansDisplay** weight 400 (normal)
- **universalSansDisplay** weight 550 (normal)
- **universalSansDisplay Fallback** weight normal (normal)

### Typography Hierarchy

| Role | Font | Size | Weight | Line Height | Letter Spacing | Notes |
|------|------|------|--------|-------------|----------------|-------|
| Display Hero | universalSansDisplay | 60px | 500 | 1 | -1.5px | Main headline (h1) |
| Card Title | universalSans | 16px | 400 | 1.5 | normal | Card headings |
| Sub-heading | universalSans | 14px | 500 | 1.38 | -0.35px | Third-level heading (h3) |

### Full Font Size Scale

Sizes detected in the design (descending): `72px`, `60px`, `48px`, `30px`, `24px`, `18px`, `16px`, `14px`, `13px`, `12px`, `11px`, `10.50px`, `10px`

> 10 size(s) detected outside the sampled hierarchy (72px, 48px, 30px, 24px, 18px, 13px, 12px, 11px, 10.5px, 10px). These appear on elements not in the sampled set — likely additional display sizes, marketing-section overrides, or third-party-widget styles.

## 4. Component Stylings

### Buttons

**Icon Button**
- Background: `transparent`
- Text: `#ffffff` `{colors.on-primary}`
- Padding: 0px 12px 0px 8px
- Radius: 0px 9999px 9999px 0px
- Font: 16px weight 400
- Use: Toolbar/UI icons
- Focus: outline: `rgba(0, 0, 0, 0) solid 2px`

**Pill**
- Background: `transparent`
- Text: `#0a0a0a` `{colors.ink-subtle}`
- Padding: 8px 16px
- Radius: 9999px
- Shadow: `rgb(255, 255, 255) 0px 0px 0px 0px, rgba(10, 10, 10, 0.15) 0px 0px 0px 1px, rgba...`
- Font: 14px weight 500
- Use: Status pills, tags, chips
- Focus: outline: `rgba(0, 0, 0, 0) solid 2px`

**Pill**
- Background: `transparent`
- Text: `#ffffff` `{colors.on-primary}`
- Padding: 8px 12px 8px 16px
- Radius: 9999px 0px 0px 9999px
- Font: 14px weight 500
- Use: Status pills, tags, chips
- Focus: outline: `rgba(0, 0, 0, 0) solid 2px`

**Light / Invert**
- Background: `#f9f8f6`
- Text: `#0a0a0a` `{colors.ink-subtle}`
- Padding: 0px
- Radius: 16px
- Border: 1px solid rgba(10, 10, 10, 0.06)
- Font: 16px weight 400
- Use: Bright CTA on dark sections
- Focus: outline: `rgba(0, 0, 0, 0) solid 2px`

**Light / Invert**
- Background: `#f9f8f6`
- Text: `#0a0a0a` `{colors.ink-subtle}`
- Padding: 4px
- Radius: 16px
- Border: 1px solid rgba(10, 10, 10, 0.06)
- Font: 16px weight 400
- Use: Bright CTA on dark sections
- Focus: outline: `rgba(0, 0, 0, 0) solid 2px`

### Cards & Containers

**Standard Card**
- Background: `#f9f8f6`
- Padding: 0px
- Radius: 12px
- Shadow: `rgba(0, 0, 0, 0) 0px 0px 0px 0px, rgba(0, 0, 0, 0) 0px 0px 0px 0px, rgba(0, 0, 0...`
- Use: Content containers, listing items

### Navigation

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

### Code Blocks

**Inline Code / Pre**
- Background: `transparent`
- Text: `#e1e4e8`
- Padding: 12px 0px
- Radius: 0px
- Font: 13px weight 400 — GeistMono
- Use: Code samples, CLI commands, syntax highlighting blocks


## 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(10, 10, 10)"
      shadow: "rgb(255, 255, 255) 0px 0px 0px 0px, rgba(10, 10, 10, 0.15) 0"
    focus:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(10, 10, 10)"
      shadow: "rgb(255, 255, 255) 0px 0px 0px 0px, rgba(10, 10, 10, 0.15) 0"
  link:
    default:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(10, 10, 10)"
  card:
    default:
      bg: "rgb(249, 248, 246)"
      fg: "rgb(10, 10, 10)"
      shadow: "rgba(0, 0, 0, 0) 0px 0px 0px 0px, rgba(0, 0, 0, 0) 0px 0px 0"
  navLink:
    default:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(10, 10, 10)"
  footerLink:
    default:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(125, 129, 135)"
```

**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
- **5 shape(s)** in this system: `Icon Button`, `Pill`, `Pill`, `Light / Invert`, `Light / Invert`
- **DO NOT introduce new buttons variants** without justification

### Cards & Containers
- **1 shape(s)** in this system: `Standard Card`
- **DO NOT introduce new cards & containers variants** without justification

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

### Code Blocks
- **1 shape(s)** in this system: `Inline Code / Pre`
- **DO NOT introduce new code blocks variants** without justification

## 5. Layout Principles

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

### Grid
Single column, centered content

### Max Width
1200px

### Spacing System
Compact spacing — information density prioritized

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

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

### Shape Language

| Component | Border Radius |
|-----------|---------------|
| Buttons | `0px 9999px 9999px 0px` |
| Cards & Containers | `12px` |
| Navigation | `none` |
| Code Blocks | `0px` |
| Page Body | `0px` |

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

**Full Radius Spectrum**: 0px, 3px, 4px, 6px, 8px, 12px, 16px, 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** | `16px` | Card padding, list-item spacing |
| **compact** | `12px` | Form fields, tight clusters, badge padding |
| **micro** | `8px` | Icon-text gap, tag inner padding |

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

## 5c. Widget & Structure Library

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

**4/8 structural patterns detected.**

### Hero Pattern

- **Composition:** split-right-text — Split layout, media-left/text-right — image in left column, heading + body in right column. Less common variant.
- **Viewport coverage:** full-viewport hero (≥70% screen height)
- **Heading:** "Frontier AI models for everything you searchsearch." — 60px center-aligned
- **Subheading:** "Reasoning, code, voice, images, and video. Trained on the world's largest supercluster."
- **Media:** present, positioned left
- **CTAs:** 7 (primary: "NewGrok Build Beta")
- **Clone instruction:** Reproduce the **split-right-text** layout. Use the heading font-size token at the documented size. Place media left 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:** 64px
- **Logo:** ✓ present
- **Nav links:** 17 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:** 4 cards detected
- **Columns (desktop):** 2-up grid
- **Card dimensions:** 610×280px (aspect 2.18:1)
- **Gap:** 12px between cards
- **Content:** ✗ no image
- **Clone instruction:** Build a 2-column grid (desktop) with cards at ~2.18:1 aspect ratio. Text/icon-only cards (no photography).

### Footer Pattern

- **Columns:** 1
- **Links:** 46 total
- **Height:** 439px
- **Includes:** ✗ no newsletter | ✓ social icons |  ✓ copyright
- **Clone instruction:** Build a 1-column footer with ~46 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>`rgb(255, 255, 255) 0px 0px 0px 0px`,<br>`rgba(10, 10, 10, 0.15) 0px 0px 0px 1px`,<br>`rgba(0, 0, 0, 0) 0px 0px 0px 0px` | Cards, elevated surfaces |
| Layered (Level 2) | <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 20px 25px -5px`,<br>`rgba(0, 0, 0, 0.1) 0px 8px 10px -6px` | Cards, elevated surfaces |
| Inset (Level 3) | <br>`rgba(255, 255, 255, 0.03) 0px 1px 0px 0px inset` | Buttons, pressed-state elements |
| Layered (Level 4) | <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.08) 0px 10px 15px -3px`,<br>`rgba(0, 0, 0, 0.08) 0px 4px 6px -4px` | 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

### Dominant Easing Curves

| Curve | Semantic Name |
|-------|---------------|
| `cubic-bezier(0.4,0,0.2,1)` | Material Standard — Balanced |
| `cubic-bezier(0.16,1,0.3,1)` | Ease Out — Decelerating |
| `cubic-bezier(0,0,0.2,1)` | Material Decelerate — Entrance |

### Duration Scale

| Value | Tier | Typical Use |
|-------|------|-------------|
| `90ms` | Fast | Hover states, micro-interactions |
| `120ms` | Fast | Hover states, micro-interactions |
| `150ms` | Fast | Hover states, micro-interactions |
| `200ms` | Normal | Panel open/close, navigation |
| `300ms` | Normal | Panel open/close, navigation |
| `500ms` | Slow | Hero animations, page transitions |
| `700ms` | Cinematic | Splash, marketing reveals |

### Copy-Paste Transition Snippets

**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...;
```

**Opacity**
```css
transition: opacity 0.12s, transform 0.12s;
```

**Opacity**
```css
transition: opacity 0.15s;
```

**Opacity**
```css
transition: opacity 0.15s cubic-bezier(0.4, 0, 0.2, 1);
```

### Keyframe Animation Catalog

| Animation Name | Type | Animated Props | Use Hint |
|----------------|------|----------------|----------|
| `marquee` | Slide | transform | UI transition |
| `pulse` | Fade | opacity | Attention / status |
| `slideUpAndOut` | Slide | transform | Panel / drawer enter |
| `spin` | Rotate / Spin | transform | Loading indicator |
| `waveform` | Custom | height | UI transition |
| `fadeIn` | Fade | opacity | Element entrance |
| `tooltip-in` | Fade + Move | opacity, transform | UI transition |
| `tooltip-out` | Fade + Move | opacity, transform | UI transition |
| `border-beam` | Custom | --angle | UI transition |
| `context-menu-in` | Fade + Move | opacity, transform | UI transition |
| `context-menu-out` | Fade + Move | opacity, transform | UI transition |
| `hero-shimmer` | Custom | background-position-x, background-position-y | Loading placeholder |
| `border-shimmer` | Custom | background-position-x, background-position-y | Loading placeholder |
| `swipe-out` | Fade + Move | transform, opacity | Swipe gesture dismiss |
| `sonner-fade-in` | Fade + Move | opacity, transform | Element entrance |
| `sonner-fade-out` | Fade + Move | opacity, transform | Element exit |
| `sonner-spin` | Fade | opacity | Loading indicator |
| `gridShimmerH` | Slide | transform | Loading placeholder |

### Motion Fingerprint

- **Speed Character**: Balanced Pacing (median duration: `200ms`)
- **Dominant Easing**: custom cubic-bezier curves
- **Animation Library**: 18 unique animations (18 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 Jet Black (`#0a0a0a`) for text — not pure black, it's warmer and more readable
- Use universalSans as the primary typeface — it defines the brand personality
- Keep font weights between 400-500 — the system uses a narrow weight range for subtle hierarchy
- Use negative letter-spacing (-1.5px) at display sizes for compressed, editorial headlines
- Use the extracted shadow patterns for elevation — they are tuned to match the brand palette
- Use full-pill radius (9999px) only for specific elements (avatars, pills, toggles)
- Use Success Green (`#46954a`) as the primary accent — it's the brand's signature interactive color
- Use pill-shaped radius (9999px) for primary CTA buttons — the brand uses fully-rounded, pill CTAs
- Use 12px border-radius on cards — consistent with the grid card corners
- Maintain nav height at 64px — 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
- Build the hero as a split layout with media on the right — text and visual share equal weight
- Include exactly 7 CTAs in the hero (primary + secondary) — this design pattern is multi-action, not single-purpose

### 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 use weight 700 (bold) or above — 500 is the maximum weight in this system
- Don't increase letter-spacing on headings — the type is designed to run tight at scale
- Don't invent new shadow values — use only the extracted shadow levels
- Don't 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 use rectangular buttons for primary actions — the rounded pill shape is the brand standard
- 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 `#46954a` for primary CTAs and brand-mark signals only"
    why: "Single chromatic assertion device — overuse dilutes meaning"
    test: "querySelectorAll('[style*=\"#46954a\"]').length <= 3 per fold"
```

## 9. Responsive Behavior

### Breakpoints
| Name | Width | Key Changes |
|------|-------|-------------|
| Mobile Large | 600px | Expanded mobile layout |
| Mobile Large | 640px | Expanded mobile layout |
| Tablet | 768px | Multi-column grids begin |
| Tablet | 1024px | Multi-column grids begin |
| Desktop | 1280px | Full feature layout |
| Large Desktop | 1536px | Maximum content width |

### Token Diff — Desktop vs Mobile

| Element | Property | Desktop | Mobile |
|---------|----------|---------|--------|
| heading | font-size | `60px` | `36px` |
| heading | line-height | `60px` | `37.8px` |
| heading | letter-spacing | `-1.5px` | `-0.9px` |
| nav | height | `64px` | `80px` |
| button | width | `36px` | `auto` |
| card | width | `147px` | `auto` |

### Collapsing Strategy
- Headlines: 60px → 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 12px 0px 8px padding
- Navigation: adequate spacing between items
- Interactive elements: minimum 44px touch target recommended

### Collapsing Narrative

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

- **Hero collapses split-right-text → centered** — the side-by-side layout stacks vertically, with media moving above the text.
- **Navigation collapses to hamburger** — 17 links visible on desktop, 0 on mobile (the rest hide behind a menu toggle).
- **Card grid: 2-up → 1-up** — cards stack as viewport narrows, becoming a vertical list on 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://x.ai/opengraph-image-1j7jya.png?opengraph-image.12t~.8y.z80vm.png?dpl=5c2f91edf2427e90bd58dc75e35d916ca4cb11b8 (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.48:1 (landscape)
- Rendered size: 399×270px
- *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): 7 (100%)
- Portrait (<0.87): 0 (0%)
- Square (0.87–1.15): 0 (0%)

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

**Average rendered image size:** 280×164px
**Above-fold image count:** 2 / 7

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

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

**Imagery Guidance for clones:**
- 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: Jet Black (`#0a0a0a`)
- Accent: Success Green (`#46954a`)
- Border: #d5d9e2 (`#d5d9e2`)
- Font: universalSans
- Body: 16px weight 400

### Example Component Prompts
- "Create a hero section on Pure White background (#ffffff). Headline at 60px universalSans weight 500, line-height 1, letter-spacing -1.5px, color #0a0a0a."
- "Create the primary CTA button: `#46954a` background, `#ffffff` text, 0px 9999px 9999px 0px border-radius, 0px 12px 0px 8px padding, 500 weight, universalSans font."
- "Design a card on `#f9f8f6` background. Border: none. Radius: 12px. Shadow: use extracted shadow. Padding: 0px."
- "Build navigation: static on `#ffffff`. universalSans 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 universalSans, weight range 400–500. Never exceed 500 — heavier weights break the brand's tonal restraint.
3. **Accent**: Success Green (`#46954a`) is the sole interactive color. On hover → Crimson (`#cf222e`). Use CSS transitions, not opacity/brightness filters.
4. **Motion**: All transitions use `cubic-bezier(0.4,0,0.2,1)`. Never use linear for UI transitions — preserve the brand's easing personality.
5. **Shape**: CTAs at `9999px`, cards at `12px`. Apply border-radius from the extracted scale only — don't invent intermediate values.
6. **Spacing**: Use the `--ca-space-*` token scale (8px–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-ink-subtle: #0a0a0a;
  --ca-primary: #46954a;
  --ca-primary-hover: #cf222e;
  --ca-hairline: #d5d9e2;
}

/* Typography */
:root {
  --ca-font-primary: "universalSansDisplay", system-ui, sans-serif;
  --ca-text-display: 60px;
  --ca-text-body: 16px;
}

/* Spacing & Radius */
:root {
  --ca-space-xxs: 2px;
  --ca-space-xs: 8px;
  --ca-space-sm: 12px;
  --ca-space-md: 16px;
  --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: 4px;
  --ca-radius-sm: 8px;
  --ca-radius-md: 12px;
  --ca-radius-lg: 16px;
  --ca-radius-xl: 16px;
  --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: hero
    tag: div
    classes: ["home-hero-pt", "relative"]
    height: 1211px
    width: full-bleed
    layout: block
    children: 1
    padding: "148px 0px 0px"
  - section: section-2
    tag: section
    height: 530px
    width: full-bleed
    layout: block
    children: 1
  - section: section-3
    tag: section
    classes: ["relative", "overflow-hidden"]
    height: 432px
    width: full-bleed
    layout: block
    children: 4
  - section: section-4
    tag: section
    height: 475px
    width: full-bleed
    layout: block
    children: 1
  - section: section-5
    tag: section
    height: 682px
    width: full-bleed
    layout: block
    children: 1
  - section: footer
    tag: footer
    height: 439px
    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:
    - "One API.
Every modality."
    - "Latest news"
  sub-headings:
    - "Grok Build 0.1 on API"
    - "Build on your own"
  ctas:
    - "Contact Sales"
    - "Try for free"
    - "Get API Access"
    - "View Documentation"
    - "Imagine
Explore →"
    - "Get API Key"
    - "Start Building"
  navigation:
    - "Products"
    - "Solutions"
    - "Developer"
    - "Company"
    - "Pricing"
    - "News"
    - "Contact Sales"
    - "Try for free"
    - "Grok"
    - "Business"
  footer-links:
    - "Built with Grok"
    - "Chat"
```

**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:
```

**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">
  Contact Sales
</button>
```
_Source pattern detected: padding `8px 16px` · radius `9999px` · weight `500`_

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

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

| Category | Score | Max | Detail |
|----------|-------|-----|--------|
| Colors & Palette | 25 | 25 | 20 named colors |
| Typography | 8 | 20 | 3 roles defined |
| Components | 16 | 20 | 4 specs extracted |
| Motion & Interaction | 12 | 15 | Keyframes present |
| CSS Custom Properties | 8 | 10 | 164 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 | 164 CSS vars (semantic naming requires ≥20 for high) |
| §3 Typography | Medium | 3 typography roles inferred |
| §4 Components | Medium | 4 component variants captured |
| §7 Motion | High | Keyframes + transitions |
| §8 Do's/Don'ts | High | 24 rules generated; design-decisions.json has evidence per rule |
| §9 Responsive | High | 6 breakpoints detected |
| §9b Photography | High | 7 images, hero present |

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