supabase.com

DESIGN.md

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

---
version: alpha
name: supabase.com
description: "Light product system built on #fcfcfc with #2b825b as the primary CTA accent. Type anchored in Circular at 72px / weight 400. Extracted automatically from https://supabase.com/ — every value from getComputedStyle(), no approximation."
narrative: |
  supabase.com is built on a pure-white canvas (rgb(252, 252, 252)).
  The system uses #2b825b as the accent for primary actions and brand signals.
  Circular as the primary typeface.

colors:
  background: "#fcfcfc"
  surface-1: "#e8e8e8"
  surface-2: "#fdfdfd"
  ink: "#171717"
  ink-muted: "rgba(23, 23, 23, 0.65)"
  ink-subtle: "#8a8f98"
  primary: "#2b825b"
  on-primary: "#ffffff"
  primary-hover: "#8ed2af"
  hairline: "#dfdfdf"

typography:
  display-xl:
    fontFamily: "Circular"
    fontSize: 72px
    fontWeight: 400
    lineHeight: 1
    letterSpacing: 0
  display-md:
    fontFamily: "Circular"
    fontSize: 36px
    fontWeight: 400
    lineHeight: 1.2
    letterSpacing: 0
  headline:
    fontFamily: "Circular"
    fontSize: 18px
    fontWeight: 400
    lineHeight: 1.56
    letterSpacing: 0
  button:
    fontFamily: "Circular"
    fontSize: 14px
    fontWeight: 400
    lineHeight: 1.43
    letterSpacing: 0

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

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

components:
  button-ghost:
    backgroundColor: "transparent"
    textColor: "#525252"
    typography: "{typography.button}"
    rounded: "{rounded.none}"
  button-light--invert:
    backgroundColor: "{colors.surface-2}"
    textColor: "{colors.ink-muted}"
    typography: "{typography.button}"
    rounded: "{rounded.xs}"
    padding: 4px 10px
  button-ghost:
    backgroundColor: "transparent"
    textColor: "{colors.ink-muted}"
    typography: "{typography.button}"
    rounded: "{rounded.xs}"
    padding: 4px 10px
  card-standard-card:
    backgroundColor: "{colors.on-primary}"
    typography: "{typography.headline}"
    rounded: "{rounded.lg}"
    padding: 24px
  input-text-input:
    backgroundColor: "#000000"
    textColor: "{colors.ink-muted}"
    typography: "{typography.button}"
    rounded: "{rounded.xs}"
    padding: 8px
  navigation-main-nav:
    backgroundColor: "transparent"
    typography: "{typography.headline}"
    rounded: "{rounded.none}"
  tab-ghost-tab:
    backgroundColor: "transparent"
    textColor: "{colors.ink-muted}"
    typography: "{typography.headline}"
    rounded: "{rounded.none}"
  tab-pill-tab:
    backgroundColor: "{colors.surface-2}"
    textColor: "{colors.ink-muted}"
    typography: "{typography.button}"
    rounded: "{rounded.pill}"
    padding: 8px 32px
  alert-alert-banner:
    backgroundColor: "{colors.background}"
    textColor: "{colors.ink-muted}"
    typography: "{typography.button}"
    rounded: "{rounded.sm}"
    padding: 12px 20px

extracted_at: "2026-05-30T20:40:04.404Z"
completeness: 86
scoreVersion: "v2"

---

# Design System — supabase.com
> Extracted automatically by Clone Architect from https://supabase.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(252, 252, 252)` is the page background. Every component composits against this.
> - **Accent**: `#2b825b` 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

supabase.com sits on a off-white canvas (`#fcfcfc`), a neutral foundation calibrated for sustained reading and component contrast. 

Typography is anchored in **Circular**. Headlines run at a remarkably light weight (400) — restraint over assertion, creating an editorial calm that invites reading rather than demanding it. 

