@w3kits-com/plugin-opendesign 0.1.8 → 0.1.9

package/dist/__w3kits/assets/design-systems/stripe/tokens.css

@@ -0,0 +1,295 @@
+/* ─────────────────────────────────────────────────────────────────────────
+ * design-systems/stripe/tokens.css
+ *
+ * Structured token bindings for "Inspired by Stripe" — fintech
+ * infrastructure dressed in deep navy, signature violet, and the
+ * blue-tinted multi-layer shadow that makes elevation feel branded.
+ *
+ * This file pre-compiles the values described in `DESIGN.md` into
+ * the schema shared with every OD design system. Agents generating a
+ * Stripe-flavored artifact should paste the `:root { … }` block
+ * verbatim into the first `<style>` of the artifact, then reference
+ * every value through `var(--name)` — never re-author the hex
+ * inline. The fixture in `components.html` is the round-trip proof
+ * that the token block alone is sufficient to render a recognisably
+ * Stripe page.
+ *
+ * Why this file exists:
+ *   DESIGN.md gives humans context ("Stripe Purple #533afd — primary
+ *   CTAs"), but agents have to translate prose names like
+ *   "Stripe Purple" into the standard token names the lint enforces
+ *   (`--accent`). This file pre-translates the brand once, so agents
+ *   copy structure rather than invent it.
+ *
+ * Schema notes (Stripe binds the shared schema in seven brand-
+ * specific ways — see `#Stripe N` tags inline for each decision):
+ *   #Stripe 1  — 3-tier surface stops short of a darker third tier;
+ *                `--surface-warm` binds to the cool-pale #f6f9fc that
+ *                Stripe uses behind nested panels (pricing rows, code
+ *                previews) rather than to a warm parchment.
+ *   #Stripe 2  — 3-tier foreground (navy heading / dark-slate label /
+ *                slate body). No fourth metadata tier — `--meta`
+ *                aliases `var(--muted)`.
+ *   #Stripe 3  — One border tier. `--border-soft` aliases `--border`
+ *                because DESIGN.md never describes a separate
+ *                row-separator weight.
+ *   #Stripe 4  — `--accent-hover` and `--accent-active` bind to the
+ *                hand-picked Purple Hover (#4434d4) and Purple Deep
+ *                (#2e2b8c) values from DESIGN.md, not the schema's
+ *                black-mix formula. Stripe's saturation needs the
+ *                exact shifts.
+ *   #Stripe 5  — Type scale ceiling is 56px (`--text-4xl`), not 64px.
+ *                DESIGN.md §3 puts the display hero at 56px / weight
+ *                300 with -1.4px tracking — Stripe's "whisper
+ *                authority". Adding 64px would push past the brand's
+ *                self-imposed ceiling.
+ *   #Stripe 6  — `--elev-raised` carries Stripe's trademark
+ *                multi-layer blue-tinted shadow
+ *                (`rgba(50,50,93,0.25) … , rgba(0,0,0,0.1) …`). This
+ *                is the single most brand-distinctive token in the
+ *                file; rebinding it to a neutral drop shadow erases
+ *                Stripe's atmosphere even when every color is right.
+ *   #Stripe 7  — `--focus-ring` is a layered purple halo — a thin
+ *                solid edge plus a translucent outer glow. Stripe's
+ *                focus state is more visible than the schema default
+ *                because keyboard navigation in payment flows is a
+ *                first-class concern.
+ *
+ * Brand-specific extensions (Layer C):
+ *   None. The dark brand section (`#1c1e54`) and ruby/magenta
+ *   gradient accents from DESIGN.md are *decorative* — they exist
+ *   only as one-off inline expressions in components.html, derived
+ *   from `--accent` via `color-mix(...)`. They are not promoted to
+ *   tokens because no cross-component rule needs to reference them
+ *   by name; promoting them would force every other brand to declare
+ *   matching slots.
+ * ─────────────────────────────────────────────────────────────────── */
+
+:root {
+  /* ─── Surface (3 levels — #Stripe 1) ──────────────────────────────
+   * Stripe sits on pure white. The "warm" tier is a cool-pale
+   * blue-tinted #f6f9fc (DESIGN.md's neutral-pill border colour) —
+   * it reads as a separate elevation under nested panels (pricing
+   * rows, code previews, sticky nav blur) without introducing a
+   * warm cast that would clash with the navy / violet palette.
+   * Brands without a tertiary surface tier should alias
+   * `--surface-warm` to `var(--surface)`; Stripe binds a real value
+   * because its dense data panels need that quiet separation. */
+  --bg:           #ffffff;
+  --surface:      #ffffff;
+  --surface-warm: #f6f9fc;  /* cool-pale blue — nested panels, sticky nav */
+
+  /* ─── Foreground ramp (3 tiers — #Stripe 2) ─────────────────────
+   * Deep Navy (`#061b31`) carries every heading — never pure
+   * black, never gray. DESIGN.md is explicit: "warmth matters".
+   * Dark Slate (`#273951`) is the form-label tier. Slate (`#64748d`)
+   * is the body / caption / placeholder colour.
+   *
+   * Stripe doesn't differentiate a fourth metadata tier, so
+   * `--meta` aliases `var(--muted)`. Brands like kami that need
+   * dates / timestamps / footnote text at a fourth shade may bind
+   * an independent value. */
+  --fg:    #061b31;          /* deep navy — headings, nav text, strong labels */
+  --fg-2:  #273951;          /* dark slate — form labels, sub-headings */
+  --muted: #64748d;          /* slate — body, placeholders, captions */
+  --meta:  var(--muted);     /* alias — Stripe has no separate metadata tier */
+
+  /* ─── Border (1 tier — #Stripe 3) ───────────────────────────────
+   * One border weight for everything: card edges, dividers,
+   * containers. DESIGN.md's purple/magenta/dashed border variants
+   * are *decorative* (drop-zones, themed badges), not row
+   * separators — they live inline in components.html and do not
+   * earn a slot in the schema. `--border-soft` aliases. */
+  --border:      #e5edf5;
+  --border-soft: var(--border);  /* alias — Stripe has one border weight */
+
+  /* ─── Accent ──────────────────────────────────────────────────────
+   * Stripe Purple — primary CTAs, link text, interactive
+   * highlights, the focus ring. A saturated blue-violet that
+   * anchors the entire system. Hard cap of ≤2 visible uses per
+   * screen (lint `accent-overuse` P1 enforces). */
+  --accent:    #533afd;
+  --accent-on: #ffffff;     /* button label on purple — DESIGN.md §4 */
+
+  /* ─── Accent states (#Stripe 4) ─────────────────────────────────
+   * Hand-picked values from DESIGN.md §2, NOT a black-mix formula.
+   * Stripe Purple is saturated enough that the schema's
+   * `color-mix(in oklab, var(--accent), black 8%)` produces a
+   * muddy violet rather than the deliberate Purple Hover that
+   * Stripe.com ships. Use the brand's own values.
+   *
+   * Schema rule: every brand provides `--accent-hover` and
+   * `--accent-active`. The binding strategy (formula / identity /
+   * hand-picked) is brand-decided. */
+  --accent-hover:  #4434d4;  /* Purple Hover — DESIGN.md §2 */
+  --accent-active: #2e2b8c;  /* Purple Deep — DESIGN.md §2 */
+
+  /* ─── Semantic ───────────────────────────────────────────────────
+   * Status colours pulled from DESIGN.md §2. Stripe's success is a
+   * deliberately vivid green (`#15be53`) because payment-success
+   * confirmations are the system's happy path — that pixel deserves
+   * the saturation. Warn is the muted lemon Stripe uses for
+   * highlight pills; danger is the ruby accent because rejected
+   * cards and disputed charges are the only "danger" surface
+   * Stripe.com renders, and they ship ruby — not the schema's
+   * neutral red — for the alert. */
+  --success: #15be53;        /* DESIGN.md success green */
+  --warn:    #9b6829;        /* lemon — warning / highlight accent */
+  --danger:  #ea2261;        /* ruby — used for alerts, dispute states */
+
+  /* ─── Typography — fonts ─────────────────────────────────────────
+   * `sohne-var` is the defining element of Stripe's identity
+   * (DESIGN.md §1). It is a custom face and will not load for
+   * most readers; the fallback chain is the closest SF / system
+   * sans we can reach without licensing. Components must always
+   * set `font-feature-settings: "ss01"` on top of these stacks —
+   * the stylistic set is non-negotiable when sohne-var IS loaded.
+   *
+   * `--font-mono` is `SourceCodePro` per DESIGN.md §3 — the
+   * brand's monospace companion, used for code blocks at 12px /
+   * 500 with 2.00 line-height. */
+  --font-display:
+    "sohne-var", "Söhne", "Sohne",
+    "SF Pro Display", -apple-system, BlinkMacSystemFont,
+    system-ui, "Helvetica Neue", Arial, sans-serif;
+  --font-body:
+    "sohne-var", "Söhne", "Sohne",
+    "SF Pro Display", -apple-system, BlinkMacSystemFont,
+    system-ui, "Helvetica Neue", Arial, sans-serif;
+  --font-mono:
+    "SourceCodePro", "Source Code Pro",
+    ui-monospace, "SF Mono", "JetBrains Mono",
+    Menlo, Monaco, Consolas, monospace;
+
+  /* ─── Typography — type scale (#Stripe 5) ───────────────────────
+   * Direct mapping of DESIGN.md §3 hierarchy: 12 / 14 / 16 / 18 /
+   * 22 / 32 / 48 / 56. Stripe's display ceiling is 56px (weight
+   * 300, -1.4px tracking) — adding a 64px tier would push past
+   * the brand's self-imposed limit on hero loudness. The smaller
+   * 8px / 10px / 11px / 13px sizes from DESIGN.md's table are
+   * intentional micro sizes (chart axes, financial fine print) and
+   * are inlined where used rather than promoted to the shared
+   * scale. */
+  --text-xs:   12px;         /* caption small, dense labels */
+  --text-sm:   14px;         /* button small, navigation links */
+  --text-base: 16px;         /* body baseline */
+  --text-lg:   18px;         /* body large, feature lede */
+  --text-xl:   22px;         /* sub-heading, card title */
+  --text-2xl:  32px;         /* section heading */
+  --text-3xl:  48px;         /* display large */
+  --text-4xl:  56px;         /* display hero — ceiling */
+
+  /* ─── Typography — leading & tracking ───────────────────────────
+   * Reading rhythm is 1.40 — denser than the schema-default 1.5
+   * because Stripe's body type (sohne-var at weight 300) reads
+   * lighter than Inter / system sans, and slightly tighter
+   * leading prevents the page from feeling airy.
+   *
+   * `--leading-tight` is the headline rhythm — 1.10 matches
+   * DESIGN.md's section-heading line-height. The 1.03 / 1.15
+   * variations for individual display sizes are tuned in
+   * components.html overrides; this token is the default.
+   *
+   * `--tracking-display` is brand-defining: Stripe compresses
+   * display sizes with negative letter-spacing (-1.4px at 56px →
+   * -0.025em). The token uses -0.02em so the rule reads
+   * consistently across the display range (48px → -0.96px,
+   * 32px → -0.64px, all close to -0.02em). Components targeting
+   * the 56px hero may override locally for the exact -1.4px. */
+  --leading-body:     1.40;
+  --leading-tight:    1.10;
+  --tracking-display: -0.02em;
+
+  /* ─── Spacing ────────────────────────────────────────────────────
+   * 4px base unit. DESIGN.md §5 calls out a denser scale at the
+   * small end (every 2px from 4 → 12) for precision data displays;
+   * those fine-grained values are inlined inside specific
+   * financial-data components rather than promoted to tokens —
+   * the schema's 4/8/12/16/20/24/32/48 ladder covers the
+   * UI-chrome rhythm Stripe actually uses on hero / nav / card
+   * surfaces. */
+  --space-1:  4px;
+  --space-2:  8px;
+  --space-3:  12px;
+  --space-4:  16px;
+  --space-5:  20px;
+  --space-6:  24px;
+  --space-8:  32px;
+  --space-12: 48px;
+
+  /* ─── Section rhythm ─────────────────────────────────────────────
+   * Generous vertical breathing room desktop-side (96px) so the
+   * 56px hero has air above and below; tightens to 64px on
+   * tablet, 40px on phone per DESIGN.md §8 ("64px → 40px on
+   * mobile"). */
+  --section-y-desktop: 96px;
+  --section-y-tablet:  64px;
+  --section-y-phone:   40px;
+
+  /* ─── Radius ─────────────────────────────────────────────────────
+   * Conservative rounding, 4 → 6 → 8 (DESIGN.md §5). Buttons,
+   * inputs, and badges share the 4px small tier; nav containers
+   * and dropdown shells take 6px; featured cards and hero
+   * elements take 8px. No pill shapes on cards or buttons —
+   * DESIGN.md §7 Don't list. `--radius-pill` is kept as a schema
+   * slot (avatars only) but is never used on interactive
+   * surfaces. */
+  --radius-sm:   4px;        /* buttons, inputs, badges, cards */
+  --radius-md:   6px;        /* nav container, comfortable cards */
+  --radius-lg:   8px;        /* featured cards, hero elements */
+  --radius-pill: 9999px;     /* avatars only — never on buttons / cards */
+
+  /* ─── Elevation (3 levels — #Stripe 6) ──────────────────────────
+   * The single most brand-distinctive token in this file.
+   *
+   * Stripe's shadow philosophy is "chromatic depth": the primary
+   * shadow colour is a deep blue-gray (`rgba(50,50,93,0.25)`) that
+   * echoes the navy palette, paired with a pure-black secondary
+   * layer at a different offset for parallax. Negative spread
+   * values (-30px, -18px) keep the shadow vertical so cards don't
+   * fringe sideways.
+   *
+   * Rebinding `--elev-raised` to a neutral drop shadow strips
+   * Stripe's atmosphere even when every other colour is correct —
+   * the shadow IS part of the brand voice, not chrome around it.
+   * Brands forbidding chromatic shadows (kami) override; Stripe
+   * defines. */
+  --elev-flat:   none;
+  --elev-ring:   0 0 0 1px var(--border);
+  --elev-raised:
+    rgba(50, 50, 93, 0.25)  0px 30px 45px -30px,
+    rgba(0,   0,  0, 0.10)  0px 18px 36px -18px;
+
+  /* ─── Focus ring (#Stripe 7) ────────────────────────────────────
+   * Layered purple halo — a 2px solid edge in `--accent` plus an
+   * outer translucent glow. DESIGN.md §6 specifies the solid 2px
+   * ring; we add the soft outer halo so keyboard focus is
+   * unambiguously visible against pale surfaces (payment flows
+   * are keyboard-heavy, the brand spec mandates clarity).
+   *
+   * Implemented as box-shadow stack so it layers outside the
+   * element without affecting layout. */
+  --focus-ring:
+    0 0 0 2px var(--accent),
+    0 0 0 5px color-mix(in oklab, var(--accent), transparent 75%);
+
+  /* ─── Motion ─────────────────────────────────────────────────────
+   * Two durations + one easing curve, per the anti-ai-slop
+   * "short, purposeful transitions (150–250ms) with stable
+   * easing" contract. Stripe's hover transitions colour and shadow
+   * but never transform — buttons do not nudge or scale on hover;
+   * cards lift via shadow intensity only. */
+  --motion-fast:   150ms;
+  --motion-base:   200ms;
+  --ease-standard: cubic-bezier(0.2, 0, 0, 1);
+
+  /* ─── Layout ─────────────────────────────────────────────────────
+   * 1080px container ceiling per DESIGN.md §5. Per-breakpoint
+   * gutter compresses 32 → 24 → 16 — generous on desktop because
+   * the white canvas wants air; tight on phone because every
+   * pixel is content. */
+  --container-max:            1080px;
+  --container-gutter-desktop: 32px;
+  --container-gutter-tablet:  24px;
+  --container-gutter-phone:   16px;
+}

