prism-design 2.13.0

package/extractions/github.com/DESIGN.md

@@ -0,0 +1,1130 @@
+---
+version: alpha
+name: github.com
+description: "Light product system built on #ffffff with #1f883d as the primary CTA accent. Type anchored in Mona Sans VF at 32px / weight 600. Extracted automatically from https://github.com/ — rendered styles via getComputedStyle() + CSS custom properties (token-only values may not be painted)."
+narrative: |
+  github.com is built on a pure-white canvas (rgb(255, 255, 255)).
+  The system uses rgb(31, 136, 61) as the accent for primary actions and brand signals.
+  Sharp 0px corners on CTAs — architectural restraint, engineering precision alongside Mona Sans VF as the primary typeface.
+  A layered elevation system (7 distinct shadows) building a clear front-to-back hierarchy.
+  Motion is a first-class concern — 54 keyframe animations plus transition-driven interactions.
+
+colors:
+  background: "#ffffff"
+  surface-1: "rgba(255, 255, 255, 0)"
+  surface-2: "rgba(228, 235, 230, 0.996)"
+  ink: "#1f2328"
+  ink-subtle: "#58635b"
+  primary: "#1f883d"
+  on-primary: "#ffffff"
+  primary-hover: "#1f2328"
+  hairline: "#25292e"
+  primary-focus: "#0969da"
+  semantic-error: "#d1242f"
+  semantic-success: "#1a7f37"
+  semantic-warning: "#9a6700"
+
+typography:
+  display-xl:
+    fontFamily: "Mona Sans VF"
+    fontSize: 32px
+    fontWeight: 600
+    lineHeight: 1.5
+    letterSpacing: 0
+  display-md:
+    fontFamily: "Mona Sans VF"
+    fontSize: 24px
+    fontWeight: 600
+    lineHeight: 1.5
+    letterSpacing: 0
+  headline:
+    fontFamily: "Mona Sans VF"
+    fontSize: 16px
+    fontWeight: 600
+    lineHeight: 1.5
+    letterSpacing: 0
+  body:
+    fontFamily: "Mona Sans"
+    fontSize: 16px
+    fontWeight: 400
+    lineHeight: 1.5
+    letterSpacing: 0
+  body-sm:
+    fontFamily: "Mona Sans"
+    fontSize: 16px
+    fontWeight: 500
+    lineHeight: 1.5
+    letterSpacing: 0
+  caption:
+    fontFamily: "Mona Sans"
+    fontSize: 12px
+    fontWeight: 500
+    lineHeight: 0px
+    letterSpacing: 0
+  button:
+    fontFamily: "Mona Sans VF"
+    fontSize: 16px
+    fontWeight: 400
+    lineHeight: 1.5
+    letterSpacing: 0
+  eyebrow:
+    fontFamily: "Mona Sans"
+    fontSize: 14px
+    fontWeight: 400
+    lineHeight: 1.5
+    letterSpacing: 0
+
+rounded:
+  none: 0px
+  xs: 3px
+  sm: 6px
+  md: 12px
+  lg: 12px
+  xl: 12px
+  xxl: 24px
+  pill: 9999px
+
+spacing:
+  xxs: 2px
+  xs: 6px
+  sm: 16px
+  md: 40px
+  lg: 24px
+  xl: 32px
+  xxl: 64px
+  section: 80px
+
+components:
+  button-light--invert:
+    backgroundColor: "#efefef"
+    textColor: "#000000"
+    typography: "{typography.headline}"
+    rounded: "{rounded.none}"
+    padding: 1px 6px
+  button-ghost:
+    backgroundColor: "{colors.surface-1}"
+    textColor: "{colors.on-primary}"
+    typography: "{typography.headline}"
+    rounded: "{rounded.none}"
+    padding: 8px
+  button-ghost:
+    backgroundColor: "{colors.surface-1}"
+    textColor: "{colors.on-primary}"
+    typography: "{typography.eyebrow}"
+    rounded: "{rounded.sm}"
+    padding: 0px 0px 0px 8px
+  input-text-input:
+    backgroundColor: "{colors.surface-1}"
+    textColor: "{colors.surface-1}"
+    typography: "{typography.eyebrow}"
+    rounded: "{rounded.sm}"
+  navigation-main-nav:
+    backgroundColor: "{colors.hairline}"
+    typography: "{typography.headline}"
+    rounded: "{rounded.none}"
+    padding: 16px 0px
+
+extracted_at: "2026-05-30T21:32:12.271Z"
+completeness: 88
+scoreVersion: "v2"
+
+---
+
+# Design System — github.com
+> Extracted automatically by Clone Architect from https://github.com/paulsainton/lifeos-app.git
+> Date: 2026-05-30
+> Viewport: Desktop 1440x900 + Mobile 390x844
+> Values are extracted, not hand-written: rendered styles via getComputedStyle() + colors declared in CSS custom properties (token-only values are marked `(token)` and may not be painted).
+
+> **🤖 TL;DR for AI agents** (read this first — saves you scanning the full doc):
+>
+> - **Canvas**: `rgb(255, 255, 255)` is the page background. Every component composits against this.
+> - **Accent**: `rgb(31, 136, 61)` for primary CTAs ONLY. Never decorative.
+> - **Body type**: 14px (token: `typography.body`). Default for ALL text not in a heading role.
+> - **Section rhythm**: 48px between major bands. Card padding: 24px.
+> - **Default radius**: 6px 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
+
+github.com adopts the classic pure-white canvas (`#ffffff`) — a deliberate choice that recedes into transparency, letting typography, color and product imagery carry the entire visual weight. 
+
+Typography is anchored in **Mona Sans VF**. The weight scale rejects the standard 100/200/.../900 ladder in favor of custom values (max **460** in this system) — a deliberate signal that this design system is precisely tuned, not assembled from defaults. 
+
+Body text reads in Warm Brown (`#1f2328`) — softened from pure black, a small but deliberate detail that lowers reading friction. **Forest Green** (`#1f883d`) is the single high-saturation color in the system — it earns its presence only on interactive elements, making CTAs and links the unmistakable focal points against the otherwise neutral palette. 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. The site uses a variable font with ITAL axes, enabling precise weight/width control across the type hierarchy. 
+
+**Key Characteristics:**
+- Background: Text White (`#ffffff`)
+- Primary typeface: Mona Sans
+- Primary text: Warm Brown (`#1f2328`)
+- Accent: Forest Green (`#1f883d`)
+- Shadow system: 7 distinct elevation levels
+- Custom fonts loaded: Mona Sans, MonaSansFallback, MonaSansHeaderFallback, Hubot Sans, Mona Sans Mono, Mona Sans Fallback, Mona Sans Header Fallback
+
+## 2. Color Palette & Roles
+
+### Background & Surface
+- **Text White** (`#ffffff`): Page background (primary)
+- **Transparent** (`transparent`): Surface / elevated background
+- **Ghost White** (`#f6f8fa`): Surface / elevated background
+- **Light Gray** (`#efefef`): Surface / elevated background
+
+### Text & Content
+- **Warm Brown** (`#1f2328`): Primary body text
+- **Warm Brown** (`#25292e`): Secondary text
+
+### Accent & Interactive
+- **Brand Label Color Green Blue Start** (`#08872b`): Accent / interactive (CSS var)
+- **Brand Testimonial QuoteMarkBackground Teal** (`#daf9f5`): Accent / interactive (CSS var)
+- **Brand Color Text Muted** (`#58635b`): Accent / interactive (CSS var)
+- **Brand Pagination Link BgColor Rest** (`#000000`): Accent / interactive (CSS var)
+- **Brand SubNav Color Link BgColor** (`#e4ebe6`): Accent / interactive (CSS var)
+- **Brand Icon Color Coral** (`#e13f1b`): Accent / interactive (CSS var)
+- **Brand IDE PlayPauseControl Rest** (`#d2d9d4`): Accent / interactive (CSS var)
+
+### Border & Divider
+- **#d1d9e0** (`#d1d9e0`): Borders / dividers
+- **Translucent Light Blue (40%)** (`rgba(200, 209, 218, 0.4)`): Borders / dividers
+
+### Full Extracted Palette
+**20 colors rendered on the page** + **365** more declared in design tokens (CSS custom properties — not necessarily painted). (15 categorized above + 370 additional below.)
+Rendered values are read via `getComputedStyle()`; token values come from CSS variable declarations. Third-party logo colors are filtered out.
+
+- `#0969da` — M Tricolor Blue
+- `#0377ff` — #0377ff
+- `#818b98` — Medium Gray
+- `#59636e` — Dim Gray
+- `#979a9c` — Cool Gray
+- `#1f883d` — Forest Green
+- `#d1242f` — Crimson
+- `rgba(212, 167, 44, 0.4)` — Translucent #d4a72c (40%)
+- `#9a6700` — #9a6700
+- `rgba(255, 129, 130, 0.4)` — Translucent #ff8182 (40%)
+- `#b6e3ff` — Light Blue *(token)*
+- `#64513a` — #64513a *(token)*
+- `#ce2c85` — Cherry *(token)*
+- `#0a4852` — #0a4852 *(token)*
+- `#b88700` — #b88700 *(token)*
+- `#e3f2b5` — Vibrant Yellow *(token)*
+- `#e6eaef` — Light Gray *(token)*
+- `#fecfaa` — Pink *(token)*
+- `#c7f5ef` — #c7f5ef *(token)*
+- `#052b2c` — Navy Blue *(token)*
+- `#007b94` — #007b94 *(token)*
+- `#e6d6d5` — Soft Pink *(token)*
+- `#0757ba` — Cobalt Blue *(token)*
+- `#004db3` — Cobalt Blue *(token)*
+- `#b8500f` — #b8500f *(token)*
+- `#495a2b` — #495a2b *(token)*
+- `#ffe5db` — Beige *(token)*
+- `#422b00` — #422b00 *(token)*
+- `#f68c41` — Coral *(token)*
+- `#23b1ae` — #23b1ae *(token)*
+- `#a98906` — #a98906 *(token)*
+- `#1a7f37` — Forest Green *(token)*
+- *…+338 more in `raw-css.json` (`desktop.allColors`).*
+
+### CSS Custom Properties (Design Tokens)
+
+**Shadow Token**
+- `--button-danger-shadow-selected`: `inset 0 1px 0 0 #4c001433`
+- `--brand-CTABanner-shadow-color-start`: `#08872b`
+- `--color-mktg-btn-shadow-focus`: `#00000026 0 0 0 4px`
+- `--sub-nav-mktg-shadow`: `0 0 0 1px #35485b24, 0 3px 2px #0000000a, 0 7px 7px #00000008`
+
+**Motion Token**
+- `--brand-animation-variant-scaleInLeft-end`: `1`
+- `--base-duration-600`: `.6s`
+- `--brand-animation-variant-scaleInRight-distance`: `-1.25rem`
+
+**Secondary Color**
+- `--display-lime-bgColor-muted`: `#e3f2b5`
+- `--data-coral-color-muted`: `#ffe5db`
+- `--display-plum-borderColor-muted`: `#f0cdfe`
+- `--display-cyan-borderColor-muted`: `#7ae9ff`
+
+**Spacing Token**
+- `--control-medium-gap`: `.5rem`
+- `--brand-RiverBreakout-variant-gridline-spacing-outerBlock`: `4rem`
+- `--brand-RiverAccordion-variant-gridline-spacing-outerInline`: `4rem`
+- `--Layout-outer-spacing-x`: `0px`
+
+**Success**
+- `--brand-Label-color-green-blue-start`: `#08872b`
+- `--brand-Eyebrowbanner-fgColor-green-blue-end`: `#0377ff`
+- `--fgColor-success`: `#1a7f37`
+- `--bgColor-success-emphasis`: `#1f883d`
+
+**Text Color**
+- `--brand-color-text-muted`: `#58635b`
+- `--brand-color-text-emphasized`: `#08872b`
+- `--brand-color-text-onEmphasis`: `#fff`
+- `--color-text-white`: `#fff`
+
+**Border**
+- `--header-borderColor-divider`: `#818b98`
+- `--brand-color-border-subtle`: `#d2d9d4`
+- `--brand-color-border-muted`: `#e4ebe6`
+- `--brand-color-border-default`: `#b6bfb8`
+
+**Border Radius Token**
+- `--brand-borderRadius-small`: `.25rem`
+- `--brand-VideoPlayer-range-borderRadius`: `.1875rem`
+- `--brand-Bento-item-borderRadius-large`: `1.5rem`
+- `--borderRadius-medium`: `.375rem`
+
+**Warning**
+- `--brand-Label-color-yellow`: `#be7d00`
+- `--brand-Testimonial-quoteMarkColor-yellow`: `#be7d00`
+- `--brand-Eyebrowbanner-fgColor-yellow`: `#be7d00`
+- `--brand-Accordion-toggle-color-yellow`: `#be7d00`
+
+**Error / Destructive**
+- `--brand-Label-color-red-orange-end`: `#b85b06`
+- `--brand-Accordion-toggle-color-red`: `#cf2230`
+- `--brand-Testimonial-quoteMarkColor-red-orange-start`: `#cf2230`
+- `--brand-Pillar-icon-color-red`: `#cf2230`
+
+**Primary Brand Color**
+- `--borderColor-accent-muted`: `#54aeff66`
+- `--brand-color-accent-primary`: `#0d6731`
+- `--fgColor-accent`: `#0969da`
+- `--brand-Token-fgColor-accent`: `#fff`
+
+**Font Size Token**
+- `--font-size-small`: `.75rem`
+- `--body-font-size`: `.875rem`
+
+**Background**
+- `--brand-color-canvas-invert`: `#000`
+- `--brand-color-canvas-inset`: `#f2f5f3`
+- `--brand-color-canvas-overlay`: `#fff`
+- `--brand-color-canvas-muted`: `#fafafa`
+
+**Other tokens**
+- `--label-blue-borderColor`: `#fff0`
+- `--diffBlob-hunkNum-bgColor-rest`: `#b6e3ff`
+- `--label-brown-fgColor-hover`: `#64513a`
+- `--label-teal-fgColor-active`: `#0a4852`
+- `--button-primary-iconColor-disabled`: `#fffc`
+- `--button-outline-fgColor-disabled`: `#0969da80`
+- `--data-yellow-color-emphasis`: `#b88700`
+- `--brand-text-weight-300`: `400`
+
+## 3. Typography Rules
+
+### Font Families
+- **Primary**: `Mona Sans VF`
+- **Secondary**: `Noto Sans`
+- **Font 3**: `Mona Sans`
+- **Font 4**: `MonaSansFallback`
+- **Font 5**: `MonaSansHeaderFallback`
+
+### Custom Fonts Loaded
+- **Noto Sans** weight normal (normal)
+- **Mona Sans** weight 200 900 (normal)
+- **MonaSansFallback** weight normal (normal)
+- **MonaSansHeaderFallback** weight normal (normal)
+- **Hubot Sans** weight 200 900 (normal)
+- **Mona Sans Mono** weight 200 900 (normal)
+- **Mona Sans Fallback** weight normal (normal)
+- **Mona Sans Header Fallback** weight normal (normal)
+
+### Typography Hierarchy
+
+| Role | Font | Size | Weight | Line Height | Letter Spacing | Notes |
+|------|------|------|--------|-------------|----------------|-------|
+| Display Hero | Mona Sans VF | 32px | 600 | 1.5 | normal | Main headline (h1) |
+| Sub-heading | Mona Sans VF | 24px | 600 | 1.5 | normal | Section titles (h2) |
+| Label Heading | Mona Sans VF | 16px | 600 | 1.5 | normal | Small heading (H4) |
+| Button Large | Mona Sans VF | 16px | 400 | 1.5 | normal | Button label (16px) |
+| Link Large | Mona Sans | 16px | 500 | 1.5 | normal | Link (16px) — Decoration: none |
+| Navigation | Mona Sans | 16px | 400 | 1.5 | normal | Navigation items |
+| Sub-heading | Mona Sans VF | 14px | 600 | 1.5 | normal | Third-level heading (h3) |
+| Body | Mona Sans VF | 14px | 400 | 1.5 | normal | Standard reading text |
+| Button | Mona Sans VF | 14px | 500 | 1.43 | normal | Button label (14px) |
+| Eyebrow / Overline | Mona Sans | 14px | 400 | 1.5 | normal | Label above heading, uppercase tag |
+| Caption / Badge | Mona Sans | 12px | 500 | 0px | normal | small text (12px) |
+
+### Font Weight Scale
+
+CSS custom properties define 2 explicit weight steps:
+- `--brand-Testimonial-quote-fontWeight-default`: `425` — Regular (custom, ~400)
+- `--brand-Testimonial-quote-fontWeight-large`: `460` — Medium (custom, ~500)
+
+### Full Font Size Scale
+
+Sizes detected in the design (descending): `32px`, `24px`, `16px`, `14px`, `12px`
+
+### OpenType & Variable Font Features
+
+The typography uses these OpenType features intentionally — this is a sophisticated type system, not a default fallback:
+
+- **tabular figures** (`tnum`) — numbers align vertically, essential for pricing tables and dashboards
+- **stylistic sets** (`ss0X`) — alternate letterforms enabled (often for brand-specific glyph variants)
+- **contextual alternates** (`calt`) — connections between letters refined contextually
+- **ligatures** — common letter pairs replaced with refined glyphs (fi, fl, etc.)
+
+**Clone instruction:** Enable these in your CSS:
+```css
+body {
+  font-feature-settings: "liga", "calt", "tnum", "ss02", "ss01";
+}
+```
+
+**Variable font axes:**
+- ITAL axis
+
+## 4. Component Stylings
+
+### Buttons
+
+**Light / Invert**
+- Background: `#efefef`
+- Text: `#000000`
+- Padding: 1px 6px
+- Radius: 0px
+- Font: 16px weight 400
+- Use: Bright CTA on dark sections
+
+**Ghost**
+- Background: `transparent` `{colors.surface-1}`
+- Text: `#ffffff` `{colors.on-primary}`
+- Padding: 8px
+- Radius: 0px
+- Font: 16px weight 400
+- Use: Subtle action, toolbar, nav button
+
+**Ghost**
+- Background: `transparent` `{colors.surface-1}`
+- Text: `rgba(255, 255, 255, 0.75)` `{colors.on-primary}`
+- Padding: 0px 0px 0px 8px
+- Radius: 6px
+- Font: 14px weight 400
+- Use: Subtle action, toolbar, nav button
+
+**Primary Brand**
+- Background: `#1f883d` `{colors.primary}`
+- Text: `#ffffff` `{colors.on-primary}`
+- Padding: 5px 16px
+- Radius: 6px
+- Border: 1px solid rgba(31, 35, 40, 0.15)
+- Font: 14px weight 500
+- Use: Primary CTA / brand action
+
+**Outline**
+- Background: `transparent` `{colors.surface-1}`
+- Text: `#ffffff` `{colors.on-primary}`
+- Padding: 4px 12px
+- Radius: 6px
+- Border: 1px solid rgb(209, 217, 224)
+- Font: 14px weight 400
+- Use: Secondary action with border
+
+**Icon Button**
+- Background: `transparent` `{colors.surface-1}`
+- Text: `#59636e`
+- Padding: 0px
+- Radius: 6px
+- Border: 1px solid rgb(209, 217, 224)
+- Font: 14px weight 500
+- Use: Toolbar/UI icons
+
+**Light / Invert**
+- Background: `#f6f8fa`
+- Text: `#25292e` `{colors.hairline}`
+- Padding: 5px 16px
+- Radius: 6px
+- Border: 1px solid rgb(209, 217, 224)
+- Font: 14px weight 500
+- Use: Bright CTA on dark sections
+
+### Inputs & Forms
+
+**Text Input**
+- Background: `transparent` `{colors.surface-1}`
+- Text: `transparent` `{colors.surface-1}`
+- Padding: 0px
+- Radius: 6px
+- Border: 0px none rgba(0, 0, 0, 0)
+- Shadow: `rgba(31, 35, 40, 0.04) 0px 1px 0px 0px inset`
+- Font: 14px weight 400
+- Use: Text fields, search inputs
+
+### Navigation
+
+**Main Nav**
+- Background: `#25292e` `{colors.hairline}`
+- Padding: 16px 0px
+- Radius: none
+- Font: 16px weight 400
+- Use: Fixed/sticky block nav — N/A items
+- Hover: textDecoration: `underline`
+
+
+## 4b. Component Behaviors (State Matrix)
+
+### Interaction State Narrative
+
+
+*State transitions extracted via Playwright simulation — exact values in the YAML matrix below.*
+
+```yaml
+component-behaviors:
+  button:
+    default:
+      bg: "rgb(239, 239, 239)"
+      fg: "rgb(0, 0, 0)"
+  input:
+    default:
+      bg: "rgba(0, 0, 0, 0)"
+      fg: "rgba(0, 0, 0, 0)"
+      shadow: "rgba(31, 35, 40, 0.04) 0px 1px 0px 0px inset"
+  link:
+    default:
+      bg: "rgb(9, 105, 218)"
+      fg: "rgb(255, 255, 255)"
+  card:
+    default:
+      bg: "rgba(0, 0, 0, 0)"
+      fg: "rgb(31, 35, 40)"
+  navLink:
+    default:
+      bg: "rgba(0, 0, 0, 0)"
+      fg: "rgb(255, 255, 255)"
+    hover:
+      bg: "rgba(0, 0, 0, 0)"
+      fg: "rgb(255, 255, 255)"
+  footerLink:
+    default:
+      bg: "rgba(0, 0, 0, 0)"
+      fg: "rgb(31, 35, 40)"
+    hover:
+      bg: "rgba(0, 0, 0, 0)"
+      fg: "rgb(31, 35, 40)"
+```
+
+**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: `Light / Invert`, `Ghost`, `Primary Brand`, `Outline`, `Icon Button`
+- **DO NOT introduce new buttons 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
+
+## 5. Layout Principles
+
+### Layout Type
+**top-nav + content**
+
+### Grid
+Single column, centered content
+
+### Max Width
+80rem
+
+### Spacing System
+Compact spacing — information density prioritized
+
+| Token | Value |
+|-------|-------|
+| xxs | 2px |
+| xs | 6px |
+| sm | 16px |
+| md | 40px |
+| base | 16px |
+| lg | 24px |
+| xl | 32px |
+| 2xl | 48px |
+| 3xl | 64px |
+
+### Border Radius Scale
+| Name | Value | Use |
+|------|-------|-----|
+| None | 0px | No rounding |
+| Xs | 3px | Tiny corners (badges, micro elements) |
+| Sm | 6px | 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` |
+| Inputs & Forms | `6px` |
+| Navigation | `none` |
+| Page Body | `0px` |
+| Primary Input | `6px` |
+
+**Shape Personality**: Moderate Rounding — Medium corners (4–12px). Modern SaaS standard, neither sharp nor pill.
+
+**Full Radius Spectrum**: 0px, 3px, 6px, 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** | `24px` | Within a section, between content groups |
+| **card** | `40px` | Card padding, list-item spacing |
+| **compact** | `16px` | Form fields, tight clusters, badge padding |
+| **micro** | `6px` | 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).
+
+**2/8 structural patterns detected.**
+
+### Navigation Pattern
+
+- **Position:** static (scrolls with page)
+- **Layout:** unknown — Layout not classified
+- **Height:** 40px
+- **Logo:** ✓ present
+- **Nav links:** 1 primary items
+- **CTAs in nav:** 0 (no buttons — links only)
+- **Clone instruction:** Build a static unknown navigation. Link-only — no button styling needed.
+
+### Footer Pattern
+
+- **Columns:** 2
+- **Links:** 49 total
+- **Height:** 600px
+- **Includes:** ✗ no newsletter | ✓ social icons |  ✓ copyright
+- **Clone instruction:** Build a 2-column footer with ~25 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(209, 217, 224, 0.25) 0px 0px 0px 1px`,<br>`rgba(37, 41, 46, 0.04) 0px 6px 12px -3px`,<br>`rgba(37, 41, 46, 0.12) 0px 6px 18px 0px` | Cards, elevated surfaces |
+| Layered (Level 2) | <br>`rgba(209, 217, 224, 0) 0px 0px 0px 1px`,<br>`rgba(37, 41, 46, 0.24) 0px 40px 80px 0px` | Cards, elevated surfaces |
+| Inset (Level 3) | <br>`rgba(31, 35, 40, 0.04) 0px 1px 0px 0px inset` | Buttons, pressed-state elements |
+| Inset (Level 4) | <br>`rgb(209, 217, 224) 0px -1px 0px 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
+
+### Easing System
+
+| CSS Variable | Curve | Semantic Name |
+|--------------|-------|---------------|
+| `--brand-control-animation-easing` | `cubic-bezier(.33, 1, .68, 1)` | Custom Ease — Balanced |
+| `--brand-animation-easing-glide` | `cubic-bezier(.33, 1, .68, 1)` | Custom Ease — Balanced |
+| `--easing-easeInOut` | `cubic-bezier(.65,0,.35,1)` | Ease Out — Decelerating |
+| `--brand-animation-easing-default` | `cubic-bezier(.16, 1, .3, 1)` | Ease Out — Decelerating |
+| `--base-easing-easeIn` | `cubic-bezier(.7, .1, .75, .9)` | Custom Ease — Balanced |
+| `--brand-Card-animation-easing` | `cubic-bezier(.01, .73, .08, .93)` | Ease Out — Decelerating |
+| `--base-easing-easeOut` | `cubic-bezier(.3, .8, .6, 1)` | Custom Ease — Balanced |
+| `--base-easing-easeInOut` | `cubic-bezier(.6, 0, .2, 1)` | Ease Out — Decelerating |
+| `--base-easing-linear` | `cubic-bezier(0, 0, 1, 1)` | Custom Ease — Balanced |
+| `--base-easing-ease` | `cubic-bezier(.25, .1, .25, 1)` | Ease Out — Decelerating |
+
+### Duration Scale
+
+| CSS Variable | Value | Tier |
+|--------------|-------|------|
+| `--base-duration-600` | `.6s` | Slow |
+| `--brand-InlineLink-transition-timing` | `.3s` | Normal |
+| `--brand-control-animation-duration` | `80ms` | Fast |
+| `--base-duration-50` | `50ms` | Instant |
+| `--duration-fast` | `80ms` | Fast |
+| `--base-duration-300` | `.3s` | Normal |
+| `--base-duration-1000` | `1s` | Cinematic |
+| `--base-duration-500` | `.5s` | Slow |
+| `--brand-animation-duration-fast` | `.3s` | Normal |
+| `--base-duration-400` | `.4s` | Slow |
+
+### Copy-Paste Transition Snippets
+
+**Opacity**
+```css
+transition: opacity 0.4s linear 0.4s;
+```
+
+**Opacity**
+```css
+transition: opacity 0.5s cubic-bezier(0.16, 1, 0.3, 1), transform 0.5s cubic-bezier(0.16, 1, 0.3, 1);
+```
+
+**Color / Background**
+```css
+transition: color 0.08s cubic-bezier(0.65, 0, 0.35, 1), fill 0.08s cubic-bezier(0.65, 0, 0.35, 1), background-color 0.08s cubic-b...;
+```
+
+**Opacity**
+```css
+transition: opacity 0.5s cubic-bezier(0.16, 1, 0.3, 1);
+```
+
+### Keyframe Animation Catalog
+
+| Animation Name | Type | Animated Props | Use Hint |
+|----------------|------|----------------|----------|
+| `AppFrame-a11yLink-focus` | Scale | color, transform | UI transition |
+| `tooltip-appear` | Fade | opacity | UI transition |
+| `fade-in` | Fade | opacity | Element entrance |
+| `fade-out` | Fade | opacity | Element exit |
+| `fade-up` | Fade + Move | opacity, transform | UI transition |
+| `fade-down` | Fade + Move | opacity, transform | UI transition |
+| `grow-x` | Custom | width | UI transition |
+| `shrink-x` | Custom | width | UI transition |
+| `scale-in` | Fade + Move | opacity, transform | Focus / emphasis |
+| `pulse` | Fade | opacity | Attention / status |
+| `pulse-in` | Scale | transform | Attention / status |
+| `rotate-keyframes` | Rotate / Spin | transform | Loading indicator |
+| `AnimatedEllipsis-keyframes` | Slide | transform | UI transition |
+| `SelectMenu-modal-animation` | Fade + Move | opacity, transform | UI transition |
+| `SelectMenu-modal-animation--sm` | Fade + Move | opacity, transform | UI transition |
+| `Toast--animateIn` | Fade + Move | opacity, transform | UI transition |
+| `Toast--animateOut` | Fade + Move | pointer-events, opacity, transform | UI transition |
+| `Toast--spinner` | Rotate / Spin | transform | Loading indicator |
+| `Overlay--motion-scaleFade` | Fade + Move | opacity, transform | Focus / emphasis |
+| `Overlay--motion-slideDown` | Slide | transform | Panel / drawer enter |
+
+> *34 additional animations omitted (repetitive variants). See raw keyframes in `raw-css.json`.*
+
+### Motion Fingerprint
+
+- **Speed Character**: Deliberate & Calm (median duration: `400ms`)
+- **Dominant Easing**: custom cubic-bezier curves
+- **Animation Library**: 54 unique animations (54 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 Warm Brown (`#1f2328`) for text — not pure black, it's warmer and more readable
+- Use Mona Sans VF as the primary typeface — it defines the brand personality
+- Keep font weights between 400-600 — the system uses a narrow weight range for subtle hierarchy
+- Use the extracted shadow patterns for elevation — they are tuned to match the brand palette
+- Use Forest Green (`#1f883d`) 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
+- Maintain nav height at 40px — consistent vertical space for the navigation bar
+
+### Don't
+- Don't use pure black (`#000000`) for text — the near-black adds warmth
+- Don't substitute with generic sans-serif or serif — the custom font carries the brand
+- Don't use weight 700 (bold) or above — 600 is the maximum weight in this system
+- 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 collapse or hide the nav on scroll without an explicit scroll-triggered animation — the design uses fixed nav presence
+- Don't make the nav sticky — this design lets it scroll away to maximize content focus
+- Don't put a CTA button in the nav — this design uses links only at the top
+
+
+## 7b. Enforceable Brand Rules
+
+*Structured Do/Don't with reasoning and validation tests. Agents can programmatically verify generated UI.*
+
+```yaml
+rules:
+  - id: brand-canvas-001
+    type: do
+    rule: "Always use the page background `rgb(255, 255, 255)` as the base canvas"
+    why: "Every component is designed to composit against this exact tone"
+    test: "document.body.style.backgroundColor === 'rgb(255, 255, 255)'"
+  - id: brand-accent-001
+    type: do
+    rule: "Reserve `rgb(31, 136, 61)` for primary CTAs and brand-mark signals only"
+    why: "Single chromatic assertion device — overuse dilutes meaning"
+    test: "querySelectorAll('[style*=\"rgb(31, 136, 61)\"]').length <= 3 per fold"
+```
+
+## 9. Responsive Behavior
+
+### Breakpoints
+| Name | Width | Key Changes |
+|------|-------|-------------|
+| Mobile | 400px | Single column, compact spacing |
+| Mobile | 480px | Single column, compact spacing |
+| Mobile Large | 618px | Expanded mobile layout |
+| Mobile Large | 767px | Expanded mobile layout |
+| Tablet | 1011px | Multi-column grids begin |
+| Desktop | 1150px | Full feature layout |
+| Desktop | 1250px | Full feature layout |
+| Large Desktop | 1464px | Maximum content width |
+
+### Token Diff — Desktop vs Mobile
+
+| Element | Property | Desktop | Mobile |
+|---------|----------|---------|--------|
+| nav | height | `40px` | `324px` |
+| button | width | `100%` | `390px` |
+
+### Collapsing Strategy
+- 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: 1px 6px padding
+- Navigation: adequate spacing between items
+- Interactive elements: minimum 44px touch target recommended
+
+### Collapsing Narrative
+
+How the structural patterns adapt from desktop to mobile (extracted from both viewport extractions):
+
+*No major structural differences detected between desktop and mobile widgets. The same blueprints scale rather than collapse — verify by inspecting actual mobile render.*
+
+## 9b. Visual Tone & Photography
+
+**Tone:** Mixed photography + illustration
+
+A balanced mix of photographic content and vector graphics. Photos likely carry product/lifestyle context while SVG handles icons, logos, and decorative accents.
+
+**Canonical Brand Image (OG):**
+- https://github.githubassets.com/assets/github-logo-55c5b9a1fe52.png (1200×1200px)
+  *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: 3.39:1 (ultra-wide cinematic)
+- Rendered size: 1440×425px
+- *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): 0 (0%)
+- Portrait (<0.87): 1 (14%)
+- Square (0.87–1.15): 1 (14%)
+- Ultra-wide (>2.3): 5 (71%)
+
+**Media Format Mix:**
+
+**Average rendered image size:** 456×187px
+**Above-fold image count:** 7 / 7
+
+**Imagery Guidance for clones:**
+- Mix photography and illustration intentionally: photos for product/context, vectors for icons + decorative accents.
+- Respect the format split — replacing JPGs with illustrations (or vice versa) will shift the brand tone.
+
+## 10. Agent Prompt Guide
+
+### Quick Reference
+- Background: Text White (`#ffffff`)
+- Primary text: Warm Brown (`#1f2328`)
+- Accent: Forest Green (`#1f883d`)
+- Border: Warm Brown (`#25292e`)
+- Font: Mona Sans VF
+- Body: 14px weight 400
+
+### Example Component Prompts
+- "Create a hero section on Text White background (#ffffff). Headline at 32px Mona Sans VF weight 600, line-height 1.5, color #1f2328."
+- "Create the primary CTA button: `#1f883d` background, `#ffffff` text, 6px border-radius, 5px 16px padding, 500 weight, Mona Sans VF font."
+- "Design a card on `transparent` background. Border: none. Radius: 0px. Shadow: none. Padding: 0px."
+- "Build navigation: static on `#ffffff`. Mona Sans VF 16px weight 400 for links."
+
+### Iteration Guide
+1. **Canvas**: Set the light canvas to Text White (`#ffffff`) — every component is composited against this exact base.
+2. **Typography**: All type in Mona Sans VF, weight range 400–600. Never exceed 600 — heavier weights break the brand's tonal restraint.
+3. **Accent**: Forest Green (`#1f883d`) is the sole interactive color. On hover → M Tricolor Blue (`#0969da`). Use CSS transitions, not opacity/brightness filters.
+4. **Motion**: All transitions use `cubic-bezier(0.16,1,0.3,1)`. Timing: 50ms for micro-interactions, 400ms for layout changes. Never use linear for UI transitions — preserve the brand's easing personality.
+5. **Shape**: CTAs at `0px`, cards at `0px`. Apply border-radius from the extracted scale only — don't invent intermediate values.
+6. **Spacing**: Use the `--ca-space-*` token scale (6px–32px). All padding, margin, and gap values are multiples from this scale — no magic numbers.
+7. **Tokens**: Import from §11 CSS Export (`--ca-*` vars). Never hardcode hex values — always reference a token so theming remains consistent.
+
+## 11. CSS Design Tokens Raw Export
+
+*Copy-paste ready `:root {}` block — all values extracted directly from the live site.*
+
+```css
+/* Colors */
+:root {
+  --ca-on-primary: #ffffff;
+  --ca-surface-1: transparent;
+  --ca-surface-2: #e4ebe6;
+  --ca-primary-hover: #1f2328;
+  --ca-ink-subtle: #58635b;
+  --ca-primary: #1f883d;
+  --ca-hairline: #25292e;
+  --ca-primary-focus: #0969da;
+  --ca-semantic-error: #d1242f;
+  --ca-semantic-success: #1a7f37;
+  --ca-semantic-warning: #9a6700;
+}
+
+/* Typography */
+:root {
+  --ca-font-primary: "Mona Sans VF", system-ui, sans-serif;
+  --ca-text-display: 32px;
+  --ca-text-body: 16px;
+  --ca-text-small: 16px;
+  --ca-text-caption: 12px;
+  --ca-text-button: 16px;
+}
+
+/* Spacing & Radius */
+:root {
+  --ca-space-xxs: 2px;
+  --ca-space-xs: 6px;
+  --ca-space-sm: 16px;
+  --ca-space-md: 40px;
+  --ca-space-base: 16px;
+  --ca-space-lg: 24px;
+  --ca-space-xl: 32px;
+  --ca-space-2xl: 48px;
+  --ca-space-3xl: 64px;
+  --ca-radius-none: 0px;
+  --ca-radius-xs: 3px;
+  --ca-radius-sm: 6px;
+  --ca-radius-md: 12px;
+  --ca-radius-lg: 12px;
+  --ca-radius-xl: 12px;
+  --ca-radius-full: 9999px;
+}
+
+/* Motion */
+:root {
+  --ca-duration-fast: 80ms;
+}
+```
+
+
+## 13. Page Structure Skeleton
+
+*The actual layout the source site uses. Reproduce these sections in order to match the site structure.*
+
+```yaml
+page-skeleton:
+  - section: unknown
+    tag: div
+    classes: ["logged-out", "page-responsive", "min-height-full", "d-flex"]
+    height: 1219px
+    width: full-bleed
+    layout: flex-column justify=normal
+    children: 12
+  - section: main-content
+    tag: main
+    classes: ["font-mktg"]
+    height: 547px
+    width: full-bleed
+    layout: block
+    children: 2
+  - section: unknown
+    tag: div
+    classes: ["container-lg", "tmp-mt-5", "tmp-px-3", "tmp-pb-5"]
+    height: 145px
+    width: 1012px
+    layout: block
+    children: 2
+    padding: "0px 16px 32px"
+  - section: footer
+    tag: footer
+    classes: ["footer", "tmp-pt-6", "position-relative"]
+    height: 600px
+    width: full-bleed
+    layout: block
+    children: 3
+    padding: "40px 0px 0px"
+  - section: unknown
+    tag: div
+    classes: ["container-xl"]
+    height: 444px
+    width: 1280px
+    layout: block
+    children: 1
+    padding: "0px 16px"
+  - section: navigation
+    tag: nav
+    classes: ["col-6", "col-sm-3", "col-lg-2", "tmp-mb-6"]
+    height: 372px
+    width: 208px
+    layout: block
+    children: 2
+    padding: "0px 0px 0px 24px"
+  - section: navigation
+    tag: nav
+    classes: ["col-6", "col-sm-3", "col-lg-2", "tmp-mb-6"]
+    height: 372px
+    width: 208px
+    layout: block
+    children: 2
+    padding: "0px 0px 0px 24px"
+  - section: navigation
+    tag: nav
+    classes: ["col-6", "col-sm-3", "col-lg-2", "tmp-mb-6"]
+    height: 372px
+    width: 208px
+    layout: block
+    children: 2
+    padding: "0px 0px 0px 24px"
+  - section: navigation
+    tag: nav
+    classes: ["col-6", "col-sm-3", "col-lg-2", "tmp-mb-6"]
+    height: 372px
+    width: 208px
+    layout: block
+    children: 2
+    padding: "0px 0px 0px 24px"
+  - section: section-10
+    tag: section
+    classes: ["col-12", "col-lg-4", "tmp-mb-5", "tmp-pr-lg-4"]
+    height: 348px
+    width: 416px
+    layout: block
+    children: 4
+    padding: "0px 24px 0px 0px"
+  - section: unknown
+    tag: div
+    classes: ["container-xl", "f6", "tmp-py-4", "d-md-flex"]
+    height: 84px
+    width: 1280px
+    layout: flex-row justify=space-between
+    children: 2
+    padding: "24px 16px"
+```
+
+**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:
+  sub-headings:
+    - "Subscribe to our developer newsletter"
+    - "Platform"
+  ctas:
+    - "Platform"
+    - "Search or jump to..."
+    - "Sign in"
+    - "Sign up"
+    - "Search"
+    - "Subscribe"
+    - "Manage cookies"
+    - "English 
+Select language"
+  navigation:
+    - "Sign in"
+    - "Pricing"
+    - "Search syntax tips"
+    - "documentation"
+    - "Forgot password?"
+    - "or continue with other methods"
+    - "Sign up"
+    - "Features"
+    - "Enterprise"
+    - "Copilot"
+  footer-links:
+    - "Subscribe"
+    - "Features"
+    - "Terms"
+    - "GitHub on LinkedIn"
+    - "GitHub on YouTube"
+    - "GitHub’s organization on GitHub"
+```
+
+**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: 2
+    avg-ratio: 2.85
+    common-aspect: "~16:6 banner"
+  hero:
+    count: 1
+    avg-ratio: 3.39
+    common-aspect: "~16:6 banner"
+  product:
+    count: 1
+    avg-ratio: 1.09
+    common-aspect: "~1:1 square"
+    sample-alts:
+      - "404 “This is not the web page you are looking for”"
+```
+
+**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">
+  Platform
+</button>
+```
+_Source pattern detected: padding `8px` · radius `0px` · weight `400`_
+
+**Agent rule**: use these markup skeletons as the structural baseline. Apply tokens from §2-3 for visual styling.
+
+
+## 12. Known Extraction Gaps
+
+*Auto-detected limitations of this extraction — understand before building:*
+
+- **Sparse component extraction** — fewer than 5 component types detected. Highly dynamic sections (modals, datepickers, carousels) require interaction to render and are not captured in a static pass.
+
+
+---
+## Extraction Completeness: 88/100 (B)
+
+| Category | Score | Max | Detail |
+|----------|-------|-----|--------|
+| Colors & Palette | 21 | 25 | 15 named colors |
+| Typography | 20 | 20 | 11 roles defined |
+| Components | 12 | 20 | 3 specs extracted |
+| Motion & Interaction | 15 | 15 | Keyframes present, easing vars |
+| CSS Custom Properties | 10 | 10 | 1985 vars |
+| Responsive Breakpoints | 5 | 5 | 8 breakpoints |
+| Variable Fonts | 5 | 5 | ITAL axes |
+
+## 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 | 1985 CSS vars (semantic naming requires ≥20 for high) |
+| §3 Typography | High | 11 typography roles inferred |
+| §4 Components | Medium | 3 component variants captured |
+| §7 Motion | High | Keyframes + transitions |
+| §8 Do's/Don'ts | High | 15 rules generated; design-decisions.json has evidence per rule |
+| §9 Responsive | High | 8 breakpoints detected |
+| §9b Photography | High | 7 images, hero present |
+
+---
+*Generated by Clone Architect — automated Playwright extraction + design analysis.*
+*Source: https://github.com/paulsainton/lifeos-app.git | 2026-05-30T21:32:13.958Z*
+*All values verified via getComputedStyle() — no approximation, no hallucination.*