Skip to content

Add PWA file-handling guide and launch support#32

Merged
zhaobozhen merged 2 commits into
mainfrom
codex/pwa-file-handling-guide
Jul 16, 2026
Merged

Add PWA file-handling guide and launch support#32
zhaobozhen merged 2 commits into
mainfrom
codex/pwa-file-handling-guide

Conversation

@zhaobozhen

@zhaobozhen zhaobozhen commented Jul 16, 2026

Copy link
Copy Markdown
Member

Summary

  • Add a desktop PWA install guide that explains how to install LibChecker WebUI and open APK, APKS, APKM, and XAPK files from Finder or File Explorer.
  • Register Chromium File Handling API associations and route launchQueue files through the existing local analyzer flow.
  • Add the web app manifest, install icons, localized copy, and lazy build handling required for desktop PWA integration.
  • Refine the auto-replaying SVG walkthrough with the LibChecker mark, Chrome-style install control, measured label width, staged checkmark drawing, reduced-motion behavior, and low-power fallback.
  • Add manifest, file-handler, browser interaction, accessibility, and motion regression coverage.

Why

The WebUI previously had no system-level entry point for installed desktop users and no in-product explanation of the install-and-share workflow. The guide appears after a successful local analysis, when the benefit is relevant, while retaining picker and drag-and-drop fallbacks for browsers without file handling support.

The animation also used fixed control geometry and guessed stroke lengths, which caused excess padding and an early checkmark fragment. Localized text width and SVG path length are now measured at runtime with compact fallbacks.

Validation

  • npm run deploy:preflight -- --target=preview
  • npm run pages:check
  • npm run test:browser --workspace @tgbot/apk-webui
  • npm run test:browser --workspace @tgbot/apk-webui -- test-browser/pwa.spec.mjs
  • npm run perf:check

All preview preflight and performance budget rows passed.

Copilot AI review requested due to automatic review settings July 16, 2026 09:23

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@zhaobozhen zhaobozhen marked this pull request as draft July 16, 2026 09:30
@zhaobozhen zhaobozhen marked this pull request as ready for review July 16, 2026 09:39
@zhaobozhen zhaobozhen merged commit 12ceb60 into main Jul 16, 2026
3 checks passed
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