clickhouse.com

DESIGN.md

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

---
version: alpha
name: clickhouse.com
description: "Dark-canvas product system built on #1f1f1c with #166534 as the single brand accent. Type anchored in sans-serif at 96px / weight 900. Extracted automatically from https://clickhouse.com/ — every value from getComputedStyle(), no approximation."
narrative: |
  clickhouse.com is built on a near-black canvas (rgb(31, 31, 28)).
  The system uses rgb(22, 101, 52) as the singular interactive color.
  Sharp 0px corners on CTAs — architectural restraint, engineering precision alongside sans-serif as the primary typeface.

colors:
  canvas: "#1f1f1c"
  surface-2: "#1f1f1c"
  ink: "#ffffff"
  ink-muted: "#808080"
  ink-subtle: "#ffffff"
  primary: "#166534"
  on-primary: "#ffffff"
  primary-hover: "#4f5100"
  hairline: "rgba(96, 96, 96, 0.2)"
  primary-focus: "#141414"

typography:
  display-xl:
    fontFamily: "__Inter_d1b8ee"
    fontSize: 96px
    fontWeight: 900
    lineHeight: 1
    letterSpacing: 0
  display-md:
    fontFamily: "__Inter_d1b8ee"
    fontSize: 20px
    fontWeight: 700
    lineHeight: 1.4
    letterSpacing: 0
  body:
    fontFamily: "__Inter_d1b8ee"
    fontSize: 16px
    fontWeight: 400
    lineHeight: 1.5
    letterSpacing: 0
  button:
    fontFamily: "ui-sans-serif"
    fontSize: 14px
    fontWeight: 400
    lineHeight: 1.43
    letterSpacing: 0

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

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

components:
  button-secondary:
    backgroundColor: "{colors.primary}"
    textColor: "{colors.on-primary}"
    typography: "{typography.button}"
    rounded: "{rounded.none}"
    padding: 12px 16px
  button-dark--solid:
    backgroundColor: "{colors.primary-focus}"
    textColor: "{colors.on-primary}"
    typography: "{typography.button}"
    rounded: "{rounded.none}"
    padding: 12px 16px
  button-ghost:
    backgroundColor: "transparent"
    textColor: "#f4f692"
    typography: "{typography.button}"
    rounded: "{rounded.none}"
    padding: 16px
  card-standard-card:
    backgroundColor: "{colors.primary-focus}"
    typography: "{typography.body}"
    rounded: "{rounded.sm}"
  navigation-main-nav:
    backgroundColor: "{colors.primary-focus}"
    typography: "{typography.body}"
    rounded: "{rounded.none}"
  code-block-inline-code--pre:
    backgroundColor: "#282828"
    textColor: "{colors.on-primary}"
    typography: "{typography.body}"
    rounded: "{rounded.sm}"
    padding: 24px 32px

extracted_at: "2026-05-30T20:38:45.034Z"
completeness: 76
scoreVersion: "v2"

---

# Design System — clickhouse.com
> Extracted automatically by Clone Architect from https://clickhouse.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(31, 31, 28)` is the page background. Every component composits against this.
> - **Accent**: `rgb(22, 101, 52)` 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: 64px.
> - **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

clickhouse.com commits fully to dark-mode as the native medium, not as a toggled alternative. The canvas is a dark surface (`#1f1f1c`) 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 **sans-serif**. Headlines use weight 900 for confident, assertive presence — the brand wants to be heard. 

Body text reads in Pure White (`#ffffff`). **#166534** (`#166534`) 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: Near Black (`#1f1f1c`)
- Primary typeface: sans-serif
- Primary text: Off-White (`#f9f9f9`)
- Accent: #166534 (`#166534`)
- Display: 96px weight 900
- Shadow system: 6 distinct elevation levels

## 2. Color Palette & Roles

### Background & Surface
- **Near Black** (`#1f1f1c`): Page background (primary)
- **Jet Black** (`#131312`): Surface / elevated background
- **Pure Black** (`#000000`): Surface / elevated background
- **Jet Black** (`#141414`): Surface / elevated background
- **Charcoal** (`#393939`): Surface / elevated background

### Text & Content
- **Pure White** (`#ffffff`): Primary body text
- **Medium Gray** (`#808080`): Secondary text
- **Silver** (`#b3b6bd`): Secondary text
- **Silver** (`#c0c0c0`): Secondary text
- **Coral** (`#ff7575`): Secondary text

