heraspec 0.1.12 → 0.1.14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (129) hide show
  1. package/LICENSE +22 -22
  2. package/README.md +188 -103
  3. package/bin/heraspec.js +4805 -1122
  4. package/bin/heraspec.js.map +4 -4
  5. package/dist/core/templates/skills/CHANGELOG.md +117 -117
  6. package/dist/core/templates/skills/README-template.md +58 -58
  7. package/dist/core/templates/skills/README.md +38 -38
  8. package/dist/core/templates/skills/content-optimization-skill.md +104 -104
  9. package/dist/core/templates/skills/data/design-systems.csv +54 -0
  10. package/dist/core/templates/skills/data/pages-proposed.csv +21 -21
  11. package/dist/core/templates/skills/data/pages.csv +9 -9
  12. package/dist/core/templates/skills/data/typography.csv +57 -57
  13. package/dist/core/templates/skills/deploy-documentation-skill.md +408 -0
  14. package/dist/core/templates/skills/design-system-skill.md +176 -0
  15. package/dist/core/templates/skills/documents/templates/documentation-landing-page.html +63 -63
  16. package/dist/core/templates/skills/documents/templates/documentation.html +49 -49
  17. package/dist/core/templates/skills/documents/templates/landing-script.js +38 -38
  18. package/dist/core/templates/skills/documents/templates/landing-style.css +158 -158
  19. package/dist/core/templates/skills/documents/templates/script.js +56 -56
  20. package/dist/core/templates/skills/documents/templates/style.css +155 -155
  21. package/dist/core/templates/skills/documents/templates/technical-doc-template.md +16 -16
  22. package/dist/core/templates/skills/documents/templates/user-guide-template.md +16 -16
  23. package/dist/core/templates/skills/documents-skill.md +104 -104
  24. package/dist/core/templates/skills/e2e-test-skill.md +119 -119
  25. package/dist/core/templates/skills/git-embed-skill.md +57 -0
  26. package/dist/core/templates/skills/integration-test-skill.md +118 -118
  27. package/dist/core/templates/skills/knowledge/README.md +63 -0
  28. package/dist/core/templates/skills/knowledge/design-systems/airbnb/DESIGN.md +246 -0
  29. package/dist/core/templates/skills/knowledge/design-systems/airtable/DESIGN.md +89 -0
  30. package/dist/core/templates/skills/knowledge/design-systems/apple/DESIGN.md +313 -0
  31. package/dist/core/templates/skills/knowledge/design-systems/bmw/DESIGN.md +180 -0
  32. package/dist/core/templates/skills/knowledge/design-systems/cal/DESIGN.md +259 -0
  33. package/dist/core/templates/skills/knowledge/design-systems/claude/DESIGN.md +312 -0
  34. package/dist/core/templates/skills/knowledge/design-systems/clay/DESIGN.md +304 -0
  35. package/dist/core/templates/skills/knowledge/design-systems/clickhouse/DESIGN.md +281 -0
  36. package/dist/core/templates/skills/knowledge/design-systems/cohere/DESIGN.md +266 -0
  37. package/dist/core/templates/skills/knowledge/design-systems/coinbase/DESIGN.md +129 -0
  38. package/dist/core/templates/skills/knowledge/design-systems/composio/DESIGN.md +307 -0
  39. package/dist/core/templates/skills/knowledge/design-systems/cursor/DESIGN.md +309 -0
  40. package/dist/core/templates/skills/knowledge/design-systems/elevenlabs/DESIGN.md +265 -0
  41. package/dist/core/templates/skills/knowledge/design-systems/expo/DESIGN.md +281 -0
  42. package/dist/core/templates/skills/knowledge/design-systems/figma/DESIGN.md +220 -0
  43. package/dist/core/templates/skills/knowledge/design-systems/framer/DESIGN.md +246 -0
  44. package/dist/core/templates/skills/knowledge/design-systems/hashicorp/DESIGN.md +278 -0
  45. package/dist/core/templates/skills/knowledge/design-systems/ibm/DESIGN.md +332 -0
  46. package/dist/core/templates/skills/knowledge/design-systems/index.json +72 -0
  47. package/dist/core/templates/skills/knowledge/design-systems/intercom/DESIGN.md +146 -0
  48. package/dist/core/templates/skills/knowledge/design-systems/kraken/DESIGN.md +125 -0
  49. package/dist/core/templates/skills/knowledge/design-systems/linear.app/DESIGN.md +367 -0
  50. package/dist/core/templates/skills/knowledge/design-systems/lovable/DESIGN.md +298 -0
  51. package/dist/core/templates/skills/knowledge/design-systems/minimax/DESIGN.md +257 -0
  52. package/dist/core/templates/skills/knowledge/design-systems/mintlify/DESIGN.md +326 -0
  53. package/dist/core/templates/skills/knowledge/design-systems/miro/DESIGN.md +108 -0
  54. package/dist/core/templates/skills/knowledge/design-systems/mistral.ai/DESIGN.md +261 -0
  55. package/dist/core/templates/skills/knowledge/design-systems/mongodb/DESIGN.md +266 -0
  56. package/dist/core/templates/skills/knowledge/design-systems/notion/DESIGN.md +309 -0
  57. package/dist/core/templates/skills/knowledge/design-systems/nvidia/DESIGN.md +293 -0
  58. package/dist/core/templates/skills/knowledge/design-systems/ollama/DESIGN.md +267 -0
  59. package/dist/core/templates/skills/knowledge/design-systems/opencode.ai/DESIGN.md +281 -0
  60. package/dist/core/templates/skills/knowledge/design-systems/pinterest/DESIGN.md +230 -0
  61. package/dist/core/templates/skills/knowledge/design-systems/posthog/DESIGN.md +256 -0
  62. package/dist/core/templates/skills/knowledge/design-systems/raycast/DESIGN.md +268 -0
  63. package/dist/core/templates/skills/knowledge/design-systems/replicate/DESIGN.md +261 -0
  64. package/dist/core/templates/skills/knowledge/design-systems/resend/DESIGN.md +303 -0
  65. package/dist/core/templates/skills/knowledge/design-systems/revolut/DESIGN.md +185 -0
  66. package/dist/core/templates/skills/knowledge/design-systems/runwayml/DESIGN.md +244 -0
  67. package/dist/core/templates/skills/knowledge/design-systems/sanity/DESIGN.md +357 -0
  68. package/dist/core/templates/skills/knowledge/design-systems/sentry/DESIGN.md +262 -0
  69. package/dist/core/templates/skills/knowledge/design-systems/spacex/DESIGN.md +194 -0
  70. package/dist/core/templates/skills/knowledge/design-systems/spotify/DESIGN.md +246 -0
  71. package/dist/core/templates/skills/knowledge/design-systems/stripe/DESIGN.md +322 -0
  72. package/dist/core/templates/skills/knowledge/design-systems/supabase/DESIGN.md +255 -0
  73. package/dist/core/templates/skills/knowledge/design-systems/superhuman/DESIGN.md +252 -0
  74. package/dist/core/templates/skills/knowledge/design-systems/together.ai/DESIGN.md +263 -0
  75. package/dist/core/templates/skills/knowledge/design-systems/uber/DESIGN.md +295 -0
  76. package/dist/core/templates/skills/knowledge/design-systems/vercel/DESIGN.md +310 -0
  77. package/dist/core/templates/skills/knowledge/design-systems/voltagent/DESIGN.md +323 -0
  78. package/dist/core/templates/skills/knowledge/design-systems/warp/DESIGN.md +253 -0
  79. package/dist/core/templates/skills/knowledge/design-systems/webflow/DESIGN.md +92 -0
  80. package/dist/core/templates/skills/knowledge/design-systems/wise/DESIGN.md +173 -0
  81. package/dist/core/templates/skills/knowledge/design-systems/x.ai/DESIGN.md +257 -0
  82. package/dist/core/templates/skills/knowledge/design-systems/zapier/DESIGN.md +328 -0
  83. package/dist/core/templates/skills/knowledge/frameworks/php/codeigniter/rise-cms/profile.json +27 -0
  84. package/dist/core/templates/skills/knowledge/frameworks/php/codeigniter/rise-cms/structure.md +137 -0
  85. package/dist/core/templates/skills/knowledge/frameworks/php/laravel/botble/profile.json +39 -0
  86. package/dist/core/templates/skills/knowledge/frameworks/php/laravel/botble/structure.md +208 -0
  87. package/dist/core/templates/skills/knowledge/frameworks/php/wordpress/core/profile.json +51 -0
  88. package/dist/core/templates/skills/knowledge/frameworks/php/wordpress/core/structure.md +369 -0
  89. package/dist/core/templates/skills/knowledge/index.json +65 -0
  90. package/dist/core/templates/skills/module-codebase-skill.md +110 -110
  91. package/dist/core/templates/skills/plugin-directory-skill.md +396 -396
  92. package/dist/core/templates/skills/project-memory-skill.md +222 -0
  93. package/dist/core/templates/skills/project-memory-skill.vi.md +223 -0
  94. package/dist/core/templates/skills/scripts/CODE_EXPLANATION.md +394 -394
  95. package/dist/core/templates/skills/scripts/SEARCH_ALGORITHMS_COMPARISON.md +421 -421
  96. package/dist/core/templates/skills/scripts/SEARCH_MODES_GUIDE.md +238 -238
  97. package/dist/core/templates/skills/scripts/__pycache__/core.cpython-311.pyc +0 -0
  98. package/dist/core/templates/skills/scripts/core.py +391 -385
  99. package/dist/core/templates/skills/scripts/search.py +1 -1
  100. package/dist/core/templates/skills/smart-explore-skill.md +141 -0
  101. package/dist/core/templates/skills/sourcecode-analyzer-skill.md +210 -0
  102. package/dist/core/templates/skills/sourcecode-analyzer-skill.vi.md +210 -0
  103. package/dist/core/templates/skills/suggestion-skill.md +118 -118
  104. package/dist/core/templates/skills/templates/accessibility-checklist.md +40 -40
  105. package/dist/core/templates/skills/templates/example-prompt-full-theme.md +333 -333
  106. package/dist/core/templates/skills/templates/page-types-guide.md +338 -338
  107. package/dist/core/templates/skills/templates/pages-proposed-summary.md +273 -273
  108. package/dist/core/templates/skills/templates/pre-delivery-checklist.md +42 -42
  109. package/dist/core/templates/skills/templates/prompt-template-full-theme.md +313 -313
  110. package/dist/core/templates/skills/templates/responsive-design.md +40 -40
  111. package/dist/core/templates/skills/ui-ux-skill.md +595 -584
  112. package/dist/core/templates/skills/unit-test-skill.md +111 -111
  113. package/dist/core/templates/skills/ux-element/templates/Controller.php +50 -50
  114. package/dist/core/templates/skills/ux-element/templates/Shortcode.php +23 -23
  115. package/dist/core/templates/skills/ux-element/templates/Template.html +20 -20
  116. package/dist/core/templates/skills/ux-element/templates/Thumbnail.svg +8 -8
  117. package/dist/core/templates/skills/ux-element/templates/View.php +21 -21
  118. package/dist/core/templates/skills/ux-element-skill.md +83 -83
  119. package/dist/core/templates/skills/wordpress-plugin-check-skill.md +151 -76
  120. package/dist/core/templates/skills/wordpress-plugin-standard/templates/admin-dashboard.php +47 -47
  121. package/dist/core/templates/skills/wordpress-plugin-standard/templates/admin-settings.php +60 -60
  122. package/dist/core/templates/skills/wordpress-plugin-standard/templates/assets/admin-css.css +22 -22
  123. package/dist/core/templates/skills/wordpress-plugin-standard/templates/assets/admin-js.js +15 -15
  124. package/dist/core/templates/skills/wordpress-plugin-standard/templates/plugin-main.php +169 -169
  125. package/dist/core/templates/skills/wordpress-plugin-standard/templates/readme.txt +41 -41
  126. package/dist/core/templates/skills/wordpress-plugin-standard/templates/uninstall.php +21 -21
  127. package/dist/core/templates/skills/wordpress-plugin-standard-skill.md +100 -100
  128. package/dist/index.js +4068 -278
  129. package/package.json +75 -72
