madgicx.com

DESIGN.md

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

---
version: alpha
name: madgicx.com
description: "Dark-canvas product system built on #040114 with #f96a84 as the single brand accent. Type anchored in Oxygen at 64px / weight 500. Extracted automatically from https://madgicx.com/ — every value from getComputedStyle(), no approximation."
narrative: |
  madgicx.com is built on a near-black canvas (rgb(4, 1, 20)).
  The system uses #f96a84 as the accent for primary actions and brand signals.
  Sharp 0px corners on CTAs — architectural restraint, engineering precision alongside Roboto as the primary typeface.

colors:
  canvas: "#040114"
  surface-1: "#040114"
  surface-2: "#333333"
  ink: "#ffffff"
  ink-muted: "rgba(255, 255, 255, 0.65)"
  ink-subtle: "rgba(255, 255, 255, 0.01)"
  primary: "#f96a84"
  on-primary: "#ffffff"
  primary-hover: "#5525da"
  hairline: "rgba(255,255,255,0.08)"
  semantic-error: "#df8080"
  semantic-success: "#80df90"

typography:
  display-xl:
    fontFamily: "Aeonik Pro"
    fontSize: 64px
    fontWeight: 500
    lineHeight: 1.1
    letterSpacing: 0
  body:
    fontFamily: "Oxygen"
    fontSize: 16px
    fontWeight: 400
    lineHeight: 1.4
    letterSpacing: 0
  button:
    fontFamily: "Apple Color Emoji"
    fontSize: 16px
    fontWeight: 400
    lineHeight: 1.4
    letterSpacing: 0

rounded:
  none: 0px
  xs: 6px
  sm: 8px
  md: 16px
  lg: 16px
  xl: 32px
  pill: 1000px

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

components:
  button-ghost:
    backgroundColor: "transparent"
    textColor: "{colors.hairline}"
    typography: "{typography.body}"
    rounded: "{rounded.none}"
    padding: 16px
  button-pill:
    backgroundColor: "{colors.surface-1}"
    textColor: "{colors.hairline}"
    typography: "{typography.body}"
    rounded: "{rounded.pill}"
    padding: 0px 20px
  button-pill:
    backgroundColor: "{colors.surface-1}"
    textColor: "{colors.hairline}"
    typography: "{typography.body}"
    rounded: "{rounded.pill}"
    padding: 0px 20px
  navigation-main-nav:
    backgroundColor: "{colors.surface-1}"
    typography: "{typography.body}"
    rounded: "{rounded.none}"
    padding: 16px 40px
  cta-banner-full-width-cta:
    backgroundColor: "transparent"
    textColor: "{colors.hairline}"
    typography: "{typography.body}"
    rounded: "{rounded.none}"
  testimonial-quote-card:
    backgroundColor: "transparent"
    textColor: "{colors.hairline}"
    typography: "{typography.body}"
    rounded: "{rounded.none}"
  testimonial-quote-card:
    backgroundColor: "#cab7ff"
    textColor: "{colors.hairline}"
    typography: "{typography.body}"
    rounded: "{rounded.md}"
    padding: 20px
  tab-ghost-tab:
    backgroundColor: "transparent"
    textColor: "{colors.hairline}"
    typography: "{typography.body}"
    rounded: "{rounded.none}"
  tab-ghost-tab:
    backgroundColor: "transparent"
    textColor: "{colors.hairline}"
    typography: "{typography.body}"
    rounded: "{rounded.pill}"
    padding: 8px 24px

extracted_at: "2026-05-30T20:39:15.904Z"
completeness: 73
scoreVersion: "v2"

---

# Design System — madgicx.com
> Extracted automatically by Clone Architect from https://madgicx.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(4, 1, 20)` is the page background. Every component composits against this.
> - **Accent**: `#f96a84` 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: 40px.
> - **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

madgicx.com commits fully to dark-mode as the native medium, not as a toggled alternative. The canvas is a near-pure-black surface (`#040114`) where elevation is communicated through subtle white-opacity gradations rather than traditional shadows — semi-transparent white borders act as the primary depth indicator, like wireframes etched in moonlight. 

