# v2 Wireframes

Redesigned wireframes for Codewalkers frontend — addressing 13 UX gaps identified in v1.

## Changes from v1

| # | Issue | Resolution | Wireframe |
|---|-------|------------|-----------|
| 1 | No brand identity — achromatic palette | Indigo brand color (#6366F1), differentiated tokens | [theme.md](theme.md) |
| 2 | No dark mode toggle | 3-state toggle (Sun/Monitor/Moon) in header | [app-layout.md](app-layout.md), [theme.md](theme.md) |
| 3 | Missing loading/error states across pages | Skeleton loaders, AlertCircle + retry patterns | [shared-components.md](shared-components.md) |
| 4 | No save feedback on editors | SaveIndicator component (Saving.../Saved/Failed) | [content-tab.md](content-tab.md), [plan-tab.md](plan-tab.md) |
| 5 | No breadcrumb navigation in content | Breadcrumb row above page title | [content-tab.md](content-tab.md) |
| 6 | Inconsistent empty states | Standardized EmptyState component | [shared-components.md](shared-components.md) |
| 7 | No search/filter on agents page | Provider, mode, and name search filters | [agents.md](agents.md) |
| 8 | Missing agent context (what task/initiative) | Context row on agent cards | [agents.md](agents.md) |
| 9 | No batch dispatch in execution | "Queue All Pending" button + dispatch feedback | [execution-tab.md](execution-tab.md) |
| 10 | Confusing inbox button layout | Simplified 2-button form (Send + Stop) | [inbox.md](inbox.md) |
| 11 | No initiative metadata on cards | Branch badge + project names + timestamp | [initiatives-list.md](initiatives-list.md) |
| 12 | Missing review tab loading/error | Spinner + AlertCircle states | [review-tab.md](review-tab.md) |
| 13 | No command palette | Cmd+K palette for cross-entity search | [shared-components.md](shared-components.md) |

## Files

### Theme

| File | Description |
|------|-------------|
| [theme.md](theme.md) | Complete design system specification |

### Pages

| File | Route | Description |
|------|-------|-------------|
| [app-layout.md](app-layout.md) | `*` | Global shell: consolidated header, theme toggle, health dot |
| [initiatives-list.md](initiatives-list.md) | `/initiatives` | Cards with metadata, sort, search |
| [initiative-detail.md](initiative-detail.md) | `/initiatives/$id` | Two-row header, tab badges |
| [content-tab.md](content-tab.md) | `?tab=content` | Breadcrumbs, save indicator, placeholder |
| [plan-tab.md](plan-tab.md) | `?tab=plan` | Split empty states, save indicator |
| [execution-tab.md](execution-tab.md) | `?tab=execution` | Queue All, dispatch feedback, overflow |
| [review-tab.md](review-tab.md) | `?tab=review` | Loading/error states, jump-to-unresolved |
| [agents.md](agents.md) | `/agents` | Multi-filter, search, context row |
| [inbox.md](inbox.md) | `/inbox` | Simplified question form |
| [settings.md](settings.md) | `/settings/*` | Error states on Projects |

### Components

| File | Description |
|------|-------------|
| [dialogs.md](dialogs.md) | Updated dialog wireframes |
| [shared-components.md](shared-components.md) | Reusable component specs |