Body text reads in Near Black (`#171717`) — softened from pure black, a small but deliberate detail that lowers reading friction. **Teal** (`#2b825b`) provides interactive distinction without visual aggression. Elevation is built from multi-layer shadow stacks — each level combines several blurred layers at varying offsets to simulate the way light actually falls on stacked surfaces, not the simulated drop-shadow of cheap interfaces. 
Motion design uses smooth easing curves for polished state transitions. 

**Key Characteristics:**
- Background: Off-White (`#fcfcfc`)
- Primary typeface: custom-font
- Primary text: Near Black (`#171717`)
- Accent: Teal (`#2b825b`)
- Display: 72px weight 400
- Shadow system: 3 distinct elevation levels
- Custom fonts loaded: custom-font

## 2. Color Palette & Roles

### Background & Surface
- **Off-White** (`#fcfcfc`): Page background (primary)
- **Light Gray** (`#dfdfdf`): Surface / elevated background
- **Light Gray** (`#e8e8e8`): Surface / elevated background
- **Pure White** (`#fdfdfd`): Surface / elevated background
- **Light Gray** (`#ededed`): Surface / elevated background

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

### Accent & Interactive
- **Brand 1100** (`#2b825b`): Accent / interactive (CSS var)
- **Brand 700** (`#8ed2af`): Accent / interactive (CSS var)
- **Brand 1000** (`#40bf86`): Accent / interactive (CSS var)
- **Brand 100** (`#fafefd`): Accent / interactive (CSS var)
- **Brand 1200** (`#122b20`): Accent / interactive (CSS var)
- **Brand 900** (`#3fcf8e`): Accent / interactive (CSS var)
- **Brand 800** (`#34b27b`): Accent / interactive (CSS var)

### Border & Divider
- **Silver** (`#d4d4d4`): Borders / dividers
- **Silver** (`#c7c7c7`): Borders / dividers

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

- `#525252` — Slate
- `#3ecf8e` — #3ecf8e
- `#72e3ad` — #72e3ad
- `#707070` — Stone
- `#ffffff` — White
- `#b2b2b2` — Silver
- `#f3f3f3` — Light Gray
- `#a9f1ca` — #a9f1ca
- `#00bb68` — Emerald
- `#f9f1fe` — Ghost White
- `#add6ff` — Light Blue
- `#f9d8ec` — Soft Pink
- `#ffcca7` — Pink
- `#fa934e` — Tangerine
- `#5746af` — #5746af
- `#96c7f2` — Baby Blue
- `#be93e4` — Plum
- `#fff4d5` — Beige
- `#ccebd7` — #ccebd7
- `#e1f0ff` — Light Gray
- `#eceef0` — Light Gray
- `#e93d82` — Cherry
- `#687076` — Dim Gray
- `#fdfdfc` — Pure White
- `#eeeeee` — Light Gray
- `#e3ccf4` — Soft Pink
- `#cd1d8d` — #cd1d8d
- `#e4defc` — Light Gray
- `#3d0d1d` — Near Black
- `#30a46c` — Teal
- `#fffcfd` — Snow
- `#0081f1` — #0081f1
- *…+171 more in `raw-css.json` (`desktop.allColors`).*

### CSS Custom Properties (Design Tokens)

**Font Family Token**
- `--font-family-body`: `Inter`
- `--default-font-family`: `Circular,custom-font,Helvetica Neue,Helvetica,Arial,sans-serif`
- `--default-mono-font-family`: `Source Code Pro,Office Code Pro,Menlo,monospace`

**Primary Brand Color**
- `--color-brand-600`: `hsl(156.5deg 86.5% 26.1%)`
- `--color-brand-300`: `hsl(147.5deg 72% 80.4%)`
- `--color-brand-200`: `hsl(147.6deg 72.5% 90%)`
- `--color-brand-1100`: `#2b825b`

**Shadow Token**
- `--tw-inset-ring-shadow`: `0 0 #0000`
- `--tw-inset-shadow`: `0 0 #0000`
- `--tw-shadow-alpha`: `100%`
- `--tw-ring-shadow`: `0 0 #0000`

**Warning**
- `--color-amber-300`: `#fff4d5`
- `--color-amber-1000`: `#ffa01c`
- `--color-yellow-1100`: `#946800`
- `--color-amber-100`: `#fefdfb`