Typography is anchored in **Oxygen**. 

Body text reads in Pure White (`#ffffff`) (contrast ratio 62.8:1, well above WCAG AA). **#f96a84** (`#f96a84`) 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 Black (`#040114`)
- Primary typeface: Inter
- Primary text: Pure White (`#ffffff`)
- Accent: #f96a84 (`#f96a84`)
- Display: 64px weight 500
- Shadow system: 1 distinct elevation levels
- Custom fonts loaded: Inter, Aeonik Pro

## 2. Color Palette & Roles

### Background & Surface
- **Pure Black** (`#040114`): Page background (primary)
- **Surface  Secondary** (`#080519`): Surface / elevated background (CSS var)
- **Surface  Tertiary** (`#0c081d`): Surface / elevated background (CSS var)
- **Charcoal** (`#333333`): Surface / elevated background
- **#483481** (`#483481`): Surface / elevated background

### Text & Content
- **Pure White** (`#ffffff`): Primary body text
- **Text  Brand** (`#d3c3ff`): Text (CSS var)

### Accent & Interactive
- **Surface  Brand Pink** (`#f96a84`): Accent / interactive (CSS var)
- **Surface  Brand Primary Weak** (`#5525da`): Accent / interactive (CSS var)
- **Surface  Brand Primary** (`#6647ff`): Accent / interactive (CSS var)
- **Surface  Brand Orange** (`#ff7e47`): Accent / interactive (CSS var)
- **Surface  Sparkle** (`#fe8446`): Accent / interactive (CSS var)
- **Surface  Brand Light Blue** (`#8cd5f5`): Accent / interactive (CSS var)
- **Surface  Brand Primary Xstrong** (`#cab7ff`): Accent / interactive (CSS var)

### Border & Divider
- **Charcoal** (`#2d2842`): Borders / dividers

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

- `#000000` — Pure Black
- `#917aff` — #917aff
- `#3e3266` — #3e3266
- `#d8b818` — #d8b818
- `#80df90` — #80df90
- `#efda71` — #efda71
- `#43ad54` — Success Green
- `#df8080` — #df8080
- `#f6f8fa` — Ghost White
- `#f8fafb` — Off-White
- `#bb3535` — #bb3535

### Gradients & Decorative Fills

- `linear-gradient(90deg, rgba(202, 183, 255, 0), rgba(202, 183, 255, 0.08) 50%, rgba(202, 183, 255, 0)…` — (header)
- `linear-gradient(rgb(255, 255, 255), rgba(255, 255, 255, 0.72))` — (heading)

### CSS Custom Properties (Design Tokens)

**Border Radius Token**
- `--radius--large`: `32px`
- `--radius--none`: `0px`
- `--radius--rounded`: `1000px`
- `--radius--small`: `16px`

**Other tokens**
- `--color--alert--400`: `#d8b818`
- `--text--primary-invert`: `black`
- `--text--tretinary-invert`: `#0000008f`
- `--color--success--600`: `#80df90`
- `--surface--brand-primary-weak`: `#5525da`
- `--surface--brand-primary`: `#6647ff`
- `--surface--primary`: `#040114`
- `--text--brand`: `#d3c3ff`

## 3. Typography Rules

### Font Families
- **Primary**: `system-ui`
- **Secondary**: `Aeonik Pro`
- **Font 3**: `webflow-icons`
- **Font 4**: `Inter`
- **Font 5**: `Proxima nova`

### Custom Fonts Loaded
- **webflow-icons** weight 400 (normal)
- **Inter** weight 500 (normal)
- **Inter** weight 400 (normal)
- **Aeonik Pro** weight 500 (normal)

### Typography Hierarchy

