Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.encoreos.io/llms.txt

Use this file to discover all available pages before exploring further.

Version: 1.0.0
Last Updated: 2026-02-20
Purpose: Central index for all navigation-related documentation in the Encore Health OS Platform
This index organizes all navigation documentation to help developers quickly find the right guide for their needs.

Quick Navigation


Standards & Architecture

Location: docs/architecture/standards/NAVIGATION_STANDARD.md
Version: 1.0.0
Last Updated: 2025-01-25
Purpose: Defines the authoritative navigation standards for all domain cores. When to Use:
  • Understanding module navigation structure
  • Implementing new module navigation
  • Understanding sub-module system
  • Reviewing navigation architecture decisions
  • Understanding permission-based navigation filtering
Key Topics:
  • Module navigation standards
  • Sub-module definitions
  • Navigation registry structure
  • Permission filtering (PF-30)
  • Route integrity requirements
Related: See navigation-quick-reference.md for implementation tasks.

Mobile Navigation

Mobile Navigation Guide

Location: docs/development/mobile-navigation-guide.md
Version: 1.4.0
Last Updated: 2025-12-23
Purpose: Comprehensive guide for implementing mobile navigation patterns. When to Use:
  • Implementing mobile navigation components
  • Understanding mobile navigation architecture
  • Troubleshooting mobile navigation issues
  • Implementing mobile-specific patterns (bottom nav, header, menu sheet)
  • Understanding responsive breakpoints
  • Implementing mobile gestures
Key Topics:
  • Mobile navigation architecture
  • Bottom tab bar implementation
  • Mobile header patterns
  • Mobile menu sheet
  • Responsive breakpoints
  • Touch targets and safe areas
  • Mobile gestures
  • Common issues and solutions
Related: See breadcrumb-implementation-guide.md for mobile breadcrumbs.
Location: docs/development/breadcrumb-implementation-guide.md
Version: 1.1.0
Last Updated: 2025-12-23
Purpose: Complete guide for implementing breadcrumbs in desktop and mobile contexts. When to Use:
  • Implementing breadcrumbs on a new page
  • Understanding breadcrumb architecture
  • Adding custom route labels
  • Implementing mobile breadcrumbs
  • Troubleshooting breadcrumb issues
Key Topics:
  • Breadcrumb architecture
  • Desktop vs mobile breadcrumbs
  • Centralized route labels
  • Component reference
  • Implementation patterns
  • Mobile breadcrumb truncation
  • Custom label configuration
Related: See mobile-navigation-guide.md for mobile navigation context.

UX Analysis & Recommendations (Consolidated)

Navigation improvement recommendations have been consolidated here. Key priorities: From UX Analysis (2025-12-23):
  1. Reduce mobile header vertical space (HIGH)
  2. Add recent/frequent pages feature (HIGH)
  3. Improve module search with nested navigation (HIGH)
  4. Add persistent navigation shortcuts (MEDIUM)
  5. Implement swipe gestures on mobile (MEDIUM)
  6. Add favorites/bookmarks system (LOW)
From Visual/Improvement Review (2026-01-16):
  1. Visual hierarchy and spacing – module list readability (HIGH)
  2. Search enhancement – nested results (HIGH)
  3. Module flyout improvements – reduce cognitive load (MEDIUM)
  4. Header search refinement – visual feedback (MEDIUM)
  5. Sidebar truncation fix – tooltips or wider sidebar (HIGH)
  6. Recent/frequent pages – quick access (HIGH)
  7. Visual polish – hover states and transitions (MEDIUM)
  8. Mobile header optimization – reduce vertical space (CRITICAL)
When to Use:
  • Planning navigation UX improvements
  • Prioritizing navigation enhancements
  • Understanding current navigation issues
Related: See NAVIGATION_STANDARD.md for architecture context. Full historical analyses are in docs/archive/development/ (navigation improvement and UX recommendation documents).

Implementation Reference

Location: docs/architecture/standards/navigation-quick-reference.md
Last Updated: 2025-01-25
Purpose: Step-by-step implementation tasks and quick lookup reference for navigation improvements. When to Use:
  • Implementing specific navigation features
  • Following step-by-step implementation tasks
  • Quick lookup for navigation patterns
  • Understanding implementation phases
  • Reviewing acceptance criteria
Key Topics:
  • Implementation tasks by phase
  • Quick lookup reference
  • Code examples
  • Acceptance criteria
  • Task dependencies
Related: See NAVIGATION_STANDARD.md for complete standards.

Archived Documentation

Historical navigation reviews and audits are archived in docs/archive/development/navigation/:
  • NAVIGATION_CONSISTENCY_REVIEW.md - Historical consistency review
  • NAVIGATION_DEEP_REVIEW.md - Historical deep review
  • NAVIGATION_IMPROVEMENTS_TEST_RESULTS.md - Test results from improvements
  • NAVIGATION_RECOMMENDATIONS_SUMMARY.md - Historical recommendations
  • NAVIGATION_UI_UX_AUDIT.md - Historical UI/UX audit
These documents are preserved for historical reference.

Documentation Hierarchy

Navigation Documentation

├── Standards & Architecture
│   └── NAVIGATION_STANDARD.md (Authoritative standards)

├── Implementation Guides
│   ├── mobile-navigation-guide.md (Mobile patterns)
│   ├── breadcrumb-implementation-guide.md (Breadcrumb patterns)
│   └── navigation-quick-reference.md (Implementation tasks)

└── Analysis & Planning
    └── NAVIGATION_UX_RECOMMENDATIONS.md (UX improvements)

Common Use Cases

”I need to implement navigation for a new module”

  1. Start with NAVIGATION_STANDARD.md to understand requirements
  2. Review mobile-navigation-guide.md for mobile patterns
  3. Use navigation-quick-reference.md for step-by-step tasks

”I need to add breadcrumbs to a page”

  1. Read breadcrumb-implementation-guide.md
  2. Check if route label exists in route-labels.ts
  3. Add custom label if needed
  4. Implement breadcrumbs using provided patterns

”I’m troubleshooting mobile navigation issues”

  1. Check mobile-navigation-guide.md Common Issues section
  2. Review responsive breakpoints and touch targets
  3. Verify component structure matches architecture

”I want to improve navigation UX”

  1. Review NAVIGATION_UX_RECOMMENDATIONS.md for prioritized recommendations (archived)
  2. Understand current state analysis
  3. Plan implementation based on priority

”I need to understand navigation architecture”

  1. Start with NAVIGATION_STANDARD.md for system overview
  2. Review mobile-navigation-guide.md Architecture section
  3. Check breadcrumb-implementation-guide.md Architecture section
Desktop nav: Users can switch between Dock, Sidebar, and Taskbar (Ctrl+1/2/3); theme toggle is in the header. See src/platform/navigation/README.md for details.

Core Documentation

Development Guides


Document Status

DocumentStatusVersionLast Updated
NAVIGATION_STANDARD.mdActive1.0.02025-01-25
mobile-navigation-guide.mdActive1.4.02025-12-23
breadcrumb-implementation-guide.mdActive1.1.02025-12-23
Navigation recommendationsConsolidated above-2026-01-31
navigation-quick-reference.mdActive-2025-01-25
This indexActive1.0.02026-02-20

Last Updated: 2026-02-20
Maintained By: Platform Foundation Team