**Spacing Token**
- `--spacing-scale`: `2px`
- `--tw-space-x-reverse`: `0`
- `--spacing-lg`: `32px`
- `--card-padding-x-md`: `1.5rem`

**Success**
- `--color-green-500`: `#ccebd7`
- `--color-green-900`: `#30a46c`
- `--color-green-400`: `#ddf3e4`
- `--color-green-100`: `#fbfefc`

**Border Radius Token**
- `--borderradius-lg`: `8px`
- `--radius-sm`: `.25rem`
- `--borderradius-sm`: `4px`
- `--radius-md`: `.375rem`

**Error / Destructive**
- `--color-red-1200`: `#381316`
- `--color-red-1100`: `#cd2b31`
- `--color-red-800`: `#eb9091`
- `--color-red-500`: `#fdd8d8`

**Border**
- `--color-border`: `hsl(0deg 0% 87.5%)`

**Motion Token**
- `--tw-animation-direction`: `normal`
- `--tw-animation-fill-mode`: `none`
- `--tw-animation-delay`: `0s`

**Font Weight Token**
- `--font-weight-extrabold`: `800`
- `--font-weight-medium`: `500`
- `--font-weight-normal`: `400`
- `--font-weight-bold`: `700`

**Z-Index Token**
- `--z-index`: `1`

**Other tokens**
- `--color-purple-300`: `#f9f1fe`
- `--colors-slate-light-alpha-200`: `#05294d08`
- `--colors-slate-dark-300`: `192deg 7.2% 13.5%`
- `--color-pink-500`: `#f9d8ec`
- `--color-orange-600`: `#ffcca7`
- `--color-orange-800`: `#fa934e`
- `--color-neutral-600`: `oklch(43.9% 0 0)`
- `--color-violet-1100`: `#5746af`

## 3. Typography Rules

### Font Families
- **Primary**: `Circular`
- **Secondary**: `custom-font`
- **Font 3**: `Source Code Pro`

### Custom Fonts Loaded
- **custom-font** weight 400 (normal)
- **custom-font** weight 500 (normal)

### Typography Hierarchy

| Role | Font | Size | Weight | Line Height | Letter Spacing | Notes |
|------|------|------|--------|-------------|----------------|-------|
| Display Hero | Circular | 72px | 400 | 1 | normal | Main headline (h1) |
| Sub-heading | Circular | 36px | 400 | 1.2 | normal | Third-level heading (h3) |
| Label Heading | Circular | 18px | 400 | 1.56 | normal | Small heading (H4) |
| Label Heading | Circular | 16px | 400 | 1.5 | normal | Small heading (H6) |
| Button | Circular | 14px | 400 | 1.43 | normal | Button label (14px) |
| Button | Circular | 14px | 500 | 1.14 | normal | Button label (14px) |
| Button Small | Circular | 12px | 400 | 1.33 | normal | Button label (12px) |

### Font Weight Scale

CSS custom properties define 6 explicit weight steps:
- `--font-weight-light`: `300` — Light
- `--font-weight-normal`: `400` — Regular
- `--font-weight-medium`: `500` — Medium
- `--font-weight-semibold`: `600` — SemiBold
- `--font-weight-bold`: `700` — Bold
- `--font-weight-extrabold`: `800` — ExtraBold

### Full Font Size Scale

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

> 1 size(s) detected outside the sampled hierarchy (24px). 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: `#525252`
- Padding: 0px
- Radius: 0px
- Font: 14px weight 400
- Use: Subtle action, toolbar, nav button

**Light / Invert**
- Background: `#fdfdfd` `{colors.surface-2}`
- Text: `#171717` `{colors.ink-muted}`
- Padding: 4px 10px
- Radius: 6px
- Border: 1px solid rgb(212, 212, 212)
- Font: 12px weight 400
- Use: Bright CTA on dark sections

**Ghost**
- Background: `transparent`
- Text: `#171717` `{colors.ink-muted}`
- Padding: 4px 10px
- Radius: 6px
- Border: 1px solid rgba(0, 0, 0, 0)
- Shadow: `rgba(0, 0, 0, 0) 0px 0px 0px 0px, rgba(0, 0, 0, 0) 0px 0px 0px 0px, rgba(0, 0, 0...`
- Font: 12px weight 400
- Use: Subtle action, toolbar, nav button

**Primary Brand**
- Background: `#72e3ad`
- Text: `#171717` `{colors.ink-muted}`
- Padding: 4px 10px
- Radius: 6px
- Border: 1px solid oklab(0.685565 -0.144466 0.057858 / 0.75)
- Font: 12px weight 400
- Use: Primary CTA / brand action

**Primary Brand**
- Background: `#72e3ad`
- Text: `#171717` `{colors.ink-muted}`
- Padding: 8px 16px
- Radius: 6px
- Border: 1px solid oklab(0.685565 -0.144466 0.057858 / 0.75)
- Font: 14px weight 400
- Use: Primary CTA / brand action

**Light / Invert**
- Background: `#fdfdfd` `{colors.surface-2}`
- Text: `#171717` `{colors.ink-muted}`
- Padding: 8px 16px
- Radius: 6px
- Border: 1px solid rgb(212, 212, 212)
- Font: 14px weight 400
- Use: Bright CTA on dark sections

### Cards & Containers

**Standard Card**
- Background: `#ffffff` `{colors.on-primary}`
- Padding: 24px
- Radius: 16px
- Border: 1px solid rgb(223, 223, 223)
- Use: Content containers, listing items

### Inputs & Forms

**Text Input**
- Background: `#000000`
- Text: `#171717` `{colors.ink-muted}`
- Padding: 8px
- Radius: 6px
- Border: 1px solid rgb(199, 199, 199)
- Font: 14px weight 400
- Use: Text fields, search inputs
- Focus: boxShadow: `rgba(0, 0, 0, 0) 0px 0px 0px 0px, rgba(0, 0, 0, 0) 0px 0px 0`, outline: `rgba(0, 0, 0, 0) none 2px`

### Navigation

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

### Tabs

**Ghost Tab**
- Background: `transparent`
- Text: `#171717` `{colors.ink-muted}`
- Padding: 0px
- Radius: 0px
- Font: 16px weight 400
- Use: Navigation tabs, filter tabs

**Pill Tab**
- Background: `#fdfdfd` `{colors.surface-2}`
- Text: `#171717` `{colors.ink-muted}`
- Padding: 8px 32px
- Radius: 9999px
- Border: 1px solid rgb(23, 23, 23)
- Font: 14px weight 400
- Use: Navigation tabs, filter tabs

### Alerts

**Alert Banner**
- Background: `#fcfcfc` `{colors.background}`
- Text: `#171717` `{colors.ink-muted}`
- Padding: 12px 20px
- Radius: 8px
- Border: 1px solid rgb(232, 232, 232)
- Font: 14px weight 400
- Use: System alert, banner notification, toast


## 4b. Component Behaviors (State Matrix)

### Interaction State Narrative

- **Input**:
  - **focus:** shadow added

*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(82, 82, 82)"
  input:
    default:
      bg: "oklab(0.204404 0.00000931323 0.00000409782 / 0.026)"
      fg: "rgb(23, 23, 23)"
      border: "1px solid rgb(199, 199, 199)"
    focus:
      bg: "oklab(0.204404 0.00000931323 0.00000409782 / 0.026)"
      fg: "rgb(23, 23, 23)"
      border: "1px solid rgb(199, 199, 199)"
      shadow: "rgba(0, 0, 0, 0) 0px 0px 0px 0px, rgba(0, 0, 0, 0) 0px 0px 0"
  link:
    default:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(23, 23, 23)"
    hover:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(23, 23, 23)"
  card:
    default:
      bg: "rgb(255, 255, 255)"
      fg: "rgb(23, 23, 23)"
      border: "1px solid rgb(223, 223, 223)"
  navLink:
    default:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(23, 23, 23)"
  tab:
    default:
      bg: "rgb(253, 253, 253)"
      fg: "rgb(23, 23, 23)"
      border: "1px solid rgb(23, 23, 23)"
  footerLink:
    default:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(0, 187, 104)"
    hover:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(0, 187, 104)"
