changelog/v<major>/<major>.<minor>.x/<version>.md for each of the 42 releases from v1.0.0 to v4.7.1, and changelog/beta/ for pre-releases (none has been published; its README says how one would be filed). CHANGELOG.md becomes the index: what the layout is, [Unreleased] exactly as it was, and a table per major version (version, date, edition) that links each file. Each file is its section, copied byte for byte except that its heading is the file's H1 (so the sub-headings move up one level, outside code fences), relative links gain ../../../ so they name the same repository paths, and the --- separators between sections are gone. Checked by reversing all three changes on every file and comparing with the original section: 40 of 40 equal. Two releases had no section: v1.0.0 (its GitHub release notes, which the changelog pointed to as "Initial stable") and v1.1.3 (its tag message). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
7.0 KiB
7.0 KiB
v3.2.0 – 2026-05-11 (The "SEO + Donate + Auto-Discussion + Health Polish + Dev Docs" Edition)
Single-PR bundle (#64) shipping eight features on top of v3.1.0. Web app + desktop bumped from 1.1.0 → 1.2.0. Repo public-facing version 3.1.0 → 3.2.0. Tag v3.2.0 is GPG-signed; companion desktop tag is desktop-v1.2.0.
🔍 SEO basics
web/index.html— full Open Graph block (og:type,og:title,og:description,og:url,og:image,og:site_name,og:locale+ alternate), Twitter Card (summary),<link rel="canonical">,meta name="author", JSON-LD (WebSite+Person+SoftwareApplication).- New
web/public/robots.txt(allow all + sitemap pointer) andweb/public/sitemap.xml(5 entries: site root, GitHub repo, all-games / top-online / changelog markdown). - New hook
web/src/hooks/useDocumentTitle.ts— setsdocument.titleto<page> · Steam F2P Trackerand re-runs on language change. Wired into all 18 routes (Dashboard / Games / TopOnline / Health / Activity / Add / About / Donate / Settings / 9 charts). - VitePWA already emits
manifest.webmanifestfromvite.config.ts; no manual manifest needed.
💬 Auto-create GitHub Discussion on release
- New
.github/workflows/announce-release-discussion.yml— fires onrelease: published(plusworkflow_dispatchwith ataginput for re-runs). - Implemented via
actions/github-script@v8+ GraphQLcreateDiscussion(REST has no equivalent). - Resolves the discussion category by slug — defaults to
Announcements, falls back toGeneralwith a logged warning, then to the first available category. - Idempotent: a GraphQL search runs first; if a discussion with the same title exists, the workflow skips with
core.notice()and returns the existing URL via output. Re-runningworkflow_dispatchis therefore a no-op. - Permissions:
contents: read,discussions: write— both granted byGITHUB_TOKENdefaults once Discussions is enabled on the repo.
💖 Donate page
- New
web/src/pages/Donate.tsxroute at/donate— grid of 5 platform cards (GitHub Sponsors, Ko-fi, Buy Me a Coffee, Patreon, PayPal) sourced from.github/FUNDING.yml. - Each card has a tinted icon ring, label, short description, and an "Open" button (
target="_blank" rel="noopener noreferrer"). - New nav item in
web/src/components/layout/Sidebar.tsxSECONDARY group (between About and Settings);Hearticon from lucide. - Full EN + VI i18n keys under
donate.*(title / subtitle / cta / footnote + per-platform label & desc).
📖 Dev docs
- New
docs/pc_spec.md(EN) +docs/i18n/vi/pc_spec.md(VI) — maintainer hardware spec mirroringE:\spec.txt(CPU / GPU / RAM / IDE) plus iPhone test-device list. - New
docs/dev_env.md(EN) +docs/i18n/vi/dev_env.md(VI) — IDE map (PyCharm / WebStorm / RustRover 2026.x), toolchain table (Python 3.12 / Node ≥ 22 / Rust stable / Tauri 2), per-area dev workflow (web / Tauri / Python pipeline), Git + GPG conventions, branch + PR flow. - New
web/src-tauri/TAURI.md— desktop build prerequisites (incl. CI's exactapt-getline), local + production build commands, signing + auto-update notes, troubleshooting. AUTHORS.md— new "Dev info" table (GitHub handle, IDE channel, toolchain versions, link map to all the above).- README "Docs" section — links the four new docs.
🤖 Telegram bot user-guide pointer
- New
docs/telegram-bot.md— one-page pointer to the externaltelegram-scraper-bot/docs/USER_GUIDE.md, bot source repo, plus a paragraph each on what the bot does and the whitelist lifecycle. CONTRIBUTING.md— section 3 (@my_skull_bot) gets a 3-line callout with the user guide link, bot source URL, and the new in-repo summary doc.web/src/pages/About.tsx— Maintainer card's privacy note now includes a "Bot user guide & source" sub-card with the same three links.
🩺 Health bucket split
web/src/pages/Health.tsx—gatherIssues()adds a fifthIssueGroup:OnlineAcUnknownfor games withtype_game === "online"andanti_cheat ∈ {"", "-"}. Previously these games were silently dropped from all categories; now they have a discoverable home.- Edge-case fix: the existing "Kernel" filter compared
(r.anti_cheat ?? "-") !== "-", missing the empty-string case. Both filters now use a normalised(r.anti_cheat ?? "").trim(). ShieldQuestionicon (lucide). EN + VI i18n keys:health.groupOnlineAcUnknown+…Desc.
🎮 Steam Desktop direct link
- New helper
web/src/lib/steam-link.ts—steamProtocolUrl(appid)returnssteam://store/<appid>,steamWebUrl(appid)returns the regular HTTPS store URL. web/src/components/games/GameDetailDrawer.tsx— single store link replaced by two buttons rendered side-by-side: a primary "Steam Desktop" (steam://) and an outline "Web" (https://). Tooltip on the desktop button explains the fallback path.- Works in both web build (browser shows protocol prompt if Steam is installed, silent fail otherwise — Web button is the safety net) and Tauri build (Tauri 2 allows
steam://navigation by default; no allow-list change needed). - EN + VI i18n:
detail.openOnSteamDesktop,detail.openOnSteamDesktopHint,detail.openOnSteamWeb.
🛌 Bi-weekly offline-player leaderboard
- New
scripts/top_offline.py— clones thetop_online.pyshape but filters_is_offline(g)(non-emptytype_game ≠ "online"). Emitsgames/top-offline.md(top 100 single-player F2P concurrents, 10-column format identical to top-online). - Calibrated tier thresholds (
_TIERS) lower than online (offline games rarely break 6-figure concurrents) —🔥 Mega ≥ 20k,⭐ Hot ≥ 5k,🟢 Healthy ≥ 1.5k,🟡 Stable ≥ 300,🟠 Low ≥ 50,🔴 Quiet ≥ 10,💀 Idle <10. - New
bash/offline.shmatches the shape ofbash/online.sh(pip install requests → run script → conditional commit). - New
.github/workflows/top-offline.yml— cron0 5 1,15 * *(1st + 15th of each month at 05:00 UTC) plusworkflow_dispatch. Shares the unifieddata-writeconcurrency group. - Health page (
web/src/pages/Health.tsx) — new manual trigger button "Top offline" (next to the existing "Top online" trigger). - Bug fix during implementation:
scripts/core/fetcher.py:update_players_only()had a hardcodedtype_game == "online"filter that would have made the offline workflow refresh zero rows. Extended with atype_filterkwarg ("online"default for backward compat,"offline", or"all");top_offline.pypassestype_filter="offline"(excludes both online and empty/unclassified type).
🔢 Versioning
| Surface | Old | New |
|---|---|---|
| Repo public-facing | 3.1.0 | 3.2.0 |
web/package.json |
1.1.0 | 1.2.0 |
web/src-tauri/Cargo.toml |
1.1.0 | 1.2.0 |
web/src-tauri/tauri.conf.json |
1.1.0 | 1.2.0 |
| Git tag (signed) | v3.1.0 |
v3.2.0 |
| Desktop tag (signed) | desktop-v1.1.0 |
desktop-v1.2.0 |