Skip to content

chore(readme): polish for Microsoft Store launch traffic#55

Merged
nelsonduarte merged 1 commit into
mainfrom
chore/readme-polish-for-launch
May 10, 2026
Merged

chore(readme): polish for Microsoft Store launch traffic#55
nelsonduarte merged 1 commit into
mainfrom
chore/readme-polish-for-launch

Conversation

@nelsonduarte
Copy link
Copy Markdown
Owner

Why

Today PDFApps went live on the Microsoft Store. Before posting to HN / Reddit / r/SideProject, the README needed:

  • a hero screenshot (it had none),
  • the Store install badge + Download-table row (it had neither),
  • accurate Convert / Import / OCR descriptions (all three were stale by a few releases),
  • a working AppImage URL (was hard-coded to a v1.8.3 file),
  • realistic build sizes,
  • a less presumptuous sponsor section for a solo-dev project.

Major changes

  • Hero screenshot using `` so GitHub auto-switches dark/light.
  • Microsoft Store install badge at the top + dedicated row in the Download table.
  • Convert: 8 export formats (was 3). Import: 8 source formats (was 3). OCR: clarifies bundled-vs-Tesseract-wide support.
  • Build sizes refreshed against the v1.13.10 release artefacts.
  • Project structure mentions all six docs pages and every packaging dir.
  • Sponsor section trimmed; Hypercommit badge removed.

Test plan

  • GitHub renders the README without broken images
  • `` correctly swaps between viewer.png and viewer-light.png in dark/light themes
  • Microsoft Store badge links to the live listing
  • No remaining references to v1.8.3 / v1.11.0 / "82 MB" / Hypercommit
  • Sponsor block still actionable but no longer presumptuous

🤖 Generated with Claude Code

Tightens the README ahead of HN / Reddit submissions:

Hero / badges
- Add a hero screenshot using the <picture> element so GitHub serves
  the dark-theme viewer to dark-mode visitors and the light-theme
  variant to light-mode visitors.
- Replace the bespoke "PDFApps PDF Editor" base64 badge (which still
  linked to the legacy nelsonduarte.github.io URL) with a clean
  Microsoft Store install badge linking to the Store listing.
- Drop the Hypercommit badge.

Features table accuracy (was significantly underselling the app)
- OCR: clarify that we bundle 5 language packs but any Tesseract
  language can be installed separately (Tesseract supports 100+).
- Convert: list all eight current targets (DOCX, PPTX, XLSX, HTML,
  EPUB, TXT, PNG, JPG) instead of just DOCX/TXT/images.
- Import: list all eight current source formats (DOCX, PPTX, XLSX,
  HTML, EPUB, TXT, Markdown, images) instead of just TXT/Markdown/
  images. Eight import formats landed in v1.12.0.

Download table
- Promote "Get from Microsoft Store" to the first row, with the
  direct installer demoted to a second Windows row.
- Replace the broken `PDFApps-1.8.3-x86_64.AppImage` URL with a
  version-agnostic "latest" instruction.

Build sizes
- Update PDFApps.exe (~82 → ~93 MB), PDFAppsUninstall.exe (~11 → ~13
  MB) and PDFAppsSetup.exe (~104 → ~113 MB) to reflect actual v1.13.10
  artefact sizes.

Project structure
- Replace the "Single-page site with JS-based i18n" line with the
  current six-page docs/ layout, and list msix/, flatpak/, snap/,
  aur/, rpm/, winget/ packaging directories that weren't documented.

Sponsors
- Simplify to a two-line ask + the two existing buttons. Drop the
  empty Gold sponsors / Backers tiers, which felt presumptuous for
  a solo-dev project.

Why dedupe
- The "Why PDFApps?" multi-language bullet now mentions the language
  count instead of repeating the "auto-detects" wording that already
  appears in "Other highlights".

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@nelsonduarte nelsonduarte merged commit 74d5932 into main May 10, 2026
3 checks passed
@nelsonduarte nelsonduarte deleted the chore/readme-polish-for-launch branch May 10, 2026 21:50
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