Version: 1.0.0Documentation Index
Fetch the complete documentation index at: https://docs.encoreos.io/llms.txt
Use this file to discover all available pages before exploring further.
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
- Mobile Navigation
- Breadcrumbs
- UX Analysis & Recommendations
- Implementation Reference
Standards & Architecture
Navigation Standard
Location:docs/architecture/standards/NAVIGATION_STANDARD.mdVersion: 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
- Module navigation standards
- Sub-module definitions
- Navigation registry structure
- Permission filtering (PF-30)
- Route integrity requirements
Mobile Navigation
Mobile Navigation Guide
Location:docs/development/mobile-navigation-guide.mdVersion: 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
- 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
Breadcrumbs
Breadcrumb Implementation Guide
Location:docs/development/breadcrumb-implementation-guide.mdVersion: 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
- Breadcrumb architecture
- Desktop vs mobile breadcrumbs
- Centralized route labels
- Component reference
- Implementation patterns
- Mobile breadcrumb truncation
- Custom label configuration
UX Analysis & Recommendations (Consolidated)
Navigation improvement recommendations have been consolidated here. Key priorities: From UX Analysis (2025-12-23):- Reduce mobile header vertical space (HIGH)
- Add recent/frequent pages feature (HIGH)
- Improve module search with nested navigation (HIGH)
- Add persistent navigation shortcuts (MEDIUM)
- Implement swipe gestures on mobile (MEDIUM)
- Add favorites/bookmarks system (LOW)
- Visual hierarchy and spacing – module list readability (HIGH)
- Search enhancement – nested results (HIGH)
- Module flyout improvements – reduce cognitive load (MEDIUM)
- Header search refinement – visual feedback (MEDIUM)
- Sidebar truncation fix – tooltips or wider sidebar (HIGH)
- Recent/frequent pages – quick access (HIGH)
- Visual polish – hover states and transitions (MEDIUM)
- Mobile header optimization – reduce vertical space (CRITICAL)
- Planning navigation UX improvements
- Prioritizing navigation enhancements
- Understanding current navigation issues
docs/archive/development/ (navigation improvement and UX recommendation documents).
Implementation Reference
Navigation Quick Reference
Location:docs/architecture/standards/navigation-quick-reference.mdLast 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
- Implementation tasks by phase
- Quick lookup reference
- Code examples
- Acceptance criteria
- Task dependencies
Archived Documentation
Historical navigation reviews and audits are archived indocs/archive/development/navigation/:
NAVIGATION_CONSISTENCY_REVIEW.md- Historical consistency reviewNAVIGATION_DEEP_REVIEW.md- Historical deep reviewNAVIGATION_IMPROVEMENTS_TEST_RESULTS.md- Test results from improvementsNAVIGATION_RECOMMENDATIONS_SUMMARY.md- Historical recommendationsNAVIGATION_UI_UX_AUDIT.md- Historical UI/UX audit
Documentation Hierarchy
Common Use Cases
”I need to implement navigation for a new module”
- Start with NAVIGATION_STANDARD.md to understand requirements
- Review mobile-navigation-guide.md for mobile patterns
- Use navigation-quick-reference.md for step-by-step tasks
”I need to add breadcrumbs to a page”
- Read breadcrumb-implementation-guide.md
- Check if route label exists in
route-labels.ts - Add custom label if needed
- Implement breadcrumbs using provided patterns
”I’m troubleshooting mobile navigation issues”
- Check mobile-navigation-guide.md Common Issues section
- Review responsive breakpoints and touch targets
- Verify component structure matches architecture
”I want to improve navigation UX”
- Review NAVIGATION_UX_RECOMMENDATIONS.md for prioritized recommendations (archived)
- Understand current state analysis
- Plan implementation based on priority
”I need to understand navigation architecture”
- Start with NAVIGATION_STANDARD.md for system overview
- Review mobile-navigation-guide.md Architecture section
- Check breadcrumb-implementation-guide.md Architecture section
src/platform/navigation/README.md for details.
Related Documentation
Core Documentation
- constitution.md §6.3 - Core navigation requirements
- UI/UX Standards - UI/UX patterns including navigation
- Platform Integration Layers - Platform navigation integration
Development Guides
- Mobile Gesture Guide - Mobile gesture patterns
- PWA Setup - PWA navigation considerations
Document Status
| Document | Status | Version | Last Updated |
|---|---|---|---|
| NAVIGATION_STANDARD.md | Active | 1.0.0 | 2025-01-25 |
| mobile-navigation-guide.md | Active | 1.4.0 | 2025-12-23 |
| breadcrumb-implementation-guide.md | Active | 1.1.0 | 2025-12-23 |
| Navigation recommendations | Consolidated above | - | 2026-01-31 |
| navigation-quick-reference.md | Active | - | 2025-01-25 |
| This index | Active | 1.0.0 | 2026-02-20 |
Last Updated: 2026-02-20
Maintained By: Platform Foundation Team