```

**Agent usage**: Validate generated components against this matrix. If your output's `:hover` state changes properties not listed here, you are off-brand.


## 4c. Component Vocabulary (Closed System)

*This brand uses ONLY the following component vocabulary. Introducing new variants without justification breaks the system's tonal coherence.*

### Buttons
- **6 shape(s)** in this system: `Ghost`, `Light / Invert`, `Ghost`, `Primary Brand`, `Primary Brand`
- **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

### Inputs & Forms
- **1 shape(s)** in this system: `Text Input`
- **DO NOT introduce new inputs & forms variants** without justification

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

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

### Alerts
- **1 shape(s)** in this system: `Alert Banner`
- **DO NOT introduce new alerts variants** without justification

## 5. Layout Principles

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

### Grid
Single column, centered content

### Max Width
1128px

### Spacing System
Compact spacing — information density prioritized

| Token | Value |
|-------|-------|
| xxs | 2px |
| xs | 4px |
| sm | 8px |
| md | 16px |
| base | 32px |
| lg | 64px |
| 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 | 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` |
| Cards & Containers | `16px` |
| Inputs & Forms | `6px` |
| Navigation | `none` |
| Tabs | `0px` |
| Alerts | `8px` |
| Page Body | `0px` |
| Primary Input | `6px` |

**Shape Personality**: Generously Rounded — Soft, friendly corners (8px+). Approachable, consumer-facing feel.

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

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

## 5c. Widget & Structure Library

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

**4/8 structural patterns detected.**

### Hero Pattern

- **Composition:** centered — Centered composition — heading + subheading + CTAs stacked vertically, content centered horizontally. Common for SaaS marketing pages.
- **Viewport coverage:** full-viewport hero (≥70% screen height)
- **Heading:** "Build in a weekendScale to millions" — 72px center-aligned
- **Subheading:** "Supabase is the Postgres development platform. Start your project with a Postgres database, Authentication, instant APIs, Edge Functions, Realtime sub"
- **CTAs:** 3 (primary: "State of Startups 2026: Take the survey.")
- **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:** 65px
- **Logo:** ✓ present
- **Nav links:** 3 primary items
- **CTAs in nav:** 3
- **Clone instruction:** Build a static logo left links left navigation. Reserve 3 slots for primary CTAs.

### Card Grid Pattern

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

### Footer Pattern

- **Columns:** 2
- **Links:** 60 total
- **Height:** 942px
- **Includes:** ✓ newsletter signup | ✓ social icons |  ✓ copyright
- **Clone instruction:** Build a 2-column footer with ~30 links per column, newsletter signup, 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) 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) 0px 0px 0px 0px`,<br>`rgba(0, 0, 0, 0) 0px 0px 0px 0px`,<br>`rgba(0, 0, 0, 0) 0px 0px 0px 0px` | 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) 0px 0px 0px 0px`,<br>`rgba(0, 0, 0, 0) 0px 0px 0px 0px`,<br>`rgba(0, 0, 0, 0.1) 0px 4px 6px -1px`,<br>`rgba(0, 0, 0, 0.1) 0px 2px 4px -2px` | 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

### Easing System

| CSS Variable | Curve | Semantic Name |
|--------------|-------|---------------|
| `--ease-in` | `cubic-bezier(.4,0,1,1)` | Custom Ease — Balanced |
| `--default-transition-timing-function` | `cubic-bezier(.4,0,.2,1)` | Ease Out — Decelerating |
| `--ease-out` | `cubic-bezier(0,0,.2,1)` | Ease Out — Decelerating |
| `--ease-in-out` | `cubic-bezier(.4,0,.2,1)` | Ease Out — Decelerating |
| `--tw-ease` | `cubic-bezier(0,0,.2,1)` | Ease Out — Decelerating |

