Dashboard: Restructure root page as projects overview #205

New issue

Closed

opened 2026-02-19 14:56:05 +00:00 by mprihoda · 0 comments

mprihoda commented

2026-02-19 14:56:05 +00:00

(Migrated from github.com)

Context

Part of the dashboard hierarchical navigation redesign. Currently the root page (/) shows two flat sections: a Main Projects row and a Worktree List grid. All worktrees from all projects are mixed together.

Goal

Restructure the dashboard root to be a projects overview — the entry point into the navigation hierarchy.

Requirements

Show one card per known project (derived from registered worktrees + independently tracked main projects per #148)
Each project card shows:
- Project name and tracker type
- Number of active worktrees (as a count/badge)
- Summary status (e.g., "3 worktrees, 1 needs attention")
Clicking a project card navigates to the project details page (separate issue)
Remove the flat worktree list from the root page — worktrees are now nested under their project
Keep the "+ Create Worktree" action accessible (either on project cards or in project details)

Relationship to current code

DashboardService.renderDashboard() currently renders both sections
MainProjectsView renders project cards — needs enhancement with summary data
WorktreeListView renders the flat worktree list — moves to project details page
MainProjectService.deriveFromWorktrees() handles project discovery

Part of dashboard hierarchical navigation: Projects → Project → Worktree → Artifact
Depends on: project details page existing to navigate to
Related: #148 (track main projects independently)

## Context Part of the dashboard hierarchical navigation redesign. Currently the root page (`/`) shows two flat sections: a Main Projects row and a Worktree List grid. All worktrees from all projects are mixed together. ## Goal Restructure the dashboard root to be a **projects overview** — the entry point into the navigation hierarchy. ## Requirements - Show one card per known project (derived from registered worktrees + independently tracked main projects per #148) - Each project card shows: - Project name and tracker type - Number of active worktrees (as a count/badge) - Summary status (e.g., "3 worktrees, 1 needs attention") - Clicking a project card navigates to the **project details page** (separate issue) - Remove the flat worktree list from the root page — worktrees are now nested under their project - Keep the "+ Create Worktree" action accessible (either on project cards or in project details) ## Relationship to current code - `DashboardService.renderDashboard()` currently renders both sections - `MainProjectsView` renders project cards — needs enhancement with summary data - `WorktreeListView` renders the flat worktree list — moves to project details page - `MainProjectService.deriveFromWorktrees()` handles project discovery ## Related - Part of dashboard hierarchical navigation: Projects → Project → Worktree → Artifact - Depends on: project details page existing to navigate to - Related: #148 (track main projects independently)