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>
7.9 KiB
7.9 KiB
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. Addedtauri-plugin-single-instancev2 inwebapp/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)]+ matchingcfg(not(android, ios))inCargo.toml. Desktop binary boundary change → bumpedCargo.tomlandtauri.conf.jsonfrom0.1.0to0.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-instancev2 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 aMobileTopBarinwebapp/src/components/sidebar.tsx. Belowmd, 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 | 3incolumns.tsx.data-table.tsxhides priority 2 belowmdand priority 3 belowlg, 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.htmlnow ships description, theme-color (per scheme), Open Graph (title/description/image/url/type/locale), Twitter card (summary_large_image),canonical,apple-touch-icon,manifest, andpreconnecttoimg.itch.zone+raw.githubusercontent.com.robots.txtandsitemap.xmladded underwebapp/public/. - OG image.
webapp/public/og.png(1200×630) +og.webpgenerated bygen_assets.py. Brand-coloured (#863bffpurple, cyan accent) with project name, tagline, and URL. - Per-route titles. New
useDocumentTitlehook (noreact-helmet-asyncdependency). Each route now sets a contextual title (Charts — Itch.io Free Games Database, etc.); game-detail uses the game name. - Hash-anchor scroll.
App.tsxnow wires aScrollToHashlistener so links like/about#supportscroll to the matching element under HashRouter. - About page Telegram entries. New
messagingsocial 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 §1bdescribes the bot path (DM owner → numeric ID added to local whitelist → bot dispatchesbot-ingest.yml). Cross-linked from README.md, README.vi.md, and the new issue templategame_via_bot.yml. Vietnamese mirror indocs/i18n/vi/CONTRIBUTING.md. - Privacy + ToS clauses for the bot path.
docs/ToS.md §14anddocs/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— onrelease: publishedposts to the Announcements category; on push todocs/**/CHANGELOG.md/README*.mdposts to General, gated by[skip-discuss]in the head-commit message and a quiet skip onbot-ingest:commits. Usesgh api graphqldirectly (no third-party action). Setup: configure repo variablesDISCUSSION_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, andnotify-release-pipeline.ymlreplaceworkflows: ["*"]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.ymlcleanup. Removed a dead final step that referenced a non-existent${{ secrets.BOT_TOKEN }}and aresult.txtfile. The Pythonsuccess/failureTelegram callback steps above already handle both outcomes.- Image hints. Game thumbnails in
columns.tsxand the hero ingame-detail.tsxnow declarewidth/height(CLS),decoding="async", andfetchPriority(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.ymlexactly: 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— therepository.idfrom the response.DISCUSSION_ANNOUNCEMENTS_CATEGORY_ID— theidof the Announcements category.DISCUSSION_GENERAL_CATEGORY_ID— theidof the General category.
Without these set, the workflow runs but no-ops with a warning (safe default).