gravl/.planning/STATE.md

Project State

Project Reference

See: .planning/PROJECT.md (updated 2026-02-15)

Core value: Logging a workout should be fast, clear, and flexible — the app never fights the user during a session Current focus: Phase 1 — Input UX

Current Position

Phase: 2 of 3 (Flexible Sets) Plan: 1 of 2 in current phase (02-01 complete) Status: Phase 2 in progress — plan 02-01 done, 02-02 pending Last activity: 2026-02-21 — Completed 02-01 (ExerciseCard dynamic setList, add-set modal, delete-set)

Progress: [█████░░░░░] 50%

Performance Metrics

Velocity:

• Total plans completed: 3
• Average duration: ~1.3 min
• Total execution time: ~0.07 hours

By Phase:

Phase	Plans	Total	Avg/Plan
01-input-ux	3/3	~4 min	~1.3 min
02-flexible-sets	1/2	~8 min	~8 min

Recent Trend:

• Last 5 plans: 01-01 (1 min), 01-03 (2 min), 01-02 (1 min), 02-01 (8 min)
• Trend: fast

Updated after each plan completion

Accumulated Context

Decisions

• Keep existing program model; custom workouts are a fork, not a replacement
• Frontend-only changes for Phase 1 (zero backend risk)
• React Hook Form + Zod approved for input validation (research recommendation)
• Do NOT modify shared program data — fork to custom_workout table for per-user changes
• StepperInput is a pure controlled component — no internal useState, all state lives in parent
• 44px minimum touch targets on stepper buttons for mobile usability; 16px font prevents iOS auto-zoom
• Decimal step (2.5) uses inputMode=decimal; integer step uses inputMode=numeric
• All App.css interactive elements have min-height: 44px; global input font-size: 16px prevents iOS auto-zoom across all form fields
• handleInputChange already accepts plain string values — WeightInput/RepsInput onChange passes string directly, no signature changes needed
• flex-start alignment on .set-row and .set-inputs accommodates taller stepper containers
• setList uses array index (not set_number key) — set_number derived as idx+1 when calling onLogSet
• Dropset weight drops: 80% then 60% of base weight, each rounded to nearest 2.5kg per app progression convention
• Last-set guard: handleDeleteSet returns early if setList.length <= 1, delete button also disabled in DOM
• progress-badge and all-done class reference setList.length instead of exercise.sets — badge reflects actual set count
• onDeleteSet prop is optional stub in ExerciseCard — backend wiring deferred to plan 02-02

Pending Todos

None yet.

Blockers/Concerns

• Phase 3 requires new DB tables (custom_workouts, custom_workout_exercises) and a source_type column on workout_logs — backend schema migration needed before Phase 3 planning

Session Continuity

Last session: 2026-02-21 Stopped at: Completed 02-01-PLAN.md (ExerciseCard dynamic setList, add-set modal, delete-set button) Resume file: None