medesign 0.0.0-stage → 1.2.0

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 (82) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +128 -2
  3. package/bin/medesign.js +200 -0
  4. package/integrations/claude-code/SKILL.md +20 -0
  5. package/integrations/cursor/medesign.mdc +26 -0
  6. package/medesign.config.js +46 -0
  7. package/package.json +62 -4
  8. package/presets/apple/design-tokens.css +115 -0
  9. package/presets/apple/guidelines.md +19 -0
  10. package/presets/apple/preset.json +53 -0
  11. package/presets/metha/design-tokens.css +127 -0
  12. package/presets/metha/guidelines.md +23 -0
  13. package/presets/metha/preset.json +53 -0
  14. package/presets/schema.json +102 -0
  15. package/presets/tesla/design-tokens.css +112 -0
  16. package/presets/tesla/guidelines.md +17 -0
  17. package/presets/tesla/preset.json +53 -0
  18. package/references/ai-tells.md +127 -0
  19. package/references/appendices.md +220 -0
  20. package/references/architecture.md +39 -0
  21. package/references/argon-design-archetypes.md +317 -0
  22. package/references/banner-sizes-and-styles.md +118 -0
  23. package/references/block-library.md +61 -0
  24. package/references/brand-design-tokens.md +42 -0
  25. package/references/catalog.json +108 -0
  26. package/references/cip-deliverable-guide.md +95 -0
  27. package/references/cip-design.md +121 -0
  28. package/references/cip-prompt-engineering.md +84 -0
  29. package/references/cip-style-guide.md +68 -0
  30. package/references/cli-architecture.md +146 -0
  31. package/references/components.md +240 -0
  32. package/references/dark-mode.md +23 -0
  33. package/references/design-core.md +42 -0
  34. package/references/design-md-protocol.md +75 -0
  35. package/references/design-routing.md +207 -0
  36. package/references/eng-imagery-content.md +71 -0
  37. package/references/eng-layout.md +28 -0
  38. package/references/eng-other.md +26 -0
  39. package/references/eng-states-theme.md +22 -0
  40. package/references/eng-type-color.md +44 -0
  41. package/references/icon-design.md +122 -0
  42. package/references/image-mockup-direction.md +53 -0
  43. package/references/image-to-code.md +46 -0
  44. package/references/impeccable-polish.md +85 -0
  45. package/references/intake.md +90 -0
  46. package/references/logo-color-psychology.md +101 -0
  47. package/references/logo-design.md +110 -0
  48. package/references/logo-prompt-engineering.md +158 -0
  49. package/references/logo-style-guide.md +109 -0
  50. package/references/mesurv-dna.md +104 -0
  51. package/references/micro-interactions-and-auto-animate.md +71 -0
  52. package/references/modern-craft-invariants.md +332 -0
  53. package/references/motion-tokens.md +99 -0
  54. package/references/preflight.md +110 -0
  55. package/references/proactive-motion.md +167 -0
  56. package/references/quality-gate.md +147 -0
  57. package/references/redesign-audit.md +38 -0
  58. package/references/redesign.md +52 -0
  59. package/references/slides-copywriting-formulas.md +84 -0
  60. package/references/slides-create.md +4 -0
  61. package/references/slides-html-template.md +295 -0
  62. package/references/slides-layout-patterns.md +137 -0
  63. package/references/slides-strategies.md +94 -0
  64. package/references/slides.md +42 -0
  65. package/references/social-photos-design.md +329 -0
  66. package/references/spatial-canvas-engine.md +160 -0
  67. package/references/stitch-system.md +184 -0
  68. package/references/style-extraction.md +17 -0
  69. package/references/styles/brutalist.md +88 -0
  70. package/references/styles/minimalist.md +81 -0
  71. package/references/styles/soft.md +94 -0
  72. package/references/threeui-spatial-engine.md +224 -0
  73. package/references/ui-styling-shadcn.md +336 -0
  74. package/references/ui-ux-vocabulary-vault.json +1223 -0
  75. package/references/ui-ux-vocabulary-vault.md +438 -0
  76. package/references/vocab-protocol.md +52 -0
  77. package/references/vocabulary.md +78 -0
  78. package/scripts/export-tokens.js +403 -0
  79. package/tests/browser-audit.js +442 -0
  80. package/tests/linter.js +412 -0
  81. package/tests/schemas/sarif-2.1.0.schema.json +2915 -0
  82. package/tests/visual-testbed.html +681 -0
