Knowledgebase — content/ junction missing

Status: ✅ Fixed (2026-05-06)
Severity: High — entire knowledge base renders blank

Symptom

http://localhost:3004/ loads but shows no content — sidebar is empty, pages 404.

Root Cause

apps/knowledgebase/content/ must be a Windows directory junction pointing to ../../docs/. Nextra reads all MDX from this path at compile time. Git does not preserve Windows junctions — after a fresh clone or git clean, the path becomes an empty plain directory, so Nextra finds no files.

Fix

From the repo root:

Remove-Item "apps\knowledgebase\content" -Recurse -Force
New-Item -ItemType Junction -Path "apps\knowledgebase\content" -Target (Resolve-Path "docs")

Verify:

ls apps\knowledgebase\content   # should list INDEX.md and subdirectories

The dev server picks up the change automatically (Next.js hot reload). If not, restart it.

Prevention

Add the recreation step to any first-time setup / onboarding script so the junction is always restored after a fresh clone.