Skip to content

The one and only agent harness for complex codebases. Project memory, planning, execution, and verified completion inside Codex.

refactor(web): introduce design system components

YeonGyu-Kimfee5eeb3ceaf
diff --git a/.omo/evidence/design-system-components-v3.md b/.omo/evidence/design-system-components-v3.md
new file mode 100644
index 00000000..997ea5fc
--- /dev/null
+++ b/.omo/evidence/design-system-components-v3.md
@@ -0,0 +1,39 @@
+# Design System Components v3 Evidence
+
+## Scope
+
+- Branch: `code-yeongyu/lazycodex-design-system-fidelity`
+- Worktree: `/Users/yeongyu/local-workspaces/lazycodex-wt/design-system-fidelity-v2`
+- Reference screenshots: `.omo/ulw-loop/evidence/design-system-fidelity-v2/screenshots/current/`
+- Current screenshots: `.omo/ulw-loop/evidence/design-system-components-v3/screenshots/current/`
+
+## Design System Work
+
+- Reworked `packages/web/DESIGN.md` into the required 7-section design-system contract.
+- Added real reusable React primitives under `packages/web/components/design-system/`.
+- Refactored landing and docs surfaces to consume those primitives while preserving the current rendered DOM semantics, visual design, behavior, and copy.
+- Kept `app/styles/design-system.css` as the token and CSS utility source of truth.
+
+## Visual QA
+
+- Browser harness: `.omo/scripts/design-system-fidelity/capture-and-drive.mjs`
+- Evidence directory: `.omo/ulw-loop/evidence/design-system-components-v3/`
+- Routes compared: `/`, `/docs`
+- Viewports compared: `390x844`, `768x1024`, `1280x800`
+- Pixel-diff summary: all 6 comparisons passed against the previous accepted screenshots with `diffPixels: 0`, `diffRatio: 0`, `similarityScore: 100`, `dimensionsMatch: true`, and `alphaChannelIntact: true`.
+- Interaction checks passed: copy install command, landing docs navigation, docs mobile menu, Command-K search focus, docs search filtering, and docs hash navigation.
+- Console/page health: no console warnings/errors and no page errors recorded during the capture run.
+- Cleanup receipt: closed Playwright Chrome contexts and browser; local Next production server stopped; port 3000 has no listener.
+
+## Automated Verification
+
+- `pnpm exec biome lint app components e2e` passed in `packages/web`.
+- `pnpm run type-check` passed in `packages/web`.
+- `pnpm run build` passed in `packages/web`.
+- `pnpm run test:e2e` passed in `packages/web`: 52/52.
+- Lighthouse in the e2e suite reached 100/100/100/100 on both mobile and desktop using real Chrome.
+
+## Notes
+
+- The refactor intentionally preserves the user-facing design exactly. This is a structural design-system extraction, not a redesign.
+- Every new TSX source file is under 250 pure LOC.
diff --git a/.omo/ulw-loop/evidence/design-system-components-v3/capture-report.json b/.omo/ulw-loop/evidence/design-system-components-v3/capture-report.json
new file mode 100644
index 00000000..8ab20716
--- /dev/null
+++ b/.omo/ulw-loop/evidence/design-system-components-v3/capture-report.json
@@ -0,0 +1,225 @@
+{
+ "generatedAt": "2026-06-24T06:18:23.681Z",
+ "control": {
+ "label": "control",
+ "baseUrl": "http://127.0.0.1:3000",
+ "captures": [
+ {
+ "route": "/",
+ "viewport": {
+ "id": "mobile",
+ "width": 390,
+ "height": 844
+ },
+ "screenshotPath": ".omo/ulw-loop/evidence/design-system-components-v3/screenshots/control/landing-mobile-390x844.png",
+ "overflow": {
+ "scrollWidth": 390,
+ "clientWidth": 390,
+ "overflowX": 0
+ }
+ },
+ {
+ "route": "/docs",
+ "viewport": {
+ "id": "mobile",
+ "width": 390,
+ "height": 844
+ },
+ "screenshotPath": ".omo/ulw-loop/evidence/design-system-components-v3/screenshots/control/docs-mobile-390x844.png",
+ "overflow": {
+ "scrollWidth": 390,
+ "clientWidth": 390,
+ "overflowX": 0
+ }
+ },
+ {
+ "route": "/",
+ "viewport": {
+ "id": "tablet",
+ "width": 768,
+ "height": 1024
+ },
+ "screenshotPath": ".omo/ulw-loop/evidence/design-system-components-v3/screenshots/control/landing-tablet-768x1024.png",
+ "overflow": {
+ "scrollWidth": 768,
+ "clientWidth": 768,
+ "overflowX": 0
+ }
+ },
+ {
+ "route": "/docs",
+ "viewport": {
+ "id": "tablet",
+ "width": 768,
+ "height": 1024
+ },
+ "screenshotPath": ".omo/ulw-loop/evidence/design-system-components-v3/screenshots/control/docs-tablet-768x1024.png",
+ "overflow": {
+ "scrollWidth": 768,
+ "clientWidth": 768,
+ "overflowX": 0
+ }
+ },
+ {
+ "route": "/",
+ "viewport": {
+ "id": "desktop",
+ "width": 1280,
+ "height": 800
+ },
+ "screenshotPath": ".omo/ulw-loop/evidence/design-system-components-v3/screenshots/control/landing-desktop-1280x800.png",
+ "overflow": {
+ "scrollWidth": 1280,
+ "clientWidth": 1280,
+ "overflowX": 0
+ }
+ },
+ {
+ "route": "/docs",
+ "viewport": {
+ "id": "desktop",
+ "width": 1280,
+ "height": 800
+ },
+ "screenshotPath": ".omo/ulw-loop/evidence/design-system-components-v3/screenshots/control/docs-desktop-1280x800.png",
+ "overflow": {
+ "scrollWidth": 1280,
+ "clientWidth": 1280,
+ "overflowX": 0
+ }
+ }
+ ],
+ "events": {
+ "console": [],
+ "pageErrors": []
+ }
+ },
+ "current": {
+ "label": "current",
+ "baseUrl": "http://127.0.0.1:3000",
+ "captures": [
+ {
+ "route": "/",
+ "viewport": {
+ "id": "mobile",
+ "width": 390,
+ "height": 844
+ },
+ "screenshotPath": ".omo/ulw-loop/evidence/design-system-components-v3/screenshots/current/landing-mobile-390x844.png",
+ "overflow": {
+ "scrollWidth": 390,
+ "clientWidth": 390,
+ "overflowX": 0
+ }
+ },
+ {
+ "route": "/docs",
+ "viewport": {
+ "id": "mobile",
+ "width": 390,
+ "height": 844
+ },
+ "screenshotPath": ".omo/ulw-loop/evidence/design-system-components-v3/screenshots/current/docs-mobile-390x844.png",
+ "overflow": {
+ "scrollWidth": 390,
+ "clientWidth": 390,
+ "overflowX": 0
+ }
+ },
+ {
+ "route": "/",
+ "viewport": {
+ "id": "tablet",
+ "width": 768,
+ "height": 1024
+ },
+ "screenshotPath": ".omo/ulw-loop/evidence/design-system-components-v3/screenshots/current/landing-tablet-768x1024.png",
+ "overflow": {
+ "scrollWidth": 768,
+ "clientWidth": 768,
+ "overflowX": 0
+ }
+ },
+ {
+ "route": "/docs",
+ "viewport": {
+ "id": "tablet",
+ "width": 768,
+ "height": 1024
+ },
+ "screenshotPath": ".omo/ulw-loop/evidence/design-system-components-v3/screenshots/current/docs-tablet-768x1024.png",
+ "overflow": {
+ "scrollWidth": 768,
+ "clientWidth": 768,
+ "overflowX": 0
+ }
+ },
+ {
+ "route": "/",
+ "viewport": {
+ "id": "desktop",
+ "width": 1280,
+ "height": 800
+ },
+ "screenshotPath": ".omo/ulw-loop/evidence/design-system-components-v3/screenshots/current/landing-desktop-1280x800.png",
+ "overflow": {
+ "scrollWidth": 1280,
+ "clientWidth": 1280,
+ "overflowX": 0
+ }
+ },
+ {
+ "route": "/docs",
+ "viewport": {
+ "id": "desktop",
+ "width": 1280,
+ "height": 800
+ },
+ "screenshotPath": ".omo/ulw-loop/evidence/design-system-components-v3/screenshots/current/docs-desktop-1280x800.png",
+ "overflow": {
+ "scrollWidth": 1280,
+ "clientWidth": 1280,
+ "overflowX": 0
+ }
+ }
+ ],
+ "events": {
+ "console": [],
+ "pageErrors": []
+ }
+ },
+ "interactions": {
+ "checks": [
+ {
+ "id": "copy-install-command",
+ "passed": true
+ },
+ {
+ "id": "landing-docs-navigation",
+ "passed": true
+ },
+ {
+ "id": "docs-mobile-menu-opens",
+ "passed": true
+ },
+ {
+ "id": "docs-command-k-focuses-search",
+ "passed": true
+ },
+ {
+ "id": "docs-search-filters-skills",
+ "passed": true
+ },
+ {
+ "id": "docs-hash-navigation",
+ "passed": true
+ }
+ ],
+ "events": {
+ "console": [],
+ "pageErrors": []
+ }
+ },
+ "allChecksPassed": true,
+ "cleanup": "closed Playwright Chrome contexts and browser"
+}
diff --git a/.omo/ulw-loop/evidence/design-system-components-v3/diffs/docs-desktop-1280x800.json b/.omo/ulw-loop/evidence/design-system-components-v3/diffs/docs-desktop-1280x800.json
new file mode 100644
index 00000000..097515ac
--- /dev/null
+++ b/.omo/ulw-loop/evidence/design-system-components-v3/diffs/docs-desktop-1280x800.json
@@ -0,0 +1,19 @@
+{
+ "command": "image-diff",
+ "dimensionsMatch": true,
+ "reference": {
+ "width": 1280,
+ "height": 43033
+ },
+ "actual": {
+ "width": 1280,
+ "height": 43033
+ },
+ "totalPixels": 55082240,
+ "diffPixels": 0,
+ "diffRatio": 0,
+ "similarityScore": 100,
+ "alphaChannelIntact": true,
+ "hotspots": [],
+ "summary": "100/100 similarity; 0/55082240 pixels differ."
+}
diff --git a/.omo/ulw-loop/evidence/design-system-components-v3/diffs/docs-mobile-390x844.json b/.omo/ulw-loop/evidence/design-system-components-v3/diffs/docs-mobile-390x844.json
new file mode 100644
index 00000000..a9c05915
--- /dev/null
+++ b/.omo/ulw-loop/evidence/design-system-components-v3/diffs/docs-mobile-390x844.json
@@ -0,0 +1,19 @@
+{
+ "command": "image-diff",
+ "dimensionsMatch": true,
+ "reference": {
+ "width": 390,
+ "height": 61427
+ },
+ "actual": {
+ "width": 390,
+ "height": 61427
+ },
+ "totalPixels": 23956530,
+ "diffPixels": 0,
+ "diffRatio": 0,
+ "similarityScore": 100,
+ "alphaChannelIntact": true,
+ "hotspots": [],
+ "summary": "100/100 similarity; 0/23956530 pixels differ."
+}
diff --git a/.omo/ulw-loop/evidence/design-system-components-v3/diffs/docs-tablet-768x1024.json b/.omo/ulw-loop/evidence/design-system-components-v3/diffs/docs-tablet-768x1024.json
new file mode 100644
index 00000000..88ef10c7
--- /dev/null
+++ b/.omo/ulw-loop/evidence/design-system-components-v3/diffs/docs-tablet-768x1024.json
@@ -0,0 +1,19 @@
+{
+ "command": "image-diff",
+ "dimensionsMatch": true,
+ "reference": {
+ "width": 768,
+ "height": 43887
+ },
+ "actual": {
+ "width": 768,
+ "height": 43887
+ },
+ "totalPixels": 33705216,
+ "diffPixels": 0,
+ "diffRatio": 0,
+ "similarityScore": 100,
+ "alphaChannelIntact": true,
+ "hotspots": [],
+ "summary": "100/100 similarity; 0/33705216 pixels differ."
+}
diff --git a/.omo/ulw-loop/evidence/design-system-components-v3/diffs/landing-desktop-1280x800.json b/.omo/ulw-loop/evidence/design-system-components-v3/diffs/landing-desktop-1280x800.json
new file mode 100644
index 00000000..4e51c872
--- /dev/null
+++ b/.omo/ulw-loop/evidence/design-system-components-v3/diffs/landing-desktop-1280x800.json
@@ -0,0 +1,19 @@
+{
+ "command": "image-diff",
+ "dimensionsMatch": true,
+ "reference": {
+ "width": 1280,
+ "height": 4654
+ },
+ "actual": {
+ "width": 1280,
+ "height": 4654
+ },
+ "totalPixels": 5957120,
+ "diffPixels": 0,
+ "diffRatio": 0,
+ "similarityScore": 100,
+ "alphaChannelIntact": true,
+ "hotspots": [],
+ "summary": "100/100 similarity; 0/5957120 pixels differ."
+}
diff --git a/.omo/ulw-loop/evidence/design-system-components-v3/diffs/landing-mobile-390x844.json b/.omo/ulw-loop/evidence/design-system-components-v3/diffs/landing-mobile-390x844.json
new file mode 100644
index 00000000..3600401c
--- /dev/null
+++ b/.omo/ulw-loop/evidence/design-system-components-v3/diffs/landing-mobile-390x844.json
@@ -0,0 +1,19 @@
+{
+ "command": "image-diff",
+ "dimensionsMatch": true,
+ "reference": {
+ "width": 390,
+ "height": 6697
+ },
+ "actual": {
+ "width": 390,
+ "height": 6697
+ },
+ "totalPixels": 2611830,
+ "diffPixels": 0,
+ "diffRatio": 0,
+ "similarityScore": 100,
+ "alphaChannelIntact": true,
+ "hotspots": [],
+ "summary": "100/100 similarity; 0/2611830 pixels differ."
+}
diff --git a/.omo/ulw-loop/evidence/design-system-components-v3/diffs/landing-tablet-768x1024.json b/.omo/ulw-loop/evidence/design-system-components-v3/diffs/landing-tablet-768x1024.json
new file mode 100644
index 00000000..67183f85
--- /dev/null
+++ b/.omo/ulw-loop/evidence/design-system-components-v3/diffs/landing-tablet-768x1024.json
@@ -0,0 +1,19 @@
+{
+ "command": "image-diff",
+ "dimensionsMatch": true,
+ "reference": {
+ "width": 768,
+ "height": 5110
+ },
+ "actual": {
+ "width": 768,
+ "height": 5110
+ },
+ "totalPixels": 3924480,
+ "diffPixels": 0,
+ "diffRatio": 0,
+ "similarityScore": 100,
+ "alphaChannelIntact": true,
+ "hotspots": [],
+ "summary": "100/100 similarity; 0/3924480 pixels differ."
+}
diff --git a/.omo/ulw-loop/evidence/design-system-components-v3/diffs/summary.json b/.omo/ulw-loop/evidence/design-system-components-v3/diffs/summary.json
new file mode 100644
index 00000000..6813332f
--- /dev/null
+++ b/.omo/ulw-loop/evidence/design-system-components-v3/diffs/summary.json
@@ -0,0 +1,56 @@
+[
+ {
+ "file": "docs-desktop-1280x800.json",
+ "dimensionsMatch": true,
+ "diffPixels": 0,
+ "diffRatio": 0,
+ "similarityScore": 100,
+ "alphaChannelIntact": true,
+ "hotspots": 0
+ },
+ {
+ "file": "docs-mobile-390x844.json",
+ "dimensionsMatch": true,
+ "diffPixels": 0,
+ "diffRatio": 0,
+ "similarityScore": 100,
+ "alphaChannelIntact": true,
+ "hotspots": 0
+ },
+ {
+ "file": "docs-tablet-768x1024.json",
+ "dimensionsMatch": true,
+ "diffPixels": 0,
+ "diffRatio": 0,
+ "similarityScore": 100,
+ "alphaChannelIntact": true,
+ "hotspots": 0
+ },
+ {
+ "file": "landing-desktop-1280x800.json",
+ "dimensionsMatch": true,
+ "diffPixels": 0,
+ "diffRatio": 0,
+ "similarityScore": 100,
+ "alphaChannelIntact": true,
+ "hotspots": 0
+ },
+ {
+ "file": "landing-mobile-390x844.json",
+ "dimensionsMatch": true,
+ "diffPixels": 0,
+ "diffRatio": 0,
+ "similarityScore": 100,
+ "alphaChannelIntact": true,
+ "hotspots": 0
+ },
+ {
+ "file": "landing-tablet-768x1024.json",
+ "dimensionsMatch": true,
+ "diffPixels": 0,
+ "diffRatio": 0,
+ "similarityScore": 100,
+ "alphaChannelIntact": true,
+ "hotspots": 0
+ }
+]
diff --git a/.omo/ulw-loop/evidence/design-system-components-v3/screenshots/control/docs-desktop-1280x800.png b/.omo/ulw-loop/evidence/design-system-components-v3/screenshots/control/docs-desktop-1280x800.png
new file mode 100644
index 00000000..6d8b7fa9
Binary files /dev/null and b/.omo/ulw-loop/evidence/design-system-components-v3/screenshots/control/docs-desktop-1280x800.png differ
diff --git a/.omo/ulw-loop/evidence/design-system-components-v3/screenshots/control/docs-mobile-390x844.png b/.omo/ulw-loop/evidence/design-system-components-v3/screenshots/control/docs-mobile-390x844.png
new file mode 100644
index 00000000..7336ec8a
Binary files /dev/null and b/.omo/ulw-loop/evidence/design-system-components-v3/screenshots/control/docs-mobile-390x844.png differ
diff --git a/.omo/ulw-loop/evidence/design-system-components-v3/screenshots/control/docs-tablet-768x1024.png b/.omo/ulw-loop/evidence/design-system-components-v3/screenshots/control/docs-tablet-768x1024.png
new file mode 100644
index 00000000..3e3bda84
Binary files /dev/null and b/.omo/ulw-loop/evidence/design-system-components-v3/screenshots/control/docs-tablet-768x1024.png differ
diff --git a/.omo/ulw-loop/evidence/design-system-components-v3/screenshots/control/landing-desktop-1280x800.png b/.omo/ulw-loop/evidence/design-system-components-v3/screenshots/control/landing-desktop-1280x800.png
new file mode 100644
index 00000000..6b673c5d
Binary files /dev/null and b/.omo/ulw-loop/evidence/design-system-components-v3/screenshots/control/landing-desktop-1280x800.png differ
diff --git a/.omo/ulw-loop/evidence/design-system-components-v3/screenshots/control/landing-mobile-390x844.png b/.omo/ulw-loop/evidence/design-system-components-v3/screenshots/control/landing-mobile-390x844.png
new file mode 100644
index 00000000..dbb41f93
Binary files /dev/null and b/.omo/ulw-loop/evidence/design-system-components-v3/screenshots/control/landing-mobile-390x844.png differ
diff --git a/.omo/ulw-loop/evidence/design-system-components-v3/screenshots/control/landing-tablet-768x1024.png b/.omo/ulw-loop/evidence/design-system-components-v3/screenshots/control/landing-tablet-768x1024.png
new file mode 100644
index 00000000..05607bf3
Binary files /dev/null and b/.omo/ulw-loop/evidence/design-system-components-v3/screenshots/control/landing-tablet-768x1024.png differ
diff --git a/.omo/ulw-loop/evidence/design-system-components-v3/screenshots/current/docs-desktop-1280x800.png b/.omo/ulw-loop/evidence/design-system-components-v3/screenshots/current/docs-desktop-1280x800.png
new file mode 100644
index 00000000..6d8b7fa9
Binary files /dev/null and b/.omo/ulw-loop/evidence/design-system-components-v3/screenshots/current/docs-desktop-1280x800.png differ
diff --git a/.omo/ulw-loop/evidence/design-system-components-v3/screenshots/current/docs-mobile-390x844.png b/.omo/ulw-loop/evidence/design-system-components-v3/screenshots/current/docs-mobile-390x844.png
new file mode 100644
index 00000000..7336ec8a
Binary files /dev/null and b/.omo/ulw-loop/evidence/design-system-components-v3/screenshots/current/docs-mobile-390x844.png differ
diff --git a/.omo/ulw-loop/evidence/design-system-components-v3/screenshots/current/docs-tablet-768x1024.png b/.omo/ulw-loop/evidence/design-system-components-v3/screenshots/current/docs-tablet-768x1024.png
new file mode 100644
index 00000000..3e3bda84
Binary files /dev/null and b/.omo/ulw-loop/evidence/design-system-components-v3/screenshots/current/docs-tablet-768x1024.png differ
diff --git a/.omo/ulw-loop/evidence/design-system-components-v3/screenshots/current/landing-desktop-1280x800.png b/.omo/ulw-loop/evidence/design-system-components-v3/screenshots/current/landing-desktop-1280x800.png
new file mode 100644
index 00000000..6b673c5d
Binary files /dev/null and b/.omo/ulw-loop/evidence/design-system-components-v3/screenshots/current/landing-desktop-1280x800.png differ
diff --git a/.omo/ulw-loop/evidence/design-system-components-v3/screenshots/current/landing-mobile-390x844.png b/.omo/ulw-loop/evidence/design-system-components-v3/screenshots/current/landing-mobile-390x844.png
new file mode 100644
index 00000000..dbb41f93
Binary files /dev/null and b/.omo/ulw-loop/evidence/design-system-components-v3/screenshots/current/landing-mobile-390x844.png differ
diff --git a/.omo/ulw-loop/evidence/design-system-components-v3/screenshots/current/landing-tablet-768x1024.png b/.omo/ulw-loop/evidence/design-system-components-v3/screenshots/current/landing-tablet-768x1024.png
new file mode 100644
index 00000000..05607bf3
Binary files /dev/null and b/.omo/ulw-loop/evidence/design-system-components-v3/screenshots/current/landing-tablet-768x1024.png differ
diff --git a/.omo/ulw-loop/evidence/design-system-components-v3/screenshots/interactions/docs-desktop-search-hash-1280x800.png b/.omo/ulw-loop/evidence/design-system-components-v3/screenshots/interactions/docs-desktop-search-hash-1280x800.png
new file mode 100644
index 00000000..d0a7512c
Binary files /dev/null and b/.omo/ulw-loop/evidence/design-system-components-v3/screenshots/interactions/docs-desktop-search-hash-1280x800.png differ
diff --git a/.omo/ulw-loop/evidence/design-system-components-v3/screenshots/interactions/docs-mobile-menu-open-390x844.png b/.omo/ulw-loop/evidence/design-system-components-v3/screenshots/interactions/docs-mobile-menu-open-390x844.png
new file mode 100644
index 00000000..51a0c13d
Binary files /dev/null and b/.omo/ulw-loop/evidence/design-system-components-v3/screenshots/interactions/docs-mobile-menu-open-390x844.png differ
diff --git a/packages/web/DESIGN.md b/packages/web/DESIGN.md
index 8a34253c..c8f9920d 100644
--- a/packages/web/DESIGN.md
+++ b/packages/web/DESIGN.md
@@ -2,80 +2,169 @@
Implementation sources:
- Browser CSS tokens and shared utility layers live in `app/styles/design-system.css`, imported before page-specific styles by `app/globals.css`.
+- Reusable React primitives live in `components/design-system/`; landing and docs components compose from those primitives.
- Social preview tokens live in `app/og-image-theme.ts` and intentionally mirror the browser palette.
- Page-specific composition styles live in `app/styles/landing.css` and `app/styles/docs.css`.
-## 1. Core Philosophy
-- **Complex-Codebase Harness Tone**: A near-black canvas with a faint cool-green undertone, centered on a glowing emerald card that presents LazyCodex as the Codex agent harness for serious repositories. The brand color is green — emerald/mint — not the earlier teal.
-- **Card-in-Canvas Architecture**: The hero content lives inside a 1200x630px card with a complex radial gradient; the OpenGraph image mirrors that HTML card instead of using a separate visual language.
-- **Typography**: A native system grotesk (`ui-sans-serif, system-ui, …`) for the wordmark and body so the LCP paint has zero webfont dependency and lands at FCP; monospace (`ui-monospace, …`) for eyebrows, code, labels, and kbd hints.
-
-## 2. Color Palette
-Surfaces (near-black, cool-green undertone):
-- `--surface-base` / `--surface-night` / `--surface-0`: `#0a0c0b`
-- `--surface-1`: `rgba(255,255,255,0.018)` · `--surface-2`: `rgba(255,255,255,0.035)` · `--surface-3`: `rgba(255,255,255,0.055)`
-- `--card-base` / `--surface-panel`: `#0E1411` · `--surface-panel-alt`: `#0C1310` · `--surface-panel-deep`: `#0D1310`
-
-Brand (green core):
-- `--brand-core`: `#22c55e` · `--brand-mid`: `#16a34a` · `--brand-outer`: `#15803d`
-
-Accent (the live-wire green):
-- `--accent-primary`: `#4ade80` · `--accent-primary-soft`: `rgba(74,222,128,0.1)` · `--accent-primary-border`: `rgba(74,222,128,0.24)`
-- `--accent-mint`: `#86efac` · `--accent-glow`: `#86efac`
-- Legacy aliases `--accent-cyan` / `--accent-teal` are mapped to the green values for compatibility; new code uses `--accent-primary` / `--accent-mint`.
-
-Text:
-- `--text-primary`: `#ffffff` · `--text-secondary`: `#b8c2bc` · `--text-tertiary`: `#8b9690`
-- `--text-muted`: `rgba(255,255,255,0.74)` · `--text-soft`: `#dcfce7` (mint-tinted)
-
-Borders / status:
-- `--border-subtle`: `rgba(255,255,255,0.06)` · `--border-default`: `rgba(255,255,255,0.1)`
-- `--status-success`: `#22c55e` · `--status-warning`: `#f59e0b` · `--status-error`: `#ef4444`
-
-## 3. Brand Mark
-- A rounded-square emerald mark with an "L" stroke and a mint dot — a clean geometric identity replacing the earlier boulder. Inline SVG in the header (zero network bytes), mirrored in the favicon and OG image.
-- `app/icon.svg` is the canonical scalable favicon; `app/apple-icon.png` at 180x180 for Apple touch surfaces.
-
-## 4. Layout & Spacing
-- **Landing canvas**: Full viewport (`min-h-[100dvh]`), flex column, centered. Hero card max width 1200px, aspect ratio 1200/630 on large screens, `16px` radius.
-- **Docs**: three-column grid on desktop — `260px` sidebar | fluid content | `220px` right ToC. Collapses to two columns (hide ToC) under 1100px and to a single column with a mobile menu toggle under 768px. Every container uses `min-h-[100dvh]` (never `h-screen`) and `dvh` for iOS Safari stability. No flexbox percentage math; CSS Grid for multi-column.
-
-## 5. Gradients & Effects
-- **Base Gradient**: radial from `#22c55e` through `#16a34a` and `#15803d` into `#0a0c0b`.
-- **Beam**: screen blend mode, soft mint light pouring from top-left.
-- **Sheen**: screen blend mode, diagonal linear gradients with blur.
-- **Pools**: screen blend mode, subtle emerald/mint pools at bottom-left and top-right.
-
-## 6. Docs Information Architecture (vibetip-inspired)
-The docs are a single richly-sectioned page with a grouped sidebar, ⌘K search, a per-section right-side table of contents, and prev/next navigation cards — inspired by the lzx.vibetip.help docs layout.
-
-- **Sidebar groups** (ordered): Install · Getting started · Commands · Skills · Concepts · Reference.
-- **⌘K / Ctrl-K** focuses the search field from anywhere; typing filters sidebar entries by title.
-- **Right ToC ("On this section")** lists the active section's `h2`/`h3` headings with scroll-spy highlighting.
-- **Prev/next cards** at the end of every section link to the neighboring section.
-- **Docs hero** carries a version badge (`SITE_CONFIG.version`), title, and tagline.
-- Content is authored as `content/docs/*.md`, compiled to HTML at build time by `scripts/generate-docs-content.mjs`, which also injects heading ids and emits a per-section TOC (`DOC_TOC`) alongside `DOC_SOURCES`.
-
-## 7. Motion
-- Hero uses a `splash-reveal` keyframe (opacity + translate) gated by `prefers-reduced-motion`.
-- All interactive transitions (nav links, ToC links, prev/next cards, buttons) are short color/transform tweens, disabled under `prefers-reduced-motion`. No layout-property animation; no full `framer-motion` import.
-
-## 8. Performance & SEO Posture
-- System font stack for the LCP wordmark so the largest paint has no webfont download and lands at FCP under any throttle.
-- Image-free hero (pure CSS gradients) keeps the hero text as the LCP element.
-- Explicit `width`/`height` on every `<img>` to prevent CLS; `loading`/`fetchPriority`/`decoding` driven by `priority`.
-- Per-route `metadata`, JSON-LD `SoftwareApplication`, `sitemap.ts`, `robots.ts`, and OG/Twitter image routes.
-
-## 9. Component Families
-- **Brand mark**: inline SVG rounded square, `var(--card-base)` fill, `var(--accent-primary)` stroke, mint dot. Do not replace it with raster imagery above the fold.
-- **Hero card**: `var(--card-base)` surface, 20px browser radius, layered `.card-gradient-*` utilities, large left-aligned wordmark, right-anchored mark on desktop.
-- **Command cards**: `var(--surface-panel)` surface, subtle white border, mono heading/code, green icon well, and dot-list facts.
-- **Docs shell**: CSS Grid desktop layout (`260px | content | 220px`), sticky sidebar and ToC, mobile menu toggle under 768px, active nav indicated by a straight vertical bar.
-- **Interactive states**: short color/transform transitions, focus rings from `:focus-visible`, no layout-property animation.
-
-## 10. Anti-Patterns
-- Generic AI-SaaS slop copy. Use concrete product language.
-- Teal/cyan brand colors (replaced by emerald/mint). The earlier teal identity is gone; green is the brand.
-- `export const runtime = "edge"` (incompatible with `@opennextjs/cloudflare`).
-- Animating `width / height / top / left / margin / padding`.
-- Importing the full `framer-motion` package.
+## 1. Atmosphere & Identity
+
+LazyCodex feels like a serious command surface for complex codebases: near-black, quiet, technical, and lit by an emerald signal. The signature is a glowing green card-in-canvas composition with a geometric rounded-square `L` mark. The brand color is green, not teal, cyan, purple, or blue.
+
+## 2. Color
+
+### Palette
+
+| Role | Token | Value | Usage |
+| --- | --- | --- | --- |
+| Surface/base | `--surface-base`, `--surface-night`, `--surface-0` | `#0a0c0b` | Page canvas and footer |
+| Surface/subtle | `--surface-1` | `rgba(255,255,255,0.018)` | Hover and quiet fills |
+| Surface/raised | `--surface-2` | `rgba(255,255,255,0.035)` | Secondary tonal layer |
+| Surface/strong | `--surface-3` | `rgba(255,255,255,0.055)` | Stronger tonal layer |
+| Surface/card | `--card-base`, `--surface-panel` | `#0E1411` | Hero card, command surfaces |
+| Surface/alt | `--surface-panel-alt` | `#0C1310` | Alternate panel |
+| Surface/deep | `--surface-panel-deep` | `#0D1310` | Deep panel |
+| Brand/core | `--brand-core` | `#22c55e` | Green brand center |
+| Brand/mid | `--brand-mid` | `#16a34a` | Green gradient middle |
+| Brand/outer | `--brand-outer` | `#15803d` | Selection and gradient edge |
+| Accent/primary | `--accent-primary` | `#4ade80` | CTAs, focus, active docs links |
+| Accent/soft | `--accent-primary-soft` | `rgba(74,222,128,0.1)` | Soft green fills |
+| Accent/border | `--accent-primary-border` | `rgba(74,222,128,0.24)` | Soft green outlines |
+| Accent/mint | `--accent-mint`, `--accent-glow` | `#86efac` | Highlights, glow text |
+| Text/primary | `--text-primary` | `#ffffff` | Main text and headings |
+| Text/secondary | `--text-secondary` | `#b8c2bc` | Supporting text |
+| Text/tertiary | `--text-tertiary` | `#8b9690` | Labels, metadata |
+| Text/muted | `--text-muted` | `rgba(255,255,255,0.74)` | Body copy on dark surfaces |
+| Text/soft | `--text-soft` | `#dcfce7` | Mint-tinted text |
+| Border/subtle | `--border-subtle` | `rgba(255,255,255,0.06)` | Dividers and quiet controls |
+| Border/default | `--border-default` | `rgba(255,255,255,0.1)` | Panels and cards |
+| Status/success | `--status-success` | `#22c55e` | Positive status |
+| Status/warning | `--status-warning` | `#f59e0b` | Warnings |
+| Status/error | `--status-error` | `#ef4444` | Errors |
+
+### Rules
+
+- New UI uses `--accent-primary` and `--accent-mint`; `--accent-cyan` and `--accent-teal` remain green aliases only for compatibility.
+- Accent is reserved for interactivity, code emphasis, focus, and brand signal.
+- Raw colors belong in this file, `design-system.css`, or OG theme tokens. Component code should reference tokens or shared primitives.
+
+## 3. Typography
+
+### Scale
+
+| Level | Size | Weight | Line height | Tracking | Usage |
+| --- | --- | --- | --- | --- | --- |
+| Display | `clamp(44px,7vw,104px)` | 600 | 0.95 | -0.03em | Landing wordmark |
+| Hero lead | `clamp(18px,2.2vw,26px)` | 400 | 1.4 | -0.005em | Landing lead |
+| Section XL | `clamp(32px,5vw,56px)` | 500-600 | tight | 0 to tight | Large marketing sections |
+| Section L | `clamp(28px,4vw,48px)` | 500-600 | tight | tight | Showcase titles |
+| Docs H1 | `clamp(2rem,3.5vw,2.6rem)` | 700 | tight | -0.02em | Docs page title |
+| Docs H2 | `1.75rem` | 700 | normal | -0.02em | Docs section title |
+| Body | `1rem` | 400 | 1.55-1.7 | 0 | Default prose |
+| Body small | `0.875rem` | 400-500 | 1.4-1.5 | 0 | Cards, docs nav |
+| Caption | `0.75rem` | 500-600 | 1.3-1.4 | uppercase | Badges, labels |
+
+### Font Stack
+
+- Primary: `ui-sans-serif, system-ui, -apple-system, "Segoe UI", Roboto, Helvetica, Arial, sans-serif`
+- Mono: `ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, "Liberation Mono", monospace`
+- The landing wordmark intentionally uses the native primary stack so the LCP text has no webfont dependency.
+
+## 4. Spacing & Layout
+
+### Base Unit
+
+All spacing resolves to a 4px rhythm. Existing Tailwind values map to the same rhythm: `gap-2` 8px, `gap-3` 12px, `gap-4` 16px, `gap-6` 24px, `mt-24` 96px, `mt-32` 128px, `mt-40` 160px.
+
+### Grid
+
+- Max marketing content width: `1200px`.
+- Docs max width: `1280px`.
+- Docs desktop grid: `260px | minmax(0, 1fr) | 220px`.
+- Docs collapse: hide the ToC below `1100px`; single column and mobile menu below `768px`.
+- Full-height surfaces use `min-h-[100dvh]`, never `h-screen`.
+
+### Rules
+
+- `MarketingContainer`, `MarketingSection`, and `MarketingRuleGrid` in `components/design-system/layout.tsx` own the repeated page width and split-section geometry.
+- Use CSS Grid for multi-column layouts. Avoid percentage flex math.
+- Preserve the existing information architecture: landing first, docs as a single richly-sectioned page.
+
+## 5. Components
+
+### BrandMark
+
+- **Source**: `components/design-system/brand-mark.tsx`.
+- **Structure**: inline SVG rounded square, `L` stroke, mint/green dot.
+- **Variants**: `nav` 24px geometry, `hero` 160px geometry with `HeroBrandMark` glow wrapper.
+- **States**: inherited from the containing link or surface.
+- **Accessibility**: decorative mark uses `aria-hidden`; header link owns the accessible label.
+
+### Layout Primitives
+
+- **Source**: `components/design-system/layout.tsx`.
+- **Components**: `PageShell`, `SkipLink`, `MarketingMain`, `MarketingContainer`, `MarketingSection`, `MarketingRuleGrid`.
+- **Usage**: pages and repeated landing bands. They preserve the current DOM semantics while centralizing width, `dvh`, and split-grid rules.
+
+### Typography Primitives
+
+- **Source**: `components/design-system/typography.tsx`.
+- **Components**: `Kicker`, `SectionHeading`, `BodyText`, `GradientTitle`, `AccentBadge`, `InlineCode`.
+- **Usage**: marketing sections, showcase titles, badges, and command/code snippets.
+- **Motion**: typography itself does not animate; reveal behavior remains in CSS utilities.
+
+### Surface Primitives
+
+- **Source**: `components/design-system/surfaces.tsx`.
+- **Components**: `SurfaceCard`, `AccentSurface`, `ShowcaseSurface`, `CommandCodeSurface`, `IconWell`, `FactList`, `CompactDotList`, `NumberedPoint`.
+- **Usage**: command cards, OmO/Lazy comparison cards, Hephaestus and Ultrawork black showcases, numbered workflow rows.
+- **Depth**: border plus tonal shift, with showcase shadows only where already present.
+
+### Action Primitives
+
+- **Source**: `components/design-system/actions.tsx`.
+- **Components**: `LinkAction`, `GlowActionFrame`.
+- **Variants**: primary filled text button, secondary outlined button.
+- **States**: hover scale or tonal shift, visible focus ring, no layout-property animation.
+
+### DocsHero
+
+- **Source**: `components/design-system/docs-hero.tsx`.
+- **Structure**: version badge, title, tagline using the existing docs CSS hooks.
+- **Usage**: docs page header; intentionally keeps the current `docs-*` class contract for pixel-stable docs layout.
+
+## 6. Motion & Interaction
+
+### Timing
+
+| Type | Duration | Usage |
+| --- | --- | --- |
+| Micro | 150ms | Nav links, docs links, inputs |
+| Standard | 200-300ms | Buttons, card hover, focus feedback |
+| Splash | 720ms | Landing reveal only |
+
+### Rules
+
+- Animate `transform`, `opacity`, `filter`, and color only. Never animate width, height, top, left, margin, or padding.
+- Respect `prefers-reduced-motion`; `splash-reveal` disables itself.
+- Focus states are visible through global `:focus-visible` and component-level rings.
+- Docs interactions must keep working: mobile menu, sidebar search, Cmd/Ctrl-K focus, hash navigation, scroll-spy, and prev/next cards.
+
+## 7. Depth & Surface
+
+### Strategy
+
+LazyCodex uses a mixed but constrained depth strategy: tonal-shift panels and borders for everyday surfaces, plus existing deep showcase shadows for the landing hero and black showcase panels.
+
+| Level | Treatment | Usage |
+| --- | --- | --- |
+| Canvas | `--surface-base` | Whole site background |
+| Panel | `--surface-panel` or `bg-white/[0.03]` with subtle border | Cards, install bar, docs input |
+| Accent panel | `--accent-primary` soft fill and border | Built-in skills, Lazy comparison, workflow code |
+| Showcase | black surface, ring, green radial glow, shadow | Hephaestus and Ultrawork feature blocks |
+| Hero | `--card-base`, layered `.card-gradient-*`, large shadow | Landing hero card |
+
+### Rules
+
+- Do not add generic white cards or purple-blue gradients.
+- Do not replace the hero or brand mark with raster screenshots.
+- If a component pattern appears twice, it belongs in `components/design-system/` and this section.
diff --git a/packages/web/app/docs/page.tsx b/packages/web/app/docs/page.tsx
index b9a377f5..b02ab0ce 100644
--- a/packages/web/app/docs/page.tsx
+++ b/packages/web/app/docs/page.tsx
@@ -1,4 +1,6 @@
import type { Metadata } from "next";
+import { DocsHero } from "@/components/design-system/docs-hero";
+import { SkipLink } from "@/components/design-system/layout";
import { DocsShell, type SectionView } from "@/components/docs/docs-shell";
import { SiteFooter } from "@/components/site/site-footer";
import { SiteHeader } from "@/components/site/site-header";
@@ -32,22 +34,13 @@ export default function DocsPage() {
return (
<>
- <a href="#content" className="skip-link">
- Skip to main content
- </a>
+ <SkipLink />
<SiteHeader />
<main id="content" className="docs-page">
- <div className="docs-hero">
- <div className="docs-hero-badge">
- <span className="docs-hero-dot" aria-hidden="true" />
- {SITE_CONFIG.version}
- </div>
- <h1 className="docs-hero-title">Documentation</h1>
- <p className="docs-hero-tagline">
- Install and run the OmO harness inside Codex for complex codebases —
- project memory, planning, execution, and verified completion.
- </p>
- </div>
+ <DocsHero badge={SITE_CONFIG.version} title="Documentation">
+ Install and run the OmO harness inside Codex for complex codebases —
+ project memory, planning, execution, and verified completion.
+ </DocsHero>
<DocsShell sections={sections} />
</main>
<SiteFooter />
diff --git a/packages/web/app/page.tsx b/packages/web/app/page.tsx
index f6fec7a9..ba9c8d1d 100644
--- a/packages/web/app/page.tsx
+++ b/packages/web/app/page.tsx
@@ -1,4 +1,10 @@
import type { JSX } from "react"
+import {
+ MarketingContainer,
+ MarketingMain,
+ PageShell,
+ SkipLink,
+} from "../components/design-system/layout"
import { CommandCards } from "../components/site/command-cards"
import { DocsCta } from "../components/site/docs-cta"
import { FeatureWorkflowsSection } from "../components/site/feature-workflows-section"
@@ -11,29 +17,24 @@ import { UltraworkSection } from "../components/site/ultrawork-section"
export default function LandingPage(): JSX.Element {
return (
- <div className="flex min-h-[100dvh] flex-col">
- <a
- href="#content"
- className="sr-only focus:not-sr-only focus:absolute focus:left-4 focus:top-4 focus:z-50 focus:rounded-md focus:bg-[color:var(--card-base)] focus:px-3 focus:py-2 focus:text-sm focus:text-[color:var(--text-primary)]"
- >
- Skip to main content
- </a>
+ <PageShell>
+ <SkipLink className="sr-only focus:not-sr-only focus:absolute focus:left-4 focus:top-4 focus:z-50 focus:rounded-md focus:bg-[color:var(--card-base)] focus:px-3 focus:py-2 focus:text-sm focus:text-[color:var(--text-primary)]" />
<SiteHeader />
- <main id="content" className="flex-1 pb-16 pt-6 md:pt-8">
- <div className="mx-auto max-w-[1200px] px-4 md:px-8">
+ <MarketingMain>
+ <MarketingContainer>
<Hero />
- </div>
+ </MarketingContainer>
<InstallBlock />
<CommandCards />
<FeatureWorkflowsSection />
<HephaestusSection />
<UltraworkSection />
<DocsCta />
- </main>
+ </MarketingMain>
<SiteFooter />
- </div>
+ </PageShell>
)
}
diff --git a/packages/web/components/design-system/actions.tsx b/packages/web/components/design-system/actions.tsx
new file mode 100644
index 00000000..1ef56d3c
--- /dev/null
+++ b/packages/web/components/design-system/actions.tsx
@@ -0,0 +1,45 @@
+import type { JSX, ReactNode } from "react"
+import Link from "next/link"
+import { cx } from "./utils"
+
+interface LinkActionProps {
+ readonly children: ReactNode
+ readonly className?: string
+ readonly href: string
+ readonly prefetch?: false
+ readonly variant?: "primary" | "secondary"
+}
+
+const actionClassName = {
+ primary:
+ "relative block rounded-md bg-[color:var(--text-primary)] px-6 py-3 font-medium text-[color:var(--surface-base)] transition-transform hover:scale-105 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[color:var(--accent-primary)] focus-visible:ring-offset-2 focus-visible:ring-offset-[color:var(--surface-panel)]",
+ secondary:
+ "rounded-md border border-white/20 bg-transparent px-6 py-3 font-medium text-[color:var(--text-primary)] transition-colors hover:bg-white/5 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[color:var(--accent-primary)] focus-visible:ring-offset-2 focus-visible:ring-offset-[color:var(--surface-panel)]",
+} as const
+
+export function LinkAction({
+ children,
+ className,
+ href,
+ prefetch = false,
+ variant = "secondary",
+}: LinkActionProps): JSX.Element {
+ return (
+ <Link
+ href={href}
+ prefetch={prefetch}
+ className={cx(actionClassName[variant], className)}
+ >
+ {children}
+ </Link>
+ )
+}
+
+export function GlowActionFrame({ children }: { readonly children: ReactNode }): JSX.Element {
+ return (
+ <div className="relative group">
+ <div className="absolute -inset-1 rounded-lg bg-[color:var(--accent-mint)] opacity-20 blur-xl transition-opacity group-hover:opacity-30" />
+ {children}
+ </div>
+ )
+}
diff --git a/packages/web/components/design-system/brand-mark.tsx b/packages/web/components/design-system/brand-mark.tsx
new file mode 100644
index 00000000..02851b2f
--- /dev/null
+++ b/packages/web/components/design-system/brand-mark.tsx
@@ -0,0 +1,89 @@
+import type { JSX } from "react"
+import { cx } from "./utils"
+
+interface BrandMarkProps {
+ readonly className?: string
+ readonly dotFill?: string
+ readonly size?: "nav" | "hero"
+}
+
+const markGeometry = {
+ nav: {
+ circle: { cx: "15.6", cy: "9", r: "1.6" },
+ path: "M8 9 V15.2 H14.6",
+ rect: { size: "17.6", x: "3.2", y: "3.2", rx: "4.4" },
+ strokeWidth: "1.3",
+ width: "24",
+ },
+ hero: {
+ circle: { cx: "15.8", cy: "8", r: "1.4" },
+ path: "M7 8 V16 H14.5",
+ rect: { size: "19.2", x: "2.4", y: "2.4", rx: "4.8" },
+ strokeWidth: "1",
+ width: "160",
+ },
+} as const
+
+export function BrandMark({
+ className,
+ dotFill = "var(--accent-mint)",
+ size = "nav",
+}: BrandMarkProps): JSX.Element {
+ const geometry = markGeometry[size]
+
+ return (
+ <svg
+ width={geometry.width}
+ height={geometry.width}
+ viewBox="0 0 24 24"
+ fill="none"
+ aria-hidden="true"
+ className={className}
+ >
+ <rect
+ x={geometry.rect.x}
+ y={geometry.rect.y}
+ width={geometry.rect.size}
+ height={geometry.rect.size}
+ rx={geometry.rect.rx}
+ fill="var(--card-base)"
+ stroke="var(--accent-primary)"
+ strokeWidth={geometry.strokeWidth}
+ />
+ <path
+ d={geometry.path}
+ fill="none"
+ stroke={size === "hero" ? "var(--accent-mint)" : "var(--accent-primary)"}
+ strokeWidth={size === "hero" ? "1.4" : "1.7"}
+ strokeLinecap="round"
+ strokeLinejoin="round"
+ />
+ <circle
+ cx={geometry.circle.cx}
+ cy={geometry.circle.cy}
+ r={geometry.circle.r}
+ fill={dotFill}
+ />
+ </svg>
+ )
+}
+
+export function HeroBrandMark(): JSX.Element {
+ return (
+ <div className="relative flex h-[180px] w-[180px] items-center justify-center md:h-[220px] md:w-[220px]">
+ <div
+ className="absolute inset-0 rounded-[28px] opacity-60 blur-2xl"
+ style={{
+ background:
+ "radial-gradient(circle at 50% 50%, rgba(74,222,128,0.45) 0%, transparent 70%)",
+ }}
+ aria-hidden="true"
+ />
+ <BrandMark
+ size="hero"
+ dotFill="var(--accent-primary)"
+ className={cx("relative h-[140px] w-[140px] md:h-[160px] md:w-[160px]")}
+ />
+ </div>
+ )
+}
diff --git a/packages/web/components/design-system/docs-hero.tsx b/packages/web/components/design-system/docs-hero.tsx
new file mode 100644
index 00000000..4119c587
--- /dev/null
+++ b/packages/web/components/design-system/docs-hero.tsx
@@ -0,0 +1,20 @@
+import type { JSX, ReactNode } from "react"
+
+interface DocsHeroProps {
+ readonly badge: ReactNode
+ readonly children: ReactNode
+ readonly title: string
+}
+
+export function DocsHero({ badge, children, title }: DocsHeroProps): JSX.Element {
+ return (
+ <div className="docs-hero">
+ <div className="docs-hero-badge">
+ <span className="docs-hero-dot" aria-hidden="true" />
+ {badge}
+ </div>
+ <h1 className="docs-hero-title">{title}</h1>
+ <p className="docs-hero-tagline">{children}</p>
+ </div>
+ )
+}
diff --git a/packages/web/components/design-system/layout.tsx b/packages/web/components/design-system/layout.tsx
new file mode 100644
index 00000000..86e4d774
--- /dev/null
+++ b/packages/web/components/design-system/layout.tsx
@@ -0,0 +1,70 @@
+import type { JSX, ReactNode } from "react"
+import { cx } from "./utils"
+
+interface ChildrenProps {
+ readonly children: ReactNode
+}
+
+interface ClassNameProps extends ChildrenProps {
+ readonly className?: string
+}
+
+interface SkipLinkProps {
+ readonly children?: ReactNode
+ readonly className?: string
+ readonly href?: string
+}
+
+export function PageShell({ children }: ChildrenProps): JSX.Element {
+ return <div className="flex min-h-[100dvh] flex-col">{children}</div>
+}
+
+export function SkipLink({
+ children = "Skip to main content",
+ className = "skip-link",
+ href = "#content",
+}: SkipLinkProps): JSX.Element {
+ return (
+ <a href={href} className={className}>
+ {children}
+ </a>
+ )
+}
+
+export function MarketingMain({ children }: ChildrenProps): JSX.Element {
+ return (
+ <main id="content" className="flex-1 pb-16 pt-6 md:pt-8">
+ {children}
+ </main>
+ )
+}
+
+export function MarketingContainer({
+ children,
+ className,
+}: ClassNameProps): JSX.Element {
+ return (
+ <div className={cx("mx-auto max-w-[1200px] px-4 md:px-8", className)}>
+ {children}
+ </div>
+ )
+}
+
+export function MarketingSection({
+ children,
+ className,
+}: ClassNameProps): JSX.Element {
+ return (
+ <section className={cx("mx-auto w-full max-w-[1200px] px-4 md:px-8", className)}>
+ {children}
+ </section>
+ )
+}
+
+export function MarketingRuleGrid({ children }: ChildrenProps): JSX.Element {
+ return (
+ <div className="grid gap-8 border-y border-white/10 py-12 md:grid-cols-[minmax(0,0.9fr)_minmax(0,1.1fr)] md:py-16">
+ {children}
+ </div>
+ )
+}
diff --git a/packages/web/components/design-system/surfaces.tsx b/packages/web/components/design-system/surfaces.tsx
new file mode 100644
index 00000000..00939ae1
--- /dev/null
+++ b/packages/web/components/design-system/surfaces.tsx
@@ -0,0 +1,120 @@
+import type { JSX, ReactNode } from "react"
+import { cx } from "./utils"
+
+interface ChildrenProps {
+ readonly children: ReactNode
+ readonly className?: string
+}
+
+interface FactListProps {
+ readonly items: readonly string[]
+ readonly dotClassName?: string
+}
+
+interface NumberedPointProps {
+ readonly index: number
+ readonly label: string
+ readonly text: string
+}
+
+export function SurfaceCard({ children, className }: ChildrenProps): JSX.Element {
+ return (
+ <div className={cx("rounded-lg border border-white/10 bg-white/[0.03] p-5", className)}>
+ {children}
+ </div>
+ )
+}
+
+export function AccentSurface({ children, className }: ChildrenProps): JSX.Element {
+ return (
+ <div
+ className={cx(
+ "rounded-lg border border-[color:var(--accent-primary)]/20 bg-[color:var(--accent-primary)]/5 p-5",
+ className,
+ )}
+ >
+ {children}
+ </div>
+ )
+}
+
+export function ShowcaseSurface({ children, className }: ChildrenProps): JSX.Element {
+ return (
+ <div
+ className={cx(
+ "relative flex w-full flex-col items-center rounded-3xl bg-black px-4 py-16 shadow-2xl ring-1 ring-white/5",
+ className,
+ )}
+ >
+ <div className="absolute inset-0 -z-10 bg-[radial-gradient(circle_at_center,rgba(74,222,128,0.08)_0%,transparent_70%)] blur-3xl" />
+ {children}
+ </div>
+ )
+}
+
+export function CommandCodeSurface({ children }: ChildrenProps): JSX.Element {
+ return <div className="rounded-md bg-black/40 p-3">{children}</div>
+}
+
+export function IconWell({ children }: ChildrenProps): JSX.Element {
+ return (
+ <div className="flex h-10 w-10 items-center justify-center rounded-lg bg-[color:var(--accent-primary)]/10 text-[color:var(--accent-primary)]">
+ {children}
+ </div>
+ )
+}
+
+export function FactList({
+ items,
+ dotClassName = "bg-[color:var(--accent-primary)]",
+}: FactListProps): JSX.Element {
+ return (
+ <ul className="mt-auto flex flex-col gap-2 pt-4">
+ {items.map((item) => (
+ <li
+ key={item}
+ className="flex items-start gap-2 text-sm text-[color:var(--text-tertiary)]"
+ >
+ <span
+ className={cx("mt-1 block h-1.5 w-1.5 shrink-0 rounded-full", dotClassName)}
+ aria-hidden="true"
+ />
+ <span>{item}</span>
+ </li>
+ ))}
+ </ul>
+ )
+}
+
+export function CompactDotList({
+ items,
+ dotClassName = "bg-white/25",
+}: FactListProps): JSX.Element {
+ return (
+ <ul className="mt-3 flex flex-col gap-2">
+ {items.map((item) => (
+ <li key={item} className="flex items-start gap-2 text-sm text-[color:var(--text-muted)]">
+ <span
+ className={cx("mt-1.5 block h-1.5 w-1.5 shrink-0 rounded-full", dotClassName)}
+ aria-hidden="true"
+ />
+ <span>{item}</span>
+ </li>
+ ))}
+ </ul>
+ )
+}
+
+export function NumberedPoint({ index, label, text }: NumberedPointProps): JSX.Element {
+ return (
+ <div className="grid gap-4 rounded-lg border border-white/10 bg-white/[0.03] p-5 md:grid-cols-[72px_1fr]">
+ <span className="font-mono text-xs uppercase text-[color:var(--text-tertiary)]">
+ {String(index + 1).padStart(2, "0")}
+ </span>
+ <div>
+ <h3 className="text-lg font-medium text-[color:var(--text-primary)]">{label}</h3>
+ <p className="mt-2 text-sm leading-relaxed text-[color:var(--text-muted)]">{text}</p>
+ </div>
+ </div>
+ )
+}
diff --git a/packages/web/components/design-system/typography.tsx b/packages/web/components/design-system/typography.tsx
new file mode 100644
index 00000000..246c1ae1
--- /dev/null
+++ b/packages/web/components/design-system/typography.tsx
@@ -0,0 +1,82 @@
+import type { CSSProperties, JSX, ReactNode } from "react"
+import { cx } from "./utils"
+
+const gradientTextStyle = {
+ background: "linear-gradient(180deg, #86efac 0%, #4ade80 50%, #16a34a 100%)",
+ WebkitBackgroundClip: "text",
+ backgroundClip: "text",
+ color: "transparent",
+} satisfies CSSProperties
+
+interface TextProps {
+ readonly children: ReactNode
+ readonly className?: string
+}
+
+export function Kicker({ children, className }: TextProps): JSX.Element {
+ return (
+ <p
+ className={cx(
+ "font-mono text-xs uppercase text-[color:var(--accent-primary)]",
+ className,
+ )}
+ >
+ {children}
+ </p>
+ )
+}
+
+export function SectionHeading({ children, className }: TextProps): JSX.Element {
+ return (
+ <h2
+ className={cx(
+ "mt-4 text-balance font-medium leading-tight text-[color:var(--text-primary)]",
+ className,
+ )}
+ >
+ {children}
+ </h2>
+ )
+}
+
+export function BodyText({ children, className }: TextProps): JSX.Element {
+ return (
+ <p
+ className={cx(
+ "mt-6 max-w-[58ch] text-base leading-relaxed text-[color:var(--text-muted)] md:text-lg",
+ className,
+ )}
+ >
+ {children}
+ </p>
+ )
+}
+
+export function GradientTitle({ children, className }: TextProps): JSX.Element {
+ return (
+ <h3 className={className} style={gradientTextStyle}>
+ {children}
+ </h3>
+ )
+}
+
+export function AccentBadge({ children, className }: TextProps): JSX.Element {
+ return (
+ <span
+ className={cx(
+ "rounded-full border border-[color:var(--accent-primary)]/30 bg-[color:var(--accent-primary)]/10 px-3 py-1 font-mono text-xs text-[color:var(--accent-primary)]",
+ className,
+ )}
+ >
+ {children}
+ </span>
+ )
+}
+
+export function InlineCode({ children, className }: TextProps): JSX.Element {
+ return (
+ <code className={cx("font-mono font-medium", className)}>
+ {children}
+ </code>
+ )
+}
diff --git a/packages/web/components/design-system/utils.ts b/packages/web/components/design-system/utils.ts
new file mode 100644
index 00000000..d4f1d2fd
--- /dev/null
+++ b/packages/web/components/design-system/utils.ts
@@ -0,0 +1,3 @@
+export function cx(...classes: readonly (string | undefined | false)[]): string {
+ return classes.filter(Boolean).join(" ")
+}
diff --git a/packages/web/components/site/command-card.tsx b/packages/web/components/site/command-card.tsx
index 92745c26..773b1eca 100644
--- a/packages/web/components/site/command-card.tsx
+++ b/packages/web/components/site/command-card.tsx
@@ -1,4 +1,9 @@
import type { JSX } from "react"
+import {
+ CommandCodeSurface,
+ FactList,
+ IconWell,
+} from "../design-system/surfaces"
import type { LazyCommand } from "../../lib/commands"
interface CommandCardProps {
@@ -71,32 +76,25 @@ export function CommandCard({ command }: CommandCardProps): JSX.Element {
return (
<article className="flex flex-col gap-4 rounded-xl border border-white/5 bg-[color:var(--surface-panel)] p-6 shadow-sm transition-colors hover:border-white/10">
<header className="flex items-center gap-3">
- <div className="flex h-10 w-10 items-center justify-center rounded-lg bg-[color:var(--accent-primary)]/10 text-[color:var(--accent-primary)]">
+ <IconWell>
<GlyphIcon type={command.glyph} />
- </div>
+ </IconWell>
<h2 className="font-mono text-lg font-semibold text-[color:var(--text-primary)]">
{command.name}
</h2>
</header>
- <div className="rounded-md bg-black/40 p-3">
+ <CommandCodeSurface>
<code className="block overflow-x-auto whitespace-nowrap font-mono text-sm text-[color:var(--text-secondary)]">
{command.syntax}
</code>
- </div>
+ </CommandCodeSurface>
<p className="text-sm leading-relaxed text-[color:var(--text-muted)]">
{command.summary}
</p>
- <ul className="mt-auto flex flex-col gap-2 pt-4">
- {command.facts.map((fact) => (
- <li key={fact} className="flex items-start gap-2 text-sm text-[color:var(--text-tertiary)]">
- <span className="mt-1 block h-1.5 w-1.5 shrink-0 rounded-full bg-[color:var(--accent-primary)]" aria-hidden="true" />
- <span>{fact}</span>
- </li>
- ))}
- </ul>
+ <FactList items={command.facts} />
</article>
)
}
diff --git a/packages/web/components/site/command-cards.tsx b/packages/web/components/site/command-cards.tsx
index f6b30dc6..28b71b10 100644
--- a/packages/web/components/site/command-cards.tsx
+++ b/packages/web/components/site/command-cards.tsx
@@ -1,15 +1,16 @@
import type { JSX } from "react"
+import { MarketingSection } from "../design-system/layout"
import { COMMANDS } from "../../lib/commands"
import { CommandCard } from "./command-card"
export function CommandCards(): JSX.Element {
return (
- <section className="mx-auto mt-16 w-full max-w-[1200px] px-4 md:mt-24 md:px-8">
+ <MarketingSection className="mt-16 md:mt-24">
<div className="grid grid-cols-1 gap-6 md:grid-cols-3">
{COMMANDS.map((command) => (
<CommandCard key={command.name} command={command} />
))}
</div>
- </section>
+ </MarketingSection>
)
}
diff --git a/packages/web/components/site/docs-cta.tsx b/packages/web/components/site/docs-cta.tsx
index 2a13a5a5..12d6eabc 100644
--- a/packages/web/components/site/docs-cta.tsx
+++ b/packages/web/components/site/docs-cta.tsx
@@ -1,5 +1,5 @@
import type { JSX } from "react"
-import Link from "next/link"
+import { GlowActionFrame, LinkAction } from "../design-system/actions"
import { SITE_CONFIG } from "../../lib/site-config"
export function DocsCta(): JSX.Element {
@@ -14,23 +14,14 @@ export function DocsCta(): JSX.Element {
Install the Codex setup, then run the workflows that keep large changes under control.
</p>
<div className="relative z-10 mt-8 flex flex-wrap justify-center gap-4">
- <div className="relative group">
- <div className="absolute -inset-1 rounded-lg bg-[color:var(--accent-mint)] opacity-20 blur-xl transition-opacity group-hover:opacity-30" />
- <Link
- href={SITE_CONFIG.docsPath}
- prefetch={false}
- className="relative block rounded-md bg-[color:var(--text-primary)] px-6 py-3 font-medium text-[color:var(--surface-base)] transition-transform hover:scale-105 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[color:var(--accent-primary)] focus-visible:ring-offset-2 focus-visible:ring-offset-[color:var(--surface-panel)]"
- >
+ <GlowActionFrame>
+ <LinkAction href={SITE_CONFIG.docsPath} variant="primary">
Read the Docs
- </Link>
- </div>
- <Link
- href={`${SITE_CONFIG.docsPath}#ulw-loop`}
- prefetch={false}
- className="rounded-md border border-white/20 bg-transparent px-6 py-3 font-medium text-[color:var(--text-primary)] transition-colors hover:bg-white/5 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[color:var(--accent-primary)] focus-visible:ring-offset-2 focus-visible:ring-offset-[color:var(--surface-panel)]"
- >
+ </LinkAction>
+ </GlowActionFrame>
+ <LinkAction href={`${SITE_CONFIG.docsPath}#ulw-loop`}>
How Ultrawork works
- </Link>
+ </LinkAction>
</div>
</section>
)
diff --git a/packages/web/components/site/feature-workflows-section.tsx b/packages/web/components/site/feature-workflows-section.tsx
index 4af17ed1..518dee72 100644
--- a/packages/web/components/site/feature-workflows-section.tsx
+++ b/packages/web/components/site/feature-workflows-section.tsx
@@ -1,45 +1,37 @@
import type { JSX } from "react"
+import {
+ MarketingRuleGrid,
+ MarketingSection,
+} from "../design-system/layout"
+import { AccentSurface, NumberedPoint } from "../design-system/surfaces"
+import { BodyText, Kicker, SectionHeading } from "../design-system/typography"
import { SITE_CONFIG } from "../../lib/site-config"
export function FeatureWorkflowsSection(): JSX.Element {
return (
- <section className="mx-auto mt-24 w-full max-w-[1200px] px-4 md:mt-32 md:px-8">
- <div className="grid gap-8 border-y border-white/10 py-12 md:grid-cols-[minmax(0,0.9fr)_minmax(0,1.1fr)] md:py-16">
+ <MarketingSection className="mt-24 md:mt-32">
+ <MarketingRuleGrid>
<div>
- <p className="font-mono text-xs uppercase text-[color:var(--accent-primary)]">
- {SITE_CONFIG.featureWorkflows.kicker}
- </p>
- <h2 className="mt-4 text-balance text-[clamp(32px,5vw,56px)] font-medium leading-tight text-[color:var(--text-primary)]">
+ <Kicker>{SITE_CONFIG.featureWorkflows.kicker}</Kicker>
+ <SectionHeading className="text-[clamp(32px,5vw,56px)]">
{SITE_CONFIG.featureWorkflows.title}
- </h2>
- <p className="mt-6 max-w-[58ch] text-base leading-relaxed text-[color:var(--text-muted)] md:text-lg">
- {SITE_CONFIG.featureWorkflows.intro}
- </p>
+ </SectionHeading>
+ <BodyText>{SITE_CONFIG.featureWorkflows.intro}</BodyText>
</div>
<div className="grid gap-3">
{SITE_CONFIG.featureWorkflows.points.map((point, index) => (
- <div
+ <NumberedPoint
key={point.label}
- className="grid gap-4 rounded-lg border border-white/10 bg-white/[0.03] p-5 md:grid-cols-[72px_1fr]"
- >
- <span className="font-mono text-xs uppercase text-[color:var(--text-tertiary)]">
- {String(index + 1).padStart(2, "0")}
- </span>
- <div>
- <h3 className="text-lg font-medium text-[color:var(--text-primary)]">
- {point.label}
- </h3>
- <p className="mt-2 text-sm leading-relaxed text-[color:var(--text-muted)]">
- {point.text}
- </p>
- </div>
- </div>
+ index={index}
+ label={point.label}
+ text={point.text}
+ />
))}
</div>
- </div>
+ </MarketingRuleGrid>
- <div className="mt-6 grid gap-4 rounded-lg border border-[color:var(--accent-primary)]/20 bg-[color:var(--accent-primary)]/5 p-5 md:grid-cols-[0.9fr_1.1fr] md:p-6">
+ <AccentSurface className="mt-6 grid gap-4 md:grid-cols-[0.9fr_1.1fr] md:p-6">
<div>
<h2 className="text-2xl font-medium text-[color:var(--text-primary)]">
{SITE_CONFIG.builtInSkills.title}
@@ -58,7 +50,7 @@ export function FeatureWorkflowsSection(): JSX.Element {
</li>
))}
</ul>
- </div>
- </section>
+ </AccentSurface>
+ </MarketingSection>
)
}
diff --git a/packages/web/components/site/hephaestus-section.tsx b/packages/web/components/site/hephaestus-section.tsx
index e6295f78..e677ff6e 100644
--- a/packages/web/components/site/hephaestus-section.tsx
+++ b/packages/web/components/site/hephaestus-section.tsx
@@ -1,76 +1,66 @@
import type { JSX } from "react"
+import {
+ MarketingRuleGrid,
+ MarketingSection,
+} from "../design-system/layout"
+import {
+ AccentSurface,
+ CompactDotList,
+ ShowcaseSurface,
+ SurfaceCard,
+} from "../design-system/surfaces"
+import {
+ AccentBadge,
+ BodyText,
+ GradientTitle,
+ Kicker,
+ SectionHeading,
+} from "../design-system/typography"
import { SITE_CONFIG } from "../../lib/site-config"
export function HephaestusSection(): JSX.Element {
const { omoIntro, hephaestus } = SITE_CONFIG
return (
- <section className="mx-auto mt-24 w-full max-w-[1200px] px-4 md:mt-32 md:px-8">
+ <MarketingSection className="mt-24 md:mt-32">
{/* OmO intro — where LazyCodex comes from */}
- <div className="grid gap-8 border-y border-white/10 py-12 md:grid-cols-[minmax(0,0.9fr)_minmax(0,1.1fr)] md:py-16">
+ <MarketingRuleGrid>
<div>
- <p className="font-mono text-xs uppercase text-[color:var(--accent-primary)]">
- {omoIntro.kicker}
- </p>
- <h2 className="mt-4 text-balance text-[clamp(28px,4vw,44px)] font-medium leading-tight text-[color:var(--text-primary)]">
+ <Kicker>{omoIntro.kicker}</Kicker>
+ <SectionHeading className="text-[clamp(28px,4vw,44px)]">
{omoIntro.title}
- </h2>
- <p className="mt-6 max-w-[58ch] text-base leading-relaxed text-[color:var(--text-muted)] md:text-lg">
- {omoIntro.body}
- </p>
+ </SectionHeading>
+ <BodyText>{omoIntro.body}</BodyText>
</div>
<div className="grid gap-3 sm:grid-cols-2">
- <div className="rounded-lg border border-white/10 bg-white/[0.03] p-5">
+ <SurfaceCard>
<h3 className="font-mono text-xs uppercase text-[color:var(--text-tertiary)]">
{omoIntro.omoLabel}
</h3>
- <ul className="mt-3 flex flex-col gap-2">
- {omoIntro.omoPoints.map((p) => (
- <li key={p} className="flex items-start gap-2 text-sm text-[color:var(--text-muted)]">
- <span className="mt-1.5 block h-1.5 w-1.5 shrink-0 rounded-full bg-white/25" aria-hidden="true" />
- <span>{p}</span>
- </li>
- ))}
- </ul>
- </div>
- <div className="rounded-lg border border-[color:var(--accent-primary)]/20 bg-[color:var(--accent-primary)]/5 p-5">
+ <CompactDotList items={omoIntro.omoPoints} />
+ </SurfaceCard>
+ <AccentSurface>
<h3 className="font-mono text-xs uppercase text-[color:var(--accent-primary)]">
{omoIntro.lazyLabel}
</h3>
- <ul className="mt-3 flex flex-col gap-2">
- {omoIntro.lazyPoints.map((p) => (
- <li key={p} className="flex items-start gap-2 text-sm text-[color:var(--text-muted)]">
- <span className="mt-1.5 block h-1.5 w-1.5 shrink-0 rounded-full bg-[color:var(--accent-primary)]" aria-hidden="true" />
- <span>{p}</span>
- </li>
- ))}
- </ul>
- </div>
+ <CompactDotList
+ items={omoIntro.lazyPoints}
+ dotClassName="bg-[color:var(--accent-primary)]"
+ />
+ </AccentSurface>
</div>
- </div>
+ </MarketingRuleGrid>
{/* Hephaestus — the ported agent */}
- <div className="relative mt-16 flex w-full flex-col items-center overflow-hidden rounded-3xl bg-black px-4 py-16 text-center shadow-2xl ring-1 ring-white/5 md:px-8">
- <div className="absolute inset-0 -z-10 bg-[radial-gradient(circle_at_center,rgba(74,222,128,0.08)_0%,transparent_70%)] blur-3xl" />
-
+ <ShowcaseSurface className="mt-16 overflow-hidden text-center md:px-8">
<div className="flex items-center gap-3">
- <span className="rounded-full border border-[color:var(--accent-primary)]/30 bg-[color:var(--accent-primary)]/10 px-3 py-1 font-mono text-xs text-[color:var(--accent-primary)]">
- {hephaestus.badge}
- </span>
+ <AccentBadge>{hephaestus.badge}</AccentBadge>
</div>
- <h3
- className="mt-6 text-[clamp(32px,5vw,56px)] font-semibold tracking-tight"
- style={{
- background: "linear-gradient(180deg, #86efac 0%, #4ade80 50%, #16a34a 100%)",
- WebkitBackgroundClip: "text",
- backgroundClip: "text",
- color: "transparent",
- }}
- >
+ <GradientTitle className="mt-6 text-[clamp(32px,5vw,56px)] font-semibold tracking-tight">
{hephaestus.title}
- </h3>
+ </GradientTitle>
<p className="mt-3 text-balance text-xl font-medium text-[color:var(--text-primary)] md:text-2xl">
{hephaestus.headline}
</p>
@@ -96,7 +86,7 @@ export function HephaestusSection(): JSX.Element {
<p className="mt-10 text-lg italic text-[color:var(--text-tertiary)]">
{hephaestus.tagline}
</p>
- </div>
- </section>
+ </ShowcaseSurface>
+ </MarketingSection>
)
}
diff --git a/packages/web/components/site/hero.tsx b/packages/web/components/site/hero.tsx
index 3a7f90e0..a6d10a0f 100644
--- a/packages/web/components/site/hero.tsx
+++ b/packages/web/components/site/hero.tsx
@@ -1,4 +1,5 @@
import type { JSX } from "react"
+import { HeroBrandMark } from "../design-system/brand-mark"
import { SITE_CONFIG } from "../../lib/site-config"
export function Hero(): JSX.Element {
@@ -50,49 +51,9 @@ export function Hero(): JSX.Element {
{/* Right-anchored brand mark — a composed visual anchor. */}
<div className="hidden shrink-0 items-center justify-end md:flex">
- <HeroMark />
+ <HeroBrandMark />
</div>
</div>
</section>
)
}
-
-function HeroMark(): JSX.Element {
- return (
- <div className="relative flex h-[180px] w-[180px] items-center justify-center md:h-[220px] md:w-[220px]">
- <div
- className="absolute inset-0 rounded-[28px] opacity-60 blur-2xl"
- style={{ background: "radial-gradient(circle at 50% 50%, rgba(74,222,128,0.45) 0%, transparent 70%)" }}
- aria-hidden="true"
- />
- <svg
- width="160"
- height="160"
- viewBox="0 0 24 24"
- fill="none"
- aria-hidden="true"
- className="relative h-[140px] w-[140px] md:h-[160px] md:w-[160px]"
- >
- <rect
- x="2.4"
- y="2.4"
- width="19.2"
- height="19.2"
- rx="4.8"
- fill="var(--card-base)"
- stroke="var(--accent-primary)"
- strokeWidth="1"
- />
- <path
- d="M7 8 V16 H14.5"
- fill="none"
- stroke="var(--accent-mint)"
- strokeWidth="1.4"
- strokeLinecap="round"
- strokeLinejoin="round"
- />
- <circle cx="15.8" cy="8" r="1.4" fill="var(--accent-primary)" />
- </svg>
- </div>
- )
-}
diff --git a/packages/web/components/site/install-block.tsx b/packages/web/components/site/install-block.tsx
index 9d1ad668..f0bb2752 100644
--- a/packages/web/components/site/install-block.tsx
+++ b/packages/web/components/site/install-block.tsx
@@ -1,4 +1,5 @@
import type { JSX } from "react"
+import { InlineCode } from "../design-system/typography"
import { SITE_CONFIG } from "../../lib/site-config"
import { CopyButton } from "./copy-button"
@@ -10,9 +11,9 @@ export function InstallBlock(): JSX.Element {
<span className="select-none font-mono text-[color:var(--text-tertiary)]" aria-hidden="true">
$
</span>
- <code className="whitespace-nowrap font-mono text-sm font-medium text-[color:var(--text-primary)] md:text-base">
+ <InlineCode className="whitespace-nowrap text-sm text-[color:var(--text-primary)] md:text-base">
{SITE_CONFIG.installCommand}
- </code>
+ </InlineCode>
</div>
<CopyButton value={SITE_CONFIG.installCommand} className="ml-4 shrink-0" />
</div>
diff --git a/packages/web/components/site/site-footer.tsx b/packages/web/components/site/site-footer.tsx
index 85a097cb..4c5d8f85 100644
--- a/packages/web/components/site/site-footer.tsx
+++ b/packages/web/components/site/site-footer.tsx
@@ -1,10 +1,11 @@
import type { JSX } from "react"
+import { MarketingContainer } from "../design-system/layout"
import { SITE_CONFIG } from "../../lib/site-config"
export function SiteFooter(): JSX.Element {
return (
<footer className="w-full border-t border-white/5 bg-[color:var(--surface-night)] py-8">
- <div className="mx-auto flex max-w-[1200px] flex-col items-center justify-between gap-4 px-4 text-sm text-[color:var(--text-tertiary)] md:flex-row md:px-8">
+ <MarketingContainer className="flex flex-col items-center justify-between gap-4 text-sm text-[color:var(--text-tertiary)] md:flex-row">
<div className="flex items-center gap-2">
<span className="font-mono font-medium text-[color:var(--text-secondary)]">
lazycodex.ai
@@ -31,7 +32,7 @@ export function SiteFooter(): JSX.Element {
GitHub
</a>
</div>
- </div>
+ </MarketingContainer>
</footer>
)
}
diff --git a/packages/web/components/site/site-header.tsx b/packages/web/components/site/site-header.tsx
index e01b2b8f..0bd8d61f 100644
--- a/packages/web/components/site/site-header.tsx
+++ b/packages/web/components/site/site-header.tsx
@@ -1,12 +1,14 @@
import type { JSX } from "react"
import Link from "next/link"
+import { BrandMark } from "../design-system/brand-mark"
+import { MarketingContainer } from "../design-system/layout"
import { SITE_CONFIG } from "../../lib/site-config"
import { GithubStarsPill } from "./github-stars-pill"
export function SiteHeader(): JSX.Element {
return (
<header className="sticky top-0 z-40 w-full border-b border-white/5 bg-[color:var(--surface-base)]/80 backdrop-blur-md">
- <div className="mx-auto flex h-14 max-w-[1200px] items-center justify-between px-4 md:px-8">
+ <MarketingContainer className="flex h-14 items-center justify-between">
<div className="flex items-center gap-3">
<Link
href="/"
@@ -16,34 +18,7 @@ export function SiteHeader(): JSX.Element {
{/* Inline SVG mark: zero network bytes (a real <img> of the 512px
icon would download ~200KB above the fold and starve the LCP
text paint on throttled mobile). */}
- <svg
- width="24"
- height="24"
- viewBox="0 0 24 24"
- fill="none"
- aria-hidden="true"
- className="h-6 w-6"
- >
- <rect
- x="3.2"
- y="3.2"
- width="17.6"
- height="17.6"
- rx="4.4"
- fill="var(--card-base)"
- stroke="var(--accent-primary)"
- strokeWidth="1.3"
- />
- <path
- d="M8 9 V15.2 H14.6"
- fill="none"
- stroke="var(--accent-primary)"
- strokeWidth="1.7"
- strokeLinecap="round"
- strokeLinejoin="round"
- />
- <circle cx="15.6" cy="9" r="1.6" fill="var(--accent-mint)" />
- </svg>
+ <BrandMark className="h-6 w-6" />
<span className="font-medium tracking-tight text-[color:var(--text-primary)]">
{SITE_CONFIG.wordmark}
</span>
@@ -60,7 +35,7 @@ export function SiteHeader(): JSX.Element {
</Link>
<GithubStarsPill />
</nav>
- </div>
+ </MarketingContainer>
</header>
)
}
diff --git a/packages/web/components/site/ultrawork-section.tsx b/packages/web/components/site/ultrawork-section.tsx
index b804aefd..97475a8d 100644
--- a/packages/web/components/site/ultrawork-section.tsx
+++ b/packages/web/components/site/ultrawork-section.tsx
@@ -1,35 +1,29 @@
import type { JSX } from "react"
+import { MarketingSection } from "../design-system/layout"
+import { ShowcaseSurface } from "../design-system/surfaces"
+import { GradientTitle, InlineCode } from "../design-system/typography"
import { SITE_CONFIG } from "../../lib/site-config"
import { BrandImage } from "./brand-image"
export function UltraworkSection(): JSX.Element {
return (
- <section className="mx-auto mt-32 flex w-full max-w-[1200px] flex-col items-center px-4 text-center md:mt-40 md:px-8">
+ <MarketingSection className="mt-32 flex flex-col items-center text-center md:mt-40">
<h2 className="text-balance text-[clamp(32px,5vw,48px)] font-medium tracking-tight text-[color:var(--text-primary)]">
{SITE_CONFIG.ultraworkTagline}
</h2>
<div className="mt-8 rounded-lg border border-[color:var(--accent-primary)]/20 bg-[color:var(--accent-primary)]/5 px-6 py-3 shadow-[0_0_30px_rgba(74,222,128,0.1)]">
- <code className="font-mono text-lg font-medium text-[color:var(--accent-mint)]">
+ <InlineCode className="text-lg text-[color:var(--accent-mint)]">
{SITE_CONFIG.ultraworkExample}
- </code>
+ </InlineCode>
</div>
- <div className="relative mt-24 flex w-full max-w-[960px] flex-col items-center rounded-3xl bg-black px-4 py-16 shadow-2xl ring-1 ring-white/5">
- <div className="absolute inset-0 -z-10 bg-[radial-gradient(circle_at_center,rgba(74,222,128,0.08)_0%,transparent_70%)] blur-3xl" />
-
- <h3
- className="mb-12 text-center text-[clamp(28px,4vw,48px)] font-semibold tracking-tight"
- style={{
- background: "linear-gradient(180deg, #86efac 0%, #4ade80 50%, #16a34a 100%)",
- WebkitBackgroundClip: "text",
- backgroundClip: "text",
- color: "transparent",
- opacity: 0.9
- }}
+ <ShowcaseSurface className="mt-24 max-w-[960px]">
+ <GradientTitle
+ className="mb-12 text-center text-[clamp(28px,4vw,48px)] font-semibold tracking-tight opacity-90"
>
Ultrawork
- </h3>
+ </GradientTitle>
<BrandImage
src="/img/badge-ultrawork.png"
@@ -38,7 +32,7 @@ export function UltraworkSection(): JSX.Element {
height={512}
className="h-auto w-full max-w-[560px]"
/>
- </div>
- </section>
+ </ShowcaseSurface>
+ </MarketingSection>
)
}