The one and only agent harness for complex codebases. Project memory, planning, execution, and verified completion inside Codex.
JavaScript aiai-agentsclaudeclaude-codeclicodexdeveloper-toolslazylazycodexoh-my-openagentomoopenaiorchestrationtypescript
refactor(web): extract shared design system tokens
YeonGyu-Kim131e4ac8ef2b
diff --git a/packages/web/DESIGN.md b/packages/web/DESIGN.mdindex 00ac9602..8a34253c 100644--- a/packages/web/DESIGN.md+++ b/packages/web/DESIGN.md@@ -1,5 +1,10 @@# LazyCodex Design System+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`.+- 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.@@ -11,21 +16,21 @@ Surfaces (near-black, cool-green undertone):- `--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 (emerald core):-- `--brand-core`: `#10b981` · `--brand-mid`: `#059669` · `--brand-outer`: `#065f46`+Brand (green core):+- `--brand-core`: `#22c55e` · `--brand-mid`: `#16a34a` · `--brand-outer`: `#15803d`Accent (the live-wire green):-- `--accent-primary`: `#34d399` · `--accent-primary-soft`: `rgba(52,211,153,0.1)` · `--accent-primary-border`: `rgba(52,211,153,0.22)`-- `--accent-mint`: `#6ee7b7` · `--accent-glow`: `#6ee7b7`+- `--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`: `#9aa6a0` · `--text-tertiary`: `#7a857f`-- `--text-muted`: `rgba(255,255,255,0.72)` · `--text-soft`: `#d1fae5` (mint-tinted)+- `--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`: `#10b981` · `--status-warning`: `#f59e0b` · `--status-error`: `#ef4444`+- `--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.@@ -36,7 +41,7 @@ Borders / status:- **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 `#10b981` through `#059669` and `#065f46` into `#0a0c0b`.+- **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.@@ -61,7 +66,14 @@ The docs are a single richly-sectioned page with a grouped sidebar, ⌘K search,- 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. Anti-Patterns+## 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`).diff --git a/packages/web/app/globals.css b/packages/web/app/globals.cssindex fc68e398..6eb9f03b 100644--- a/packages/web/app/globals.css+++ b/packages/web/app/globals.css@@ -1,114 +1,3 @@@import "tailwindcss";+@import "./styles/design-system.css";@import "./styles/landing.css";--@theme {- /* A native system font stack — no webfont. This keeps the render-critical- path (and Lighthouse's Lantern LCP graph) free of any font download, so- LCP lands at FCP. On Apple this renders as SF Pro, on Windows Segoe UI:- a clean, premium grotesk that suits the Codex aesthetic. */- --font-sans: ui-sans-serif, system-ui, -apple-system, "Segoe UI", Roboto,- Helvetica, Arial, sans-serif;- --font-mono: ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, "Liberation Mono", monospace;-}--@layer base {- :root {- /* Surfaces — near-black canvas with a faint cool-green undertone. */- --surface-base: #0a0c0b;- --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: #0E1411;- --surface-night: #0a0c0b;- --surface-panel: #0E1411;- --surface-panel-alt: #0C1310;- --surface-panel-deep: #0D1310;-- /* Brand — green core (green-500 family), clearly green not teal. */- --brand-core: #22c55e;- --brand-mid: #16a34a;- --brand-outer: #15803d;-- /* Text. */- --text-primary: #ffffff;- --text-secondary: #b8c2bc;- --text-tertiary: #8b9690;- --text-muted: rgba(255, 255, 255, 0.74);- --text-soft: #dcfce7;-- /* Accent — the live-wire green (green-400/300, unambiguously green). */- --accent-primary: #4ade80;- --accent-primary-soft: rgba(74, 222, 128, 0.1);- --accent-primary-border: rgba(74, 222, 128, 0.24);- --accent-cyan: #4ade80;- --accent-teal: #22c55e;- --accent-mint: #86efac;- --accent-glow: #86efac;-- /* Borders. */- --border-subtle: rgba(255, 255, 255, 0.06);- --border-default: rgba(255, 255, 255, 0.1);-- /* Status. */- --status-success: #22c55e;- --status-warning: #f59e0b;- --status-error: #ef4444;- }-- html {- background-color: var(--surface-base);- color-scheme: dark;- }-- body {- background-color: var(--surface-base);- color: var(--text-primary);- font-feature-settings: "rlig" 1, "calt" 1, "ss01" 1;- -webkit-font-smoothing: antialiased;- -moz-osx-font-smoothing: grayscale;- text-rendering: optimizeLegibility;- }-- ::selection {- background-color: var(--brand-outer);- color: var(--text-primary);- }-- a {- color: inherit;- }-- :focus-visible {- border-radius: 6px;- outline: 2px solid var(--accent-primary);- outline-offset: 3px;- }-}--@layer utilities {- .card-gradient-base {- background: radial-gradient(120% 100% at 60% 65%, #22c55e 0%, #16a34a 35%, #15803d 70%, #0a0c0b 100%);- }-- .card-gradient-beam {- background: radial-gradient(55% 55% at 38% -8%, rgba(134,239,172,0.55) 0%, rgba(74,222,128,0.22) 35%, rgba(255,255,255,0) 65%),- radial-gradient(32% 28% at 55% -5%, rgba(134,239,172,0.38) 0%, rgba(255,255,255,0) 70%);- mix-blend-mode: screen;- }-- .card-gradient-sheen {- background: linear-gradient(118deg, transparent 18%, rgba(134,239,172,0.16) 26%, rgba(134,239,172,0.30) 30%, rgba(134,239,172,0.12) 35%, transparent 45%),- linear-gradient(112deg, transparent 8%, rgba(74,222,128,0.12) 15%, transparent 28%);- filter: blur(20px);- mix-blend-mode: screen;- opacity: 0.85;- }-- .card-gradient-pools {- background: radial-gradient(55% 50% at 8% 95%, rgba(34,197,94,0.26), transparent 70%),- radial-gradient(45% 45% at 95% 40%, rgba(134,239,172,0.20), transparent 70%);- mix-blend-mode: screen;- }--}diff --git a/packages/web/app/styles/design-system.css b/packages/web/app/styles/design-system.cssnew file mode 100644index 00000000..7b554c92--- /dev/null+++ b/packages/web/app/styles/design-system.css@@ -0,0 +1,110 @@+@theme {+ /* A native system font stack — no webfont. This keeps the render-critical+ path (and Lighthouse's Lantern LCP graph) free of any font download, so+ LCP lands at FCP. On Apple this renders as SF Pro, on Windows Segoe UI:+ a clean, premium grotesk that suits the Codex aesthetic. */+ --font-sans: ui-sans-serif, system-ui, -apple-system, "Segoe UI", Roboto,+ Helvetica, Arial, sans-serif;+ --font-mono: ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, "Liberation Mono", monospace;+}++@layer base {+ :root {+ /* Surfaces — near-black canvas with a faint cool-green undertone. */+ --surface-base: #0a0c0b;+ --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: #0E1411;+ --surface-night: #0a0c0b;+ --surface-panel: #0E1411;+ --surface-panel-alt: #0C1310;+ --surface-panel-deep: #0D1310;++ /* Brand — green core (green-500 family), clearly green not teal. */+ --brand-core: #22c55e;+ --brand-mid: #16a34a;+ --brand-outer: #15803d;++ /* Text. */+ --text-primary: #ffffff;+ --text-secondary: #b8c2bc;+ --text-tertiary: #8b9690;+ --text-muted: rgba(255, 255, 255, 0.74);+ --text-soft: #dcfce7;++ /* Accent — the live-wire green (green-400/300, unambiguously green). */+ --accent-primary: #4ade80;+ --accent-primary-soft: rgba(74, 222, 128, 0.1);+ --accent-primary-border: rgba(74, 222, 128, 0.24);+ --accent-cyan: #4ade80;+ --accent-teal: #22c55e;+ --accent-mint: #86efac;+ --accent-glow: #86efac;++ /* Borders. */+ --border-subtle: rgba(255, 255, 255, 0.06);+ --border-default: rgba(255, 255, 255, 0.1);++ /* Status. */+ --status-success: #22c55e;+ --status-warning: #f59e0b;+ --status-error: #ef4444;+ }++ html {+ background-color: var(--surface-base);+ color-scheme: dark;+ }++ body {+ background-color: var(--surface-base);+ color: var(--text-primary);+ font-feature-settings: "rlig" 1, "calt" 1, "ss01" 1;+ -webkit-font-smoothing: antialiased;+ -moz-osx-font-smoothing: grayscale;+ text-rendering: optimizeLegibility;+ }++ ::selection {+ background-color: var(--brand-outer);+ color: var(--text-primary);+ }++ a {+ color: inherit;+ }++ :focus-visible {+ border-radius: 6px;+ outline: 2px solid var(--accent-primary);+ outline-offset: 3px;+ }+}++@layer utilities {+ .card-gradient-base {+ background: radial-gradient(120% 100% at 60% 65%, #22c55e 0%, #16a34a 35%, #15803d 70%, #0a0c0b 100%);+ }++ .card-gradient-beam {+ background: radial-gradient(55% 55% at 38% -8%, rgba(134,239,172,0.55) 0%, rgba(74,222,128,0.22) 35%, rgba(255,255,255,0) 65%),+ radial-gradient(32% 28% at 55% -5%, rgba(134,239,172,0.38) 0%, rgba(255,255,255,0) 70%);+ mix-blend-mode: screen;+ }++ .card-gradient-sheen {+ background: linear-gradient(118deg, transparent 18%, rgba(134,239,172,0.16) 26%, rgba(134,239,172,0.30) 30%, rgba(134,239,172,0.12) 35%, transparent 45%),+ linear-gradient(112deg, transparent 8%, rgba(74,222,128,0.12) 15%, transparent 28%);+ filter: blur(20px);+ mix-blend-mode: screen;+ opacity: 0.85;+ }++ .card-gradient-pools {+ background: radial-gradient(55% 50% at 8% 95%, rgba(34,197,94,0.26), transparent 70%),+ radial-gradient(45% 45% at 95% 40%, rgba(134,239,172,0.20), transparent 70%);+ mix-blend-mode: screen;+ }+}