@jaimevalasek/aioson 1.30.1 → 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 (90) hide show
  1. package/CHANGELOG.md +9 -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 +567 -511
  12. package/template/.aioson/docs/play/README.md +2 -0
  13. package/template/.aioson/docs/play/agent-usage-guide.md +7 -1
  14. package/template/.aioson/docs/play/app-compatibility-guide.md +6 -1
  15. package/template/.aioson/docs/play/auth-services-and-testing.md +16 -1
  16. package/template/.aioson/docs/play/manifest-and-runtime.md +23 -0
  17. package/template/.aioson/skills/design/aurora-command-ui/SKILL.md +266 -243
  18. package/template/.aioson/skills/design/aurora-command-ui/references/art-direction.md +293 -293
  19. package/template/.aioson/skills/design/aurora-command-ui/references/components.md +827 -827
  20. package/template/.aioson/skills/design/aurora-command-ui/references/dashboards.md +250 -250
  21. package/template/.aioson/skills/design/aurora-command-ui/references/design-tokens.md +585 -585
  22. package/template/.aioson/skills/design/aurora-command-ui/references/motion.md +365 -365
  23. package/template/.aioson/skills/design/aurora-command-ui/references/patterns.md +485 -482
  24. package/template/.aioson/skills/design/aurora-command-ui/references/websites.md +386 -387
  25. package/template/.aioson/skills/design/bold-editorial-ui/SKILL.md +228 -205
  26. package/template/.aioson/skills/design/bold-editorial-ui/references/art-direction.md +338 -338
  27. package/template/.aioson/skills/design/bold-editorial-ui/references/components.md +977 -977
  28. package/template/.aioson/skills/design/bold-editorial-ui/references/dashboards.md +218 -218
  29. package/template/.aioson/skills/design/bold-editorial-ui/references/design-tokens.md +326 -326
  30. package/template/.aioson/skills/design/bold-editorial-ui/references/motion.md +461 -461
  31. package/template/.aioson/skills/design/bold-editorial-ui/references/patterns.md +293 -293
  32. package/template/.aioson/skills/design/bold-editorial-ui/references/websites.md +352 -352
  33. package/template/.aioson/skills/design/clean-saas-ui/SKILL.md +233 -210
  34. package/template/.aioson/skills/design/clean-saas-ui/references/art-direction.md +319 -319
  35. package/template/.aioson/skills/design/clean-saas-ui/references/components.md +365 -365
  36. package/template/.aioson/skills/design/clean-saas-ui/references/dashboards.md +196 -196
  37. package/template/.aioson/skills/design/clean-saas-ui/references/design-tokens.md +244 -244
  38. package/template/.aioson/skills/design/clean-saas-ui/references/motion.md +235 -235
  39. package/template/.aioson/skills/design/clean-saas-ui/references/patterns.md +215 -215
  40. package/template/.aioson/skills/design/clean-saas-ui/references/websites.md +295 -295
  41. package/template/.aioson/skills/design/cognitive-core-ui/SKILL.md +239 -203
  42. package/template/.aioson/skills/design/cognitive-core-ui/references/art-direction.md +339 -339
  43. package/template/.aioson/skills/design/cognitive-core-ui/references/components.md +417 -407
  44. package/template/.aioson/skills/design/cognitive-core-ui/references/dashboards.md +289 -272
  45. package/template/.aioson/skills/design/cognitive-core-ui/references/design-tokens.md +525 -524
  46. package/template/.aioson/skills/design/cognitive-core-ui/references/motion.md +279 -279
  47. package/template/.aioson/skills/design/cognitive-core-ui/references/patterns.md +355 -289
  48. package/template/.aioson/skills/design/cognitive-core-ui/references/websites.md +443 -437
  49. package/template/.aioson/skills/design/glassmorphism-ui/SKILL.md +245 -222
  50. package/template/.aioson/skills/design/glassmorphism-ui/references/art-direction.md +159 -159
  51. package/template/.aioson/skills/design/glassmorphism-ui/references/components.md +498 -498
  52. package/template/.aioson/skills/design/glassmorphism-ui/references/dashboards.md +236 -236
  53. package/template/.aioson/skills/design/glassmorphism-ui/references/design-tokens.md +274 -274
  54. package/template/.aioson/skills/design/glassmorphism-ui/references/motion.md +355 -355
  55. package/template/.aioson/skills/design/glassmorphism-ui/references/patterns.md +198 -198
  56. package/template/.aioson/skills/design/glassmorphism-ui/references/websites.md +307 -307
  57. package/template/.aioson/skills/design/interface-design/SKILL.md +68 -47
  58. package/template/.aioson/skills/design/interface-design/references/components-and-states.md +105 -105
  59. package/template/.aioson/skills/design/interface-design/references/design-directions.md +101 -101
  60. package/template/.aioson/skills/design/interface-design/references/handoff-and-quality.md +92 -71
  61. package/template/.aioson/skills/design/interface-design/references/intent-and-domain.md +74 -74
  62. package/template/.aioson/skills/design/interface-design/references/tokens-and-depth.md +173 -173
  63. package/template/.aioson/skills/design/neo-brutalist-ui/SKILL.md +236 -213
  64. package/template/.aioson/skills/design/neo-brutalist-ui/references/art-direction.md +228 -228
  65. package/template/.aioson/skills/design/neo-brutalist-ui/references/components.md +855 -855
  66. package/template/.aioson/skills/design/neo-brutalist-ui/references/dashboards.md +334 -334
  67. package/template/.aioson/skills/design/neo-brutalist-ui/references/design-tokens.md +342 -342
  68. package/template/.aioson/skills/design/neo-brutalist-ui/references/motion.md +286 -286
  69. package/template/.aioson/skills/design/neo-brutalist-ui/references/patterns.md +458 -458
  70. package/template/.aioson/skills/design/neo-brutalist-ui/references/websites.md +723 -723
  71. package/template/.aioson/skills/design/premium-command-center-ui/SKILL.md +83 -62
  72. package/template/.aioson/skills/design/premium-command-center-ui/references/operations.md +74 -74
  73. package/template/.aioson/skills/design/premium-command-center-ui/references/patterns.md +116 -116
  74. package/template/.aioson/skills/design/premium-command-center-ui/references/validation.md +47 -47
  75. package/template/.aioson/skills/design/premium-command-center-ui/references/visual-system.md +215 -215
  76. package/template/.aioson/skills/design/pt.squarespace.com/.skill-meta.json +31 -31
  77. package/template/.aioson/skills/design/pt.squarespace.com/SKILL.md +94 -66
  78. package/template/.aioson/skills/design/pt.squarespace.com/references/components.md +366 -366
  79. package/template/.aioson/skills/design/pt.squarespace.com/references/design-tokens.md +150 -150
  80. package/template/.aioson/skills/design/pt.squarespace.com/references/motion.md +270 -270
  81. package/template/.aioson/skills/design/pt.squarespace.com/references/patterns.md +189 -189
  82. package/template/.aioson/skills/design/pt.squarespace.com/references/websites.md +161 -161
  83. package/template/.aioson/skills/design/warm-craft-ui/SKILL.md +232 -209
  84. package/template/.aioson/skills/design/warm-craft-ui/references/art-direction.md +324 -324
  85. package/template/.aioson/skills/design/warm-craft-ui/references/components.md +508 -508
  86. package/template/.aioson/skills/design/warm-craft-ui/references/dashboards.md +223 -223
  87. package/template/.aioson/skills/design/warm-craft-ui/references/design-tokens.md +374 -374
  88. package/template/.aioson/skills/design/warm-craft-ui/references/motion.md +356 -356
  89. package/template/.aioson/skills/design/warm-craft-ui/references/patterns.md +288 -288
  90. 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).