# Roadmap: Xtablo Go + HTMX Rewrite

## Milestones

- ✅ **v1.0 MVP** — Phases 1-7 (shipped 2026-05-15). Archive: [`milestones/v1.0-ROADMAP.md`](milestones/v1.0-ROADMAP.md)
- ✅ **v2.0 Collaboration, Planning, and Social Sign-in** — Phases 8-12 (shipped 2026-05-16). Archive: [`milestones/v2.0-ROADMAP.md`](milestones/v2.0-ROADMAP.md)
- ✅ **v3.0 Design System & Visual Polish** — Phases 13-17 (shipped 2026-05-17). Archive: [`milestones/v3.0-ROADMAP.md`](milestones/v3.0-ROADMAP.md)

## v4.0 Active Phases

- [x] Phase 18: App Shell & Navigation — sidebar redesign + top header bar (NAV-01, NAV-02) — completed 2026-05-17
- [ ] Phase 19: Tablo List Revamp — card redesign, progress bar, status field, list/card toggle (LIST-01, LIST-02, LIST-03)
- [ ] Phase 20: Tablo Detail & Kanban — detail page + kanban restyled to Figma (DETAIL-01, TASK-01)
- [ ] Phase 21: Task Grid & Roadmap Views — new grid view + new roadmap view with date fields (TASK-02, TASK-03)
- [ ] Phase 22: Calendar Rework — month/week/day grid, event blocks, tablo filter (CAL-01, CAL-02, CAL-03)

## Phases

<details>
<summary>✅ v1.0 MVP (Phases 1-7) — SHIPPED 2026-05-15</summary>

- [x] Phase 1: Foundation — completed 2026-05-14
- [x] Phase 2: Authentication — completed 2026-05-15
- [x] Phase 3: Tablos CRUD — completed 2026-05-15
- [x] Phase 4: Tasks Kanban — completed 2026-05-15
- [x] Phase 5: File Attachments — completed 2026-05-15
- [x] Phase 6: Background Worker — completed 2026-05-15
- [x] Phase 7: Deploy v1 — completed 2026-05-15

</details>

<details>
<summary>✅ v2.0 Collaboration, Planning, and Social Sign-in (Phases 8-12) — SHIPPED 2026-05-16</summary>

- [x] Phase 8: Social Sign-in (5/5 plans) — completed 2026-05-15
- [x] Phase 9: Etapes (4/4 plans) — completed 2026-05-15
- [x] Phase 10: Events (3/3 plans) — completed 2026-05-16
- [x] Phase 11: Individual Planning (2/2 plans) — completed 2026-05-16
- [x] Phase 12: Native Tablo Chat (3/3 plans) — completed 2026-05-16

</details>

<details>
<summary>✅ v3.0 Design System & Visual Polish (Phases 13-17) — SHIPPED 2026-05-17</summary>

- [x] Phase 13: Design System Foundation (5/5 plans) — completed 2026-05-16
- [x] Phase 14: Auth Pages (2/2 plans) — completed 2026-05-16
- [x] Phase 15: Dashboard & Tablos (3/3 plans) — completed 2026-05-16
- [x] Phase 16: Tablo Detail (4/4 plans) — completed 2026-05-17
- [x] Phase 17: Chat & Planning (2/2 plans) — completed 2026-05-17

</details>

## Phase Details — v4.0

### Phase 18: App Shell & Navigation
**Goal:** Redesign the sidebar and top header bar to match the Figma design.
**Requirements:** NAV-01, NAV-02
**Plans:** 3 plans
**Success criteria:**
1. Sidebar renders brand section, icon nav items, tablo list section, and user footer matching Figma
2. Every authenticated page shows a top header bar with page title and contextual actions
3. Existing navigation functionality (logout, tablo selection) is preserved

Plans:
- [ ] 18-01-PLAN.md — AppLayout signature extension + BreadcrumbItem struct + all call sites updated
- [ ] 18-02-PLAN.md — Sidebar full HTML/CSS rebuild to Figma spec with collapse toggle
- [ ] 18-03-PLAN.md — PageHeader component, avatar dropdown, /settings stub, tests updated

### Phase 19: Tablo List Revamp
**Goal:** Restyle the tablos page with revamped cards, real progress data, list/card toggle, and status field.
**Requirements:** LIST-01, LIST-02, LIST-03
**Plans:** 3 plans
**Success criteria:**
1. Tablo cards display with updated Figma layout including a progress bar showing real task completion %
2. User can switch between card grid and list view; selection persists for the session
3. Tablos have an active/archived status field in DB; a status indicator is visible on cards and list rows
4. DB migration for status field is reversible

