Files
free-steam-games-list/CHANGELOG.md
T
poli0981andClaude Opus 5.5 2b4b988cc7 docs: sync the community docs with the repository
A read-through against the code found about forty claims that had drifted.

README:
- Dynamic game-count and version badges. The count is index.json's total.
  The version is the newest v* release by semver, since an app release
  published last would otherwise count as "latest".
- SvelteKit 3, every desktop package, and the shard layout without a last
  shard number.
- The media host, which commits deploy, and the nine workflows the table
  left out.
- The accessibility statement and form in the link lists.

SECURITY.md:
- Fix the broken bullet list.
- Describe the real stack, and pushes with the built-in GITHUB_TOKEN.
- Add to scope: the media host, /api/ingest/*, /api/updates/desktop and the
  avatar origin.

AUTHORS.md and username.txt:
- Donations are in FUNDING.yml.
- The Add-games template is gone.
- Test devices come from pc_spec.

The issue forms lose the hash URLs, the GitHub Pages permalink, and the
editing and GPG options.

web/README.md, dev_env (EN + VI), the acknowledgements and the contact page
are updated to match. The last two are not consent documents, so nobody is
asked to accept the terms again.

CHANGELOG [Unreleased] lists all three commits.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-09 08:43:39 +07:00

149 KiB
Raw Blame History

Changelog

All notable changes to this awesome noob repo will be documented here.

[Unreleased]

✨ Added

  • An accessibility statement. ACCESSIBILITY.md says what works today with a keyboard, a screen reader and zoom, and what does not work yet: the games table, most charts, the first-run screens, zoom in the apps. It also lists which browsers and apps are checked by hand, and how a report is handled. GitHub shows it as the repository's Accessibility tab. Barriers get their own issue form and an accessibility label, and the About page links the statement and the form.
  • A pull request template covering what and why, the checks to run, and a short accessibility list for interface changes.

🐛 Fixed

  • The About page's stack list said SvelteKit 2 and counted 3,600 rows. Its footnote said everything the page loads comes from this site, which is not true of Cloudflare's beacon and human check. It now says what is true: the game data and art come from this site. The Vietnamese AI note gains the sentence it was missing.
  • Source archives (git archive, GitHub's "Source code" downloads) left out three legal documents that the web build reads, so building from one stopped. They are included now.

📚 Docs

  • The community docs match the repository again:
    • README: live game-count and version badges, SvelteKit 3, every desktop package, the shard layout, the workflows its table left out, and which commits deploy.
    • SECURITY.md: the real stack, pushes with the built-in token, and the media host and the ingest and update endpoints in scope.
    • AUTHORS.md, username.txt, CONTRIBUTING.md and the code of conduct.
    • The issue forms: the hash links, GitHub Pages permalinks and the editing and GPG options are gone. The version is under the title, not behind a hover.
    • web/README.md, docs/dev_env.md (EN + VI), the acknowledgements and the contact page. Neither of the last two is a document you accept, so nobody is asked to accept the terms again.
  • CLAUDE.md: ACCESSIBILITY.md is a claim about the code, kept true in the same pull request.

[v4.7.0] – 2026-11-03 (The "Lucky Dip" Edition)

Two small additions. A Random games page picks up to five games from the catalogue when you cannot decide what to play, and the first-run terms screen gets a way out: on the website, "Leave site" takes you back to the page you came from; in the apps, Decline now quits, which on Android it never did. No legal document changed, so nobody is asked to accept the terms again. Desktop and Android bumped 2.4.1 → 2.5.0; repo public-facing version 4.6.1 → 4.7.0. The desktop app offers 2.5.0 through its updater once the release is published; on Android, install the new APK over the old one.

✨ Added

  • Random games. /random, in the sidebar, the menu and the command palette, with a dice button on the dashboard, rolls one to five games (five to start with): online, offline or either, dead games only when you ask for them, and never one marked unsafe. Roll again for a set that avoids the games on screen; a smaller count keeps the first ones, a larger one adds to them. Opening a game and coming back keeps the picks, and nothing is stored: a reload rolls anew.
  • Leave site, on the first-run terms screen and on the notice after Decline (website only). A page may not open the browser's own start page, so it goes back to the page before the site - the new-tab page when you typed the address there, the search results when you came from a search - past every page of the site you opened in between. When the site is the first page in its tab, it says so and offers to close the tab; that takes a second click, because closing the last tab closes the browser window too.

🐛 Fixed

  • Declining the terms quits the Android app. It did nothing at all: the app asked its window to close, which does nothing on Android. Both apps now quit through Tauri's own exit, and the declined notice appears if an app is ever still open afterwards. The apps also drop a permission nothing uses any more (closing a window from script) for the one quitting needs.

🧰 Tooling & misc

  • Dependencies: SvelteKit 3.1.1 and adapter-static 4.0.1, Svelte 5.57.3, the Tauri shell plugin 2.6.0 (JavaScript and Rust together) and single-instance 2.5.5, the updater's JavaScript side 2.14.1 (its Rust side already was), wrangler 4.156.0, pytest 9.2.0 and the SonarCloud scan action 8.4.0, plus patch releases of the icon, toast and virtual-list libraries. No security advisory among them; nothing changes in how the site or the apps behave.
  • The undici override is gone: wrangler 4.156.0's local simulator pins the patched undici 7.30.1 itself.

📚 Docs

  • CLAUDE.md: how /random rolls and why it stores nothing; how Leave site finds the page before the site, and why Decline quits through exit().
  • Both READMEs list the random page and its modules.

[v4.6.1] – 2026-10-31 (The "Zip Tie" Edition)

A security pass. The desktop app's updater takes the patched zip reader v4.4.1 had to leave waiting on Tauri, and the service-worker build takes patched glob and minimatch. Nothing changes in how the site or the apps look or behave. Desktop and Android bumped 2.4.0 → 2.4.1; repo public-facing version 4.6.0 → 4.6.1. The desktop app offers 2.4.1 through its updater once the release is published; on Android, install the new APK over the old one.

🔐 Security

  • The desktop updater's zip reader is patched. tauri-plugin-updater 2.14.1 moves from zip 4 to zip 9.2, which closes six advisories in how an archive is read and extracted, one of them critical: two headers in one archive that disagree, so whatever checks an archive and whatever unpacks it could see different files. The others are symlinks pointing out of the destination, setuid bits and permissions carried through symlinks, an unbounded symlink target, and an AES entry accepted without its authentication code. The updater opens a zip only on Windows, and only after it has checked the download's signature, so a forged archive never reached it. Still waiting on Tauri: the Linux GTK 3 bindings (glib 0.18) and the unmaintained proc-macro-error, zbus_names and zvariant.
  • Build tooling: glob 14.0.3 and minimatch 11.0.3 in the service-worker build, two moderate advisories published on 2026-10-30 (an aborted walk that kept reading directories, and patterns that could take exponential time). Only this repository's own patterns reach them, at build time; the service worker precaches exactly the same 172 URLs as before.
  • deepmerge, used by the Svelte and rollup plugins to merge their own configuration at build time, has a low advisory with no fixed release. It never ships to the site, the Worker or the apps, and the alert is dismissed as a tolerable risk.

📚 Docs

  • CLAUDE.md: the glob and minimatch overrides, why they are safe and when to delete them; the undici override can go with wrangler 4.156.0.

[v4.6.0] – 2026-10-30 (The "Polyglot" Edition)

The catalogue now takes free games in every language, not only the ones that support English: about 1,300 more, most of them Chinese, Japanese or Korean, arrive through the review queue over the next days. The site and the apps get a language filter, search that matches across scripts and widths, and CSV files that Excel opens correctly; and 1,357 games filed under "Free To Play" get a real genre. Desktop and Android bumped 2.3.0 → 2.4.0; repo public-facing version 4.5.1 → 4.6.0. The desktop app offers 2.4.0 through its updater once the release is published; on Android, install the new APK over the old one.

✨ Added

  • Games in every language. Discovery used to search Steam only for free games that list English, which left out 1,592 of them: mostly Simplified Chinese (784), Japanese (317), Korean (165) and Traditional Chinese (164) only, the free Japanese visual novel //トロイメライ・ノクターン among them. It now proposes every free game whatever its languages, and every release window swept before gets one more pass. The pipeline still asks Steam in English, so tags, genres and language names stay in English; a name or description the developer never wrote in English stays in their language.
  • A language filter on Games, counted like the others and part of the link (?lang=Japanese), so a reader can keep to the languages they read. The About page says the catalogue now covers every language.
  • Search across scripts and widths. Every search box (Games, the command palette, developers, publishers and the anti-cheat list) now matches half-width and full-width forms and hiragana and katakana as one: トロイ, とろい and トロイ find the same game, and 4 finds 4. One kanji, kana or Hangul syllable is enough in the command palette.
  • /admin shows a candidate's languages, with a No English badge when English is not among them. Such games are decided like any other.

🐛 Fixed

  • The header search no longer jumps to Games in the middle of a word typed with a Japanese, Chinese or Korean input method; it waits until the word is chosen. And it keeps its focus when it does jump: until now the next letter typed after the jump went nowhere, whatever the language.
  • A CSV export opens in Excel with its Japanese, Chinese and Korean names intact (it now starts with a byte order mark).
  • A long Chinese or Japanese description is cut at the end of a sentence where it can be, and never ends in 、… or 。….
  • "Free To Play" is no longer a genre. Steam spells it with a capital T, the list of names never to use as a genre had a small one, and 1,357 games were filed under "Free To Play" - the third most common genre, and one that says nothing about a catalogue of free games. New games get their real genre, and the daily store refresh gives the 1,357 theirs from Steam, 150 a day (about nine days). A genre someone set by hand is never touched.
  • A queued store link written in full-width digits (5118700) is read as the appid it is; digits of any other script are refused. Such an appid used to slip through, and the next daily refresh would have stopped on it. The blocklist now accepts exactly the lines the site's own reader does.

🧰 Pipeline

  • Discovery runs wait in turn: backfill windows dispatched together no longer cancel each other, and a window can be swept a whole year at a time (max_pages). Each run says how many candidates do not list English.

📚 Docs

  • docs/plan/19-all-languages.md: what kept these games out, what every workflow does with them, and what is left (games not sold in the US, CJK fonts).

[v4.5.1] – 2026-10-27 (The "Speed Bump" Edition)

The site's Worker now limits how fast one address can call it, behind Cloudflare's own rate-limiting rule at the edge. Nothing changes for readers, the apps or the pipeline: every limit sits far above what they send. The desktop and Android apps stay at 2.3.0, with no new build. Repo public-facing version 4.5.0 → 4.5.1.

🔐 Security

  • Rate limits in the Worker, one budget per surface. Per address and per minute: the catalogue API 240 requests (loading the whole catalogue takes about 16), the image proxy 600, the other public API routes 120, the human check 20 (a person sends one a day) and the admin surface 300. Past a limit the Worker answers 429 Too Many Requests with Retry-After: 60 until the minute is up; the apps can read that answer, where they would otherwise have seen a network error. An IPv6 address counts by its /64, the block one subscriber is normally given. Cloudflare keeps these counts per server, so they stop a client that keeps its connection open, as browsers and most scripts do; one that reconnects for every request is left to the edge rule, which counts exactly. They are ceilings for abuse, never quotas. The limits are bindings in web/wrangler.jsonc and change by pull request.
  • Two layers, the edge first. The zone's rate-limiting rule still refuses a burst before the Worker runs, at no cost, and is the only limit on the pages themselves; the Worker adds the one-minute window the Free plan's 10-second rule cannot, and keeps holding if that rule is changed. If the Worker's limiter is ever unavailable, requests go through rather than fail.
  • The recommended edge rule now covers the whole site except the hashed JavaScript and CSS bundles, at 250 requests per 10 seconds per address. That is about twice what a first visit sends once the offline cache fills in (counted from the build: 110 to 130 requests in a few seconds). Applying it is a Cloudflare dashboard change, described in docs/SECURITY_SETUP.md §3a.

📚 Docs

  • docs/SECURITY_SETUP.md §3 describes both layers, how to check each one with curl, and the Free-plan rule budget as it stands (one of one rate limiting rule, four of five custom rules).
  • CLAUDE.md records the layer's rules: it fails open, is not logged, keeps a 60-second period and an account-unique namespace_id per binding, and needs a budget for any prefix the Worker runs first for.

[v4.5.0] – 2026-10-26 (The "Groundwork" Edition)

The site and the apps move to SvelteKit 3, the framework every page is built on. Nothing about how they look or work should change: every page, the Content-Security-Policy and the offline cache were compared with a SvelteKit 2 build of the same commit before the switch. The apps also take Tauri 2.12.5. Desktop and Android bumped 2.2.2 → 2.3.0; repo public-facing version 4.4.1 → 4.5.0. The desktop app offers 2.3.0 through its updater once the release is published; on Android, install the new APK over the old one.

🧹 Changed

  • The site and the apps build on SvelteKit 3 (3.1, with adapter-static 4). Nothing changes for readers: the same pages with the same text, the same Content-Security-Policy and the same service-worker precache, each checked against a SvelteKit 2 build of the same commit. SvelteKit 3 refuses svelte.config.js, so its options moved to web/build/sveltekit-config.ts, now with tests for both the web and the app policies; $lib imports became #lib, and the /legal/<slug> matcher moved to web/src/params.ts.
  • The service worker is wired into the build by web/build/pwa.ts, on vite-plugin-pwa: @vite-pwa/sveltekit never supported SvelteKit 3.
  • An old /#/… link to a page that no longer exists now opens the "Page not found" page (/error/404); SvelteKit 3 refuses to navigate to it in place. One that names another site (/#//other.example/…) is ignored.
  • SvelteKit now asks the site for its version (/_app/version.json, a few bytes) when a tab regains focus and once an hour, where it used to ask only after a navigation failed. A newer deploy still changes nothing until a navigation fails, which then reloads the page, as before.
  • The desktop and Android apps take Tauri 2.12.5 (tauri-build 2.7.4).

🔐 Security

  • The two SvelteKit advisories dismissed in v4.4.1 (GHSA-27mw-82g8-phjj, GHSA-pfhg-q3qv-9q6r) are fixed by the upgrade, and npm audit reports nothing: the cookie override SvelteKit 2 needed is gone.

[v4.4.1] – 2026-10-26 (The "Tune-Up" Edition)

A dependency and security pass. The desktop and Android apps take the patched TLS stack their updater talks to the release server with; the dev tooling, the Python pipeline and the CI workflows catch up with their fixes. Nothing changes in how the site or the apps look or behave. Desktop and Android bumped 2.2.1 → 2.2.2; repo public-facing version 4.4.0 → 4.4.1. The desktop app offers 2.2.2 through its updater once the release is published; on Android, install the new APK over the old one.

🔐 Security

  • The apps' TLS stack is patched. rustls 0.23.46 closes four advisories, among them an unauthenticated ServerHello that could downgrade later connections to classical key exchange; rustls-webpki 0.103.16 and webpki-root-certs 1.0.11 stop accepting certificates chained to the distrusted emSign intermediates. In the apps this is the HTTPS the updater checks for, and downloads, a new version over.
  • Also in the apps: tokio, anyhow and event-listener (soundness fixes) and plist 1.10, whose quick-xml 0.42 closes two denial-of-service advisories. Still waiting on Tauri: the zip 4 inside its updater plugin (three extraction advisories; the updater checks every download's signature before it opens it), the Linux GTK 3 bindings (glib 0.18) and the unmaintained proc-macro-error, zbus_names and zvariant. They go when Tauri moves.
  • Dev tooling: undici 7.30.1 inside wrangler's local simulator (three advisories; it runs in wrangler dev and the deploy check, never in the deployed Worker), zod 4.6.7 (in the unused-code report).
  • Two SvelteKit advisories are fixed only in SvelteKit 3 and need code this site does not have - a prerendered page forwarding an untrusted cache-control to setHeaders, and use:enhance form actions - so they are dismissed as not applicable. The move to SvelteKit 3 is a migration of its own.

🧹 Changed

  • Pipeline: certifi 2026.10.23 (the CA bundle the scrapers verify Steam with), coverage 7.17.0 for the tests, both pinned with their hashes.
  • Site and apps: bits-ui 2.20.2, Lucide 1.61.0, TanStack Virtual 3.13.48, Vite 8.3.5; tooling: wrangler 4.152.0, knip 6.43.0, Tauri CLI 2.12.4.
  • Merged by Dependabot since v4.4.0 and first shipped in these apps: Tauri 2.12.4; in the build tooling, fast-uri 3.1.9 and serialize-javascript 7.1.4 (two advisories).
  • CI: every workflow runs on actions/checkout v6 and actions/setup-python v6. The data jobs still on the Node 20 majors printed a deprecation warning on every run. The release workflows take rust-cache 2.9.3.

📚 Docs

  • CLAUDE.md: the undici override and when to delete it; why SvelteKit stays on 2 and what would make the two advisories apply again. .github/dependabot.yml: why checkout and setup-python majors are taken by hand, for every workflow at once.

[v4.4.0] – 2026-10-23 (The "Headroom" Edition)

The data pipeline grows with the catalogue again. With almost 10,000 games and a few hundred more every day, the jobs that asked Steam about one game at a time had run out of time; they now read Steam's store API fifty games a request, wait their turn instead of cancelling each other, and stop in time to save. The release also carries the tooling merged since v4.3.3 - TypeScript 7, Node 26 and Python 3.15, SonarCloud in CI, the desktop updater fix - and a certifi bump. The desktop and Android apps stay at 2.2.1, with no new build. Repo public-facing version 4.3.3 → 4.4.0.

🧰 Pipeline

  • The data jobs scale with the catalogue again. With almost 10,000 games and a few hundred more every day, three jobs that asked Steam about one game at a time had reached GitHub's six-hour limit: on 2026-10-23 Update Reviews was stopped at exactly six hours with nothing saved. The full assessment, with every measurement, is docs/plan/18-pipeline-scale.md.
  • Reviews come from Steam's store API, for every game, every day. Fifty games a request, about two minutes for the catalogue, instead of every two days and five and a half hours. The percentage is now Steam's own, which rounds down: about 4,000 games show one point less once (Counter-Strike 2 "85%" instead of "86%"), exactly as on their store pages. A summary that says 0 reviews is double-checked game by game before it replaces a percentage.
  • New games get their reviews again. Steam's per-game reviews endpoint has answered with a redirect to the store front since 2026-10-23, so the 38 games added that day were listed with "N/A". A new game now takes its summary from the store API when that endpoint gives none, and a game never read becomes "No reviews" until Steam counts its first one.
  • The daily purge needs two answers to remove a game. Steam's store API screens every game in a few minutes, and a game is removed only when appdetails agrees; "unavailable" is asked twice, five minutes apart. A run that would remove more than 100 games, or flags more than 500, stops before writing anything. It also lists earlier removals that Steam has since undone. It runs daily now, instead of a five-hour sweep on Mondays.
  • Check Dead Links is retired. In its whole life it never found a dead link: Steam sends a delisted game's page to the store front, which answers 200. The purge's screen sees delisted games (unlisted) instead.
  • No run is cancelled for waiting. The data jobs share one queue that used to hold a single waiting run: a third job cancelled it, and Update Reviews lost five of ten runs that way. The queue now holds them all, first in, first out, and every job checks out the latest main when it starts - Auto Update JSON failed four days in ten from working on the data as it was when the run was queued.
  • Every long job stops in time to save. Each workflow gives its job a time budget below its timeout: past it the job saves and commits what it did instead of being stopped with nothing, and it warns before the budget gets tight. The leaderboards skip the pauses meant for store pages (Top Online ~27 minutes instead of 48). The store-data and all-time-peak rotations stretch their cycle as the catalogue grows instead of their daily runs.
  • Force Re-fetch runs in parts (1/8 … 8/8, queued one after another), and a game whose fetch fails keeps its old data.

🧰 Tooling

  • Desktop releases keep reaching the updater. tauri-action v1 writes each file's API address into latest.json, which the app's update check refuses, so desktop 2.2.1 had to be fixed by hand before installed apps were offered it. A new step of the release workflow now rewrites those addresses to the release's own downloads, checking every signature on the way.
  • SonarCloud reads tests as tests, and no longer analyses the dataset, the Android resources the Tauri CLI generated, or the SQLite migrations its PL/SQL analyser misread.
  • SonarCloud analyses in CI. A workflow runs the scan on pull requests and on main in place of SonarCloud's automatic analysis, with its settings in sonar-project.properties (formerly .sonarcloud.properties). Commits that only carry data are not scanned. It runs both test suites with coverage first (pytest-cov for the pipeline, npm run test:coverage for the web app), so SonarCloud shows what the tests reach instead of reading 0%.
  • TypeScript 7, Node 26 and Python 3.15. The type-check runs on TypeScript 7, the native compiler: tsc for the Worker, the tests and the admin's Node code, and svelte-check --tsgo for the app. TypeScript 6 stays installed beside it, because svelte-check and SvelteKit's route types still need the JavaScript API that 7.0 does not have (the admin's svelte-check stays on it too). CI, the release builds and Cloudflare's build run Node 26, the LTS from 28 October; the pipeline, its tests and every data job run Python 3.15, which writes the shards byte for byte as 3.12 did - no re-download for anyone. The leaderboards and the dead-link log name their encoding, so they no longer crash on Windows under an older Python. A new test fails when one of the version pins drifts from the others, and Web CI now runs on workflow-only changes so it sees them. The full assessment is in docs/plan/16-toolchain-2026.md; docs/plan/17-typescript-7.1.md prepares the move to TypeScript 7 alone once 7.1 is out.

🔐 Security

  • certifi 2026.10.19 (GHSA-6q48-6c7w-9gw2), the CA bundle behind every HTTPS request the pipeline makes. eMudhra's emSign ECC Root CA - G3 had intermediates whose private keys were compromised; certifi 2026.10.18 - the version pinned here - had already dropped every emSign root, and 2026.10.19 puts back the three that are not affected (G1, C1, ECC C3) while G3 stays out. So the pipeline was never trusting the bad root, but the advisory's range covered 2026.10.18 and pip-audit flagged it; the lock now names the fixed release, with its hashes.

[v4.3.3] – 2026-10-19 (The "Locksmith" Edition)

The one open code-scanning alert is fixed, and what SonarCloud found on main is fixed or accounted for: CI installs only what it has pinned and runs no dependency's install code, the Android app stops copying its data into Google's backup, and the parsers lose the regexes that could backtrack. Desktop and Android bumped 2.2.0 → 2.2.1; repo public-facing version 4.3.2 → 4.3.3.

The apps also catch up with the website: the new Contact page, the reworded anti-cheat paragraphs of the Disclaimer and the Terms (so they show the consent gate once, with those paragraphs), and v4.3.2's anti-cheat grouping. The desktop app offers 2.2.1 through its updater once the release is published; on Android, install the new APK over the old one.

🔐 Security

  • Code scanning is clean again. The worker that decodes the catalogue now refuses a message from any origin but its own (CodeQL js/missing-origin-check). Only the page that started it can reach it, so nothing changes for anyone; the alert had been dismissed once and came back as soon as the code around it moved.
  • CI installs only what it has pinned. The release workflows, which hold the signing keys, pin every third-party action to a commit. Every npm ci runs with --ignore-scripts, and no workflow uses npx. The Python pipeline pins every package it installs, the dependencies' dependencies included, with the hash of each file, and installs wheels only (--require-hashes --only-binary :all:), so no package's setup script runs and nothing unlisted is installed.
  • The Android app no longer takes part in Android's Auto Backup. Left unset, Android copied the app's storage (your consent, your settings and the cached catalogue) into your Google account's backup, while the Privacy Policy says none of it leaves your device. From 2.2.1 it stays there; on a new phone you accept the terms again.
  • The source no longer contains raw invisible or right-to-left control characters: the pipeline's lists of characters to strip spell them as escapes.

🧹 Changed

  • Regexes that could backtrack quadratically on long input are linear now: the store page's tags and "unsupported" language rows, the discovery sweep's search rows, the review percentage and label, the chart colour tokens, the legal pages' titles, the image route's capsule path and a few more. Each new form was checked against the old one, on the dataset and on random input.
  • Lists sorted for a build hash, the sitemap or a test R2 listing state the code-unit order they always had; the admin stylesheet puts its @imports first, as CSS requires (the built stylesheet is byte-for-byte the same); Number.parseInt over the global, [[ ]] in the bash wrappers; the unused normalizeLink is gone; the Steam client mounts its retrying adapter for https only.
  • New tests pin the store page's tag and language parsing, the discovery sweep's rows, the review summary parsing and the worker's origin check.

📚 Docs

  • CLAUDE.md: the worker's origin check, the CI pinning rules (and how to add a Python dependency), the Android backup decision. docs/dev_env.md and its Vietnamese copy: run the pipeline from the repo root, with the hashed installs; they said cd scripts, from where data/ cannot be found. docs/DEPLOYMENT.md: what CI checks, CodeQL and SonarCloud included.

[v4.3.2] – 2026-10-16 (The "Pigeonhole" Edition)

The anti-cheat charts and filters know the products Steam's declarations brought in. Only the website's anti-cheat grouping and the pipeline's labels changed: the desktop and Android apps stay at 2.2.0, with no new build, and group these products from their next release. Repo public-facing version 4.3.1 → 4.3.2.

✨ Added

  • Seven more anti-cheat families: ACE (Anti-Cheat Expert), Anti-Cheat Toolkit, CrackProof, HoYoKProtect, NGS (Nexon Game Security), EA Javelin and SARD. After v4.3.1, 68 of the 159 games with a named anti-cheat sat in the charts' "Other" slice; now 35 do, and those are one-off names a developer typed. New games get the short name as their label; a label already stored stays as it was written, so nothing in the catalogue is rewritten.

🐛 Fixed

  • A product name now has to appear as a whole word to count. Matching inside words would have filed "Space Guard", "Interface Shield" or "Peacekeeper" under ACE, and "Vacuum Protect" under VAC.

[v4.3.1] – 2026-10-16 (The "Fair Play" Edition)

Anti-cheat information comes from Steam again, for every game, and the retired browser extension leaves the repository. Only the data pipeline, the admin, the docs and two legal documents changed: the desktop and Android apps stay at 2.2.0, with no new build. Repo public-facing version 4.3.0 → 4.3.1.

The data catches up through the pipeline itself. The first data job after this release cleans the notes once (about 520 games). The first anti-cheat sweep fills and corrects every game Steam has a declaration for, and every daily sweep after it keeps them in step.

🐛 Fixed

  • No game added since September had an anti-cheat. The browser extension was the only part of the project that read the anti-cheat a developer declares on Steam, and it stopped in June; the pipeline itself only looked for VAC. None of the 4,700 games added since then had one, Delta Force's kernel-level ACE included. The pipeline now reads Steam's own declaration: the product, whether it runs in the kernel, and whether it needs Secure Boot. It does so when a game is added, and for the whole catalogue every day. More than 80 games that declare an anti-cheat on Steam had none here, among them Brawlhalla, Destiny 2, THE FINALS, Delta Force, Albion Online, SMITE 2, Throne and Liberty and Dark and Darker; about 20 more get the kernel flag or note they were missing. A developer who types a paragraph where the product name goes gets a label cut to 40 characters, with the whole text kept in the note.
  • Where the list and Steam disagree, Steam's declaration wins. Wuthering Waves uses ACE, not EAC; Jujutsu Kaisen Phantom Parade's anti-cheat does not run in the kernel; Marvel Rivals' kernel flag is now known. A correction made in the admin still beats Steam. A game that declares nothing on Steam keeps what it has, because no declaration is not proof that a game has no anti-cheat (Warframe, Overwatch 2 and NARAKA declare none).
  • A game whose anti-cheat had been reset to an empty value had only its first Steam category checked for VAC, and a full re-fetch reset - to an empty value.

✨ Added

  • The anti-cheat sweep (scripts/refresh_anticheat.py), at the end of the daily Refresh Store Data run, with a commit of its own. About 160 requests to Steam's store API cover every game; a store page is read only for a declaration whose name the API leaves out. A manual Refresh Store Data run with only: anticheat runs just the sweep.

🧹 Changed

  • The browser extension is archived (steam-f2p-extension; v2.8.0 was its last release). The ingest queue (scripts/temp_info.jsonl) now takes store links only: any other key on a line is ignored, and the game is fetched from Steam. The code that merged the extension's fields is gone, along with the field lists that existed only for it.
  • The notes the extension left behind are removed: "Has paid DLC" at the start of 491 notes (the paid-DLC flag already says it, and 10 of those notes contradicted the flag) and "[hover-add]" on 26. A note left with nothing else reads "Not reviewed yet".
  • DISCLAIMER section 5 and Terms of Use item 5 now say where anti-cheat comes from: the developer's declaration on Steam. On the website the consent screen shows those two changes once.
  • "Denuvo", Steam's name for Denuvo Anti-Cheat, is grouped with it in the charts and filters.

🧰 Pipeline

  • Refresh Store Data checks out the tip of main when it starts, as the ingest does, so a run that waited its turn works on current data.
  • A retired override whose old value equals its new one no longer counts as a change on every save.

📚 Docs

  • README, CONTRIBUTING and the contact page no longer send anyone to the extension. A missing game or a correction goes in Discussions › Ideas, and the manual fork path queues links only.

[v4.3.0] – 2026-10-13 (The "Autopilot" Edition)

The admin can now approve the review queue on its own, a batch at a time and within a daily limit, and it can take games out of the catalogue and put them back. Four new admin pages show what is going on. Only the admin, its Worker routes and the data pipeline changed: the desktop and Android apps stay at 2.2.0 with no new build, there is no D1 migration, and the GitHub App keeps the same permissions. Repo public-facing version 4.2.1 → 4.3.0.

Auto-approve is off until it is turned on at /admin/automation.

✨ Added

  • Auto-approve. Every 15 minutes the Worker's cron can approve one batch of pending games, exactly as a reviewer's Approve does: a request in scripts/temp_info.jsonl that the ingest still checks game by game (free, reachable, a game, not already listed). The page sets the limits: games per batch (up to 100), games per day (up to 500, a ceiling written in code), a minimum wait before a game can be taken, the order, and which discovery sources. A batch is committed only when the previous one has been ingested and no data job is running or waiting its turn, since pushing then would cancel that job. Anything it cannot check counts as "not now". Run one batch now does one on demand, within the same limits.
  • Removing games. /admin/remove takes up to 100 games out of the catalogue at once, with a reason from a fixed list and an optional note. Both are public. A removal is a line in the new data/blocklist.jsonl, and every pipeline write leaves those games out. No scrape, re-fetch or browser-extension push can bring one back, and discovery never proposes it again. Each removal is logged once in scripts/removed_games.jsonl, so the game's page says it was removed and why. Restore puts a game back in one commit, and the game is fetched fresh from Steam. scripts/delete_game.py does the same from the command line. It used to be an interactive prompt that kept no record and did not stop the game from coming back.
  • Overview at /admin, with one card each for the queue, auto-approve's day, removals waiting for the pipeline, data jobs running now, data-quality totals, and commit jobs that failed or are stuck. The queue moved to /admin/queue, and old links are forwarded there.
  • Pipeline (/admin/pipeline): the latest runs of every data workflow, and what is running or waiting.
  • Data quality (/admin/quality): published games with something missing or unreviewed, such as safety never set or never reviewed, no genre, no tags or no publisher. Each game links to its Edit page.

🐛 Fixed

  • A free DLC, demo or tool could be added as a game. The ingest now refuses anything Steam does not call a game, and logs it as not_a_game. This applies to the browser extension too.
  • ingest_new.py crashed on an entry whose link was a number, and would have crashed again on every three-hourly run until the file was cleaned by hand. A number is now read as an appid, and anything else unusable is counted as a bad entry.
  • An ingest run that waited behind a long data job worked on the data as it was when the run was queued. It now starts from the tip of main.
  • Mark Dead Games pushed with a bare git push, so a commit landing during its run threw the run away. It now commits through the same rebase-and-retry helper as every other data job.

🧰 Pipeline

  • scripts/remove_games.py applies the blocklist. Ingest New Game Links runs it before every ingest, and a push to data/blocklist.jsonl starts that workflow. A save that would remove more than 500 games stops before writing anything, so a damaged file fails loudly instead of emptying the catalogue. Check Overrides validates the blocklist on every push that touches it.
  • Discovery counts removed games as already known.

🔐 Security

  • The app shell's lockfile takes rustls 0.23.45 (and rustls-webpki 0.103.15), closing GHSA-2mjx-qc3c-rqvc: TLS 1.3 handshake messages were accepted across encryption-level boundaries. Only the desktop updater's HTTPS client uses it; the Android app does not include it. The desktop app picks it up in its next build, and 2.2.0 is unchanged.

🧹 Housekeeping

  • 25 merged branches on GitHub, their local copies and 7 stale worktrees are gone. GitHub now deletes a pull request's branch when it is merged.
  • Dependencies: Tauri 2.12.2 and its plugins (#181), and eleven npm minor/patch updates including Svelte 5.57.2, Vite 8.3.4 and wrangler 4.149.0 (#182). The website already runs them; the apps pick them up in their next build. Dependabot no longer proposes SvelteKit 3, adapter-static 4, a new Svelte, Tailwind or TypeScript major, or a @types/node ahead of the Node 24 the project runs on.

[v4.2.1] – 2026-10-10 (The "Age Gate" Edition)

Adult Only games now have their tags, languages and paid-DLC flag. Every release date reads the same way, and the catalogue's text no longer carries HTML escapes, invisible characters or Vietnamese notes. Only the data pipeline changed: the web app and the desktop/Android apps stay at 2.2.0, with no new build. Repo public-facing version 4.2.0 → 4.2.1.

The fixes reach the catalogue through the pipeline itself. The next data job rewrites the dates, notes and text once. The next Refresh Store Data run fills the games that were empty. Every app, old or new, picks the changes up with its next catalogue download.

🐛 Fixed

  • Adult Only games had no tags, no languages and the wrong paid-DLC flag. Steam answers an anonymous visit to such a game's store page with its age check, a Sign In page no cookie gets past, and the pipeline read that page as the game's own: no language table, no tags, no DLC section. 25 games were stuck that way: about 16 adult games, plus Warframe, PUBG, Rainbow Six Siege and other age-rated games that were gated on the US servers the pipeline runs on. Every one of them was marked "no paid DLC". A gated page is now recognised and never read. Those games come from Steam's own store data instead: tags, languages with their interface/audio/subtitle columns, and the paid-DLC flag from the prices of their DLC. A game with empty tags or languages is retried every day until they fill.
  • "Point & Click". 458 games had the tag written out with its HTML escape, next to 10 with "Point & Click", so the tag filter listed both (also "Design & Illustration" and "Animation & Modeling"). About 320 descriptions showed &quot; instead of quotation marks.
  • TrackMania Nations Forever listed a language called "#lang_slovakian"; it is Slovak.

🧹 Changed

  • One release-date format. Every release date reads like "Aug 21, 2012". The catalogue held three shapes: about 1,360 games in "21 Aug, 2012" and one in Russian. Dates sent in another order or another store language are converted when they are saved. Placeholders such as "Coming soon" are left as they are.
  • The note "Có DLC trả phí", which the browser extension wrote on 482 games, now reads "Has paid DLC".
  • Invisible characters (zero-width spaces, stray direction marks) and stray spaces or tabs are removed from 56 games' names, developers, publishers and descriptions. Two games listed a publisher that was only a space.

[v4.2.0] – 2026-10-03 (The "All-Time High" Edition)

Every game now shows the most players it has ever had at once, the catalogue the site and the apps keep for offline use is a fraction of its old size and no longer readable as text, and every open dependency alert is closed. Web app + desktop/Android bumped 2.1.1 → 2.2.0; repo public-facing version 4.1.1 → 4.2.0.

On the website all of this is already live. The desktop app offers 2.2.0 through its updater once the release is published; on Android, install the new APK over the old one. The apps also pick up the Disclaimer's new paragraph on where player numbers come from, so they show the consent gate once, with that paragraph; the website already did.

✨ Added

  • All-time peak players. Every game shows the most players it has ever had at once: "All-time peak" on its page, and a sortable column in the games table and the CSV export. The number is the peak Steam Charts has recorded, which for a game it tracks goes back to the launch, read about once a month per game; for the many small games Steam Charts does not track, it is the most this project's own samples have seen. It only ever goes up. The "(peak N)" beside the player count is gone: it was the highest of our own occasional samples since the last full re-fetch, not a daily or all-time peak, and it read like one. The Disclaimer names the new source, so returning visitors see the consent gate once, showing that paragraph.

🗜️ A smaller, opaque offline cache

  • The catalogue your browser or app keeps for offline use is now stored as the packed shards it downloads, not as thousands of readable records: about 1.4 MB instead of roughly 9.5 MB, and opaque bytes in DevTools. Like the packed downloads, this is compression and obfuscation, not protection: the key is public, and the dataset stays readable in Git. The copy an earlier version saved keeps working until the data next changes, then it is replaced and deleted. Same storage keys, so the Privacy Policy and the consent gate are unchanged.
  • Opening the cached catalogue happens off the main thread now: on a desktop the longest freeze while loading it fell from about 20 ms to 6 ms, for about 45 ms more until the data is ready. The two cache keys are now written in one transaction, so a failed write can no longer leave a new index next to old data, and a cache that will not open is simply downloaded again.

🧰 Pipeline

  • scripts/refresh_peaks.py and the daily "Refresh All-Time Peaks" workflow (19:30 UTC) ask Steam Charts about a thirtieth of the catalogue a day, a page every two to three seconds, and stop for the day if it ever refuses; every run also raises the field from the pipeline's own player counts. A manual run with backfill ticked asks about every game at once, in about four hours.

🔐 Security

  • Every open dependency alert is closed (19 from Dependabot, plus the few npm audit adds); npm audit reports none. Only two of the packages run in production: devalue, whose parser is in the page and the apps (5.9.2 → 5.9.4), and urllib3 in the data pipeline (2.7.0 → 2.8.0). The rest are build and development tools: undici comes up to 7.29.1 with wrangler 4.147.0, and brace-expansion, fast-uri and serialize-javascript are lockfile-only bumps. SvelteKit 2 still asks for cookie 0.6, whose fix is only in SvelteKit 3, so an npm override gives it 0.7.2 (same API; with the static adapter that code only runs while the site is built). The sharp override is gone: wrangler's own pin now holds the patched version.

[v4.1.1] – 2026-10-03 (The "Pocket-Sized" Edition)

The site and the apps fit a phone: nothing runs off the right edge, game names are back in the leaderboards, and the Android app no longer puts its top bar under the clock. Web app + desktop/Android bumped 2.1.0 → 2.1.1; repo public-facing version 4.1.0 → 4.1.1.

On the website the phone fixes go live with this release; the caching changes below already were. The desktop app offers 2.1.1 through its updater once the release is published; on Android, install the new APK over the old one. The apps also pick up the Privacy Policy line about the image host below, so they show the consent gate once, with that paragraph; the website already did.

📱 Fits a phone

  • Nothing runs off the right edge any more. On a phone, the Dashboard's "Top genres", "Playing right now" and chart cards, and every card on Developers and Publishers, were wider than the screen: the counts and the "View all" links were cut off and the page slid sideways. One long name was enough, because a grid with no column count for small screens grows to fit its longest line. Every grid now starts at one column that fits the screen, and a test fails on any grid that does not.
  • Game names are back in the leaderboards. Top Online, Top Offline and the developer and publisher pages squeezed the name to nothing to make room for the genre badge and the review score. On a phone those two now give way to the name.
  • The Android app keeps out from under the status bar. Since 2.0.0 the top bar sat under the clock and the battery icon: the safe-area padding the 1.x app had was lost in the rewrite. The page, the menu, the dialogs, the back-to-top button and the notifications clear the status and navigation bars again, and a strip behind the status bar keeps the clock readable whichever theme the app and the phone are in. This needs Android System WebView 136 or newer, which any phone that updates it from the Play Store has.
  • Charts that fit. On a phone the Anti-Cheat, Delisted and Catalogue growth legends no longer cover the chart, axis numbers no longer print on top of each other, and the tag cloud shows the most common tags instead of dropping exactly those.
  • Smaller fixes. The header search shows its hint instead of "Search by na"; on /games a game with a long anti-cheat name no longer paints over the next card; the consent gate scrolls to its top on a short screen; long names and links in titles and game descriptions wrap instead of widening the page.

⚡ Faster repeat visits

  • Static files are cached by what they are. Only the hashed scripts, styles and fonts had a lifetime; the icons, the favicon, the social card, the manifest and Workbox's runtime were asked for again on every page load. Workbox's hashed runtime is now cached for a year like the rest of the build, and the art and manifest are fresh for a day and then refreshed in the background. Pages, the service worker and the version signal still revalidate every time, so a deploy - or a changed legal document - shows on the next load.
  • Game art comes straight out of Cloudflare's cache. Every thumbnail and hero ran the site's Worker on every view, however often it had been seen - a Worker always runs before the cache. The website now loads the AVIF copies from the site's own image host, media.free-steam-games.win, which Cloudflare caches like any static file, and falls back to the old address by itself for art the cron has not converted yet or a browser without AVIF. The desktop and Android apps are unchanged. The Privacy Policy now names the image host, so returning visitors see the consent gate once, showing that paragraph.

📚 Docs

  • docs/DEPLOYMENT.md explains which commits deploy: documentation commits stopped deploying, data commits still did, and it gives a configuration that stops both - with the one trap: the legal documents are read by the build, so a commit that changes only them must still trigger one.
  • docs/android-support.md (and its Vietnamese mirror) says which Android System WebView the safe areas need, and what to do on an older one.

[v4.1.0] – 2026-10-02 (The "Featherweight" Edition)

Game art and the catalogue both got much lighter, the deploy log lost its noise, and scrollbars finally look like the rest of the site. Web app + desktop/Android bumped 2.0.2 → 2.1.0; repo public-facing version 4.0.2 → 4.1.0.

The web changes are already live. The desktop app offers 2.1.0 through its updater once the release is published, and brings the packed catalogue with it; on Android, install the new APK over the old one. Returning visitors see the consent gate once, showing one new line in the Privacy Policy: the storage key of the new scrollbar setting.

✨ Added

  • Game art is AVIF now - heroes about 58% smaller, thumbnails about 92%. The Worker's 15-minute cron encodes each game's Steam header once with Cloudflare Images - a 230 px thumbnail and a 460 px hero - and stores it in R2; every request after that is served from the stored copy, never encoded on the fly. The ten most-played heroes went from 40 KB to 16.8 KB (SSIM 0.979 against Steam's JPEG); thumbnails are ~3.4 KB. Most-played games go first, the whole catalogue takes about a day and a half, and a hard monthly cap keeps the Images bill bounded. Browsers that do not take AVIF keep getting Steam's JPEG, and social cards always do.
  • The catalogue downloads in about a seventh of the bytes. The app now reads each shard as a packed file (/api/data/p1/*.bin, 224 KB instead of 1.5 MB): compressed, and wrapped so the site's API is no longer a ready-made JSON feed. It is obfuscation, not secrecy - the readable dataset is the repository, as it always was. The app checks what it unpacks against index.json exactly as before, and the released apps keep reading the plain files.
  • Scrollbars match the site, and can be hidden. A warm thumb that turns amber under the pointer, in both themes. Settings → Scrollbars: Visible, Hidden in tables and panels, or Hidden everywhere; hidden bars still scroll with the wheel, trackpad, touch or keyboard.

🐛 Fixed

  • Every deploy log was 91% noise. The build printed one [404] GET /img/… per prerendered game - 5,566 lines - and rendered an error page for each. They were harmless (a Worker route the build cannot see), but they buried anything worth reading. Now there are none.
  • The plain catalogue went out uncompressed. Cloudflare does not compress application/x-ndjson by default, so every full load moved ~9 MiB. A Compression Rule now brotli-compresses those files for every client, released apps included (1.5 MB → 226 KB per shard).
  • Tables showed the operating system's grey scrollbar. Tailwind 4.3's own scrollbar-thin merged with ours and, in Chromium, switched the themed bar off. Ours is now scrollbar-slim, with a test that keeps it that way.
  • Thumbnails cost two guaranteed 404s on half the catalogue, probing for a Steam capsule that hashed paths never have, and stray query strings forked the image edge cache.
  • A data-only commit redeployed the whole site (5,681 files), against what docs/DEPLOYMENT.md intends. The fix is the Workers Builds watch paths, a dashboard setting.

🔐 Security

  • /img/* can no longer be used to run up the image bill. With Cloudflare's URL transformations enabled, /cdn-cgi/image/<options>/img/… let anyone bill a new transformation per option set, through a proxy that serves any Steam game's art - a scanner found such a URL within minutes. The Worker now refuses the transformation service as a client, and URL transformations are switched off for the zone; the cron's encoding does not need them.

[v4.0.2] – 2026-09-29 (The "Right Address" Edition)

A game's tags, languages and store details are now re-read on a rotation instead of being fetched once and never again, a long data job no longer loses its work when something else lands on main, and each kind of message now has an address of its own. Web app + desktop/Android bumped 2.0.1 → 2.0.2; repo public-facing version 4.0.1 → 4.0.2.

The web changes are live as soon as this merges. The desktop app offers 2.0.2 through its updater once the release is published; on Android, install the new APK over the old one. Returning visitors see the consent gate once, listing the Privacy Policy, the Terms of Use and the Data Licence — each changed only by a contact address, and the gate shows exactly that line.

✨ Added

  • Tags, languages and the rest of a game's store data now stay current. update_data.py only fills in incomplete records, and only empty fields, so once a game had its tags, languages, platforms or header image nothing looked at them again short of a manual full re-fetch. Refresh Store Data (daily, 16:00 UTC) re-reads them on a rotation: the store page - tags, languages and their details, the paid-DLC flag - for every game once a week, and appdetails - name, header image, description, developer and publisher, release date, platforms, Metacritic, DRM notes - once a month. About 630 store pages and 150 appdetails calls a day instead of 8,800 requests in one sitting. It never blanks a value on a failed or age-gated page, never touches the hand-set fields (genre, type, anti-cheat, safety, notes), and marks a game updated only when something changed. A dry run on three games found all three with tags that had drifted since they were first fetched.

🐛 Fixed

  • A long data job lost its work if anything landed on main meanwhile. purge-unhealthy ran for four hours on 2026-09-21 and then failed on push rejected (fetch first): the data-write group serialises workflows, but a merged pull request or an /admin commit still moves main. Every data job now commits through bash/commit_push.sh, which rebases onto origin/main and retries the push.

📇 Contact

contact@poli0981.dev stays the default. Three role addresses join it, each published where a reader of that document would look:

Address For Where
security@poli0981.dev vulnerabilities, after GitHub's private reporting SECURITY.md, /.well-known/security.txt
privacy@poli0981.dev privacy questions Privacy Policy
copyright@poli0981.dev copyright, DMCA and takedown notices Data Licence, Terms of Use §6

The maintainer's website, https://poli0981.dev/, is on the About page next to the email and the links page. security.txt now lists GitHub's private vulnerability reporting first and security@ second, in RFC 9116 preference order. The full map is in AUTHORS.md and docs/Contact.md.

[v4.0.1] – 2026-09-23 (The "Human Check" Edition)

The web app now asks each browser to pass a Cloudflare Turnstile check once a day after the terms are accepted, shows a changed legal document as a diff instead of asking for a full re-read, and counts page views with Cloudflare Web Analytics. The desktop app's game artwork - blank because its webview sends a Referer the zone's Hotlink Protection refuses - is back, and nothing in the app loads data before the reader is past the consent step and the check. Web app + desktop/Android bumped 2.0.0 → 2.0.1; repo public-facing version 4.0.0 → 4.0.1.

The web changes are already live - pushing main deploys. The desktop app offers 2.0.1 through its updater once the release is published; on Android, install the new APK over the old one. Returning visitors see the consent gate once, listing only the Privacy Policy and Terms of Use changes.

✨ Added

  • A legal document that changes now shows you the change, not the whole document again. Each binding document is hashed at build time (virtual:legal-versions); when one differs from the version you accepted, the consent gate reopens on its own and lists only that document, with a +/- diff against the copy kept in your browser. TERMS_VERSION is no longer the only signal — it stays as the lever that forces a full re-read. Clearing site data removes the stored copy, and the gate then links to the full text instead.
  • Cloudflare Web Analytics, cookieless, loaded only after you accept the terms and never in the desktop or Android apps. It replaces an "automatic" edge injection that had been enabled for months and could never have worked: it inserts an inline script, and a hash-based CSP ignores 'unsafe-inline' by specification, so it only ever produced two console errors per page load. Measured on the live site: the beacon returns 200 and its reports 204, with nothing loaded at all before consent.
  • A human-verification step for suspicious page loads, and a country block (mainland China, Russia, Argentina). Both are WAF custom rules, live since 2026-09-20 and documented with their expressions and every exclusion in docs/SECURITY_SETUP.md. Verified after they went live: a plain curl with no browser User-Agent is still served every public path, and the challenge rate has stayed at 0%. BLOCKED_COUNTRIES in wrangler.jsonc makes the Worker refuse the same countries as defence in depth; the rule is the boundary, because prerendered pages never reach the Worker at all.
  • A Cloudflare Turnstile check on the website, separate from the WAF challenge above: after accepting the terms, each browser passes a Turnstile widget at most once every 24 hours before the app loads its data. The Worker verifies the token at POST /api/human-check with the TURNSTILE_SECRET secret, checking the action and the hostname; nothing is stored server-side. It is an overlay like the consent gate, so prerendered pages and crawlers are unaffected, and it is soft on purpose: /api/data/*, /img/* and the desktop and Android apps never require it (the Terms of Use promise as much). It refuses only when Cloudflare says no; a missing secret, a siteverify outage, a widget misconfiguration or being offline let the reader through for that page load. The web CSP gains challenges.cloudflare.com in script-src and a new frame-src; verify-dist.mjs fails the Tauri build if either appears there. The privacy policy and the terms describe it, so returning visitors see those two documents' changes at the consent gate once.

🐛 Fixed

  • Game artwork was blank in the desktop app (and would be on Android): the WebView2 webview sends Referer: http://tauri.localhost/, and the zone's Hotlink Protection refused every /img/* request carrying it — before the Worker ran, so nothing in the app's logs showed it. Every <img> now sets referrerpolicy="no-referrer", which the protection allows, and src/lib/images.test.ts fails on one that does not. That also fixes the thumbnails npm run dev could never show. Installed 2.0.0 apps are covered by a Configuration Rule on the zone until they update; Hotlink Protection itself stays on for other sites.

  • /activity and /charts/delisted fetched their data before consent. The root layout held the catalogue back, but those two pages called load() from effects of their own, and the activity feed also refetched on window focus. The gate now lives in Resource itself: an enabled option read inside every load(), which every resource sets to appReady() - consent accepted and the human check cleared - so a held-back load starts by itself once both are passed. src/lib/resource.test.ts fails on a new Resource without it.

  • The service worker threw non-precached-url: /200.html on every page load. navigateFallback named the adapter-static fallback, which is written into dist/ after workbox has already globbed the build output — so it was never in the precache, and the throw abandoned the rest of the worker's setup. It is now /, which is both precached and what Cloudflare and Tauri already serve for an unmatched path. verify-dist.mjs fails the build if the two ever disagree again.

  • /admin no longer writes the maintainer's email address into public Git. Commit bodies and data/overrides/*.json say admin; the four override files that already carried it were rewritten. The acting identity is still recorded in D1, where /admin/audit reads it.

  • /admin said "Your Cloudflare Access session has expired" straight after signing in, in a private window too. Its API was at /api/admin/*, behind a second Cloudflare Access application. Access issues its session cookie per application and fetch() cannot follow the sign-in redirect, so the session for /admin never reached the API and every call bounced to the login page. The API now lives at /admin/api/*, under the page's own application, and worker/index.test.ts drives it through the real router and token check. The /api/admin Access application is no longer used and can be deleted.

  • scripts/discover_new.py took any host ending in cloudflareaccess.com for an Access login page, lookalikes included; the suffix check now needs the dot.

  • The i18n, SEO and chart tests share one comment stripper instead of three regexes, one of which removed text that was never inside a comment.

📚 Docs

  • docs/ACKNOWLEDGEMENTs.md listed the dependencies of the React app — React 18, react-router, i18next, Zustand, TanStack Query, Radix, shadcn/ui, OpenPGP.js, Tailwind 3, TypeScript 5, PostCSS. None of that has shipped since the v4 rewrite. Replaced with the real list, licences checked against node_modules rather than remembered (echarts-wordcloud is ISC, not BSD-3-Clause), and the claim that /about carries a "full SPDX list" dropped — it is a curated subset.
  • docs/DEPLOYMENT.md records that a zero-duration "Workers Builds" failure on a PR branch is a preview-build artefact, not a broken commit, so the next person does not go looking for a bug that is not there.
  • docs/SECURITY_SETUP.md section 10 claimed the packaged apps survived Hotlink Protection because their webview sent no Referer, recommended switching the protection off, and said no allowlist could express the apps' origin. The first was no longer true and the last never was; it now documents the per-image fix and the Configuration Rule, with the measured check. A new section 12 covers the Turnstile widget settings, the secret and local testing with Cloudflare's test keys (web/.dev.vars.example).
  • Stale public/_headers paths (the file has been static/_headers since the SvelteKit move) and a SITE_ORIGIN that is really API_ORIGIN in src/lib/site.ts are corrected in worker/lib/http.ts, svelte.config.js and the security doc; _headers itself gains comments on why images opt out of its Referrer-Policy.

🛠 CI

  • The Android release builds the tag it releases (a manual run used to build main), installs platform-tools only (the SDK no longer carries tools, which stopped android-v2.0.0), and names the commit it built.
  • CodeQL also runs when only .mjs/.cjs files change, and verify-dist.mjs finds <script>/<style> by scanning.

[v4.0.0] – 2026-09-17 (The "Rewrite" Edition)

The end-user web app was rewritten from React 19 to SvelteKit 2 / Svelte 5, given a typeface and a palette of its own, and gained the pages it had been missing. /admin was rebuilt as an app of its own, embedded in the Worker. The data path now verifies every shard it caches, every game has a page search engines can read, the web app is installable, and the desktop app updates itself. Web app + desktop/Android bumped 1.4.5 → 2.0.0; repo public-facing version 3.4.3 → 4.0.0.

Breaking for anyone who packaged or embedded the old build: the desktop window is now resizable, the tauri-plugin-http native bridge is gone, and the Content-Security-Policy is emitted by the app itself rather than by _headers.

Deploying it needs one manual step: npx wrangler d1 migrations apply f2p-admin --remote (migration 0002_admin_state.sql). The Worker runs without it, degraded, and /admin/health says so.

🎨 A front end that looks like something

  • Rewritten on SvelteKit 2 + Svelte 5 runes. 30 routes, prerendered to static HTML — every page now ships real markup to a crawler instead of an empty shell. React, react-router, zustand, TanStack Query, cmdk and Radix are gone; Bits UI, @tanstack/svelte-virtual and svelte-sonner replace them.
  • Three self-hosted typefaces, subsetted to Latin, Latin-Ext and Vietnamese: Bricolage Grotesque for display, IBM Plex Sans for body and the 3,666-row table, JetBrains Mono for figures. The old build declared Inter and shipped no font file at all, so it had always rendered in system-ui.
  • A warm amber palette, replacing the Tailwind 3 defaults the previous version kept "until the palette rework", plus a skip link, a :focus-visible rule and a prefers-reduced-motion block — none of which had ever existed.
  • A brand mark that is geometry, not a font glyph. The old icon drew "▶" as SVG <text> in system-ui: a different shape on every platform, and tofu where no font supplied it.

📄 New pages

  • /legal/:doc — all eight documents, rendered from the repo's markdown at build time, so no markdown parser or sanitiser reaches the browser. The welcome screen used to intercept these links and redirect to /about.
  • /games/:appid — a real page per game, prerendered for all ~3,600 games from build-time seeds with VideoGame structured data, and listed in the sitemap. Player counts and reviews still come live from the catalogue.
  • /welcome — a first-run introduction, shown once after the terms are accepted: what the list is and is not, three ways in, the language, and the documents just accepted.
  • /legal — an index of the documents. An unknown document is a translated 404 rather than the dashboard.
  • /developers, /developers/:name, /publishers/:name — developer[] and publisher[] were on every record and used by nothing.
  • /stats — the fields no chart covered: Metacritic distribution, peak-vs-now retention, safety flags, language coverage, review-label buckets, and when games went quiet.
  • /charts/time gains catalogue growth (added per month, running total), and the anti-cheat index is a searchable, sortable table.

🔎 Findable

  • Open Graph and Twitter cards on every page. There were none, so a shared link rendered as a bare grey URL everywhere. og:image is a real 1200×630 PNG — it used to point at an SVG, which no social platform renders.
  • Canonical URLs on every page, not just /games/:appid.
  • sitemap.xml generated from the route table. The old one listed four URLs, three of them pointing at github.com, and none of the app's own routes.
  • PNG icons for the PWA manifest and apple-touch-icon, which never accepted SVG.

🛠️ /admin rebuilt

  • Its own app. The two Worker-rendered pages (1,400 lines of HTML and script inside template literals) are replaced by a Svelte 5 app in web/admin/, embedded in the Worker and served only behind Cloudflare Access, with a nonce-only script policy. None of it reaches dist/, the service worker or the packaged apps, and the build fails if any does.
  • Decided rows are read-only. Approved, committed and rejected rows, and undecided rows for a game that is already published, have no checkbox and are skipped by select-all. The server enforces the same rules from one shared module, and every row a decision cannot touch comes back with a reason instead of being dropped silently.
  • Reopen a rejected row from its details, with the reason when it cannot be.
  • Every decision is confirmed first; tabs, search, sort and page live in the URL; keyboard shortcuts; a phone layout.
  • Corrections are reviewed as a diff before the commit, bulk changes can set or retire any field across pages, and a settled override file can be deleted.
  • Jobs, Audit and Health have their own pages. Health still draws its table when the answer is a 503, and Test write proves the write path.
  • Deferring or requeueing a failed row next to an open one no longer 500s; an approval whose commit landed but whose queue update failed says exactly that and leaves its job marked committed.
  • Reconcile holds a D1 lease, sweeps undecided rows whose game appeared in data/ by another route, and skips the dataset fetch while nothing changed.
  • audit_log and commit_jobs are pruned after 180 days, as the privacy policy now says.
  • npm run dev:admin runs the real handlers against an in-memory database, so the admin can be worked on without deploying it.

🧮 Data you can trust

  • data/index.json carries a SHA-256 per shard, and last_updated changes only when the data did — a pipeline run that changed nothing no longer makes every visitor re-download ~6 MB.
  • The Worker serves ?v=<sha256> shard requests content-addressed and immutable, and refuses (503) while GitHub's CDN still has the previous bytes.
  • The app caches only a generation whose hashes verified, keeps the last good one for offline use, and re-checks when the tab comes back. A long-lived tab used to show a count and date days out of date.

📲 Installable, and updatable

  • The web app registers its service worker (it never had, on the SvelteKit build), offers installation, works offline, and asks before reloading into an update.
  • The desktop app updates itself: it checks a feed at /api/updates/desktop, which offers only a published desktop-v* release, shows the notes, and restarts into the new version. The old endpoint pointed at the repository's "latest" release, usually a dataset release, and 404'd.
  • Updating no longer wipes settings: the webview is cleared once, only when coming from a build older than 2.0.
  • steam:// links open the Steam client from the apps.

🔐 Security

  • A negative limit disabled the SQL bound. Math.min(Number("-1") || 50, 200) is -1, and SQLite treats a negative LIMIT as unlimited — so ?limit=-1 dumped the entire never-pruned audit log. Clamped.
  • A token with a missing or non-numeric exp never expired. exp is now required and numeric.
  • The JWT is no longer accepted from a cookie on writes. Only the Cf-Access-Jwt-Assertion header, which browsers never send cross-site.
  • A signing-key rotation locked out admin and ingest for up to an hour as an opaque 404; the JWKS is refetched once on an unknown kid, and a fetch failure is now a 503 rather than "not found".
  • Every server crash was reported to the reviewer as "Session expired" — the admin pages sniff Content-Type, and an unhandled throw became Cloudflare's HTML 1101 page. There is a top-level handler now.
  • A reject can no longer downgrade an approved game, which would have made it permanently invisible to every future discovery sweep.
  • header_image is validated as an HTTPS Steam CDN URL, not merely length-capped.

✅ Tests, where there were none

docs/ADMIN.md claimed the override byte-parity between scripts/edit_game.py and the Worker was "asserted by a parity test". No test existed anywhere in the repo. Vitest now covers the app, the Worker (against a real SQLite database with the real migrations) and the admin app; pytest covers the index hashing; cargo covers the upgrade purge. The first 95 were each checked by mutation, not merely by passing. verify-dist.mjs reads the built HTML in CI for the mistakes that only exist there.

🖥️ Binary 2.0.0

  • The window unlocks. It was pinned to exactly 1400×900, non-resizable and non-maximisable, which made a responsive redesign pointless on the one platform that could not use it. Now 1280×860, resizable, minimum 880×600.
  • tauri-plugin-http removed along with its https://github.com/* capability. It existed for the GitHub OAuth Device Flow, which went with sign-in; the only remaining GitHub call is the Android release check, which is a plain fetch to an endpoint that sends CORS headers.
  • Real paths, no hash router. tauri::manager::get_asset() resolves /games/730 through its own fallback chain; the note claiming the webview had no server-side fallback was out of date. Links from released 1.4.x builds are still upgraded on load.

🐛 Fixed on the live site

  • Raw placeholders on screen: Languages ({{count}}), (PEAK {{PEAK}}) as a field label, (peak {{peak}}) on a chart axis, and one in a prerendered meta description. A test now reads every call site.
  • Hovering a chart tile, bar or slice blanked it (the colour format zrender cannot parse), the genre treemap tooltip printed ({d}%), and axis names were clipped on /stats.
  • The command palette crashed on open (a duplicate route), the consent overlay covered the documents it asked people to read, unknown URLs rendered the dashboard, and old /#/ links changed the address bar without the page.
  • Vietnamese readers saw English for the legal document names, the table's data-issue hints and the About page's stack. 137 locale keys nothing used any more are gone, and a test fails on the next one.
  • The report-only CSP messages in the console come from Cloudflare's Continuous script monitoring, not the site; docs/SECURITY_SETUP.md says how to turn it off.

🐛 Console

Every reported error is fixed, and each was measured rather than assumed:

  • GitHub avatars were blocked by CSP on /activity. They are proxied through the Worker at /img/gh/*, so img-src stays 'self'.
  • The Cloudflare Access re-auth fetch was blocked. It uses a full-page redirect now.
  • [Violation] 'setTimeout' handler took 122ms — zero long tasks while four charts initialise, because each waits for an IntersectionObserver instead of all of them racing in one frame.
  • [Violation] non-passive 'mousewheel' listener — zrender binds both wheel and mousewheel with no options object, unconditionally. Four blocking listeners for two charts, measured; now zero.

📇 Contact

The maintainer address is contact@poli0981.dev; every other channel is https://poli0981.dev/links/. CODE_OF_CONDUCT.md had no reporting address at all. /.well-known/security.txt exists and is served as text/plain — it used to return the app shell with HTTP 200.

[v3.4.3] – 2026-09-11 (The "Own Domain" Edition)

The site moved off GitHub Pages to free-steam-games.win on Cloudflare, and the catalogue gained a reviewed intake path for new games plus durable manual corrections. Web app + desktop/Android bumped 1.4.4 → 1.4.5; repo public-facing version 3.4.2 → 3.4.3. Tags v3.4.3, desktop-v1.4.5 and android-v1.4.5 are GPG-signed; both binary workflows publish draft releases.

🌐 New home

  • Served by a Cloudflare Worker with static assets; data is proxied same-origin at /api/data/*, Steam art at /img/*. Details: docs/DEPLOYMENT.md.
  • Real URLs on the web (/games/730) instead of /#/games/730; old hash links are upgraded on load. The desktop/Android shell keeps hash routing.
  • Content-Security-Policy and hardening headers, with a check command for every setting in docs/SECURITY_SETUP.md.

📥 New games: discovered, then reviewed

  • Discover New Games sweeps the Steam store daily into a review queue; the maintainer approves at /admin (behind Cloudflare Access). Approval queues the game for ingest_new.py, and a reconcile cron confirms it landed.
  • Submissions from outside now come only through the browser extension; the issue-template and Telegram-bot paths were removed.

✏️ Corrections that survive the pipeline

  • Manual fixes (genre, notes, anti-cheat…) live in data/overrides/<appid>.json and are re-applied on every write, so a refetch or genre normalisation can no longer revert them. Edit from /admin/edit (single game or bulk by genre) or scripts/edit_game.py.

📄 Data & licensing

  • Dataset licensed separately under CC BY 4.0 (LICENSE-DATA); code stays MIT. Terms updated, so the consent prompt appears once more.
  • description is now a short quotation — capped at 180 characters and attributed in the app.
  • The bulk markdown tables in games/ were removed; the two leaderboards stay.

🖥️ Desktop & Android

  • Packaged apps now read from free-steam-games.win; the Worker sends CORS for /api/data/* so they can. Builds made from main before this fix could not load the catalogue — no released build was affected.
  • The Tauri webview has a real CSP (ipc: included, so native calls keep working). Smoke-test the draft builds before publishing.

[v3.4.2] – 2026-06-15 (The "Android Floor" Edition)

Android-focused release that raises the APK's minimum OS, hides a desktop-only affordance on phones, and documents the support policy with sourced numbers. Web app + desktop/Android bumped 1.4.3 → 1.4.4; repo public-facing version 3.4.1 → 3.4.2. Tag v3.4.2 is GPG-signed; the Android APK ships from android-v1.4.4.

🤖 Minimum Android raised to 11 (API 30)

  • build.gradle.kts minSdk 24 → 30. Android's package installer refuses to install the APK below this (INSTALL_FAILED_OLDER_SDK), so the version floor doubles as the OS-level install gate — no in-app check, no bypass. Don't re-run tauri android init (it would reset it).
  • Why 11, not lower: Android 7–10 are deeply end-of-life — Google ships OS security backports only for 14/15/16 as of mid-2026 — and tend to carry an outdated System WebView that breaks the modern ES2022 / React 19 output of the Vite 8 / Rolldown bundle. A minSdk 30 floor still reaches ~87% of active Android devices (StatCounter, May 2026) while dropping only the dead tail. Android 11–13 install but no longer get Google OS patches — called out explicitly in the docs.

📱 "Steam Desktop" button hidden on mobile

  • The steam:// "Steam Desktop" button in GameDetailDrawer.tsx can't reach a Steam client on a phone, so it's now hidden on the Android app or a sub-768px viewport; the "Web" button stays. Gated by a new reactive useIsMobile.ts hook (useSyncExternalStore + matchMedia("(max-width: 767px)"), OR the existing isAndroid() from external-open.ts) — re-renders on resize / rotation. No new i18n strings.

📚 Docs & transparency

[v3.4.1] – 2026-06-14 (The "Chart Hotfix" Edition)

Patch release fixing a production regression introduced by the Vite 8 / Rolldown deploy hotfix (#95): every chart tab threw a blank React error #130 and failed to render. Web app + desktop bumped 1.4.0 → 1.4.1; repo public-facing version 3.4.0 → 3.4.1.

🐛 Charts render again (React #130)

  • EChart.tsx imported the chart wrapper from echarts-for-react/lib/core — the CommonJS build. Under Vite 8's Rolldown bundler the CJS default-interop wraps module.exports = class into a namespace object, so <ReactEChartsCore/> received an object instead of a component → React error #130 on every chart page (all pages/charts/* + the Dashboard). Switched the import to the ESM build echarts-for-react/esm/core, which has a clean export default. echarts core and echarts-wordcloud were already ESM, so this single import was the only offender.
  • Verified at runtime against the production (Rolldown) build (the step skipped in #95): bar, pie/donut, line, treemap, heatmap and wordcloud charts all render with zero console errors. echarts/openpgp remain lazy async chunks (not eager-preloaded in index.html).

⚠️ glib advisory (Linux desktop) — acknowledged, no upstream fix

  • The Dependabot alert for the glib crate (GHSA-wrw7-89jp-8q8g, medium, Linux-only) cannot be resolved within Tauri 2.x: the latest webkit2gtk crate (2.0.2) pins glib ^0.18, tao/wry pin gtk ^0.18, and Tauri 3 is not released. Only the Linux build links glib (Windows = WebView2, macOS = Cocoa) and the app does not call the affected API, so the alert is dismissed as tolerable risk. Will revisit when the upstream stack adopts gtk-rs 0.20. See TAURI.md.

Feature release on top of v3.3.0 adding an explicit, up-front acceptance of the project's legal documents on both surfaces: a first-run consent gate in the app (web + desktop) and a real license-agreement page in the Windows installer. No backend, no cookies — acceptance is a single localStorage flag, versioned so it can re-prompt when the terms change, and naturally fresh in incognito/private tabs. Web app + desktop bumped 1.3.0 → 1.4.0. Repo public-facing version 3.3.0 → 3.4.0. Tag v3.4.0 is GPG-signed; companion desktop tag is desktop-v1.4.0.

  • New ConsentGate.tsx — a full-screen card (styled like the error pages, eager bundle, no flash) that blocks the main UI until the user ticks a checkbox and clicks Continue. Mounted inside AppErrorBoundary + HashRouter in main.tsx, wrapping <App/> (the <Toaster/> stays a sibling). A gate crash is still caught by the top-level boundary.
  • Decline path — explicit Decline button: on desktop (Tauri) it quits the app via getCurrentWindow().close(); on web it shows a blocking "you need to accept" notice with a way back to the gate.
  • Persistence — new stores/consent.ts (Zustand, same pattern as stores/gpg.ts): localStorage key f2p:legal_consent holding { version, acceptedAt }. A TERMS_VERSION constant gates validity — bump it when the legal docs change materially and everyone is re-prompted. Incognito tabs get a fresh storage partition, so the gate re-shows there with zero extra code. No cookie is used anywhere (there is no server to read one).
  • Error routes pass through — the gate lets #/error/* render even before consent, so a mid-session chunk-load 503, the Pages 404.html redirect, or an #/error/:code deep link still reaches the user instead of being swallowed.
  • Doc links — the gate's five binding documents (MIT License, EULA, Privacy Policy, Disclaimer, Terms of Use) open through the existing external-open.ts openExternal() helper, so they work inside the Tauri webview (which blocks window.open to external HTTPS) as well as on the web.
  • Shared legal list — the LEGAL_DOCS array (label / path / hint) was lifted out of About.tsx into a reusable lib/legal.ts (LEGAL_DOCS, CONSENT_DOCS, legalDocUrl()); About now imports it instead of holding a private copy.
  • New consent.* i18n keys added to both en.json and vi.json. Long-form legal copy stays English (the doc labels come from LEGAL_DOCS); only the gate chrome is bilingual.

🪟 Windows installer license page

  • tauri.conf.json now sets bundle.licenseFile to a new LICENSE_AGREEMENT.rtf. Tauri v2 surfaces this as a mandatory "I Agree" license page in both Windows targets built by targets: "all" — the NSIS -setup.exe (MUI license page) and the WiX .msi (which requires RTF). The RTF is plain ASCII with no BOM to avoid the known NSIS license-encoding bug.
  • The installer gate (install-time, desktop-only) and the in-app gate (first-run, web + desktop, re-promptable) are intentionally both kept: the auto-updater replaces the binary without re-running the installer, so the in-app TERMS_VERSION mechanism is the only way to re-prompt updated installs.
  • Desktop window-close on decline needs the core:window:allow-close permission, now added to capabilities/default.json. New dependency @tauri-apps/api (official, lazy-imported only on the desktop decline path — no web-bundle bloat).

🧰 Tooling & misc

  • Version bumped across the three desktop files (web/package.json, tauri.conf.json, Cargo.toml) → 1.4.0; the stale README version badge corrected 3.2.7 → 3.4.0.
  • Pre-publish suite (typecheck, knip, npm audit, vulture, pip-audit) re-run clean.

[v3.3.0] – 2026-06-12 (The "Lazy-Load + Error Pages" Edition)

Feature release on top of v3.2.7, two themes: a web-app performance overhaul (route-level code splitting, lazy echarts/openpgp/locale chunks — first-load JS drops from ~574 KB to ~163 KB gzipped, −72%) and a proper error-page system (403/404/419/5xx/offline pages, React error boundaries, a real GitHub Pages 404.html). Web app + desktop bumped 1.2.7 → 1.3.0. Repo public-facing version 3.2.7 → 3.3.0. Tag v3.3.0 is GPG-signed; companion desktop tag is desktop-v1.3.0.

⚡ Lazy-loading overhaul

  • Route splitting — web/src/App.tsx: every page except Dashboard (the landing route) is now React.lazy via a new lazyWithRetry helper (web/src/lib/lazy.ts). The <Suspense> boundary sits inside Layout.tsx around <Outlet/>, so the sidebar/topbar stay mounted during navigation; fallback reuses the existing LoadingState.
  • echarts (~666 KB raw) — new LazyEChart.tsx wrapper is the single dynamic boundary for EChart.tsx (which keeps the echarts.use([...]) registration). All 15 chart components swap one import line; a fixed-height animate-pulse skeleton prevents layout shift. echarts now downloads only when a chart mounts.
  • openpgp (~391 KB raw) — web/src/lib/gpg.ts switches to a type-only import + memoized await import("openpgp"). All exports were already async, so zero caller changes; visitors without a saved GPG key never download the crypto chunk at all.
  • Per-locale i18n — web/src/i18n/index.ts: en.json stays bundled (it's fallbackLng — a missing key can never render raw), vi.json becomes a dynamic import. initI18n() preloads the detected locale before i18n.init, and main.tsx awaits it before first render — no flash of raw keys, verified with a hard reload under f2p:lang=vi. setLanguage() is now async and loads the bundle before switching. Also syncs <html lang> (was hardcoded vi for everyone).
  • manualChunks fix — forcing echarts/openpgp into manualChunks made Rollup hoist shared helpers (tslib) into the echarts chunk, which the eager graph then statically imported — echarts was being modulepreloaded on first paint, nullifying the lazy boundary. Both entries are removed from vite.config.ts; the dynamic-import boundaries split them naturally. dist/index.html now modulepreloads only react + query.
  • Net effect: eager JS ~1746 KB → ~494 KB raw (~574 → ~163 KB gzip). The PWA still precaches everything in the background, but first paint no longer waits for charts + crypto.

🚦 Error pages (403 / 404 / 419 / 500 / 502 / 503 / 504 / offline)

  • New web/src/pages/errors/ErrorPage.tsx — one config-driven component: per-code lucide icon + tone (neutral/warn/destructive, reusing the exact ErrorState/PwaIndicator palettes), mono ERROR {{code}} badge, i18n'd title/description, and three actions (Go home / Reload / Report issue → GitHub Issues). Full errors.* key blocks added to both en.json and vi.json. Kept in the eager bundle on purpose — error UI must not live in a lazy chunk.
  • Routing — #/error/:code deep links via ErrorCodeRoute (unknown codes render 404 in place, no redirect), and the catch-all <Route path="*"> now shows a real 404 page instead of silently redirecting to the Dashboard.
  • GitHub Pages 404.html — new web/public/404.html: standalone dark page (inline CSS, no JS deps), bilingual via a one-liner that respects the app's own f2p:lang, noindex, absolute link back to /free-steam-games-list/#/. Excluded from the SW precache via globIgnores in vite.config.ts — SW-controlled clients get navigateFallback and never see it.

🛡️ Error boundaries + stale-deploy resilience

  • New ErrorBoundary.tsx (own ~40-line class, no new dep) with a resetKey prop — navigating away clears a stuck error without remounting the page subtree on every navigation (which key would do, destroying table scroll/selection state).
  • Two mounts: route-level inside Layout (chunk-load error → 503 page with "new version deployed, reload" copy; render crash → 500 page, error message shown in dev only), and a top-level AppErrorBoundary outside the router with inline styles + hardcoded bilingual strings — immune to i18n/Tailwind/router failures.
  • lazyWithRetry handles the deploy-mid-session case: a chunk 404 triggers ONE auto-reload per tab (sessionStorage flag, try/catch-guarded for lockdown webviews) which also picks up the waiting service worker; a second failure throws to the boundary.

🔌 Real error flows wired in

  • QueryState.tsx ErrorState upgraded in place (contract preserved): offline detection swaps in the errors.offline.* copy + WifiOff icon, plus Retry / Report-issue action buttons. All 17 call sites now pass onRetry={() => void q.refetch()}.
  • Expired/revoked token on session restore (stores/auth.ts hydrate() catch) now fires a Sonner toast with the shared errors.419.* copy and an "Open Settings" action (10 s duration — the 4 s default is too short for action toasts). Deliberately a toast, not a redirect: don't hijack whatever page the user opened. Auth gating on /add stays as-is.

🖼️ Images

  • decoding="async" added to every <img> (10 sites: table thumbs, mobile cards, command palette, detail drawer, avatars, About QRs) — keeps image decode off the main thread during virtualised scrolling.
  • Detail drawer header image now goes through a new preferWebp() (web/src/lib/image.ts): weserv WebP transcode (~50 KB → ~20 KB) on web, direct Steam URL on Tauri desktop (no third-party calls from the bundled app), with an onError fallback to the original. Replaces the old <picture><source> markup, which only falls back on unsupported type — a weserv outage would have shown a broken image. Thumbnails intentionally stay on direct Steam capsules (~10 KB, SW-cached); webpProxyUrl is no longer exported.

⌨️ Search responsiveness

  • GamesTable.tsx: the Fuse.js search input is wrapped in useDeferredValue — typing stays per-keystroke responsive while filtering ~1.2k records lags at React's low priority. No debounce timer (deferral only delays when the machine is actually busy). Same treatment + useMemo for the command palette's game scan.

🧰 Tooling & misc

  • rollup-plugin-visualizer devDependency + npm run analyze (vite build --mode analyze → dist/stats.html treemap, gzip/brotli sizes).
  • index.html: preconnect hints for raw.githubusercontent.com (shard fetches, crossorigin) and shared.akamai.steamstatic.com (thumbnails).
  • npm audit fix — react-router open-redirect advisory GHSA-2j2x-hqr9-3h42 (react-router-dom 6.30.x patch line); npm audit and pip-audit both report 0 known vulnerabilities.

[v3.2.7] – 2026-05-22 (The "Coming-Soon Guard + Dead-Code Cleanup" Edition)

Maintenance release on top of v3.2.6. A small, useful batch: the Python pipeline now rejects unreleased ("coming soon") games at ingest instead of listing titles nobody can play yet; a one-time dead-code sweep across the web app and the pipeline; and three dev-tooling additions (knip, vulture, pip-audit) so future releases can run the same checks. Web app + desktop bumped 1.2.6 → 1.2.7. Repo public-facing version 3.2.6 → 3.2.7. Tag v3.2.7 is GPG-signed; companion desktop tag is desktop-v1.2.7.

🚧 Coming-soon games rejected at ingest

  • scripts/core/health_checker.py — new COMING_SOON status, added to the REMOVABLE set. check_game_health() now reads the Steam appdetails flag release_date.coming_soon right after the API response resolves (before the is_free check) and returns HealthResult(COMING_SOON, …) for unreleased titles.
  • Effect: ingest_new.py rejects coming-soon entries from the queue and logs them to removed_games.jsonl with reason "Not yet released (coming soon)" — the same path NOT_FREE already uses. purge_unhealthy.py's weekly scan likewise evicts any coming-soon title already in the dataset.
  • Rationale: an F2P games tracker should list playable titles. A coming-soon game has zero players, no reviews, and an unconfirmed price (it can launch paid). The API flag is used instead of scraping the game_area_comingsoon HTML block — it's already fetched during the health check and is authoritative. No schema change.

🧹 Web dead-code cleanup (knip)

  • New knip sweep (config in web/knip.json). Removed two unused files: src/components/common/UpdateChecker.tsx — the Tauri auto-update component, never wired into Layout.tsx since Phase 9, so the frontend update check never actually ran — and src/components/ui/switch.tsx, an unused shadcn primitive.
  • Removed 11 unused dependencies from web/package.json: 7 Radix primitives (react-dropdown-menu, react-scroll-area, react-select, react-switch, react-tabs, react-toast, react-tooltip), @tanstack/react-table (the virtualised table uses only @tanstack/react-virtual), and 3 Tauri packages (@tauri-apps/api, @tauri-apps/plugin-process, @tauri-apps/plugin-updater — the last two were referenced only by the removed UpdateChecker).
  • vite.config.ts — dropped the now-stale @tanstack/react-table entry from the manualChunks.table group.
  • knip's remaining "unused export" findings inside the src/lib/* port modules are intentional API surface; they're set to warn so npm run knip stays green.

🧹 Python dead-code cleanup (vulture)

  • Deleted scripts/dedup_removed_games.py — the one-shot v3.2.4 migration, completed and now redundant (dedup_removed() runs inside the pipeline on every write). Same rationale as v3.2.4's removal of migrate_to_shards.py.
  • scripts/core/data_store.py — dropped the unused EXTENSION_FIELDS import. The constant stays defined in constants.py as the documented MANUAL/ARRAY/EXTENSION field-class trio (mirrored in web/src/lib/schema.ts).
  • scripts/core/steam_client.py — __exit__(self, *a) → __exit__(self, *_) (idiomatic unused-varargs name).

🧰 Dead-code & audit tooling

  • knip — web/package.json devDependency + npm run knip script + web/knip.json. Finds unused files / exports / dependencies in the TypeScript SPA.
  • vulture + pip-audit — new requirements-dev.txt; vulture config in a new root pyproject.toml ([tool.vulture], min_confidence = 80). Python dead-code detection + dependency CVE audit.
  • All three run at dev time only — nothing new ships in the pipeline, web bundle, or desktop app.

📄 Docs

  • New docs/THIRD_PARTY.md — documents the dev tooling above (purpose, license, where declared) and the canonical pre-publish check suite. Linked from the README "Docs" section.
  • Synced the third-party dependency lists to the removals above — docs/ACKNOWLEDGEMENTs.md, the in-app /about page (web/src/pages/About.tsx), and web/README.md no longer list the dropped Radix primitives, @tanstack/react-table, or @tauri-apps/api.

[v3.2.6] – 2026-05-20 (The "Mobile Hotfix" Edition)

Hotfix on top of v3.2.5. Two mobile-viewport regressions introduced by the v3.2.5 responsive overhaul. Web app + desktop bumped 1.2.5 → 1.2.6. Repo public-facing version 3.2.5 → 3.2.6. Tag v3.2.6 is GPG-signed; companion desktop tag is desktop-v1.2.6.

🐛 AC Index table — horizontal scroll on mobile

  • web/src/pages/AntiCheatList.tsx — the per-family table wrapper was <div className="overflow-hidden rounded-md border">. On a 390 px viewport the 5-column table (# / Game / Genre / Kernel / Players) is wider than the card, and overflow-hidden clipped the right-hand columns with no way to scroll to them.
  • Fix: overflow-hidden → overflow-x-auto. The table now scrolls horizontally when it exceeds the viewport, and the scrollbar stays hidden when it fits.

🖼️ Mobile game cards — thumbnail fallback

  • web/src/components/games/table/MobileGameCards.tsx — the card <img> loads headerToCapsule(g.header_image) (the smaller capsule_184x69.jpg variant, ~10 KB vs ~50 KB). Steam's CDN doesn't host that variant for every game, so those cards rendered a blank thumbnail.
  • The desktop table column (table/columns.tsx) already had an onError handler that falls back to the original header.jpg; the v3.2.5 mobile card component didn't port it. GameDetailDrawer uses g.header_image directly, which is why the image always appeared once a card was tapped.
  • Fix: add the same onError fallback to the mobile card <img> — on a 404 it swaps src to g.header_image, with an el.src !== g.header_image guard against an infinite error loop.

[v3.2.5] – 2026-05-20 (The "AC Nav + Mobile + Games Cleanup" Edition)

Patch release on top of v3.2.4. One reported bug fix + three quality-of-life polish items. Bug: clicking any "Family" link in the Anti-Cheat Index sidebar redirected to the Dashboard instead of scrolling to the matching family table — HashRouter was treating the <a href="#vac"> anchor as a route navigation. Polish: the GamesTable (1318 px wide) now degrades to a virtualised card list below the md breakpoint so mobile no longer needs horizontal scroll; the AntiCheatList sidebar drops to md instead of lg and exposes a horizontal chip nav on phones; KpiCards adds md/lg rungs to avoid uneven grid jumps. Cleanup: 93 per-genre markdown files in games/ are removed (the web app's /games?genre=X filter has replaced them since v3.0); generate_tables.py now skips regeneration when game data hasn't actually changed via a .gen-hash checksum, cutting daily catalogue commits to roughly the days that move records. New: floating back-to-top button on the main scroll container, fades in past 400 px. Web app + desktop bumped 1.2.4 → 1.2.5. Repo public-facing version 3.2.4 → 3.2.5. Tag v3.2.5 is GPG-signed; companion desktop tag is desktop-v1.2.5.

🔗 AC Index sidebar navigation fix

  • web/src/pages/AntiCheatList.tsx: swap <a href="#anchor"> for <button onClick> that calls document.getElementById(id).scrollIntoView({ behavior: "smooth", block: "start" }). The id={anchor} attribute on each family <Card> stays the same — only the click target changes.
  • Root cause: main.tsx:24 uses HashRouter. Anchor links inside a hash-routed page produce URLs like #/charts/anti-cheat/list#vac. HashRouter parses the trailing #vac as a fresh route, the regex doesn't match, and the <Route path="*" element={<Navigate to="/" replace />}> fallback in App.tsx sends the user to the Dashboard.
  • Same fix applied to the new mobile chip nav (below) so behaviour is uniform across viewports.

📱 Mobile responsive

  • New web/src/components/games/table/MobileGameCards.tsx — virtualised card list rendering one card per game with thumb, name, genre/type/AC/status badges, review %, current players, and a Steam-link icon. Shares filter/sort/page state with the desktop table via the existing useFilters store.
  • GamesTable.tsx wraps the desktop scroll container in hidden md:block and renders <MobileGameCards> inside md:hidden. No new state, no behaviour drift between views.
  • AntiCheatList.tsx sidebar changes from hidden w-48 shrink-0 lg:block to hidden md:block md:w-40 lg:w-48 — visible on tablets too. Below md, a horizontal scrollable chip rail above the content provides the same family-jump nav.
  • KpiCards.tsx grid sm:grid-cols-2 lg:grid-cols-3 xl:grid-cols-7 → sm:grid-cols-2 md:grid-cols-3 lg:grid-cols-4 xl:grid-cols-7. Inserts md (tablet, 3 cols) and lg (small laptop, 4 cols) rungs so the 7 KPIs don't double-stack awkwardly.

🧹 games/ cleanup + smart regen

  • Deleted 93 per-genre <genre>.md files (action.md, fps.md, visual-novel.md, …). Web app /games?genre=X is the canonical genre filter since v3.0; no inbound link audit hit anything beyond games/README.md (regenerated) and the now-stale "By Genre" section in the index. Files kept: 11 × all-games_part*.md, top-online.md, top-offline.md, anti-cheat-list.md, README.md.
  • scripts/generate_tables.py drops the genre loop entirely and rewrites the games/README.md template to point at part files + leaderboards + AC list, with a one-line note about the web-app genre filter.
  • Smart regen via .gen-hash — script computes sha256 of sorted (link, name, genre, reviews, current_players, anti_cheat, is_kernel_ac, status) tuples and writes the digest to games/.gen-hash. Subsequent runs short-circuit (Skip: no semantic changes (hash=...)) when the hash is unchanged. Order-invariant, ignores timestamps embedded in MD output, so daily workflow ticks only commit when game data actually moves.

⬆️ Back-to-top button

  • New web/src/components/common/BackToTop.tsx — a fixed-position icon button bottom-right of the viewport. Listens for scroll events on the passed scroll container ref (passive listener), fades in (opacity-100) past 400 px, becomes pointer-events-none below to avoid blocking click-through.
  • Layout.tsx creates a useRef<HTMLElement> on <main>, passes it as scrollRef. Single mount, no per-page wiring.
  • i18n: common.backToTop added to en.json ("Back to top") and vi.json ("Lên đầu trang") for aria-label + title.

[v3.2.4] – 2026-05-20 (The "Refactor + Removed-Games + Anti-Cheat Index" Edition)

Patch release on top of v3.2.3, landed as two PRs. PR #74 (cleanup): two dead scripts removed, EditGameDrawer.tsx (718 LOC) and GamesTable.tsx (568 LOC) split into focused sub-modules, two new charts (TopOfflineBar, AddedPerMonthBar) wired to a fresh /top-offline page and the existing /charts/time page. PR #75 (features): the scripts/removed_games.jsonl log now passes through a dedup_removed() filter on every write (a one-time migration trimmed 6 historical duplicates), Top Online leaderboard expanded 50 → 100 to match Top Offline, a generated games/anti-cheat-list.md plus a /charts/anti-cheat/list web page group active games by anti-cheat family, and a new /charts/delisted page renders a timeline + reason breakdown of every removed-from-catalogue title. Web app + desktop bumped 1.2.3 → 1.2.4. Repo public-facing version 3.2.3 → 3.2.4. Tag v3.2.4 is GPG-signed; companion desktop tag is desktop-v1.2.4.

🧹 Dead-script removal

  • scripts/discord_notify.py deleted — superseded by the poli0981/.github reusable workflow; no .github/workflows/*.yml or bash/*.sh referenced it.
  • scripts/migrate_to_shards.py deleted — one-shot v2.2 migration tool, completed and unreferenced. The 10-script "unreferenced in workflows" audit confirmed the other eight (check_dead_links, delete_game, normalize_genres, purge_unhealthy, top_offline, top_online, update_data, update_reviews) all have live bash/*.sh wrappers and stay.

🪓 Component splits

  • web/src/components/games/EditGameDrawer.tsx (718 LOC) → 7 focused files under edit/:
    • EditGameDrawer.tsx keeps the save handler, dialog shell, view-toggle wiring.
    • EditFormFields.tsx, EditJsonView.tsx (with JsonDiff), EditChangePreview.tsx, ViewToggle.tsx extract the four UI regions.
    • form-utils.ts exports gameToForm + formToPatch; types.ts re-exports the FormState + View types.
  • web/src/components/games/GamesTable.tsx (568 LOC) → container + 5 files under table/:
    • GamesTable.tsx keeps the virtualizer (useVirtualizer ownership at container level so row-height stays single-source), filters, fuzzy search, sort, and paging.
    • columns.tsx extracts the COLS: ColDef[] array (12 columns) + TOTAL_WIDTH + SELECT_COL_WIDTH constants.
    • TableHeader.tsx, TableRow.tsx (memoised with React.memo), TableToolbar.tsx, ExportMenu.tsx extract the visual regions.
  • No behaviour change — same virtual scrolling, same sort/filter wiring, same selection store.

📊 New charts

  • web/src/components/charts/TopOfflineBar.tsx — mirror of TopOnlineBar but with offline-tier thresholds (20k/1.5k/300) calibrated to the top_offline.py scale instead of the online-only 100k/10k/1k palette. Filters type_game !== "online" && status === "active", top 100 by current_players.
  • web/src/pages/TopOffline.tsx — new page at /top-offline, layout mirror of TopOnlinePage, registered in App.tsx and Sidebar.tsx (Trophy icon).
  • web/src/components/charts/AddedPerMonthBar.tsx — aggregates records[*].added_at into YYYY-MM buckets, renders an ECharts bar. Added as a third card to the existing charts/Time.tsx page alongside ReleaseYearHistogram + AddedCumulativeLine.

🗑️ Removed-games dedup

  • scripts/core/data_store.py — new dedup_removed(records) keeps the latest entry per appid (compared by removed_at ISO timestamp, lexicographic order matches chronological for YYYY-MM-DDTHH:MM:SSZ). Records without a resolvable appid are dropped.
  • scripts/purge_unhealthy.py:41-43 and scripts/ingest_new.py:106-108 — both call sites now write dedup_removed(existing + log) instead of existing.extend(log). Same save_jsonl atomic-rename transaction, so partial writes can't leave duplicates.
  • scripts/dedup_removed_games.py (new) — one-shot CLI that loads, dedups, and rewrites the file. Run once locally as part of this release; idempotent, safe to re-run.
  • Result: existing log trimmed 43 → 37 records. Verified zero duplicate appids post-migration.

🏆 Top Online expanded 50 → 100

  • scripts/core/constants.py:81 — TOP_ONLINE_LIMIT = 100 (was 50). Top Offline already 100.
  • games/top-online.md regenerated with 100 rows on next workflow tick; format unchanged (10-column table preserved).
  • web/src/pages/TopOnline.tsx — <TopOnlineBar limit={100} height={1800}> to match the new row count.
  • i18n strings topOnline.{subtitle,cardTitle} updated Top 50 → Top 100 in both en.json and vi.json.

🛡️ Anti-cheat list

  • scripts/generate_anti_cheat_list.py (new) — buckets active games by canonical AC name (ANTI_CHEAT_PATTERNS keys), with substring-match fallback for free-text values. Unrecognised values land in an Other bucket with a stderr warning. Output games/anti-cheat-list.md: H1 + TOC + per-family H2 sections, each a 6-column table sorted by current_players desc.
  • bash/anti_cheat.sh + .github/workflows/anti-cheat-list.yml (new) — weekly Sunday 06:00 UTC cron + manual dispatch. Uses the same data-write concurrency group as the other table-generation workflows.
  • web/src/pages/AntiCheatList.tsx (new) — /charts/anti-cheat/list page mirrors the MD: collapsible per-family sections + sticky AC-name sidebar nav. Uses existing useGames hook; canonicalises client-side via a TS port of the Python patterns table. i18n keys antiCheatList.* added to en + vi.

📉 Delisted charts

  • web/src/hooks/useRemovedGames.ts (new) — fetches scripts/removed_games.jsonl from raw.githubusercontent.com, parses lines, deduplicates client-side (same logic as the Python dedup). TanStack Query with 5-minute staleTime.
  • web/src/components/charts/DelistedTimeline.tsx (new) — ECharts stacked bar, x = YYYY-MM of removed_at, stacked by status_code (not_free / unavailable / fallback other).
  • web/src/components/charts/DelistedReasonBreakdown.tsx (new) — ECharts donut by status_code.
  • web/src/pages/charts/Delisted.tsx (new) — /charts/delisted page renders both charts. Sidebar nav link with WifiOff icon.
  • web/src/components/charts/KpiCards.tsx — new optional removedCount prop; when set, renders a 7th "Removed (all-time)" KPI alongside the existing in-catalog "Delisted" badge. Wired from Dashboard.tsx via useRemovedGames().data?.length. Grid bumps from xl:grid-cols-6 to xl:grid-cols-7.

📝 Docs

  • README: removed the duplicate "Quick Links" section (the comprehensive 11-row "Quick links" table at the top covers everything the 4-row duplicate listed).
  • README: added 🎯 Top offline (md) row to the main Quick links table.
  • README: version badge bumped 3.2.3 → 3.2.4.
  • i18n: combined nav.{topOffline,antiCheatList,delisted}, topOffline.*, antiCheatList.*, charts.{time.addedPerMonth,delisted.*} keys added to en.json + vi.json.

[v3.2.3] – 2026-05-17 (The "View Commit Toast + Offline AC Lock" Edition)

Patch release on top of v3.2.2. Three user-reported fixes: the "View commit" action button in success toasts (now reachable + cross-platform), an editor lock that prevents anti-cheat fields from being set on offline games, and a broken Mark dead games workflow setup-python step. Web app + desktop bumped 1.2.2 → 1.2.3. Repo public-facing version 3.2.2 → 3.2.3. Tag v3.2.3 is GPG-signed; companion desktop tag is desktop-v1.2.3.

🍞 View commit toast — clickable + desktop-safe

  • Migrated the eight window.open(commit.htmlUrl, "_blank") action handlers in EditGameDrawer.tsx (2), Add.tsx (2 inside reportToast), BulkEditDrawer.tsx (2), and BulkActionBar.tsx (2) to openExternal() from web/src/lib/external-open.ts — completes the follow-up migration flagged in v3.2.2's CHANGELOG. The Tauri webview was silently blocking the raw window.open(...) for external HTTPS URLs, so "View commit" did nothing on desktop.
  • Each toast.success(...) with a "View commit" action now sets duration: 15000 (was Sonner's 4 s default). On web the old toasts auto-dismissed before the user could read the description + click the action button.
  • Handler now accepts the click event and calls event.preventDefault() so the toast stays visible after click (Sonner's default is to dismiss on action click — undesirable when the user wants to glance at the SHA after opening the commit).
  • The fix applies to both the initial toast.success and the follow-up emit fired by pollCommitVerification(...).then(...) (same toast id, so duration must be set on the update too — otherwise the second emit rebounds to the 4 s default).

🔒 Anti-cheat fields lock on offline games

  • web/src/components/games/EditGameDrawer.tsx — FormFields derives lockAC = form.type_game === "offline" and threads disabled={lockAC} to the AC <select>, the custom-AC <Input>, the three kernel <Button>s, and the AC note <Textarea>. A muted hint is rendered under the AC note when locked, explaining how to re-enable.
  • update() setter now auto-resets anti_cheat="", anti_cheat_note="", is_kernel_ac="unknown" when key === "type_game" && value === "offline". This keeps the formToPatch() diff honest — switching an online game with AC populated to offline now produces an explicit AC-clear in the commit instead of orphan anti-cheat data on an offline record.
  • web/src/pages/Add.tsx — same pattern in OverrideFields + the SingleAdd.setOv() setter. OverrideFields combines the existing busy-state disabled prop with the new lock via acDisabled = disabled || lockAC, so the global "form is submitting" disable still wins. BulkAdd uses raw text / JSON input, so no UI lock needed there.
  • type_game === "" (unknown) deliberately does not lock — only an explicit "offline" triggers the gate. The existing validation.ts "kernel?" badge rule for online + missing-kernel is untouched.
  • New i18n key edit.acLockedOffline added to web/src/i18n/locales/en.json and vi.json, rendered as a text-xs text-muted-foreground hint under the AC note when lockAC is true.

🪦 Mark dead games workflow path fix

  • .github/workflows/mark-dead-games.yml — cache-dependency-path: scripts/requirements.txt and the subsequent pip install -r scripts/requirements.txt both pointed at a path that doesn't exist. The file lives at the repo root (requirements.txt), consistent with the path codeql.yml:25 already uses.
  • Fix: both lines now reference requirements.txt at the root. The setup-python cache lookup no longer errors with No file in /home/runner/work/free-steam-games-list/free-steam-games-list matched to [scripts/requirements.txt or **/pyproject.toml], and the install step actually finds the deps.
  • Workflow is scheduled Mon + Thu 04:30 UTC; the next scheduled run will be the first end-to-end verification, but workflow_dispatch with dry_run=true is also available for ad-hoc validation.

