Skip to content

docs: align IA/ROUTES navigation behavior with shell primitives#358

Merged
kabeier merged 2 commits into
mainfrom
codex/update-navigation-documentation-and-align-routes-s6mw3g
Apr 1, 2026
Merged

docs: align IA/ROUTES navigation behavior with shell primitives#358
kabeier merged 2 commits into
mainfrom
codex/update-navigation-documentation-and-align-routes-s6mw3g

Conversation

@kabeier

@kabeier kabeier commented Apr 1, 2026

Copy link
Copy Markdown
Owner

Motivation

  • Keep documentation accurate with the actual shell primitive wiring so authors and engineers know the single source of truth for navigation surfaces and item wiring.
  • Clarify the difference between top-nav utility responsibilities and primary destination navigation to avoid UI/UX implementation confusion.

Description

  • Updated docs/IA_MAP.md to reflect current sidebar vs mobile tab behavior with explicit breakpoint semantics and the canonical sidebar/mobile route sets.
  • Updated docs/ROUTES.md to match the IA language so both docs describe the same navigation model and behavior.
  • Strengthened the canonical-source note to point to src/components/ui/primitives/shell/primitives.tsx for shell surface/item wiring and noted src/lib/view-models/routes.ts as the source for route metadata used by mobile tab generation.
  • No runtime code changes were made; this is a documentation-only update to docs/IA_MAP.md and docs/ROUTES.md.

Testing

  • Pre-commit formatting hooks (Prettier) ran successfully on the changed markdown files.
  • Repo verification run in this workspace shows npm run test:run passed and npm run typecheck, npm run lint, and npm run format:check all passed.
  • npm run build failed due to an environment network issue downloading the Next.js SWC binary, and npm run a11y:smoke could not complete because the build artifact was missing; docs:route-status-gate was skipped for the same environment limitation.

Codex Task

@kabeier kabeier merged commit 3e1e0b7 into main Apr 1, 2026
1 check passed
@kabeier kabeier deleted the codex/update-navigation-documentation-and-align-routes-s6mw3g branch April 1, 2026 20:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant