M18: Navigation Surfaces
Phase: A1 Amendment -- Phase 4 Roadmap: SPEC-GAP-IMPLEMENTATION-PLAN.md Phase 4 Version target:
web/v0.18.0
Phase Context
Goal: Build the five navigation surfaces (verse map, three-column minimap, breadcrumb minimap, page gutters, infinite scroll), establish a unified visual language across all of them, upgrade the command palette to three-tier ranked results with prefix modes, and implement the branching history tree that converges with the Study Map renderer.
Key constraint: Shared visual language utilities (M18-004) should be built early so that all navigation surfaces consume a single encoding system. The branching history tree (M18-007) depends on infinite scroll navigation entries; command palette escalation (M18-009) depends on both the history tree and command palette upgrade.
ZenHub Configuration
| Field | Value |
|---|---|
| Milestone | M18: Navigation Surfaces |
| Due Date | TBD |
| Default Pipeline | Product Backlog |
| Primary Epic(s) | Navigation Surfaces, Command Palette & History |
Prerequisites
- M17: Core UX -- hover card infrastructure reused for navigation previews
Epics & Issues
Epic: Navigation Surfaces
| Issue | Title | Status | Notes |
|---|---|---|---|
| M18-001 | Verse Map Navigation (Chapter/Book Grid, Completion Overlay) | ❌ To Do | Not implemented |
| M18-002 | Three-Column Minimap (Structure/Density/Position) | ❌ To Do | Not implemented |
| M18-003 | Breadcrumb Minimap (Expandable, Hierarchical Navigation) | ❌ To Do | Not implemented |
| M18-004 | Shared Visual Language Utilities (Color Encoding, Icons) | ❌ To Do | Not implemented |
| M18-005 | Page Gutters (Annotation Markers, Navigation Indicators) | ❌ To Do | Not implemented |
| M18-006 | Infinite Scroll Navigation (Continuous Reading, Lazy Load) | ❌ To Do | Not implemented |
Epic: Command Palette & History
| Issue | Title | Status | Notes |
|---|---|---|---|
| M18-007 | Branching History Tree (Session Navigation History) | ❌ To Do | Not implemented |
| M18-008 | Command Palette Upgrade (Three-Tier Results, Prefix Modes) | ❌ To Do | Not implemented |
| M18-009 | Command Palette Escalation (History + Search Integration) | ❌ To Do | Not implemented |
| M18-010 | Navigation Keyboard Shortcuts (Vim-Style, Customizable) | ❌ To Do | Not implemented |
Progress: 0 Done · 0 Partial · 10 To Do (0%)
Summary
| Metric | Count |
|---|---|
| Total Issues | 10 |
| Sub-Issues | 0 |
| Total Estimate (pts) | 74 |
| Sprints | S6--S8 |
| Dependencies (blocking) | 4 |
| Dependencies (blocked by) | 4 |