Phase 1.5 — Docs Site Goals
Description: Bootstrap a Fumadocs Next.js app and apply the Matte Graphite design system — tokens, MDX components, search, code blocks, OG images, and site chrome.
Phase 1.5 — Docs Site Goals
| Goal | Title | Milestones |
|---|---|---|
| D.1 | Monorepo + tooling foundation | D.1.1, D.1.2 |
| D.2 | Fumadocs application and visual system | D.2.1 – D.2.8 |
| D.3 | Content authoring and IA | D.3.1 – D.3.4 |
| D.4 | CI/CD and preview deploys | D.4.1, D.4.2 |
| D.5 | Verification and quality gates | D.5.1, D.5.2 |
| D.6 | Domain, DNS, and cross-site nav | D.6.2, D.6.3 (D.6.1 domain purchase: done) |
Goal D.1: Monorepo + tooling foundation
Description: Add pnpm workspace, Turborepo pipelines, and Cursor/editor tooling so the docs app can live in web/ alongside existing Go services without package-manager conflicts.
Related milestones:
Validation: pnpm install at repo root succeeds; pnpm docs:dev resolves to Turborepo; Cursor project rules active under web/
Goal D.2: Fumadocs application and visual system
Description: Bootstrap a Fumadocs Next.js app and apply the Matte Graphite design system — tokens, MDX components, search, code blocks, OG images, and site chrome.
Related milestones:
Validation: pnpm docs:dev renders introduction page; no gradients/blurs; Cmd+K search works; visual design matches MASTER_BRIEF Part A
Goal D.3: Content authoring and IA
Description: Define sidebar information architecture, seed all leaf pages, author the 5-minute quickstart, and publish the initial manual proxy/auth API reference for implemented surfaces (OpenAPI generation deferred until a maintained spec exists).
Related milestones:
Validation: Sidebar matches IA tree; every leaf renders; pnpm docs:build succeeds; quickstart is copy-paste runnable
Goal D.4: CI/CD and preview deploys
Description: Wire GitHub Actions checks and production deployment for the unified web/ site. Historical milestone names retain the original Vercel wording, but the shipped path is GitHub Actions plus Cloudflare Pages for the apex domain.
Related milestones:
Validation: Required web checks stay green on PRs touching web/; production deploy publishes the unified site to ibexharness.com; broken links and a11y regressions block merge
Goal D.5: Verification and quality gates
Description: Visual QA baselines, Playwright screenshot tests, and a production verification script that validates redirects, key pages, OG images, and search.
Related milestones:
Validation: Baseline screenshots committed; infra/scripts/verify_phase15.sh exits 0 against preview and production
Goal D.6: Domain, DNS, and cross-site nav
Description: Configure the apex-domain DNS and wire cross-links and sitemaps for the unified ibexharness.com site. Historical milestone filenames retain the original Vercel/domain wording for URL stability, but production runs on Cloudflare Pages.
Related milestones:
Validation: Apex-domain routing is correct; legacy docs.ibexharness.com redirects to apex docs paths; cross-nav links work; sitemaps and robots.txt are verified
Last updated on