### Accent & Interactive
- **#f4f692** (`#f4f692`): Interactive / accent
- **#166534** (`#166534`): Interactive / accent
- **#4f5100** (`#4f5100`): Interactive / accent
- **#fbff46** (`#fbff46`): Interactive / accent

### Border & Divider
- **Jet Black** (`#161600`): Borders / dividers
- **Dark Gray** (`#414141`): Borders / dividers
- **Jet Black** (`#151515`): Borders / dividers
- **Near Black** (`#1f2014`): Borders / dividers
- **Jet Black** (`#161517`): Borders / dividers
- **Charcoal** (`#313128`): Borders / dividers

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

- `#f9f9f9` — Off-White
- `#e5e7eb` — Light Gray
- `#f2f3f2` — Light Gray
- `#faff69` — #faff69
- `#dfdfdf` — Light Gray
- `rgba(96, 96, 96, 0.2)` — Translucent Dim Gray (20%)
- `#282828` — Warm Brown
- `#211d1b` — Near Black
- `#343434` — Charcoal
- `rgba(191, 191, 191, 0.6)` — Translucent Silver (60%)
- `#a0a0a0` — Cool Gray
- `rgba(161, 161, 161, 0.1)` — Translucent Cool Gray (10%)
- `#373439` — Charcoal
- `rgba(59, 130, 246, 0.5)` — Translucent Ring Blue (50%)
- `#007aff` — #007aff

### Gradients & Decorative Fills

- `linear-gradient(272.48deg, rgb(41, 41, 36) 1.95%, rgb(15, 15, 15))` — (body)

### CSS Custom Properties (Design Tokens)

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

**Spacing Token**
- `--tw-numeric-spacing`: ``
- `--tw-border-spacing-x`: `0`
- `--tw-border-spacing-y`: `0`

**Other tokens**
- `--tw-text-opacity`: `1`
- `--tw-ring-color`: `rgba(59,130,246,.5)`
- `--swiper-theme-color`: `#007aff`
- `--tw-ring-offset-color`: `#fff`
- `--font-basier`: `"__basier_a58b65","__basier_Fallback_a58b65"`
- `--font-inter`: `"__Inter_d1b8ee",sans-serif`
- `--font-inconsolata`: `"__Inconsolata_a25f62"`
- `--tw-bg-opacity`: `1`

## 3. Typography Rules

### Font Families
- **Primary**: `swiper-icons`
- **Secondary**: `ui-sans-serif`

### Custom Fonts Loaded
- **__Inter_d1b8ee** weight 400 (normal)
- **__Inter_d1b8ee** weight 500 (normal)
- **__Inter_d1b8ee** weight 600 (normal)
- **__Inter_d1b8ee** weight 700 (normal)
- **__Inconsolata_a25f62** weight 400 (normal)
- **__Inconsolata_a25f62** weight 500 (normal)
- **__Inconsolata_a25f62** weight 600 (normal)
- **__Inconsolata_a25f62** weight 700 (normal)
- **__basier_a58b65** weight 500 (normal)
- **__basier_a58b65** weight 600 (normal)
- **__basier_a58b65** weight 700 (normal)
- **__basier_Fallback_a58b65** weight normal (normal)
- **swiper-icons** weight 400 (normal)

### Typography Hierarchy

| Role | Font | Size | Weight | Line Height | Letter Spacing | Notes |
|------|------|------|--------|-------------|----------------|-------|
| Display Hero | __Inter_d1b8ee | 96px | 900 | 1 | normal | Main headline (h1) |
| Sub-heading | __Inter_d1b8ee | 20px | 700 | 1.4 | normal | Third-level heading (h3) |
| Card Title | __Inter_d1b8ee | 16px | 400 | 1.5 | normal | Card headings |
| Body | sans-serif | 16px | 400 | 1.5 | normal | Standard reading text |
| Button | ui-sans-serif | 14px | 400 | 1.43 | normal | Button label (14px) |
| Button | __Inter_d1b8ee | 14px | 500 | 1.43 | normal | Button label (14px) |

### Full Font Size Scale

Sizes detected in the design (descending): `96px`, `72px`, `36px`, `24px`, `20px`, `18px`, `16px`, `14px`, `12px`, `11.20px`

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

## 4. Component Stylings

