create-modoock-app 1.0.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 (99) hide show
  1. package/dist/cli.js +52 -0
  2. package/package.json +21 -0
  3. package/template/.cursor/agents/code-reviewer.md +25 -0
  4. package/template/.cursor/rules/agents.mdc +9 -0
  5. package/template/.cursor/rules/honey.mdc +226 -0
  6. package/template/.cursor/rules/ui.mdc +18 -0
  7. package/template/.cursor/skills/debug/SKILL.md +29 -0
  8. package/template/.dcdignore +3 -0
  9. package/template/AGENTS.md +89 -0
  10. package/template/CLAUDE.md +2 -0
  11. package/template/README.md +339 -0
  12. package/template/app/(local)/components/page.tsx +886 -0
  13. package/template/app/(local)/design-system/page.tsx +1140 -0
  14. package/template/app/(local)/layout.tsx +5 -0
  15. package/template/app/(local)/page.tsx +59 -0
  16. package/template/app/auth/layout.tsx +7 -0
  17. package/template/app/auth/login/page.tsx +76 -0
  18. package/template/app/favicon.ico +0 -0
  19. package/template/app/globals.css +365 -0
  20. package/template/app/layout.tsx +28 -0
  21. package/template/components/layout/app-layout.tsx +30 -0
  22. package/template/components/layout/header.tsx +72 -0
  23. package/template/components/layout/index.ts +3 -0
  24. package/template/components/layout/side-nav.tsx +163 -0
  25. package/template/components/shared/detail-header.tsx +39 -0
  26. package/template/components/shared/index.ts +8 -0
  27. package/template/components/shared/info-card.tsx +75 -0
  28. package/template/components/shared/summary-card.tsx +31 -0
  29. package/template/components/shared/table-section.tsx +38 -0
  30. package/template/components/shared/timeline-list.tsx +31 -0
  31. package/template/components/ui/action-stack.tsx +42 -0
  32. package/template/components/ui/badge.tsx +43 -0
  33. package/template/components/ui/button.tsx +104 -0
  34. package/template/components/ui/icon.tsx +78 -0
  35. package/template/components/ui/index.ts +28 -0
  36. package/template/components/ui/input.tsx +376 -0
  37. package/template/components/ui/loader.tsx +78 -0
  38. package/template/components/ui/metric-bar.tsx +49 -0
  39. package/template/components/ui/modal.tsx +177 -0
  40. package/template/components/ui/select.tsx +458 -0
  41. package/template/components/ui/stepper.tsx +96 -0
  42. package/template/components/ui/tab.tsx +85 -0
  43. package/template/components/ui/user-table.tsx +806 -0
  44. package/template/eslint.config.mjs +18 -0
  45. package/template/knowledge-base/design-system/components/action-stack.mdc +17 -0
  46. package/template/knowledge-base/design-system/components/badges.mdc +16 -0
  47. package/template/knowledge-base/design-system/components/buttons.mdc +21 -0
  48. package/template/knowledge-base/design-system/components/detail-header.mdc +17 -0
  49. package/template/knowledge-base/design-system/components/dropdowns.mdc +12 -0
  50. package/template/knowledge-base/design-system/components/info-list.mdc +17 -0
  51. package/template/knowledge-base/design-system/components/inputs.mdc +23 -0
  52. package/template/knowledge-base/design-system/components/menu.mdc +20 -0
  53. package/template/knowledge-base/design-system/components/modals.mdc +24 -0
  54. package/template/knowledge-base/design-system/components/selects.mdc +39 -0
  55. package/template/knowledge-base/design-system/components/stepper.mdc +18 -0
  56. package/template/knowledge-base/design-system/components/tables.mdc +59 -0
  57. package/template/knowledge-base/design-system/components/tabs.mdc +17 -0
  58. package/template/knowledge-base/design-system/components.mdc +91 -0
  59. package/template/knowledge-base/design-system/tokens.mdc +24 -0
  60. package/template/knowledge-base/examples/bad/README.md +8 -0
  61. package/template/knowledge-base/examples/good/README.md +13 -0
  62. package/template/knowledge-base/metadata/catalog.yaml +245 -0
  63. package/template/knowledge-base/patterns/components/reuse-existing.mdc +26 -0
  64. package/template/knowledge-base/patterns/data-fetching/local-data.mdc +20 -0
  65. package/template/knowledge-base/patterns/layouts/app-shell.mdc +20 -0
  66. package/template/knowledge-base/patterns/pages/data-table-page.mdc +31 -0
  67. package/template/knowledge-base/patterns/pages/workflow-page.mdc +27 -0
  68. package/template/knowledge-base/rules/accessibility/responsive.mdc +31 -0
  69. package/template/knowledge-base/rules/architecture/layout.mdc +52 -0
  70. package/template/knowledge-base/rules/architecture/single-screen.mdc +62 -0
  71. package/template/knowledge-base/rules/code-quality/jsx.mdc +19 -0
  72. package/template/knowledge-base/rules/global/naming.mdc +12 -0
  73. package/template/knowledge-base/rules/global/technology.mdc +19 -0
  74. package/template/knowledge-base/rules/global/ui-copy.mdc +20 -0
  75. package/template/knowledge-base/rules/performance/client.mdc +20 -0
  76. package/template/knowledge-base/rules/ui/information-density.mdc +36 -0
  77. package/template/knowledge-base/rules/ui/interaction.mdc +47 -0
  78. package/template/knowledge-base/rules/ui/simple-ui.mdc +58 -0
  79. package/template/knowledge-base/validation/accessibility.mdc +13 -0
  80. package/template/knowledge-base/validation/architecture.mdc +10 -0
  81. package/template/knowledge-base/validation/ast-grep/do-what-brooooooklyn-said.yml +15 -0
  82. package/template/knowledge-base/validation/ast-grep/no-nested-links.yml +12 -0
  83. package/template/knowledge-base/validation/ast-grep/rewrite-svg-attribute.yml +19 -0
  84. package/template/knowledge-base/validation/code-quality.mdc +18 -0
  85. package/template/knowledge-base/validation/performance.mdc +11 -0
  86. package/template/knowledge-base/validation/ui.mdc +26 -0
  87. package/template/next.config.ts +21 -0
  88. package/template/package-lock.json +6938 -0
  89. package/template/package.json +30 -0
  90. package/template/postcss.config.mjs +7 -0
  91. package/template/public/identity/full_logo_black.svg +27 -0
  92. package/template/public/identity/full_logo_color.svg +38 -0
  93. package/template/public/identity/full_logo_white.svg +34 -0
  94. package/template/public/identity/logo_icon_black.svg +6 -0
  95. package/template/public/identity/logo_icon_color.svg +13 -0
  96. package/template/public/identity/logo_icon_white.svg +13 -0
  97. package/template/public/login-hero.png +0 -0
  98. package/template/sgconfig.yml +11 -0
  99. package/template/tsconfig.json +43 -0