### Duration Scale

| CSS Variable | Value | Tier |
|--------------|-------|------|
| `--default-transition-duration` | `.15s` | Fast |
| `--tw-duration` | `.2s` | Normal |

### Copy-Paste Transition Snippets

**Transform**
```css
transition: transform 0.4s, opacity 0.4s, height 0.4s, box-shadow 0.2s;
```

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

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

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

### Keyframe Animation Catalog

| Animation Name | Type | Animated Props | Use Hint |
|----------------|------|----------------|----------|
| `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 |

### Motion Fingerprint

- **Speed Character**: Deliberate & Calm (median duration: `300ms`)
- **Dominant Easing**: custom cubic-bezier curves
- **Animation Library**: 4 unique animations (4 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 Off-White (`#fcfcfc`) as the page background — it's intentionally not pure white
- Use Near Black (`#171717`) for text — not pure black, it's warmer and more readable
- Use Circular 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 Teal (`#2b825b`) as the primary accent — it's the brand's signature interactive color
- Use 6px border-radius on buttons — the standard corner rounding for interactive elements
- Apply 24px padding inside cards — matches the design system's content breathing room
- Use 16px border-radius on cards — consistent with the grid card corners
- Style form inputs with a `1px solid rgb(199, 199, 199)` border — use border-based inputs, not floating labels or underline-only
- Maintain nav height at 65px — consistent vertical space for the navigation bar
- Respect the 4px–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
- Keep the hero centered and text-driven — no decorative media, typography carries the message
- Include exactly 3 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
- Include a newsletter signup in the footer — email capture is part of the conversion funnel

### Don't
- Don't use pure white (`#ffffff`) as a page background — the warm tone is part of the brand identity
- Don't use pure black (`#000000`) for text — the near-black adds warmth
- Don't substitute with generic sans-serif or serif — the custom font carries the brand
- Don't invent new shadow values — use only the extracted shadow levels
- Don't introduce additional saturated accent colors — the palette is intentionally controlled
- Don't remove the input border — the border is the primary affordance indicator for form fields
- Don't collapse or hide the nav on scroll without an explicit scroll-triggered animation — the design uses fixed nav presence
- 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(252, 252, 252)` as the base canvas"
    why: "Every component is designed to composit against this exact tone"
    test: "document.body.style.backgroundColor === 'rgb(252, 252, 252)'"
  - id: brand-accent-001
    type: do
    rule: "Reserve `#2b825b` for primary CTAs and brand-mark signals only"
    why: "Single chromatic assertion device — overuse dilutes meaning"
    test: "querySelectorAll('[style*=\"#2b825b\"]').length <= 3 per fold"
```

## 9. Responsive Behavior

### Breakpoints
| Name | Width | Key Changes |
|------|-------|-------------|
| Mobile Large | 600px | Expanded mobile layout |

### Token Diff — Desktop vs Mobile

| Element | Property | Desktop | Mobile |
|---------|----------|---------|--------|
| heading | font-size | `72px` | `36px` |
| heading | line-height | `72px` | `40px` |
| button | width | `auto` | `102px` |
| card | width | `auto` | `309.812px` |

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

### Touch Targets
- Buttons: 0px padding
- Navigation: adequate spacing between items
- Interactive elements: minimum 44px touch target recommended

### Collapsing Narrative

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

- **Navigation collapses to hamburger** — 3 links visible on desktop, 0 on mobile (the rest hide behind a menu toggle).
- **Nav CTAs reduced** on mobile (3 → 0) — the design prioritizes content over conversion buttons at small sizes.
- **Footer columns collapse:** 2 columns (desktop) → 1 column (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://supabase.com/images/og/supabase-og.png (800×600px)
  *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:1 (square / portrait)
- Rendered size: 398×398px
- Alt text: "Supabase Postgres database"
- *Use this aspect ratio + composition for your clone's hero — mimicking the proportion preserves the visual hierarchy.*

**Aspect Ratio Distribution:**
- Landscape (1.15–2.3): 1 (9%)
- Portrait (<0.87): 8 (73%)
- Square (0.87–1.15): 2 (18%)

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

**Average rendered image size:** 283×364px
**Above-fold image count:** 4 / 11

**Decorative Patterns Detected:**
- 2 multi-stop linear gradients (mesh-like, 3+ color stops) — the brand leans on rich color transitions for visual depth
- 8 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:** Decorative SVG accents are part of the brand — generate or source blob/illustration shapes to scatter behind content.

**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: Off-White (`#fcfcfc`)
- Primary text: Near Black (`#171717`)
- Accent: Teal (`#2b825b`)
- Border: Light Gray (`#dfdfdf`)
- Font: Circular
- Body: 16px weight 400