package/dist/__w3kits/assets/design-systems/supabase/DESIGN.md

@@ -0,0 +1,258 @@
+# Design System Inspired by Supabase
+
+> Category: Backend & Data
+> Open-source Firebase alternative. Dark emerald theme, code-first.
+
+## 1. Visual Theme & Atmosphere
+
+Supabase's website is a dark-mode-native developer platform that channels the aesthetic of a premium code editor — deep black backgrounds (`#0f0f0f`, `#171717`) with emerald green accents (`#3ecf8e`, `#00c573`) that reference the brand's open-source, PostgreSQL-green identity. The design system feels like it was born in a terminal window and evolved into a sophisticated marketing surface without losing its developer soul.
+
+The typography is built on "Circular" — a geometric sans-serif with rounded terminals that softens the technical edge. At 72px with a 1.00 line-height, the hero text is compressed to its absolute minimum vertical space, creating dense, impactful statements that waste nothing. The monospace companion (Source Code Pro) appears sparingly for uppercase technical labels with 1.2px letter-spacing, creating the "developer console" markers that connect the marketing site to the product experience.
+
+What makes Supabase distinctive is its sophisticated HSL-based color token system. Rather than flat hex values, Supabase uses HSL with alpha channels for nearly every color (`--colors-crimson4`, `--colors-purple5`, `--colors-slateA12`), enabling a nuanced layering system where colors interact through transparency. This creates depth through translucency — borders at `rgba(46, 46, 46)`, surfaces at `rgba(41, 41, 41, 0.84)`, and accents at partial opacity all blend with the dark background to create a rich, dimensional palette from minimal color ingredients.
+
+The green accent (`#3ecf8e`) appears selectively — in the Supabase logo, in link colors (`#00c573`), and in border highlights (`rgba(62, 207, 142, 0.3)`) — always as a signal of "this is Supabase" rather than as a decorative element. Pill-shaped buttons (9999px radius) for primary CTAs contrast with standard 6px radius for secondary elements, creating a clear visual hierarchy of importance.
+
+**Key Characteristics:**
+- Dark-mode-native: near-black backgrounds (`#0f0f0f`, `#171717`) — never pure black
+- Emerald green brand accent (`#3ecf8e`, `#00c573`) used sparingly as identity marker
+- Circular font — geometric sans-serif with rounded terminals
+- Source Code Pro for uppercase technical labels (1.2px letter-spacing)
+- HSL-based color token system with alpha channels for translucent layering
+- Pill buttons (9999px) for primary CTAs, 6px radius for secondary
+- Neutral gray scale from `#171717` through `#898989` to `#fafafa`
+- Border system using dark grays (`#2e2e2e`, `#363636`, `#393939`)
+- Minimal shadows — depth through border contrast and transparency
+- Radix color primitives (crimson, purple, violet, indigo, yellow, tomato, orange, slate)
+
+## 2. Color Palette & Roles
+
+### Brand
+- **Supabase Green** (`#3ecf8e`): Primary brand color, logo, accent borders
+- **Green Link** (`#00c573`): Interactive green for links and actions
+- **Green Border** (`rgba(62, 207, 142, 0.3)`): Subtle green border accent
+
+### Neutral Scale (Dark Mode)
+- **Near Black** (`#0f0f0f`): Primary button background, deepest surface
+- **Dark** (`#171717`): Page background, primary canvas
+- **Dark Border** (`#242424`): Horizontal rule, section dividers
+- **Border Dark** (`#2e2e2e`): Card borders, tab borders
+- **Mid Border** (`#363636`): Button borders, dividers
+- **Border Light** (`#393939`): Secondary borders
+- **Charcoal** (`#434343`): Tertiary borders, dark accents
+- **Dark Gray** (`#4d4d4d`): Heavy secondary text
+- **Mid Gray** (`#898989`): Muted text, link color
+- **Light Gray** (`#b4b4b4`): Secondary link text
+- **Near White** (`#efefef`): Light border, subtle surface
+- **Off White** (`#fafafa`): Primary text, button text
+
+### Radix Color Tokens (HSL-based)
+- **Slate Scale**: `--colors-slate5` through `--colors-slateA12` — neutral progression
+- **Purple**: `--colors-purple4`, `--colors-purple5`, `--colors-purpleA7` — accent spectrum
+- **Violet**: `--colors-violet10` (`hsl(251, 63.2%, 63.2%)`) — vibrant accent
+- **Crimson**: `--colors-crimson4`, `--colors-crimsonA9` — warm accent / alert
+- **Indigo**: `--colors-indigoA2` — subtle blue wash
+- **Yellow**: `--colors-yellowA7` — attention/warning
+- **Tomato**: `--colors-tomatoA4` — error accent
+- **Orange**: `--colors-orange6` — warm accent
+
+### Surface & Overlay
+- **Glass Dark** (`rgba(41, 41, 41, 0.84)`): Translucent dark overlay
+- **Slate Alpha** (`hsla(210, 87.8%, 16.1%, 0.031)`): Ultra-subtle blue wash
+- **Fixed Scale Alpha** (`hsla(200, 90.3%, 93.4%, 0.109)`): Light frost overlay
+
+### Shadows
+- Supabase uses **almost no shadows** in its dark theme. Depth is created through border contrast and surface color differences rather than box-shadows. Focus states use `rgba(0, 0, 0, 0.1) 0px 4px 12px` — minimal, functional.
+
+## 3. Typography Rules
+
+### Font Families
+- **Primary**: `Circular`, with fallbacks: `custom-font, Helvetica Neue, Helvetica, Arial`
+- **Monospace**: `Source Code Pro`, with fallbacks: `Office Code Pro, Menlo`
+
+### Hierarchy
+
+| Role | Font | Size | Weight | Line Height | Letter Spacing | Notes |
+|------|------|------|--------|-------------|----------------|-------|
+| Display Hero | Circular | 72px (4.50rem) | 400 | 1.00 (tight) | normal | Maximum density, zero waste |
+| Section Heading | Circular | 36px (2.25rem) | 400 | 1.25 (tight) | normal | Feature section titles |
+| Card Title | Circular | 24px (1.50rem) | 400 | 1.33 | -0.16px | Slight negative tracking |
+| Sub-heading | Circular | 18px (1.13rem) | 400 | 1.56 | normal | Secondary headings |
+| Body | Circular | 16px (1.00rem) | 400 | 1.50 | normal | Standard body text |
+| Nav Link | Circular | 14px (0.88rem) | 500 | 1.00–1.43 | normal | Navigation items |
+| Button | Circular | 14px (0.88rem) | 500 | 1.14 (tight) | normal | Button labels |
+| Caption | Circular | 14px (0.88rem) | 400–500 | 1.43 | normal | Metadata, tags |
+| Small | Circular | 12px (0.75rem) | 400 | 1.33 | normal | Fine print, footer links |
+| Code Label | Source Code Pro | 12px (0.75rem) | 400 | 1.33 | 1.2px | `text-transform: uppercase` |
+
+### Principles
+- **Weight restraint**: Nearly all text uses weight 400 (regular/book). Weight 500 appears only for navigation links and button labels. There is no bold (700) in the detected system — hierarchy is created through size, not weight.
+- **1.00 hero line-height**: The hero text is compressed to absolute zero leading. This is the defining typographic gesture — text that feels like a terminal command: dense, efficient, no wasted vertical space.
+- **Negative tracking on cards**: Card titles use -0.16px letter-spacing, a subtle tightening that differentiates them from body text without being obvious.
+- **Monospace as ritual**: Source Code Pro in uppercase with 1.2px letter-spacing is the "developer console" voice — used sparingly for technical labels that connect to the product experience.
+- **Geometric personality**: Circular's rounded terminals create warmth in what could otherwise be a cold, technical interface. The font is the humanizing element.
+
+## 4. Component Stylings
+
+### Buttons
+
+**Primary Pill (Dark)**
+- Background: `#0f0f0f`
+- Text: `#fafafa`
+- Padding: 8px 32px
+- Radius: 9999px (full pill)
+- Border: `1px solid #fafafa` (white border on dark)
+- Focus shadow: `rgba(0, 0, 0, 0.1) 0px 4px 12px`
+- Use: Primary CTA ("Start your project")
+
+**Secondary Pill (Dark, Muted)**
+- Background: `#0f0f0f`
+- Text: `#fafafa`
+- Padding: 8px 32px
+- Radius: 9999px
+- Border: `1px solid #2e2e2e` (dark border)
+- Opacity: 0.8
+- Use: Secondary CTA alongside primary
+
+**Ghost Button**
+- Background: transparent
+- Text: `#fafafa`
+- Padding: 8px
+- Radius: 6px
+- Border: `1px solid transparent`
+- Use: Tertiary actions, icon buttons
+
+### Cards & Containers
+- Background: dark surfaces (`#171717` or slightly lighter)
+- Border: `1px solid #2e2e2e` or `#363636`
+- Radius: 8px–16px
+- No visible shadows — borders define edges
+- Internal padding: 16px–24px
+
+### Tabs
+- Border: `1px solid #2e2e2e`
+- Radius: 9999px (pill tabs)
+- Active: green accent or lighter surface
+- Inactive: dark, muted
+
+### Links
+- **Green**: `#00c573` — Supabase-branded links
+- **Primary Light**: `#fafafa` — standard links on dark
+- **Secondary**: `#b4b4b4` — muted links
+- **Muted**: `#898989` — tertiary links, footer
+
+### Navigation
+- Dark background matching page (`#171717`)
+- Supabase logo with green icon
+- Circular 14px weight 500 for nav links
+- Clean horizontal layout with product dropdown
+- Green "Start your project" CTA pill button
+- Sticky header behavior
+
+## 5. Layout Principles
+
+### Spacing System
+- Base unit: 8px
+- Scale: 1px, 4px, 6px, 8px, 12px, 16px, 20px, 24px, 32px, 40px, 48px, 90px, 96px, 128px
+- Notable large jumps: 48px → 90px → 96px → 128px for major section spacing
+
+### Grid & Container
+- Centered content with generous max-width
+- Full-width dark sections with constrained inner content
+- Feature grids: icon-based grids with consistent card sizes
+- Logo grids for "Trusted by" sections
+- Footer: multi-column on dark background
+
+### Breakpoints
+| Name | Width | Key Changes |
+|------|-------|-------------|
+| Mobile | <600px | Single column, stacked layout |
+| Desktop | >600px | Multi-column grids, expanded layout |
+
+*Note: Supabase uses a notably minimal breakpoint system — primarily a single 600px breakpoint, suggesting a mobile-first approach with progressive enhancement.*
+
+### Whitespace Philosophy
+- **Dramatic section spacing**: 90px–128px between major sections creates a cinematic pacing — each section is its own scene in the dark void.
+- **Dense content blocks**: Within sections, spacing is tight (16px–24px), creating concentrated information clusters.
+- **Border-defined space**: Instead of whitespace + shadows for separation, Supabase uses thin borders on dark backgrounds — separation through line, not gap.
+
+### Border Radius Scale
+- Standard (6px): Ghost buttons, small elements
+- Comfortable (8px): Cards, containers
+- Medium (11px–12px): Mid-size panels
+- Large (16px): Feature cards, major containers
+- Pill (9999px): Primary buttons, tab indicators
+
+## 6. Depth & Elevation
+
+| Level | Treatment | Use |
+|-------|-----------|-----|
+| Flat (Level 0) | No shadow, border `#2e2e2e` | Default state, most surfaces |
+| Subtle Border (Level 1) | Border `#363636` or `#393939` | Interactive elements, hover |
+| Focus (Level 2) | `rgba(0, 0, 0, 0.1) 0px 4px 12px` | Focus states only |
+| Green Accent (Level 3) | Border `rgba(62, 207, 142, 0.3)` | Brand-highlighted elements |
+
+**Shadow Philosophy**: Supabase deliberately avoids shadows. In a dark-mode-native design, shadows are nearly invisible and serve no purpose. Instead, depth is communicated through a sophisticated border hierarchy — from `#242424` (barely visible) through `#2e2e2e` (standard) to `#393939` (prominent). The green accent border (`rgba(62, 207, 142, 0.3)`) at 30% opacity is the "elevated" state — the brand color itself becomes the depth signal.
+
+## 7. Do's and Don'ts
+
+### Do
+- Use near-black backgrounds (`#0f0f0f`, `#171717`) — depth comes from the gray border hierarchy
+- Apply Supabase green (`#3ecf8e`, `#00c573`) sparingly — it's an identity marker, not a decoration
+- Use Circular at weight 400 for nearly everything — 500 only for buttons and nav
+- Set hero text to 1.00 line-height — the zero-leading is the typographic signature
+- Create depth through border color differences (`#242424` → `#2e2e2e` → `#363636`)
+- Use pill shape (9999px) exclusively for primary CTAs and tabs
+- Employ HSL-based colors with alpha for translucent layering effects
+- Use Source Code Pro uppercase labels for developer-context markers
+
+### Don't
+- Don't add box-shadows — they're invisible on dark backgrounds and break the border-defined depth system
+- Don't use bold (700) text weight — the system uses 400 and 500 only
+- Don't apply green to backgrounds or large surfaces — it's for borders, links, and small accents
+- Don't use warm colors (crimson, orange) as primary design elements — they exist as semantic tokens for states
+- Don't increase hero line-height above 1.00 — the density is intentional
+- Don't use large border radius (16px+) on buttons — pills (9999px) or standard (6px), nothing in between
+- Don't lighten the background above `#171717` for primary surfaces — the darkness is structural
+- Don't forget the translucent borders — `rgba` border colors are the layering mechanism
+
+## 8. Responsive Behavior
+
+### Breakpoints
+| Name | Width | Key Changes |
+|------|-------|-------------|
+| Mobile | <600px | Single column, stacked features, condensed nav |
+| Desktop | >600px | Multi-column grids, full nav, expanded sections |
+
+### Collapsing Strategy
+- Hero: 72px → scales down proportionally
+- Feature grids: multi-column → single column stacked
+- Logo row: horizontal → wrapped grid
+- Navigation: full → hamburger
+- Section spacing: 90–128px → 48–64px
+- Buttons: inline → full-width stacked
+
+## 9. Agent Prompt Guide
+
+### Quick Color Reference
+- Background: `#0f0f0f` (button), `#171717` (page)
+- Text: `#fafafa` (primary), `#b4b4b4` (secondary), `#898989` (muted)
+- Brand green: `#3ecf8e` (brand), `#00c573` (links)
+- Borders: `#242424` (subtle), `#2e2e2e` (standard), `#363636` (prominent)
+- Green border: `rgba(62, 207, 142, 0.3)` (accent)
+
+### Example Component Prompts
+- "Create a hero section on #171717 background. Headline at 72px Circular weight 400, line-height 1.00, #fafafa text. Sub-text at 16px Circular weight 400, line-height 1.50, #b4b4b4. Pill CTA button (#0f0f0f bg, #fafafa text, 9999px radius, 8px 32px padding, 1px solid #fafafa border)."
+- "Design a feature card: #171717 background, 1px solid #2e2e2e border, 16px radius. Title at 24px Circular weight 400, letter-spacing -0.16px. Body at 14px weight 400, #898989 text."
+- "Build navigation bar: #171717 background. Circular 14px weight 500 for links, #fafafa text. Supabase logo with green icon left-aligned. Green pill CTA 'Start your project' right-aligned."
+- "Create a technical label: Source Code Pro 12px, uppercase, letter-spacing 1.2px, #898989 text."
+- "Design a framework logo grid: 6-column layout on dark, grayscale logos at 60% opacity, 1px solid #2e2e2e border between sections."
+
+### Iteration Guide
+1. Start with #171717 background — everything is dark-mode-native
+2. Green is the brand identity marker — use it for links, logo, and accent borders only
+3. Depth comes from borders (#242424 → #2e2e2e → #363636), not shadows
+4. Weight 400 is the default for everything — 500 only for interactive elements
+5. Hero line-height of 1.00 is the signature typographic move
+6. Pill (9999px) for primary actions, 6px for secondary, 8-16px for cards
+7. HSL with alpha channels creates the sophisticated translucent layering