@@ -0,0 +1,317 @@
1
+ # 38 High-Craft Design & Operational Archetypes & Prompt Architecture (Gemini 4.0 Argon Vault)
2
+
3
+ คลังแม่แบบสถาปัตยกรรมการออกแบบ 30 รูปแบบระดับ World-Class สำหรับนำไปใช้เป็น Blueprint ในการสั่งงาน `/medesign` หรือสร้างไฟล์ `design.md` ประจำโปรเจกต์ เพื่อขจัดงานดีไซน์แบบ AI Slop ให้กลายเป็นผลงานระดับ Awwwards และ Production-Grade
4
+
5
+ ---
6
+
7
+ ## 1. Master Prompt Formula (โครงสร้างสั่งงาน 5 ส่วน)
8
+
9
+ ```markdown
10
+ # Role & Aesthetic Direction
11
+ Act as a Principal Design Technologist & Awwwards-winning Creative Developer.
12
+ Design and build a [ประเภทโปรเจกต์] following the "[ชื่อสไตล์จาก 30 แบบด้านล่าง]" aesthetic.
13
+
14
+ # 1. Visual & Color Architecture
15
+ - Canvas Background: [Hex Code เช่น #08090A หรือ #F6F5F2]
16
+ - Surface & Elevation: [1px translucent border, subtle top highlight, layered ambient shadows]
17
+ - Palette: [Primary, Secondary, Accent สัดส่วน 60-30-10, บังคับ linear-gradient(in oklch, ...)]
18
+
19
+ # 2. Typography & Scannability
20
+ - Headings: [ชื่อฟอนต์, letter-spacing -0.03em, line-height 1.05, text-wrap: balance]
21
+ - Body/UI: [ฟอนต์อ่านง่าย, line-height 1.6-1.7, text-wrap: pretty]
22
+ - Metrics/Data: [Monospace, tabular-nums เสมอ]
23
+
24
+ # 3. Layout & Spatial Rhythm
25
+ - Grid: [12-column Bento Grid / Swiss Hairline Grid / Editorial Asymmetric]
26
+ - Radii: [Concentric Formula: r_inner = max(0, r_outer - padding)]
27
+ - Whitespace: [Generous breathing room, minimum 25% empty canvas]
28
+
29
+ # 4. Motion & Micro-interactions
30
+ - Easing: [Calibrated Cubic-Bezier หรือ Spring Physics — ห้าม linear หรือ 0.3s ease ทื่อๆ]
31
+ - States: [Hover lift, focus-visible ring, active scale 0.97]
32
+
33
+ # 5. Anti-Bloat Guardrails
34
+ - NO generic Tailwind default blues/indigos.
35
+ - NO heavy muddy black drop-shadows.
36
+ - NO cramped padding or cluttered cards.
37
+ ```
38
+
39
+ ---
40
+
41
+ ## 2. คลัง 38 สไตล์การออกแบบ (38 Production Archetypes: 30 Visual + 8 High-Signal Engineering)
42
+
43
+ ### GROUP A: Luxury, Editorial & High-Fashion (หรูหรา เหนือกาลเวลา และงานนิตยสาร)
44
+
45
+ #### 01. Quiet Luxury (Old Money Minimal)
46
+ - **Vibe:** Loro Piana, Aesop, Bottega Veneta — หรูหราไม่ตะโกน เน้นพื้นผิวธรรมชาติและช่องไฟมหาศาล
47
+ - **Palette:** Warm Alabaster (`#F6F5F2`), Cashmere Taupe (`#E6E2DD`), Deep Espresso (`#1C1B19`), Muted Bronze (`#8C7A6B`)
48
+ - **Typography:** Display: *Cormorant Garamond* (Light, italic accents) | UI: *Plus Jakarta Sans* (Tracking `+0.08em` uppercase)
49
+ - **Rules:** `0px` border-radius, zero drop shadows, `1px solid #E2DDD5` dividers, minimum `160px` vertical section padding.
50
+
51
+ #### 02. Swiss International Editorial (Neo-Grid)
52
+ - **Vibe:** พิพิธภัณฑ์ศิลปะร่วมสมัย งานกราฟิกสวิส คมกริบด้วยเส้นตารางที่มองเห็นได้จริง
53
+ - **Palette:** Stark Paper (`#FAFAFA`), Carbon Ink (`#0D0D0D`), International Orange (`#FF3300`)
54
+ - **Typography:** *Inter* หรือ *Helvetica Now* — Oversized bold headers (`tracking: -0.04em`, `line-height: 0.95`)
55
+ - **Rules:** Exposed `1px solid #0D0D0D` grid lines, sticky sidebar metadata, asymmetric masonry imagery, instant color inversion on hover.
56
+
57
+ #### 03. Dark Haute Couture (Obsidian & Champagne)
58
+ - **Vibe:** แบรนด์นาฬิกาไฮเอนด์ จิวเวลรี่ คลับส่วนตัวระดับอัลตร้าลักชัวรี
59
+ - **Palette:** Obsidian Void (`#070708`), Charcoal Velvet (`#121214`), Champagne Gold (`#D4AF37`), Muted Silver (`#9E9E9E`)
60
+ - **Typography:** Display: *Playfair Display* หรือ *Cinzel* | Body: *Manrope*
61
+ - **Rules:** Subtle radial golden glow behind hero focal points, `1px` gradient borders (`linear-gradient(135deg, rgba(212,175,55,0.4), transparent)`).
62
+
63
+ #### 04. Architectural Monolith (Brutalist Luxury)
64
+ - **Vibe:** แกลเลอรีสถาปัตยกรรม สตูดิโอออกแบบภายใน ดิบแต่ประณีตเหมือนคอนกรีตหล่อเปลือย
65
+ - **Palette:** Raw Concrete (`#D8D6D0`), Wet Slate (`#2B2B2A`), Pure Chalk (`#FFFFFF`)
66
+ - **Typography:** *Syne* หรือ *Space Grotesk* — Massive viewport-width typography (`font-size: clamp(3.5rem, 9vw, 10rem)`)
67
+ - **Rules:** Hard edges (`border-radius: 0px`), full-bleed architectural photography, fixed corner coordinates, horizontal scroll gallery.
68
+
69
+ #### 05. Japanese Zen & Wabi-Sabi Digital
70
+ - **Vibe:** โรงแรมเรียวกังหรู มัทฉะเกรดพิธีการ สกินแคร์ออร์แกนิก เน้นความสงบและสมดุลที่ไม่สมมาตร
71
+ - **Palette:** Washi Paper (`#F4F1EA`), Sumi Ink (`#22211F`), Moss Matcha (`#4A5D4E`), Terracotta Clay (`#A65E46`)
72
+ - **Typography:** *Noto Serif JP* / *Instrument Serif* paired with clean humanist sans
73
+ - **Rules:** Vertical text accents (`writing-mode: vertical-rl`), SVG paper grain overlay (`opacity: 0.04`), organic asymmetric layouts.
74
+
75
+ #### 06. Nordic Kinfolk Aesthetic
76
+ - **Vibe:** นิตยสารไลฟ์สไตล์สแกนดิเนเวีย เฟอร์นิเจอร์ไม้โอ๊ค แสงแดดยามเช้าที่นุ่มนวล
77
+ - **Palette:** Oat Milk (`#F9F6F0`), Sage Grey (`#C8CEC6`), Charcoal (`#2C302E`), Warm Sand (`#DBCBB8`)
78
+ - **Typography:** *Newsreader* (Light/Regular) + *DM Sans*
79
+ - **Rules:** Soft pill buttons (`border-radius: 9999px`), warm image filters, multi-column editorial article layouts.
80
+
81
+ ---
82
+
83
+ ### GROUP B: Next-Gen SaaS, WebApp & Productivity (เว็บแอปสมัยใหม่ Silicon Valley)
84
+
85
+ #### 07. Linear-Style Dark Mode (Precision Glow)
86
+ - **Vibe:** เครื่องมือสำหรับนักพัฒนาและสตาร์ทอัพระดับโลก คมชัด ลึกลับ มืออาชีพสูงสุด
87
+ - **Palette:** Deep Space (`#08090A`), Elevated Surface (`#111215`), Subtle Border (`rgba(255,255,255,0.08)`), Electric Indigo (`#5E6AD2`)
88
+ - **Typography:** *Inter* หรือ *Geist Sans* (`font-feature-settings: "cv02", "cv03", "cv04"`)
89
+ - **Rules:** `1px` translucent borders with top-edge specular highlight, radial mouse-tracking spotlight on cards, keyboard shortcut badges (`kbd`).
90
+
91
+ #### 08. Raycast / Vercel Monochromatic Sharp
92
+ - **Vibe:** ความเร็วสูง มินิมอลขาว-ดำ-เทา เน้นความคมของเส้นและข้อมูลเชิงเทคนิค
93
+ - **Palette:** Pure Pitch (`#000000`), Zinc Surface (`#0A0A0A`), Crisp White (`#EDEDED`), Muted Zinc (`#888888`)
94
+ - **Typography:** *Geist Sans* + *Geist Mono* for metrics, tags, and code snippets
95
+ - **Rules:** Crosshair intersection markers (`+`) at grid corners, `1px solid #222222` structural lines, zero decorative colors (status indicators use emerald/amber dots only).
96
+
97
+ #### 09. Apple VisionOS (Spatial Glassmorphism)
98
+ - **Vibe:** อินเทอร์เฟซลอยตัวในอากาศ โปร่งแสง รับแสงจากสภาพแวดล้อมรอบข้าง
99
+ - **Palette:** Translucent Glass (`rgba(255, 255, 255, 0.12)`), Specular Edge (`rgba(255, 255, 255, 0.35)`), Pure White text
100
+ - **Typography:** *SF Pro Display* / *Inter* (Medium weight for legibility over glass)
101
+ - **Rules:** Heavy `backdrop-filter: blur(40px) saturate(190%)`, squircle corners (`border-radius: 32px`), inner ring shadow (`inset 0 1px 0 0 rgba(255,255,255,0.3)`).
102
+
103
+ #### 10. Stripe-Inspired Mesh & Micro-Polish
104
+ - **Vibe:** ฟินเทคและแพลตฟอร์มระดับองค์กรที่สดใส น่าเชื่อถือ และมีรายละเอียดอินเทอร์แอคทีฟที่สมบูรณ์แบบ
105
+ - **Palette:** Crisp Slate Canvas (`#F6F9FC`), Pure White Cards (`#FFFFFF`), Deep Navy Ink (`#0A2540`), Vibrant Mesh (`#635BFF`, `#00D4B6`, `#FF7A59`)
106
+ - **Typography:** *Plus Jakarta Sans* หรือ *Sohne*
107
+ - **Rules:** Skewed diagonal section dividers, multi-layered realistic shadows, interactive live-updating UI micro-components inside hero cards.
108
+
109
+ #### 11. Bento Grid Modular Dashboard
110
+ - **Vibe:** การจัดระเบียบข้อมูลที่ซับซ้อนให้อยู่ในกล่องสี่เหลี่ยมหลายขนาดที่สอดรับกันอย่างลงตัว
111
+ - **Palette:** Off-White (`#F4F4F6`) หรือ Dark Onyx (`#0D0E11`), Surface Cards (`#FFFFFF` / `#16181D`), Accent Coral หรือ Cobalt
112
+ - **Typography:** *Outfit* หรือ *Inter* (Bold metrics, compact descriptions)
113
+ - **Rules:** CSS Grid `repeat(12, 1fr)` with `gap: 16px` หรือ `24px`, uniform `border-radius: 24px`, micro-charts bleeding to card edges.
114
+
115
+ #### 12. Fintech Private Banking (Emerald & Brass)
116
+ - **Vibe:** ความมั่งคั่ง การบริหารพอร์ตโฟลิโอระดับ VIP ความปลอดภัยและเสถียรภาพทางการเงิน
117
+ - **Palette:** Midnight Forest (`#061411`), Deep Emerald Surface (`#0B221D`), Brushed Brass (`#C5A059`), Mint Signal (`#34D399`)
118
+ - **Typography:** *Instrument Serif* (Headers) + *JetBrains Mono* (`tabular-nums` for all financial figures)
119
+ - **Rules:** Razor-sharp SVG sparkline charts with gradient area fills, glassmorphic card previews, ultra-clean data tables.
120
+
121
+ ---
122
+
123
+ ### GROUP C: 3D Web, WebGL & Immersive Experiences (งาน 3 มิติ แสงเงา และ Interactive)
124
+
125
+ #### 13. Three.js / R3F Studio Product Showcase
126
+ - **Vibe:** เว็บเปิดตัวฮาร์ดแวร์ รถยนต์ไฟฟ้า หรือแกดเจ็ตระดับเรือธงที่หมุนดูได้ 360 องศา
127
+ - **Palette:** Studio Cyclorama Grey (`#141517` radial to `#08080A`), Crisp White HUD, Anodized Metallic accents
128
+ - **Typography:** *Space Grotesk* + *Inter*
129
+ - **Rules:** Fullscreen fixed `<canvas>` (`z-index: 0`), HTML scroll sections (`z-index: 10; pointer-events: none`), PBR metallic/roughness shaders, callout pins tethered to 3D coordinates.
130
+
131
+ #### 14. Liquid Metal & Iridescent Shaders
132
+ - **Vibe:** สตูดิโอครีเอทีฟ ศิลปะดิจิทัล พื้นผิวไหลเวียนเหมือนปรอทสะท้อนแสงรุ้ง
133
+ - **Palette:** Void Black (`#030305`), Prismatic Chrome (Cyan `#00F0FF`, Magenta `#FF007A`, Violet `#7000FF`)
134
+ - **Typography:** *Syne* (ExtraBold) + *Space Mono*
135
+ - **Rules:** Custom GLSL fragment shader background reacting to cursor velocity, chromatic aberration on scroll.
136
+
137
+ #### 15. Spline-Style Soft 3D Claymorphism
138
+ - **Vibe:** เป็นมิตร สนุกสนาน น่าหยิบจับ เหมาะกับ Web3 ครีเอเตอร์ทูลส์
139
+ - **Palette:** Soft Lavender (`#F3F0FF`), Mint Cream (`#E6FCF5`), Pastel Coral (`#FFE3E3`), Deep Indigo Ink (`#1E1B4B`)
140
+ - **Typography:** *Plus Jakarta Sans* หรือ *Fredoka*
141
+ - **Rules:** Matte 3D isometric illustrations with subsurface scattering, plump buttons with soft inner shadows, bouncy spring physics.
142
+
143
+ #### 16. Cybernetic Hologram & Sci-Fi Telemetry HUD
144
+ - **Vibe:** ระบบปฏิบัติการยานอวกาศ อินเทอร์เฟซ AI ขั้นสูง โรโบติกส์
145
+ - **Palette:** Deep Radar Black (`#02060D`), Hologram Cyan (`#00F5D4`), Amber Alert (`#FFB703`), Grid Line (`rgba(0, 245, 212, 0.15)`)
146
+ - **Typography:** *Rajdhani* หรือ *Chakra Petch* (Headers) + *Share Tech Mono* (Telemetry data)
147
+ - **Rules:** Chamfered corners with `clip-path: polygon(...)`, wireframe 3D globe or mesh centerpiece, CRT scanline overlay, ticking coordinates.
148
+
149
+ #### 17. Architectural ArchViz Scrollytelling
150
+ - **Vibe:** โครงการอสังหาริมทรัพย์ระดับ Super Luxury รีสอร์ตส่วนตัว
151
+ - **Palette:** Warm Travertine (`#EAE4DC`), Bronze (`#5C4D3C`), Charcoal (`#1A1918`)
152
+ - **Typography:** *Cormorant* + *Montserrat* (Thin/Light uppercase)
153
+ - **Rules:** Smooth camera path interpolation between rooms on scroll, interactive day-to-night slider, floorplan mini-map.
154
+
155
+ #### 18. Particle Cloud & Generative Morphing
156
+ - **Vibe:** แพลตฟอร์ม AI, Big Data, Biotechnology หรือ Research Lab
157
+ - **Palette:** Deep Abyss (`#040508`), Bioluminescent Blue (`#3B82F6`), Neural Violet (`#8B5CF6`), Pure White particles
158
+ - **Typography:** *Sora* หรือ *Inter*
159
+ - **Rules:** Instanced particles morphing between geometric shapes per scroll section, additive blending (`THREE.AdditiveBlending`), depth-of-field bokeh.
160
+
161
+ ---
162
+
163
+ ### GROUP D: Tactile, Hardware & Skeuomorphic Revival (งานมีมิติ สัมผัสได้จริง)
164
+
165
+ #### 19. Teenage Engineering (Industrial Tactile)
166
+ - **Vibe:** เครื่องดนตรีสังเคราะห์ อุปกรณ์ฮาร์ดแวร์สวีเดน ปุ่มกดกลไกและป้ายกำกับวิศวกรรม
167
+ - **Palette:** Anodized Aluminium (`#E5E5E0`), Matte Charcoal (`#222222`), Signal Orange (`#FF5500`), Safety Yellow (`#FFB800`)
168
+ - **Typography:** *IBM Plex Mono* หรือ *Space Mono* (Strict grid alignment)
169
+ - **Rules:** Physical button states (`box-shadow: 0 4px 0 #111`, active `translateY(3px)`), rotary knob SVG controls, perforated speaker grille motifs.
170
+
171
+ #### 20. Neo-Neumorphism (Soft Extruded Dark Matte)
172
+ - **Vibe:** รีโมตคอนโทรลรถสปอร์ต แผงควบคุมสมาร์ทโฮมระดับไฮเอนด์ พื้นผิวยางด้านที่มีไฟ LED
173
+ - **Palette:** Matte Vulcan (`#1E2025`), Highlight Shadow (`#272A30`), Drop Shadow (`#15171B`), Neon Status LED (`#00FF88`)
174
+ - **Typography:** *DM Sans* (Medium, clean geometric)
175
+ - **Rules:** Dual extruded shadows (`8px 8px 16px #15171B, -8px -8px 16px #272A30`), depressed active states, tiny glowing LED dots.
176
+
177
+ #### 21. Analog Print & Risograph Texture
178
+ - **Vibe:** สตูดิโออิลลัสเตรชัน คาเฟ่สเปเชียลตี้ งานสิ่งพิมพ์ที่มีเสน่ห์ของเม็ดสีซ้อนทับกัน
179
+ - **Palette:** Unbleached Paper (`#F2ECE1`), Risograph Blue (`#0078BF`), Fluorescent Pink (`#FF48B0`), Soy Black (`#1A1A1A`)
180
+ - **Typography:** *Fraunces* (Chunky retro serif) + *Space Mono*
181
+ - **Rules:** `mix-blend-mode: multiply` on overlapping layers, SVG halftone dot patterns, grain noise overlay, slight stamp misregistration offset (`2px`).
182
+
183
+ #### 22. Luxury Horology (Watchmaker Precision)
184
+ - **Vibe:** กลไกนาฬิกาสวิส งานวิศวกรรมระดับไมครอน พื้นผิวโลหะปัดเสี้ยน
185
+ - **Palette:** Rhodium Dark (`#0E1013`), Rose Gold (`#C88A65`), Sapphire Blue (`#0F2537`), Super-LumiNova Green (`#76FF9B`)
186
+ - **Typography:** *Cinzel* (Engraved headers) + *JetBrains Mono* (Caliber specs)
187
+ - **Rules:** SVG radial degree ticks and guilloché patterns, brushed metal conic-gradients, precision circular progress gauges.
188
+
189
+ #### 23. Retro-Futuristic Braun / Dieter Rams
190
+ - **Vibe:** "Less, but better" — ความคลาสสิกยุค 1960s-70s ที่สะอาดตา ซื่อตรงต่อฟังก์ชัน
191
+ - **Palette:** Rams Off-White (`#EFECE6`), Bakelite Black (`#181818`), Muted Olive (`#7A7D72`), Rams Orange (`#E04F16` strictly for active toggle)
192
+ - **Typography:** *Helvetica Neue* หรือ *Akzidenz-Grotesk* (Strict flush-left alignment)
193
+ - **Rules:** Disciplined modular grid, physical-inspired toggle switches, zero gradients on canvas backgrounds.
194
+
195
+ #### 24. Glass & Prismatic Refraction
196
+ - **Vibe:** เลนส์กล้องระดับโปร คริสตัลเจียระไน งานศิลปะแสงเงาที่หักเหผ่านกระจกหนา
197
+ - **Palette:** Deep Twilight (`#090A10`), Frosted White (`rgba(255,255,255,0.07)`), Spectral Rainbow edge highlights
198
+ - **Typography:** *Outfit* (Light/Regular)
199
+ - **Rules:** Refractive borders using layered `box-shadow` with cyan/magenta/yellow 1px offsets, heavy backdrop blur with chromatic dispersion.
200
+
201
+ ---
202
+
203
+ ### GROUP E: Bold, Creative Agency & Experimental (งานครีเอทีฟ สตูดิโอ สายรางวัล)
204
+
205
+ #### 25. Neo-Brutalism (High-Craft Commercial)
206
+ - **Vibe:** Gumroad, Figma Config — สดใส กล้าหาญ เส้นขอบดำหนาและเงาแข็ง
207
+ - **Palette:** Cream Canvas (`#FFFDF8`), Pure Black Borders (`#000000`), Acid Yellow (`#FFDE00`), Electric Lavender (`#C4A1FF`)
208
+ - **Typography:** *Lexend Mega* หรือ *Cabinet Grotesk* (Black weight) + *Public Sans*
209
+ - **Rules:** Mandatory `2px solid #000000` border, hard offset shadow (`4px 4px 0px #000000`), hover translates `(-2px, -2px)` with expanded shadow (`6px 6px 0px #000000`).
210
+
211
+ #### 26. Kinetic Typography & Marquee Studio
212
+ - **Vibe:** เอเจนซี่โฆษณา สตูดิโอโปรดักชัน ตัวอักษรมีชีวิตและเคลื่อนไหวตลอดเวลา
213
+ - **Palette:** Stark Black (`#0B0B0B`), Off-White (`#F5F5F3`), Acid Lime (`#D4FF00`)
214
+ - **Typography:** *Clash Display* หรือ *Monument Extended* (Ultra-wide uppercase)
215
+ - **Rules:** Infinite horizontal marquee tickers, text skewing (`transform: skewX()`) proportional to scroll speed, magnetic circular cursor.
216
+
217
+ #### 27. Y2K Chrome & Acid Cyber
218
+ - **Vibe:** แฟชั่นสตรีทแวร์ คอนเสิร์ตอิเล็กทรอนิกส์ จัดจ้านสะดุดตา
219
+ - **Palette:** Pitch Black (`#050505`), Liquid Silver (`#E2E8F0`), Acid Green (`#00FF66`), Hyper Pink (`#FF0055`)
220
+ - **Typography:** Stretched display headers + *OCR-A* / *VT323* monospace accents
221
+ - **Rules:** Metallic chrome gradients, tribal/starburst SVG ornaments, sticker-like floating badges, glitch hover transitions.
222
+
223
+ #### 28. Biophilic & Organic Wellness
224
+ - **Vibe:** คลินิกเวชศาสตร์ชะลอวัย รีสอร์ตธรรมชาติ เส้นสายโค้งมนเหมือนสายน้ำและก้อนหิน
225
+ - **Palette:** Warm Sand (`#F5EFE6`), Terracotta (`#C87D65`), Deep Olive (`#2E3B30`), Soft Clay (`#E6D7C3`)
226
+ - **Typography:** *Fraunces* (Soft, organic curves) + *Plus Jakarta Sans*
227
+ - **Rules:** Fluid organic border-radius morphing slowly via CSS keyframes, slow breathing ambient animations (`6s ease-in-out infinite`).
228
+
229
+ #### 29. AI-Native Ambient Interface (Zero-UI)
230
+ - **Vibe:** ระบบปฏิบัติการ AI ยุคถัดไป ลดทอนปุ่มกด เหลือเพียงพื้นที่สนทนาและการ์ดผลลัพธ์
231
+ - **Palette:** Alabaster (`#F8FAFC`) หรือ Obsidian (`#090A0F`), Aurora Gradient (`#6366F1`, `#EC4899`, `#14B8A6` at `15%` blur)
232
+ - **Typography:** *Inter* (Variable weight, ultra-clean hierarchy)
233
+ - **Rules:** Floating command bar anchored at bottom-center with glowing ambient aura during thinking states, fluid staggered token streaming animations.
234
+
235
+ #### 30. Hyper-Minimalist Scrollytelling (Apple Pro Product Page)
236
+ - **Vibe:** หน้าเปิดตัวสินค้าเรือธง เล่าเรื่องทีละเฟรมอย่างทรงพลัง ดราม่า สะกดสายตา
237
+ - **Palette:** Pure OLED Black (`#000000`), Titanium Grey (`#86868B`), Pure White (`#F5F5F7`)
238
+ - **Typography:** *SF Pro Display* / *Inter* — Tight tracking (`-0.03em`), gradient text fills from white to muted grey
239
+ - **Rules:** Sticky viewport containers (`height: 300vh` outer track with `position: sticky; top: 0; height: 100vh` inner stage), macro hardware photography, scroll-linked opacity and scale transforms.
240
+
241
+ ---
242
+
243
+
244
+ ---
245
+
246
+ ### GROUP F: Mission-Critical Engineering & Operational Systems (ระบบวิศวกรรมสำรวจ ควบคุมระบบ และ HMI)
247
+
248
+ #### 31. Mission Control / High-Performance HMI (ISA-101 Standard)
249
+ - **Vibe:** ระบบควบคุมโรงกลั่น โครงข่ายไฟฟ้า หรือศูนย์เฝ้าระวังดาวเทียม ตามมาตรฐาน ISA-101
250
+ - **Palette:** Muted Greyscale Canvas (#18191B), Surface (#222428), Normal State Muted Slate (#64748B), Advisory Yellow (#F59E0B), Critical Alarm Flash (#EF4444)
251
+ - **Typography:** *Geist Mono* / *JetBrains Mono* สำหรับรหัส Alarm และตัวเลข Telemetry + *Plus Jakarta Sans* สำหรับคำอธิบาย
252
+ - **Rules:** ห้ามใช้สีสดเพื่อตกแต่งเด็ดขาด (Color Reserved for State), แยก 3 สถานะชัดเจน: Acknowledged, Unacknowledged (กระพริบช้า 1Hz), และ Suppressed; แสดงระดับความผิดปกติ (Severity 1-4) ชัดเจนโดยไม่ต้องเดา
253
+
254
+ #### 32. Geospatial Situation Awareness (GIS & Cadastre)
255
+ - **Vibe:** แพลตฟอร์มจัดการแปลงที่ดิน กรมที่ดิน และผังเมืองเชิงพื้นที่ความละเอียดสูง
256
+ - **Palette:** Deep Slate (#0F172A), Viewport Neutral (#1E293B), Cadastral Gold (#F59E0B), Vertex Cyan (#06B6D4), Boundary Emerald (#10B981)
257
+ - **Typography:** *Plus Jakarta Sans* สำหรับ Inspector Panel + *Geist Mono* สำหรับพิกัด UTM/Lat-Long (`tabular-nums`)
258
+ - **Rules:** แผนที่เป็นพื้นที่ทำงานหลัก (16:10 หรือ 100dvh Canvas), เชื่อมโยงตารางข้อมูลและ Inspector แบบ Linked Selection (คลิกแปลงในตาราง -> แผนที่ Pan/Zoom หาจุดนั้นทันที), แสดง CRS/Datum (EPSG:32647) และ Scale Bar ที่มุมขวาล่างเสมอ
259
+
260
+ #### 33. CAD Precision Workbench
261
+ - **Vibe:** ซอฟต์แวร์เขียนแบบวิศวกรรม คำนวณโครงสร้าง และรังวัดทำแผนที่ (AutoCAD/Civil 3D Web)
262
+ - **Palette:** Drafter Void (#121316), Hairline Grid (rgba(255,255,255,0.06)), Selection Blue (#3B82F6), Snap Crosshair Magenta (#EC4899)
263
+ - **Typography:** *Geist Mono* สำหรับบรรทัดป้อนคำสั่ง (Command Line) + Coordinate HUD
264
+ - **Rules:** ขยายพื้นที่ Canvas ให้กว้างที่สุด, มี Floating Command/Input Bar ด้านล่าง, Properties Inspector ตรึงขวา, แสดงโหมด Snap (Endpoint, Midpoint, Perpendicular) ด้วยสัญลักษณ์เรขาคณิตชัดเจน
265
+
266
+ #### 34. Telemetry & Signal Forensics
267
+ - **Vibe:** ระบบวิเคราะห์การสั่นสะเทือน โครงสร้างสะพานเขื่อน และการเคลื่อนตัวของแผ่นเปลือกโลก (GNSS Baseline)
268
+ - **Palette:** Pure Carbon (#0B0C0E), Signal Green (#22C55E), Baseline Drift Violet (#8B5CF6), Stale Warning Orange (#F97316)
269
+ - **Typography:** *Geist Mono* (High-Density Tabular)
270
+ - **Rules:** กราฟ Time-Series ต้องเชื่อมไทม์ไลน์กันทุกมิติ (Linked Scrubbing), มีแถบแสดงสถานะข้อมูลขาดหาย (Missing/Gap Data) และเซนเซอร์ค้าง (Stale Data), ห้ามลากเส้นต่อข้ามจุดที่ไม่มีข้อมูลโดยไม่ทำสัญลักษณ์เตือน
271
+
272
+ #### 35. Anomaly Triage & Incident Response
273
+ - **Vibe:** คอนโซลคัดกรองความผิดปกติ คลื่นรังวัดเพี้ยน หรือหมุดสำรวจเคลื่อนตัวผิดปกติ
274
+ - **Palette:** Charcoal Matrix (#111215), Severity High (#DC2626), Medium (#EA580C), Low (#2563EB)
275
+ - **Typography:** *Public Sans* + *Geist Mono*
276
+ - **Rules:** จัดลำดับความสำคัญด้วย Priority Queue (ห้ามใช้ Grid ทื่อๆ), แยกความรุนแรง (Severity) ออกจากความมั่นใจของโมเดล (Confidence), มีปุ่ม Action ชัดเจน: Acknowledge, Assign, Suppress, Resolve
277
+
278
+ #### 36. Field Survey & Offline Operations
279
+ - **Vibe:** แอปแท็บเล็ตและอุปกรณ์รังวัดสมบุกสมบันในสนามกลางแจ้ง (Leica Captivate / Trimble Access)
280
+ - **Palette:** High-Contrast Outdoor Daylight (#FFFFFF พื้นขาว / #000000 เส้นดำหนา) หรือ Dark HUD (#0A0A0C), RTK Fix Green (#15803D), Float Orange (#C2410C)
281
+ - **Typography:** Oversized *Plus Jakarta Sans* (ตัวหนังสือและปุ่มขนาดใหญ่สำหรับนิ้วมือและถุงมือ)
282
+ - **Rules:** ปุ่มกดต้องมี Touch Target >= 52px, แสดงสถานะ GNSS RTK Status (Fixed / Float / Single), ค่าความคลาดเคลื่อน (1-Sigma Hz/Vt), และคิวดาวน์โหลดข้อมูลค้างส่ง (Offline Queue Sync) ที่หัวจอเสมอ
283
+
284
+ #### 37. Spatiotemporal Change Detection
285
+ - **Vibe:** การตรวจจับการบุกรุกพื้นที่ การเปลี่ยนแปลงของตลิ่งแม่น้ำ หรือความคืบหน้างานก่อสร้างรายสัปดาห์
286
+ - **Palette:** Neutral Stage (#141518), Added Features Emerald (#10B981), Removed Crimson (#EF4444), Modified Amber (#F59E0B)
287
+ - **Typography:** *Geist Sans* + *Geist Mono*
288
+ - **Rules:** จอแสดงผลสองฝั่ง (Split View Before/After) ที่ซิงก์ตำแหน่งเมาส์และระดับการซูมแบบ 1:1 พร้อมมีแถบเลื่อนกาลเวลา (Epoch Time Slider)
289
+
290
+ #### 38. Data Provenance & Survey QA/QC
291
+ - **Vibe:** ระบบตรวจรับงานสำรวจ ตรวจสอบความถูกต้องของเส้นชั้นความสูง และรายงานค่าพิกัดตามมาตรฐานกรมที่ดิน
292
+ - **Palette:** Archival Warm Paper (#F8F6F0) หรือ Clean Slate (#0F172A), Passed Accent (#059669), Tolerance Drift (#D97706)
293
+ - **Typography:** *Fraunces* Heading + *Geist Mono* สำหรับตารางค่าพิกัดความละเอียดทศนิยม 4 ตำแหน่ง
294
+ - **Rules:** แสดงสายธารที่มาของข้อมูล (Raw Sensor -> Net Adjustment -> Final UTM), แสดงวงรีความคลาดเคลื่อน (Error Ellipse), ป้ายกำกับเครื่องมือที่ใช้รังวัด และตราประทับเวลาทางนิติวิทยาศาสตร์
295
+
296
+ ---
297
+
298
+ ## 4. The 5-Axis Decoupled Taxonomy (สถาปัตยกรรม 5 มิติอิสระ)
299
+
300
+ แทนการผูกสไตล์ทั้งหมดเป็นก้อนเดียว ให้ medesign ประกอบร่าง UI ผ่าน 5 แกนอิสระตามลักษณะภารกิจ:
301
+
302
+ | แกนที่ | มิติการออกแบบ | ตัวเลือกในระบบ | หน้าที่เชิงวิศวกรรม |
303
+ |---|---|---|---|
304
+ | **1. Operational Archetype** | ภารกิจหลักของผู้ใช้ | 38 รูปแบบ (เช่น Geospatial Situation, CAD Precision, HMI ISA-101, Luxury) | กำหนด Information Hierarchy, ลำดับความสำคัญ และชุดข้อมูลที่ต้องแสดงร่วมกัน |
305
+ | **2. Visual Language** | โทนและผิวสัมผัส (Skin) | Linear Minimal, Swiss Editorial, Bloomberg Pro Density, Cosmos Glass, ฯลฯ | กำหนด Color Tokens, รัศมีขอบ, เส้นแบ่ง และระดับความลึกของเงา |
306
+ | **3. Spatial Model** | โครงสร้างการจัดผัง (Layout) | Canvas-Centric, Bento 3-Pane Workbench, Split HUD, Master-Detail Stream | กำหนด CSS Grid Template Areas และ Responsive Breakpoints |
307
+ | **4. Motion Profile** | พฤติกรรมและฟิสิกส์โมชัน | precision (0-100ms), soft-settle (280ms), spring-settle, instant (0ms) | กำหนดความรู้สึกทางกายภาพและการเคารพ reduced-motion |
308
+ | **5. Governance Tier** | มาตรฐานการตรวจรับ (Gate) | Tier 1 Hard Invariants, Tier 2 Soft Heuristics, Tier 3 Enhancements, Tier 4 Domain Rules | ประเมินคะแนนคุณภาพและสกัดกั้น AI Slop ก่อนส่งมอบ |
309
+
310
+ ## 3. Micro-Craft Engineering Rules (ข้อบังคับสำหรับทุกสไตล์)
311
+
312
+ 1. **Concentric Radii:** $R_{\text{inner}} = \max(0, R_{\text{outer}} - \text{Padding})$ เสมอ ห้ามใช้ border-radius เดียวกันระหว่างกล่องนอกและรูป/ปุ่มข้างใน
313
+ 2. **Color Science:** ห้ามใช้สีเทาแท้ (#1a1a1a) ให้ใช้ Tinted Neutrals เจือสีแบรนด์ 3%–6% เสมอ และใช้ `linear-gradient(in oklch, ...)` เพื่อป้องกันสีหม่นตรงกลาง
314
+ 3. **Optical Typography:** ใช้ `text-wrap: balance` กับทุก Headings, ใช้ `text-wrap: pretty` กับย่อหน้า, เปิด `font-feature-settings: "cv02", "cv03", "cv04", "cv11"` และใช้ `tabular-nums` ทุกตัวเลขตาราง/ราคา
315
+ 4. **Thai-Latin Harmony:** ฟอนต์ไทยไร้หัว (`Anuphan` / `LINE Seed Sans TH` / `IBM Plex Sans Thai`) กำหนด `line-height: 1.7` และ `size-adjust: 105%` เมื่อวางคู่กับอักษรละติน
316
+ 5. **Surface & Shadow:** ใช้ Multi-layered shadows (ซ้อนเงาอย่างน้อย 3 ชั้น) และใช้ Progressive Backdrop Blur กับ Navigation Bar
317
+ 6. **3D Performance Budget:** กำหนด `devicePixelRatio = Math.min(window.devicePixelRatio, 2)` และโมเดล 3D ต้องใช้ Draco Compression `< 2MB`
@@ -0,0 +1,118 @@
1
+ # Banner Sizes & Art Direction Styles Reference
2
+
3
+ ## Complete Banner Sizes
4
+
5
+ ### Social Media
6
+ | Platform | Type | Size (px) | Aspect Ratio |
7
+ |----------|------|-----------|--------------|
8
+ | Facebook | Cover (desktop) | 820 × 312 | ~2.6:1 |
9
+ | Facebook | Cover (mobile) | 640 × 360 | ~16:9 |
10
+ | Facebook | Event cover | 1920 × 1080 | 16:9 |
11
+ | Twitter/X | Header | 1500 × 500 | 3:1 |
12
+ | Twitter/X | Ad banner | 800 × 418 | ~2:1 |
13
+ | LinkedIn | Company cover | 1128 × 191 | ~6:1 |
14
+ | LinkedIn | Personal banner | 1584 × 396 | 4:1 |
15
+ | YouTube | Channel art | 2560 × 1440 | 16:9 |
16
+ | YouTube | Safe area | 1546 × 423 | ~3.7:1 |
17
+ | Instagram | Stories | 1080 × 1920 | 9:16 |
18
+ | Instagram | Post | 1080 × 1080 | 1:1 |
19
+ | Pinterest | Pin | 1000 × 1500 | 2:3 |
20
+
21
+ ### Web / Display Ads (Google Display Network)
22
+ | Name | Size (px) | Notes |
23
+ |------|-----------|-------|
24
+ | Medium Rectangle | 300 × 250 | Highest CTR |
25
+ | Leaderboard | 728 × 90 | Top of page |
26
+ | Wide Skyscraper | 160 × 600 | Sidebar |
27
+ | Half Page | 300 × 600 | Premium |
28
+ | Large Rectangle | 336 × 280 | High performer |
29
+ | Mobile Banner | 320 × 50 | Mobile default |
30
+ | Large Mobile | 320 × 100 | Mobile hero |
31
+ | Billboard | 970 × 250 | Desktop hero |
32
+
33
+ ### Website
34
+ | Type | Size (px) |
35
+ |------|-----------|
36
+ | Full-width hero | 1920 × 600–1080 |
37
+ | Section banner | 1200 × 400 |
38
+ | Blog header | 1200 × 628 |
39
+ | Email header | 600 × 200 |
40
+
41
+ ### Print
42
+ | Type | Size |
43
+ |------|------|
44
+ | Roll-up | 850mm × 2000mm |
45
+ | Step-and-repeat | 8ft × 8ft |
46
+ | Vinyl outdoor | 6ft × 3ft |
47
+ | Trade show | 33in × 78in |
48
+
49
+ ## 22 Art Direction Styles
50
+
51
+ 1. **Minimalist** — White space dominant, single focal element, 1-2 colors, clean sans-serif
52
+ 2. **Bold Typography** — Type IS the design; oversized, expressive letterforms fill canvas
53
+ 3. **Gradient / Color Wash** — Smooth transitions, mesh gradients, chromatic blends
54
+ 4. **Photo-Based** — Full-bleed photography with text overlay; hero lifestyle imagery
55
+ 5. **Illustrated / Hand-Drawn** — Custom illustrations, bespoke icons, artisan feel
56
+ 6. **Geometric / Abstract** — Shapes, lines, grids as primary visual elements
57
+ 7. **Retro / Vintage** — Distressed textures, muted palettes, serif type, halftone dots
58
+ 8. **Glassmorphism** — Frosted glass panels, blur backdrop, subtle border glow
59
+ 9. **3D / Sculptural** — Rendered objects, depth, shadows; product-centric
60
+ 10. **Neon / Cyberpunk** — Dark backgrounds, glowing neon accents, high contrast
61
+ 11. **Duotone** — Two-color photo treatment; bold brand color overlay on image
62
+ 12. **Editorial / Magazine** — Grid-heavy layouts, pull quotes, journalistic composition
63
+ 13. **Collage / Mixed Media** — Cut-paper textures, photo cutouts, layered elements
64
+ 14. **Retro Futurism** — Space-age nostalgia, chrome, gradients, optimism
65
+ 15. **Expressive / Anti-Design** — Chaotic layouts, mixed fonts, deliberate "wrong" composition
66
+ 16. **Digi-Cute / Kawaii** — Rounded shapes, pastel gradients, pixel art, playful characters
67
+ 17. **Tactile / Sensory** — Puffy/squishy textures, hyper-real materials, embossed feel
68
+ 18. **Data / Infographic** — Stats front-and-center, charts, numbers as heroes
69
+ 19. **Dark Mode / Moody** — Near-black backgrounds, rich jewel tones, high contrast
70
+ 20. **Flat / Solid Color** — Single background color, clean icons, no gradients
71
+ 21. **Nature / Organic** — Earthy tones, botanical motifs, sustainable brand feel
72
+ 22. **Motion-Ready / Kinetic** — Designed for animation; layered elements, loopable
73
+
74
+ ## Design Principles
75
+
76
+ ### Visual Hierarchy (3-Zone Rule)
77
+ - **Top**: Logo or main value prop
78
+ - **Middle**: Supporting message + visuals
79
+ - **Bottom**: CTA (button/QR/URL)
80
+
81
+ ### Safe Zones
82
+ - Critical content in central 70-80% of canvas
83
+ - Avoid text/CTA within 50-100px of edges
84
+ - YouTube: 1546 × 423px safe area inside 2560 × 1440
85
+ - Meta/Instagram: central 80% to avoid UI chrome
86
+
87
+ ### CTA Rules
88
+ - One CTA per banner
89
+ - High contrast vs background
90
+ - Bottom-right placement (terminal area)
91
+ - Min 44px height for mobile tap targets
92
+ - Action verbs: "Get", "Start", "Download", "Claim"
93
+
94
+ ### Typography
95
+ - Max 2 typefaces per banner
96
+ - Min 16px body, ≥32px headline (digital)
97
+ - Min 4.5:1 contrast ratio
98
+ - Max 7 words/line, 3 lines for ads
99
+
100
+ ### Text-to-Image Ratio
101
+ - Ads: under 20% text (Meta penalizes)
102
+ - Social covers: 60/40 image-to-text
103
+ - Print: 70pt+ headlines for 3-5m viewing distance
104
+
105
+ ### Print Specs
106
+ - 300 DPI minimum (150 DPI for large format)
107
+ - 3-5mm bleed all sides
108
+ - CMYK color mode
109
+ - 1pt per foot viewing distance rule
110
+
111
+ ## Pinterest Research Queries
112
+
113
+ Use these search queries on Pinterest for art direction references:
114
+ - `[purpose] banner design [style]` (e.g., "social media banner minimalist")
115
+ - `[platform] cover design inspiration` (e.g., "youtube channel art design")
116
+ - `creative banner layout [industry]` (e.g., "creative banner layout tech startup")
117
+ - `[style] graphic design 2026` (e.g., "gradient graphic design 2026")
118
+ - `banner ad design [product type]` (e.g., "banner ad design saas")
@@ -0,0 +1,61 @@
1
+ ## 12. THE BLOCK LIBRARY (Contract - Implementations Land Here Iteratively)
2
+
3
+ The Reference Vocabulary (Section 10) names patterns. The Block Library implements them with real props, real motion specs, and real code sketches.
4
+
5
+ **Status:** schema defined here. Blocks will be added iteratively. Do not freelance new blocks without following this schema.
6
+
7
+ ### 12.A File Location
8
+ ```
9
+ references/blocks/
10
+ hero/
11
+ asymmetric-split.md
12
+ editorial-manifesto.md
13
+ kinetic-type.md
14
+ ...
15
+ feature/
16
+ bento-grid.md
17
+ sticky-scroll-stack.md
18
+ zig-zag.md
19
+ ...
20
+ social-proof/
21
+ pricing/
22
+ cta/
23
+ footer/
24
+ navigation/
25
+ portfolio/
26
+ transition/
27
+ ```
28
+
29
+ ### 12.B Required Frontmatter
30
+ ```yaml
31
+ ---
32
+ name: asymmetric-split-hero
33
+ category: hero
34
+ dial_compatibility:
35
+ variance: [6, 10]
36
+ motion: [3, 10]
37
+ density: [2, 5]
38
+ when_to_use: "Landing pages with one strong asset and one strong message. Default hero for SaaS, agency, premium consumer."
39
+ not_for: "Editorial / manifesto launches where the message IS the design."
40
+ stack: ["react", "next", "tailwind", "motion"]
41
+ ---
42
+ ```
43
+
44
+ ### 12.C Required Body Sections
45
+ 1. **Visual sketch** - short ASCII or description of the layout.
46
+ 2. **Props API** - the component's interface.
47
+ 3. **Code sketch** - minimal working implementation (Server Component default, Client island for motion).
48
+ 4. **Mobile fallback** - explicit collapse rules for `< 768px`.
49
+ 5. **Motion variants** - one variant per `MOTION_INTENSITY` band (1-3, 4-7, 8-10). Reduced-motion fallback explicit.
50
+ 6. **Dark-mode notes** - token strategy specific to this block.
51
+ 7. **Anti-patterns** - common ways this block goes wrong.
52
+ 8. **References** - links to real examples in production.
53
+
54
+ ### 12.D Block-Library Discipline
55
+ * One block per file. No multi-block files.
56
+ * Every block must work standalone (drop it into a page, it renders).
57
+ * Every block must pass the Pre-Flight Check (Section 14).
58
+ * Blocks that depend on a design system from Section 2.A live under `blocks/<category>/<name>--<system>.md` (e.g. `feature/bento-grid--material.md`).
59
+
60
+ ---
61
+
@@ -0,0 +1,42 @@
1
+ ---
2
+ name: brand-design-md
3
+ description: "คลังต้นแบบดีไซน์หน้าเว็บและ UI จาก 73 แบรนด์ระดับโลก (Stripe, Linear, Apple, Vercel) — ใช้เมื่อต้องการดึงโทนสี ฟอนต์ และการจัดวางเว็บระดับพรีเมียม (Production brand design tokens, HEX/HSL palettes, typography, and layout specs from 73 top tech brands)"
4
+ ---
5
+
6
+ # Brand Design System Intelligence (Awesome DESIGN.md)
7
+
8
+ This skill provides direct access to **73 production-grade `DESIGN.md`** design specifications from world-class brands, cloned from [VoltAgent/awesome-design-md](https://github.com/VoltAgent/awesome-design-md).
9
+
10
+ ## Available Brands (73 Brands)
11
+
12
+ - **Developer Tools & SaaS:** `linear.app`, `stripe`, `vercel`, `supabase`, `raycast`, `posthog`, `resend`, `sentry`, `warp`, `hashicorp`, `mintlify`, `clickhouse`, `mongodb`, `cursor`, `expo`, `sanity`, `composio`, `airtable`, `cal`, `clay`, `opencode.ai`, `lovable`
13
+ - **AI & LLM Platforms:** `claude`, `elevenlabs`, `mistral.ai`, `together.ai`, `x.ai`, `replicate`, `runwayml`, `cohere`, `minimax`, `ollama`, `voltagent`
14
+ - **Productivity & Collaboration:** `notion`, `figma`, `framer`, `webflow`, `miro`, `slack`, `superhuman`, `zapier`, `intercom`
15
+ - **Consumer & Tech Giants:** `apple`, `airbnb`, `spotify`, `uber`, `nike`, `tesla`, `spacex`, `playstation`, `meta`, `nvidia`, `pinterest`, `shopify`, `starbucks`, `ibm`, `hp`, `dell-1996`, `vodafone`
16
+ - **Auto & Luxury:** `bmw`, `bmw-m`, `ferrari`, `lamborghini`, `bugatti`, `renault`
17
+ - **Fintech & Crypto:** `coinbase`, `revolut`, `wise`, `mastercard`, `kraken`, `binance`
18
+ - **Media:** `theverge`, `wired`, `nintendo-2001`
19
+
20
+ ## How to Apply a Brand Design System
21
+
22
+ When the user asks to build or style an interface like a specific brand (e.g., *"Make it look like Linear"*, *"Use Stripe style"*, or *"Design a dark SaaS dashboard like Supabase"*):
23
+
24
+ 1. **Locate the Brand Specification:**
25
+ Primary path: `references/brand-design-tokens.md` หรือ `awesome-design-md-src/design-md/<brand_name>/DESIGN.md`
26
+ *(Example: `awesome-design-md-src/design-md/linear.app/DESIGN.md`)*
27
+
28
+ 2. **Read the Token Definitions:**
29
+ - **Colors:** Extract the exact semantic hex codes (`primary`, `canvas`, `surface-1` through `surface-4`, `hairline`, `ink`, `ink-muted`).
30
+ - **Typography:** Apply the specified font families, font sizes, line heights, and letter spacing (tracking).
31
+ - **Component Styles:** Replicate the cards, buttons, input fields, badges, and focus rings defined in the document.
32
+ - **Elevation & Lighting:** Use the subtle gradients, hairline borders (e.g. `1px solid rgba(255,255,255,0.08)`), and glow effects.
33
+
34
+ 3. **Enforce Cohesion:**
35
+ Never mix random colors with a brand's palette. Always build the CSS Variables (`:root`) directly from the `DESIGN.md` specification.
36
+
37
+ ## Updating the Collection
38
+
39
+ To pull latest brands from upstream:
40
+ ```powershell
41
+ git -C "path/to/awesome-design-md-src" pull
42
+ ```