### Buttons

**Secondary**
- Background: `#166534` `{colors.primary}`
- Text: `#ffffff` `{colors.on-primary}`
- Padding: 12px 16px
- Radius: 0px
- Border: 1px solid rgb(20, 20, 20)
- Font: 14px weight 400
- Use: Secondary action
- Hover: backgroundColor: `#14532d`
- Focus: outline: `rgb(20, 20, 20) solid 1px`

**Dark / Solid**
- Background: `#141414` `{colors.primary-focus}`
- Text: `#ffffff` `{colors.on-primary}`
- Padding: 12px 16px
- Radius: 0px
- Border: 1px solid rgb(20, 20, 20)
- Font: 14px weight 400
- Use: Solid dark CTA
- Hover: backgroundColor: `#14532d`
- Focus: outline: `rgb(20, 20, 20) solid 1px`

**Ghost**
- Background: `transparent`
- Text: `#f4f692`
- Padding: 16px
- Radius: 0px
- Font: 14px weight 400
- Use: Subtle action, toolbar, nav button
- Hover: backgroundColor: `#14532d`
- Focus: outline: `rgb(20, 20, 20) solid 1px`

**Icon Button**
- Background: `transparent`
- Text: `#161600`
- Padding: 4px
- Radius: 4px
- Border: 1px solid rgba(0, 0, 0, 0)
- Font: 16px weight 400
- Use: Toolbar/UI icons
- Hover: backgroundColor: `#14532d`
- Focus: outline: `rgb(20, 20, 20) solid 1px`

**Ghost**
- Background: `transparent`
- Text: `#ffffff` `{colors.on-primary}`
- Padding: 10px 12px
- Radius: 8px
- Font: 14px weight 500
- Use: Subtle action, toolbar, nav button
- Hover: backgroundColor: `#14532d`
- Focus: outline: `rgb(20, 20, 20) solid 1px`

### Cards & Containers

**Standard Card**
- Background: `rgba(20, 20, 20, 0.5)` `{colors.primary-focus}`
- Padding: 0px
- Radius: 8px
- Border: 1px solid rgba(65, 65, 65, 0.8)
- 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
- Hover: boxShadow: `rgba(0, 0, 0, 0) 0px 0px 0px 0px, rgba(0, 0, 0, 0) 0px 0px 0px 0px, rgba(0, 0, 0, 0.1) 0px 10px 15px -3px, rgba(0, 0, 0, 0.1) 0px 4px 6px -4px`

### Navigation

**Main Nav**
- Background: `rgba(20, 20, 20, 0.1)` `{colors.primary-focus}`
- Padding: 0px
- Radius: none
- Font: 16px weight 400
- Use: Fixed/sticky block nav — N/A items

### Code Blocks

**Inline Code / Pre**
- Background: `#282828`
- Text: `#ffffff` `{colors.on-primary}`
- Padding: 24px 32px
- Radius: 8px
- Border: 1px solid rgba(65, 65, 65, 0.4)
- Font: 16px weight 600 — __Inconsolata_a25f62
- Use: Code samples, CLI commands, syntax highlighting blocks


## 4b. Component Behaviors (State Matrix)

### Interaction State Narrative

- **Button**:
  - **hover:** bg #166534 → #14532d
- **Card**:
  - **hover:** shadow level changes
- **FooterLink**:
  - **hover:** text #a0a0a0 → #f7f7f7

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

```yaml
component-behaviors:
  button:
    default:
      bg: "rgb(22, 101, 52)"
      fg: "rgb(255, 255, 255)"
      border: "1px solid rgb(20, 20, 20)"
    hover:
      bg: "rgb(20, 83, 45)"
      fg: "rgb(255, 255, 255)"
      border: "1px solid rgb(20, 20, 20)"
    focus:
      bg: "rgb(22, 101, 52)"
      fg: "rgb(255, 255, 255)"
      border: "1px solid rgb(20, 20, 20)"
  link:
    default:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(244, 246, 146)"
  card:
    default:
      bg: "rgba(20, 20, 20, 0.5)"
      fg: "rgb(255, 255, 255)"
      border: "1px solid rgba(65, 65, 65, 0.8)"
      shadow: "rgba(0, 0, 0, 0) 0px 0px 0px 0px, rgba(0, 0, 0, 0) 0px 0px 0"
    hover:
      bg: "rgba(20, 20, 20, 0.5)"
      fg: "rgb(255, 255, 255)"
      border: "1px solid rgba(65, 65, 65, 0.8)"
      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(22, 22, 0)"
  footerLink:
    default:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(160, 160, 160)"
    hover:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(247, 247, 247)"
```