| Role | Font | Size | Weight | Line Height | Letter Spacing | Notes |
|------|------|------|--------|-------------|----------------|-------|
| Display Hero | Aeonik Pro | 64px | 500 | 1.1 | normal | Main headline (h1) |
| Body | Oxygen | 16px | 400 | 1.4 | normal | Standard reading text |
| Button Large | Apple Color Emoji | 16px | 400 | 1.4 | normal | Button label (16px) |
| Navigation | Inter | 16px | 400 | 1.4 | normal | Navigation items |
| Button | Inter | 14px | 400 | 1.4 | normal | Button label (14px) |
| Button | Inter | 14px | 500 | 1.4 | normal | Button label (14px) |

### Full Font Size Scale

Sizes detected in the design (descending): `64px`, `56px`, `24px`, `20px`, `16px`, `15px`, `14px`, `13px`, `12px`

> 6 size(s) detected outside the sampled hierarchy (56px, 24px, 20px, 15px, 13px, 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

**Ghost**
- Background: `transparent`
- Text: `rgba(255, 255, 255, 0.72)` `{colors.hairline}`
- Padding: 16px
- Radius: 0px
- Font: 14px weight 400
- Use: Subtle action, toolbar, nav button

**Pill**
- Background: `#040114` `{colors.surface-1}`
- Text: `#ffffff` `{colors.hairline}`
- Padding: 0px 20px
- Radius: 1000px
- Border: 1px solid rgb(72, 52, 129)
- Font: 14px weight 500
- Use: Status pills, tags, chips

**Pill**
- Background: `#040114` `{colors.surface-1}`
- Text: `#ffffff` `{colors.hairline}`
- Padding: 0px 20px
- Radius: 1000px
- Border: 1px solid rgb(45, 40, 66)
- Font: 14px weight 500
- Use: Status pills, tags, chips

**Primary Brand**
- Background: `#6647ff`
- Text: `#ffffff` `{colors.hairline}`
- Padding: 0px
- Radius: 50%
- Shadow: `rgba(0, 0, 0, 0.06) 0px 1px 6px 0px, rgba(0, 0, 0, 0.16) 0px 2px 32px 0px`
- Font: 16px weight 400
- Use: Primary CTA / brand action

**Dark / Solid**
- Background: `#040114` `{colors.surface-1}`
- Text: `#917aff`
- Padding: 8px
- Radius: 32px
- Border: 1px solid rgba(202, 183, 255, 0.1)
- Font: 16px weight 400
- Use: Solid dark CTA

### Navigation

**Main Nav**
- Background: `#040114` `{colors.surface-1}`
- Padding: 16px 40px
- Radius: none
- Font: 16px weight 400
- Use: Fixed/sticky flex nav — N/A items

### CTA Banners

**Full-width CTA**
- Background: `transparent`
- Text: `#ffffff` `{colors.hairline}`
- Padding: 0px
- Radius: 0px
- Font: 16px weight 400
- Use: Full-width conversion strip with headline + button

### Testimonials

**Quote Card**
- Background: `transparent`
- Text: `#ffffff` `{colors.hairline}`
- Padding: 0px
- Radius: 0px
- Font: 16px weight 400
- Use: Customer quote with avatar + company attribution

**Quote Card**
- Background: `rgba(202, 183, 255, 0.02)`
- Text: `#ffffff` `{colors.hairline}`
- Padding: 20px
- Radius: 16px
- Border: 1px solid rgba(202, 183, 255, 0.12)
- Font: 16px weight 400
- Use: Customer quote with avatar + company attribution

### Tabs

**Ghost Tab**
- Background: `transparent`
- Text: `#ffffff` `{colors.hairline}`
- Padding: 0px
- Radius: 0px
- Font: 16px weight 400
- Use: Navigation tabs, filter tabs
- Hover: outline: `rgb(255, 255, 255) none 0px`

**Ghost Tab**
- Background: `transparent`
- Text: `#ffffff` `{colors.hairline}`
- Padding: 8px 24px
- Radius: 1000px 0px 0px 1000px
- Font: 14px weight 400
- Use: Navigation tabs, filter tabs
- Hover: outline: `rgb(255, 255, 255) none 0px`


## 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(255, 255, 255)"
  link:
    default:
      bg: "rgb(102, 71, 255)"
      fg: "rgb(145, 122, 255)"
  navLink:
    default:
      bg: "rgba(202, 183, 255, 0.02)"
      fg: "rgb(145, 122, 255)"
      border: "1px solid rgba(202, 183, 255, 0.1)"
  tab:
    default:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(255, 255, 255)"
    hover:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(255, 255, 255)"
  footerLink:
    default:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(145, 122, 255)"
    hover:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(145, 122, 255)"
```

**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: `Ghost`, `Pill`, `Pill`, `Primary Brand`, `Dark / Solid`
- **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

### CTA Banners
- **1 shape(s)** in this system: `Full-width CTA`
- **DO NOT introduce new cta banners variants** without justification

### Testimonials
- **2 shape(s)** in this system: `Quote Card`, `Quote Card`
- **DO NOT introduce new testimonials variants** without justification

### Tabs
- **2 shape(s)** in this system: `Ghost Tab`, `Ghost Tab`
- **DO NOT introduce new tabs 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 | 2px |
| sm | 8px |
| md | 12px |
| base | 16px |
| lg | 40px |
| xl | 32px |
| 2xl | 48px |
| 3xl | 64px |

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

### Shape Language

| Component | Border Radius |
|-----------|---------------|
| Buttons | `0px` |
| Navigation | `none` |
| CTA Banners | `0px` |
| Testimonials | `0px` |
| Tabs | `0px` |
| Page Body | `0px` |

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

**Full Radius Spectrum**: 0px, 6px, 16px, 24px, 32px, 40px, 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** | `40px` | Within a section, between content groups |
| **card** | `12px` | Card padding, list-item spacing |
| **compact** | `8px` | Form fields, tight clusters, badge padding |
| **micro** | `2px` | 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).

**5/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:** "Dominate AI Ads Results" — 64px center-aligned
- **Subheading:** "You just found Madgicx. The secret AI Ads Manager top ad agencies use to run all accounts. Streamline advertising operations. Maximize Ad ROI and prof"
- **Media:** present, positioned top
- **CTAs:** 4 (primary: "Unlock the Madgicx")
- **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:** unknown — Layout not classified
- **Height:** 52px
- **Logo:** ✓ present
- **Nav links:** 1 primary items
- **CTAs in nav:** 0 (no buttons — links only)
- **Clone instruction:** Build a static unknown navigation. Link-only — no button styling needed.

### Card Grid Pattern

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

### Testimonial Pattern

- **Count:** 23 testimonial blocks
- **Layout:** grid
- **Avg quote length:** 109 chars (medium quote)
- **Includes:** ✗ no avatars | ✗ no logos | ✓ star ratings
- **Clone instruction:** Build a grid of 23 testimonials.   Display ratings prominently.

### Footer Pattern

- **Columns:** 1
- **Links:** 69 total
- **Height:** 1045px
- **Includes:** ✗ no newsletter | ✓ social icons |  ✓ copyright
- **Clone instruction:** Build a 1-column footer with ~69 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.06) 0px 1px 6px 0px`,<br>`rgba(0, 0, 0, 0.16) 0px 2px 32px 0px` | Cards, elevated surfaces |

**Shadow Philosophy**: Multi-layered shadow system creating natural, atmospheric depth. Each shadow level combines multiple layers for realistic elevation.

## 7. Motion & Interaction

### Dominant Easing Curves

| Curve | Semantic Name |
|-------|---------------|
| `cubic-bezier(0.33,0,0,1)` | Ease Out — Decelerating |
| `linear` | Linear — No Easing |

### Duration Scale

| Value | Tier | Typical Use |
|-------|------|-------------|
| `80ms` | Fast | Hover states, micro-interactions |
| `100ms` | Fast | Hover states, micro-interactions |
| `167ms` | Normal | Panel open/close, navigation |
| `200ms` | Normal | Panel open/close, navigation |
| `300ms` | Normal | Panel open/close, navigation |

### Copy-Paste Transition Snippets

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

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

**Transform**
```css
transition: transform 0.167s cubic-bezier(0.33, 0, 0, 1);
```

**Transform**
```css
transition: transform 0.1s linear, opacity 0.08s linear;
```

### Keyframe Animation Catalog

| Animation Name | Type | Animated Props | Use Hint |
|----------------|------|----------------|----------|
| `spin` | Rotate / Spin | transform | Loading indicator |
| `spinScreen` | Custom | --angleScreen | Loading indicator |
| `spinScreenTwo` | Custom | --angleScreenTwo | Loading indicator |
| `intercom-lightweight-app-launcher` | Fade + Move | opacity, transform | UI transition |
| `intercom-lightweight-app-gradient` | Fade | opacity | UI transition |
| `intercom-lightweight-app-messenger` | Fade + Move | opacity, transform | UI transition |

### Motion Fingerprint

- **Speed Character**: Balanced Pacing (median duration: `167ms`)
- **Dominant Easing**: custom cubic-bezier curves
- **Animation Library**: 6 unique animations (6 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 dark background (`#040114`) as the foundation — this is a dark-mode-native design
- Use Oxygen 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 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 #f96a84 (`#f96a84`) as the primary accent — it's the brand's signature interactive color
- Maintain nav height at 51.5938px — consistent vertical space for the navigation bar
- Respect the 2px–32px spacing range — the design uses a wide scale for visual breathing room
- Make the hero full-viewport (≥70% screen height) — this design uses an immersive hero, not a tall navbar
- Include exactly 4 CTAs in the hero (primary + secondary) — this design pattern is multi-action, not single-purpose
- Each card includes a top image — imagery is part of the card identity, not optional
- Lay out testimonials in a grid (23+ items) — quantity signals scale and trust

### Don't
- Don't use light backgrounds — the dark canvas is the native medium
- 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 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 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(4, 1, 20)` as the base canvas"
    why: "Every component is designed to composit against this exact tone"
    test: "document.body.style.backgroundColor === 'rgb(4, 1, 20)'"
  - id: brand-accent-001
    type: do
    rule: "Reserve `#f96a84` for primary CTAs and brand-mark signals only"
    why: "Single chromatic assertion device — overuse dilutes meaning"
    test: "querySelectorAll('[style*=\"#f96a84\"]').length <= 3 per fold"
```

## 9. Responsive Behavior

### Breakpoints
| Name | Width | Key Changes |
|------|-------|-------------|
| Mobile | 478px | Single column, compact spacing |
| Mobile Large | 767px | Expanded mobile layout |
| Tablet | 991px | Multi-column grids begin |

### Token Diff — Desktop vs Mobile

| Element | Property | Desktop | Mobile |
|---------|----------|---------|--------|
| heading | font-size | `64px` | `40px` |
| heading | line-height | `70.4px` | `44px` |
| nav | display | `flex` | `none` |
| nav | height | `51.5938px` | `auto` |
| button | padding | `16px` | `12px 16px` |
| button | width | `125px` | `auto` |

### Collapsing Strategy
- Headlines: 64px → 40px on mobile
- Navigation: flex → none on mobile
- Cards: multi-column → stacked vertical on mobile
- Footer: multi-column → stacked single column on mobile

### Touch Targets
- Buttons: 16px 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):

*No major structural differences detected between desktop and mobile widgets. The same blueprints scale rather than collapse — verify by inspecting actual mobile render.*

## 9b. Visual Tone & Photography

**Tone:** Illustration-driven

The site relies primarily on illustrations, vector art, and decorative SVG elements rather than photography. Use commissioned illustrations, icon sets, or generated graphics for clones — stock photos will feel off-brand.

**Canonical Brand Image (OG):**
- https://cdn.prod.website-files.com/614069317241cba124a0dd3b/68a44d76eddc76f62c923418_Madgicx%20-%20Agentic%20Meta%20Ads%20Management%20AI%20Platform.jpg
  *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.6:1 (landscape (16:9-ish))
- Rendered size: 1262×789px
- Alt text: "Madgicx AI Marketer"
- *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): 6 (21%)
- Portrait (<0.87): 0 (0%)
- Square (0.87–1.15): 0 (0%)
- Ultra-wide (>2.3): 22 (79%)

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

**Average rendered image size:** 1074×258px
**Above-fold image count:** 2 / 28

**Decorative Patterns Detected:**
- 25 multi-stop linear gradients (mesh-like, 3+ color stops) — the brand leans on rich color transitions for visual depth
- 10 radial gradients — circular color blooms used for spotlight/glow effects
- 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:**
- Use vector illustration as the primary visual language — photos will read as off-brand.
- Maintain consistent illustration style (line weight, color palette) across the site.

## 10. Agent Prompt Guide

### Quick Reference
- Background: Pure Black (`#040114`)
- Primary text: Pure White (`#ffffff`)
- Accent: #f96a84 (`#f96a84`)
- Border: Translucent Pure White (8%) (`rgba(255, 255, 255, 0.08)`)
- Font: Oxygen
- Body: 16px weight 400

### Example Component Prompts
- "Create a hero section on Pure Black background (#040114). Headline at 64px Oxygen weight 500, line-height 1.1, color #ffffff."
- "Create the primary CTA button: `#f96a84` background, `#ffffff` text, 50% border-radius, 12px 24px padding, 500 weight, Oxygen font."
- "Build navigation: static on `#040114`. Oxygen 16px weight 400 for links."

### Iteration Guide
1. **Canvas**: Set the dark canvas to Pure Black (`#040114`) — every component is composited against this exact base.
2. **Typography**: All type in Oxygen, weight range 400–500. Never exceed 500 — heavier weights break the brand's tonal restraint.
3. **Accent**: #f96a84 (`#f96a84`) is the sole interactive color. On hover → #5525da (`#5525da`). Use CSS transitions, not opacity/brightness filters.
4. **Motion**: All transitions use `cubic-bezier(0.33,0,0,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 (2px–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-surface-1: #040114;
  --ca-surface-2: #333333;
  --ca-hairline: #ffffff;
  --ca-primary: #f96a84;
  --ca-primary-hover: #5525da;
  --ca-semantic-error: #df8080;
  --ca-semantic-success: #80df90;
}

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

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


## 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: ["page-wrapper"]
    height: 13003px
    width: full-bleed
    layout: block
    children: 5
  - section: header
    tag: div
    classes: ["w-nav"]
    height: 85px
    width: full-bleed
    layout: block
    children: 2
    bg: "rgb(4, 1, 20)"
    padding: "16px 40px"
  - section: header
    tag: header
    classes: ["section_home-hero-new"]
    height: 1389px
    width: full-bleed
    layout: block
    children: 1
  - section: main-content
    tag: main
    classes: ["main-wrapper"]
    height: 11874px
    width: full-bleed
    layout: block
    children: 9
  - section: hero
    tag: div
    classes: ["padding-section-large", "is-hero"]
    height: 1327px
    width: 1280px
    layout: block
    children: 3
    padding: "64px 0px 160px"
  - section: unknown
    tag: div
    classes: ["container-large"]
    height: 1389px
    width: 1280px
    layout: block
    children: 2
  - section: section-6
    tag: section
    height: 736px
    width: full-bleed
    layout: block
    children: 1
  - section: unknown
    tag: div
    classes: ["padding-section-medium"]
    height: 736px
    width: 1280px
    layout: block
    children: 1
    padding: "80px 0px"
  - section: unknown
    tag: div
    classes: ["container-large"]
    height: 736px
    width: 1280px
    layout: block
    children: 1
  - section: section-7
    tag: section
    classes: ["section_home-mastering"]
    height: 1031px
    width: full-bleed
    layout: block
    children: 1
  - section: unknown
    tag: div
    classes: ["padding-section-large"]
    height: 969px
    width: 1280px
    layout: block
    children: 3
    padding: "160px 0px"
  - section: unknown
    tag: div
    classes: ["container-large"]
    height: 1031px
    width: 1280px
    layout: block
    children: 2
  - section: section-8
    tag: section
    classes: ["section_home-opt"]
    height: 1497px
    width: full-bleed
    layout: block
    children: 1
  - section: unknown
    tag: div
    classes: ["padding-section-large"]
    height: 1435px
    width: 1280px
    layout: block
    children: 2
    padding: "160px 0px"
  - section: unknown
    tag: div
    classes: ["container-large"]
    height: 1497px
    width: 1280px
    layout: block
    children: 2
  - section: section-9
    tag: section
    classes: ["section_grey"]
    height: 1654px
    width: full-bleed
    layout: block
    children: 1
    padding: "8px"
  - section: unknown
    tag: div
    classes: ["section-grey-wrap"]
    height: 1638px
    width: 1424px
    layout: block
    children: 1
    bg: "rgb(12, 8, 29)"
  - section: unknown
    tag: div
    classes: ["padding-section-large"]
    height: 1574px
    width: 1280px
    layout: block
    children: 2
    padding: "160px 0px"
  - section: unknown
    tag: div
    classes: ["container-large"]
    height: 1636px
    width: 1280px
    layout: block
    children: 2
  - section: section-10
    tag: section
    classes: ["section_home-analytics"]
    height: 1847px
    width: full-bleed
    layout: block
    children: 1
  - section: unknown
    tag: div
    classes: ["padding-section-large"]
    height: 1786px
    width: 1280px
    layout: block
    children: 2
    padding: "160px 0px"
  - section: unknown
    tag: div
    classes: ["container-large"]
    height: 1847px
    width: 1280px
    layout: block
    children: 2
  - section: section-11
    tag: section
    classes: ["section_home-yt"]
    height: 1450px
    width: full-bleed
    layout: block
    children: 1
  - section: unknown
    tag: div
    classes: ["padding-section-large"]
    height: 1389px
    width: 1280px
    layout: block
    children: 3
    padding: "160px 0px"
  - section: unknown
    tag: div
    classes: ["container-large"]
    height: 1450px
    width: 1280px
    layout: block
    children: 2
```

**Agent rule**: rebuild sections in this order (sorted by vertical position). Match the layout primitive (grid N-col / flex direction / block).


## 14. Copy Library (Real Content from Source)

*Actual text content extracted from the live page. Use these strings verbatim when reproducing the site — they carry the brand voice.*

```yaml
copy:
  section-headings:
    - "Master AI Ads Optimization for Meta"
    - "Automated Creatives for Facebook That Actually Convert"
  ctas:
    - "Workflows"
    - "Try for Free"
    - "View Pricing"
  navigation:
    - "Why Madgicx?"
    - "About Us"
    - "Blog"
    - "Careers"
    - "Case Studies"
    - "Pricing"
    - "Try for Free"
    - "Login"
    - "Unlock the Madgicx"
  footer-links:
    - "Ads Launcher"
```

**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: 13
    avg-ratio: 2.82
    common-aspect: "~16:6 banner"
  hero:
    count: 11
    avg-ratio: 14.60
    common-aspect: "~16:6 banner"
```

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

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


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

| Category | Score | Max | Detail |
|----------|-------|-----|--------|
| Colors & Palette | 21 | 25 | 15 named colors |
| Typography | 15 | 20 | 6 roles defined |
| Components | 20 | 20 | 5 specs extracted |
| Motion & Interaction | 12 | 15 | Keyframes present |
| CSS Custom Properties | 2 | 10 | 45 vars |
| Responsive Breakpoints | 3 | 5 | 3 breakpoints |
| Variable Fonts | 0 | 5 | None detected |

## 12. Known Gaps & Confidence

Explicit list of what this extraction could NOT capture. Agents should not invent values for these — either skip the feature or use the documented baseline + heuristic fallback.

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

### Per-section confidence

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

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