oh-my-opencode 4.10.0 → 4.11.0

package/packages/omo-codex/plugin/skills/frontend/references/design/expo.md

@@ -0,0 +1,281 @@
+# Design System Inspired by Expo
+
+## 1. Visual Theme & Atmosphere
+
+Expo's interface is a luminous, confidence-radiating developer platform built on the premise that tools for building apps should feel as polished as the apps themselves. The entire experience lives on a bright, airy canvas — a cool-tinted off-white (`#f0f0f3`) that gives the page a subtle technological coolness without the starkness of pure white. This is a site that breathes: enormous vertical spacing between sections creates a gallery-like pace where each feature gets its own "room."
+
+The design language is decisively monochromatic — pure black (`#000000`) headlines against the lightest possible backgrounds, with a spectrum of cool blue-grays (`#60646c`, `#b0b4ba`, `#555860`) handling all secondary communication. Color is almost entirely absent from the interface itself; when it appears, it's reserved for product screenshots, app icons, and the React universe illustration — making the actual content burst with life against the neutral canvas.
+
+What makes Expo distinctive is its pill-shaped geometry. Buttons, tabs, video containers, and even images use generously rounded or fully pill-shaped corners (24px–9999px), creating an organic, approachable feel that contradicts the typical sharp-edged developer tool aesthetic. Combined with tight letter-spacing on massive headlines (-1.6px to -3px at 64px), the result is a design that's simultaneously premium and friendly — like an Apple product page reimagined for developers.
+
+**Key Characteristics:**
+- Luminous cool-white canvas (`#f0f0f3`) with gallery-like vertical spacing
+- Strictly monochromatic: pure black headlines, cool blue-gray body text, no decorative color
+- Pill-shaped geometry everywhere — buttons, tabs, containers, images (24px–9999px radius)
+- Massive display headlines (64px) with extreme negative letter-spacing (-1.6px to -3px)
+- Inter as the sole typeface, used at weights 400–900 for full expressive range
+- Whisper-soft shadows that barely lift elements from the surface
+- Product screenshots as the only source of color in the interface
+
+## 2. Color Palette & Roles
+
+### Primary
+- **Expo Black** (`#000000`): The absolute anchor — used for primary headlines, CTA buttons, and the brand identity. Pure black on cool white creates maximum contrast without feeling aggressive.
+- **Near Black** (`#1c2024`): The primary text color for body content — a barely perceptible blue-black that's softer than pure #000 for extended reading.
+
+### Secondary & Accent
+- **Link Cobalt** (`#0d74ce`): The standard link color — a trustworthy, saturated blue that signals interactivity without competing with the monochrome hierarchy.
+- **Legal Blue** (`#476cff`): A brighter, more saturated blue for legal/footer links — slightly more attention-grabbing than Link Cobalt.
+- **Widget Sky** (`#47c2ff`): A light, friendly cyan-blue for widget branding elements — the brightest accent in the system.
+- **Preview Purple** (`#8145b5`): A rich violet used for "preview" or beta feature indicators — creating clear visual distinction from standard content.
+
+### Surface & Background
+- **Cloud Gray** (`#f0f0f3`): The primary page background — a cool off-white with the faintest blue-violet tint. Not warm, not sterile — precisely technological.
+- **Pure White** (`#ffffff`): Card surfaces, button backgrounds, and elevated content containers. Creates a clear "lifted" distinction from Cloud Gray.
+- **Widget Dark** (`#1a1a1a`): Dark surface for dark-theme widgets and overlay elements.
+- **Banner Dark** (`#171717`): The darkest surface variant, used for promotional banners and high-contrast containers.
+
+### Neutrals & Text
+- **Slate Gray** (`#60646c`): The workhorse secondary text color (305 instances). A cool blue-gray that's authoritative without being heavy.
+- **Mid Slate** (`#555860`): Slightly darker than Slate, used for emphasized secondary text.
+- **Silver** (`#b0b4ba`): Tertiary text, placeholders, and de-emphasized metadata. Comfortably readable but clearly receded.
+- **Pewter** (`#999999`): Accordion icons and deeply de-emphasized UI elements in dark contexts.
+- **Light Silver** (`#cccccc`): Arrow icons and decorative elements in dark contexts.
+- **Dark Slate** (`#363a3f`): Borders on dark surfaces, switch tracks, and emphasized containment.
+- **Charcoal** (`#333333`): Dark mode switch backgrounds and deep secondary surfaces.
+
+### Semantic & Accent
+- **Warning Amber** (`#ab6400`): A warm, deep amber for warning states — deliberately not bright yellow, conveying seriousness.
+- **Destructive Rose** (`#eb8e90`): A soft pink-coral for disabled destructive actions — gentler than typical red, reducing alarm fatigue.
+- **Border Lavender** (`#e0e1e6`): Standard card/container borders — a cool lavender-gray that's visible without being heavy.
+- **Input Border** (`#d9d9e0`): Button and form element borders — slightly warmer/darker than card borders for interactive elements.
+- **Dark Focus Ring** (`#2547d0`): Deep blue for keyboard focus indicators in dark theme contexts.
+
+### Gradient System
+- The design is notably **gradient-free** in the interface layer. Visual richness comes from product screenshots, the React universe illustration, and careful shadow layering rather than color gradients. This absence IS the design decision — gradients would undermine the clinical precision.
+
+## 3. Typography Rules
+
+### Font Family
+- **Primary**: `Inter`, with fallbacks: `-apple-system, system-ui`
+- **Monospace**: `JetBrains Mono`, with fallback: `ui-monospace`
+- **System Fallback**: `system-ui, Segoe UI, Roboto, Helvetica, Arial, Apple Color Emoji, Segoe UI Emoji`
+
+### Hierarchy
+
+| Role | Font | Size | Weight | Line Height | Letter Spacing | Notes |
+|------|------|------|--------|-------------|----------------|-------|
+| Display / Hero | Inter | 64px (4rem) | 700–900 | 1.10 (tight) | -1.6px to -3px | Maximum impact, extreme tracking |
+| Section Heading | Inter | 48px (3rem) | 600 | 1.10 (tight) | -2px | Feature section anchors |
+| Sub-heading | Inter | 20px (1.25rem) | 600 | 1.20 (tight) | -0.25px | Card titles, feature names |
+| Body Large | Inter | 18px (1.13rem) | 400–500 | 1.40 | normal | Intro paragraphs, section descriptions |
+| Body / Button | Inter | 16px (1rem) | 400–700 | 1.25–1.40 | normal | Standard text, nav links, buttons |
+| Caption / Label | Inter | 14px (0.88rem) | 400–600 | 1.00–1.40 | normal | Descriptions, metadata, badge text |
+| Tag / Small | Inter | 12px (0.75rem) | 500 | 1.00–1.60 | normal | Smallest sans-serif text, badges |
+| Code Body | JetBrains Mono | 16px (1rem) | 400–600 | 1.40 | normal | Inline code, terminal commands |
+| Code Caption | JetBrains Mono | 14px (0.88rem) | 400–600 | 1.40 | normal | Code snippets, technical labels |
+| Code Small | JetBrains Mono | 12px (0.75rem) | 400 | 1.60 | normal | Uppercase tech tags |
+
+### Principles
+- **One typeface, full expression**: Inter is the only sans-serif, used from weight 400 (regular) through 900 (black). This gives the design a unified voice while still achieving dramatic contrast between whisper-light body text and thundering display headlines.
+- **Extreme negative tracking at scale**: Headlines at 64px use -1.6px to -3px letter-spacing, creating ultra-dense text blocks that feel like logotypes. This aggressive compression is the signature typographic move.
+- **Weight as hierarchy**: 700–900 for display, 600 for headings, 500 for emphasis, 400 for body. The jumps are decisive — no ambiguous in-between weights.
+- **Consistent 1.40 body line-height**: Nearly all body and UI text shares 1.40 line-height, creating a rhythmic vertical consistency.
+
+## 4. Component Stylings
+
+### Buttons
+
+**Primary (White on border)**
+- Background: Pure White (`#ffffff`)
+- Text: Near Black (`#1c2024`)
+- Padding: 0px 12px (compact, content-driven height)
+- Border: thin solid Input Border (`1px solid #d9d9e0`)
+- Radius: subtly rounded (6px)
+- Shadow: subtle combined shadow on hover
+- The understated default — clean, professional, unheroic
+
+**Primary Pill**
+- Same as Primary but with pill-shaped radius (9999px)
+- Used for hero CTAs and high-emphasis actions
+- The extra roundness signals "start here"
+
+**Dark Primary**
+- Background: Expo Black (`#000000`)
+- Text: Pure White (`#ffffff`)
+- Pill-shaped (9999px) or generously rounded (32–36px)
+- No border (black IS the border)
+- The maximum-emphasis CTA — reserved for primary conversion actions
+
+### Cards & Containers
+- Background: Pure White (`#ffffff`) — clearly lifted from Cloud Gray page
+- Border: thin solid Border Lavender (`1px solid #e0e1e6`) for standard cards
+- Radius: comfortably rounded (8px) for standard cards; generously rounded (16–24px) for featured containers
+- Shadow Level 1: Whisper (`rgba(0,0,0,0.08) 0px 3px 6px, rgba(0,0,0,0.07) 0px 2px 4px`) — barely perceptible lift
+- Shadow Level 2: Standard (`rgba(0,0,0,0.1) 0px 10px 20px, rgba(0,0,0,0.05) 0px 3px 6px`) — clear floating elevation
+- Hover: likely subtle shadow deepening or background shift
+
+### Inputs & Forms
+- Background: Pure White (`#ffffff`)
+- Text: Near Black (`#1c2024`)
+- Border: thin solid Input Border (`1px solid #d9d9e0`)
+- Padding: 0px 12px (inline with button sizing)
+- Radius: subtly rounded (6px)
+- Focus: blue ring shadow via CSS custom property
+
+### Navigation
+- Sticky top nav on transparent/blurred background
+- Logo: Expo wordmark in black
+- Links: Near Black (`#1c2024`) or Slate Gray (`#60646c`) at 14–16px Inter weight 500
+- CTA: Black pill button ("Sign Up") on the right
+- GitHub star badge as social proof
+- Status indicator ("All Systems Operational") with green dot
+
+### Image Treatment
+- Product screenshots and device mockups are the visual heroes
+- Generously rounded corners (24px) on video and image containers
+- Screenshots shown in realistic device frames
+- Dark UI screenshots provide contrast against the light canvas
+- Full-bleed within rounded containers
+
+### Distinctive Components
+
+**Universe React Logo**
+- Animated/illustrated React logo as the visual centerpiece
+- Connects Expo's identity to the React ecosystem
+- The only illustrative element on an otherwise photographic page
+
+**Device Preview Grid**
+- Multiple device types (phone, tablet, web) shown simultaneously
+- Demonstrates cross-platform capability visually
+- Each device uses realistic device chrome
+
+**Status Badge**
+- "All Systems Operational" pill in the nav
+- Green dot + text — compact trust signal
+- Pill-shaped (36px radius)
+
+## 5. Layout Principles
+
+### Spacing System
+- Base unit: 8px
+- Scale: 1px, 2px, 4px, 8px, 12px, 16px, 24px, 32px, 40px, 48px, 64px, 80px, 96px, 144px
+- Button padding: 0px 12px (unusually compact — height driven by line-height)
+- Card internal padding: approximately 24–32px
+- Section vertical spacing: enormous (estimated 96–144px between major sections)
+- Component gap: 16–24px between sibling elements
+
+### Grid & Container
+- Max container width: approximately 1200–1400px, centered
+- Hero: centered single-column with massive breathing room
+- Feature sections: alternating layouts (image left/right, full-width showcases)
+- Card grids: 2–3 column for feature highlights
+- Full-width sections with contained inner content
+
+### Whitespace Philosophy
+- **Gallery-like pacing**: Each section feels like its own exhibit, surrounded by vast empty space. This creates a premium, unhurried browsing experience.
+- **Breathing room is the design**: The generous whitespace IS the primary design element — it communicates confidence, quality, and that each feature deserves individual attention.
+- **Content islands**: Sections float as isolated "islands" in the white space, connected by scrolling rather than visual continuation.
+
+### Border Radius Scale
+- Nearly squared (4px): Small inline elements, tags
+- Subtly rounded (6px): Buttons, form inputs, combo boxes — the functional interactive radius
+- Comfortably rounded (8px): Standard content cards, containers
+- Generously rounded (16px): Feature tabs, content panels
+- Very rounded (24px): Buttons, video/image containers, tabpanels — the signature softness
+- Highly rounded (32–36px): Hero CTAs, status badges, nav buttons
+- Pill-shaped (9999px): Primary action buttons, tags, avatars — maximum friendliness
+
+## 6. Depth & Elevation
+
+| Level | Treatment | Use |
+|-------|-----------|-----|
+| Flat (Level 0) | No shadow | Cloud Gray page background, inline text |
+| Surface (Level 1) | White bg, no shadow | Standard white cards on Cloud Gray |
+| Whisper (Level 2) | `rgba(0,0,0,0.08) 0px 3px 6px` + `rgba(0,0,0,0.07) 0px 2px 4px` | Subtle card lift, hover states |
+| Elevated (Level 3) | `rgba(0,0,0,0.1) 0px 10px 20px` + `rgba(0,0,0,0.05) 0px 3px 6px` | Feature showcases, product screenshots |
+| Modal (Level 4) | Dark overlay (`--dialog-overlay-background-color`) + heavy shadow | Dialogs, overlays |
+
+**Shadow Philosophy**: Expo uses shadows as gentle whispers rather than architectural statements. The primary depth mechanism is **background color contrast** — white cards floating on Cloud Gray — rather than shadow casting. When shadows appear, they're soft, diffused, and directional (downward), creating the feeling of paper hovering millimeters above a desk.
+
+## 7. Do's and Don'ts
+
+### Do
+- Use Cloud Gray (`#f0f0f3`) as the page background and Pure White (`#ffffff`) for elevated cards — the two-tone light system is essential
+- Keep display headlines at extreme negative letter-spacing (-1.6px to -3px at 64px) for the signature compressed look
+- Use pill-shaped (9999px) radius for primary CTA buttons — the organic shape is core to the identity
+- Reserve black (`#000000`) for headlines and primary CTAs — it carries maximum authority on the light canvas
+- Use Slate Gray (`#60646c`) for secondary text — it's the precise balance between readable and receded
+- Maintain enormous vertical spacing between sections (96px+) — the gallery pacing defines the premium feel
+- Use product screenshots as the primary visual content — the interface stays monochrome, the products bring color
+- Apply Inter at the full weight range (400–900) — weight contrast IS the hierarchy
+
+### Don't
+- Don't introduce decorative colors into the interface chrome — the monochromatic palette is intentional
+- Don't use sharp corners (border-radius < 6px) on interactive elements — the pill/rounded geometry is the signature
+- Don't reduce section spacing below 64px — the breathing room is the design
+- Don't use heavy drop shadows — depth comes from background contrast and whisper-soft shadows
+- Don't mix in additional typefaces — Inter handles everything from display to caption
+- Don't use letter-spacing wider than -0.25px on body text — extreme tracking is reserved for display only
+- Don't use borders heavier than 2px — containment is subtle, achieved through background color and gentle borders
+- Don't add gradients to the interface — visual richness comes from content, not decoration
+- Don't use saturated colors outside of semantic contexts — the palette is strictly grayscale + functional blue
+
+## 8. Responsive Behavior
+
+### Breakpoints
+| Name | Width | Key Changes |
+|------|-------|-------------|
+| Mobile | <640px | Single column, hamburger nav, stacked cards, hero text scales to ~36px |
+| Tablet | 640–1024px | 2-column grids, condensed nav, medium hero text |
+| Desktop | >1024px | Full multi-column layout, expanded nav, massive hero (64px) |
+
+*Only one explicit breakpoint detected (640px), suggesting a fluid, container-query or min()/clamp()-based responsive system rather than fixed breakpoint snapping.*
+
+### Touch Targets
+- Buttons use generous radius (24–36px) creating large, finger-friendly surfaces
+- Navigation links spaced with adequate gap
+- Status badge sized for touch (36px radius)
+- Minimum recommended: 44x44px
+
+### Collapsing Strategy
+- **Navigation**: Full horizontal nav with CTA collapses to hamburger on mobile
+- **Feature sections**: Multi-column → stacked single column
+- **Hero text**: 64px → ~36px progressive scaling
+- **Device previews**: Grid → stacked/carousel
+- **Cards**: Side-by-side → vertical stacking
+- **Spacing**: Reduces proportionally but maintains generous rhythm
+
+### Image Behavior
+- Product screenshots scale proportionally
+- Device mockups may simplify or show fewer devices on mobile
+- Rounded corners maintained at all sizes
+- Lazy loading for below-fold content
+
+## 9. Agent Prompt Guide
+
+### Quick Color Reference
+- Primary CTA / Headlines: "Expo Black (#000000)"
+- Page Background: "Cloud Gray (#f0f0f3)"
+- Card Surface: "Pure White (#ffffff)"
+- Body Text: "Near Black (#1c2024)"
+- Secondary Text: "Slate Gray (#60646c)"
+- Borders: "Border Lavender (#e0e1e6)"
+- Links: "Link Cobalt (#0d74ce)"
+- Tertiary Text: "Silver (#b0b4ba)"
+
+### Example Component Prompts
+- "Create a hero section on Cloud Gray (#f0f0f3) with a massive headline at 64px Inter weight 700, line-height 1.10, letter-spacing -3px. Text in Expo Black (#000000). Below, add a subtitle in Slate Gray (#60646c) at 18px. Place a black pill-shaped CTA button (9999px radius) beneath."
+- "Design a feature card on Pure White (#ffffff) with a 1px solid Border Lavender (#e0e1e6) border and comfortably rounded corners (8px). Title in Near Black (#1c2024) at 20px Inter weight 600, description in Slate Gray (#60646c) at 16px. Add a whisper shadow (rgba(0,0,0,0.08) 0px 3px 6px)."
+- "Build a navigation bar with Expo logo on the left, text links in Near Black (#1c2024) at 14px Inter weight 500, and a black pill CTA button on the right. Background: transparent with blur backdrop. Bottom border: 1px solid Border Lavender (#e0e1e6)."
+- "Create a code block using JetBrains Mono at 14px on a Pure White surface with Border Lavender border and 8px radius. Code in Near Black, keywords in Link Cobalt (#0d74ce)."
+- "Design a status badge pill (9999px radius) with a green dot and 'All Systems Operational' text in Inter 12px weight 500. Background: Pure White, border: 1px solid Input Border (#d9d9e0)."
+
+### Iteration Guide
+1. Focus on ONE component at a time
+2. Reference specific color names and hex codes — "use Slate Gray (#60646c)" not "make it gray"
+3. Use radius values deliberately — 6px for buttons, 8px for cards, 24px for images, 9999px for pills
+4. Describe the "feel" alongside measurements — "enormous breathing room with 96px section spacing"
+5. Always specify Inter and the exact weight — weight contrast IS the hierarchy
+6. For shadows, specify "whisper shadow" or "standard elevation" from the elevation table
+7. Keep the interface monochrome — let product content be the color

