winter-super-cli 2026.5.15

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

@@ -0,0 +1,262 @@
+# Design System Inspired by Sentry
+
+## 1. Visual Theme & Atmosphere
+
+Sentry's website is a dark-mode-first developer tool interface that speaks the language of code editors and terminal windows. The entire aesthetic is rooted in deep purple-black backgrounds (`#1f1633`, `#150f23`) that evoke the late-night debugging sessions Sentry was built for. Against this inky canvas, a carefully curated set of purples, pinks, and a distinctive lime-green accent (`#c2ef4e`) create a visual system that feels simultaneously technical and vibrant.
+
+The typography pairing is deliberate: "Dammit Sans" appears at hero scale (88px, weight 700) as a display font with personality and attitude that matches Sentry's irreverent brand voice ("Code breaks. Fix it faster."), while Rubik serves as the workhorse UI font across all functional text — headings, body, buttons, captions, and navigation. Monaco provides the monospace layer for code snippets and technical content, completing the developer-tool trinity.
+
+What makes Sentry distinctive is its embrace of the "dark IDE" aesthetic without feeling cold or sterile. Warm purple tones replace the typical cool grays of developer tools, and bold illustrative elements (3D characters, colorful product screenshots) punctuate the dark canvas. The button system uses a signature muted purple (`#79628c`) with inset shadows that creates a tactile, almost physical quality — buttons feel like they could be pressed into the surface.
+
+**Key Characteristics:**
+- Dark purple-black backgrounds (`#1f1633`, `#150f23`) — never pure black
+- Warm purple accent spectrum: from deep (`#362d59`) through mid (`#79628c`, `#6a5fc1`) to vibrant (`#422082`)
+- Lime-green accent (`#c2ef4e`) for high-visibility CTAs and highlights
+- Pink/coral accents (`#ffb287`, `#fa7faa`) for focus states and secondary highlights
+- "Dammit Sans" display font for brand personality at hero scale
+- Rubik as primary UI font with uppercase letter-spaced labels
+- Monaco monospace for code elements
+- Inset shadows on buttons creating tactile depth
+- Frosted glass effects with `blur(18px) saturate(180%)`
+
+## 2. Color Palette & Roles
+
+### Primary Brand
+- **Deep Purple** (`#1f1633`): Primary background, the defining color of the brand
+- **Darker Purple** (`#150f23`): Deeper sections, footer, secondary backgrounds
+- **Border Purple** (`#362d59`): Borders, dividers, subtle structural lines
+
+### Accent Colors
+- **Sentry Purple** (`#6a5fc1`): Primary interactive color — links, hover states, focus rings
+- **Muted Purple** (`#79628c`): Button backgrounds, secondary interactive elements
+- **Deep Violet** (`#422082`): Select dropdowns, active states, high-emphasis surfaces
+- **Lime Green** (`#c2ef4e`): High-visibility accent, special links, badge highlights
+- **Coral** (`#ffb287`): Focus state backgrounds, warm accent
+- **Pink** (`#fa7faa`): Focus outlines, decorative accents
+
+### Text Colors
+- **Pure White** (`#ffffff`): Primary text on dark backgrounds
+- **Light Gray** (`#e5e7eb`): Secondary text, muted content
+- **Code Yellow** (`#dcdcaa`): Syntax highlighting, code tokens
+
+### Surface & Overlay
+- **Glass White** (`rgba(255, 255, 255, 0.18)`): Frosted glass button backgrounds
+- **Glass Dark** (`rgba(54, 22, 107, 0.14)`): Hover overlay on glass elements
+- **Input White** (`#ffffff`): Form input backgrounds (light context)
+- **Input Border** (`#cfcfdb`): Form field borders
+
+### Shadows
+- **Ambient Glow** (`rgba(22, 15, 36, 0.9) 0px 4px 4px 9px`): Deep purple ambient shadow
+- **Button Hover** (`rgba(0, 0, 0, 0.18) 0px 0.5rem 1.5rem`): Elevated hover state
+- **Card Shadow** (`rgba(0, 0, 0, 0.1) 0px 10px 15px -3px`): Standard card elevation
+- **Inset Button** (`rgba(0, 0, 0, 0.1) 0px 1px 3px 0px inset`): Tactile pressed effect
+
+## 3. Typography Rules
+
+### Font Families
+- **Display**: `Dammit Sans` — brand personality font for hero headings
+- **Primary UI**: `Rubik`, with fallbacks: `-apple-system, system-ui, Segoe UI, Helvetica, Arial`
+- **Monospace**: `Monaco`, with fallbacks: `Menlo, Ubuntu Mono`
+
+### Hierarchy
+
+| Role | Font | Size | Weight | Line Height | Letter Spacing | Notes |
+|------|------|------|--------|-------------|----------------|-------|
+| Display Hero | Dammit Sans | 88px (5.50rem) | 700 | 1.20 (tight) | normal | Maximum impact, brand voice |
+| Display Secondary | Dammit Sans | 60px (3.75rem) | 500 | 1.10 (tight) | normal | Secondary hero text |
+| Section Heading | Rubik | 30px (1.88rem) | 400 | 1.20 (tight) | normal | Major section titles |
+| Sub-heading | Rubik | 27px (1.69rem) | 500 | 1.25 (tight) | normal | Feature section headers |
+| Card Title | Rubik | 24px (1.50rem) | 500 | 1.25 (tight) | normal | Card and block headings |
+| Feature Title | Rubik | 20px (1.25rem) | 600 | 1.25 (tight) | normal | Emphasized feature names |
+| Body | Rubik | 16px (1.00rem) | 400 | 1.50 | normal | Standard body text |
+| Body Emphasis | Rubik | 16px (1.00rem) | 500–600 | 1.50 | normal | Bold body, nav items |
+| Nav Label | Rubik | 15px (0.94rem) | 500 | 1.40 | normal | Navigation links |
+| Uppercase Label | Rubik | 15px (0.94rem) | 500 | 1.25 (tight) | normal | `text-transform: uppercase` |
+| Button Text | Rubik | 14px (0.88rem) | 500–700 | 1.14–1.29 (tight) | 0.2px | `text-transform: uppercase` |
+| Caption | Rubik | 14px (0.88rem) | 500–700 | 1.00–1.43 | 0.2px | Often uppercase |
+| Small Caption | Rubik | 12px (0.75rem) | 600 | 2.00 (relaxed) | normal | Subtle annotations |
+| Micro Label | Rubik | 10px (0.63rem) | 600 | 1.80 (relaxed) | 0.25px | `text-transform: uppercase` |
+| Code | Monaco | 16px (1.00rem) | 400–700 | 1.50 | normal | Code blocks, technical text |
+
+### Principles
+- **Dual personality**: Dammit Sans brings irreverent brand character at display scale; Rubik provides clean professionalism for everything functional.
+- **Uppercase as system**: Buttons, captions, labels, and micro-text all use `text-transform: uppercase` with subtle letter-spacing (0.2px–0.25px), creating a systematic "technical label" pattern throughout.
+- **Weight stratification**: Rubik uses 400 (body), 500 (emphasis/nav), 600 (titles/strong), 700 (buttons/CTAs) — a clean four-tier weight system.
+- **Tight headings, relaxed body**: All headings use 1.10–1.25 line-height; body uses 1.50; small captions expand to 2.00 for readability at tiny sizes.
+
+## 4. Component Stylings
+
+### Buttons
+
+**Primary Muted Purple**
+- Background: `#79628c` (rgb(121, 98, 140))
+- Text: `#ffffff`, uppercase, 14px, weight 500–700, letter-spacing 0.2px
+- Border: `1px solid #584674`
+- Radius: 13px
+- Shadow: `rgba(0, 0, 0, 0.1) 0px 1px 3px 0px inset` (tactile inset)
+- Hover: elevated shadow `rgba(0, 0, 0, 0.18) 0px 0.5rem 1.5rem`
+
+**Glass White**
+- Background: `rgba(255, 255, 255, 0.18)` (frosted glass)
+- Text: `#ffffff`
+- Padding: 8px
+- Radius: 12px (left-aligned variant: `12px 0px 0px 12px`)
+- Shadow: `rgba(0, 0, 0, 0.08) 0px 2px 8px`
+- Hover background: `rgba(54, 22, 107, 0.14)`
+- Use: Secondary actions on dark surfaces
+
+**White Solid**
+- Background: `#ffffff`
+- Text: `#1f1633`
+- Padding: 12px 16px
+- Radius: 8px
+- Hover: background transitions to `#6a5fc1`, text to white
+- Focus: background `#ffb287` (coral), outline `rgb(106, 95, 193) solid 0.125rem`
+- Use: High-visibility CTA on dark backgrounds
+
+**Deep Violet (Select/Dropdown)**
+- Background: `#422082`
+- Text: `#ffffff`
+- Padding: 8px 16px
+- Radius: 8px
+
+### Inputs
+
+**Text Input**
+- Background: `#ffffff`
+- Text: `#1f1633`
+- Border: `1px solid #cfcfdb`
+- Padding: 8px 12px
+- Radius: 6px
+- Focus: border-color stays `#cfcfdb`, shadow `rgba(0, 0, 0, 0.15) 0px 2px 10px inset`
+
+### Links
+- **Default on dark**: `#ffffff`, underline decoration
+- **Hover**: color transitions to `#6a5fc1` (Sentry Purple)
+- **Purple links**: `#6a5fc1` default, hover underline
+- **Lime accent links**: `#c2ef4e` default, hover to `#6a5fc1`
+- **Dark context links**: `#362d59`, hover to `#ffffff`
+
+### Cards & Containers
+- Background: semi-transparent or dark purple surfaces
+- Radius: 8px–12px
+- Shadow: `rgba(0, 0, 0, 0.1) 0px 10px 15px -3px`
+- Backdrop filter: `blur(18px) saturate(180%)` for glass effects
+
+### Navigation
+- Dark transparent header over hero content
+- Rubik 15px weight 500 for nav links
+- White text, hover to Sentry Purple (`#6a5fc1`)
+- Uppercase labels with 0.2px letter-spacing for categories
+- Mobile: hamburger menu, full-width expanded
+
+## 5. Layout Principles
+
+### Spacing System
+- Base unit: 8px
+- Scale: 1px, 2px, 4px, 5px, 6px, 8px, 12px, 16px, 24px, 32px, 40px, 44px, 45px, 47px
+
+### Grid & Container
+- Max content width: 1152px (XL breakpoint)
+- Responsive padding: 2rem (mobile) → 4rem (tablet+)
+- Content centered within container
+- Full-width dark sections with contained inner content
+
+### Breakpoints
+| Name | Width | Key Changes |
+|------|-------|-------------|
+| Mobile | < 576px | Single column, stacked layout |
+| Small Tablet | 576–640px | Minor width adjustments |
+| Tablet | 640–768px | 2-column begins |
+| Small Desktop | 768–992px | Full nav visible |
+| Desktop | 992–1152px | Standard layout |
+| Large Desktop | 1152–1440px | Max-width content |
+
+### Whitespace Philosophy
+- **Dark breathing room**: Generous vertical spacing between sections (64px–80px+) lets the dark background serve as a visual rest.
+- **Content islands**: Feature sections are self-contained blocks floating in the dark purple sea, each with its own internal spacing rhythm.
+- **Asymmetric padding**: Buttons use asymmetric padding patterns (12px 16px, 8px 12px) that feel organic rather than rigid.
+
+### Border Radius Scale
+- Minimal (6px): Form inputs, small interactive elements
+- Standard (8px): Buttons, cards, containers
+- Comfortable (10px–12px): Larger containers, glass panels
+- Rounded (13px): Primary muted buttons
+- Pill (18px): Image containers, badges
+
+## 6. Depth & Elevation
+
+| Level | Treatment | Use |
+|-------|-----------|-----|
+| Sunken (Level -1) | Inset shadow `rgba(0, 0, 0, 0.1) 0px 1px 3px inset` | Primary buttons (tactile pressed feel) |
+| Flat (Level 0) | No shadow | Default surfaces, dark backgrounds |
+| Surface (Level 1) | `rgba(0, 0, 0, 0.08) 0px 2px 8px` | Glass buttons, subtle cards |
+| Elevated (Level 2) | `rgba(0, 0, 0, 0.1) 0px 10px 15px -3px` | Cards, floating panels |
+| Prominent (Level 3) | `rgba(0, 0, 0, 0.18) 0px 0.5rem 1.5rem` | Hover states, modals |
+| Ambient (Level 4) | `rgba(22, 15, 36, 0.9) 0px 4px 4px 9px` | Deep purple ambient glow around hero |
+
+**Shadow Philosophy**: Sentry uses a unique combination of inset shadows (buttons feel pressed INTO the surface) and ambient glows (content radiates from the dark background). The deep purple ambient shadow (`rgba(22, 15, 36, 0.9)`) is the signature — it creates a bioluminescent quality where content seems to emit its own purple-tinted light.
+
+## 7. Do's and Don'ts
+
+### Do
+- Use deep purple backgrounds (`#1f1633`, `#150f23`) — never pure black (`#000000`)
+- Apply inset shadows on primary buttons for the tactile pressed effect
+- Use Dammit Sans ONLY for hero/display headings — Rubik for everything else
+- Apply `text-transform: uppercase` with `letter-spacing: 0.2px` on buttons and labels
+- Use the lime-green accent (`#c2ef4e`) sparingly for maximum impact
+- Employ frosted glass effects (`blur(18px) saturate(180%)`) for layered surfaces
+- Maintain the warm purple shadow tones — shadows should feel purple-tinted, not neutral gray
+- Use Rubik's 4-tier weight system: 400 (body), 500 (nav/emphasis), 600 (titles), 700 (CTAs)
+
+### Don't
+- Don't use pure black (`#000000`) for backgrounds — always use the warm purple-blacks
+- Don't apply Dammit Sans to body text or UI elements — it's display-only
+- Don't use standard gray (`#666`, `#999`) for borders — use purple-tinted grays (`#362d59`, `#584674`)
+- Don't drop the uppercase treatment on buttons — it's a system-wide pattern
+- Don't use sharp corners (0px radius) — minimum 6px for all interactive elements
+- Don't mix the lime-green accent with the coral/pink accents in the same component
+- Don't use flat (non-inset) shadows on primary buttons — the tactile quality is signature
+- Don't forget letter-spacing on uppercase text — 0.2px minimum
+
+## 8. Responsive Behavior
+
+### Breakpoints
+| Name | Width | Key Changes |
+|------|-------|-------------|
+| Mobile | <576px | Single column, hamburger nav, stacked CTAs |
+| Tablet | 576–768px | 2-column feature grids begin |
+| Small Desktop | 768–992px | Full navigation, side-by-side layouts |
+| Desktop | 992–1152px | Max-width container, full layout |
+| Large | >1152px | Content max-width maintained, generous margins |
+
+### Collapsing Strategy
+- Hero text: 88px Dammit Sans → 60px → mobile scales
+- Navigation: horizontal → hamburger with slide-out
+- Feature sections: side-by-side → stacked cards
+- Buttons: inline → full-width stacked on mobile
+- Container padding: 4rem → 2rem
+
+## 9. Agent Prompt Guide
+
+### Quick Color Reference
+- Background: `#1f1633` (primary), `#150f23` (deeper)
+- Text: `#ffffff` (primary), `#e5e7eb` (secondary)
+- Interactive: `#6a5fc1` (links/hover), `#79628c` (buttons)
+- Accent: `#c2ef4e` (lime highlight), `#ffb287` (coral focus)
+- Border: `#362d59` (dark), `#cfcfdb` (light context)
+
+### Example Component Prompts
+- "Create a hero section on deep purple background (#1f1633). Headline at 88px Dammit Sans weight 700, line-height 1.20, white text. Sub-text at 16px Rubik weight 400, line-height 1.50. White solid CTA button (8px radius, 12px 16px padding), hover transitions to #6a5fc1."
+- "Design a navigation bar: transparent over dark background. Rubik 15px weight 500, white text. Uppercase category labels with 0.2px letter-spacing. Hover color #6a5fc1."
+- "Build a primary button: background #79628c, border 1px solid #584674, inset shadow rgba(0,0,0,0.1) 0px 1px 3px, white uppercase text at 14px Rubik weight 700, letter-spacing 0.2px, radius 13px. Hover: shadow rgba(0,0,0,0.18) 0px 0.5rem 1.5rem."
+- "Create a glass card panel: background rgba(255,255,255,0.18), backdrop-filter blur(18px) saturate(180%), radius 12px. White text content inside."
+- "Design a feature section: #150f23 background, 24px Rubik weight 500 heading, 16px Rubik weight 400 body text. 14px uppercase lime-green (#c2ef4e) label above heading."
+
+### Iteration Guide
+1. Always start with the dark purple background — the color palette is built FOR dark mode
+2. Use inset shadows on buttons, ambient purple glows on hero sections
+3. Uppercase + letter-spacing is the systematic pattern for labels, buttons, and captions
+4. Lime green (#c2ef4e) is the "pop" color — use once per section maximum
+5. Frosted glass for overlaid panels, solid purple for primary surfaces
+6. Rubik handles 90% of typography — Dammit Sans is hero-only

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

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

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

@@ -0,0 +1,350 @@
+# Design System Inspired by Shopify
+
+## 1. Visual Theme & Atmosphere
+
+Shopify.com is a dark-first digital theatre — a website that stages its commerce platform like a cinematic premiere. The entire experience unfolds against an abyss of near-black surfaces that carry the faintest whisper of deep forest green (`#02090A`, `#061A1C`, `#102620`), creating a nocturnal atmosphere that feels less like a SaaS marketing page and more like an exclusive product reveal at a tech keynote. This darkness isn't cold or corporate — it's the warm, enveloping dark of a luxury experience, like sitting in the front row of a darkened auditorium.
+
+The typography is the undeniable star. NeueHaasGrotesk — a refined Helvetica descendant — appears at monumental scale (96px) with impossibly light weight (330-400), creating headlines that feel etched in light rather than printed in ink. The `ss03` OpenType feature gives letterforms a distinctive character that separates Shopify's type from generic Helvetica usage. Below the display layer, Inter Variable handles body text with surgical precision, using equally unusual variable weights (420, 450, 550) that live in the spaces between traditional weight stops. This precision signals a company that sweats every detail.
+
+Color is used with extreme restraint. The primary accent is Shopify Neon Green (`#36F4A4`) — an electric mint that appears exclusively on focus rings and accent highlights, pulsing like a bioluminescent signal against the dark canvas. Softer green tints (Aloe `#C1FBD4`, Pistachio `#D4F9E0`) provide atmospheric washes. White is the only text color that matters on dark surfaces, while a zinc-based neutral scale (`#A1A1AA` through `#3F3F46`) handles the hierarchy of quiet information. The result is a design that makes commerce technology feel like it belongs in a science-fiction future.
+
+**Key Characteristics:**
+- Dark-first design with deep forest-teal undertones (not pure black)
+- Ultra-light display typography (weight 330) at monumental scale (96px) creating an ethereal presence
+- Neon Green (`#36F4A4`) as the singular high-energy accent against darkness
+- Full-pill buttons (9999px radius) as the primary interactive shape
+- Layered, multi-stage box shadows creating photographic depth
+- Product screenshots embedded in dark UI contexts, matching the surrounding darkness
+- Zinc-based neutral scale for text hierarchy — balanced between warm and cool
+
+## 2. Color Palette & Roles
+
+### Primary
+
+- **Shopify White** (`#FFFFFF`): Primary text on dark surfaces, button fills, high-contrast elements
+- **Shopify Black** (`#000000`): Body background, button text on white, maximum contrast base (--color-shade-100)
+
+### Secondary & Accent
+
+- **Neon Green** (`#36F4A4`): The signature accent — focus rings, interactive highlights, active state indicators. Electric and bioluminescent
+- **Aloe** (`#C1FBD4`): Soft green wash for decorative backgrounds, atmospheric cards (--color-aloe-10)
+- **Pistachio** (`#D4F9E0`): Lightest green tint for subtle surface differentiation (--color-pistachio-10)
+
+### Surface & Background
+
+- **Void** (`#000000`): Root page background — true black for maximum depth
+- **Deep Teal** (`#02090A`): Card surfaces, content containers — near-black with green undertone
+- **Dark Forest** (`#061A1C`): Section backgrounds with visible green character
+- **Forest** (`#102620`): Elevated dark surfaces, header backgrounds — the warmest dark shade
+- **Dark Card Border** (`#1E2C31`): Card borders on dark surfaces, subtle boundary definition
+
+### Neutrals & Text (Zinc Scale)
+
+- **Shade-30** (`#D4D4D8`): Lightest neutral, barely-there borders on dark (--color-shade-30)
+- **Muted Text** (`#A1A1AA`): Secondary text, metadata, descriptions — the quiet voice
+- **Shade-50** (`#71717A`): Tertiary text, timestamps, least important info (--color-shade-50)
+- **Shade-60** (`#52525B`): Disabled text, decorative neutrals (--color-shade-60)
+- **Shade-70** (`#3F3F46`): Subtle dividers, barely-visible UI boundaries (--color-shade-70)
+- **Light Border** (`#E4E4E7`): Borders on light surfaces (rare — only in light-mode modals)
+
+### Semantic & Accent
+
+- **Link Muted** (`#9797A2`): Muted link text with underline decoration
+- **Link Sage** (`#9DABAD`): Teal-tinted muted links
+- **Link Lavender** (`#BDBDCA`): Lighter link variant
+- **Link Mint** (`#99B3AD`): Green-tinted link variant for themed sections
+
+### Gradient System
+
+- **Dark Teal Wash**: Radial gradient from `#102620` center to `#02090A` edge — used behind product showcases
+- **Green Atmospheric**: Subtle green-tinted ambient gradients behind hero sections, creating depth without solid colors
+- **Spotlight**: Focused bright area fading to black — creates keynote-style presentation lighting
+
+## 3. Typography Rules
+
+### Font Family
+
+**Display:** NeueHaasGrotesk (refined Helvetica descendant, variable font)
+- Fallbacks: Helvetica, Arial, sans-serif
+- OpenType features: `ss03` (stylistic set 3 — distinctive letterform alternates)
+- Available weights: 330, 360, 400, 500, 750 (variable)
+- Used for all headings, hero text, and large display elements
+
+**Body:** Inter-Variable
+- Fallbacks: Helvetica, Arial, sans-serif
+- OpenType features: `ss03`
+- Available weights: 400, 420, 450, 500, 550 (variable)
+- Used for body text, links, buttons, UI elements
+
+**Mono:** ui-monospace
+- Fallbacks: SFMono-Regular, Menlo, Monaco, Consolas, Liberation Mono, Courier New
+- Used for code snippets, data labels, technical content
+
+### Hierarchy
+
+| Role | Size | Weight | Line Height | Letter Spacing | Notes |
+|------|------|--------|-------------|----------------|-------|
+| Display XL | 96px | 400 | 1.00 | — | NeueHaasGrotesk, hero headlines, "ss03" |
+| Display XL Bold | 90.74px | 750 | 1.00 | 4.54px | NeueHaasGrotesk, emphasis display |
+| Display XL Tracked | 96px | 400 | 1.00 | 2.4px | NeueHaasGrotesk, spaced display |
+| Display Light | 96px | 330 | 0.96 | — | NeueHaasGrotesk, ethereal display |
+| Heading 1 | 70px | 330 | 1.00 | — | NeueHaasGrotesk, section titles |
+| Heading 2 | 55px | 330 | 1.16 | — | NeueHaasGrotesk, subsections |
+| Heading 3 | 48px | 330 | 1.14 | — | NeueHaasGrotesk, feature titles |
+| Heading 4 | 32px | 360 | 1.14 | 0.32px | NeueHaasGrotesk, card headings |
+| Heading 5 | 28px | 500 | 1.28 | 0.42px | NeueHaasGrotesk, small headings |
+| Heading 6 | 24px | 400 | 1.14 | 0.36px | NeueHaasGrotesk, minor headings |
+| Body Large | 20px | 500 | 1.40 | 0.3px | NeueHaasGrotesk / Inter, lead paragraphs |
+| Body | 18px | 400 | 1.56 | — | Inter-Variable, standard body |
+| Body Medium | 18px | 550 | 1.56 | — | Inter-Variable, emphasized body |
+| Body Small | 16px | 400 | 1.50 | — | Inter / NeueHaasGrotesk, compact body |
+| Body Small Medium | 16px | 420 | 1.50 | — | Inter-Variable, slightly emphasized |
+| Button | 16px | 400 | 1.50 | — | NeueHaasGrotesk, CTA text |
+| Nav Link | 18px | 500 | 1.25 | 0.72px | NeueHaasGrotesk, navigation items |
+| Caption | 14px | 500 | 1.49 | 0.28px | NeueHaasGrotesk / Inter, metadata |
+| Caption Medium | 14px | 550 | 1.49 | 0.28px | Inter-Variable, emphasized caption |
+| Overline | 15.36px | 400 | 1.50 | 1.54px | NeueHaasGrotesk, wide-tracked labels |
+| Micro | 13px | 500 | 1.50 | -0.13px | Inter, tight-tracked small text |
+| Label | 12px | 400 | 1.20 | 0.72px | Inter, uppercase labels |
+| Code | 16px | 400 | 1.50 | — | ui-monospace, uppercase, code blocks |
+| Code Small | 12px | 400 | 1.33 | — | ui-monospace, uppercase, inline code |
+
+### Principles
+
+Shopify's typography is a masterclass in variable font precision. The display layer lives almost exclusively at weights 330-400 — featherweight text that appears to hover above the dark background like projected light. This is the opposite of the bold, heavy approach most SaaS sites take: where others shout, Shopify whispers at scale. The 96px headlines at weight 330 create a paradox of enormous size and delicate stroke that feels both monumental and fragile. The `ss03` OpenType feature activates a stylistic set that gives specific characters (likely 'a', 'g', and certain numerals) a more refined appearance, distinguishing Shopify's typography from standard Helvetica Neue usage. Inter Variable handles the body layer with surgical precision, using weights like 420 and 550 that exist between the traditional stops — every piece of text has exactly the visual weight it needs.
+
+## 4. Component Stylings
+
+### Buttons
+
+**Primary (White Fill)**
+- Background: White (`#FFFFFF`)
+- Text: Black (`#000000`)
+- Border: 2px solid transparent
+- Border radius: full pill (9999px)
+- Padding: 12px 26px 12px 16px (asymmetric — more right padding for visual balance)
+- Hover: slight opacity reduction or background shift
+- Focus: 2px `#36F4A4` (Neon Green) outline ring
+- Transition: all 200ms ease
+
+**Secondary (Ghost/Outlined)**
+- Background: transparent
+- Text: White (`#FFFFFF`)
+- Border: 2px solid White (`#FFFFFF`)
+- Border radius: full pill (9999px)
+- Padding: 12px 26px 12px 16px
+- Hover: fills to white bg with black text
+- Focus: 2px `#36F4A4` outline
+
+**Badge/Tag (Neutral Filled)**
+- Background: `rgba(255, 255, 255, 0.2)` (frosted glass)
+- Text: White (`#FFFFFF`)
+- Border: none
+- Border radius: subtly rounded (4px)
+- Padding: 12px 16px
+- Font: 16px regular
+
+### Cards & Containers
+
+- Background: Deep Teal (`#02090A`) on dark pages
+- Border: 1px solid `#1E2C31` (Dark Card Border) — barely visible boundary
+- Border radius: 8px for standard cards, 12px for featured cards, 20px 20px 0 0 for top-rounded cards
+- Shadow: Multi-layered system:
+  - Resting: `rgba(0,0,0,0.1) 0px 0px 0px 1px, rgba(0,0,0,0.1) 0px 2px 2px, rgba(0,0,0,0.1) 0px 4px 4px, rgba(0,0,0,0.1) 0px 8px 8px` + `rgba(255,255,255,0.03) 0px 1px 0px inset`
+  - The inset white highlight creates a subtle top-edge glow
+- Hover: shadow expands, card may slightly brighten
+- Transition: box-shadow 300ms ease, transform 200ms ease
+
+### Inputs & Forms
+
+- Background: transparent or Dark Forest (`#061A1C`)
+- Text: White (`#FFFFFF`)
+- Border: 1px solid `#3F3F46` (Shade-70)
+- Border radius: 8px
+- Padding: 12px 16px
+- Focus: 2px solid `#36F4A4` (Neon Green focus ring)
+- Placeholder: Shade-50 (`#71717A`)
+- Transition: border-color 200ms ease
+
+### Navigation
+
+- Background: transparent (overlaid on dark hero), becomes Forest (`#102620`) on scroll
+- Height: ~64px
+- Left: Shopify wordmark logo (SVG, white on dark)
+- Center/Right: nav links in 18px/500 NeueHaasGrotesk, white, letter-spacing 0.72px
+- CTA: White pill button "Start for free" (right)
+- Secondary CTA: Ghost button with white border
+- Hover: links shift to Muted Text (`#A1A1AA`) or gain underline
+- Mobile: hamburger menu, full-screen dark overlay
+- Transition: background 300ms ease on scroll
+
+### Image Treatment
+
+- Product screenshots: embedded in dark UI contexts, matching the surrounding darkness
+- Admin interface previews: shown on dark backgrounds with subtle card borders
+- Aspect ratios: varied — hero images are wide (16:9-ish), feature shots are flexible
+- All images sit flush within dark containers — no bright borders or frames
+- Lazy loading with dark placeholder surfaces
+
+### Trust Indicators
+
+- Statistics displayed prominently: "15+" (years), "150M+" (buyers)
+- Numbers at display scale in NeueHaasGrotesk
+- Partner/developer ecosystem callout sections
+- Dark-themed testimonials integrated into the page flow
+
+## 5. Layout Principles
+
+### Spacing System
+
+Base unit: 8px
+
+| Token | Value | Use |
+|-------|-------|-----|
+| space-1 | 4px | Tight inline gaps |
+| space-2 | 8px | Base unit, icon gaps |
+| space-3 | 12px | Card padding, tight margins |
+| space-4 | 16px | Standard element padding |
+| space-5 | 24px | Card gaps, section padding |
+| space-6 | 28px | Medium section spacing |
+| space-7 | 32px | Section breaks |
+| space-8 | 36px | Large padding |
+| space-9 | 40px | Major section padding |
+| space-10 | 64px | Hero section padding, large gaps |
+
+### Grid & Container
+
+- Max container width: ~1280px (centered)
+- Hero: full-width, edge-to-edge dark background with centered text
+- Feature sections: 2-column layouts with text and product screenshots
+- Stats sections: horizontal layout with large numbers
+- Horizontal padding: 64px desktop, 32px tablet, 16px mobile
+- Grid gap: 24-32px between major content blocks
+
+### Whitespace Philosophy
+
+Shopify's whitespace strategy is theatrical. Sections are separated by vast expanses of dark space — 80px to 120px of pure black breathing room — that create the pacing of a presentation, not a webpage. Each content block is its own "slide" in a keynote-style scroll. Within sections, spacing is tighter and more deliberate, creating focal density against the expansive void. The contrast between macro-level emptiness and micro-level precision is what gives the site its cinematic cadence.
+
+### Border Radius Scale
+
+| Value | Context |
+|-------|---------|
+| 4px | Tags, badges, micro-elements |
+| 8px | Standard cards, inputs, video containers |
+| 12px | Featured cards, image containers, buttons (non-pill) |
+| 20px | Top-rounded cards (20px 20px 0 0), modal headers |
+| 340px | Large rounded decorative elements |
+| 9999px | Pill buttons, pill badges, nav elements |
+
+## 6. Depth & Elevation
+
+| Level | Treatment | Use |
+|-------|-----------|-----|
+| Base | No shadow, dark surface | Default page background |
+| Subtle | `rgba(0,0,0,0.1) 0px 0px 0px 1px` + inset white glow | Resting cards |
+| Medium | Multi-layer: 1px ring + 2px + 4px + 8px shadow stack | Elevated cards, featured sections |
+| High | `rgba(0,0,0,0.25) 0px 25px 50px -12px` | Modals, dropdowns, overlays |
+| Focus | `0px 0px 0px 2px #36F4A4` | Keyboard focus ring (Neon Green) |
+
+Shopify's shadow system is unusually sophisticated. Rather than single-value shadows, cards use a stacked, multi-layer approach: a 1px ring for boundary definition, 2px/4px/8px progressive blurs for natural light falloff, and a delicate inset white glow (`rgba(255,255,255,0.03)`) that simulates a top-lit glass surface. On dark backgrounds, shadows darken from already-dark surfaces, so the shadows function more as "ambient occlusion" than traditional elevation — the card appears to sink slightly into the surface rather than float above it.
+
+### Decorative Depth
+
+- **Dark teal gradients**: Ambient radial washes behind hero sections and product showcases
+- **Spotlight effects**: Bright centered areas fading to black, creating keynote-style theatrical lighting
+- **Edge glow**: Subtle light colored edges on dark cards via inset box-shadow
+- **Green atmospheric halos**: Faint green tints in background gradients, echoing the brand accent
+
+## 7. Do's and Don'ts
+
+### Do
+
+- Use the dark teal-black surface hierarchy (Void → Deep Teal → Dark Forest → Forest) for depth
+- Keep display typography at weight 330-400 — the ethereal lightness is the design's signature
+- Use Neon Green (`#36F4A4`) exclusively for focus states and critical accent highlights
+- Apply 9999px radius to all primary CTA buttons — the full pill is non-negotiable
+- Use the multi-layered shadow system for card elevation — single shadows look flat
+- Maintain the `ss03` OpenType feature across all text — it's part of the typographic identity
+- Use Inter Variable for body text and NeueHaasGrotesk for headings — never mix their roles
+- Create theatrical spacing between sections (80px+) for cinematic pacing
+
+### Don't
+
+- Don't use pure black (#000000) for text on dark backgrounds — use white (#FFFFFF) only
+- Don't introduce warm colors (orange, red, yellow) — the palette is strictly cool (greens, teals, neutrals)
+- Don't use font weights above 500 for NeueHaasGrotesk body text — heavy weights break the ethereal feel
+- Don't apply green accents to large surfaces — Neon Green is for small, precise highlights only
+- Don't use sharp corners (0px radius) on interactive elements — everything rounds
+- Don't add bright backgrounds — the dark theme is fundamental, not optional
+- Don't use single-layer box shadows — the stacked approach is the system
+- Don't set line-height above 1.56 for body text — Shopify's text is relatively compact
+- Don't mix NeueHaasGrotesk and Inter at the same size/role — their weight scales differ
+- Don't use letter-spacing below 0 for headings — Shopify headings track neutral or positive
+
+## 8. Responsive Behavior
+
+### Breakpoints
+
+| Name | Width | Key Changes |
+|------|-------|-------------|
+| Mobile | <640px | Single column, hamburger nav, display text scales to 48px, 16px padding |
+| Tablet | 640-1024px | 2-column grids begin, display text at 70px, 32px padding |
+| Desktop | 1024-1440px | Full layout, expanded nav, 96px display, 64px padding |
+| Large Desktop | >1440px | Max-width container centered, increased section spacing |
+
+### Touch Targets
+
+- Minimum touch target: 44x44px (WCAG AAA)
+- Pill buttons: 48px height minimum with generous horizontal padding
+- Nav links: 44px touch area
+- Card surfaces: full card is tappable where linked
+
+### Collapsing Strategy
+
+- **Navigation**: Full horizontal links → hamburger menu below 1024px; logo and CTA button remain visible
+- **Hero section**: 96px display → 70px at tablet → 48px on mobile; maintains single-column center alignment
+- **Feature sections**: 2-column text+image → stacked single column below 768px
+- **Stats**: Horizontal row → stacked vertical on mobile
+- **Section padding**: 64px → 40px → 24px → 16px as viewport narrows
+- **Cards**: Grid → stack, maintaining full-width on mobile
+
+### Image Behavior
+
+- Product screenshots: responsive within dark containers, maintain aspect ratio
+- Hero images: full-width on all breakpoints, lazy loaded with dark placeholders
+- Admin UI previews: scale proportionally, may crop on mobile
+- All images use CDN (`cdn.shopify.com`) with responsive srcset
+
+## 9. Agent Prompt Guide
+
+### Quick Color Reference
+
+- Primary CTA: Shopify White (`#FFFFFF`)
+- Page background: Void Black (`#000000`)
+- Card surface: Deep Teal (`#02090A`)
+- Section bg: Dark Forest (`#061A1C`)
+- Elevated bg: Forest (`#102620`)
+- Accent: Neon Green (`#36F4A4`)
+- Body text: White (`#FFFFFF`)
+- Muted text: Muted (`#A1A1AA`)
+- Border dark: Dark Card Border (`#1E2C31`)
+
+### Example Component Prompts
+
+- "Create a hero section on true black (#000000) background with a 96px/330 NeueHaasGrotesk headline in white, a 20px/500 subtitle in #A1A1AA, and two pill buttons: white filled (9999px radius) and ghost with 2px white border"
+- "Design a feature card on Deep Teal (#02090A) with 1px #1E2C31 border, 12px radius, multi-layer shadow (1px ring + 2px/4px/8px blur at 10% black), containing a 32px/360 white heading and 18px/400 #A1A1AA body text"
+- "Build a stats section on Dark Forest (#061A1C) with 96px/750 white numbers (NeueHaasGrotesk), 16px/400 #A1A1AA descriptive labels, and generous 64px spacing between stat blocks"
+- "Create a sticky nav with transparent background (becomes #102620 on scroll), white Shopify logo left, 18px/500 white nav links with 0.72px letter-spacing, and a white pill 'Start for free' button right"
+- "Design a tag/badge with rgba(255,255,255,0.2) frosted glass background, 4px radius, 12px 16px padding, white 16px text — floating over a dark card surface"
+
+### Iteration Guide
+
+When refining existing screens generated with this design system:
+1. Focus on ONE component at a time
+2. Reference specific color names and hex codes from this document
+3. Remember: this is a DARK-FIRST design — light surfaces are the exception, not the rule
+4. Display text should always feel feather-light (weight 330-400) — if it looks heavy, reduce the weight
+5. Neon Green (#36F4A4) is precious — use sparingly for focus and accent only
+6. The dark surface hierarchy (black → deep teal → dark forest → forest) creates subtle depth
+7. Shadows are multi-layered — a single `box-shadow` value won't capture the Shopify card feel
+8. `ss03` OpenType feature must be active on all text for typographic consistency

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

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