Files
Codewalkers/docs/wireframes/v2/README.md
Lukas May 0ff65b0b02 feat: Rename application from "Codewalk District" to "Codewalkers"
Update all user-facing strings (HTML title, manifest, header logo,
browser title updater), code comments, and documentation references.
Folder name retained as-is.
2026-03-05 12:05:08 +01:00

52 lines
3.0 KiB
Markdown

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