**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: `Secondary`, `Dark / Solid`, `Ghost`, `Icon Button`, `Ghost`
- **DO NOT introduce new buttons variants** without justification

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

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

### 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 | 12px |
| sm | 16px |
| md | 24px |
| base | 32px |
| lg | 64px |
| 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 | 12px | Large rounded elements, pill segments |
| Xl | 12px | Category strips, featured containers |
| Full | 9999px | Pills, avatars, circular elements |

### Shape Language

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

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

**Full Radius Spectrum**: 0px, 2px, 4px, 6px, 7px, 8px, 10px, 12px (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** | `64px` | Within a section, between content groups |
| **card** | `24px` | Card padding, list-item spacing |
| **compact** | `16px` | Form fields, tight clusters, badge padding |
| **micro** | `12px` | 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:** 192px tall (not full-viewport)
- **Heading:** "The leadingdatabase for AI" — 96px center-aligned
- **CTAs:** none detected in hero (unusual — agent should verify)
- **Clone instruction:** Reproduce the **centered** layout. Use the heading font-size token at the documented size. No imagery needed for hero — text-driven.

### Navigation Pattern

- **Position:** static (scrolls with page)
- **Layout:** logo-left-links-left — Logo and links both on the left (CTAs typically right)
- **Height:** 40px
- **Logo:** ✓ present
- **Nav links:** 40 primary items
- **CTAs in nav:** 2
- **Clone instruction:** Build a static logo left links left navigation. Reserve 2 slots for primary CTAs.

### Card Grid Pattern

- **Card count:** 4 cards detected
- **Columns (desktop):** 5-up grid
- **Card dimensions:** 292×362px (aspect 0.81:1)
- **Gap:** 16px between cards
- **Content:** ✓ image
- **Image position:** top
- **Clone instruction:** Build a 5-column grid (desktop) with cards at ~0.81:1 aspect ratio. Each card has an image at the top.

### FAQ Pattern

- **Item count:** 5 questions
- **Format:** accordion (expand/collapse)
- **Layout:** single-column
- **Avg question length:** 39 chars
- **Clone instruction:** Build 5 expandable accordion items in a single-column layout.

### Footer Pattern

- **Columns:** 1
- **Links:** 56 total
- **Height:** 621px
- **Includes:** ✗ no newsletter | ✓ social icons |  ✓ copyright
- **Clone instruction:** Build a 1-column footer with ~56 links per column, social media links, and a copyright line.

## 6. Depth & Elevation

| Level | Treatment | Use |
|-------|-----------|-----|
| Flat (Level 0) | No shadow | Page background, content blocks |
| Layered (Level 1) | <br>`rgba(0, 0, 0, 0) 0px 0px 0px 0px`,<br>`rgba(0, 0, 0, 0) 0px 0px 0px 0px`,<br>`rgba(0, 0, 0, 0.1) 0px 10px 15px -3px`,<br>`rgba(0, 0, 0, 0.1) 0px 4px 6px -4px` | Cards, elevated surfaces |
| Layered (Level 2) | <br>`rgba(0, 0, 0, 0) 0px 0px 0px 0px`,<br>`rgba(0, 0, 0, 0) 0px 0px 0px 0px`,<br>`rgba(0, 0, 0, 0.1) 0px 1px 3px 0px`,<br>`rgba(0, 0, 0, 0.1) 0px 1px 2px -1px` | Cards, elevated surfaces |
| Layered (Level 3) | <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.05) 0px 1px 2px 0px` | Cards, elevated surfaces |
| Inset (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.06) 0px 4px 4px 0px`,<br>`rgba(0, 0, 0, 0.14) 0px 4px 25px 0px inset` | Buttons, pressed-state elements |

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

## 7. Motion & Interaction

### Dominant Easing Curves

| Curve | Semantic Name |
|-------|---------------|
| `cubic-bezier(0.4,0,0.2,1)` | Material Standard — Balanced |
| `ease-in-out` | Ease In-Out — Symmetric |
| `ease-in` | Ease In — Accelerating |

### Duration Scale