@@ -0,0 +1,72 @@
1
+ {
2
+ "version": "1.0",
3
+ "source": "https://github.com/VoltAgent/awesome-design-md",
4
+ "description": "DESIGN.md files extracted from real websites following Google Stitch format. Each file contains a complete design system with 9 sections: Visual Theme, Color Palette, Typography, Components, Layout, Elevation, Do's/Don'ts, Responsive, Agent Prompts.",
5
+ "format": "Google Stitch DESIGN.md (https://stitch.withgoogle.com/docs/design-md/format/)",
6
+ "update_instructions": "To update: copy DESIGN.md files from awesome-design-md/design-md/<site>/ into the corresponding subdirectory here. Only DESIGN.md files are needed (preview.html files are not required).",
7
+ "count": 54,
8
+ "categories": {
9
+ "ai-ml": ["claude", "cohere", "elevenlabs", "minimax", "mistral.ai", "ollama", "opencode.ai", "replicate", "runwayml", "together.ai", "voltagent", "x.ai"],
10
+ "developer-tools": ["cursor", "expo", "linear.app", "lovable", "mintlify", "posthog", "raycast", "resend", "sentry", "supabase", "superhuman", "vercel", "warp", "zapier"],
11
+ "infrastructure-cloud": ["clickhouse", "composio", "hashicorp", "mongodb", "sanity", "stripe"],
12
+ "design-productivity": ["airtable", "cal", "clay", "figma", "framer", "intercom", "miro", "notion", "pinterest", "webflow"],
13
+ "fintech-crypto": ["coinbase", "kraken", "revolut", "wise"],
14
+ "enterprise-consumer": ["airbnb", "apple", "bmw", "ibm", "nvidia", "spacex", "spotify", "uber"]
15
+ },
16
+ "entries": [
17
+ {"id": "airbnb", "name": "Airbnb", "category": "enterprise-consumer", "theme": "light", "accent": "#FF5A5F"},
18
+ {"id": "airtable", "name": "Airtable", "category": "design-productivity", "theme": "light", "accent": "#2D7FF9"},
19
+ {"id": "apple", "name": "Apple", "category": "enterprise-consumer", "theme": "light", "accent": "#0071E3"},
20
+ {"id": "bmw", "name": "BMW", "category": "enterprise-consumer", "theme": "dark", "accent": "#1C69D4"},
21
+ {"id": "cal", "name": "Cal.com", "category": "design-productivity", "theme": "light", "accent": "#111827"},
22
+ {"id": "claude", "name": "Claude (Anthropic)", "category": "ai-ml", "theme": "light", "accent": "#DA7756"},
23
+ {"id": "clay", "name": "Clay", "category": "design-productivity", "theme": "light", "accent": "#4361EE"},
24
+ {"id": "clickhouse", "name": "ClickHouse", "category": "infrastructure-cloud", "theme": "light", "accent": "#FADB14"},
25
+ {"id": "cohere", "name": "Cohere", "category": "ai-ml", "theme": "both", "accent": "#39594D"},
26
+ {"id": "coinbase", "name": "Coinbase", "category": "fintech-crypto", "theme": "light", "accent": "#0052FF"},
27
+ {"id": "composio", "name": "Composio", "category": "infrastructure-cloud", "theme": "dark", "accent": "#6C5CE7"},
28
+ {"id": "cursor", "name": "Cursor", "category": "developer-tools", "theme": "dark", "accent": "#7C5CFC"},
29
+ {"id": "elevenlabs", "name": "ElevenLabs", "category": "ai-ml", "theme": "dark", "accent": "#FFFFFF"},
30
+ {"id": "expo", "name": "Expo", "category": "developer-tools", "theme": "dark", "accent": "#368CCB"},
31
+ {"id": "figma", "name": "Figma", "category": "design-productivity", "theme": "light", "accent": "#0D99FF"},
32
+ {"id": "framer", "name": "Framer", "category": "design-productivity", "theme": "both", "accent": "#0055FF"},
33
+ {"id": "hashicorp", "name": "HashiCorp", "category": "infrastructure-cloud", "theme": "light", "accent": "#000000"},
34
+ {"id": "ibm", "name": "IBM", "category": "enterprise-consumer", "theme": "both", "accent": "#0F62FE"},
35
+ {"id": "intercom", "name": "Intercom", "category": "design-productivity", "theme": "light", "accent": "#396AFF"},
36
+ {"id": "kraken", "name": "Kraken", "category": "fintech-crypto", "theme": "dark", "accent": "#7B61FF"},
37
+ {"id": "linear.app", "name": "Linear", "category": "developer-tools", "theme": "dark", "accent": "#5E6AD2"},
38
+ {"id": "lovable", "name": "Lovable", "category": "developer-tools", "theme": "both", "accent": "#9B87F5"},
39
+ {"id": "minimax", "name": "MiniMax", "category": "ai-ml", "theme": "dark", "accent": "#00FF88"},
40
+ {"id": "mintlify", "name": "Mintlify", "category": "developer-tools", "theme": "light", "accent": "#0D9373"},
41
+ {"id": "miro", "name": "Miro", "category": "design-productivity", "theme": "light", "accent": "#FFD02F"},
42
+ {"id": "mistral.ai", "name": "Mistral AI", "category": "ai-ml", "theme": "light", "accent": "#F54E42"},
43
+ {"id": "mongodb", "name": "MongoDB", "category": "infrastructure-cloud", "theme": "light", "accent": "#00ED64"},
44
+ {"id": "notion", "name": "Notion", "category": "design-productivity", "theme": "light", "accent": "#2383E2"},
45
+ {"id": "nvidia", "name": "NVIDIA", "category": "enterprise-consumer", "theme": "dark", "accent": "#76B900"},
46
+ {"id": "ollama", "name": "Ollama", "category": "ai-ml", "theme": "light", "accent": "#000000"},
47
+ {"id": "opencode.ai", "name": "OpenCode", "category": "ai-ml", "theme": "dark", "accent": "#10B981"},
48
+ {"id": "pinterest", "name": "Pinterest", "category": "design-productivity", "theme": "light", "accent": "#E60023"},
49
+ {"id": "posthog", "name": "PostHog", "category": "developer-tools", "theme": "dark", "accent": "#F54E00"},
50
+ {"id": "raycast", "name": "Raycast", "category": "developer-tools", "theme": "dark", "accent": "#FF6363"},
51
+ {"id": "replicate", "name": "Replicate", "category": "ai-ml", "theme": "light", "accent": "#000000"},
52
+ {"id": "resend", "name": "Resend", "category": "developer-tools", "theme": "dark", "accent": "#FFFFFF"},
53
+ {"id": "revolut", "name": "Revolut", "category": "fintech-crypto", "theme": "dark", "accent": "#0075EB"},
54
+ {"id": "runwayml", "name": "Runway", "category": "ai-ml", "theme": "dark", "accent": "#FFFFFF"},
55
+ {"id": "sanity", "name": "Sanity", "category": "infrastructure-cloud", "theme": "light", "accent": "#F36458"},
56
+ {"id": "sentry", "name": "Sentry", "category": "developer-tools", "theme": "dark", "accent": "#6C5FC7"},
57
+ {"id": "spacex", "name": "SpaceX", "category": "enterprise-consumer", "theme": "dark", "accent": "#FFFFFF"},
58
+ {"id": "spotify", "name": "Spotify", "category": "enterprise-consumer", "theme": "dark", "accent": "#1DB954"},
59
+ {"id": "stripe", "name": "Stripe", "category": "infrastructure-cloud", "theme": "light", "accent": "#533AFD"},
60
+ {"id": "supabase", "name": "Supabase", "category": "developer-tools", "theme": "dark", "accent": "#3ECF8E"},
61
+ {"id": "superhuman", "name": "Superhuman", "category": "developer-tools", "theme": "dark", "accent": "#6C5CE7"},
62
+ {"id": "together.ai", "name": "Together AI", "category": "ai-ml", "theme": "both", "accent": "#3A86FF"},
63
+ {"id": "uber", "name": "Uber", "category": "enterprise-consumer", "theme": "both", "accent": "#000000"},
64
+ {"id": "vercel", "name": "Vercel", "category": "developer-tools", "theme": "light", "accent": "#171717"},
65
+ {"id": "voltagent", "name": "VoltAgent", "category": "ai-ml", "theme": "dark", "accent": "#10B981"},
66
+ {"id": "warp", "name": "Warp", "category": "developer-tools", "theme": "dark", "accent": "#01A4FF"},
67
+ {"id": "webflow", "name": "Webflow", "category": "design-productivity", "theme": "light", "accent": "#4353FF"},
68
+ {"id": "wise", "name": "Wise", "category": "fintech-crypto", "theme": "light", "accent": "#9FE870"},
69
+ {"id": "x.ai", "name": "xAI", "category": "ai-ml", "theme": "dark", "accent": "#FFFFFF"},
70
+ {"id": "zapier", "name": "Zapier", "category": "developer-tools", "theme": "light", "accent": "#FF4A00"}
71
+ ]
72
+ }
@@ -0,0 +1,146 @@
1
+ # Design System: Intercom
2
+
3
+ ## 1. Visual Theme & Atmosphere
4
+
5
+ Intercom's website is a warm, confident customer service platform that communicates "AI-first helpdesk" through a clean, editorial design language. The page operates on a warm off-white canvas (`#faf9f6`) with off-black (`#111111`) text, creating an intimate, magazine-like reading experience. The signature Fin Orange (`#ff5600`) — named after Intercom's AI agent — serves as the singular vibrant accent against the warm neutral palette.
6
+
7
+ The typography uses Saans — a custom geometric sans-serif with aggressive negative letter-spacing (-2.4px at 80px, -0.48px at 24px) and a consistent 1.00 line-height across all heading sizes. This creates ultra-compressed, billboard-like headlines that feel engineered and precise. Serrif provides the serif companion for editorial moments, and SaansMono handles code and uppercase technical labels. MediumLL and LLMedium appear for specific UI contexts, creating a rich five-font ecosystem.
8
+
9
+ What distinguishes Intercom is its remarkably sharp geometry — 4px border-radius on buttons creates near-rectangular interactive elements that feel industrial and precise, contrasting with the warm surface colors. Button hover states use `scale(1.1)` expansion, creating a physical "growing" interaction. The border system uses warm oat tones (`#dedbd6`) and oklab-based opacity values for sophisticated color management.
10
+
11
+ **Key Characteristics:**
12
+ - Warm off-white canvas (`#faf9f6`) with oat-toned borders (`#dedbd6`)
13
+ - Saans font with extreme negative tracking (-2.4px at 80px) and 1.00 line-height
14
+ - Fin Orange (`#ff5600`) as singular brand accent
15
+ - Sharp 4px border-radius — near-rectangular buttons and elements
16
+ - Scale(1.1) hover with scale(0.85) active — physical button interaction
17
+ - SaansMono uppercase labels with wide tracking (0.6px–1.2px)
18
+ - Rich multi-color report palette (blue, green, red, pink, lime, orange)
19
+ - oklab color values for sophisticated opacity management
20
+
21
+ ## 2. Color Palette & Roles
22
+
23
+ ### Primary
24
+ - **Off Black** (`#111111`): `--color-off-black`, primary text, button backgrounds
25
+ - **Pure White** (`#ffffff`): `--wsc-color-content-primary`, primary surface
26
+ - **Warm Cream** (`#faf9f6`): Button backgrounds, card surfaces
27
+ - **Fin Orange** (`#ff5600`): `--color-fin`, primary brand accent
28
+ - **Report Orange** (`#fe4c02`): `--color-report-orange`, data visualization
29
+
30
+ ### Report Palette
31
+ - **Report Blue** (`#65b5ff`): `--color-report-blue`
32
+ - **Report Green** (`#0bdf50`): `--color-report-green`
33
+ - **Report Red** (`#c41c1c`): `--color-report-red`
34
+ - **Report Pink** (`#ff2067`): `--color-report-pink`
35
+ - **Report Lime** (`#b3e01c`): `--color-report-lime-300`
36
+ - **Green** (`#00da00`): `--color-green`
37
+ - **Deep Blue** (`#0007cb`): Deep blue accent
38
+
39
+ ### Neutral Scale (Warm)
40
+ - **Black 80** (`#313130`): `--wsc-color-black-80`, dark neutral
41
+ - **Black 60** (`#626260`): `--wsc-color-black-60`, mid neutral
42
+ - **Black 50** (`#7b7b78`): `--wsc-color-black-50`, muted text
43
+ - **Content Tertiary** (`#9c9fa5`): `--wsc-color-content-tertiary`
44
+ - **Oat Border** (`#dedbd6`): Warm border color
45
+ - **Warm Sand** (`#d3cec6`): Light warm neutral
46
+
47
+ ## 3. Typography Rules
48
+
49
+ ### Font Families
50
+ - **Primary**: `Saans`, fallbacks: `Saans Fallback, ui-sans-serif, system-ui`
51
+ - **Serif**: `Serrif`, fallbacks: `Serrif Fallback, ui-serif, Georgia`
52
+ - **Monospace**: `SaansMono`, fallbacks: `SaansMono Fallback, ui-monospace`
53
+ - **UI**: `MediumLL` / `LLMedium`, fallbacks: `system-ui, -apple-system`
54
+
55
+ ### Hierarchy
56
+
57
+ | Role | Font | Size | Weight | Line Height | Letter Spacing |
58
+ |------|------|------|--------|-------------|----------------|
59
+ | Display Hero | Saans | 80px | 400 | 1.00 (tight) | -2.4px |
60
+ | Section Heading | Saans | 54px | 400 | 1.00 | -1.6px |
61
+ | Sub-heading | Saans | 40px | 400 | 1.00 | -1.2px |
62
+ | Card Title | Saans | 32px | 400 | 1.00 | -0.96px |
63
+ | Feature Title | Saans | 24px | 400 | 1.00 | -0.48px |
64
+ | Body Emphasis | Saans | 20px | 400 | 0.95 | -0.2px |
65
+ | Nav / UI | Saans | 18px | 400 | 1.00 | normal |
66
+ | Body | Saans | 16px | 400 | 1.50 | normal |
67
+ | Body Light | Saans | 14px | 300 | 1.40 | normal |
68
+ | Button | Saans | 16px / 14px | 400 | 1.50 / 1.43 | normal |
69
+ | Button Bold | LLMedium | 16px | 700 | 1.20 | 0.16px |
70
+ | Serif Body | Serrif | 16px | 300 | 1.40 | -0.16px |
71
+ | Mono Label | SaansMono | 12px | 400–500 | 1.00–1.30 | 0.6px–1.2px uppercase |
72
+
73
+ ## 4. Component Stylings
74
+
75
+ ### Buttons
76
+
77
+ **Primary Dark**
78
+ - Background: `#111111`
79
+ - Text: `#ffffff`
80
+ - Padding: 0px 14px
81
+ - Radius: 4px
82
+ - Hover: white background, dark text, scale(1.1)
83
+ - Active: green background (`#2c6415`), scale(0.85)
84
+
85
+ **Outlined**
86
+ - Background: transparent
87
+ - Text: `#111111`
88
+ - Border: `1px solid #111111`
89
+ - Radius: 4px
90
+ - Same scale hover/active behavior
91
+
92
+ **Warm Card Button**
93
+ - Background: `#faf9f6`
94
+ - Text: `#111111`
95
+ - Padding: 16px
96
+ - Border: `1px solid oklab(... / 0.1)`
97
+
98
+ ### Cards & Containers
99
+ - Background: `#faf9f6` (warm cream)
100
+ - Border: `1px solid #dedbd6` (warm oat)
101
+ - Radius: 8px
102
+ - No visible shadows
103
+
104
+ ### Navigation
105
+ - Saans 16px for links
106
+ - Off-black text on white
107
+ - Small 4px–6px radius buttons
108
+ - Orange Fin accent for AI features
109
+
110
+ ## 5. Layout Principles
111
+
112
+ ### Spacing: 8px, 10px, 12px, 14px, 16px, 20px, 24px, 32px, 40px, 48px, 60px, 64px, 80px, 96px
113
+ ### Border Radius: 4px (buttons), 6px (nav items), 8px (cards, containers)
114
+
115
+ ## 6. Depth & Elevation
116
+ Minimal shadows. Depth through warm border colors and surface tints.
117
+
118
+ ## 7. Do's and Don'ts
119
+
120
+ ### Do
121
+ - Use Saans with 1.00 line-height and negative tracking on all headings
122
+ - Apply 4px radius on buttons — sharp geometry is the identity
123
+ - Use Fin Orange (#ff5600) for AI/brand accent only
124
+ - Apply scale(1.1) hover on buttons
125
+ - Use warm neutrals (#faf9f6, #dedbd6)
126
+
127
+ ### Don't
128
+ - Don't round buttons beyond 4px
129
+ - Don't use Fin Orange decoratively
130
+ - Don't use cool gray borders — always warm oat tones
131
+ - Don't skip the negative tracking on headings
132
+
133
+ ## 8. Responsive Behavior
134
+ Breakpoints: 425px, 530px, 600px, 640px, 768px, 896px
135
+
136
+ ## 9. Agent Prompt Guide
137
+
138
+ ### Quick Color Reference
139
+ - Text: Off Black (`#111111`)
140
+ - Background: Warm Cream (`#faf9f6`)
141
+ - Accent: Fin Orange (`#ff5600`)
142
+ - Border: Oat (`#dedbd6`)
143
+ - Muted: `#7b7b78`
144
+
145
+ ### Example Component Prompts
146
+ - "Create hero: warm cream (#faf9f6) background. Saans 80px weight 400, line-height 1.00, letter-spacing -2.4px, #111111. Dark button (#111111, 4px radius). Hover: scale(1.1), white bg."
@@ -0,0 +1,125 @@
1
+ # Design System: Kraken
2
+
3
+ ## 1. Visual Theme & Atmosphere
4
+
5
+ Kraken's website is a clean, trustworthy crypto exchange that uses purple as its commanding brand color. The design operates on white backgrounds with Kraken Purple (`#7132f5`, `#5741d8`, `#5b1ecf`) creating a distinctive, professional crypto identity. The proprietary Kraken-Brand font handles display headings with bold (700) weight and negative tracking, while Kraken-Product (with IBM Plex Sans fallback) serves as the UI workhorse.
6
+
7
+ **Key Characteristics:**
8
+ - Kraken Purple (`#7132f5`) as primary brand with darker variants (`#5741d8`, `#5b1ecf`)
9
+ - Kraken-Brand (display) + Kraken-Product (UI) dual font system
10
+ - Near-black (`#101114`) text with cool blue-gray neutral scale
11
+ - 12px radius buttons (rounded but not pill)
12
+ - Subtle shadows (`rgba(0,0,0,0.03) 0px 4px 24px`) — whisper-level
13
+ - Green accent (`#149e61`) for positive/success states
14
+
15
+ ## 2. Color Palette & Roles
16
+
17
+ ### Primary
18
+ - **Kraken Purple** (`#7132f5`): Primary CTA, brand accent, links
19
+ - **Purple Dark** (`#5741d8`): Button borders, outlined variants
20
+ - **Purple Deep** (`#5b1ecf`): Deepest purple
21
+ - **Purple Subtle** (`rgba(133,91,251,0.16)`): Purple at 16% — subtle button backgrounds
22
+ - **Near Black** (`#101114`): Primary text
23
+
24
+ ### Neutral
25
+ - **Cool Gray** (`#686b82`): Primary neutral, borders at 24% opacity
26
+ - **Silver Blue** (`#9497a9`): Secondary text, muted elements
27
+ - **White** (`#ffffff`): Primary surface
28
+ - **Border Gray** (`#dedee5`): Divider borders
29
+
30
+ ### Semantic
31
+ - **Green** (`#149e61`): Success/positive at 16% opacity for badges
32
+ - **Green Dark** (`#026b3f`): Badge text
33
+
34
+ ## 3. Typography Rules
35
+
36
+ ### Font Families
37
+ - **Display**: `Kraken-Brand`, fallbacks: `IBM Plex Sans, Helvetica, Arial`
38
+ - **UI / Body**: `Kraken-Product`, fallbacks: `Helvetica Neue, Helvetica, Arial`
39
+
40
+ ### Hierarchy
41
+
42
+ | Role | Font | Size | Weight | Line Height | Letter Spacing |
43
+ |------|------|------|--------|-------------|----------------|
44
+ | Display Hero | Kraken-Brand | 48px | 700 | 1.17 | -1px |
45
+ | Section Heading | Kraken-Brand | 36px | 700 | 1.22 | -0.5px |
46
+ | Sub-heading | Kraken-Brand | 28px | 700 | 1.29 | -0.5px |
47
+ | Feature Title | Kraken-Product | 22px | 600 | 1.20 | normal |
48
+ | Body | Kraken-Product | 16px | 400 | 1.38 | normal |
49
+ | Body Medium | Kraken-Product | 16px | 500 | 1.38 | normal |
50
+ | Button | Kraken-Product | 16px | 500–600 | 1.38 | normal |
51
+ | Caption | Kraken-Product | 14px | 400–700 | 1.43–1.71 | normal |
52
+ | Small | Kraken-Product | 12px | 400–500 | 1.33 | normal |
53
+ | Micro | Kraken-Product | 7px | 500 | 1.00 | uppercase |
54
+
55
+ ## 4. Component Stylings
56
+
57
+ ### Buttons
58
+
59
+ **Primary Purple**
60
+ - Background: `#7132f5`
61
+ - Text: `#ffffff`
62
+ - Padding: 13px 16px
63
+ - Radius: 12px
64
+
65
+ **Purple Outlined**
66
+ - Background: `#ffffff`
67
+ - Text: `#5741d8`
68
+ - Border: `1px solid #5741d8`
69
+ - Radius: 12px
70
+
71
+ **Purple Subtle**
72
+ - Background: `rgba(133,91,251,0.16)`
73
+ - Text: `#7132f5`
74
+ - Padding: 8px
75
+ - Radius: 12px
76
+
77
+ **White Button**
78
+ - Background: `#ffffff`
79
+ - Text: `#101114`
80
+ - Radius: 10px
81
+ - Shadow: `rgba(0,0,0,0.03) 0px 4px 24px`
82
+
83
+ **Secondary Gray**
84
+ - Background: `rgba(148,151,169,0.08)`
85
+ - Text: `#101114`
86
+ - Radius: 12px
87
+
88
+ ### Badges
89
+ - Success: `rgba(20,158,97,0.16)` bg, `#026b3f` text, 6px radius
90
+ - Neutral: `rgba(104,107,130,0.12)` bg, `#484b5e` text, 8px radius
91
+
92
+ ## 5. Layout Principles
93
+
94
+ ### Spacing: 1px, 2px, 3px, 4px, 5px, 6px, 8px, 10px, 12px, 13px, 15px, 16px, 20px, 24px, 25px
95
+ ### Border Radius: 3px, 6px, 8px, 10px, 12px, 16px, 9999px, 50%
96
+
97
+ ## 6. Depth & Elevation
98
+ - Subtle: `rgba(0,0,0,0.03) 0px 4px 24px`
99
+ - Micro: `rgba(16,24,40,0.04) 0px 1px 4px`
100
+
101
+ ## 7. Do's and Don'ts
102
+
103
+ ### Do
104
+ - Use Kraken Purple (#7132f5) for CTAs and links
105
+ - Apply 12px radius on all buttons
106
+ - Use Kraken-Brand for headings, Kraken-Product for body
107
+
108
+ ### Don't
109
+ - Don't use pill buttons — 12px is the max radius for buttons
110
+ - Don't use other purples outside the defined scale
111
+
112
+ ## 8. Responsive Behavior
113
+ Breakpoints: 375px, 425px, 640px, 768px, 1024px, 1280px, 1536px
114
+
115
+ ## 9. Agent Prompt Guide
116
+
117
+ ### Quick Color Reference
118
+ - Brand: Kraken Purple (`#7132f5`)
119
+ - Dark variant: `#5741d8`
120
+ - Text: Near Black (`#101114`)
121
+ - Secondary text: `#9497a9`
122
+ - Background: White (`#ffffff`)
123
+
124
+ ### Example Component Prompts
125
+ - "Create hero: white background. Kraken-Brand 48px weight 700, letter-spacing -1px. Purple CTA (#7132f5, 12px radius, 13px 16px padding)."