[v3.2.2] – 2026-05-11 (The "Bug Fix Quartet" Edition)

Patch release on top of v3.2.1. Four user-reported bug fixes touching the Ctrl+K command palette on desktop, the Health → Games navigation flow, Tauri process-stacking on every launch, and the type_game scraper that was defaulting every new game to "offline". Web app + desktop bumped 1.2.1 → 1.2.2. Repo public-facing version 3.2.1 → 3.2.2. Tag v3.2.2 is GPG-signed; companion desktop tag is desktop-v1.2.2.

  • New web/src/lib/external-open.ts — lazy-detects the Tauri runtime via __TAURI_INTERNALS__, opens external URLs through @tauri-apps/plugin-shell on desktop (capability shell:allow-open already granted in web/src-tauri/capabilities/default.json), falls back to window.open(url, "_blank", "noopener,noreferrer") on web/PWA. Plugin module is lazy-imported, so the web bundle never pays for the Tauri code path.
  • web/src/components/common/CommandPalette.tsx — Ctrl+K game results now route through openExternal(). The Tauri webview was silently blocking the raw window.open(r.link, "_blank") for external HTTPS URLs, so clicking a search result on desktop did nothing.
  • Six other window.open(...) call sites (Health workflow link, Add, BulkActionBar, BulkEditDrawer, EditGameDrawer, DeviceFlowPanel) are flagged for follow-up migration to openExternal() — same desktop silent-fail will hit them when triggered.