| Value | Tier | Typical Use |
|-------|------|-------------|
| `3ms` | Instant | State toggles, instant feedback |
| `150ms` | Fast | Hover states, micro-interactions |
| `200ms` | Normal | Panel open/close, navigation |
| `300ms` | Normal | Panel open/close, navigation |
| `400ms` | Slow | Hero animations, page transitions |
| `1s` | Cinematic | Splash, marketing reveals |

### Copy-Paste Transition Snippets

**Transform**
```css
transition: transform 1s, -webkit-transform 1s;
```

**All Props**
```css
transition: 0.003s ease-in-out;
```

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

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

### Keyframe Animation Catalog

| Animation Name | Type | Animated Props | Use Hint |
|----------------|------|----------------|----------|
| `fadeInOut` | Fade | opacity | Element entrance |
| `marqueeLeftTransform` | Slide | transform | UI transition |
| `ping` | Fade + Move | transform, opacity | Attention / status |
| `pulse` | Fade | opacity | Attention / status |
| `spin` | Rotate / Spin | transform | Loading indicator |
| `swiper-preloader-spin` | Rotate / Spin | transform | Loading indicator |
| `hero-entrance_heroSlideUp__dtoT7` | Fade + Move | opacity, transform | Panel / drawer enter |

### Motion Fingerprint

- **Speed Character**: Deliberate & Calm (median duration: `300ms`)
- **Dominant Easing**: custom cubic-bezier curves
- **Animation Library**: 7 unique animations (7 total including variants)

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

## 8. Do's and Don'ts

### Do
- Use dark background (`#1f1f1c`) as the foundation — this is a dark-mode-native design
- Use sans-serif as the primary typeface — it defines the brand personality
- Use the extracted shadow patterns for elevation — they are tuned to match the brand palette
- Use full-pill radius (9999px) only for specific elements (avatars, pills, toggles)
- Use #166534 (`#166534`) as the primary accent — it's the brand's signature interactive color
- Use 8px border-radius on buttons — the standard corner rounding for interactive elements
- Use 8px border-radius on cards — consistent with the grid card corners
- Maintain nav height at 40px — consistent vertical space for the navigation bar
- Transition button background to #14532d (`#14532d`) on hover — this is the extracted interactive state
- Keep the hero centered and text-driven — no decorative media, typography carries the message
- Each card includes a top image — imagery is part of the card identity, not optional
- Use a 5-column grid on desktop — density matters for this content type
- Use expandable accordion for the FAQ — saves vertical space and lets users self-navigate

### 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 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 use opacity or brightness filter for button hover — the design uses an explicit background color change
- Don't add hero illustrations or photos — they'll break the typographic restraint
- Don't make the nav sticky — this design lets it scroll away to maximize content focus


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

## 9. Responsive Behavior

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

### Token Diff — Desktop vs Mobile

| Element | Property | Desktop | Mobile |
|---------|----------|---------|--------|
| heading | font-size | `96px` | `40px` |
| heading | line-height | `96px` | `40px` |
| nav | height | `40px` | `240px` |
| button | width | `286px` | `342px` |
| card | width | `292px` | `358px` |

### Collapsing Strategy
- Headlines: 96px → 40px on mobile
- Navigation: horizontal links → hamburger menu on mobile
- Cards: multi-column → stacked vertical on mobile
- Footer: multi-column → stacked single column on mobile

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

- **Navigation collapses to hamburger** — 40 links visible on desktop, 6 on mobile (the rest hide behind a menu toggle).
- **Nav CTAs reduced** on mobile (2 → 0) — the design prioritizes content over conversion buttons at small sizes.
- **Card grid: 5-up → 1-up** — cards stack as viewport narrows, becoming a vertical list on mobile.

## 9b. Visual Tone & Photography

**Tone:** Illustration-driven

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

**Canonical Brand Image (OG):**
- https://clickhouse.com/_next/image?url=%2Fimages%2Fsocial_share.png&w=1200&h=630&q=80
  *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: 4.3:1 (ultra-wide cinematic)
- Rendered size: 241×56px
- *Use this aspect ratio + composition for your clone's hero — mimicking the proportion preserves the visual hierarchy.*

**Aspect Ratio Distribution:**
- Landscape (1.15–2.3): 12 (36%)
- Portrait (<0.87): 0 (0%)
- Square (0.87–1.15): 9 (27%)
- Ultra-wide (>2.3): 12 (36%)

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

