- Read
Uncodixfy.mdand applied its constraints to the redesign direction. - Reviewed
using-superpowers,frontend-design, andvercel-react-best-practices. - Inspected the current app architecture and main React workflow.
- Reviewed prior redesign notes in
ai/. - Ran the app locally and inspected current desktop and mobile layouts.
- Identified current UX, design-system, and mobile issues.
- Wrote the redesign roadmap in
PLAN.md. - Wrote durable product and UX observations in
FINDINGS.md. - Implemented the first redesign pass for the app shell, workflow rail, step framing, and light/dark theme control.
- Reworked the theme switch into a morphing SVG-based control with reduced-motion-safe behavior.
- Simplified step copy and corrected selection-step language to focus on output rows instead of mapping.
- Added first-pass semantic shell tokens for surfaces, lines, and focus treatment.
- Visually verified the shell pass on desktop and mobile after implementation.
- Re-ran lint and build after implementation changes.
- Redesigned the shared upload panel primitive for calmer drop zones, action rows, and success states.
- Replaced collapsed CSV/SVG history with compact always-visible recent-file selectors for faster selection and deselection.
- Reduced SVG template density by summarizing current template metadata and truncating placeholder lists.
- Visually verified the upload-panel pass on desktop and mobile after implementation.
- Refined the recent-file selectors into a clearer desktop column layout with file name, size, and saved time while preserving the mobile stacked version.
- Replaced file size/time metadata with more useful history metadata: CSV row counts and date-only display, sorted by uploaded time descending and name ascending.
- Flattened grouped history into a denser table-like recent-file selector to reduce vertical noise.
- Restored the SVG uploader summary card and fixed the SVG history grid after the data model became more column-oriented.
- Removed the SVG current-template summary block and redundant per-row subtitle to keep the template picker tighter.
- Moved the primary browse action into each dropzone, reduced upload-panel height, and removed duplicate bottom browse buttons.
- Refactored the mapping step into a denser table-first workspace with compact status, integrated actions, and clearer unresolved-state emphasis.
- Refactored selection into the same system and added a mobile row-card fallback instead of forcing the desktop table on narrow screens.
- Reworked mobile workflow navigation from a horizontal step scroller into a compact back/next step navigator with current-step summary.
- Refactored the template editor into a clearer workspace with a stronger header, a primary canvas, and a more coherent inspector order.
- Refactored preview into a print workspace with a clearer canvas/sidebar split, status band, and calmer print action hierarchy.
- Demoted field-by-field print resizing behind an explicit disclosure so page setup remains the default visible path.
- Ran the final responsive and functional verification pass across desktop and mobile for the redesigned workflow.
- Replaced the mobile mapping stacked-table fallback with a guided one-placeholder-at-a-time flow, including previous/next navigation, next-unresolved shortcut, and jump strip.
- Restored the pre-redesign UI from commit
c1a3998dfd2e6b4d5501d19f77ffe670a919eff2into side-by-side legacy components for experiment use. - Added a PostHog-powered app variant switch using the
new-redesignfeature flag, withtestrouted to the redesigned UI and control/default routed to the legacy UI. - Added local
uiVariantoverrides for browser verification of both branches without changing the PostHog flag. - Added a persistent beta toggle so users can opt into the redesigned UI or return to the stable UI without relying on query parameters.
- Apply the system to editor, mapping, selection, and preview.
- Redesign the editor-side inspector and mapping triage panels using the same secondary-section pattern as upload history.
- Replace mobile horizontal workflow scrolling with a more deliberate small-screen navigation pattern.
- Keep running lint and build validation after each implementation pass.
- No blocking product ambiguity was found during this implementation pass.
- Functional parity remains intact for the shell/theme layer; core CSV/SVG workflow logic was not changed.
- Functional parity remains intact for upload/history behavior; this pass changed presentation and disclosure, not file-processing rules.
- Functional parity remains intact for the editor, mapping, selection, and preview redesign passes; the work stayed on layout, hierarchy, and disclosure rather than workflow capability changes.
- The redesign roadmap in
PLAN.mdhas now been implemented end to end, with verification completed after the final pass. - The mobile mapping redesign preserves the same mapping model and controls as desktop; only the narrow-screen presentation changed.
- The A/B test implementation keeps the same application state and business logic underneath both variants; only the UI component tree changes.
- The beta toggle is implemented on top of the same override mechanism as the experiment QA tools, so user opt-in does not require any separate routing or deployment.