> ## 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.

# Navigation Documentation Index

> Version: 1.0.0 Last Updated: 2026-02-20 Purpose: Central index for all navigation-related documentation in the Encore Health OS Platform

**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](#standards--architecture)
* [Mobile Navigation](#mobile-navigation)
* [Breadcrumbs](#breadcrumbs)
* [UX Analysis & Recommendations](#ux-analysis--recommendations)
* [Implementation Reference](#implementation-reference)

***

## Standards & Architecture

### [Navigation Standard](../architecture/standards/NAVIGATION_STANDARD.md)

**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](../architecture/standards/navigation-quick-reference.md) for implementation tasks.

***

## Mobile Navigation

### [Mobile Navigation Guide](./mobile-navigation-guide.md)

**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](./breadcrumb-implementation-guide.md) for mobile breadcrumbs.

***

## Breadcrumbs

### [Breadcrumb Implementation Guide](./breadcrumb-implementation-guide.md)

**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](./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](../architecture/standards/NAVIGATION_STANDARD.md) for architecture context. Full historical analyses are in `docs/archive/development/` (navigation improvement and UX recommendation documents).

***

## Implementation Reference

### [Navigation Quick Reference](../architecture/standards/navigation-quick-reference.md)

**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](../architecture/standards/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](../architecture/standards/NAVIGATION_STANDARD.md) to understand requirements
2. Review [mobile-navigation-guide.md](./mobile-navigation-guide.md) for mobile patterns
3. Use [navigation-quick-reference.md](../architecture/standards/navigation-quick-reference.md) for step-by-step tasks

### "I need to add breadcrumbs to a page"

1. Read [breadcrumb-implementation-guide.md](./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](./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](../archive/development/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](../architecture/standards/NAVIGATION_STANDARD.md) for system overview
2. Review [mobile-navigation-guide.md](./mobile-navigation-guide.md) Architecture section
3. Check [breadcrumb-implementation-guide.md](./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.

***

## Related Documentation

### Core Documentation

* [constitution.md](../../constitution.md) §6.3 - Core navigation requirements
* [UI/UX Standards](./UI_UX_STANDARDS.md) - UI/UX patterns including navigation
* [Platform Integration Layers](../architecture/integrations/PLATFORM_INTEGRATION_LAYERS.md) - Platform navigation integration

### Development Guides

* [Mobile Gesture Guide](./mobile-gesture-guide.md) - Mobile gesture patterns
* [PWA Setup](./PWA_SETUP.md) - 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