Skip to content

Polish Flow Reader product experience - #2

Merged
M3RCU3Y merged 27 commits into
mainfrom
agent/flow-reader-product-polish
Aug 17, 2026
Merged

M3RCU3Y merged 27 commits into
mainfrom
agent/flow-reader-product-polish

Conversation

@M3RCU3Y

@M3RCU3Y M3RCU3Y commented Aug 16, 2026

Copy link
Copy Markdown
Owner

What changed

  • upgraded the landing experience with a stronger visual hierarchy, deeper surfaces, and a more intentional reading workspace
  • refined the Flow Reader mark and ambient backdrop
  • rebuilt library cards so selection and deletion work cleanly with keyboard, touch, and pointer input
  • improved reader-mode tab keyboard behavior and focus handling
  • tightened app metadata and PWA cache behavior
  • removed stale Gemini build configuration
  • added non-deploying CI for pull requests and feature branches
  • documented the remaining UX, reliability, privacy, architecture, and testing work in docs/UX_AUDIT.md

Why

The reader already has substantial functionality, but the product surface felt less trustworthy and coherent than the underlying feature set. This pass focuses on product polish and interaction quality without rewriting the RSVP/Bionic reading engine or changing persistence semantics.

Safety

This PR targets main but remains a draft. The branch is agent/flow-reader-product-polish; no commits were pushed directly to main. The existing GitHub Pages deployment workflow only deploys pushes to main.

Validation

Branch CI runs:

  • npm ci
  • npm run check
  • npm run build

The latest branch CI completed successfully before opening this draft PR.

Follow-up

The highest-value next pass is bundling current CDN runtime dependencies, then splitting the oversized app/import orchestration components and adding browser-level regression coverage.

M3RCU3Y commented Aug 17, 2026

Copy link
Copy Markdown
Owner Author

Maintenance follow-up added on this existing polish branch: added the MIT license, raised the runtime/CI floor to Node 24, modernized the Vite toolchain to Vite 8 + the Vite 8-compatible PWA plugin + TypeScript 7, and regenerated the npm lockfile from a clean dependency graph. No GitHub Release was added; Flow Reader remains a GitHub Pages project.

@M3RCU3Y
M3RCU3Y marked this pull request as ready for review August 17, 2026 19:54
@M3RCU3Y
M3RCU3Y merged commit 0e0b3b2 into main Aug 17, 2026
2 checks passed
@M3RCU3Y
M3RCU3Y deleted the agent/flow-reader-product-polish branch August 17, 2026 19:54
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.

1 participant