🩺 Health → Games filter restoration

  • web/src/pages/Games.tsx — adds useSearchParams + a useEffect that mirrors the URL ?search= parameter into useFilters.search on mount. The Health page already linked rows to #/games?search=<name>, but Games never read the param, so the table stayed unfiltered and the Topbar input stayed empty. The store binding to Topbar means visual feedback is automatic once the filter is set.
  • Guard if (term !== null) (instead of if (term)) lets ?search= explicitly clear the filter — useful for shareable "no filter" links.

🪟 Tauri single-instance enforcement

  • web/src-tauri/Cargo.toml — adds tauri-plugin-single-instance = "2" under the existing desktop-only cfg(not(any(target_os = "android", target_os = "ios"))) block, matching the updater plugin's gating pattern.
  • web/src-tauri/src/lib.rs — registers single-instance as the first plugin so it short-circuits duplicate launches before any other state initialises. The dup-launch callback calls unminimize() + show() + set_focus() on the existing main window. Without this, every Start-menu / shortcut / file-association invocation spawned a fresh f2p-tracker.exe that lingered in Task Manager.
  • No capability changes needed — plugin runs entirely Rust-side, no frontend command exposed.

🎮 type_game online inference

  • scripts/core/fetcher.py — new _infer_type_game(categories) reads data.get("categories", []) and returns "online" when any description contains online, mmo, massively multiplayer, cross-platform multiplayer, or multi-player. Pure shared/split screen descriptions are treated as local-only and skipped unless paired with another online signal.
  • Wired into apply_details() next to the existing anti-cheat category loop, guarded by is_empty(game.get("type_game")) so manual prefills in temp_info.jsonl remain authoritative — the MANUAL_FIELDS merge in data_store.merge_extension_data() and the override re-apply in ingest_new.py are unchanged.
  • The legacy default-to-"offline" at the end of fetch_full() stays as the final safety net for games with no multiplayer signal in Steam categories. New ingests of online F2P games now classify correctly instead of all-offline.