Plans:
- [ ] 19-01-PLAN.md — DB migration 0010, sqlc regen with status column, batch progress query, handler wiring
- [ ] 19-02-PLAN.md — Revamped TabloProjectCard template (badge, initial, progress bar) + list row CSS
- [ ] 19-03-PLAN.md — View toggle button + inline JS + tests for LIST-01/02/03

### Phase 20: Tablo Detail & Kanban Restyle
**Goal:** Restyle the tablo detail page and kanban board to match Figma.
**Requirements:** DETAIL-01, TASK-01
**Plans:** 3/3 plans complete
**Success criteria:**
1. Tablo detail header shows tablo name, status, and progress matching Figma
2. Kanban columns and task cards are restyled to match Figma
3. Drag-and-drop reorder continues to work after restyle
4. Etapes section and files table match Figma layout

Plans:
- [x] 20-01-PLAN.md — Handler + view model + route: GET /tablos/{tabloID}, TabloDetailViewModel, test scaffold
- [x] 20-02-PLAN.md — TabloDetailPage templ components: header, tab bar, kanban board, task cards
- [x] 20-03-PLAN.md — CSS restyle: tablo detail header, kanban board layout, task card, progress bar, files table

### Phase 21: Task Grid & Roadmap Views
**Goal:** Add grid/table and roadmap/timeline views to the task section of a tablo.
**Requirements:** TASK-02, TASK-03
**Success criteria:**
1. User can switch between kanban, grid, and roadmap views via a view switcher in the tablo detail
2. Grid view shows all tasks as a sortable/filterable table with key columns (title, status, assignee, due date)
3. Roadmap view shows tasks on a horizontal timeline grouped by status or date
4. Tasks have an optional due_date field in DB (migration + sqlc); roadmap uses it for positioning

### Phase 22: Calendar Rework
**Goal:** Replace the flat agenda list on /planning with a full Google Calendar-style interface.
**Requirements:** CAL-01, CAL-02, CAL-03
**Success criteria:**
1. /planning page shows a month/week/day calendar grid with navigation controls
2. Events render as colored blocks inside calendar cells rather than plain text rows
3. User can filter the calendar to show events from a specific tablo only
4. Existing event CRUD (create, edit, delete) continues to work within the new calendar UI

## Progress

| Phase | Milestone | Plans Complete | Status   | Completed  |
|-------|-----------|---------------|----------|------------|
| 1. Foundation | v1.0 | — | Complete | 2026-05-14 |
| 2. Authentication | v1.0 | 7/7 | Complete | 2026-05-15 |
| 3. Tablos CRUD | v1.0 | 3/3 | Complete | 2026-05-15 |
| 4. Tasks Kanban | v1.0 | 3/3 | Complete | 2026-05-15 |
| 5. File Attachments | v1.0 | — | Complete | 2026-05-15 |
| 6. Background Worker | v1.0 | 2/2 | Complete | 2026-05-15 |
| 7. Deploy v1 | v1.0 | — | Complete | 2026-05-15 |
| 8. Social Sign-in | v2.0 | 5/5 | Complete | 2026-05-15 |
| 9. Etapes | v2.0 | 4/4 | Complete | 2026-05-15 |
| 10. Events | v2.0 | 3/3 | Complete | 2026-05-16 |
| 11. Individual Planning | v2.0 | 2/2 | Complete | 2026-05-16 |
| 12. Native Tablo Chat | v2.0 | 3/3 | Complete | 2026-05-16 |
| 13. Design System Foundation | v3.0 | 5/5 | Complete | 2026-05-16 |
| 14. Auth Pages | v3.0 | 2/2 | Complete | 2026-05-16 |
| 15. Dashboard & Tablos | v3.0 | 3/3 | Complete | 2026-05-16 |
| 16. Tablo Detail | v3.0 | 4/4 | Complete | 2026-05-17 |
| 17. Chat & Planning | v3.0 | 2/2 | Complete | 2026-05-17 |
| 18. App Shell & Navigation | v4.0 | 0/3 | Pending | — |
| 19. Tablo List Revamp | v4.0 | 0/3 | Pending | — |
| 20. Tablo Detail & Kanban | v4.0 | 3/3 | Complete    | 2026-05-18 |
| 21. Task Grid & Roadmap Views | v4.0 | — | Pending | — |
| 22. Calendar Rework | v4.0 | — | Pending | — |