@@ -0,0 +1,1140 @@
1
+ "use client";
2
+
3
+ import {
4
+ ArrowRight,
5
+ Check,
6
+ ChevronDown,
7
+ Info,
8
+ LayoutGrid,
9
+ Plus,
10
+ Search,
11
+ X,
12
+ } from "lucide-react";
13
+
14
+ function Section({
15
+ number,
16
+ title,
17
+ description,
18
+ children,
19
+ }: {
20
+ number: string;
21
+ title: string;
22
+ description?: string;
23
+ children: React.ReactNode;
24
+ }) {
25
+ return (
26
+ <section className="border-b border-border">
27
+ <div className="container-system py-major-section">
28
+ <div className="mb-section">
29
+ <p className="mb-inline text-label uppercase tracking-[0.12em] text-muted-foreground">
30
+ {number}
31
+ </p>
32
+ <h2 className="text-section-title text-foreground">{title}</h2>
33
+ {description && (
34
+ <p className="mt-inline max-w-2xl text-body text-muted-foreground">
35
+ {description}
36
+ </p>
37
+ )}
38
+ </div>
39
+ {children}
40
+ </div>
41
+ </section>
42
+ );
43
+ }
44
+
45
+ function TokenCard({
46
+ title,
47
+ value,
48
+ description,
49
+ children,
50
+ }: {
51
+ title: string;
52
+ value: string;
53
+ description?: string;
54
+ children?: React.ReactNode;
55
+ }) {
56
+ return (
57
+ <div className="rounded-large border border-border bg-surface p-card">
58
+ {children}
59
+ <div className="mt-component">
60
+ <p className="text-component-title text-foreground">{title}</p>
61
+ <p className="mt-micro font-mono text-small text-muted-foreground">
62
+ {value}
63
+ </p>
64
+ {description && (
65
+ <p className="mt-inline text-small text-muted-foreground">
66
+ {description}
67
+ </p>
68
+ )}
69
+ </div>
70
+ </div>
71
+ );
72
+ }
73
+
74
+ function ColorSwatch({
75
+ name,
76
+ value,
77
+ className,
78
+ }: {
79
+ name: string;
80
+ value: string;
81
+ className: string;
82
+ }) {
83
+ return (
84
+ <div className="overflow-hidden rounded-large border border-border bg-surface">
85
+ <div className={`h-28 w-full ${className}`} />
86
+ <div className="p-component">
87
+ <p className="text-body-medium text-foreground">{name}</p>
88
+ <p className="mt-micro font-mono text-small text-muted-foreground">
89
+ {value}
90
+ </p>
91
+ </div>
92
+ </div>
93
+ );
94
+ }
95
+
96
+ export default function DesignSystemPage() {
97
+ return (
98
+ <main className="flex-1">
99
+ <section className="container mx-auto">
100
+ {/* 01 COLORS */}
101
+ <Section
102
+ number="01"
103
+ title="Colors"
104
+ description="Core visual palette used throughout the interface."
105
+ >
106
+ <div className="space-y-section">
107
+ <div>
108
+ <h3 className="mb-component text-component-title">Brand</h3>
109
+ <div className="grid grid-cols-2 gap-component md:grid-cols-3 lg:grid-cols-6">
110
+ <ColorSwatch
111
+ name="Primary"
112
+ value="#264DBF"
113
+ className="bg-primary"
114
+ />
115
+ <ColorSwatch
116
+ name="Primary Hover"
117
+ value="#1F41A8"
118
+ className="bg-primary-hover"
119
+ />
120
+ <ColorSwatch
121
+ name="Primary Active"
122
+ value="#19378F"
123
+ className="bg-primary-active"
124
+ />
125
+ <ColorSwatch
126
+ name="Primary Light"
127
+ value="#E8EDFF"
128
+ className="bg-primary-light"
129
+ />
130
+ <ColorSwatch
131
+ name="Primary Muted"
132
+ value="#C9D4FF"
133
+ className="bg-primary-muted"
134
+ />
135
+ <ColorSwatch
136
+ name="Primary Foreground"
137
+ value="#FFFFFF"
138
+ className="bg-primary-foreground"
139
+ />
140
+ </div>
141
+ </div>
142
+
143
+ <div>
144
+ <h3 className="mb-component text-component-title">Neutral</h3>
145
+ <div className="grid grid-cols-2 gap-component md:grid-cols-4 lg:grid-cols-5">
146
+ <ColorSwatch
147
+ name="Background"
148
+ value="#F8F9FC"
149
+ className="bg-background"
150
+ />
151
+ <ColorSwatch
152
+ name="Foreground"
153
+ value="#171A24"
154
+ className="bg-foreground"
155
+ />
156
+ <ColorSwatch
157
+ name="Surface"
158
+ value="#FFFFFF"
159
+ className="bg-surface"
160
+ />
161
+ <ColorSwatch
162
+ name="Surface Muted"
163
+ value="#F1F3F8"
164
+ className="bg-surface-muted"
165
+ />
166
+ <ColorSwatch
167
+ name="Muted"
168
+ value="#E7EAF1"
169
+ className="bg-muted"
170
+ />
171
+ <ColorSwatch
172
+ name="Muted Foreground"
173
+ value="#687086"
174
+ className="bg-muted-foreground"
175
+ />
176
+ <ColorSwatch
177
+ name="Border"
178
+ value="#DDE1EA"
179
+ className="bg-border"
180
+ />
181
+ <ColorSwatch
182
+ name="Border Strong"
183
+ value="#C7CCDA"
184
+ className="bg-border-strong"
185
+ />
186
+ <ColorSwatch
187
+ name="Input"
188
+ value="#FFFFFF"
189
+ className="bg-input"
190
+ />
191
+ <ColorSwatch
192
+ name="Placeholder"
193
+ value="#9299AA"
194
+ className="bg-placeholder"
195
+ />
196
+ </div>
197
+ </div>
198
+
199
+ <div>
200
+ <h3 className="mb-component text-component-title">Semantic</h3>
201
+ <div className="grid grid-cols-2 gap-component md:grid-cols-4">
202
+ <ColorSwatch
203
+ name="Success"
204
+ value="#15966C"
205
+ className="bg-success"
206
+ />
207
+ <ColorSwatch
208
+ name="Success Light"
209
+ value="#E5F7F0"
210
+ className="bg-success-light"
211
+ />
212
+ <ColorSwatch
213
+ name="Warning"
214
+ value="#D99016"
215
+ className="bg-warning"
216
+ />
217
+ <ColorSwatch
218
+ name="Warning Light"
219
+ value="#FFF4DB"
220
+ className="bg-warning-light"
221
+ />
222
+ <ColorSwatch
223
+ name="Danger"
224
+ value="#D9364F"
225
+ className="bg-danger"
226
+ />
227
+ <ColorSwatch
228
+ name="Danger Light"
229
+ value="#FDE9ED"
230
+ className="bg-danger-light"
231
+ />
232
+ <ColorSwatch name="Info" value="#267CC7" className="bg-info" />
233
+ <ColorSwatch
234
+ name="Info Light"
235
+ value="#E7F2FC"
236
+ className="bg-info-light"
237
+ />
238
+ </div>
239
+ </div>
240
+
241
+ <div>
242
+ <h3 className="mb-component text-component-title">Accent</h3>
243
+ <div className="grid grid-cols-2 gap-component md:grid-cols-4">
244
+ <ColorSwatch
245
+ name="Accent"
246
+ value="#7047D9"
247
+ className="bg-accent"
248
+ />
249
+ <ColorSwatch
250
+ name="Accent Hover"
251
+ value="#5E39BD"
252
+ className="bg-accent-hover"
253
+ />
254
+ <ColorSwatch
255
+ name="Accent Light"
256
+ value="#F0EBFF"
257
+ className="bg-accent-light"
258
+ />
259
+ <ColorSwatch
260
+ name="Accent Foreground"
261
+ value="#FFFFFF"
262
+ className="bg-accent-foreground"
263
+ />
264
+ </div>
265
+ </div>
266
+ </div>
267
+ </Section>
268
+
269
+ {/* 02 TYPOGRAPHY */}
270
+ <Section
271
+ number="02"
272
+ title="Typography"
273
+ description="Role-based typography. Each style has a defined purpose within the interface."
274
+ >
275
+ <div className="overflow-hidden rounded-large border border-border bg-surface">
276
+ <div className="grid gap-component border-b border-border p-card lg:grid-cols-[12rem_1fr_18rem]">
277
+ <div>
278
+ <p className="text-body-medium">Page Title</p>
279
+ <p className="mt-micro text-small text-muted-foreground">
280
+ 2rem / 2.5rem / 700
281
+ </p>
282
+ </div>
283
+ <p className="text-page-title">Aa — Interface Typography</p>
284
+ <p className="text-small text-muted-foreground">
285
+ Main title of a page or primary screen.
286
+ </p>
287
+ </div>
288
+
289
+ <div className="grid gap-component border-b border-border p-card lg:grid-cols-[12rem_1fr_18rem]">
290
+ <div>
291
+ <p className="text-body-medium">Section Title</p>
292
+ <p className="mt-micro text-small text-muted-foreground">
293
+ 1.5rem / 2rem / 700
294
+ </p>
295
+ </div>
296
+ <p className="text-section-title">Aa — Interface Typography</p>
297
+ <p className="text-small text-muted-foreground">
298
+ Title introducing a major section of a page.
299
+ </p>
300
+ </div>
301
+
302
+ <div className="grid gap-component border-b border-border p-card lg:grid-cols-[12rem_1fr_18rem]">
303
+ <div>
304
+ <p className="text-body-medium">Component Title</p>
305
+ <p className="mt-micro text-small text-muted-foreground">
306
+ 1rem / 1.5rem / 600
307
+ </p>
308
+ </div>
309
+ <p className="text-component-title">Aa — Interface Typography</p>
310
+ <p className="text-small text-muted-foreground">
311
+ Titles inside cards, panels, dialogs and components.
312
+ </p>
313
+ </div>
314
+
315
+ <div className="grid gap-component border-b border-border p-card lg:grid-cols-[12rem_1fr_18rem]">
316
+ <div>
317
+ <p className="text-body-medium">Body</p>
318
+ <p className="mt-micro text-small text-muted-foreground">
319
+ 0.875rem / 1.25rem / 400
320
+ </p>
321
+ </div>
322
+ <p className="text-body">Aa — Interface Typography</p>
323
+ <p className="text-small text-muted-foreground">
324
+ Default interface and descriptive text.
325
+ </p>
326
+ </div>
327
+
328
+ <div className="grid gap-component border-b border-border p-card lg:grid-cols-[12rem_1fr_18rem]">
329
+ <div>
330
+ <p className="text-body-medium">Body Medium</p>
331
+ <p className="mt-micro text-small text-muted-foreground">
332
+ 0.875rem / 1.25rem / 500
333
+ </p>
334
+ </div>
335
+ <p className="text-body-medium">Aa — Interface Typography</p>
336
+ <p className="text-small text-muted-foreground">
337
+ Emphasized body text and supporting information.
338
+ </p>
339
+ </div>
340
+
341
+ <div className="grid gap-component border-b border-border p-card lg:grid-cols-[12rem_1fr_18rem]">
342
+ <div>
343
+ <p className="text-body-medium">Small / Metadata</p>
344
+ <p className="mt-micro text-small text-muted-foreground">
345
+ 0.75rem / 1rem / 400
346
+ </p>
347
+ </div>
348
+ <p className="text-small">Aa — Interface Typography</p>
349
+ <p className="text-small text-muted-foreground">
350
+ Secondary information, metadata and supporting labels.
351
+ </p>
352
+ </div>
353
+
354
+ <div className="grid gap-component p-card lg:grid-cols-[12rem_1fr_18rem]">
355
+ <div>
356
+ <p className="text-body-medium">Label / Badge</p>
357
+ <p className="mt-micro text-small text-muted-foreground">
358
+ 0.75rem / 1rem / 600
359
+ </p>
360
+ </div>
361
+ <p className="text-label">Aa — Interface Typography</p>
362
+ <p className="text-small text-muted-foreground">
363
+ Labels, compact states and categorical information.
364
+ </p>
365
+ </div>
366
+ </div>
367
+ </Section>
368
+
369
+ {/* 03 SPACING */}
370
+ <Section
371
+ number="03"
372
+ title="Spacing"
373
+ description="Adopted spacing values used to establish consistent relationships between interface elements."
374
+ >
375
+ <div className="grid gap-component md:grid-cols-2 lg:grid-cols-3">
376
+ <TokenCard
377
+ title="Micro"
378
+ value="0.25rem"
379
+ description="Icon/text adjustments and compact internal spacing."
380
+ >
381
+ <div className="flex h-20 items-center rounded-large bg-surface-muted p-component">
382
+ <div className="h-1 w-micro rounded-full bg-primary" />
383
+ </div>
384
+ </TokenCard>
385
+
386
+ <TokenCard
387
+ title="Inline"
388
+ value="0.5rem"
389
+ description="Spacing between closely related elements."
390
+ >
391
+ <div className="flex h-20 items-center rounded-large bg-surface-muted p-component">
392
+ <div className="h-1 w-inline rounded-full bg-primary" />
393
+ </div>
394
+ </TokenCard>
395
+
396
+ <TokenCard
397
+ title="Control"
398
+ value="0.75rem"
399
+ description="Control padding and label/control relationships."
400
+ >
401
+ <div className="flex h-20 items-center rounded-large bg-surface-muted p-component">
402
+ <div className="h-1 w-control rounded-full bg-primary" />
403
+ </div>
404
+ </TokenCard>
405
+
406
+ <TokenCard
407
+ title="Component"
408
+ value="1rem"
409
+ description="Default spacing between related UI elements."
410
+ >
411
+ <div className="flex h-20 items-center rounded-large bg-surface-muted p-component">
412
+ <div className="h-1 w-component rounded-full bg-primary" />
413
+ </div>
414
+ </TokenCard>
415
+
416
+ <TokenCard
417
+ title="Card"
418
+ value="1.5rem"
419
+ description="Internal spacing for cards and larger containers."
420
+ >
421
+ <div className="flex h-20 items-center rounded-large bg-surface-muted p-component">
422
+ <div className="h-1 w-card rounded-full bg-primary" />
423
+ </div>
424
+ </TokenCard>
425
+
426
+ <TokenCard
427
+ title="Section"
428
+ value="2rem"
429
+ description="Separation between groups within a page."
430
+ >
431
+ <div className="flex h-20 items-center rounded-large bg-surface-muted p-component">
432
+ <div className="h-1 w-section rounded-full bg-primary" />
433
+ </div>
434
+ </TokenCard>
435
+
436
+ <TokenCard
437
+ title="Major Section"
438
+ value="3rem"
439
+ description="Major page-level section separation."
440
+ >
441
+ <div className="flex h-20 items-center rounded-large bg-surface-muted p-component">
442
+ <div className="h-1 w-major-section rounded-full bg-primary" />
443
+ </div>
444
+ </TokenCard>
445
+ </div>
446
+ </Section>
447
+
448
+ {/* 04 RADIUS */}
449
+ <Section
450
+ number="04"
451
+ title="Border Radius"
452
+ description="A four-level radius scale used consistently across the interface."
453
+ >
454
+ <div className="grid gap-component sm:grid-cols-2 lg:grid-cols-4">
455
+ <TokenCard
456
+ title="Small"
457
+ value="0.75rem"
458
+ description="Used for compact UI elements. (Ex: small controls, tags and badges.)"
459
+ >
460
+ <div className="flex h-20 items-center justify-center rounded-small bg-surface-muted">
461
+ <div className="h-12 w-24 rounded-small border-2 border-primary bg-primary-light" />
462
+ </div>
463
+ </TokenCard>
464
+
465
+ <TokenCard
466
+ title="Medium"
467
+ value="0.875rem"
468
+ description="Used for standard interactive components. (Ex: buttons, inputs, selects and dropdowns.)"
469
+ >
470
+ <div className="flex h-20 items-center justify-center rounded-small bg-surface-muted">
471
+ <div className="h-12 w-24 rounded-medium border-2 border-primary bg-primary-light" />
472
+ </div>
473
+ </TokenCard>
474
+
475
+ <TokenCard
476
+ title="Large"
477
+ value="1rem"
478
+ description="Used for larger containers and surfaces. (Ex: cards, panels and major content blocks.)"
479
+ >
480
+ <div className="flex h-20 items-center justify-center rounded-small bg-surface-muted">
481
+ <div className="h-12 w-24 rounded-large border-2 border-primary bg-primary-light" />
482
+ </div>
483
+ </TokenCard>
484
+
485
+ <TokenCard
486
+ title="Full"
487
+ value="9999rem"
488
+ description="Used for fully rounded elements. (Ex: pills, badges, avatars and circular buttons.)"
489
+ >
490
+ <div className="flex h-20 items-center justify-center rounded-small bg-surface-muted">
491
+ <div className="rounded-full border-2 border-primary bg-primary-light px-card py-control text-label text-primary">
492
+ Rounded Element
493
+ </div>
494
+ </div>
495
+ </TokenCard>
496
+ </div>
497
+ </Section>
498
+
499
+ {/* 05 ICONOGRAPHY */}
500
+ <Section
501
+ number="05"
502
+ title="Iconography"
503
+ description="Lucide Icons are the standard icon library across the interface."
504
+ >
505
+ <div className="space-y-section">
506
+ <div className="rounded-large border border-border bg-surface p-card">
507
+ <div className="flex flex-col gap-card lg:flex-row lg:items-center lg:justify-between">
508
+ <div>
509
+ <p className="text-component-title">Lucide Icons</p>
510
+ <p className="mt-inline max-w-xl text-body text-muted-foreground">
511
+ Use Lucide as the single icon library throughout the
512
+ product. Avoid mixing icon libraries or introducing custom
513
+ icons when an equivalent Lucide icon exists.
514
+ </p>
515
+ </div>
516
+ <div className="flex items-center justify-center rounded-large bg-primary-light p-card">
517
+ <LayoutGrid
518
+ className="icon-display text-primary"
519
+ strokeWidth={1.8}
520
+ />
521
+ </div>
522
+ </div>
523
+ </div>
524
+
525
+ <div>
526
+ <h3 className="mb-component text-component-title">Icon Sizes</h3>
527
+ <div className="grid gap-component sm:grid-cols-2 lg:grid-cols-4">
528
+ <TokenCard
529
+ title="Small"
530
+ value="1rem"
531
+ description="Compact UI and supporting metadata."
532
+ >
533
+ <div className="flex h-20 items-center justify-center rounded-large bg-surface-muted">
534
+ <LayoutGrid
535
+ className="icon-sm text-primary"
536
+ strokeWidth={1.8}
537
+ />
538
+ </div>
539
+ </TokenCard>
540
+ <TokenCard
541
+ title="Default"
542
+ value="1.25rem"
543
+ description="Default interface icons."
544
+ >
545
+ <div className="flex h-20 items-center justify-center rounded-large bg-surface-muted">
546
+ <LayoutGrid
547
+ className="icon-default text-primary"
548
+ strokeWidth={1.8}
549
+ />
550
+ </div>
551
+ </TokenCard>
552
+ <TokenCard
553
+ title="Large"
554
+ value="1.5rem"
555
+ description="Prominent controls and visual indicators."
556
+ >
557
+ <div className="flex h-20 items-center justify-center rounded-large bg-surface-muted">
558
+ <LayoutGrid
559
+ className="icon-lg text-primary"
560
+ strokeWidth={1.8}
561
+ />
562
+ </div>
563
+ </TokenCard>
564
+ <TokenCard
565
+ title="Display"
566
+ value="2rem"
567
+ description="Large visual elements and empty states."
568
+ >
569
+ <div className="flex h-20 items-center justify-center rounded-large bg-surface-muted">
570
+ <LayoutGrid
571
+ className="icon-display text-primary"
572
+ strokeWidth={1.8}
573
+ />
574
+ </div>
575
+ </TokenCard>
576
+ </div>
577
+ </div>
578
+
579
+ <div>
580
+ <h3 className="mb-component text-component-title">Stroke</h3>
581
+ <div className="grid gap-component md:grid-cols-2">
582
+ <TokenCard
583
+ title="Default Stroke"
584
+ value="1.8"
585
+ description="Default stroke weight for interface icons."
586
+ >
587
+ <div className="flex h-20 items-center justify-center rounded-large bg-surface-muted">
588
+ <Search
589
+ className="icon-display text-primary"
590
+ strokeWidth={1.8}
591
+ />
592
+ </div>
593
+ </TokenCard>
594
+ <TokenCard
595
+ title="Strong Stroke"
596
+ value="2"
597
+ description="Use when an icon needs stronger visual emphasis."
598
+ >
599
+ <div className="flex h-20 items-center justify-center rounded-large bg-surface-muted">
600
+ <Check
601
+ className="icon-display text-primary"
602
+ strokeWidth={2}
603
+ />
604
+ </div>
605
+ </TokenCard>
606
+ </div>
607
+ </div>
608
+
609
+ <div>
610
+ <h3 className="mb-component text-component-title">Icon Color</h3>
611
+ <div className="grid gap-component sm:grid-cols-2 lg:grid-cols-4">
612
+ <TokenCard
613
+ title="Default"
614
+ value="Foreground"
615
+ description="Primary interface actions and navigation."
616
+ >
617
+ <div className="flex h-20 items-center justify-center rounded-large bg-surface-muted">
618
+ <Search className="icon-lg text-foreground" />
619
+ </div>
620
+ </TokenCard>
621
+ <TokenCard
622
+ title="Muted"
623
+ value="Muted Foreground"
624
+ description="Secondary or supporting icons."
625
+ >
626
+ <div className="flex h-20 items-center justify-center rounded-large bg-surface-muted">
627
+ <Info className="icon-lg text-muted-foreground" />
628
+ </div>
629
+ </TokenCard>
630
+ <TokenCard
631
+ title="Primary"
632
+ value="Primary"
633
+ description="Selected, active or brand-related icons."
634
+ >
635
+ <div className="flex h-20 items-center justify-center rounded-large bg-primary-light">
636
+ <ArrowRight className="icon-lg text-primary" />
637
+ </div>
638
+ </TokenCard>
639
+ <TokenCard
640
+ title="Semantic"
641
+ value="Semantic Colors"
642
+ description="Only when the icon communicates a system state."
643
+ >
644
+ <div className="flex items-center justify-center gap-component rounded-large bg-surface-muted py-card">
645
+ <Check className="icon-default text-success" />
646
+ <Info className="icon-default text-warning" />
647
+ <X className="icon-default text-danger" />
648
+ </div>
649
+ </TokenCard>
650
+ </div>
651
+ </div>
652
+
653
+ <div className="rounded-large border border-border bg-surface p-card">
654
+ <h3 className="text-component-title">Icon Rules</h3>
655
+ <div className="mt-component grid gap-component md:grid-cols-2">
656
+ <div className="flex gap-inline rounded-large bg-surface-muted p-component">
657
+ <Check className="icon-sm shrink-0 text-primary" />
658
+ <div>
659
+ <p className="text-body-medium">Use Lucide consistently</p>
660
+ <p className="mt-micro text-small text-muted-foreground">
661
+ Use Lucide as the default source for interface icons.
662
+ </p>
663
+ </div>
664
+ </div>
665
+ <div className="flex gap-inline rounded-large bg-surface-muted p-component">
666
+ <Check className="icon-sm shrink-0 text-primary" />
667
+ <div>
668
+ <p className="text-body-medium">Prefer clarity</p>
669
+ <p className="mt-micro text-small text-muted-foreground">
670
+ Choose the simplest icon that clearly communicates the
671
+ intended action.
672
+ </p>
673
+ </div>
674
+ </div>
675
+ <div className="flex gap-inline rounded-large bg-surface-muted p-component">
676
+ <Check className="icon-sm shrink-0 text-primary" />
677
+ <div>
678
+ <p className="text-body-medium">
679
+ Keep visual weight consistent
680
+ </p>
681
+ <p className="mt-micro text-small text-muted-foreground">
682
+ Keep stroke weights consistent across the interface.
683
+ </p>
684
+ </div>
685
+ </div>
686
+ <div className="flex gap-inline rounded-large bg-surface-muted p-component">
687
+ <Check className="icon-sm shrink-0 text-primary" />
688
+ <div>
689
+ <p className="text-body-medium">
690
+ Do not use icons as decoration
691
+ </p>
692
+ <p className="mt-micro text-small text-muted-foreground">
693
+ Every interface icon should have a functional or semantic
694
+ purpose.
695
+ </p>
696
+ </div>
697
+ </div>
698
+ <div className="flex gap-inline rounded-large bg-surface-muted p-component">
699
+ <Check className="icon-sm shrink-0 text-primary" />
700
+ <div>
701
+ <p className="text-body-medium">
702
+ Match surrounding typography
703
+ </p>
704
+ <p className="mt-micro text-small text-muted-foreground">
705
+ Icon size should visually align with the text or control
706
+ it belongs to.
707
+ </p>
708
+ </div>
709
+ </div>
710
+ <div className="flex gap-inline rounded-large bg-surface-muted p-component">
711
+ <Check className="icon-sm shrink-0 text-primary" />
712
+ <div>
713
+ <p className="text-body-medium">
714
+ Use semantic color intentionally
715
+ </p>
716
+ <p className="mt-micro text-small text-muted-foreground">
717
+ Semantic colors should only communicate a system state.
718
+ </p>
719
+ </div>
720
+ </div>
721
+ </div>
722
+ </div>
723
+ </div>
724
+ </Section>
725
+
726
+ {/* 06 LAYOUT */}
727
+ <Section
728
+ number="06"
729
+ title="Layout Rules"
730
+ description="Global rules that define how pages and sections are structured."
731
+ >
732
+ <div className="grid gap-component md:grid-cols-2">
733
+ <TokenCard
734
+ title="Content Container"
735
+ value="80rem"
736
+ description="Keep primary page content within a controlled readable width."
737
+ >
738
+ <div className="flex h-20 items-center justify-center rounded-large bg-surface-muted p-component">
739
+ <div className="w-4/5 rounded-large border border-primary bg-primary-light" />
740
+ </div>
741
+ </TokenCard>
742
+ <TokenCard
743
+ title="Page Padding"
744
+ value="1.5rem mobile / 2.5rem desktop"
745
+ description="Horizontal padding applied to main page content."
746
+ >
747
+ <div className="flex h-20 items-center gap-inline rounded-large bg-surface-muted px-[var(--layout-padding-mobile)] lg:px-[var(--layout-padding-desktop)]">
748
+ <div className="w-6 rounded-large bg-primary-muted" />
749
+ <div className="flex-1 rounded-large bg-primary" />
750
+ <div className="w-6 rounded-large bg-primary-muted" />
751
+ </div>
752
+ </TokenCard>
753
+ <TokenCard
754
+ title="Grid Gap"
755
+ value="1rem"
756
+ description="Default gap between cards and grid-based content."
757
+ >
758
+ <div className="grid h-20 grid-cols-3 gap-component rounded-large bg-surface-muted p-component">
759
+ <div className="rounded-large bg-primary-muted" />
760
+ <div className="rounded-large bg-primary" />
761
+ <div className="rounded-large bg-primary-muted" />
762
+ </div>
763
+ </TokenCard>
764
+ <TokenCard
765
+ title="Section Gap"
766
+ value="2rem"
767
+ description="Default separation between major groups inside a page."
768
+ >
769
+ <div className="flex h-20 flex-col justify-center gap-section rounded-large bg-surface-muted p-component">
770
+ <div className="h-2 rounded-full bg-primary" />
771
+ <div className="h-2 rounded-full bg-primary-muted" />
772
+ </div>
773
+ </TokenCard>
774
+ </div>
775
+ </Section>
776
+
777
+ {/* 07 SIZING */}
778
+ <Section
779
+ number="07"
780
+ title="Sizing Principle"
781
+ description="Interactive elements derive their dimensions from content and spacing rather than fixed heights."
782
+ >
783
+ <div className="grid gap-card lg:grid-cols-2">
784
+ <div className="rounded-large border border-border bg-surface p-card">
785
+ <div className="mb-card">
786
+ <p className="text-component-title">Content-driven sizing</p>
787
+ <p className="mt-micro text-small text-muted-foreground">
788
+ Padding establishes visual size while content determines final
789
+ dimensions.
790
+ </p>
791
+ </div>
792
+
793
+ <div className="space-y-component">
794
+ <div className="flex flex-wrap gap-inline">
795
+ <button className="rounded-large bg-primary px-component py-control text-body-medium text-primary-foreground">
796
+ Primary action
797
+ </button>
798
+ <button className="rounded-large border border-border bg-surface px-component py-control text-body-medium">
799
+ Secondary
800
+ </button>
801
+ </div>
802
+
803
+ <div className="flex flex-wrap gap-inline">
804
+ <span className="rounded-full bg-success-light px-component py-micro text-label text-success-foreground">
805
+ Active
806
+ </span>
807
+ <span className="rounded-full bg-surface-muted px-component py-micro text-label text-muted-foreground">
808
+ Draft
809
+ </span>
810
+ </div>
811
+
812
+ <div className="flex items-center gap-inline">
813
+ <div className="flex flex-1 items-center gap-inline rounded-large border border-border bg-surface px-component py-control">
814
+ <Search className="icon-sm text-placeholder" />
815
+ <span className="text-body text-placeholder">
816
+ Search...
817
+ </span>
818
+ </div>
819
+ <button className="rounded-large border border-border px-component py-control text-body">
820
+ Filter
821
+ </button>
822
+ </div>
823
+ </div>
824
+ </div>
825
+
826
+ <div className="rounded-large border border-border bg-surface p-card">
827
+ <p className="text-component-title">Sizing hierarchy</p>
828
+ <div className="mt-card space-y-component">
829
+ <div className="flex gap-component rounded-large bg-muted p-component">
830
+ <span className="flex h-7 w-7 shrink-0 items-center justify-center rounded-full bg-primary text-label text-primary-foreground">
831
+ 1
832
+ </span>
833
+ <div>
834
+ <p className="text-body-medium">Content</p>
835
+ <p className="mt-micro text-small text-muted-foreground">
836
+ Text, icon or internal content.
837
+ </p>
838
+ </div>
839
+ </div>
840
+ <div className="flex gap-component rounded-large bg-surface-muted p-component">
841
+ <span className="flex h-7 w-7 shrink-0 items-center justify-center rounded-full bg-primary text-label text-primary-foreground">
842
+ 2
843
+ </span>
844
+ <div>
845
+ <p className="text-body-medium">Padding</p>
846
+ <p className="mt-micro text-small text-muted-foreground">
847
+ Creates breathing room around content.
848
+ </p>
849
+ </div>
850
+ </div>
851
+ <div className="flex gap-component rounded-large bg-surface-muted p-component">
852
+ <span className="flex h-7 w-7 shrink-0 items-center justify-center rounded-full bg-primary text-label text-primary-foreground">
853
+ 3
854
+ </span>
855
+ <div>
856
+ <p className="text-body-medium">Radius</p>
857
+ <p className="mt-micro text-small text-muted-foreground">
858
+ Follows the physical scale of the element.
859
+ </p>
860
+ </div>
861
+ </div>
862
+ <div className="flex gap-component rounded-large bg-surface-muted p-component">
863
+ <span className="flex h-7 w-7 shrink-0 items-center justify-center rounded-full bg-primary text-label text-primary-foreground">
864
+ 4
865
+ </span>
866
+ <div>
867
+ <p className="text-body-medium">Container</p>
868
+ <p className="mt-micro text-small text-muted-foreground">
869
+ Defines available layout space.
870
+ </p>
871
+ </div>
872
+ </div>
873
+ </div>
874
+ </div>
875
+ </div>
876
+
877
+ <div className="mt-card rounded-large border border-primary-muted bg-primary-light p-card">
878
+ <p className="text-body-medium text-primary-active">
879
+ Global principle
880
+ </p>
881
+ <p className="mt-inline text-body text-primary-active">
882
+ Avoid fixed component heights whenever possible. Use typography,
883
+ padding and spacing tokens to allow controls to adapt naturally to
884
+ their content.
885
+ </p>
886
+ </div>
887
+ </Section>
888
+
889
+ {/* 08 VISUAL HIERARCHY */}
890
+ <Section
891
+ number="08"
892
+ title="Visual Hierarchy"
893
+ description="Hierarchy is created through surface contrast, borders, spacing and typography — not shadows."
894
+ >
895
+ <div className="grid gap-component md:grid-cols-3">
896
+ <TokenCard
897
+ title="Surface Contrast"
898
+ value="Surface / Surface Muted"
899
+ description="Use background contrast to distinguish areas without elevation."
900
+ >
901
+ <div className="overflow-hidden rounded-large border border-border">
902
+ <div className="bg-surface p-component">
903
+ <div className="h-2 w-24 rounded-full bg-border" />
904
+ </div>
905
+ <div className="bg-surface-muted p-component">
906
+ <div className="h-2 w-32 rounded-full bg-border-strong" />
907
+ </div>
908
+ </div>
909
+ </TokenCard>
910
+
911
+ <TokenCard
912
+ title="Borders"
913
+ value="Border / Border Strong"
914
+ description="Use borders to establish structure and separation."
915
+ >
916
+ <div className="rounded-large border border-border bg-surface p-component">
917
+ <div className="rounded-large border border-border-strong p-component">
918
+ <div className="h-2 w-20 rounded-full bg-border" />
919
+ </div>
920
+ </div>
921
+ </TokenCard>
922
+
923
+ <TokenCard
924
+ title="Spacing"
925
+ value="1rem → 3rem"
926
+ description="Use whitespace to establish hierarchy."
927
+ >
928
+ <div className="space-y-component rounded-large bg-surface-muted p-component">
929
+ <div className="h-2 w-28 rounded-full bg-primary" />
930
+ <div className="h-2 w-20 rounded-full bg-border-strong" />
931
+ </div>
932
+ </TokenCard>
933
+ </div>
934
+
935
+ <div className="mt-card rounded-large border border-border bg-surface p-card">
936
+ <div className="flex items-start gap-inline">
937
+ <Info className="icon-default shrink-0 text-info" />
938
+ <div>
939
+ <p className="text-body-medium">No shadows</p>
940
+ <p className="mt-micro text-small text-muted-foreground">
941
+ The interface does not use box shadows. Visual hierarchy is
942
+ represented through borders, surfaces, spacing and typography.
943
+ </p>
944
+ </div>
945
+ </div>
946
+ </div>
947
+ </Section>
948
+
949
+ {/* 09 SEMANTIC STATES */}
950
+ <Section
951
+ number="09"
952
+ title="Semantic States"
953
+ description="Semantic colors communicate system states consistently across the interface."
954
+ >
955
+ <div className="grid gap-component md:grid-cols-2 lg:grid-cols-4">
956
+ <div className="rounded-large border border-border bg-surface p-card">
957
+ <div className="flex items-center gap-inline">
958
+ <Check className="icon-sm text-success" />
959
+ <span className="text-body-medium text-success-foreground">
960
+ Success
961
+ </span>
962
+ </div>
963
+ <div className="mt-component rounded-large bg-success-light p-component text-small text-success-foreground">
964
+ Operation completed successfully.
965
+ </div>
966
+ </div>
967
+
968
+ <div className="rounded-large border border-border bg-surface p-card">
969
+ <div className="flex items-center gap-inline">
970
+ <Info className="icon-sm text-warning" />
971
+ <span className="text-body-medium text-warning-foreground">
972
+ Warning
973
+ </span>
974
+ </div>
975
+ <div className="mt-component rounded-large bg-warning-light p-component text-small text-warning-foreground">
976
+ This action requires attention.
977
+ </div>
978
+ </div>
979
+
980
+ <div className="rounded-large border border-border bg-surface p-card">
981
+ <div className="flex items-center gap-inline">
982
+ <X className="icon-sm text-danger" />
983
+ <span className="text-body-medium text-danger-foreground">
984
+ Danger
985
+ </span>
986
+ </div>
987
+ <div className="mt-component rounded-large bg-danger-light p-component text-small text-danger-foreground">
988
+ Something requires immediate attention.
989
+ </div>
990
+ </div>
991
+
992
+ <div className="rounded-large border border-border bg-surface p-card">
993
+ <div className="flex items-center gap-inline">
994
+ <Info className="icon-sm text-info" />
995
+ <span className="text-body-medium text-info-foreground">
996
+ Information
997
+ </span>
998
+ </div>
999
+ <div className="mt-component rounded-large bg-info-light p-component text-small text-info-foreground">
1000
+ Additional information is available.
1001
+ </div>
1002
+ </div>
1003
+ </div>
1004
+ </Section>
1005
+
1006
+ {/* 10 COMPLETE EXAMPLE */}
1007
+ <Section
1008
+ number="10"
1009
+ title="Complete Example"
1010
+ description="A practical composition showing how the foundation tokens work together."
1011
+ >
1012
+ <div className="overflow-hidden rounded-large border border-border bg-surface">
1013
+ <div className="border-b border-border p-card">
1014
+ <div className="flex flex-wrap items-center justify-between gap-component">
1015
+ <div>
1016
+ <p className="text-small text-muted-foreground">Overview</p>
1017
+ <h3 className="mt-micro text-section-title">Dashboard</h3>
1018
+ </div>
1019
+ <div className="flex flex-wrap gap-inline">
1020
+ <button className="rounded-large border border-border bg-surface px-component py-control text-body-medium">
1021
+ Export
1022
+ </button>
1023
+ <button className="flex items-center gap-inline rounded-large bg-primary px-component py-control text-body-medium text-primary-foreground">
1024
+ Add new
1025
+ <Plus className="icon-sm" />
1026
+ </button>
1027
+ </div>
1028
+ </div>
1029
+ </div>
1030
+
1031
+ <div className="bg-background p-card">
1032
+ <div className="grid gap-component md:grid-cols-3">
1033
+ <div className="rounded-large border border-border bg-surface p-card">
1034
+ <p className="text-small text-muted-foreground">
1035
+ Total Revenue
1036
+ </p>
1037
+ <p className="mt-inline text-section-title">$48,240</p>
1038
+ <span className="mt-component inline-flex rounded-full bg-success-light px-component py-micro text-label text-success-foreground">
1039
+ +12.5%
1040
+ </span>
1041
+ </div>
1042
+ <div className="rounded-large border border-border bg-surface p-card">
1043
+ <p className="text-small text-muted-foreground">
1044
+ Active Users
1045
+ </p>
1046
+ <p className="mt-inline text-section-title">12,842</p>
1047
+ <span className="mt-component inline-flex rounded-full bg-success-light px-component py-micro text-label text-success-foreground">
1048
+ +8.2%
1049
+ </span>
1050
+ </div>
1051
+ <div className="rounded-large border border-border bg-surface p-card">
1052
+ <p className="text-small text-muted-foreground">Conversion</p>
1053
+ <p className="mt-inline text-section-title">7.24%</p>
1054
+ <span className="mt-component inline-flex rounded-full bg-success-light px-component py-micro text-label text-success-foreground">
1055
+ +2.1%
1056
+ </span>
1057
+ </div>
1058
+ </div>
1059
+
1060
+ <div className="mt-component grid gap-component lg:grid-cols-[1.5fr_1fr]">
1061
+ <div className="rounded-large border border-border bg-surface p-card">
1062
+ <div className="flex items-center justify-between">
1063
+ <div>
1064
+ <h4 className="text-component-title">Performance</h4>
1065
+ <p className="mt-micro text-small text-muted-foreground">
1066
+ Monthly overview
1067
+ </p>
1068
+ </div>
1069
+ <button className="flex items-center gap-inline rounded-large border border-border px-component py-control text-small">
1070
+ This month
1071
+ <ChevronDown className="icon-sm" />
1072
+ </button>
1073
+ </div>
1074
+
1075
+ <div className="mt-card flex h-40 items-end gap-inline">
1076
+ <div className="h-[35%] flex-1 rounded-small bg-primary-light" />
1077
+ <div className="h-[52%] flex-1 rounded-small bg-primary-light" />
1078
+ <div className="h-[42%] flex-1 rounded-small bg-primary-light" />
1079
+ <div className="h-[68%] flex-1 rounded-small bg-primary-light" />
1080
+ <div className="h-[55%] flex-1 rounded-small bg-primary-light" />
1081
+ <div className="h-[76%] flex-1 rounded-small bg-primary-light" />
1082
+ <div className="h-[62%] flex-1 rounded-small bg-primary-light" />
1083
+ <div className="h-[88%] flex-1 rounded-small bg-primary-light" />
1084
+ <div className="h-[72%] flex-1 rounded-small bg-primary-light" />
1085
+ <div className="h-[94%] flex-1 rounded-small bg-primary-light" />
1086
+ </div>
1087
+ </div>
1088
+
1089
+ <div className="rounded-large border border-border bg-surface p-card">
1090
+ <div className="flex items-center justify-between">
1091
+ <h4 className="text-component-title">Recent Activity</h4>
1092
+ <button className="text-small font-medium text-primary">
1093
+ View all
1094
+ </button>
1095
+ </div>
1096
+
1097
+ <div className="mt-card space-y-component">
1098
+ <div className="flex items-center gap-inline">
1099
+ <div className="flex items-center justify-center rounded-small bg-primary-light p-inline">
1100
+ <LayoutGrid className="icon-sm text-primary" />
1101
+ </div>
1102
+ <div>
1103
+ <p className="text-body-medium">New account created</p>
1104
+ <p className="mt-micro text-small text-muted-foreground">
1105
+ 1 hour ago
1106
+ </p>
1107
+ </div>
1108
+ </div>
1109
+ <div className="flex items-center gap-inline">
1110
+ <div className="flex items-center justify-center rounded-small bg-primary-light p-inline">
1111
+ <LayoutGrid className="icon-sm text-primary" />
1112
+ </div>
1113
+ <div>
1114
+ <p className="text-body-medium">Payment received</p>
1115
+ <p className="mt-micro text-small text-muted-foreground">
1116
+ 2 hours ago
1117
+ </p>
1118
+ </div>
1119
+ </div>
1120
+ <div className="flex items-center gap-inline">
1121
+ <div className="flex items-center justify-center rounded-small bg-primary-light p-inline">
1122
+ <LayoutGrid className="icon-sm text-primary" />
1123
+ </div>
1124
+ <div>
1125
+ <p className="text-body-medium">Report generated</p>
1126
+ <p className="mt-micro text-small text-muted-foreground">
1127
+ 3 hours ago
1128
+ </p>
1129
+ </div>
1130
+ </div>
1131
+ </div>
1132
+ </div>
1133
+ </div>
1134
+ </div>
1135
+ </div>
1136
+ </Section>
1137
+ </section>
1138
+ </main>
1139
+ );
1140
+ }