[v3.2.1] – 2026-05-11 (The "Genre Cleanup" Edition)

Patch release on top of v3.2.0. Normalizes inconsistent genre values across the dataset (31 records, 10 canonical mappings) and broadens the webapp's genre combobox with 14 additional suggestions. Web app + desktop bumped 1.2.0 → 1.2.1. Repo public-facing version 3.2.0 → 3.2.1. Tag v3.2.1 is GPG-signed; companion desktop tag is desktop-v1.2.1.

🧹 Genre normalization script

  • New scripts/normalize_genres.py — local one-shot tool with --apply flag (dry-run by default). Reuses core.data_store.load_main / save_main so writes are atomic + sharded.
  • Canonical mappings applied (sentence-case style for compounds): Hack and Slash → Hack & Slash (4), Third-Person Shooter → Third-person Shooter (7), Top-Down Shooter → Top-down Shooter (3), Turn-Based Strategy → Turn-based Strategy (3), Turn-Based Tactics → Turn-based Tactics (4), Turn-Based Combat → Turn-based Combat (2), Shoot 'Em Up / Shoot'em up → Shoot 'em up (5), Point-and-Click → Point & Click (1), Rougelite → Roguelite (2 typo).
  • 31 records updated · 10 unique canonical changes · unique-genre count 100 → 92.
  • Idempotent — second run reports "data already canonical".
  • Comma-separated values like "Action RPG, Gacha" (Wuthering Waves, Honkai Impact 3rd) are flagged in a "Manual review needed" section rather than auto-split, since the schema is single-genre.
  • All games/*.md regenerated via scripts/generate_tables.py; affected genre files include the new sentence-case slugs (turn-based-strategy.md, top-down-shooter.md, third-person-shooter.md, roguelite.md, etc.).

🎛 Webapp genre dropdown additions

  • web/src/lib/enums.ts — GENRE_ENUM extended from 44 → 58 entries. Added 14 sub-genres already common in the data: Action RPG, Beat 'em up, Bullet Hell, Clicker, Hidden Object, Real-Time Strategy, Roguelite, Survival Horror, Tactical RPG, Third-person Shooter, Top-down Shooter, Turn-based RPG, Turn-based Strategy, Turn-based Tactics.
  • Sentence-case style matches the normalized data values.
  • Dropdown filter on web/src/pages/Games.tsx is facet-driven (auto-updates from the records), so it now shows the deduplicated canonical names. The EditGameDrawer combobox suggests the 14 new entries while still accepting free-text input.

[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) and web/public/sitemap.xml (5 entries: site root, GitHub repo, all-games / top-online / changelog markdown).
  • New hook web/src/hooks/useDocumentTitle.ts — sets document.title to <page> · Steam F2P Tracker and 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.webmanifest from vite.config.ts; no manual manifest needed.

💬 Auto-create GitHub Discussion on release

  • New .github/workflows/announce-release-discussion.yml — fires on release: published (plus workflow_dispatch with a tag input for re-runs).
  • Implemented via actions/github-script@v8 + GraphQL createDiscussion (REST has no equivalent).
  • Resolves the discussion category by slug — defaults to Announcements, falls back to General with 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-running workflow_dispatch is therefore a no-op.
  • Permissions: contents: read, discussions: write — both granted by GITHUB_TOKEN defaults once Discussions is enabled on the repo.

💖 Donate page

  • New web/src/pages/Donate.tsx route 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.tsx SECONDARY group (between About and Settings); Heart icon 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 mirroring E:\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 exact apt-get line), 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 external telegram-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 fifth IssueGroup: OnlineAcUnknown for games with type_game === "online" and anti_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().
  • ShieldQuestion icon (lucide). EN + VI i18n keys: health.groupOnlineAcUnknown + …Desc.
  • New helper web/src/lib/steam-link.ts — steamProtocolUrl(appid) returns steam://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 the top_online.py shape but filters _is_offline(g) (non-empty type_game ≠ "online"). Emits games/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.sh matches the shape of bash/online.sh (pip install requests → run script → conditional commit).
  • New .github/workflows/top-offline.yml — cron 0 5 1,15 * * (1st + 15th of each month at 05:00 UTC) plus workflow_dispatch. Shares the unified data-write concurrency 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 hardcoded type_game == "online" filter that would have made the offline workflow refresh zero rows. Extended with a type_filter kwarg ("online" default for backward compat, "offline", or "all"); top_offline.py passes type_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

[v3.1.0] – 2026-05-09 (The "Less CI Noise, Lighter Images, Dead-Game Detection" Edition)

Four PRs landed in this release plus a refresh of the docs and the contributor surface around the new Telegram bot. Web app + desktop app bumped from 1.0.0 → 1.1.0. Repo public-facing version 3.0.1 → 3.1.0. Tag v3.1.0 is GPG-signed; companion desktop tag is desktop-v1.1.0.

🛠️ CI hygiene — notify wrappers (#60)

  • The 3 notify wrappers (notify-ci-failure, notify-deploy, notify-release-pipeline) used to trigger on workflow_run: workflows: ["*"] and were filtered out by their reusable callee's if: — 95–100 % of runs showed as "skipped". Replaced the catch-all with explicit lists of source workflow name: strings per wrapper, plus job-level if: to short-circuit non-matching conclusions. Drops skip rate to <10 %.
  • Trade-off documented in each file: renaming a source workflow's name: field silently breaks notifications; comment warns about the coupling.

🖼️ Image optimisation — capsule swap + WebP via wsrv.nl (#61)

  • scripts/generate_tables.py:68 — markdown thumbnails now use capsule_184x69.jpg instead of header.jpg (~80 % bandwidth reduction at the same 120 px render width).
  • Web app GamesTable + CommandPalette — capsule swap with explicit width/height to eliminate CLS, plus onError fallback to header.jpg for the ~5 % of games without a capsule variant.
  • GameDetailDrawer — <picture> element with WebP source via images.weserv.nl proxy + JPEG fallback. Lazy-loaded, explicit dimensions.
  • vite.config.ts — new CacheFirst runtime cache for images.weserv.nl (statuses: [200] only — opaque 0-status would cache proxy errors).
  • New helper web/src/lib/image.ts — headerToCapsule() + webpProxyUrl().

💀 Dead-game detection — mark-dead-games.yml (#62)

  • New cron Mon + Thu 04:30 UTC flags online games released >1 year ago whose current_players == 0 for ≥14 days (configurable via DEAD_GAME_DAYS env or --days CLI). On trigger: is_dead = true + "💀 Dead game" appended to notes (idempotent).
  • State model: ISO timestamp zero_player_since (robust against schedule drift), not a streak counter.
  • Mark mechanism: additive is_dead: bool + note. status stays "active" so the existing enum / Top Online filter / chart groupings don't break. Web app gains a "Hide dead" filter toggle and a 💀 emoji prefix on dead rows.
  • Dry-run available: python scripts/mark_dead_games.py --dry-run --days 0 for auditing without writes.
  • New helper append_note_idempotent() in scripts/core/data_store.py. Retrofitted onto check_dead_links.py to fix duplicate "💀 Delisted" accumulation on reruns.
  • Schema migration via _SKELETON_TEMPLATE only (no one-shot script). Both the Python pipeline and the React app inherit defaults via existing migrate_record() / migrateRecord() loops.

🔄 Concurrency unification

All data-mutating workflows now share concurrency: { group: data-write, cancel-in-progress: false }:

  • update-json, update-daily, top-online, update-reviews
  • check-dead-links, purge-unhealthy, mark-dead-games (new)
  • ingest-new, ingest-from-issue, bot-ingest, refetch-all

Prevents races on git push to data/ shards. Bot-ingest moved from its own bot-ingest group to the unified group.

📝 Docs + contributor surface (this PR)

  • AUTHORS.md at repo root — handle map for the maintainer, AI-assistant disclosure, MIT licensing reminder.
  • username.txt extended with telegram bot, telegram user, and email lines (canonical machine-readable handle map mirrored by AUTHORS.md).
  • assets/qr/ — QR-code PNGs for @my_skull_bot and @SkullMute0011 (mirrored to web/public/qr/ so the SPA can serve them). Generated via python -m qrcode.
  • web/src/pages/About.tsx — Maintainer card now lists Telegram bot + Telegram DM (with QR thumbnails inline) + Email. New "Telegram QR codes" card with full-size scannable codes. Privacy note about Telegram user_id handling.
  • CONTRIBUTING.md rewrite — adds the @my_skull_bot flow as a first-class contribution path (find user_id → DM maintainer privately → whitelist → run when bot's online → follow prompts). Loud privacy warning at the top.
  • docs/PRIVACY_POLICY.md — new "Telegram bot" section covering the user_id data flow, where it's stored, retention/removal, and the maintainer's commitment.
  • docs/ToS.md — new section 5.1 "Sharing personal information when contributing" with non-negotiable rules about private vs public channels.
  • docs/Contact.md — Telegram bot + DM entries added at the top.
  • README badges and feature list refreshed (version bumped, dead-game workflow listed, About-page QR card mentioned).

🔢 Versioning

Surface Old New
Repo public-facing 3.0.1 3.1.0
web/package.json 1.0.0 1.1.0
web/src-tauri/Cargo.toml 1.0.0 1.1.0
web/src-tauri/tauri.conf.json 1.0.0 1.1.0
Git tag (signed) v3.0.1 v3.1.0
Desktop tag (signed) desktop-v1.0.0 desktop-v1.1.0

[v3.0.1] – 2026-05-07 (The "Desktop Actually Ships This Time" Edition)

Same-day post-v3.0.0 maintenance covering Phase 9 (auto-update foundations + CVE bumps + Device Flow scaffold), Phase 10 (Tauri build break + i18n full coverage + deps audit), and Phase 10.1 (minisign keypair rotation). The desktop release pipeline is now end-to-end green — desktop-v1.0.0 finally produces signed .msi / .exe / .dmg / .AppImage / .deb / .rpm artefacts with a valid latest.json for auto-update.

🖥️ Phase 9 — auto-update foundations (#56)

  • tauri-plugin-updater wired into web/src-tauri/. Endpoint pinned to the Releases page so installed clients fetch latest.json on launch.
  • Updater pubkey embedded in tauri.conf.json (gated behind a no-op for mobile builds via #[cfg(not(any(target_os="android", target_os="ios")))]).
  • GitHub Device Flow scaffold added to Settings: signed-in users no longer have to paste a long-lived PAT — they kick off https://github.com/login/device, type the user_code, and the app polls until token issuance. Falls back to PAT for the offline path.
  • Dependency CVE bumps (vite 5 → 7, vite-plugin-pwa 0.20 → 1.x). Path-traversal fix in source-map handling. No source changes required for the bumps.
  • More i18n: a chunk of edit-drawer / activity / dashboard chrome got proper translation keys.

🛠️ Phase 10 — Tauri build break + full i18n + deps audit (#57)

  • Tauri lib-name regression fixed. Phase 9's auto-updater work introduced a f2p_tracker_lib::run() call in main.rs without declaring [lib] in Cargo.toml. Cargo's implicit lib name is f2p_tracker (hyphens → underscores from the package name) so the call failed to resolve and cargo build blew up. Added the explicit Tauri-2-template-style block:
    [lib]
    name = "f2p_tracker_lib"
    crate-type = ["staticlib", "cdylib", "rlib"]
    
    The triple crate-type keeps the door open for future tauri ios init / tauri android init work that lib.rs's #[cfg_attr(mobile, tauri::mobile_entry_point)] already implies.
  • i18n now reaches every chrome surface (~150 new keys across new namespaces charts, activity, add, system, cmdk, about, bulk, detail, diff, dialogs, health). All 9 chart pages, Activity, Add, Health, Top Online, About headings, drawers (Edit / BulkEdit / Diff / GameDetail), PwaIndicator, QueryState, GpgQuickUnlock, Topbar tooltips/aria-labels, Settings rate-limit panel, BulkActionBar confirm dialog, GamesTable tooltips, and CommandPalette resolve through useTranslation. Long-form About prose stays English per the settings.languageHint policy. Enum values (anti-cheat / genre / type_game / safe) stay dataset-stable.
  • Third-party deps audit. Walked web/package.json against About → Stack & third-party and docs/ACKNOWLEDGEMENTs.md. Added missing entries: react-router-dom, the i18next stack (i18next + react-i18next + i18next-browser-languagedetector), Tauri 2 + plugins (shell / updater / process), echarts-for-react, the styling utilities (class-variance-authority / clsx / tailwind-merge / tailwindcss-animate), and PostCSS + autoprefixer. Vite version corrected 5 → 7 (was already bumped by Phase 9; About just hadn't caught up).
  • ACKNOWLEDGEMENTs.md restructured into grouped sections (runtime/build, styling, UI primitives, routing & i18n, data & state, charts, crypto & PWA, desktop) with deep links + SPDX licences.
  • web/src-tauri/Cargo.lock now committed for reproducible desktop builds.

🔑 Phase 10.1 — minisign keypair rotation (#58)

  • desktop-v1.0.0 was failing at the final sign-updater-bundle step:
    failed to decode secret key: incorrect updater private key password:
                                  Missing comment in secret key
    
    minisign formats the error so the inner "Missing comment" is the symptom of a wrong password — when the password is wrong, decryption returns garbage and the expected untrusted comment: minisign encrypted secret key header bytes don't appear. The original keypair's password was lost, so the GH secret could no longer decrypt the key.
  • Re-keyed via npx tauri signer generate --ci -p "" with no password. Stored at ~/.tauri/f2p-tracker{,.pub} on the maintainer's box; web/src-tauri/.gitignore extended (*.key, f2p-tracker{,.pub}) as a guardrail in case keys ever land in src-tauri/ during dev.
  • New pubkey baked into tauri.conf.json plugins.updater.pubkey. GH secrets TAURI_SIGNING_PRIVATE_KEY and TAURI_SIGNING_PRIVATE_KEY_PASSWORD rotated via gh secret set (password = empty string).
  • Trade-off: any user already on a build signed with the old key would have their auto-update break. Nobody hit that path because Phase 9 / Phase 10 release runs both failed before publishing artefacts. Phase 10.1's rebuild is the first actually-shipped desktop-v1.0.0.

🏷️ Tag handling

  • desktop-v1.0.0 was force-pushed twice in this cycle as the workflow input commit advanced (Phase 9 → Phase 10 → Phase 10.1). The triggering tag is GPG-signed each time. Once the auto-update story is real users-on-it, future fixes should bump desktop-v1.0.x instead of force-pushing.

📝 Docs (this release)

  • CHANGELOG.md — this entry.
  • web/src-tauri/Cargo.toml + tauri.conf.json + .gitignore — Phase 10 / 10.1 changes documented in their own commit messages and PR bodies (#57, #58).

[v3.0.0] – 2026-05-07 (The "It Has a Website Now" Edition)

The repo is no longer just a list. It is a list + a React/Vite web app + a Tauri desktop app, all reading the same Python-pipeline-maintained data.

🌐 Web app — web/ + GitHub Pages

Built across phases 1 → 7. Live at https://poli0981.github.io/free-steam-games-list/.

  • Phase 1 — read-only browse: virtualised 1.2k-row TanStack table, faceted filters, Fuse.js fuzzy search, 4 ECharts MVP charts (KPI, top-online, genre treemap, platform donut), GitHub Pages deploy via actions/deploy-pages.
  • Phase 2 — PAT-based GitHub auth, single-record edit drawer for the 8 manual fields, diff viewer, single + bulk Steam-link queue into scripts/temp_info.jsonl, conflict-retry, sonner toasts.
  • Phase 3 — client-side OpenPGP signing via Git Data API: switched all writes from Contents API to commitFile(getHead → createBlob → createTree → buildCommitContent → openpgp.sign → createCommit → updateRef). Settings panel with passphrase unlock + lock indicator. Earlier claim that PATs auto-sign was wrong — Contents API commits land Unverified.
  • Phase 4 — fixed GPG salt-notation incompatibility (config.nonDeterministicSignaturesViaNotation: false) so OpenPGP.js v6 signatures parse on GitHub. Bulk edit + bulk delete in one signed multi-shard commit. 8 remaining charts (tags wordcloud, AC stacked, languages heatmap, release-year histogram, catalog-growth cumulative line, reviews histogram, online player tiers pie, DRM/DLC bars). Health page with workflow_dispatch buttons. ⌘K command palette (cmdk).
  • Phase 4.1 — GPG signature payload fix: dropped trailing \n after the commit message so our signed bytes match verification.payload byte-for-byte. Verified via gh api .../commits/{sha}.commit.verification.reason → valid.
  • Phase 5 — PWA (installable, offline shell + last-known data via Workbox), GPG identity override (multi-UID picker), GPG idle auto-lock 5/15/30/60 min, Activity feed page (/activity) with Verified-status badges + Me/Bots/All filters.
  • Phase 6 — curated enums (ANTI_CHEAT_ENUM, GENRE_ENUM) + dropdowns, JSON-editor toggle in the edit drawer (full-record replace), manual-field overrides on Add (single + bulk JSON mode propagates genre/type_game/anti_cheat/notes/safe straight into temp_info.jsonl), GamesTable pagination 50/100/200/500/all + hidden scrollbar + per-row validation badge, per-game permalinks /games/:appid with friendly 404 drawer, verify-after-commit polling (toast updates with verification.reason once GitHub confirms), CSV/JSON export of the filtered subset, About page (repo + dev info from username.txt + 3rd-party stack + issue templates), topbar GPG quick-unlock popover, owner-gate (useIsOwner + OWNER_LOGIN) hides edit/add/delete UI from non-owners.
  • Phase 6.1 — Edit Always Failing fix: Contents API caps content at 1 MB; data/data_001.jsonl is 1.49 MB so the read came back empty and every edit threw "Record not found". New getRepoFileText() helper falls back to the /git/blobs/{sha} endpoint for oversize files.
  • Phase 6.2 — stale-after-edit fix: bumped data/index.json.last_updated in every shard-modifying commit AND switched the SW cache to NetworkFirst (raw.github CDN is Fastly-cached for 5 min). Plus optimistic-update helpers (optimisticEdit/Replace/BulkEdit/BulkDelete) write straight to TanStack + IndexedDB so the editor sees their own change instantly without waiting for the CDN.
  • Phase 7 — date-column sort fix (parseReleaseDate), hamburger mobile nav (Sheet drawer, auto-close on route change), About expansion (Heads-up caveats + AI disclosure + legal links + per-third-party SPDX licence badges), legal docs rewritten (DISCLAIMER + EULA + ToS + PRIVACY) with the four caveats from notes.txt (genre best-effort, English-only, test-data leakage, unsigned-commit dev artefacts), refreshed bug_report.yml, workflow Node 20 → 24 + actions versions bumped.

🌍 i18n — vi / en (Phase 8, this release)

  • react-i18next + i18next-browser-languagedetector. Resource files src/i18n/locales/{en,vi}.json.
  • Auto-detect from navigator.language on first load; persistent override via Settings → Language.
  • Sidebar nav, Topbar, Settings, Dashboard, Top Online, common buttons, common toast strings translated. Long-form legal copy stays English by design (legal review hard to mirror exactly across two languages).

🖥️ Desktop app — Tauri 2 (Phase 8, this release)

  • web/src-tauri/ Rust scaffold targeting Tauri 2. Single main window, fixed 1400 × 900, no resize, no maximise, dark theme, centred at startup.
  • tauri-plugin-shell for opening external links to Steam / GitHub from the embedded UI.
  • New release-desktop.yml workflow: matrix ubuntu-latest / windows-latest / macos-latest, Apple Silicon + Intel universal binaries, tauri-apps/tauri-action. Triggered by desktop-v* tags or manual workflow run. Each run creates a draft GitHub Release with .msi / .dmg / .AppImage / .deb assets.
  • npm run tauri:dev and npm run tauri:build from web/ for local builds.

📦 Versioning

  • Repo version badge 2.1.0 → 3.0.0.
  • web/package.json 0.1.0 → 1.0.0 (web app considered first-stable).
  • web/src-tauri/Cargo.toml and tauri.conf.json ship at 1.0.0.

📝 Docs (this release)

  • README.md — rewrite: web app + desktop sections, updated Quick Links table, new architecture diagram, refreshed contribute paths, refreshed docs index.
  • CHANGELOG.md — this entry consolidating phases 1 → 8.
  • docs/ACKNOWLEDGEMENTs.md — refreshed with phase-by-phase AI assistance breakdown (Grok v1; Claude for v2 + the entire web/desktop layer + this changelog).
  • web/README.md — phase 8 status appended.

🛠️ Pipelines unchanged

  • All 9 v2.x Python pipeline workflows (update-json, generate-tables, top-online, update-reviews, dead-link-check, purge-unhealthy, ingest-new, ingest-from-issue, refetch-all) keep their schedules and behaviour. Two new workflows added: deploy-pages.yml (Phase 1) and release-desktop.yml (Phase 8).

[v2.1.0] - 2026-03-28 (The "Extension-Ready + Performance" Edition)

💥 Breaking Changes

  • desc field removed from schema. Use description only. Migration script handles upgrade automatically.
  • free_type field removed (unreliable from API, extension handles classification client-side).
  • jsonlines pip dependency dropped – all I/O now uses stdlib json (faster, zero deps).
  • fetcher.py function renamed: _process_batch() → process_batch() (public API).

🏗️ Schema v2.1 (Extension-Compatible)

  • 7 new fields added to every game record, matching Chrome extension output:
    • publisher (list) – e.g. ["Square Enix", "Feral Interactive (Mac)"]
    • platforms (list) – e.g. ["Windows", "macOS", "Linux"]
    • languages (list) – e.g. ["English", "French", "Japanese"]
    • language_details (list[dict]) – per-language {name, interface, audio, subtitles} booleans
    • tags (list) – all user-defined Steam tags including hidden overflow
    • anti_cheat_note (str) – raw anti-cheat name from store page
    • is_kernel_ac (bool|null) – true = kernel-level, false = non-kernel, null = unknown
  • developer normalized: string → list everywhere (API, extension, migration).
  • desc merged into description, then dropped. One field, no duplication.

🔌 Extension Data Integration

  • New merge_extension_data() in data_store.py – smart merge with 3-tier priority:
    • MANUAL_FIELDS (notes, safe, type_game, genre, anti_cheat): only fill if empty (preserves user edits).
    • ARRAY_FIELDS (developer, publisher, platforms, languages, tags): replace wholesale (extension data is richer).
    • Other fields: overwrite if extension provides non-empty value.
  • ingest_new.py now accepts full extension output (20+ fields per entry) – merges before fetch, re-applies manual overrides after fetch.
  • Ingest summary shows field counts: dev=DONTNOD plat=[Windows, macOS, Linux] langs=6 tags=20.

🔍 HTML Scraper (New Module)

  • New scraper.py – extracts data unavailable from Steam API:
    • Language table: parses <table class="game_language_options"> → accurate Interface/Audio/Subtitles per language (API only gives a broken HTML string with no subtitle info).
    • DLC pricing: parses #gameAreaDLCSection → checks data-price-final per DLC row. Only marks has_paid_dlc=true if at least one DLC has actual non-zero price (API just lists DLC IDs with no prices).
    • Tags: parses .app_tag elements including display:none overflow tags (API appdetails doesn't return user tags at all).
  • All 3 extracted from single GET request to store page – one HTML fetch per game, not three.
  • 8 regex patterns pre-compiled at module level.

⚡ Performance Optimizations

  • Eliminated double-fetch in ingest: health_checker now caches API response in HealthResult.data. ingest_new.py passes prefetched_details=health.data to fetch_full() → skips redundant fetch_app_details() call. Saves 1 API request per game (300 games = ~450s saved).
  • Dropped jsonlines dependency: load_jsonl() uses json.loads() line-by-line, save_jsonl() uses json.dumps() + f.write() directly. ~20-30% faster I/O for large files, zero pip deps for core.
  • Pre-compiled regex: scraper.py compiles all 8 patterns at import time, not per-call. 300 games = 8 compiles instead of 2400.
  • Faster is_empty(): uses frozenset lookup for empty string variants, early returns for None/list.
  • SteamClient.__slots__: reduced memory per instance, faster attribute access.
  • extract_appid() regex simplified: /app/(\d+) instead of full domain match – shorter, same correctness.
  • make_skeleton() template: shallow-copies from frozen template dict instead of building from scratch.
  • generate_tables.py: lines.extend(generator) instead of append() loop.

🔄 New Scripts & Workflows

  • refetch_all.py + refetch-all.yml – manual-only force re-fetch of ALL games into v2.1 schema. Creates backup → migrates → clears fetchable fields → re-fetches from Steam API + HTML scrape. Preserves manual fields (notes, safe, type_game). Requires typing "yes" to confirm. Timeout: 120 minutes.
  • migrate_schema.py + migrate-schema.yml – upgrades existing data.jsonl records: adds missing fields, normalizes types, drops deprecated fields. Idempotent.

🐛 Bug Fixes

  • languages corrupted: API HTML string "Brazil<br>languages with full audio" was parsed as "Brazillanguages...". Fixed by switching to HTML table scraping.
  • subtitles always false: API has no subtitle breakdown. Fixed by parsing store page language table ( Interface/Audio/Subtitles columns).
  • has_paid_dlc false positives: Games with free-only DLC were marked true. Fixed by scraping actual data-price-final attributes.
  • description duplicated: Both desc and description stored same text. Unified to description only.

🧹 Improved

  • Tables: Publisher column, Platforms column, Language count, kernel anti-cheat badge (🔴/🟢).
  • health_checker.py: @dataclass(slots=True) for leaner objects.
  • top_online.py: tier thresholds as tuple list (cleaner).
  • All scripts: consistent sys.path.insert(0, ...) for imports.

[v2.0.0] - 2026-03-26 (The "Finally Got Serious" Edition)

💥 Breaking Changes

  • Data format migrated from data.json to data.jsonl (JSON Lines).
  • All Python scripts rewritten from scratch under scripts/core/ modular architecture.
  • Bash scripts rewritten with set -euo pipefail.

🏗️ Architecture (Complete Rewrite)

  • Modular core: constants.py, steam_client.py, data_store.py, fetcher.py, health_checker.py.
  • Rate-limited HTTP client with backoff, retry, 429 handling, session pooling.
  • Health detection (5 statuses), purge, dead link check, pre-flight ingest validation.
  • New ingest flow: temp_info.jsonl → validate → dedup → health check → fetch → data.jsonl.
  • 9 CI/CD workflows. Metacritic, DRM, Peak Today, Status columns. Top Online leaderboard with trends.

[v1.1.2] - 2026-01-11

  • 40+ games added.

[v1.1.1] - 2026-01-07

  • 50+ games, delete/dedup scripts, CSV export, auto CSV Actions. (by @poli0981)

[v1.1.0] - 2025-12-30 (Scale Noob Edition)

  • Split all-games.md into parts. Smart fetch skip. Wiki. Issue templates.
  • Batch + delay optimize for 500+ games. Various Action fixes.

Previous: [v1.0.0] – Initial stable.

Made with boredom, instant noodles, sale addiction, and AI power ✨