@jaimevalasek/aioson 1.30.0 → 1.30.2

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 (93) hide show
  1. package/CHANGELOG.md +18 -0
  2. package/docs/design-previews/cognitive-core-ui-auth.html +95 -0
  3. package/docs/design-previews/cognitive-core-ui-kanban.html +231 -0
  4. package/docs/design-previews/cognitive-core-ui-list-detail.html +174 -0
  5. package/docs/design-previews/cognitive-core-ui-preview.css +1315 -0
  6. package/docs/design-previews/cognitive-core-ui-settings.html +142 -0
  7. package/docs/design-previews/cognitive-core-ui-website.html +190 -1009
  8. package/docs/design-previews/cognitive-core-ui.html +281 -463
  9. package/docs/design-previews/index.html +83 -31
  10. package/package.json +1 -1
  11. package/src/constants.js +578 -514
  12. package/template/.aioson/docs/integrations/dashboard-app-form-publish-mapping.md +183 -0
  13. package/template/.aioson/docs/play/README.md +74 -0
  14. package/template/.aioson/docs/play/agent-usage-guide.md +112 -0
  15. package/template/.aioson/docs/play/app-compatibility-guide.md +117 -0
  16. package/template/.aioson/docs/play/auth-services-and-testing.md +235 -0
  17. package/template/.aioson/docs/play/llm-data-and-bindings.md +238 -0
  18. package/template/.aioson/docs/play/manifest-and-runtime.md +267 -0
  19. package/template/.aioson/docs/play/source-map.md +104 -0
  20. package/template/.aioson/skills/design/aurora-command-ui/SKILL.md +266 -243
  21. package/template/.aioson/skills/design/aurora-command-ui/references/art-direction.md +293 -293
  22. package/template/.aioson/skills/design/aurora-command-ui/references/components.md +827 -827
  23. package/template/.aioson/skills/design/aurora-command-ui/references/dashboards.md +250 -250
  24. package/template/.aioson/skills/design/aurora-command-ui/references/design-tokens.md +585 -585
  25. package/template/.aioson/skills/design/aurora-command-ui/references/motion.md +365 -365
  26. package/template/.aioson/skills/design/aurora-command-ui/references/patterns.md +485 -482
  27. package/template/.aioson/skills/design/aurora-command-ui/references/websites.md +386 -387
  28. package/template/.aioson/skills/design/bold-editorial-ui/SKILL.md +228 -205
  29. package/template/.aioson/skills/design/bold-editorial-ui/references/art-direction.md +338 -338
  30. package/template/.aioson/skills/design/bold-editorial-ui/references/components.md +977 -977
  31. package/template/.aioson/skills/design/bold-editorial-ui/references/dashboards.md +218 -218
  32. package/template/.aioson/skills/design/bold-editorial-ui/references/design-tokens.md +326 -326
  33. package/template/.aioson/skills/design/bold-editorial-ui/references/motion.md +461 -461
  34. package/template/.aioson/skills/design/bold-editorial-ui/references/patterns.md +293 -293
  35. package/template/.aioson/skills/design/bold-editorial-ui/references/websites.md +352 -352
  36. package/template/.aioson/skills/design/clean-saas-ui/SKILL.md +233 -210
  37. package/template/.aioson/skills/design/clean-saas-ui/references/art-direction.md +319 -319
  38. package/template/.aioson/skills/design/clean-saas-ui/references/components.md +365 -365
  39. package/template/.aioson/skills/design/clean-saas-ui/references/dashboards.md +196 -196
  40. package/template/.aioson/skills/design/clean-saas-ui/references/design-tokens.md +244 -244
  41. package/template/.aioson/skills/design/clean-saas-ui/references/motion.md +235 -235
  42. package/template/.aioson/skills/design/clean-saas-ui/references/patterns.md +215 -215
  43. package/template/.aioson/skills/design/clean-saas-ui/references/websites.md +295 -295
  44. package/template/.aioson/skills/design/cognitive-core-ui/SKILL.md +239 -203
  45. package/template/.aioson/skills/design/cognitive-core-ui/references/art-direction.md +339 -339
  46. package/template/.aioson/skills/design/cognitive-core-ui/references/components.md +417 -407
  47. package/template/.aioson/skills/design/cognitive-core-ui/references/dashboards.md +289 -272
  48. package/template/.aioson/skills/design/cognitive-core-ui/references/design-tokens.md +525 -524
  49. package/template/.aioson/skills/design/cognitive-core-ui/references/motion.md +279 -279
  50. package/template/.aioson/skills/design/cognitive-core-ui/references/patterns.md +355 -289
  51. package/template/.aioson/skills/design/cognitive-core-ui/references/websites.md +443 -437
  52. package/template/.aioson/skills/design/glassmorphism-ui/SKILL.md +245 -222
  53. package/template/.aioson/skills/design/glassmorphism-ui/references/art-direction.md +159 -159
  54. package/template/.aioson/skills/design/glassmorphism-ui/references/components.md +498 -498
  55. package/template/.aioson/skills/design/glassmorphism-ui/references/dashboards.md +236 -236
  56. package/template/.aioson/skills/design/glassmorphism-ui/references/design-tokens.md +274 -274
  57. package/template/.aioson/skills/design/glassmorphism-ui/references/motion.md +355 -355
  58. package/template/.aioson/skills/design/glassmorphism-ui/references/patterns.md +198 -198
  59. package/template/.aioson/skills/design/glassmorphism-ui/references/websites.md +307 -307
  60. package/template/.aioson/skills/design/interface-design/SKILL.md +68 -47
  61. package/template/.aioson/skills/design/interface-design/references/components-and-states.md +105 -105
  62. package/template/.aioson/skills/design/interface-design/references/design-directions.md +101 -101
  63. package/template/.aioson/skills/design/interface-design/references/handoff-and-quality.md +92 -71
  64. package/template/.aioson/skills/design/interface-design/references/intent-and-domain.md +74 -74
  65. package/template/.aioson/skills/design/interface-design/references/tokens-and-depth.md +173 -173
  66. package/template/.aioson/skills/design/neo-brutalist-ui/SKILL.md +236 -213
  67. package/template/.aioson/skills/design/neo-brutalist-ui/references/art-direction.md +228 -228
  68. package/template/.aioson/skills/design/neo-brutalist-ui/references/components.md +855 -855
  69. package/template/.aioson/skills/design/neo-brutalist-ui/references/dashboards.md +334 -334
  70. package/template/.aioson/skills/design/neo-brutalist-ui/references/design-tokens.md +342 -342
  71. package/template/.aioson/skills/design/neo-brutalist-ui/references/motion.md +286 -286
  72. package/template/.aioson/skills/design/neo-brutalist-ui/references/patterns.md +458 -458
  73. package/template/.aioson/skills/design/neo-brutalist-ui/references/websites.md +723 -723
  74. package/template/.aioson/skills/design/premium-command-center-ui/SKILL.md +83 -62
  75. package/template/.aioson/skills/design/premium-command-center-ui/references/operations.md +74 -74
  76. package/template/.aioson/skills/design/premium-command-center-ui/references/patterns.md +116 -116
  77. package/template/.aioson/skills/design/premium-command-center-ui/references/validation.md +47 -47
  78. package/template/.aioson/skills/design/premium-command-center-ui/references/visual-system.md +215 -215
  79. package/template/.aioson/skills/design/pt.squarespace.com/.skill-meta.json +31 -31
  80. package/template/.aioson/skills/design/pt.squarespace.com/SKILL.md +94 -66
  81. package/template/.aioson/skills/design/pt.squarespace.com/references/components.md +366 -366
  82. package/template/.aioson/skills/design/pt.squarespace.com/references/design-tokens.md +150 -150
  83. package/template/.aioson/skills/design/pt.squarespace.com/references/motion.md +270 -270
  84. package/template/.aioson/skills/design/pt.squarespace.com/references/patterns.md +189 -189
  85. package/template/.aioson/skills/design/pt.squarespace.com/references/websites.md +161 -161
  86. package/template/.aioson/skills/design/warm-craft-ui/SKILL.md +232 -209
  87. package/template/.aioson/skills/design/warm-craft-ui/references/art-direction.md +324 -324
  88. package/template/.aioson/skills/design/warm-craft-ui/references/components.md +508 -508
  89. package/template/.aioson/skills/design/warm-craft-ui/references/dashboards.md +223 -223
  90. package/template/.aioson/skills/design/warm-craft-ui/references/design-tokens.md +374 -374
  91. package/template/.aioson/skills/design/warm-craft-ui/references/motion.md +356 -356
  92. package/template/.aioson/skills/design/warm-craft-ui/references/patterns.md +288 -288
  93. package/template/.aioson/skills/design/warm-craft-ui/references/websites.md +289 -289
@@ -1,352 +1,352 @@
1
- # Website Layouts — Bold Editorial UI
2
-
3
- Composition guides for landing pages, product pages, and marketing sites. Uses tokens from `design-tokens.md` and components from `components.md`.
4
-
5
- ---
6
-
7
- ## General Website Rules
8
-
9
- 1. **Typography dominates.** The headline is the hero. If the design relies on an image to carry impact, the type is not working hard enough.
10
- 2. **Dark default, light as contrast.** Marketing pages use near-black backgrounds. Light sections feel like spotlights — use them intentionally.
11
- 3. **Editorial pacing.** Every page must follow a rhythm: dense impact → white space → impact → pause. Never four identical sections.
12
- 4. **Mono captions everywhere.** Every overline, category, date, and section label uses `var(--font-mono)` + uppercase + wide tracking.
13
- 5. **One accent moment per viewport.** The CTA button or the one key visual element gets `--shadow-glow`. Nothing else.
14
- 6. **Real copy.** No Lorem ipsum. Headlines must be uncomfortable to read — not clever taglines, but statements that mean something.
15
- 7. **No warm aesthetics.** No rounded corners above `radius-xl`, no serif fonts, no warm beige backgrounds.
16
-
17
- ---
18
-
19
- ## Navigation
20
-
21
- ```
22
- STICKY HEADER
23
- height: 64px
24
- background: rgba(10, 10, 10, 0.85) /* --bg-base + opacity */
25
- backdrop-filter: blur(12px)
26
- border-bottom: 1px solid var(--border-subtle)
27
- position: sticky; top: 0
28
- z-index: var(--z-sticky)
29
- padding: 0 var(--space-8)
30
- display: flex; align-items: center; justify-content: space-between
31
-
32
- Logo (left):
33
- font-display, weight-bold, text-lg, text-heading, no decoration
34
-
35
- Nav links (center):
36
- font-body, text-sm, weight-medium, text-secondary
37
- hover: text-heading
38
- active: text-heading + 1px solid border-accent bottom (optional)
39
-
40
- CTA (right):
41
- .btn-primary, compact height 36px
42
- OR .btn-ghost + .btn-primary side by side
43
-
44
- MOBILE (< 768px)
45
- Hamburger icon → full-screen overlay menu
46
- background: var(--bg-base) at 0.96 opacity
47
- Nav items stacked vertically, text-xl, font-display
48
- CTA at bottom
49
- Close button top-right
50
- ```
51
-
52
- ---
53
-
54
- ## Hero Patterns
55
-
56
- ### Pattern A — Statement Hero
57
-
58
- ```
59
- +-----------------------------------------------------------+
60
- | BACKGROUND: var(--bg-base) or var(--bg-void) |
61
- | Optional: grain texture overlay at 3% opacity |
62
- | |
63
- | MONO OVERLINE (centered or left) |
64
- | "INTRODUCING / PRODUCT — 2025" in font-mono |
65
- | |
66
- | HEADLINE |
67
- | font-display, text-5xl, weight-bold |
68
- | letter-spacing: var(--tracking-tighter) |
69
- | line-height: var(--leading-tight) |
70
- | max-width: 800px, text-align: left or center |
71
- | color: var(--text-heading) |
72
- | |
73
- | SUBTITLE |
74
- | font-body, text-lg, text-primary, max-width: 560px |
75
- | |
76
- | [CTA Hero Button] [Ghost Button — optional] |
77
- | .btn-hero with shadow-glow |
78
- | |
79
- | SOCIAL PROOF (optional) |
80
- | "Used by engineers at [logos]" — mono text-xs |
81
- | |
82
- +-----------------------------------------------------------+
83
- ```
84
-
85
- Use when: the message IS the product. Vision, manifesto, or pure product statement. No visual needed.
86
-
87
- ### Pattern B — Product Theater Hero
88
-
89
- ```
90
- +---------------------------+---------------------------+
91
- | | |
92
- | OVERLINE (mono) | PRODUCT VISUAL |
93
- | | screenshot / terminal |
94
- | HEADLINE | floating at 1-2deg tilt |
95
- | text-4xl or text-5xl | border: --border-medium |
96
- | font-display, bold | radius: --radius-lg |
97
- | | shadow: --shadow-xl |
98
- | SUBTITLE | + shadow-glow |
99
- | text-lg, text-primary | |
100
- | max-width: 480px | gradient radial behind |
101
- | | the product (subtle |
102
- | [Hero CTA] | spotlight effect) |
103
- | | |
104
- | MONO TRUST LINES | |
105
- | version badge + metrics | |
106
- | | |
107
- +---------------------------+---------------------------+
108
- ```
109
-
110
- Use when: product has a strong visual — UI, terminal, API, diagram. Let the product be the proof.
111
-
112
- ### Pattern C — Split Cinematic Hero
113
-
114
- ```
115
- +-------------------+-----------------------------------+
116
- | | |
117
- | HEADLINE | HIGH-CONTRAST VISUAL |
118
- | text-5xl+ | Full-bleed image or video |
119
- | bold, white | Dark overlay gradient |
120
- | | (rgba(10,10,10,0.4)) |
121
- | SUBTITLE | |
122
- | | OR: Abstract dark illustration |
123
- | [CTA] | code aesthetic, data visualization|
124
- | | |
125
- +-------------------+-----------------------------------+
126
- ```
127
-
128
- Use when: brand-heavy experience, premium product, emotional product story.
129
-
130
- ### Pattern D — Full-Bleed Hero
131
-
132
- ```
133
- +-----------------------------------------------------------+
134
- | FULL-VIEWPORT background |
135
- | Video or high-contrast dark photography |
136
- | Gradient overlay: rgba(10,10,10,0.55) uniform |
137
- | OR darker at bottom — text area |
138
- | |
139
- | Centered content, max-width: var(--content-sm) |
140
- | |
141
- | MONO OVERLINE |
142
- | HEADLINE — white, text-5xl, centered |
143
- | [CTA — accent, centered] |
144
- | |
145
- | SCROLL INDICATOR (bottom center) |
146
- | animated chevron or line pulsing down |
147
- | |
148
- +-----------------------------------------------------------+
149
- ```
150
-
151
- Use when: cinematic, atmospheric, experience-first products.
152
-
153
- ---
154
-
155
- ## Section Patterns
156
-
157
- ### Feature Alternating
158
-
159
- ```
160
- SECTION 1 (visual left, text right)
161
- +---------------------------+---------------------------+
162
- | [Product screenshot | MONO OVERLINE |
163
- | or illustration | DISPLAY TITLE (text-2xl) |
164
- | radius-lg, shadow-lg] | DESCRIPTION |
165
- | | BULLET POINTS or LIST |
166
- | | [CTA link →] |
167
- +---------------------------+---------------------------+
168
-
169
- SECTION 2 (text left, visual right)
170
- +---------------------------+---------------------------+
171
- | MONO OVERLINE | [Product screenshot |
172
- | DISPLAY TITLE | different angle] |
173
- | DESCRIPTION | |
174
- +---------------------------+---------------------------+
175
- ```
176
-
177
- Rules:
178
- - Always alternate sides.
179
- - Product visuals get `radius-lg` + `shadow-lg`. Never flat or borderless.
180
- - Vertical padding between sections: `var(--space-24)` minimum.
181
-
182
- ---
183
-
184
- ### Metrics Strip
185
-
186
- ```
187
- HORIZONTAL STRIP (full width, bg-surface card)
188
- 3-5 metrics side by side, divided by 1px border-subtle
189
-
190
- Each metric:
191
- MONO LABEL (text-xs, text-muted, uppercase, tracking-widest)
192
- DISPLAY NUMBER (font-display, text-4xl, weight-bold, text-heading)
193
- TREND (mono text-xs, semantic color)
194
-
195
- padding: var(--space-8) var(--space-12)
196
- border: 1px solid var(--border-subtle)
197
- radius: var(--radius-lg)
198
- shadow: var(--shadow-sm)
199
- ```
200
-
201
- Rules:
202
- - Numbers animate on scroll entry (see `motion.md` — Counter Roll).
203
- - No individual card frames around each metric — one unified strip.
204
-
205
- ---
206
-
207
- ### Testimonial Editorial
208
-
209
- ```
210
- PULL QUOTE (centered, max-width: 680px)
211
- Opening quote mark: oversized, accent color, font-display
212
- QUOTE TEXT: font-display, text-2xl, italic, text-heading, line-height: var(--leading-snug)
213
-
214
- ATTRIBUTION (below quote)
215
- avatar (40px, radius-md) + name (font-body, weight-semibold) + title + company
216
- font: text-sm, text-secondary
217
-
218
- BACKGROUND: alternating — if page is dark, testimonial section is light (white spotlight moment)
219
- ```
220
-
221
- Rules:
222
- - One testimonial section per page. Make it count.
223
- - Pull quote is strongly preferred over card grid — this is editorial, not social media.
224
- - Never a gray box. Either dramatic editorial treatment or nothing.
225
-
226
- ---
227
-
228
- ### Case Study Cards
229
-
230
- ```
231
- GRID (2 columns on desktop)
232
- Each card:
233
- background: var(--bg-surface)
234
- border: 1px solid var(--border-subtle)
235
- radius: var(--radius-lg)
236
- overflow: hidden
237
-
238
- IMAGE (top, aspect-ratio: 4/3, object-fit: cover)
239
- On hover: image scale(1.03), dark overlay fades in with project details
240
-
241
- BODY (padding var(--space-6))
242
- MONO CAPTION — year + category
243
- TITLE — font-display, text-xl, weight-bold
244
- DESCRIPTION — font-body, text-sm, text-secondary
245
- ```
246
-
247
- ---
248
-
249
- ### Logo Cloud
250
-
251
- ```
252
- HORIZONTAL ROW
253
- "TRUSTED BY TEAMS AT" — mono label, text-xs, text-muted, uppercase
254
- Logos: monochrome white (dark theme) or black (light theme), opacity 0.5
255
- Hover: opacity 1, transition var(--transition-base)
256
- Container: bg-surface, border-y: var(--border-subtle), padding var(--space-6) 0
257
- ```
258
-
259
- ---
260
-
261
- ### Pricing Section
262
-
263
- ```
264
- SECTION HEADER (centered)
265
- mono overline: "PRICING"
266
- display title: "Simple, transparent." (font-display, text-3xl)
267
- subtitle: font-body, text-lg, text-secondary
268
-
269
- PRICING CARDS (2-3 columns, centered grid)
270
- Each card:
271
- background: var(--bg-surface)
272
- border: 1px solid var(--border-subtle)
273
- radius: var(--radius-lg)
274
- padding: var(--space-8)
275
-
276
- PLAN NAME: mono, text-sm, uppercase, tracking-widest, text-secondary
277
- PRICE: font-display, text-4xl, weight-bold, text-heading
278
- PER PERIOD: mono, text-xs, text-muted
279
- FEATURE LIST: body text-sm, checkmark icons in semantic-green
280
- CTA: .btn-primary or .btn-secondary (full width)
281
-
282
- Featured card:
283
- border: 1px solid var(--accent)
284
- shadow: var(--shadow-lg) + var(--shadow-glow)
285
- "RECOMMENDED" mono badge above card (rotated -2deg optional)
286
- ```
287
-
288
- ---
289
-
290
- ### CTA Section (pre-footer)
291
-
292
- ```
293
- BACKGROUND: alternating from page (if page dark → section light; if page light → section dark)
294
- MAX-WIDTH: var(--content-lg), centered, margin auto
295
- PADDING: var(--space-20) var(--space-8)
296
-
297
- MONO OVERLINE: "START TODAY"
298
- DISPLAY TITLE: font-display, text-3xl, weight-bold
299
- SUBTITLE: font-body, text-lg, text-secondary, max-width: 480px
300
- BUTTONS: [Hero CTA] + [Ghost optional]
301
- ```
302
-
303
- ---
304
-
305
- ## Footer
306
-
307
- ```
308
- BACKGROUND: var(--bg-void)
309
- BORDER-TOP: 1px solid var(--border-subtle)
310
- PADDING: var(--space-16) var(--space-8) var(--space-8)
311
-
312
- LAYOUT (4 columns on desktop, stacked on mobile)
313
- Column 1: Logo + tagline (font-display, text-sm, italic, text-secondary) + social icons
314
- Columns 2-4: Link groups
315
-
316
- Link group title:
317
- font-family: var(--font-mono)
318
- font-size: var(--text-xs)
319
- font-weight: var(--weight-medium)
320
- letter-spacing: var(--tracking-widest)
321
- text-transform: uppercase
322
- color: var(--text-muted)
323
- margin-bottom: var(--space-4)
324
-
325
- Links:
326
- font: var(--font-body), var(--text-sm), var(--text-secondary)
327
- hover: var(--text-heading)
328
- line-height: 2
329
-
330
- BOTTOM BAR
331
- border-top: 1px solid var(--border-subtle)
332
- margin-top: var(--space-8)
333
- padding-top: var(--space-6)
334
- display: flex; justify-content: space-between
335
- copyright: font-mono, text-xs, text-muted, uppercase
336
- legal links: font-body, text-xs, text-secondary
337
- ```
338
-
339
- ---
340
-
341
- ## Anti-Patterns — Never Do This
342
-
343
- 1. **Generic dark landing page**: gradient mesh background, centered headline, abstract 3D blob in the background. The visual signature of AI-generated zero-personality marketing.
344
- 2. **Gradient mesh backgrounds**: `#8B5CF6` → `#EC4899` → `#EF4444` in an mesh. This is explicitly NOT Bold Editorial.
345
- 3. **Purple or blue as accent**: this system is red-orange. Blue and purple belong to Glassmorphism and Clean SaaS.
346
- 4. **Rounded pill buttons everywhere**: hero buttons use `radius-md` (6px). Only secondary badges are pills. Pill-everything belongs to Warm Craft.
347
- 5. **Serif fonts**: Source Serif or any editorial serif is Warm Craft territory. Bold Editorial uses display sans only.
348
- 6. **Card grid features with icon + 1-line description**: lazy and undifferentiated. Use alternating features or full feature sections instead.
349
- 7. **Equal-size section layout**: four sections all the same height and width. Editorial rhythm requires scale variation.
350
- 8. **Emoji as decoration**: never as icons, never as visual anchors.
351
- 9. **Stock illustrations**: geometric or hand-drawn generic illustrations. Product screenshots, code, or nothing.
352
- 10. **Warm beige backgrounds**: `#FDF8F0` or similar. That's Warm Craft. Bold Editorial uses off-white `#FAFAF7` (light) or near-black (dark).
1
+ # Website Layouts — Bold Editorial UI
2
+
3
+ Composition guides for landing pages, product pages, and marketing sites. Uses tokens from `design-tokens.md` and components from `components.md`.
4
+
5
+ ---
6
+
7
+ ## General Website Rules
8
+
9
+ 1. **Typography dominates.** The headline is the hero. If the design relies on an image to carry impact, the type is not working hard enough.
10
+ 2. **Dark default, light as contrast.** Marketing pages use near-black backgrounds. Light sections feel like spotlights — use them intentionally.
11
+ 3. **Editorial pacing.** Every page must follow a rhythm: dense impact → white space → impact → pause. Never four identical sections.
12
+ 4. **Mono captions everywhere.** Every overline, category, date, and section label uses `var(--font-mono)` + uppercase + wide tracking.
13
+ 5. **One accent moment per viewport.** The CTA button or the one key visual element gets `--shadow-glow`. Nothing else.
14
+ 6. **Real copy.** No Lorem ipsum. Headlines must be uncomfortable to read — not clever taglines, but statements that mean something.
15
+ 7. **No warm aesthetics.** No rounded corners above `radius-xl`, no serif fonts, no warm beige backgrounds.
16
+
17
+ ---
18
+
19
+ ## Navigation
20
+
21
+ ```
22
+ STICKY HEADER
23
+ height: 64px
24
+ background: rgba(10, 10, 10, 0.85) /* --bg-base + opacity */
25
+ backdrop-filter: blur(12px)
26
+ border-bottom: 1px solid var(--border-subtle)
27
+ position: sticky; top: 0
28
+ z-index: var(--z-sticky)
29
+ padding: 0 var(--space-8)
30
+ display: flex; align-items: center; justify-content: space-between
31
+
32
+ Logo (left):
33
+ font-display, weight-bold, text-lg, text-heading, no decoration
34
+
35
+ Nav links (center):
36
+ font-body, text-sm, weight-medium, text-secondary
37
+ hover: text-heading
38
+ active: text-heading + 1px solid border-accent bottom (optional)
39
+
40
+ CTA (right):
41
+ .btn-primary, compact height 36px
42
+ OR .btn-ghost + .btn-primary side by side
43
+
44
+ MOBILE (< 768px)
45
+ Hamburger icon → full-screen overlay menu
46
+ background: var(--bg-base) at 0.96 opacity
47
+ Nav items stacked vertically, text-xl, font-display
48
+ CTA at bottom
49
+ Close button top-right
50
+ ```
51
+
52
+ ---
53
+
54
+ ## Hero Patterns
55
+
56
+ ### Pattern A — Statement Hero
57
+
58
+ ```
59
+ +-----------------------------------------------------------+
60
+ | BACKGROUND: var(--bg-base) or var(--bg-void) |
61
+ | Optional: grain texture overlay at 3% opacity |
62
+ | |
63
+ | MONO OVERLINE (centered or left) |
64
+ | "INTRODUCING / PRODUCT — 2025" in font-mono |
65
+ | |
66
+ | HEADLINE |
67
+ | font-display, text-5xl, weight-bold |
68
+ | letter-spacing: var(--tracking-tighter) |
69
+ | line-height: var(--leading-tight) |
70
+ | max-width: 800px, text-align: left or center |
71
+ | color: var(--text-heading) |
72
+ | |
73
+ | SUBTITLE |
74
+ | font-body, text-lg, text-primary, max-width: 560px |
75
+ | |
76
+ | [CTA Hero Button] [Ghost Button — optional] |
77
+ | .btn-hero with shadow-glow |
78
+ | |
79
+ | SOCIAL PROOF (optional) |
80
+ | "Used by engineers at [logos]" — mono text-xs |
81
+ | |
82
+ +-----------------------------------------------------------+
83
+ ```
84
+
85
+ Use when: the message IS the product. Vision, manifesto, or pure product statement. No visual needed.
86
+
87
+ ### Pattern B — Product Theater Hero
88
+
89
+ ```
90
+ +---------------------------+---------------------------+
91
+ | | |
92
+ | OVERLINE (mono) | PRODUCT VISUAL |
93
+ | | screenshot / terminal |
94
+ | HEADLINE | floating at 1-2deg tilt |
95
+ | text-4xl or text-5xl | border: --border-medium |
96
+ | font-display, bold | radius: --radius-lg |
97
+ | | shadow: --shadow-xl |
98
+ | SUBTITLE | + shadow-glow |
99
+ | text-lg, text-primary | |
100
+ | max-width: 480px | gradient radial behind |
101
+ | | the product (subtle |
102
+ | [Hero CTA] | spotlight effect) |
103
+ | | |
104
+ | MONO TRUST LINES | |
105
+ | version badge + metrics | |
106
+ | | |
107
+ +---------------------------+---------------------------+
108
+ ```
109
+
110
+ Use when: product has a strong visual — UI, terminal, API, diagram. Let the product be the proof.
111
+
112
+ ### Pattern C — Split Cinematic Hero
113
+
114
+ ```
115
+ +-------------------+-----------------------------------+
116
+ | | |
117
+ | HEADLINE | HIGH-CONTRAST VISUAL |
118
+ | text-5xl+ | Full-bleed image or video |
119
+ | bold, white | Dark overlay gradient |
120
+ | | (rgba(10,10,10,0.4)) |
121
+ | SUBTITLE | |
122
+ | | OR: Abstract dark illustration |
123
+ | [CTA] | code aesthetic, data visualization|
124
+ | | |
125
+ +-------------------+-----------------------------------+
126
+ ```
127
+
128
+ Use when: brand-heavy experience, premium product, emotional product story.
129
+
130
+ ### Pattern D — Full-Bleed Hero
131
+
132
+ ```
133
+ +-----------------------------------------------------------+
134
+ | FULL-VIEWPORT background |
135
+ | Video or high-contrast dark photography |
136
+ | Gradient overlay: rgba(10,10,10,0.55) uniform |
137
+ | OR darker at bottom — text area |
138
+ | |
139
+ | Centered content, max-width: var(--content-sm) |
140
+ | |
141
+ | MONO OVERLINE |
142
+ | HEADLINE — white, text-5xl, centered |
143
+ | [CTA — accent, centered] |
144
+ | |
145
+ | SCROLL INDICATOR (bottom center) |
146
+ | animated chevron or line pulsing down |
147
+ | |
148
+ +-----------------------------------------------------------+
149
+ ```
150
+
151
+ Use when: cinematic, atmospheric, experience-first products.
152
+
153
+ ---
154
+
155
+ ## Section Patterns
156
+
157
+ ### Feature Alternating
158
+
159
+ ```
160
+ SECTION 1 (visual left, text right)
161
+ +---------------------------+---------------------------+
162
+ | [Product screenshot | MONO OVERLINE |
163
+ | or illustration | DISPLAY TITLE (text-2xl) |
164
+ | radius-lg, shadow-lg] | DESCRIPTION |
165
+ | | BULLET POINTS or LIST |
166
+ | | [CTA link →] |
167
+ +---------------------------+---------------------------+
168
+
169
+ SECTION 2 (text left, visual right)
170
+ +---------------------------+---------------------------+
171
+ | MONO OVERLINE | [Product screenshot |
172
+ | DISPLAY TITLE | different angle] |
173
+ | DESCRIPTION | |
174
+ +---------------------------+---------------------------+
175
+ ```
176
+
177
+ Rules:
178
+ - Always alternate sides.
179
+ - Product visuals get `radius-lg` + `shadow-lg`. Never flat or borderless.
180
+ - Vertical padding between sections: `var(--space-24)` minimum.
181
+
182
+ ---
183
+
184
+ ### Metrics Strip
185
+
186
+ ```
187
+ HORIZONTAL STRIP (full width, bg-surface card)
188
+ 3-5 metrics side by side, divided by 1px border-subtle
189
+
190
+ Each metric:
191
+ MONO LABEL (text-xs, text-muted, uppercase, tracking-widest)
192
+ DISPLAY NUMBER (font-display, text-4xl, weight-bold, text-heading)
193
+ TREND (mono text-xs, semantic color)
194
+
195
+ padding: var(--space-8) var(--space-12)
196
+ border: 1px solid var(--border-subtle)
197
+ radius: var(--radius-lg)
198
+ shadow: var(--shadow-sm)
199
+ ```
200
+
201
+ Rules:
202
+ - Numbers animate on scroll entry (see `motion.md` — Counter Roll).
203
+ - No individual card frames around each metric — one unified strip.
204
+
205
+ ---
206
+
207
+ ### Testimonial Editorial
208
+
209
+ ```
210
+ PULL QUOTE (centered, max-width: 680px)
211
+ Opening quote mark: oversized, accent color, font-display
212
+ QUOTE TEXT: font-display, text-2xl, italic, text-heading, line-height: var(--leading-snug)
213
+
214
+ ATTRIBUTION (below quote)
215
+ avatar (40px, radius-md) + name (font-body, weight-semibold) + title + company
216
+ font: text-sm, text-secondary
217
+
218
+ BACKGROUND: alternating — if page is dark, testimonial section is light (white spotlight moment)
219
+ ```
220
+
221
+ Rules:
222
+ - One testimonial section per page. Make it count.
223
+ - Pull quote is strongly preferred over card grid — this is editorial, not social media.
224
+ - Never a gray box. Either dramatic editorial treatment or nothing.
225
+
226
+ ---
227
+
228
+ ### Case Study Cards
229
+
230
+ ```
231
+ GRID (2 columns on desktop)
232
+ Each card:
233
+ background: var(--bg-surface)
234
+ border: 1px solid var(--border-subtle)
235
+ radius: var(--radius-lg)
236
+ overflow: hidden
237
+
238
+ IMAGE (top, aspect-ratio: 4/3, object-fit: cover)
239
+ On hover: image scale(1.03), dark overlay fades in with project details
240
+
241
+ BODY (padding var(--space-6))
242
+ MONO CAPTION — year + category
243
+ TITLE — font-display, text-xl, weight-bold
244
+ DESCRIPTION — font-body, text-sm, text-secondary
245
+ ```
246
+
247
+ ---
248
+
249
+ ### Logo Cloud
250
+
251
+ ```
252
+ HORIZONTAL ROW
253
+ "TRUSTED BY TEAMS AT" — mono label, text-xs, text-muted, uppercase
254
+ Logos: monochrome white (dark theme) or black (light theme), opacity 0.5
255
+ Hover: opacity 1, transition var(--transition-base)
256
+ Container: bg-surface, border-y: var(--border-subtle), padding var(--space-6) 0
257
+ ```
258
+
259
+ ---
260
+
261
+ ### Pricing Section
262
+
263
+ ```
264
+ SECTION HEADER (centered)
265
+ mono overline: "PRICING"
266
+ display title: "Simple, transparent." (font-display, text-3xl)
267
+ subtitle: font-body, text-lg, text-secondary
268
+
269
+ PRICING CARDS (2-3 columns, centered grid)
270
+ Each card:
271
+ background: var(--bg-surface)
272
+ border: 1px solid var(--border-subtle)
273
+ radius: var(--radius-lg)
274
+ padding: var(--space-8)
275
+
276
+ PLAN NAME: mono, text-sm, uppercase, tracking-widest, text-secondary
277
+ PRICE: font-display, text-4xl, weight-bold, text-heading
278
+ PER PERIOD: mono, text-xs, text-muted
279
+ FEATURE LIST: body text-sm, checkmark icons in semantic-green
280
+ CTA: .btn-primary or .btn-secondary (full width)
281
+
282
+ Featured card:
283
+ border: 1px solid var(--accent)
284
+ shadow: var(--shadow-lg) + var(--shadow-glow)
285
+ "RECOMMENDED" mono badge above card (rotated -2deg optional)
286
+ ```
287
+
288
+ ---
289
+
290
+ ### CTA Section (pre-footer)
291
+
292
+ ```
293
+ BACKGROUND: alternating from page (if page dark → section light; if page light → section dark)
294
+ MAX-WIDTH: var(--content-lg), centered, margin auto
295
+ PADDING: var(--space-20) var(--space-8)
296
+
297
+ MONO OVERLINE: "START TODAY"
298
+ DISPLAY TITLE: font-display, text-3xl, weight-bold
299
+ SUBTITLE: font-body, text-lg, text-secondary, max-width: 480px
300
+ BUTTONS: [Hero CTA] + [Ghost optional]
301
+ ```
302
+
303
+ ---
304
+
305
+ ## Footer
306
+
307
+ ```
308
+ BACKGROUND: var(--bg-void)
309
+ BORDER-TOP: 1px solid var(--border-subtle)
310
+ PADDING: var(--space-16) var(--space-8) var(--space-8)
311
+
312
+ LAYOUT (4 columns on desktop, stacked on mobile)
313
+ Column 1: Logo + tagline (font-display, text-sm, italic, text-secondary) + social icons
314
+ Columns 2-4: Link groups
315
+
316
+ Link group title:
317
+ font-family: var(--font-mono)
318
+ font-size: var(--text-xs)
319
+ font-weight: var(--weight-medium)
320
+ letter-spacing: var(--tracking-widest)
321
+ text-transform: uppercase
322
+ color: var(--text-muted)
323
+ margin-bottom: var(--space-4)
324
+
325
+ Links:
326
+ font: var(--font-body), var(--text-sm), var(--text-secondary)
327
+ hover: var(--text-heading)
328
+ line-height: 2
329
+
330
+ BOTTOM BAR
331
+ border-top: 1px solid var(--border-subtle)
332
+ margin-top: var(--space-8)
333
+ padding-top: var(--space-6)
334
+ display: flex; justify-content: space-between
335
+ copyright: font-mono, text-xs, text-muted, uppercase
336
+ legal links: font-body, text-xs, text-secondary
337
+ ```
338
+
339
+ ---
340
+
341
+ ## Anti-Patterns — Never Do This
342
+
343
+ 1. **Generic dark landing page**: gradient mesh background, centered headline, abstract 3D shape in the background. The visual signature of AI-generated zero-personality marketing.
344
+ 2. **Gradient mesh backgrounds**: `#8B5CF6` → `#EC4899` → `#EF4444` in an mesh. This is explicitly NOT Bold Editorial.
345
+ 3. **Purple or blue as accent**: this system is red-orange. Blue and purple belong to Glassmorphism and Clean SaaS.
346
+ 4. **Rounded pill buttons everywhere**: hero buttons use `radius-md` (6px). Only secondary badges are pills. Pill-everything belongs to Warm Craft.
347
+ 5. **Serif fonts**: Source Serif or any editorial serif is Warm Craft territory. Bold Editorial uses display sans only.
348
+ 6. **Card grid features with icon + 1-line description**: lazy and undifferentiated. Use alternating features or full feature sections instead.
349
+ 7. **Equal-size section layout**: four sections all the same height and width. Editorial rhythm requires scale variation.
350
+ 8. **Emoji as decoration**: never as icons, never as visual anchors.
351
+ 9. **Stock illustrations**: geometric or hand-drawn generic illustrations. Product screenshots, code, or nothing.
352
+ 10. **Warm beige backgrounds**: `#FDF8F0` or similar. That's Warm Craft. Bold Editorial uses off-white `#FAFAF7` (light) or near-black (dark).