# Requirements: Xtablo — Go + HTMX Product

**Defined:** 2026-05-17
**Core Value:** A user can sign in and run the Tablos workflow — organize work, attach files, discuss, and plan scheduled events — without a JS framework or managed chat provider.

## v4.0 Requirements — Figma Design Parity

Requirements for v4.0. Each maps to roadmap phases.

### Navigation & Shell

- [ ] **NAV-01**: User sees a redesigned sidebar/nav bar matching Figma (brand section, icon nav items, tablo list section, user footer)
- [ ] **NAV-02**: User sees a per-page top header bar with page title and contextual action buttons matching Figma

### Tablo List

- [ ] **LIST-01**: Tablo project cards are revamped to match Figma with updated layout, typography, and progress bar wired to real task completion percentage
- [ ] **LIST-02**: User can toggle between card grid view and list view on the tablos page
- [ ] **LIST-03**: Tablos have an active/archived status field stored in DB, visible as a UI indicator on cards and list rows

### Tasks

- [x] **TASK-01**: Kanban board columns, task cards, and drag-and-drop are restyled to match Figma
- [ ] **TASK-02**: User can switch to a grid/table view of tasks within a tablo (new view — data model + UI)
- [ ] **TASK-03**: User can switch to a roadmap/timeline view of tasks within a tablo (new view — requires due date fields added to tasks schema)

### Calendar (Planning)

- [ ] **CAL-01**: User can view their planning in a month/week/day calendar grid, replacing the current flat agenda list
- [ ] **CAL-02**: Events render as colored blocks inside calendar cells (not just text list items)
- [ ] **CAL-03**: User can filter calendar events by tablo

### Tablo Detail

- [x] **DETAIL-01**: Tablo detail page (header, tasks section, etapes section, files table) is restyled to match Figma

## v5.0 Candidates (Deferred)

### Polish & Accessibility

- **RESP-01**: Responsive layout — sidebar collapses on small screens, kanban scrolls horizontally on mobile
- **DARK-01**: Dark mode — CSS token `prefers-color-scheme` counterparts or class-toggle variant

## Out of Scope

| Feature | Reason |
|---------|--------|
| Apple sign-in | Disabled in v2.0; remains out of scope |
| Stripe / billing | Deferred until product loop validated |
| Public booking widget | Deferred to a later milestone |
| Client portal | Deferred |
| Admin app | Deferred |
| Mobile / Expo app | Out of scope for this rewrite |
| Notes / rich documents | Not part of this milestone |

## Traceability

Which phases cover which requirements. Updated during roadmap creation.

| Requirement | Phase | Status |
|-------------|-------|--------|
| NAV-01 | Phase 18 | Pending |
| NAV-02 | Phase 18 | Pending |
| LIST-01 | Phase 19 | Pending |
| LIST-02 | Phase 19 | Pending |
| LIST-03 | Phase 19 | Pending |
| TASK-01 | Phase 20 | Complete |
| DETAIL-01 | Phase 20 | Complete |
| TASK-02 | Phase 21 | Pending |
| TASK-03 | Phase 21 | Pending |
| CAL-01 | Phase 22 | Pending |
| CAL-02 | Phase 22 | Pending |
| CAL-03 | Phase 22 | Pending |

**Coverage:**
- v4.0 requirements: 12 total
- Mapped to phases: 12
- Unmapped: 0 ✓

---
*Requirements defined: 2026-05-17*
*Last updated: 2026-05-17 after initial definition*