### Example Component Prompts
- "Create a hero section on Off-White background (#fcfcfc). Headline at 72px Circular weight 400, line-height 1, color #171717."
- "Create the primary CTA button: `#2b825b` background, `#171717` text, 6px border-radius, 4px 10px padding, 500 weight, Circular font."
- "Design a card on `#ffffff` background. Border: 1px solid rgb(223, 223, 223). Radius: 16px. Shadow: none. Padding: 24px."
- "Build navigation: relative on `#fcfcfc`. Circular 16px weight 400 for links."

### Iteration Guide
1. **Canvas**: Set the light canvas to Off-White (`#fcfcfc`) — every component is composited against this exact base.
2. **Typography**: All type in Circular, weight range 300–800. Never exceed 800 — heavier weights break the brand's tonal restraint.
3. **Accent**: Teal (`#2b825b`) is the sole interactive color. On hover → #8ed2af (`#8ed2af`). Use CSS transitions, not opacity/brightness filters.
4. **Motion**: All transitions use `cubic-bezier(0.4,0,0.2,1)`. Timing: 150ms for micro-interactions, 200ms for layout changes. Never use linear for UI transitions — preserve the brand's easing personality.
5. **Shape**: CTAs at `6px`, cards at `16px`. Apply border-radius from the extracted scale only — don't invent intermediate values.
6. **Spacing**: Use the `--ca-space-*` token scale (4px–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-background: #fcfcfc;
  --ca-surface-1: #e8e8e8;
  --ca-surface-2: #fdfdfd;
  --ca-ink-muted: #171717;
  --ca-ink-subtle: #8a8f98;
  --ca-primary: #2b825b;
  --ca-on-primary: #ffffff;
  --ca-primary-hover: #8ed2af;
  --ca-hairline: #dfdfdf;
}

/* Typography */
:root {
  --ca-font-primary: "Circular", system-ui, sans-serif;
  --ca-text-display: 72px;
  --ca-text-button: 14px;
}

/* Spacing & Radius */
:root {
  --ca-space-xxs: 2px;
  --ca-space-xs: 4px;
  --ca-space-sm: 8px;
  --ca-space-md: 16px;
  --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: 6px;
  --ca-radius-sm: 8px;
  --ca-radius-md: 12px;
  --ca-radius-lg: 16px;
  --ca-radius-xl: 16px;
  --ca-radius-full: 9999px;
}

