phase 1 5 docs site

Landing, docs, blog, and benchmarks share one deploy at ibexharness.com. Legacy docs.ibexharness.com 301s to apex paths. Single sitemap and internal nav — no cross-domain dead ends.

Milestone D.6.3 — Cross-site nav + sitemaps

Status: Complete (unified-domain landing migration)
Goal: D.6
Phase: 1.5 — Docs Site
Wave: 12
Estimated effort: 1 hour
ADR required: None

Spec detail: MASTER_BRIEF.md Part D (D.6.3).


Why This Milestone Exists

Product marketing and documentation now ship from a single Next.js static export at https://ibexharness.com (landing at /, docs at /docs, blog, benchmarks, releases, roadmap). The legacy host docs.ibexharness.com becomes a 301 redirect to the same paths on apex after DNS cutover.

robots.ts and sitemap.ts emit apex URLs only. Internal nav links Home → / and Docs → /docs/... — no external cross-domain hops.

Final launch milestone before Phase 2.1.1 unblocks.


Non-Goals

  • Separate ibexdepo TanStack landing deploy (retired after cutover)
  • Shared auth between marketing and docs (unchanged)
  • Blog or changelog duplicated on a second domain

Branch

feature/m1-5-0-unified-landing-home

PR Title

feat(docs): unified landing and docs on ibexharness.com


Prerequisites


Deliverables

  • ASCII/video landing page at / (guide implementation in web)
  • Canonical SITE_URL = https://ibexharness.com; sitemap includes /
  • Home nav internal link to /; docs/blog/benchmarks unchanged
  • Private ops runbook (outside repo) for Cloudflare Pages apex attach
  • Cloudflare Redirect Rule: docs.ibexharness.com/*https://ibexharness.com/$1 (301)
  • Smoke script asserts / returns landing marker

Files Affected

File PathActionNotes
web/src/app/page.tsxAddUnified homepage
web/src/components/landing/*AddVideo, ASCII, reveal
web/src/lib/site-seo.tsModifyApex canonical URL
Ops runbook (private)AddApex DNS attach
.github/scripts/web-smoke.shModify/ landing check

Testing Requirements

  • web-smoke.sh: / returns 200 and contains ibex-landing
  • Unit: site-nav-links Home href is /
  • pnpm build:clean: static export includes /

Acceptance Criteria

  • https://ibexharness.com/ serves landing page
  • https://ibexharness.com/docs/... serves docs (unchanged)
  • Nav Home/logo links to / (internal)
  • docs.ibexharness.com/* 301s to apex (post-cutover)
  • verify_phase15.sh passes against production (make verify-phase15)

Risks

RiskProbabilityImpactMitigation
Landing PR delayed blocks cross-navMediumHighCoordinate ibexdepo PR before merge
Sitemap includes stub noindex pagesLowMediumOnly index pages with real content
GSC verification not doneLowLowManual GSC sitemap submit post-merge
Edit on GitHub

Last updated on

On this page

0%