From 4a5ca206db516629ffcac48c2d68edcbbd997f82 Mon Sep 17 00:00:00 2001
From: Kawa <us.fame.sq@gmail.com>
Date: Tue, 31 Mar 2026 15:22:44 +0200
Subject: [PATCH] docs: start milestone v1.2 UI Polish & Clarity

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 .planning/PROJECT.md | 17 ++++++++++++---
 .planning/STATE.md   | 52 ++++++++++++++++++++++++++++----------------
 2 files changed, 47 insertions(+), 22 deletions(-)

diff --git a/.planning/PROJECT.md b/.planning/PROJECT.md
index 918a514..a6a7360 100644
--- a/.planning/PROJECT.md
+++ b/.planning/PROJECT.md
@@ -16,9 +16,20 @@ An IT pro can go from zero to a deployable rclone setup in minutes — without n
 **Test coverage:** 159 tests across all test files — all GREEN
 **Total milestones:** 2 shipped (v1.0 + v1.1), 7 phases, 29 plans
 
-## Next Milestone Goals
+## Current Milestone: v1.2 UI Polish & Clarity
 
-*(Not yet defined — run `/gsd:new-milestone` to start next milestone)*
+**Goal:** Transform the bare functional wizard into a polished, self-explanatory experience — Material Design 3 overhaul, dark mode, contextual help, and cleanup of carried UI debt.
+
+**Target features:**
+- Remote name field clarity (explanation, examples, contextual help)
+- Step-level descriptions explaining what each wizard step does
+- App landing/intro section explaining what Ready2Blob is
+- Full Material Design 3 component overhaul (cards, inputs, buttons, elevation, shape, color tokens)
+- Dark mode toggle with accent color system
+- Help text improvements across all backend fields
+- FieldRenderer aria consistency fix
+- StepIndicator migration from inline styles to Tailwind
+- Mobile responsiveness improvements
 
 ## Constraints
 
@@ -75,4 +86,4 @@ An IT pro can go from zero to a deployable rclone setup in minutes — without n
 </details>
 
 ---
-*Last updated: 2026-03-31 after v1.1 milestone completed*
+*Last updated: 2026-03-31 after v1.2 milestone started*
diff --git a/.planning/STATE.md b/.planning/STATE.md
index 71806ec..1fef907 100644
--- a/.planning/STATE.md
+++ b/.planning/STATE.md
@@ -1,17 +1,17 @@
 ---
 gsd_state_version: 1.0
-milestone: v1.1
-milestone_name: Backlog & Tech Debt
-status: completed
-stopped_at: Milestone v1.1 archived
-last_updated: "2026-03-31T15:00:00Z"
-last_activity: 2026-03-31 — v1.1 milestone completed and archived
+milestone: v1.2
+milestone_name: UI Polish & Clarity
+status: planning
+stopped_at: Defining requirements
+last_updated: "2026-03-31T15:30:00Z"
+last_activity: 2026-03-31 — Milestone v1.2 started
 progress:
-  total_phases: 3
-  completed_phases: 3
-  total_plans: 11
-  completed_plans: 11
-  percent: 100
+  total_phases: 0
+  completed_phases: 0
+  total_plans: 0
+  completed_plans: 0
+  percent: 0
 ---
 
 # Project State
@@ -21,19 +21,33 @@ progress:
 See: .planning/PROJECT.md (updated 2026-03-31)
 
 **Core value:** An IT pro can go from zero to a deployable rclone setup in minutes — without needing to know rclone's config syntax or PowerShell deployment conventions.
-**Current focus:** v1.1 shipped — ready for next milestone
+**Current focus:** v1.2 — UI Polish & Clarity (defining requirements)
 
 ## Current Position
 
-Milestone: v1.1 (SHIPPED)
-Phase: All complete (5–7)
-Status: Archived
-Last activity: 2026-03-31 — v1.1 milestone completed and archived
+Phase: Not started (defining requirements)
+Plan: —
+Status: Defining requirements
+Last activity: 2026-03-31 — Milestone v1.2 started
 
-Progress: [██████████] 100% (v1.1)
+Progress: [░░░░░░░░░░] 0% (v1.2)
+
+## Accumulated Context
+
+### Decisions
+
+Decisions are logged in PROJECT.md Key Decisions table.
+
+### Pending Todos
+
+None yet.
+
+### Blockers/Concerns
+
+None yet.
 
 ## Session Continuity
 
-Last session: 2026-03-31T15:00:00Z
-Stopped at: Milestone v1.1 archived — ready for /gsd:new-milestone
+Last session: 2026-03-31T15:30:00Z
+Stopped at: Milestone v1.2 started — defining requirements
 Resume file: None