/* Motion */
:root {
  --ca-ease-in: cubic-bezier(.4,0,1,1);
  --ca-ease-out: cubic-bezier(0,0,.2,1);
  --ca-ease-in-out: cubic-bezier(.4,0,.2,1);
}
```


## 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: 7684px
    width: full-bleed
    layout: block
    children: 6
  - section: main-content
    tag: main
    classes: ["relative"]
    height: 6742px
    width: full-bleed
    layout: block
    children: 12
  - section: unknown
    tag: div
    classes: ["sm:py-18", "container", "relative", "mx-auto"]
    height: 670px
    width: 1280px
    layout: block
    children: 1
    padding: "96px 80px"
  - section: unknown
    tag: div
    classes: ["sm:py-18", "container", "relative", "mx-auto"]
    height: 952px
    width: 1280px
    layout: grid: 12-col gap=12px
    children: 8
    padding: "0px 80px 96px"
  - section: unknown
    tag: div
    classes: ["sm:py-18", "container", "relative", "mx-auto"]
    height: 282px
    width: 1280px
    layout: block
    children: 1
    padding: "96px 80px"
  - section: unknown
    tag: div
    classes: ["sm:py-18", "container", "relative", "mx-auto"]
    height: 362px
    width: 1280px
    layout: flex-row justify=space-between
    children: 2
    padding: "96px 80px 32px"
  - section: unknown
    tag: div
    classes: ["sm:py-18", "container", "relative", "mx-auto"]
    height: 293px
    width: 1280px
    layout: block
    children: 1
    padding: "128px 80px 0px"
  - section: unknown
    tag: div
    classes: ["sm:py-18", "container", "relative", "mx-auto"]
    height: 675px
    width: 1400px
    layout: block
    children: 2
    padding: "24px 80px 0px"
  - section: unknown
    tag: div
    classes: ["sm:py-18", "container", "relative", "mx-auto"]
    height: 1124px
    width: 1280px
    layout: block
    children: 2
    padding: "96px 80px"
  - section: unknown
    tag: div
    classes: ["sm:py-18", "container", "relative", "mx-auto"]
    height: 261px
    width: 1280px
    layout: flex-column justify=normal
    children: 3
    padding: "96px 80px 0px"
  - section: unknown
    tag: div
    classes: ["sm:py-18", "container", "relative", "mx-auto"]
    height: 524px
    width: 1400px
    layout: block
    children: 3
    padding: "24px 0px 0px"
  - section: unknown
    tag: div
    classes: ["sm:py-18", "container", "relative", "mx-auto"]
    height: 429px
    width: 1280px
    layout: flex-column justify=normal
    children: 3
    padding: "96px 80px"
  - section: footer
    tag: footer
    height: 942px
    width: full-bleed
    layout: block
    children: 3
    bg: "rgb(253, 253, 253)"
  - section: unknown
    tag: div
    classes: ["sm:py-18", "container", "relative", "mx-auto"]
    height: 100px
    width: 1280px
    layout: grid: 3-col gap=112px
    children: 2
    padding: "40px 80px"
  - section: unknown
    tag: div
    classes: ["sm:py-18", "container", "relative", "mx-auto"]
    height: 841px
    width: 1280px
    layout: block
    children: 2
    padding: "96px 80px"
```

**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:
    - "Postgres Database"
    - "Open source from day one"
  sub-headings:
    - "Trusted by the world’s most innovative companies."
    - "Start building in seconds"
    - "Stay productive and manage your app
without leaving the dashboard"
  ctas:
    - "Accept"
    - "Opt out"
    - "Privacy settings"
    - "Product"
    - "Pricing"
    - "103K"
    - "Sign in"
    - "Start your project"
  navigation:
    - "Pricing"
    - "Docs"
    - "Blog"
    - "103K"
    - "Sign in"
    - "Start your project"
  footer-links:
    - "More on Security"
    - "Twitter"
    - "Pricing"
```

**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: 43
    avg-ratio: 2.17
    common-aspect: "~16:9 landscape"
    sample-alts:
      - "mozilla"
      - "github"
      - "1password"
```

**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">
  Accept
</button>
```
_Source pattern detected: padding `4px 10px` · radius `6px` · weight `400`_

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

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

- **Limited breakpoint data** — fewer than 3 media query breakpoints detected. The site may use fluid CSS (clamp/vw) or container queries for responsiveness rather than traditional breakpoints.


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

| Category | Score | Max | Detail |
|----------|-------|-----|--------|
| Colors & Palette | 22 | 25 | 16 named colors |
| Typography | 18 | 20 | 7 roles defined |
| Components | 20 | 20 | 6 specs extracted |
| Motion & Interaction | 15 | 15 | Keyframes present, easing vars |
| CSS Custom Properties | 10 | 10 | 661 vars |
| Responsive Breakpoints | 1 | 5 | 1 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.

*✅ No critical extraction gaps detected — high-confidence reproduction expected.*

### Per-section confidence

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

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