Skip to content

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

docs: update README with web package reference and add DESIGN.md

YeonGyu-Kimb2a77ef8694b
diff --git a/README.md b/README.md
index 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.md
index 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.