Skip to content

Redesign the UI in a hand-drawn style, with a clearer flow - #3

Merged
ftymoshchuk merged 2 commits into
mainfrom
claude/affectionate-dirac-bdukrw
Oct 16, 2026
Merged

ftymoshchuk merged 2 commits into
mainfrom
claude/affectionate-dirac-bdukrw

Conversation

@ftymoshchuk

Copy link
Copy Markdown
Owner

What changes

Look. The page now looks like notes taped to paper: wobbly ink outlines (an SVG roughness filter on each card's outline, never its text), masking tape, marker highlights, hard offset shadows and two handwriting fonts for headings and labels. Body text, inputs and paths stay in a plain system font. One light paper theme; the page is marked color-scheme: only light, so browsers that darken pages on their own leave it alone. The fonts (Caveat and Patrick Hand, SIL OFL 1.1, licences included) are bundled, so the app still needs no internet connection.

Flow.

  • Three numbered steps in plain words: Pick your clip art, Set up the page, Make your images. Rarely used settings fold away (<details>).
  • Each result card follows the step that fills it: beside it on wide screens (sticky while the step scrolls), straight after it on phones. Before, every result sat below all the steps.
  • Results are written from the response fields instead of the server's prose: what was made, images left out and how to keep them, unreadable files, a failed video's reason. Paths get a Copy button.
  • Many bundles: one Scan click lists every bundle, picks them all and checks them. Unticking a bundle that failed makes the rest ready without a re-check, and the check card follows the picks.
  • Settings errors say "Check settings", open the section the field is in and focus it.

Fixes found on the way

  • One bundle mode: picking a folder inside the scanned folder never unlocked the buttons, because nothing scanned the picked folder. It is now scanned as if typed in.
  • Batch preview sheets reported "0 files written": batch sheet results carry page counts, not file lists. The summary now counts sheets.
  • A value left out of range in a hidden field blocked every request (video length with the video off, tolerance with cleaning off; the server rejected them too). Those fields are now sent and checked only while in use.

API

  • GenerationResponse gains images_skipped (files that could not be read as images), so the UI no longer parses the message for it. Additive; existing fields and messages are unchanged.

Testing

  • ruff check . and pytest (143 tests) pass on Python 3.11 and 3.13. New tests cover the bundled fonts, that the page loads nothing from other sites, images_skipped, and the batch/subfolder behaviour above.
  • Driven in Chromium (Playwright) at desktop, tablet and phone widths:
    • single and batch flows, the subfolder pick, and bad settings;
    • too few images for a sheet, an unreadable file, the server stopped mid-use, Copy;
    • reduced motion, and a dark system setting (the page stays light).
  • axe-core (WCAG 2.2 AA + best practice): no violations in the start, generated and batch-checked states, on desktop and phone.
  • The built wheel includes the fonts, their licences and the favicon.

🤖 Generated with Claude Code

https://claude.ai/code/session_01E6aBDEnU4vqKQ4F9cnJMrL


Generated by Claude Code

The page now looks like notes taped to paper: wobbly ink outlines (an SVG
roughness filter on each card's outline, not its text), masking tape, marker
highlights, hard offset shadows and two bundled handwriting fonts (Caveat and
Patrick Hand, SIL OFL 1.1) for headings and labels, with a system font for
body text and paths. A Chalkboard theme is the dark mode; it follows the
system until the user picks one, and is applied before the first paint.
Everything is served by the app itself, so it works offline.

The flow is three numbered steps in plain words (pick your clip art, set up
the page, make your images), with rarely used settings folded away. Each
result card follows the step that fills it: beside it on wide screens, right
after it on phones, instead of all results below every step.

Results are written from the response fields rather than the server's
prose: what was made, what was left out and how to keep it, unreadable files
(now reported as `images_skipped`), and a failed video's reason. Paths have a
Copy button.

Fixes found on the way:
- In One bundle mode, picking a folder inside the scanned folder never
  unlocked the buttons, because nothing scanned the picked folder. It is now
  scanned as if typed in.
- A batch of preview sheets reported "0 files written": its results carry
  page counts, not file lists. Batch results now count sheets.
- A value left out of range in a hidden field (video length with the video
  off, tolerance with cleaning off) blocked every request. Those fields are
  now sent and checked only while in use; an invalid one is focused and
  explained.

Many bundles mode now picks every bundle found and checks them in the same
click; unticking one that failed makes the rest ready without a re-check.

axe-core reports no violations in either theme, on desktop or phone.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01E6aBDEnU4vqKQ4F9cnJMrL
Drop the Chalkboard dark theme: its tokens, the toggle in the header, the
script that applied a saved or system theme before paint, and the README
note. The page is now marked light-only (`color-scheme: only light`), so
browsers that darken pages on their own leave it as it is. A theme saved by
the old toggle is simply ignored.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01E6aBDEnU4vqKQ4F9cnJMrL
@ftymoshchuk
ftymoshchuk merged commit 21f6f1c into main Oct 16, 2026
3 checks passed
@ftymoshchuk
ftymoshchuk deleted the claude/affectionate-dirac-bdukrw branch October 16, 2026 13:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants