Files
poli0981andClaude Opus 5.5 251369ede6 docs(changelog): one file per minor version under changelog/
CHANGELOG.md had grown to 805 lines across four major versions. The
notes now live in changelog/<major>.x/ver<major>.<minor>.x.md (newest
first); CHANGELOG.md is the index. Each index row keeps the anchor of the
old single-file heading, so the release notes that link to
CHANGELOG.md#<entry> still land on the right row.

- Entries moved verbatim; repo-relative links rebased (../../), links to
  files deleted since are pinned to the release's tag.
- Dated 1.0.2 and 1.0.3 (both released 2026-01-01); short entries that
  point to the GitHub release for 3.0.1, 3.1.0 and 3.1.1, which never
  had one; the "gotcha #18" reference now names the gotcha instead.
- 4.1.0 notes added.
- announce-discussion.yml also watches changelog/**.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-24 18:01:52 +07:00

7.9 KiB
Raw Permalink Blame History

Changelog — 3.2.x

Release notes for 3.2.0 – 3.2.1, newest first. Every version: CHANGELOG.md.

[3.2.1] - 2026-05-11 (Hotfix: single-instance enforcement on desktop)

Fixed

  • Desktop app spawned a new process on every launch. Each double-click of the installed app added another free-games-itchio-webapp.exe (Windows) / equivalent on macOS+Linux to the task list instead of focusing the existing window. Added tauri-plugin-single-instance v2 in webapp/src-tauri/src/lib.rs — second launch now unminimizes + focuses the running window and exits its own process before creating a duplicate. Plugin registered first in the builder chain per Tauri 2 docs so duplicate processes die before initializing HTTP/opener plugins. Gated by #[cfg(desktop)] + matching cfg(not(android, ios)) in Cargo.toml. Desktop binary boundary change → bumped Cargo.toml and tauri.conf.json from 0.1.0 to 0.1.1 (first time these have moved since v3.0.0).

Changed

  • README + README.vi badges bumped to 3.2.1.
  • About page lists tauri-plugin-single-instance v2 under Desktop dependencies.

[3.2.0] - 2026-05-10 (CI cleanup + mobile + SEO + Telegram bot path + auto-discussion)

Added

  • Mobile drawer navigation. New webapp/src/components/ui/sheet.tsx (shadcn pattern over the existing @radix-ui/react-dialog) and a MobileTopBar in webapp/src/components/sidebar.tsx. Below md, the sidebar collapses behind a hamburger; above, the desktop sidebar behaves as before. Touch targets in the nav now meet the 44pt iOS HIG minimum on small screens.
  • DataTable column priorities. Each column declares meta.priority: 1 | 2 | 3 in columns.tsx. data-table.tsx hides priority 2 below md and priority 3 below lg, so the table is usable on a phone without horizontal scrolling through every column.
  • PWA manifest + icons. webapp/public/manifest.webmanifest, icon-192.png, icon-512.png — Add to Home Screen on iOS without a service worker. Generator script: webapp/scripts/gen_assets.py.
  • SEO infrastructure. webapp/index.html now ships description, theme-color (per scheme), Open Graph (title/description/image/url/type/locale), Twitter card (summary_large_image), canonical, apple-touch-icon, manifest, and preconnect to img.itch.zone + raw.githubusercontent.com. robots.txt and sitemap.xml added under webapp/public/.
  • OG image. webapp/public/og.png (1200×630) + og.webp generated by gen_assets.py. Brand-coloured (#863bff purple, cyan accent) with project name, tagline, and URL.
  • Per-route titles. New useDocumentTitle hook (no react-helmet-async dependency). Each route now sets a contextual title (Charts — Itch.io Free Games Database, etc.); game-detail uses the game name.
  • Hash-anchor scroll. App.tsx now wires a ScrollToHash listener so links like /about#support scroll to the matching element under HashRouter.
  • About page Telegram entries. New messaging social group with Telegram (DM) and Telegram bot (game submission) plus a privacy reminder to never paste a numeric ID into public channels. About also surfaces all five FUNDING.yml destinations (GitHub Sponsors, Patreon, Ko-fi, Buy Me a Coffee, PayPal) with a footnote on PayPal explaining the legal-name receipt.
  • Sidebar Support link. Persistent heart-icon link from the sidebar (collapsed and expanded) to /about#support.
  • Telegram bot contribution flow. CONTRIBUTING.md §1b describes the bot path (DM owner → numeric ID added to local whitelist → bot dispatches bot-ingest.yml). Cross-linked from README.md, README.vi.md, and the new issue template game_via_bot.yml. Vietnamese mirror in docs/i18n/vi/CONTRIBUTING.md.
  • Privacy + ToS clauses for the bot path. docs/ToS.md §14 and docs/PrivacyPolicy.md §15 (plus VI mirrors) document Telegram-ID handling: opt-in, operator-side whitelist only, never committed to this repo, removable on DM.
  • docs/pc_spec.md + docs/dev_env.md (EN + VI). Maintainer hardware spec, mobile test devices (iPhone 14 Pro / 13 Pro Max, iOS 26.x on Chrome + Brave), and dev-env toolchain (Python 3.12, Node ≥ 22, Rust stable, JetBrains 2026.x). Cross-linked from README and CONTRIBUTING.
  • Auto-create GitHub Discussion workflow. announce-discussion.yml — on release: published posts to the Announcements category; on push to docs/** / CHANGELOG.md / README*.md posts to General, gated by [skip-discuss] in the head-commit message and a quiet skip on bot-ingest: commits. Uses gh api graphql directly (no third-party action). Setup: configure repo variables DISCUSSION_REPO_ID, DISCUSSION_ANNOUNCEMENTS_CATEGORY_ID, DISCUSSION_GENERAL_CATEGORY_ID (run the GraphQL pre-flight query in the workflow header to fetch them).

Changed

  • CI notify wrappers. notify-ci-failure.yml, notify-deploy.yml, and notify-release-pipeline.yml replace workflows: ["*"] with explicit allowlists. Every workflow run no longer fans out to all three wrappers; the Actions tab is much quieter and the per-event reusable filtering is what it always should have been.
  • bot-ingest.yml cleanup. Removed a dead final step that referenced a non-existent ${{ secrets.BOT_TOKEN }} and a result.txt file. The Python success/failure Telegram callback steps above already handle both outcomes.
  • Image hints. Game thumbnails in columns.tsx and the hero in game-detail.tsx now declare width/height (CLS), decoding="async", and fetchPriority (high for hero, low for table rows). itch.io thumbnails remain external — full WebP recompression is intentionally deferred (would require an image proxy).
  • About support card mirrors .github/FUNDING.yml exactly: 5 entries (GitHub Sponsors, Patreon, Ko-fi, BMC, PayPal).
  • README + README.vi badges bumped to 3.2.0.

Fixed

  • Bot ingest workflow had a broken final telegram callback step (wrong secret name + missing input file). Removed; the working callback steps above are unaffected.

Setup notes for maintainers (one-time, post-merge)

To enable the auto-discussion workflow, run once:

gh api graphql -f query='query{repository(owner:"poli0981",name:"free-games-itchio-list"){
  id
  discussionCategories(first:20){nodes{id slug name}}
}}'

Then in repo Settings → Secrets and variables → Actions → Variables, add:

  • DISCUSSION_REPO_ID — the repository.id from the response.
  • DISCUSSION_ANNOUNCEMENTS_CATEGORY_ID — the id of the Announcements category.
  • DISCUSSION_GENERAL_CATEGORY_ID — the id of the General category.

Without these set, the workflow runs but no-ops with a warning (safe default).