winter-super-cli 2026.5.15

package/resources/local/awesome-design-md/design-md/superhuman/DESIGN.md

@@ -0,0 +1,252 @@
+# Design System Inspired by Superhuman
+
+## 1. Visual Theme & Atmosphere
+
+Superhuman's website feels like opening a luxury envelope — predominantly white, immaculately clean, with a single dramatic gesture of color that commands attention. The hero section is a cinematic purple gradient, a deep twilight wash of `#1b1938` that evokes the moment just before dawn, overlaid with confident white typography. Below this dramatic entrance, the rest of the site is almost entirely white canvas with dark charcoal text, creating a stark but refined reading experience.
+
+The typography is the true signature: Super Sans VF, a custom variable font with unconventional weight stops (460, 540, 600, 700) that sit between traditional font weight categories. Weight 460 — slightly heavier than regular but lighter than medium — is the workhorse, creating text that feels more confident than typical 400-weight but never aggressive. The tight line-heights (0.96 on display text) compress headlines into dense, powerful blocks, while generous 1.50 line-height on body text provides airy readability. This tension between compressed power and breathing room defines the Superhuman typographic voice.
+
+The design philosophy is maximum confidence through minimum decoration. Warm cream buttons (`#e9e5dd`) instead of bright CTAs, a near-absence of borders and shadows, and lavender purple (`#cbb7fb`) as the sole accent color. It's a productivity tool that markets itself like a luxury brand — every pixel earns its place, nothing is merely decorative. The brand naming convention extends to colors: the primary purple is called "Mysteria," straddling blue and purple with deliberate ambiguity.
+
+**Key Characteristics:**
+- Deep purple gradient hero (`#1b1938`) contrasting against a predominantly white content body
+- Super Sans VF variable font with non-standard weight stops (460, 540, 600, 700) — sits between conventional weight categories
+- Ultra-tight display line-height (0.96) creating compressed, powerful headlines
+- Warm Cream (`#e9e5dd`) buttons instead of bright/saturated CTAs — understated luxury
+- Lavender Purple (`#cbb7fb`) as the singular accent color — a soft, approachable purple
+- Minimal border-radius scale: only 8px and 16px — no micro-rounding, no pill shapes
+- Product screenshots dominate the content — the UI sells itself with minimal surrounding decoration
+
+## 2. Color Palette & Roles
+
+### Primary
+- **Mysteria Purple** (`#1b1938`): Hero gradient background, deep purple that straddles blue-purple — the darkest expression of the brand
+- **Lavender Glow** (`#cbb7fb`): Primary accent and highlight color — soft purple used for emphasis, decorative elements, and interactive highlights
+- **Charcoal Ink** (`#292827`): Primary text and heading color on light surfaces — warm near-black with faint brown undertone
+
+### Secondary & Accent
+- **Amethyst Link** (`#714cb6`): Underlined link text — mid-range purple that connects to the brand palette while signaling interactivity
+- **Translucent White** (`color(srgb 1 1 1 / 0.95)`): Hero overlay text — near-white at 95% opacity for depth layering on dark surfaces
+- **Misted White** (`color(srgb 1 1 1 / 0.8)`): Secondary text on dark surfaces — 80% opacity white for hierarchy on the hero gradient
+
+### Surface & Background
+- **Pure White** (`#ffffff`): Primary page background — the dominant canvas color for all content sections
+- **Warm Cream** (`#e9e5dd`): Button background — a warm, neutral cream that avoids the coldness of pure gray
+- **Parchment Border** (`#dcd7d3`): Card and divider borders — warm light gray with slight pink undertone
+
+### Neutrals & Text
+- **Charcoal Ink** (`#292827`): Primary heading and body text on white surfaces
+- **Amethyst Link** (`#714cb6`): In-content links with underline decoration
+- **Translucent White 95%** (`color(srgb 1 1 1 / 0.95)`): Primary text on dark/purple surfaces
+- **Translucent White 80%** (`color(srgb 1 1 1 / 0.8)`): Secondary text on dark/purple surfaces
+
+### Semantic & Accent
+- Superhuman operates with extreme color restraint — Lavender Glow (`#cbb7fb`) is the only true accent
+- Interactive states are communicated through opacity shifts and underline decorations rather than color changes
+- The warm cream button palette avoids any saturated semantic colors (no red errors, green success visible on marketing)
+
+### Gradient System
+- **Hero Gradient**: Deep purple gradient starting from `#1b1938`, transitioning through purple-to-twilight tones across the hero section — the most dramatic visual element on the entire site
+- **Content Transition**: The gradient dissolves into the white content area, creating a cinematic curtain-lift effect as the user scrolls
+- No other gradients on the marketing site — the hero gradient is a singular dramatic gesture
+
+## 3. Typography Rules
+
+### Font Family
+- **Display & Body**: `Super Sans VF` — custom variable font with non-standard weight axis. Fallbacks: `system-ui, -apple-system, Segoe UI, Roboto, Oxygen, Ubuntu, Cantarell, Fira Sans, Droid Sans, Helvetica Neue`
+- **Product UI** (referenced in brand): `Messina Sans` / `Messina Serif` / `Messina Mono` from Luzi Type — used in the product itself for sans-serif-to-serif transitions
+
+### Hierarchy
+
+| Role | Font | Size | Weight | Line Height | Letter Spacing | Notes |
+|------|------|------|--------|-------------|----------------|-------|
+| Display Hero | Super Sans VF | 64px | 540 | 0.96 | 0px | Maximum compression, powerful block headlines |
+| Section Display | Super Sans VF | 48px | 460 | 0.96 | -1.32px | Lighter weight for section introductions |
+| Section Heading | Super Sans VF | 48px | 460 | 0.96 | 0px | Alternate section heading without tracking |
+| Feature Title | Super Sans VF | 28px | 540 | 1.14 | -0.63px | Feature block headlines, tighter |
+| Sub-heading Large | Super Sans VF | 26px | 460 | 1.30 | 0px | Content sub-sections |
+| Card Heading | Super Sans VF | 22px | 460 | 0.76 | -0.315px | Card title with extreme compression |
+| Body Heading | Super Sans VF | 20px | 460 | 1.20 | 0px | Bold content intros |
+| Body Heading Alt | Super Sans VF | 20px | 460 | 1.10 | -0.55px | Tighter variant for emphasis |
+| Body Heading Relaxed | Super Sans VF | 20px | 460 | 1.25 | -0.4px | More breathing room variant |
+| Emphasis Body | Super Sans VF | 18px | 540 | 1.50 | -0.135px | Medium-weight body for callouts |
+| Body | Super Sans VF | 16px | 460 | 1.50 | 0px | Standard reading text — generous line-height |
+| Button / UI Bold | Super Sans VF | 16px | 700 | 1.00 | 0px | Bold UI elements |
+| Button / UI Semi | Super Sans VF | 16px | 600 | 1.00 | 0px | Semi-bold navigation and labels |
+| Nav Link | Super Sans VF | 16px | 460 | 1.20 | 0px | Navigation items |
+| Caption | Super Sans VF | 14px | 500 | 1.20 | -0.315px | Small labels, metadata |
+| Caption Semi | Super Sans VF | 14px | 600 | 1.29 | 0px | Emphasized small text |
+| Caption Body | Super Sans VF | 14px | 460 | 1.50 | 0px | Small body text |
+| Micro Label | Super Sans VF | 12px | 700 | 1.50 | 0px | Smallest text — badges, tags |
+
+### Principles
+- **Non-standard weight axis**: Weights 460 and 540 are deliberately between conventional Regular (400) and Medium (500), creating a typographic texture that feels subtly "off" in a confident way — slightly heavier than expected, never quite bold
+- **Extreme display compression**: Display headlines at 0.96 line-height collapse lines nearly on top of each other, creating dense typographic blocks that feel architectural
+- **Body generosity**: In contrast, body text at 1.50 line-height is extremely spacious, ensuring comfortable reading after the dense headline impact
+- **Selective negative tracking**: Letter-spacing is applied surgically — -1.32px on 48px headings, -0.63px on 28px features, but 0px on body text. The larger the text, the tighter the tracking
+- **Variable font efficiency**: A single font file serves all weight variations (460–700), enabling smooth weight transitions and micro-adjustments
+
+## 4. Component Stylings
+
+### Buttons
+- **Warm Cream Primary**: `#e9e5dd` background, Charcoal Ink (`#292827`) text, subtle rounded corners (8px radius), no visible border. The signature CTA — warm, muted, luxurious rather than aggressive
+- **Dark Primary** (on light sections): `#292827` background with white text, 8px radius — inverse of the warm cream for contrast sections
+- **Ghost / Text Link**: No background, underline decoration, Amethyst Link (`#714cb6`) or Charcoal Ink color depending on context
+- **Hero CTA**: Warm Cream on the dark purple gradient — the cream color pops dramatically against `#1b1938`
+- **Hover**: Subtle opacity or brightness shift — no dramatic color transformations
+
+### Cards & Containers
+- **Content Card**: White background, Parchment Border (`#dcd7d3`) 1px border, 16px border-radius — clean and minimal
+- **Dark Surface Card**: `#292827` border on dark sections, maintaining warm-neutral tone
+- **Hero Surface**: Semi-transparent white border (`rgba(255, 255, 255, 0.2)`) on purple gradient — ghostly containment
+- **Product Screenshot Cards**: Large product UI images with clean edges, minimal framing — the product itself is the visual
+- **Hover**: Minimal state changes — consistency and calm over flashy interactions
+
+### Inputs & Forms
+- Minimal form presence on the marketing site — Superhuman funnels users directly to signup
+- Dark-bordered inputs with Charcoal Ink borders and warm-toned placeholder text
+- Focus: Border emphasis increase, likely shifting from Parchment Border to Charcoal Ink
+
+### Navigation
+- **Top nav**: Clean white background on content sections, transparent on hero gradient
+- **Nav links**: Super Sans VF at 16px, weight 460/600 for hierarchy
+- **CTA button**: Warm Cream (`#e9e5dd`) pill in the nav — subtle, not attention-grabbing
+- **Sticky behavior**: Nav remains fixed on scroll with background transition
+- **Mobile**: Collapses to hamburger menu with simplified layout
+
+### Image Treatment
+- **Product screenshots**: Large, dominant product UI images showing the email interface — the product is the hero
+- **Lifestyle photography**: A single dramatic image (silhouette against purple/red gradient) in the hero area — cinematic and editorial
+- **Full-width presentation**: Screenshots span full container width with subtle shadow or no border
+- **Aspect ratios**: Wide landscape ratios (roughly 16:9) for product screenshots
+- **Color integration**: Screenshots are carefully color-graded to harmonize with the purple-to-white page flow
+
+### Testimonial / Social Proof
+- "Your Superhuman suite" section with product feature grid
+- Feature descriptions paired with product screenshots — proof through demonstration rather than quotes
+- Clean grid layout with consistent card sizing
+
+## 5. Layout Principles
+
+### Spacing System
+- **Base unit**: 8px
+- **Scale**: 2px, 4px, 6px, 8px, 12px, 16px, 18px, 20px, 24px, 28px, 32px, 36px, 40px, 48px, 56px
+- **Section padding**: 48px–80px vertical between major sections
+- **Card padding**: 16px–32px internal spacing
+- **Component gaps**: 8px–16px between related elements
+
+### Grid & Container
+- **Max width**: ~1200px content container, centered
+- **Column patterns**: Full-width hero, centered single-column for key messaging, 2-3 column grid for feature cards
+- **Feature grid**: Even column distribution for "Your Superhuman suite" product showcase
+
+### Whitespace Philosophy
+- **Confident emptiness**: Generous whitespace between sections signals premium positioning — every element has room to breathe
+- **Product as content**: Large product screenshots fill space that lesser sites would fill with marketing copy
+- **Progressive density**: The hero is spacious and cinematic, content sections become denser with feature grids, then opens up again for CTAs
+
+### Border Radius Scale
+- **8px**: Buttons, inline elements (`span`, `button`, `div`) — the universal small radius
+- **16px**: Cards, links, larger containers (`a`, card elements) — the universal large radius
+- Only two radii in the entire system — radical simplicity. No micro-rounding (2px), no pill shapes (50px+)
+
+## 6. Depth & Elevation
+
+| Level | Treatment | Use |
+|-------|-----------|-----|
+| Level 0 (Flat) | No shadow, white background | Primary page canvas, most content surfaces |
+| Level 1 (Border) | `1px solid #dcd7d3` (Parchment Border) | Card containment, section dividers |
+| Level 2 (Dark Border) | `1px solid #292827` | Header elements, dark section separators |
+| Level 3 (Glow) | Subtle shadow (from 6 shadow definitions detected) | Product screenshot containers, elevated cards |
+| Level 4 (Hero Depth) | `rgba(255, 255, 255, 0.2)` transparent border | Elements on the dark purple gradient hero |
+
+### Shadow Philosophy
+Superhuman's elevation system is remarkably restrained on the marketing site. Depth is primarily communicated through:
+- **Border containment**: Warm-toned borders (`#dcd7d3`) at 1px create gentle separation
+- **Color contrast**: The hero gradient creates massive depth through color shift rather than shadows
+- **Product screenshots**: Screenshots themselves create depth by showing a layered UI within the flat page
+- **Opacity layering**: Semi-transparent whites on the hero gradient create atmospheric depth layers
+
+### Decorative Depth
+- **Hero gradient**: The `#1b1938` → white gradient transition is the primary depth device — a cinematic curtain effect
+- **Lavender accents**: `#cbb7fb` Lavender Glow elements float above the dark gradient, creating a stellar/atmospheric effect
+- **No glassmorphism**: Despite the translucent borders, there are no blur/frosted-glass effects
+- **Photography depth**: The hero silhouette image creates natural atmospheric depth without artificial CSS
+
+## 7. Do's and Don'ts
+
+### Do
+- Use Super Sans VF at weight 460 as the default — it's slightly heavier than regular, which is the brand's typographic signature
+- Keep display headlines at 0.96 line-height — the compression is intentional and powerful
+- Use Warm Cream (`#e9e5dd`) for primary buttons — not white, not gray, specifically warm cream
+- Limit border-radius to 8px (small) and 16px (large) — the binary radius system is deliberate
+- Apply negative letter-spacing on headlines only (-0.63px to -1.32px) — body text stays at 0px
+- Use Lavender Glow (`#cbb7fb`) as the only accent color — it's the sole color departure from the neutral palette
+- Let product screenshots be the primary visual content — the UI sells itself
+- Maintain the dramatic hero gradient as a singular gesture — the rest of the page is white
+
+### Don't
+- Use conventional font weights (400, 500, 600) — Superhuman's 460 and 540 are deliberately between standard stops
+- Add bright or saturated CTA colors (blue, green, red) — buttons are intentionally muted in Warm Cream or Charcoal
+- Introduce additional accent colors beyond Lavender Glow — the palette is deliberately restrained to one accent
+- Apply shadows generously — depth comes from borders, color contrast, and photography, not box-shadows
+- Use tight line-height on body text — display is compressed (0.96) but body is generous (1.50)
+- Add decorative elements, icons, or illustrations — Superhuman relies on product UI and minimal typography
+- Create pill-shaped buttons — the system uses 8px radius, not rounded pills
+- Use pure black (`#000000`) for text — Charcoal Ink (`#292827`) is warmer and softer
+
+## 8. Responsive Behavior
+
+### Breakpoints
+| Name | Width | Key Changes |
+|------|-------|-------------|
+| Mobile | <768px | Single column, hero text reduces to ~36px, stacked feature cards, hamburger nav |
+| Tablet | 768px–1024px | 2-column feature grid begins, hero text ~48px, nav partially visible |
+| Desktop | 1024px–1440px | Full layout, 64px hero display, multi-column feature grid, full nav |
+| Large Desktop | >1440px | Max-width container centered, generous side margins |
+
+### Touch Targets
+- Buttons: 8px radius with comfortable padding — meets touch target guidelines
+- Nav links: 16px text with adequate surrounding padding
+- Mobile CTAs: Full-width Warm Cream buttons for easy thumb reach
+- Links: Underline decoration provides clear tap affordance
+
+### Collapsing Strategy
+- **Navigation**: Full horizontal nav → hamburger menu on mobile
+- **Hero text**: 64px display → 48px → ~36px across breakpoints
+- **Feature grid**: Multi-column product showcase → 2-column → single stacked column
+- **Product screenshots**: Scale within containers, maintaining landscape ratios
+- **Section spacing**: Reduces proportionally — generous desktop margins compress on mobile
+
+### Image Behavior
+- Product screenshots scale responsively while maintaining aspect ratios
+- Hero silhouette image crops or scales — maintains dramatic composition
+- No art direction changes — same compositions across all breakpoints
+- Lazy loading likely on below-fold product screenshots
+
+## 9. Agent Prompt Guide
+
+### Quick Color Reference
+- Hero Background: Mysteria Purple (`#1b1938`)
+- Primary Text (light bg): Charcoal Ink (`#292827`)
+- Primary Text (dark bg): Translucent White (`color(srgb 1 1 1 / 0.95)` — use `rgba(255,255,255,0.95)`)
+- Accent: Lavender Glow (`#cbb7fb`)
+- Button Background: Warm Cream (`#e9e5dd`)
+- Border: Parchment Border (`#dcd7d3`)
+- Link: Amethyst Link (`#714cb6`)
+- Page Background: Pure White (`#ffffff`)
+
+### Example Component Prompts
+- "Create a hero section with deep purple gradient background (#1b1938), 64px Super Sans heading at weight 540, line-height 0.96, white text at 95% opacity, and a warm cream button (#e9e5dd, 8px radius, #292827 text)"
+- "Design a feature card with white background, 1px #dcd7d3 border, 16px radius, 20px Super Sans heading at weight 460, and 16px body text at weight 460 with 1.50 line-height in #292827"
+- "Build a navigation bar with white background, Super Sans links at 16px weight 460, a warm cream CTA button (#e9e5dd, 8px radius), sticky positioning"
+- "Create a product showcase section with centered 48px heading (weight 460, -1.32px letter-spacing, #292827), a large product screenshot below, on white background"
+- "Design an accent badge using Lavender Glow (#cbb7fb) background, 8px radius, 12px bold text (weight 700), for category labels"
+
+### Iteration Guide
+When refining existing screens generated with this design system:
+1. Verify font weight is 460 (not 400 or 500) for body and 540 for display — the non-standard weights are essential
+2. Check that display line-height is 0.96 — if headlines look too spaced, they're wrong
+3. Ensure buttons use Warm Cream (#e9e5dd) not pure white or gray — the warmth is subtle but critical
+4. Confirm the only accent color is Lavender Glow (#cbb7fb) — no other hues should appear
+5. The overall tone should feel like a luxury product presentation — minimal, confident, with one dramatic color gesture in the hero

package/resources/local/awesome-design-md/design-md/superhuman/README.md

@@ -0,0 +1,5 @@
+# Superhuman Inspired Design System
+
+Design system details have been moved to: https://getdesign.md/superhuman/design-md
+
+You can also view previews, dark mode examples, and download options on getdesign.md.

package/resources/local/awesome-design-md/design-md/tesla/DESIGN.md

@@ -0,0 +1,286 @@
+# Design System Inspired by Tesla
+
+## 1. Visual Theme & Atmosphere
+
+Tesla's website is an exercise in radical subtraction — a digital showroom where the product is everything and the interface is almost nothing. The page opens with a full-viewport hero that fills the entire screen with cinematic car photography: three vehicles arranged on polished concrete against a hazy cityscape sky, with a single model name floating above in translucent white type. There are no decorative borders, no gradients, no patterns, no shadows. The UI exists only to provide just enough navigational structure to get out of the way. Every pixel that isn't product imagery is white space, and that restraint is the design system's most powerful statement.
+
+The color philosophy is almost ascetic: a single blue (`#3E6AE1`) for primary calls to action, three shades of dark gray for text hierarchy, and white for everything else. The entire emotional weight is carried by photography — sprawling landscape shots, studio-lit vehicle profiles, and atmospheric environmental compositions that stretch edge-to-edge across each viewport-height section. The UI chrome dissolves into the imagery. The navigation bar floats above the hero with no visible background, border, or shadow — the TESLA wordmark and five navigation labels simply exist in the space, trusting the content beneath them to provide sufficient contrast.
+
+Typography recently transitioned from Gotham to Universal Sans — a custom family split into "Display" for headlines and "Text" for body/UI elements — unifying the website, mobile app, and in-car software into a single typographic voice. The Display variant renders hero titles at 40px weight 500, while the Text variant handles everything from navigation (14px/500) to body copy (14px/400). The font carries a geometric precision with slightly humanist terminals that feels engineered rather than designed — exactly matching Tesla's brand identity of technology that doesn't need to announce itself. There are no text shadows, no text gradients, no decorative type treatments. Every letterform earns its place through clarity alone.
+
+**Key Characteristics:**
+- Full-viewport hero sections (100vh) dominated by cinematic car photography with minimal overlay UI
+- Near-zero UI decoration: no shadows, no gradients, no borders, no patterns anywhere on the page
+- Single accent color — Electric Blue (`#3E6AE1`) — used exclusively for primary CTA buttons
+- Universal Sans font family (Display + Text) unifying web, app, and in-car interfaces
+- Photography-first presentation where product imagery carries all emotional weight
+- Frosted-glass navigation concept with transparent/white nav that floats over hero content
+- 0.33s cubic-bezier transitions as the universal timing for all interactive state changes
+- Carousel-driven hero with dot indicators and edge arrow navigation for multiple vehicle showcases
+- "Ask a Question" persistent chatbot bar anchored to the viewport bottom
+
+## 2. Color Palette & Roles
+
+### Primary
+- **Electric Blue** (`#3E6AE1`): Primary CTA button background — a confident, mid-saturation blue (rgb 62, 106, 225) that stands alone as the only chromatic color in the entire interface. Used exclusively for "Order Now" and other primary action buttons
+- **Pure White** (`#FFFFFF`): Dominant background color for all surfaces, panels, navigation, and secondary button fills — the canvas that lets photography breathe
+
+### Secondary & Accent
+- **Promo Blue** (`#3E6AE1`): Blue also serves for promotional text ("0% APR Available") displayed over hero imagery in the same hue as the CTA — creating a visual link between incentive messaging and action
+- No secondary accent colors exist. Tesla deliberately avoids color variety to maintain extreme visual discipline
+
+### Surface & Background
+- **White Canvas** (`#FFFFFF`): Page background, navigation panel, dropdown menus, and all surface containers
+- **Light Ash** (`#F4F4F4`): Subtle alternate surface for section differentiation — barely perceptible shift from pure white (rgb 244, 244, 244)
+- **Carbon Dark** (`#171A20`): Dark surface color for hero text overlays and potential dark-mode contexts (rgb 23, 26, 32) — a warm near-black with a blue undertone
+- **Frosted Glass** (`rgba(255, 255, 255, 0.75)`): Semi-transparent white for navigation backdrop-filter effects on scroll
+
+### Neutrals & Text
+- **Carbon Dark** (`#171A20`): Primary heading and navigation text — the darkest text value (rgb 23, 26, 32), used for model names, nav labels, and hero titles on light backgrounds
+- **Graphite** (`#393C41`): Body text and secondary content (rgb 57, 60, 65) — the default paragraph color, slightly warmer than pure gray
+- **Pewter** (`#5C5E62`): Tertiary text for sub-links, secondary navigation links like "Learn" and "Order" (rgb 92, 94, 98)
+- **Silver Fog** (`#8E8E8E`): Placeholder text in input fields and disabled states (rgb 142, 142, 142)
+- **Cloud Gray** (`#EEEEEE`): Light borders and divider lines (rgb 238, 238, 238)
+- **Pale Silver** (`#D0D1D2`): Subtle UI borders and delineation (rgb 208, 209, 210)
+
+### Semantic & Accent
+- Tesla's marketing site avoids semantic color coding (no green/red/yellow status indicators). Error, success, and warning states follow standard browser defaults in form contexts
+- The blue CTA (`#3E6AE1`) serves as the sole interactive color signal
+
+### Gradient System
+- No gradients are used anywhere in the interface
+- Depth is achieved entirely through photography, whitespace, and the binary contrast between full-bleed imagery and clean white surfaces
+- The navigation achieves layering through opacity (frosted glass effect) rather than gradient or shadow
+
+## 3. Typography Rules
+
+### Font Family
+- **Display**: `Universal Sans Display`, -apple-system, Arial, sans-serif — used for hero titles and large model names. A geometric sans-serif with precisely engineered proportions, recently replacing Gotham to unify Tesla's digital ecosystem (website, mobile app, vehicle interface)
+- **Text/UI**: `Universal Sans Text`, -apple-system, Arial, sans-serif — used for navigation, body copy, buttons, and all UI text. Optimized for legibility at smaller sizes with slightly wider proportions than the Display variant
+- **No OpenType features** detected — typography is completely unembellished
+- **No italic variants** observed on the marketing site
+
+### Hierarchy
+
+| Role | Size | Weight | Line Height | Letter Spacing | Notes |
+|------|------|--------|-------------|----------------|-------|
+| Hero Title | 40px (2.50rem) | 500 | 48px (1.20) | normal | Universal Sans Display, white on dark hero imagery |
+| Product Name | 17px (1.06rem) | 500 | 20px (1.18) | normal | Universal Sans Text, model names in nav panel and cards |
+| Nav Item | 14px (0.88rem) | 500 | 16.8px (1.20) | normal | Universal Sans Text, primary navigation labels |
+| Body Text | 14px (0.88rem) | 400 | 20px (1.43) | normal | Universal Sans Text, paragraph and descriptive content |
+| Button Label | 14px (0.88rem) | 500 | 16.8px (1.20) | normal | Universal Sans Text, CTA button text |
+| Sub-link | 14px (0.88rem) | 400 | 20px (1.43) | normal | Tertiary links (Learn, Order, Experience) |
+| Promo Text | 22px (1.38rem) | 400 | 20px (0.91) | normal | White promotional text on hero ("0% APR Available") |
+| Category Label | 16px (est.) | 500 | — | normal | White text labels on category cards ("Sport Sedan") |
+
+### Principles
+- **"Normal" letter-spacing everywhere**: Unlike most modern tech brands that use negative tracking for headlines, Tesla uses default letter-spacing at every level. This reflects a philosophy that the typeface should speak for itself without manipulation
+- **Weight restraint**: Only two weights appear — 500 (medium) for headings/UI and 400 (regular) for body. No bold (700), no light (300). The system avoids typographic drama
+- **Unified font sizing**: Most UI text clusters at 14px with only hero titles (40px) and promo text (22px) breaking away. This extreme uniformity creates a sense of engineered consistency
+- **Display vs Text split**: The two-variant system (Display for hero, Text for UI) creates subtle optical correction without visible stylistic difference — they appear as the same typeface at different sizes
+- **No text transforms**: No uppercase text appears in the main navigation or CTAs — the lowercase approach reinforces Tesla's understated confidence
+
+## 4. Component Stylings
+
+### Buttons
+All buttons use barely-rounded rectangles (4px border-radius) — creating a sharp, technical aesthetic that mirrors the precision of the vehicles.
+
+**Primary CTA** — The main action button:
+- Default: bg `#3E6AE1` (Electric Blue), text `#FFFFFF`, fontSize 14px, fontWeight 500, padding 4px with inner content centering, borderRadius 4px, minHeight 40px, width 200px
+- Border: 3px solid transparent (reserves space for focus/active border animation)
+- Box Shadow: `rgba(0,0,0,0) 0px 0px 0px 2px inset` (invisible at rest, animates to visible on focus)
+- Transition: `border-color 0.33s, background-color 0.33s, color 0.33s, box-shadow 0.25s`
+- Hover: subtle darkening of blue background
+- Used for: "Order Now" calls to action
+
+**Secondary CTA** — The alternative action button:
+- Default: bg `#FFFFFF`, text `#393C41` (Graphite), same dimensions and border pattern as primary
+- Transition: identical timing to primary (0.33s)
+- Used for: "View Inventory" alongside primary CTA
+
+**Nav Button** — Top navigation items:
+- Default: bg transparent, text `#171A20` (Carbon Dark), fontSize 14px, fontWeight 500, borderRadius 4px, padding 4px 16px, minHeight 32px
+- Transition: `color 0.33s, background-color 0.33s`
+- Active/expanded: subtle background highlight
+- Used for: "Vehicles", "Energy", "Charging", "Discover", "Shop"
+
+**Text Link** — In-content actions:
+- Default: text `#5C5E62` (Pewter), fontSize 14px, fontWeight 400, no background, no border
+- Hover: underline decoration with box-shadow transition
+- Transition: `box-shadow 0.33s cubic-bezier(0.5, 0, 0, 0.75), color 0.33s`
+- Used for: "Learn", "Order", "Experience", "New", "Pre-Owned" links in dropdown panel
+
+### Cards & Containers
+
+**Vehicle Card** (Navigation panel):
+- Background: transparent (inherits panel white)
+- Border: none
+- Shadow: none
+- Content: vehicle image (transparent PNG) + model name centered below + two text links
+- Layout: 3-column grid within the dropdown panel
+- No hover animation on the card itself — interaction is via the text links beneath
+
+**Category Card** (Homepage lower section):
+- Background: full-bleed landscape photography
+- Border radius: approximately 12px (subtly rounded)
+- Overflow: hidden (clips image to rounded corners)
+- Text: white label in top-left corner ("Sport Sedan", "Midsize SUV")
+- Size: large format, approximately 2:1 aspect ratio
+- No shadow, no border, no overlay gradient — text relies on image darkness for contrast
+
+### Inputs & Forms
+- Background: transparent
+- Text color: `#171A20` (Carbon Dark)
+- Placeholder color: `#8E8E8E` (Silver Fog)
+- Border: minimal, inherits from browser defaults
+- Font: Universal Sans Text, 14px
+- The "Ask a Question" chatbot input bar sits at the viewport bottom with a clean white background and subtle border
+
+### Navigation
+- **Desktop**: Centered horizontal nav with TESLA wordmark (spaced uppercase letters) on the left, five category buttons center-aligned, and three icon buttons (help, globe/language, account) on the right
+- **Background**: White (transitions from transparent over dark hero to opaque white on scroll via class toggle `tds-site-header--white-background`)
+- **Dropdown panel**: Full-width white panel with 3-column vehicle grid + right sidebar text links, no shadow, no border — appears seamlessly below the nav
+- **Sticky behavior**: `sticky-without-slide` class — stays at top without slide-in animation
+- **Mobile**: Hamburger collapse pattern
+- **No visible separator** between nav and content — the nav blends with the hero
+
+### Image Treatment
+- **Hero**: Full-viewport (100vh) sections with cinematic photography — edge-to-edge, no padding, no margin
+- **Vehicle images**: Transparent PNG renders on white background in dropdown panel, studio-quality 3/4 angle shots
+- **Category cards**: Landscape photography with approximately 2:1 ratio, rounded corners (12px)
+- **Carousel**: Auto-advancing with dot indicators (3 dots) and left/right arrow navigation on edges
+- **Lazy loading**: Below-fold sections use lazy loading, rendering as blank white until scrolled into view
+
+### Persistent Chat Bar
+- Anchored to viewport bottom, visible across all sections
+- White background with subtle border
+- Contains: chat icon + "Ask a Question" label + placeholder text ("What's Dog Mode?") + send icon + "Schedule a Drive Today" secondary CTA
+- Schedule CTA has a teal/blue icon accent
+
+## 5. Layout Principles
+
+### Spacing System
+- **Base unit**: 8px
+- **Common values**: 8px (0.5rem), 16px (1rem), 21.44px (1.34rem)
+- **Button padding**: 4px (minimal outer) with content centering via flexbox, 4px 16px for nav items
+- **Section padding**: Full-viewport sections with content centered vertically
+- **Card gap**: approximately 16px between category cards
+
+### Grid & Container
+- **Max width**: approximately 1383px (full viewport width used for most content)
+- **Hero**: Full-bleed, edge-to-edge, 100vh sections
+- **Navigation panel**: 3-column grid for vehicle cards with right-aligned text sidebar (~70/30 split)
+- **Category cards**: 2-up horizontal layout (large left card + smaller right card)
+
+### Whitespace Philosophy
+Tesla uses whitespace as a luxury signal. The generous vertical spacing between sections (each section is a full viewport height) means you can only see one "message" at a time — one car, one model name, one CTA pair. This creates a gallery-like browsing experience where each scroll is a deliberate transition, not a continuous feed. White space is not empty — it's the frame that elevates each vehicle to the status of art piece.
+
+### Border Radius Scale
+| Value | Context |
+|-------|---------|
+| 0px | Most elements — sharp edges are the default |
+| 4px | Buttons (primary, secondary, nav items) — barely perceptible rounding |
+| ~12px | Category cards — noticeable but restrained rounding on larger surfaces |
+| 50% | Carousel dot indicators — perfect circles |
+
+## 6. Depth & Elevation
+
+| Level | Treatment | Use |
+|-------|-----------|-----|
+| Level 0 (Flat) | No shadow, no border | Default state for all elements — cards, panels, buttons at rest |
+| Level 1 (Frost) | `rgba(255,255,255,0.75)` backdrop | Navigation bar on scroll — frosted glass transparency |
+| Level 2 (Overlay) | `rgba(128,128,128,0.65)` | Modal overlays and region/cookie popups |
+| Level 3 (Subtle) | `rgba(0,0,0,0.05)` | Minimal shadow hints on rare hover states |
+
+### Shadow Philosophy
+Tesla's approach to elevation is essentially "none." The site avoids box-shadows entirely in its primary interface. Depth is communicated through three alternative strategies:
+1. **Z-index layering**: The sticky navigation sits above hero content through positioning, not shadow
+2. **Opacity-based transparency**: The frosted glass nav and overlay modals use background-color opacity rather than shadow to indicate layering
+3. **Photography-as-depth**: The full-bleed images create their own visual depth through perspective, lighting, and composition — making UI shadows redundant
+
+### Decorative Depth
+- No gradients, glows, or atmospheric effects on UI elements
+- The hero imagery itself provides all visual richness — sunset skies, reflected light on car surfaces, ground shadows from studio lighting
+- The carousel arrow buttons use a semi-transparent white background to float above the hero imagery without disrupting it
+
+## 7. Do's and Don'ts
+
+### Do
+- Let photography dominate every screen — the product IS the design
+- Use Electric Blue (`#3E6AE1`) exclusively for primary CTAs — never for decorative purposes
+- Maintain viewport-height sections for major content blocks — one message per screen
+- Keep typography at weight 400-500 only — no bold, no light, no extremes
+- Use 4px border-radius for all interactive elements — precision over playfulness
+- Trust whitespace as a luxury signal — never fill available space just because it's empty
+- Keep all transitions at 0.33s — consistency in motion is as important as consistency in color
+- Use transparent PNG vehicle imagery on white backgrounds for product showcases
+- Center CTAs horizontally below model names — the vertical rhythm is model → subtitle → buttons
+- Maintain the Display/Text font split — Display for hero-scale text only, Text for everything else
+
+### Don't
+- Add shadows to any element — elevation through shadow contradicts the flat, gallery aesthetic
+- Use more than one chromatic color besides the blue CTA — the palette is intentionally monochrome-plus-one
+- Apply gradients, patterns, or decorative backgrounds to surfaces — white and photography are the only backgrounds
+- Use text larger than 40px on the web — the typography is deliberately restrained even at hero scale
+- Add borders to cards or containers — separation is achieved through spacing, not lines
+- Use uppercase text transforms — Tesla's confidence is expressed through lowercase calm
+- Introduce rounded-pill buttons or large border-radii — the 4px radius is deliberate and precise
+- Override the Universal Sans family with other typefaces — cross-platform consistency is a core brand value
+- Add hover animations with scale/translate transforms — Tesla's interactions are color-only (background and border transitions)
+- Clutter the viewport with multiple CTAs — every screen should have at most two action buttons
+
+## 8. Responsive Behavior
+
+### Breakpoints
+| Name | Width | Key Changes |
+|------|-------|-------------|
+| Mobile | <768px | Single-column layout, hamburger nav replaces horizontal labels, hero text scales to ~28px, CTA buttons stack vertically, category cards become full-width |
+| Tablet | 768-1024px | 2-column nav panel, hero maintains full-viewport height, CTAs remain side-by-side, reduced horizontal padding |
+| Desktop | 1024-1440px | Full horizontal nav, 3-column vehicle grid in dropdown, hero at 40px, side-by-side CTAs at 200px/160px width |
+| Large Desktop | >1440px | Content remains centered, hero photography scales to fill wider viewports, max-width container for nav panel content |
+
+### Touch Targets
+- Primary CTA buttons: 200px × 40px minimum (well above 44×44px WCAG requirement)
+- Nav buttons: minimum 32px height with 4px 16px padding — adequate touch targets
+- Carousel arrows: ~44px square white semi-transparent buttons at viewport edges
+- Text links ("Learn", "Order"): 14px text with adequate line-height spacing for touch
+
+### Collapsing Strategy
+- **Navigation**: Horizontal category buttons (Vehicles, Energy, Charging, Discover, Shop) collapse to a hamburger/drawer menu on mobile
+- **Hero CTA pair**: Side-by-side buttons on desktop stack vertically on mobile
+- **Category cards**: 2-up horizontal layout collapses to single-column full-width on mobile
+- **Vehicle grid**: 3-column grid in desktop nav panel becomes 2-column on tablet, single-column on mobile
+- **Spacing**: Section vertical padding remains generous (viewport-height sections) but horizontal padding reduces
+
+### Image Behavior
+- Hero images are fully responsive and fill the entire viewport at every breakpoint
+- Vehicle carousel images use `object-fit: cover` to maintain cinematic composition across widths
+- Transparent PNG vehicle images in the nav panel scale proportionally within their grid cells
+- Category card images maintain their landscape ratio and clip via `overflow: hidden` with border-radius
+
+## 9. Agent Prompt Guide
+
+### Quick Color Reference
+- Primary CTA: "Electric Blue (#3E6AE1)"
+- Background: "Pure White (#FFFFFF)"
+- Heading text: "Carbon Dark (#171A20)"
+- Body text: "Graphite (#393C41)"
+- Tertiary text: "Pewter (#5C5E62)"
+- Placeholder: "Silver Fog (#8E8E8E)"
+- Alternate surface: "Light Ash (#F4F4F4)"
+- Dark surface: "Carbon Dark (#171A20)"
+
+### Example Component Prompts
+- "Create a hero section with a full-viewport background image, centered 'Model Y' title in Universal Sans Display at 40px weight 500 in white, a subtitle line below, and two buttons side by side: a primary Electric Blue (#3E6AE1) 'Order Now' button and a secondary white 'View Inventory' button, both with 4px border-radius and 40px height"
+- "Design a navigation bar with a spaced-letter wordmark on the left, five text buttons (14px, weight 500, Carbon Dark #171A20) centered, and three icon buttons on the right, all on a white background with no shadow or border"
+- "Build a vehicle card grid with 3 columns, each card showing a transparent-background car image above a model name (17px, weight 500, Carbon Dark) and two text links (14px, weight 400, Pewter #5C5E62) labeled 'Learn' and 'Order', on a pure white surface with no borders or shadows"
+- "Create a category card with full-bleed landscape photography, 12px border-radius, overflow hidden, and a white text label ('Sport Sedan') positioned in the top-left corner with no overlay gradient"
+- "Design a persistent bottom bar with a chat input ('Ask a Question' placeholder), a send icon, and a secondary CTA ('Schedule a Drive Today') with a teal icon, anchored to the viewport bottom on a white background"
+
+### Iteration Guide
+When refining existing screens generated with this design system:
+1. Focus on ONE component at a time — Tesla's system is so minimal that each element must be pixel-perfect
+2. Reference specific color names and hex codes from this document — there are only 6-7 colors in the entire system
+3. Use natural language descriptions, not CSS values — "barely rounded corners" not "border-radius: 4px"
+4. Describe the desired "feel" alongside specific measurements — "gallery-like silence between sections" communicates the whitespace philosophy better than "margin-bottom: 100vh"
+5. Always verify that photography is doing the emotional heavy-lifting — if the UI itself feels "designed," it's too much

package/resources/local/awesome-design-md/design-md/tesla/README.md

@@ -0,0 +1,5 @@
+# Tesla Inspired Design System
+
+Design system details have been moved to: https://getdesign.md/tesla/design-md
+
+You can also view previews, dark mode examples, and download options on getdesign.md.