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
docs: update README with web package reference and add DESIGN.md
YeonGyu-Kimb2a77ef8694b
diff --git a/README.md b/README.mdindex 45ef27ab..5705ad2a 100644--- a/README.md+++ b/README.md@@ -17,12 +17,12 @@·<a href="https://github.com/code-yeongyu/oh-my-openagent">OmO</a>·- <a href="https://lazycodex.dev">lazycodex.dev</a>+ <a href="https://lazycodex.ai">lazycodex.ai</a></p><br />- <p><strong>🚧 Coming Soon</strong></p>+ <p><strong>🚧 Coming June 2026 · Currently available for OpenCode</strong></p></div><hr />@@ -54,7 +54,11 @@ LazyCodex is a thin distribution layer. The core engine is [oh-my-openagent (OmO```lazycodex/-├── src/ → oh-my-openagent (submodule)+├── src/ → oh-my-openagent (submodule)+├── packages/+│ └── web/ → Next.js 15 + Tailwind v4 + opennextjs-cloudflare+│ (deployed to lazycodex.ai via Cloudflare Workers)+├── .github/workflows/ → web-ci.yml + web-deploy.yml├── README.md└── ...```diff --git a/packages/web/DESIGN.md b/packages/web/DESIGN.mdindex dc7ad733..d591df09 100644--- a/packages/web/DESIGN.md+++ b/packages/web/DESIGN.md@@ -1,157 +1,108 @@# LazyCodex Web — Design System-> **Coming-soon site, build 2026-05.** Single route: `/`. Single goal: announce the LazyCodex June 2026 release, communicate that OpenCode is the only currently-supported version, and ship Lighthouse 100/100/100/100 on a real Chromium audit.+> **Coming-soon splash, build 2026-05.** Single route: `/`. The page mirrors the LazyCodex brand PNG: top-left OmO provenance, centered eyebrow, huge wordmark, two-line tagline, and bottom domain.## 1. Atmosphere & Identity-A late-night terminal lit by an electric-purple monitor. The brand seed comes straight from the LazyCodex splash: a single radial gradient anchored low-center, deep indigo at the edges, electric blue-violet at the core. The wordmark is the hero. Everything else is whisper.+LazyCodex is a quiet 4K brand splash, not a marketing landing page. The mood is a deep indigo Codex screen with a low-centered electric violet bloom. The wordmark owns the page; everything else is supporting metadata.-This is **not** AI SaaS slop. No three-feature-card grid. No "Get started" CTA. No marketing copy. The page exists to say one sentence: _LazyCodex is on its way, and if you are on OpenCode today, here is the install command._+Required visible copy:++- `OmO in Codex`+- `CODEX FOR NO-BRAINERS`+- `LazyCodex`+- `You don't need to think.` / `Just prompt with ultrawork.`+- `Coming June 2026 · Currently on OpenCode`+- `lazycodex.ai`++No feature grid, no install command, no CTA, no footer link cluster.## 2. Color-### Palette (every value declared here)--| Role | Token | Hex / RGBA | Usage |-| ------------------- | ---------------------- | ------------------------- | ------------------------------------------------ |-| Surface / base | `--surface-base` | `#0a0b2f` | Body fallback under the gradient |-| Gradient / core | `--brand-core` | `#5a5fef` | Radial gradient center stop |-| Gradient / mid | `--brand-mid` | `#3236c4` | Radial gradient middle stop |-| Gradient / outer | `--brand-outer` | `#191b6f` | Radial gradient outer stop |-| Accent / electric | `--accent-electric` | `#a5a8ff` | Status pill text, install command prefix |-| Accent / electric-2 | `--accent-electric-2` | `rgba(165, 168, 255, 0.18)` | Status pill background |-| Border / hairline | `--border-hairline` | `rgba(255, 255, 255, 0.12)` | Card borders, dividers |-| Glass / surface | `--surface-glass` | `rgba(10, 11, 47, 0.55)` | Install command glass card |-| Text / primary | `--text-primary` | `#f5f5fa` | Wordmark, headlines |-| Text / secondary | `--text-secondary` | `rgba(245, 245, 250, 0.7)` | Lead copy |-| Text / tertiary | `--text-tertiary` | `rgba(245, 245, 250, 0.5)` | Footer, captions |--### Rules--- The gradient is **the** brand identity. No flat color body backgrounds.-- Never use pure `#000000` or pure `#ffffff`. `#0a0b2f` is the floor, `#f5f5fa` is the ceiling.-- **No second chromatic accent.** Electric blue-violet only. No cyan, no pink, no green.-- Status colors (red/yellow/green) are banned on this page. Nothing on a coming-soon page is "errored" or "warning".-- All hex codes live in this file and `app/globals.css`. Inline raw hex in any component file is a violation.+| Role | Token | Value | Usage |+| --- | --- | --- | --- |+| Surface / base | `--surface-base` | `#2a2dbf` | Body fallback and icon base |+| Gradient / core | `--brand-core` | `#5a5fef` | Radial center stop |+| Gradient / mid | `--brand-mid` | `#3236c4` | 60% radial stop |+| Gradient / outer | `--brand-outer` | `#232897` | 100% radial stop |+| Text / primary | `--text-primary` | `#ffffff` | Wordmark, eyebrow, footer, emphasis |+| Text / secondary | `--text-secondary` | `#dcdcf8` | Large tagline and launch metadata |+| Text / tertiary | `--text-tertiary` | `#b9bce6` | Top-left secondary text |-## 3. Typography+Background CSS must mirror the reference SVG:-### Font Stack+```css+radial-gradient(ellipse 80% 60% at 50% 65%, #5a5fef 0%, #3236c4 60%, #232897 100%)+```-- **Primary sans**: `var(--font-geist-sans), ui-sans-serif, system-ui, sans-serif` — Geist via `next/font/sans`, self-hosted, zero CLS.-- **Mono**: `var(--font-geist-mono), ui-monospace, SFMono-Regular, monospace` — Geist Mono via `next/font/mono`.-- **No serif. No Pretendard.** Geist's tight tracking is the brand voice.+Contrast checks:-### Scale+- `#ffffff` on `#5a5fef` = 4.9:1, AA for normal text.+- `#dcdcf8` on `#3236c4` = 6.5:1; on `#232897` = 8.5:1; near the core it remains AA for the large tagline.+- `#b9bce6` is used only in the top-left over the darker outer gradient, where it is ≥ 6:1.-| Level | Class | Size | Weight | Tracking | Usage |-| -------- | --------------------------- | ---------- | ------ | ------------------- | ---------------------- |-| Display | `text-6xl md:text-8xl` | 60→128 px | 600 | `-0.045em` (tighter) | Wordmark "LazyCodex" |-| Lead | `text-base md:text-lg` | 16→18 px | 400 | `-0.005em` | Tagline + sub-tagline |-| Body | `text-sm md:text-base` | 14→16 px | 400 | normal | Install caption |-| Mono | `font-mono text-sm md:text-base` | 14→16 px | 400 | normal | Install command |-| Overline | `text-xs uppercase` | 12 px | 500 | `0.16em` | Status pill |-| Footer | `text-xs` | 12 px | 400 | `0.01em` | Footer links |+## 3. Typography-### Rules+Primary sans: `var(--font-geist-sans), ui-sans-serif, system-ui, sans-serif`.+Mono: `var(--font-geist-mono), ui-monospace, SFMono-Regular, monospace`.-- The wordmark runs `-0.045em` tracking — Geist's geometry handles this without breaking.-- Body never below 14 px. Captions at 12 px must be uppercase + extra tracking.-- `text-wrap: balance` on the wordmark and tagline. `text-wrap: pretty` on long copy (none on this page yet).+Font choice: the reference uses Pretendard, but the site keeps Geist because it is already installed, self-hosted through the existing `geist` package, and preserves zero new font bytes. The splash match comes from weight, scale, and tracking: medium display weight, strong negative wordmark tracking, and wide uppercase eyebrow tracking.-## 4. Spacing & Layout+| Level | Size | Weight | Tracking | Usage |+| --- | --- | --- | --- | --- |+| Corner | `clamp(12px, 1.2vw, 14px)` | 400/600 | `-0.01em` | `OmO in Codex` |+| Metadata | `clamp(10px, 0.95vw, 12px)` | 500 | `0.18em` | Launch/OpenCode line |+| Eyebrow | `clamp(11px, 1.1vw, 14px)` | 500 | `0.22em` | `CODEX FOR NO-BRAINERS` |+| Wordmark | `clamp(64px, 12vw, 180px)` | 500 | `-0.04em` | `LazyCodex` |+| Tagline | `clamp(18px, 2.2vw, 36px)` | 400/700 | `-0.015em` | Two-line promise |+| Footer | `clamp(14px, 1.4vw, 18px)` | 600 | `0.08em` | `lazycodex.ai` |-4 px grid. Centered viewport. **No multi-column layouts on this page.** One vertical stack, vertically centered in `100dvh`.+## 4. Layout & Spacing-| Token | Tailwind | Value | Usage |-| ------------- | --------------- | ----- | ------------------------------------------ |-| `--space-2` | `gap-2` | 8 px | Status pill icon-to-label |-| `--space-3` | `gap-3` | 12 px | Install command icon-to-text |-| `--space-6` | `gap-6` | 24 px | Wordmark to tagline |-| `--space-8` | `gap-8` | 32 px | Tagline to install block |-| `--space-12` | `gap-12` | 48 px | Page-level vertical rhythm |-| `--page-pad` | `px-6 md:px-10` | 24/40 px | Side gutters |+Mobile-first one-screen composition:-### Container+- Canvas: `min-height: 100dvh`, centered flex stack, `overflow-hidden` to prevent tiny horizontal scroll from the display type.+- Top-left mark: `top/left: clamp(16px, 3vw, 32px)`.+- Center stack: vertical center, no max-width card, no glass panel.+- Eyebrow to wordmark: `clamp(34px, 4vw, 52px)`.+- Wordmark to tagline: `clamp(24px, 3vw, 40px)`.+- Bottom domain: `bottom: clamp(20px, 4vw, 60px)`, centered absolute.-- `max-w-2xl` (672 px) for the content stack. Wider would dilute density.-- `min-h-[100dvh]` always. Never `h-screen` (iOS Safari jumps).-- Footer pinned to the bottom via `mt-auto` on a flex column body.+The splash intentionally leaves large negative space between tagline and footer.## 5. Components-### Wordmark+### Splash mark-- `<h1>` semantic, `text-6xl md:text-8xl font-semibold tracking-[-0.045em] text-[color:var(--text-primary)]`.-- No icon, no decoration. The word IS the logo on this page.+Plain text only. `OmO` is semibold white; `in Codex` is regular tertiary. No logo asset.-### Status Pill+### Eyebrow + metadata-- `<span>` with `inline-flex items-center gap-2 rounded-full border border-[color:var(--border-hairline)] bg-[color:var(--accent-electric-2)] px-4 py-1.5 text-xs font-medium uppercase tracking-[0.16em] text-[color:var(--accent-electric)]`.-- Leading `•` dot uses `bg-[color:var(--accent-electric)] h-1.5 w-1.5 rounded-full` with a CSS-only `animate-pulse-soft` (custom, slower than Tailwind's built-in to avoid flashbang).+Two small uppercase lines above the wordmark. The launch/OpenCode line is present for product messaging but visually subordinate to the eyebrow.-### Install Command Card+### Wordmark++Single semantic `<h1>`. Medium weight, very large, tight tracking, pure white.++### Tagline-- Glass card: `rounded-2xl border border-[color:var(--border-hairline)] bg-[color:var(--surface-glass)] backdrop-blur-md px-5 py-4`.-- Mono `<code>` block: `$ npm install -g lazycodex`.-- No copy-to-clipboard button. Coming-soon page = zero interaction. Lighthouse INP stays at 0.+Two separate visual lines. `ultrawork` is wrapped in `<strong>` and promoted to primary white with weight 700.-### Footer Links+### Footer-- Plain `<a>` with `text-[color:var(--text-tertiary)] hover:text-[color:var(--accent-electric)] transition-colors`.-- Underline on hover only. No icons.+Exactly one `<footer>` containing only `lazycodex.ai`, centered at the bottom in mono.## 6. Motion & Interaction-### Timing--| Type | Duration | Easing | Usage |-| -------- | --------- | ------------------------------- | ---------------------- |-| Micro | 150 ms | `ease-out` | Link color shift |-| Pulse | 2.8 s | `cubic-bezier(0.4, 0, 0.6, 1)` | Status pill dot |-| Entrance | 700 ms | `cubic-bezier(0.16, 1, 0.3, 1)` | Initial fade-in-up |--### Rules--- **Only `transform` and `opacity`.** Never `width / height / top / left / margin / padding`.-- **CSS-only** animations. No motion libraries.-- **`prefers-reduced-motion: reduce`** disables every animation (entrance shows immediately, pulse becomes static).-- No scroll animations, no parallax, no cursor effects, no magnetic buttons. This is a one-screen page; there is no scroll.--## 7. Depth & Surface--- **Background**: radial gradient anchored at `50% 65%`, ramping `--brand-core` → `--brand-mid` → `--brand-outer`. The outer stop falls just below `--surface-base` so the page edges feel infinite.-- **No drop shadows** anywhere. Depth is gradient + hairline border only.-- **Glass surface**: a single `backdrop-blur-md` panel for the install command. Used once. Repeated glass is slop.-- **No noise/grain texture.** Adding noise costs a DOM node + CPU on paint and buys nothing on the score-vs-taste balance for a single-screen page.--## 8. Accessibility (mandatory)--- `lang="en"` on `<html>`.-- One `<h1>` (the wordmark), nothing competes.-- All chromatic text contrast verified ≥ 4.5:1 against the darkest gradient stop. `#f5f5fa` on `#191b6f` = 12.3:1 (AAA). `rgba(245,245,250,0.5)` over the same = 6.1:1 (AA).-- Focus-visible ring on the install command and every footer link: `outline-2 outline-offset-2 outline-[color:var(--accent-electric)]`.-- `prefers-reduced-motion: reduce` honored.-- `aria-label` on the status pill dot (`<span aria-hidden="true">`).-- No icon-only buttons. Every interactive element has an accessible name.--## 9. SEO--- `<title>`: `LazyCodex — Codex for lazy people. Coming June 2026.`-- `<meta name="description">`: 1-line, 155 chars max, includes "OpenCode" and "June 2026".-- OpenGraph + Twitter card with brand-aligned 1200×630 image (matches the splash gradient).-- JSON-LD `SoftwareApplication` describing the npm package.-- `manifest.webmanifest`, `robots.txt`, `sitemap.xml` all live.-- Canonical = `https://lazycodex.ai/`.--## 10. Banned Patterns (project-specific)--- Inline raw hex outside this file or `globals.css`.-- Pure `#000000` or `#ffffff`.-- `h-screen` (use `min-h-[100dvh]`).-- `as any`, `@ts-ignore`, `@ts-expect-error`.-- Emojis in JSX, alt text, or visible UI.-- `'use client'` anywhere on this page. The page ships zero hydration JavaScript.-- Importing motion libraries (framer-motion, motion, gsap).-- Adding a copy-to-clipboard button "because every install command has one". This page has zero interaction by design.-- Lorem ipsum, marketing buzzwords, "AI-powered", "revolutionize", "supercharge".+- One CSS-only soft reveal: opacity + `translate3d(0, 8px, 0)` over 720 ms.+- `prefers-reduced-motion: reduce` disables the reveal.+- No pulse, cursor blink, hover choreography, parallax, or scroll effects.+- The only interactive element is the skip link; it receives a visible white focus ring.++## 7. Accessibility & SEO++- One `<main>`, one `<h1>`, one `<footer>`.+- `lang="en"`, canonical `https://lazycodex.ai/`, OpenGraph/Twitter image routes, JSON-LD, manifest, robots, and sitemap remain in place.+- Metadata title remains `LazyCodex — Codex for lazy people. Coming June 2026.` to preserve the SEO contract.+- The page ships as a Server Component with zero hydration JavaScript.+- No emojis, no raw hex in JSX page markup, no commented-out UI code.