Dashboard: Sidebar navigation for worktree artifacts and links #350

New issue

Open

opened 2026-04-15 08:44:03 +00:00 by mprihoda · 0 comments

mprihoda commented

2026-04-15 08:44:03 +00:00

(Migrated from github.com)

Layer: 2 — Navigation & Document Experience
Parent: #343

Problem

Currently, viewing an artifact requires navigating to it from the worktree detail page, then using the browser back button to return. There's no way to switch between documents without going back to the worktree card first. This makes document review tedious when there are multiple artifacts to examine.

Solution

Persistent sidebar (using wa-tree / wa-tree-item from Web Awesome) that stays visible while viewing artifact content
Sidebar should list:
- All worktree artifacts organized by type/phase
- Links to PR, issue tracker, git repo web page
- Link to dev version of the software (if applicable)
- Open in Zed button
Clicking an artifact in the sidebar loads it in the main content area without losing sidebar context
HTMX-driven content swaps for smooth navigation

Reference

The procedures project uses wa-tree for sidebar navigation with hx-get + hx-target=".main-content" + hx-swap="innerHTML" — same pattern would work here.

Supersedes

#207 (Hierarchical navigation redesign)
#119 (Redesign dashboard navigation with persistent worktree sidebar)
#188 (Dedicated worktree detail page with auto-refresh)
#77 (Link reference files and view source code)

**Layer:** 2 — Navigation & Document Experience **Parent:** #343 ## Problem Currently, viewing an artifact requires navigating to it from the worktree detail page, then using the browser back button to return. There's no way to switch between documents without going back to the worktree card first. This makes document review tedious when there are multiple artifacts to examine. ## Solution 1. **Persistent sidebar** (using `wa-tree` / `wa-tree-item` from Web Awesome) that stays visible while viewing artifact content 2. Sidebar should list: - All worktree artifacts organized by type/phase - Links to PR, issue tracker, git repo web page - Link to dev version of the software (if applicable) - Open in Zed button 3. Clicking an artifact in the sidebar loads it in the main content area without losing sidebar context 4. HTMX-driven content swaps for smooth navigation ## Reference The procedures project uses `wa-tree` for sidebar navigation with `hx-get` + `hx-target=".main-content"` + `hx-swap="innerHTML"` — same pattern would work here. ## Supersedes - #207 (Hierarchical navigation redesign) - #119 (Redesign dashboard navigation with persistent worktree sidebar) - #188 (Dedicated worktree detail page with auto-refresh) - #77 (Link reference files and view source code)