**Average rendered image size:** 194×101px
**Above-fold image count:** 22 / 33

**Decorative Patterns Detected:**
- 7 multi-stop linear gradients (mesh-like, 3+ color stops) — the brand leans on rich color transitions for visual depth
- 2 large decorative SVG shapes (≥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: Near Black (`#1f1f1c`)
- Primary text: Pure White (`#ffffff`)
- Accent: #166534 (`#166534`)
- Border: Translucent Dim Gray (20%) (`rgba(96, 96, 96, 0.2)`)
- Font: sans-serif
- Body: 16px weight 400

### Example Component Prompts
- "Create a hero section on Near Black background (#1f1f1c). Headline at 96px sans-serif weight 900, line-height 1, color #ffffff."
- "Create the primary CTA button: `#166534` background, `#ffffff` text, 9999px border-radius, 12px 16px padding, 700 weight, sans-serif font."
- "Design a card on `rgba(20, 20, 20, 0.5)` background. Border: 1px solid rgba(65, 65, 65, 0.8). Radius: 8px. Shadow: use extracted shadow. Padding: 0px."
- "Build navigation: static on `#1f1f1c`. sans-serif 16px weight 400 for links."

### Iteration Guide
1. **Canvas**: Set the dark canvas to Near Black (`#1f1f1c`) — every component is composited against this exact base.
2. **Typography**: All type in sans-serif, weight range 400–900. Never exceed 900 — heavier weights break the brand's tonal restraint.
3. **Accent**: #166534 (`#166534`) is the sole interactive color. On hover → #4f5100 (`#4f5100`). 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 `0px`, cards at `8px`. Apply border-radius from the extracted scale only — don't invent intermediate values.
6. **Spacing**: Use the `--ca-space-*` token scale (12px–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-2: #1f1f1c;
  --ca-on-primary: #ffffff;
  --ca-ink-muted: #808080;
  --ca-primary: #166534;
  --ca-primary-hover: #4f5100;
  --ca-hairline: #606060;
  --ca-primary-focus: #141414;
}

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

/* Spacing & Radius */
:root {
  --ca-space-xxs: 2px;
  --ca-space-xs: 12px;
  --ca-space-sm: 16px;
  --ca-space-md: 24px;
  --ca-space-base: 32px;
  --ca-space-lg: 64px;
  --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: 12px;
  --ca-radius-xl: 12px;
  --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: 10007px
    width: full-bleed
    layout: block
    children: 3
  - section: header
    tag: header
    classes: ["bg-neutral-900/10", "md-mid:bg-neutral-900/10", "fixed", "top-0"]
    height: 107px
    width: full-bleed
    layout: block
    children: 2
    bg: "rgba(20, 20, 20, 0.1)"
  - section: main-content
    tag: main
    classes: ["readable-content"]
    height: 9279px
    width: full-bleed
    layout: block
    children: 11
  - section: unknown
    tag: div
    classes: ["section-container", "relative", "z-10", "pt-16"]
    height: 622px
    width: 1280px
    layout: block
    children: 4
    padding: "96px 32px 0px"
  - section: unknown
    tag: div
    classes: ["cc-type-opt-in", "cc-theme-edgeless", "cc-left"]
    height: 257px
    width: 336px
    layout: flex-column justify=normal
    children: 2
    bg: "rgb(20, 20, 20)"
    padding: "24px 0px"
  - section: hero
    tag: div
    classes: ["relative", "z-10", "mx-auto", "-mb-12"]
    height: 94px
    width: 672px
    layout: block
    children: 1
  - section: unknown
    tag: div
    classes: ["group/container", "relative"]
    height: 172px
    width: full-bleed
    layout: block
    children: 3
  - section: unknown
    tag: div
    classes: ["carousel-container", "-my-2", "text-black", "sm:-my-3"]
    height: 172px
    width: full-bleed
    layout: block
    children: 2
  - section: unknown
    tag: div
    classes: ["swiper-wrapper"]
    height: 86px
    width: full-bleed
    layout: flex-row justify=normal
    children: 31
  - section: unknown
    tag: div
    classes: ["swiper-wrapper"]
    height: 86px
    width: full-bleed
    layout: flex-row justify=normal
    children: 30
  - section: section-6
    tag: section
    classes: ["mb-16", "bg-gradient-to-br", "from-white/5", "to-50%"]
    height: 573px
    width: full-bleed
    layout: block
    children: 1
    padding: "64px 0px 0px"
  - section: unknown
    tag: div
    classes: ["section-container"]
    height: 509px
    width: 1280px
    layout: block
    children: 2
    padding: "0px 32px"
  - section: unknown
    tag: div
    classes: ["glare-wrapper"]
    height: 362px
    width: 292px
    layout: block
    children: 1
  - section: unknown
    tag: div
    classes: ["glare-wrapper"]
    height: 362px
    width: 292px
    layout: block
    children: 1
  - section: unknown
    tag: div
    classes: ["glare-wrapper"]
    height: 362px
    width: 292px
    layout: block
    children: 1
  - section: unknown
    tag: div
    classes: ["glare-wrapper"]
    height: 362px
    width: 292px
    layout: block
    children: 1
  - section: unknown
    tag: div
    classes: ["section-container", "my-16", "flex", "flex-row"]
    height: 1951px
    width: 1280px
    layout: flex-row justify=normal
    children: 2
    padding: "0px 32px"
  - section: unknown
    tag: div
    classes: ["section-container"]
    height: 787px
    width: 1280px
    layout: block
    children: 1
    padding: "0px 32px"
  - section: unknown
    tag: div
    classes: ["section-container", "flex", "justify-center"]
    height: 547px
    width: 1280px
    layout: flex-row justify=center
    children: 1
    padding: "0px 32px"
  - section: unknown
    tag: div
    classes: ["section-container", "bg-shadow-element", "flex", "w-full"]
    height: 791px
    width: 1280px
    layout: flex-column justify=space-between
    children: 3
    padding: "0px 64px"
  - section: unknown
    tag: div
    classes: ["section-container"]
    height: 662px
    width: 1280px
    layout: block
    children: 1
    padding: "0px 32px"
  - section: unknown
    tag: div
    classes: ["section-container", "flex", "w-full", "items-center"]
    height: 290px
    width: 1280px
    layout: flex-row justify=space-between
    children: 2
    padding: "0px 32px"
  - section: footer
    tag: footer
    classes: ["bg-neutral-900", "pb-8", "pt-16"]
    height: 621px
    width: full-bleed
    layout: block
    children: 1
    bg: "rgb(21, 21, 21)"
    padding: "64px 0px 32px"
  - section: navigation
    tag: nav
    classes: ["w-full"]
    height: 428px
    width: 811px
    layout: block
    children: 1
  - section: unknown
    tag: div
    classes: ["section-container", "space-y-11"]
    height: 525px
    width: 1280px
    layout: block
    children: 2
    padding: "0px 32px"
```

**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:
    - "Built for every modern data challenge"
    - "Build real-time data products that scale"
    - "Deploy your way"
    - "Join the 
100k+ developers using ClickHouse today"
  sub-headings:
    - "Real-time analytics"
    - "Blazing fast"
    - "Open
Source"
    - "ClickHouse Cloud"
  ctas:
    - "Allow cookies"
    - "Dismiss"
    - "Cookie preferences"
    - "Copy logo as SVG"
    - "Products"
    - "Real-time analytics"
    - "All use cases ->
->"
  navigation:
    - "Download full logo"
    - "Download logomark"
    - "English"
    - "Japanese"
    - "Products"
    - "Solutions"
    - "Real-time analytics"
    - "Observability"
    - "Data warehousing"
    - "Machine learning and GenAI"
  footer-links:
    - "ClickHouse Cloud"
```

**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: 26
    avg-ratio: 2.81
    common-aspect: "~16:6 banner"
    sample-alts:
      - "ClickHouse logo"
  thumbnail:
    count: 12
    avg-ratio: 1.00
    common-aspect: "~1:1 square"
    sample-alts:
      - "ClickHouse Cloud"
      - "ClickHouse BYOC"
      - "Postgres ClickHouse Cloud"
```

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

### Generic Card
```html
<div class="card">
  <!-- content -->
</div>
```
_Source pattern detected: padding `0px` · radius `8px` · 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.
- **1 parasitic shadow(s) detected** — colored box-shadows (not near-black) found in allShadows. These likely originate from browser extensions or third-party injected widgets (e.g. Grammarly, chat overlays), not from the site's own design system. Discard them when building.


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

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

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