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 inweb) - 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 Path | Action | Notes |
|---|---|---|
web/src/app/page.tsx | Add | Unified homepage |
web/src/components/landing/* | Add | Video, ASCII, reveal |
web/src/lib/site-seo.ts | Modify | Apex canonical URL |
| Ops runbook (private) | Add | Apex DNS attach |
.github/scripts/web-smoke.sh | Modify | / landing check |
Testing Requirements
web-smoke.sh:/returns 200 and containsibex-landing- Unit:
site-nav-linksHome 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.shpasses against production (make verify-phase15)
Risks
| Risk | Probability | Impact | Mitigation |
|---|---|---|---|
| Landing PR delayed blocks cross-nav | Medium | High | Coordinate ibexdepo PR before merge |
| Sitemap includes stub noindex pages | Low | Medium | Only index pages with real content |
| GSC verification not done | Low | Low | Manual GSC sitemap submit post-merge |
Last updated on