package/packages/omo-codex/plugin/skills/frontend/references/design/ferrari.md

@@ -0,0 +1,314 @@
+# Design System Inspired by Ferrari
+
+## 1. Visual Theme & Atmosphere
+
+Ferrari's website is a digital editorial — a curated magazine where the Prancing Horse brand is presented with the gravitas of an art institution and the precision of Italian coachwork. The page opens onto an expanse of absolute black, broken only by the iconic Prancing Horse emblem floating alone in its own atmosphere. Below, the content unfolds in dramatic alternations between inky-dark cinematic sections and crisp white editorial panels. This chiaroscuro rhythm — darkness yielding to light, machinery yielding to human story — feels more like paging through a Ferrari yearbook than scrolling a commercial website. Every section is a curated vignette: a concept car dissolving from shadow, two F1 drivers posed with sculptural stillness, a lineup of production models arranged in a jewel-toned parade.
+
+The color language is monastically restrained for a brand built on speed and emotion. Ferrari Red (`#DA291C`) appears with almost surgical sparseness — reserved for the Subscribe CTA and accent moments that need to command immediate attention. The vast majority of the interface lives in black, white, and a carefully calibrated gray scale (from `#303030` dark surfaces through `#8F8F8F` mid-tones to `#D2D2D2` light borders). Two yellows — Racing Yellow (`#FFF200`) and the deeper Modena Yellow (`#F6E500`) — exist in the token system as heritage accents for special contexts, honoring Ferrari's racing provenance. The restraint means that when red does appear, it carries the weight of the entire brand.
+
+Typography relies on FerrariSans — a proprietary sans-serif family with medium-weight headings (500–700) and compact proportions. Display text runs at 24–26px for section titles, while the UI chrome lives at 12–16px in weights ranging from regular to bold. A secondary "Body-Font" custom typeface handles captions and utility text, rendered in uppercase with wide letter-spacing (1px) to create a label-like editorial quality. This two-font system — FerrariSans for narrative authority, Body-Font for structural annotation — gives the site a print-magazine hierarchy. No text decoration is gratuitous. Letter-spacing is tight for headlines and deliberately expanded for labels, creating a visual rhythm that alternates between urgency and composure.
+
+**Key Characteristics:**
+- Chiaroscuro layout alternating between deep black sections and clean white editorial panels
+- Ferrari Red (`#DA291C`) used with extreme sparseness — accent, not atmosphere
+- Prancing Horse emblem as isolated hero element on a void-black field
+- FerrariSans proprietary typeface with compact proportions and medium weights
+- Photo-journalism imagery: concept renders, driver portraits, lineup parades — each section is a story
+- Uppercase Body-Font labels with wide letter-spacing (1px) for editorial annotation
+- Nearly zero border-radius (2px default) reflecting precision engineering aesthetics
+- Dual-framework architecture (PrimeReact + Element Plus) powering 32+ interactive components
+- Carousel-driven hero with editorial slides and arrow/dot navigation
+
+## 2. Color Palette & Roles
+
+### Primary
+- **Ferrari Red** (`#DA291C`): The iconic Rosso Corsa — primary accent and CTA color. Used for the Subscribe button, key action triggers, and brand moments where maximum visual authority is needed. The single most important color in the system (--f-color-accent-100)
+- **Pure White** (`#FFFFFF`): Primary surface for editorial content panels, navigation text on dark backgrounds, and button fills. The canvas that provides breathing room between dark cinematic sections (--f-color-ui-0)
+
+### Secondary & Accent
+- **Dark Red** (`#B01E0A`): Deeper variant of Ferrari Red for hover/pressed states and high-contrast contexts — adds dimensionality to the brand color without introducing a new hue (--f-color-accent-90)
+- **Deep Red** (`#9D2211`): The most saturated dark red — used for active states and extra emphasis where even Dark Red needs more weight (--f-color-accent-80)
+- **Racing Yellow** (`#FFF200`): Heritage accent from Ferrari's racing livery — reserved for special highlights and motorsport-related contexts (--f-color-yellow-hypersail)
+- **Modena Yellow** (`#F6E500`): Slightly warmer and more golden than Racing Yellow — used for secondary heritage accents and category markers (--f-color-yellow)
+
+### Surface & Background
+- **Absolute Black** (`#000000`): Hero sections, cinematic backgrounds, and the dominant dark surface — the void that makes imagery and the Prancing Horse emblem float
+- **Dark Surface** (`#303030`): Secondary dark surface for footer regions, newsletter sections, and layered dark panels — slightly lifted from pure black for depth differentiation (--f-color-ui-90)
+- **Light Gray Surface** (`#D2D2D2`): Subtle alternate surface for dividers and border treatments on white panels (--f-color-ui-20)
+- **Overlay Dark** (`hsla(0, 0%, 7%, 0.8)`): Semi-transparent near-black for modal overlays and image caption backgrounds (--f-color-overlay-darker)
+
+### Neutrals & Text
+- **Near Black** (`#181818`): Primary body text color on light surfaces — slightly softened from absolute black for better readability (link default color)
+- **Dark Gray** (`#666666`): Secondary text and subdued UI labels — used where text needs to recede from the primary hierarchy (--f-color-black-60)
+- **Mid Gray** (`#8F8F8F`): Tertiary text for metadata, timestamps, and supportive content (--f-color-black-50)
+- **Silver Gray** (`#969696`): Placeholder text and disabled state indicators (--f-color-black-55)
+
+### Semantic & Accent
+- **Warning Red** (`#F13A2C`): Accessible warning state — brighter and more orange-shifted than Ferrari Red to differentiate semantic alerts from brand expression (--f-color-accessible-warning)
+- **Success Green** (`#03904A`): Confirmation and positive status indicators (--f-color-accessible-success)
+- **Info Blue** (`#4C98B9`): Informational callouts, tooltips, and neutral status messaging (--f-color-accessible-info)
+- **Link Hover Blue** (`#3860BE`): Interactive hover state for text links — a dignified navy-blue that signals interactivity without competing with Ferrari Red
+
+### Gradient System
+- No explicit gradients in the token system
+- Depth is achieved through photography and the binary contrast between black and white surfaces
+- The overlay darker color (`hsla(0, 0%, 7%, 0.8)`) creates depth through transparency layering over imagery
+- Occasional photographic gradients (light falloff in studio shots) provide atmospheric depth within image content
+
+## 3. Typography Rules
+
+### Font Family
+- **FerrariSans**: Primary typeface for headings, navigation, buttons, and editorial content. A proprietary sans-serif with medium weight as the default (500), compact x-height, and precise letter-spacing control. Fallbacks: Arial, Helvetica, sans-serif
+- **Body-Font**: Secondary typeface for captions, labels, and utility text. Frequently rendered in uppercase with expanded letter-spacing (1px) for an editorial label aesthetic. Used for category tags and small annotation text
+- **Arial / Helvetica**: System fallback fonts used in cookie consent modals, form elements, and third-party component frameworks
+
+### Hierarchy
+
+| Role | Size | Weight | Line Height | Letter Spacing | Notes |
+|------|------|--------|-------------|----------------|-------|
+| Section Title | 26px (1.63rem) | 500 | 1.20 | normal | FerrariSans, primary editorial headings on white backgrounds |
+| Card Heading | 24px (1.50rem) | 400 | normal | normal | FerrariSans, content card titles |
+| Subheading | 18px (1.13rem) | 700 | 1.20 (tight) | normal | FerrariSans, bold subsection labels |
+| UI Heading | 16px (1.00rem) | 500 | 1.40 | 0.08px | FerrariSans, component headings and nav items |
+| Body Bold | 16px (1.00rem) | 700 | 1.30 (tight) | normal | FerrariSans, emphasized inline text |
+| Button Label | 16px (1.00rem) | 400 | normal | 1.28px | FerrariSans, primary button text with wide tracking |
+| Small Button | 14.4px (0.90rem) | 700 | 1.00 (tight) | normal | FerrariSans, compact action buttons |
+| Nav Link | 13px (0.81rem) | 600 | 1.20 (tight) | 0.13px | FerrariSans, navigation and footer links |
+| Caption | 13px (0.81rem) | 400 | 1.50 | 0.195px | FerrariSans/Body-Font, metadata and descriptions |
+| Micro Button | 12px (0.75rem) | 700 | 1.00 (tight) | 0.96px | FerrariSans, small CTA with wide tracking |
+| Label Upper | 12px (0.75rem) | 400 | 1.27 (tight) | 1px | Body-Font, uppercase labels and category tags |
+| Micro Label | 11px (0.69rem) | 400 | 1.27 (tight) | 1px | Body-Font, uppercase smallest annotation text |
+| Cookie Text | 45px (2.81rem) | 400 | 1.50 | 0.195px | Arial, consent dialog oversized button text |
+
+### Principles
+- **Proprietary identity**: FerrariSans is exclusive to Ferrari — it cannot be substituted without losing brand recognition. The font's compact proportions and medium weight default (500) convey engineering precision
+- **Two-register system**: FerrariSans handles narrative voice (headings, content, buttons) while Body-Font handles structural annotation (labels, tags, micro-captions) — this mirrors print magazine conventions of editorial text vs. technical labels
+- **Uppercase as emphasis tool**: Body-Font captions use `text-transform: uppercase` with expanded letter-spacing (1px) to create a visually distinct label layer that reads as "informational overlay" rather than primary content
+- **Compact line-heights**: Headlines use tight line-heights (1.00–1.30) creating dense, impactful text blocks, while body text opens to 1.50 for comfortable reading — the contrast between compressed headers and relaxed body text creates visual tension
+- **Weight range 400–700**: Four weights active in the system (400, 500, 600, 700) — significantly more range than Tesla but still controlled. 500 is the default "voice," 700 is for emphasis, 400 for body, 600 for navigation
+
+## 4. Component Stylings
+
+### Buttons
+Ferrari's buttons are minimal white rectangles with near-zero radius — the CTA philosophy is "architecture, not decoration."
+
+**Primary CTA (White)** — The default action button:
+- Default: bg `#FFFFFF`, text `#000000`, fontSize 16px (FerrariSans), letterSpacing 1.28px, padding 12px 10px, borderRadius 2px, border 1px solid `#000000`
+- Hover: bg `#1EAEDB` (Teal), text `#FFFFFF`, opacity 0.9
+- Focus: bg `#1EAEDB`, text `#FFFFFF`, border 1px solid `#FFFFFF`, outline 2px solid `#000000`, opacity 0.9
+- Used for: "Configure" actions, secondary calls to action on light backgrounds
+
+**Subscribe CTA (Red)** — The high-emphasis action button:
+- Default: bg `#DA291C` (Ferrari Red), text `#FFFFFF`, borderRadius 2px, padding 12px 10px
+- Used for: Newsletter subscribe, primary conversion actions on dark backgrounds
+- The only button that uses Ferrari Red — reserved for maximum visual priority
+
+**Ghost Button (White Border)** — For dark backgrounds:
+- Default: bg transparent, text `#FFFFFF`, border 1px solid `#FFFFFF`, borderRadius 2px, padding 12px 10px
+- Hover: bg `#1EAEDB` (Teal), text `#FFFFFF`, opacity 0.9
+- Focus: same as Primary CTA focus state
+- Used for: Actions overlaid on dark imagery and cinematic sections
+
+**Text Link** — Inline navigation:
+- Default: text `#181818` (on light surfaces) or `#FFFFFF` (on dark), no border, no background
+- Hover: color shifts to `#3860BE` (Link Hover Blue), decoration removes underline
+- White variant on dark surfaces uses underline decoration by default
+- FerrariSans or Body-Font depending on context (Body-Font for uppercase label links)
+
+### Cards & Containers
+
+**Editorial Card** (Content sections):
+- Background: white
+- Border: none
+- Shadow: none
+- Layout: image above, heading + caption below
+- Image treatment: full-width within card, no rounded corners on image
+- Text: FerrariSans heading (16–24px) + Body-Font caption (12–13px uppercase)
+
+**Dark Cinematic Card** (Hero/feature sections):
+- Background: `#000000` (Absolute Black)
+- Full-bleed imagery with text overlay
+- No border, no shadow — the darkness IS the container
+- Text: white, positioned with careful negative space
+
+**Vehicle Lineup** (Model carousel):
+- Horizontal scrollable row of vehicle thumbnails
+- Each vehicle on a neutral/white background
+- Navigation: arrow buttons + dot indicators
+- Background shifts to showcase the selected model's color context
+
+### Inputs & Forms
+
+**Newsletter Input** (Footer section):
+- Background: transparent on dark surface
+- Text: white
+- Border: 1px solid `#CCCCCC`
+- Placeholder: `#969696` (Silver Gray)
+- Focus: border color transitions (standard browser focus ring)
+- Label: Body-Font uppercase, 12px, 1px letter-spacing
+
+**Cookie Consent** (Modal):
+- Background: white
+- Border radius: 8px (dialog)
+- Shadow: `rgb(153, 153, 153) 1px 1px 1px 0px`
+- Buttons: oversized (45px Arial), white bg with black border
+- Uses standard PrimeReact/Element Plus modal framework
+
+### Navigation
+- **Desktop**: Prancing Horse logo centered at top of page, primary navigation below — not a traditional horizontal nav bar but a full-width header block on black background
+- **Logo**: Centered Prancing Horse emblem (44×42px) on absolute black — the single most prominent UI element
+- **Links**: FerrariSans, 13px, weight 600, white text on dark backgrounds
+- **Mobile**: Hamburger collapse to vertical navigation drawer
+- **Footer**: Multi-column layout on `#303030` (Dark Surface) with category links in Body-Font uppercase
+- **No sticky nav behavior** observed — the page scrolls naturally with the header moving off-screen
+
+### Image Treatment
+- **Hero**: Full-width editorial photography on black backgrounds — concept cars in atmospheric studio lighting, editorial portraits with cinematic composition
+- **Aspect ratios**: Mixed — landscape (16:9) for hero sections, near-square for portrait/driver imagery, wide panoramic for vehicle lineups
+- **Full-bleed vs padded**: Hero images are full-bleed edge-to-edge; editorial content images are padded within white containers
+- **Lazy loading**: Below-fold sections use progressive loading (PrimeReact framework handles this)
+- **Image quality**: High-resolution photography with studio lighting — no user-generated or lifestyle imagery. Every image is art-directed
+
+### Carousel Component
+- Editorial carousel with multiple slides
+- Dot indicators for slide position
+- Arrow navigation (left/right) at slide edges
+- Auto-advancing with manual override
+- Content: mixed editorial — event recaps, model launches, racing highlights
+
+## 5. Layout Principles
+
+### Spacing System
+- **Base unit**: 8px (detected system base)
+- **Scale**: 1px, 2px, 4px, 5px, 6px, 9px, 10px, 11.2px, 12px, 13px, 15px, 16px, 19px, 20px, 25px
+- **Button padding**: 12px vertical, 10px horizontal — compact and precise
+- **Section padding**: Generous vertical spacing (40–80px estimated) between major content blocks
+- **Card gaps**: 16–20px between grid items
+- **Footer padding**: 25px horizontal sections within the dark footer block
+
+### Grid & Container
+- **Max width**: 1920px (largest breakpoint) with content constraining at narrower widths
+- **Hero**: Full-bleed on black, content centered
+- **Editorial sections**: 2-column layouts with image + text, alternating sides
+- **Vehicle lineup**: Horizontal scroll/carousel, 5–6 models visible at desktop width
+- **Footer**: 4-column grid for link categories
+
+### Whitespace Philosophy
+Ferrari treats white space as a gallery wall. Each section — whether a concept car render on black void or a pair of F1 drivers on neutral gray — is given its own "room" of breathing space. The alternating black/white sections create a pacing rhythm: dark = immersive moment, white = editorial content, dark = immersive moment. This cadence makes scrolling feel like turning pages in a luxury publication. White space between editorial cards is moderate (not Tesla-extreme) because Ferrari is telling stories, not exhibiting single objects.
+
+### Border Radius Scale
+| Value | Context |
+|-------|---------|
+| 1px | Subtle softening on small inline elements (spans) |
+| 2px | Default for buttons, inputs, and interactive elements — barely perceptible, razor-precision |
+| 8px | Modal dialogs and overlay containers — the "softest" structural radius |
+| 50% | Circular elements: carousel dots, avatar thumbnails, slider handles |
+
+## 6. Depth & Elevation
+
+| Level | Treatment | Use |
+|-------|-----------|-----|
+| Level 0 (Flat) | No shadow, no border | Default state for all content sections and cards |
+| Level 1 (Subtle) | `rgb(153, 153, 153) 1px 1px 1px 0px` | Rare — cookie consent dialogs and dropdown menus |
+| Level 2 (Overlay) | `hsla(0, 0%, 7%, 0.8)` backdrop | Modal overlays and image caption backgrounds |
+| Level 3 (Border) | `1px solid #CCCCCC` | Input fields, form containers — depth through delineation not shadow |
+
+### Shadow Philosophy
+Ferrari's approach to elevation is nearly as flat as Tesla's, but with a different rationale. Where Tesla avoids shadows for minimalism, Ferrari avoids them because the editorial photography provides all the visual depth needed. The single shadow token (`rgb(153, 153, 153) 1px 1px 1px 0px`) is extremely subtle — a 1-pixel whisper used only in utilitarian contexts like consent dialogs. The site communicates hierarchy through three strategies:
+1. **Surface color contrast**: Black sections vs. white sections create unmistakable layering
+2. **Overlay transparency**: The `--f-color-overlay-darker` at 80% opacity creates depth without shadow
+3. **Photographic depth**: Studio-lit car imagery with reflections, ground shadows, and atmospheric haze provides all the visual dimensionality
+
+### Decorative Depth
+- No UI gradients, no glows, no blur effects on interface elements
+- The Prancing Horse logo on black creates a "floating in void" effect through pure contrast — no glow or shadow needed
+- Dark-to-light section transitions are hard cuts, not gradient blends — reinforcing the editorial page-turn metaphor
+
+## 7. Do's and Don'ts
+
+### Do
+- Use Ferrari Red (`#DA291C`) sparingly — only for primary CTAs and brand-critical moments. Its power comes from restraint
+- Alternate between black cinematic sections and white editorial sections to create the signature chiaroscuro rhythm
+- Use FerrariSans at weight 500 as the default heading voice — it's the typographic equivalent of the engine note
+- Apply Body-Font in uppercase with 1px letter-spacing for all labels, category tags, and structural annotations
+- Keep border-radius at 2px for all interactive elements — razor precision, not rounded friendliness
+- Let photography carry the emotional weight — every image should be art-directed studio quality
+- Use the Prancing Horse emblem as a standalone hero element on black — never crowd it with adjacent content
+- Maintain the 12px/10px button padding ratio — compact, purposeful, no excess
+- Use `#181818` (Near Black) for body text instead of pure `#000000` — the subtle warmth improves readability
+- Reserve the yellow accents (`#FFF200`, `#F6E500`) strictly for motorsport and racing heritage contexts
+
+### Don't
+- Scatter Ferrari Red across the interface as decoration — it's a CTA signal, not a theme color
+- Use rounded-pill buttons or large border-radii — the 2px precision is non-negotiable
+- Add box-shadows to cards or content containers — depth comes from surface color contrast and photography
+- Mix FerrariSans and Body-Font within the same text block — they serve separate hierarchical functions
+- Use colorful backgrounds (blue, green, etc.) for sections — the palette is exclusively black/white/gray with red and yellow accents
+- Apply text transforms to FerrariSans headings — uppercase is reserved for Body-Font labels only
+- Display low-quality or user-generated imagery — every photograph must meet editorial standards
+- Use the Link Hover Blue (`#3860BE`) for anything other than interactive hover states — it's not a brand color
+- Create busy layouts with multiple competing focal points — each section should have one clear story
+- Override the semantic color system (warning, success, info) with brand colors — `#F13A2C` warning is deliberately different from `#DA291C` brand red
+
+## 8. Responsive Behavior
+
+### Breakpoints
+| Name | Width | Key Changes |
+|------|-------|-------------|
+| Mobile Small | ≤375px | Single-column, minimal padding (12px), stacked navigation, hero text scales to ~18px, full-width CTAs |
+| Mobile | 376–600px | Single-column, slightly larger padding (16px), hamburger nav, body text at 13px |
+| Tablet Small | 601–768px | 2-column editorial grid begins, hero images maintain full-width, footer switches to 2-column |
+| Tablet | 769–960px | Full 2-column layout, carousel shows 3 vehicles, padding increases to 20px |
+| Desktop | 961–1280px | Full navigation, 2-column editorial with larger imagery, vehicle lineup shows 5 models |
+| Large Desktop | 1281–1920px | Maximum content width, generous whitespace, hero photography at full cinematic scale |
+
+### Touch Targets
+- Primary CTA buttons: minimum 44px height with 12px vertical padding (meets WCAG AAA 44×44px target)
+- Navigation links: 13px text with 1.50 line-height and adequate spacing between items
+- Carousel arrows: 44px+ touch targets at viewport edges
+- Footer links: grouped with sufficient vertical spacing (16–20px) for touch accuracy
+
+### Collapsing Strategy
+- **Navigation**: Full horizontal nav collapses to centered Prancing Horse logo + hamburger menu on mobile
+- **Editorial sections**: 2-column image+text layouts collapse to single-column with image stacking above text
+- **Vehicle lineup**: Horizontal carousel maintains scroll behavior but reduces visible models from 5 to 2–3
+- **Footer**: 4-column link grid collapses to 2-column on tablet, single-column accordion on mobile
+- **Hero carousel**: Full-width at all breakpoints, dot indicators and arrows scale proportionally
+- **Spacing reduction**: Section padding reduces from 40–80px (desktop) to 20–40px (mobile), maintaining proportional breathing room
+
+### Image Behavior
+- Hero images: full-bleed at all breakpoints, using `object-fit: cover` to maintain cinematic composition
+- Editorial images: responsive within their containers, maintaining aspect ratio
+- Vehicle lineup: thumbnail size scales but maintains consistent car-to-frame proportions
+- Art direction: mobile crops may tighten on vehicle subjects, reducing environmental context
+- Lazy loading: PrimeReact handles progressive image loading for below-fold content
+
+## 9. Agent Prompt Guide
+
+### Quick Color Reference
+- Primary CTA: "Ferrari Red (#DA291C)"
+- Background Light: "Pure White (#FFFFFF)"
+- Background Dark: "Absolute Black (#000000)"
+- Secondary Dark Surface: "Dark Surface (#303030)"
+- Heading text (light bg): "Near Black (#181818)"
+- Body text: "Dark Gray (#666666)"
+- Tertiary text: "Mid Gray (#8F8F8F)"
+- Border: "Border Gray (#CCCCCC)"
+- Button Hover: "Teal (#1EAEDB)"
+- Link Hover: "Link Blue (#3860BE)"
+
+### Example Component Prompts
+- "Create a hero section on Absolute Black (#000000) background with a centered logo emblem at the top, generous vertical spacing (80px+), and a single editorial headline in FerrariSans at 26px weight 500 in white, with a small Body-Font uppercase caption (12px, 1px letter-spacing) in Silver Gray (#969696) below"
+- "Design a Subscribe section on Dark Surface (#303030) with a left-aligned headline in white FerrariSans (24px/500), a subtitle in Mid Gray (#8F8F8F, 13px), an email input with transparent background and 1px #CCCCCC border, and a Ferrari Red (#DA291C) Subscribe button with white text, 2px border-radius, and 12px 10px padding"
+- "Build an editorial card on white background with a full-width image (16:9 ratio) above, a FerrariSans heading (16px/700, Near Black #181818) below, and a Body-Font uppercase label (11px, 1px letter-spacing, Mid Gray #8F8F8F) as the category tag — no border, no shadow, no border-radius"
+- "Create a vehicle lineup carousel showing 5 car thumbnails in a horizontal scroll on white background, with left/right arrow navigation, dot indicators below, and a FerrariSans model name (16px/500) beneath each vehicle"
+- "Design a dark cinematic section with full-bleed studio photography of a concept car on Absolute Black, a white FerrariSans headline (26px/500) positioned in the lower-left with generous padding (40px), and a Ghost Button (transparent bg, 1px white border, white text, 2px radius) as the CTA"
+
+### Iteration Guide
+When refining existing screens generated with this design system:
+1. Focus on ONE component at a time — Ferrari's editorial rhythm means each section is a self-contained vignette
+2. Reference specific color names and hex codes from this document — the palette is small but each color has a precise role
+3. Use natural language descriptions, not CSS values — "razor-sharp 2px corners" conveys intent better than "border-radius: 2px"
+4. Describe the desired "feel" alongside specific measurements — "editorial magazine page-turn between sections" communicates the layout philosophy better than "margin-bottom: 80px"
+5. Always maintain the chiaroscuro contrast — if a section feels flat, check whether it needs to be on black or white to maintain the alternating rhythm
+6. Reserve Ferrari Red for ONE element per screen — if red appears in more than one place, it loses its authority