The scan job now runs both suites with coverage before scanning: pytest --cov (pyproject.toml: scripts/ without its tests, relative paths, coverage.xml) and `npm run test:coverage` (vite.config.ts: v8, lcov with projectRoot "..", so paths start web/). sonar-project.properties names both reports and drops sonar.coverage.exclusions. requirements-test.txt gains pytest-cov 7.1.0 and coverage 7.16.2 with every file's hash (uv pip compile --universal --generate-hashes --python-version 3.15; the existing pins are unchanged). web gains @vitest/coverage-v8 5.0.5, matching vitest; none of its packages has an install script. Coverage stays off for a plain `npm test`. The token check is its own job, so the scan steps no longer each repeat the condition; the workflow grants nothing at the top and the scan job contents: read. `npm run build:admin` replaces the bare `svelte-kit sync`: it syncs too, and writes the admin bundle the Worker's tests load. Locally: 576 vitest tests at 58.35% of lines, 299 pytest tests at 57.7%. Against main's new-code lines (SonarCloud's isNew), the reports cover 92 of 114 coverable lines, 80.7%: the 80% gate is borderline. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
128 KiB
Changelog
All notable changes to this awesome noob repo will be documented here.
[Unreleased]
🧰 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
mainin place of SonarCloud's automatic analysis, with its settings insonar-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:coveragefor 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:
tscfor the Worker, the tests and the admin's Node code, andsvelte-check --tsgofor 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 indocs/plan/16-toolchain-2026.md;docs/plan/17-typescript-7.1.mdprepares 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 - G3had 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 ciruns with--ignore-scripts, and no workflow usesnpx. 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.parseIntover the global,[[ ]]in the bash wrappers; the unusednormalizeLinkis 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.mdand its Vietnamese copy: run the pipeline from the repo root, with the hashed installs; they saidcd scripts, from wheredata/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 withonly: anticheatruns 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
mainwhen 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.jsonlthat 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/removetakes 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 newdata/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 inscripts/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.pydoes 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.pycrashed 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 Gamespushed with a baregit 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.pyapplies the blocklist.Ingest New Game Linksruns it before every ingest, and a push todata/blocklist.jsonlstarts 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 Overridesvalidates the blocklist on every push that touches it.- Discovery counts removed games as already known.
🔐 Security
- The app shell's lockfile takes
rustls0.23.45 (andrustls-webpki0.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/nodeahead 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
"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.pyand 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 withbackfillticked asks about every game at once, in about four hours.
🔐 Security
- Every open dependency alert is closed (19 from Dependabot, plus the few
npm auditadds);npm auditreports 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), andurllib3in the data pipeline (2.7.0 → 2.8.0). The rest are build and development tools:undicicomes up to 7.29.1 with wrangler 4.147.0, andbrace-expansion,fast-uriandserialize-javascriptare lockfile-only bumps. SvelteKit 2 still asks forcookie0.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). Thesharpoverride 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.mdexplains 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 againstindex.jsonexactly 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-ndjsonby 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-thinmerged with ours and, in Chromium, switched the themed bar off. Ours is nowscrollbar-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.mdintends. 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.pyonly 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
mainmeanwhile.purge-unhealthyran for four hours on 2026-09-21 and then failed onpush rejected (fetch first): the data-write group serialises workflows, but a merged pull request or an/admincommit still movesmain. Every data job now commits throughbash/commit_push.sh, which rebases ontoorigin/mainand 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_VERSIONis 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 plaincurlwith no browser User-Agent is still served every public path, and the challenge rate has stayed at 0%.BLOCKED_COUNTRIESinwrangler.jsoncmakes 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-checkwith theTURNSTILE_SECRETsecret, 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 gainschallenges.cloudflare.cominscript-srcand a newframe-src;verify-dist.mjsfails 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 setsreferrerpolicy="no-referrer", which the protection allows, andsrc/lib/images.test.tsfails on one that does not. That also fixes the thumbnailsnpm run devcould 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. -
/activityand/charts/delistedfetched their data before consent. The root layout held the catalogue back, but those two pages calledload()from effects of their own, and the activity feed also refetched on window focus. The gate now lives inResourceitself: anenabledoption read inside everyload(), which every resource sets toappReady()- consent accepted and the human check cleared - so a held-back load starts by itself once both are passed.src/lib/resource.test.tsfails on anew Resourcewithout it. -
The service worker threw
non-precached-url: /200.htmlon every page load.navigateFallbacknamed the adapter-static fallback, which is written intodist/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.mjsfails the build if the two ever disagree again. -
/adminno longer writes the maintainer's email address into public Git. Commit bodies anddata/overrides/*.jsonsayadmin; the four override files that already carried it were rewritten. The acting identity is still recorded in D1, where/admin/auditreads it. -
/adminsaid "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 andfetch()cannot follow the sign-in redirect, so the session for/adminnever reached the API and every call bounced to the login page. The API now lives at/admin/api/*, under the page's own application, andworker/index.test.tsdrives it through the real router and token check. The/api/adminAccess application is no longer used and can be deleted. -
scripts/discover_new.pytook any host ending incloudflareaccess.comfor 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.mdlisted 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 againstnode_modulesrather than remembered (echarts-wordcloudis ISC, not BSD-3-Clause), and the claim that/aboutcarries a "full SPDX list" dropped — it is a curated subset.docs/DEPLOYMENT.mdrecords 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.mdsection 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/_headerspaths (the file has beenstatic/_headerssince the SvelteKit move) and aSITE_ORIGINthat is reallyAPI_ORIGINinsrc/lib/site.tsare corrected inworker/lib/http.ts,svelte.config.jsand the security doc;_headersitself 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), installsplatform-toolsonly (the SDK no longer carriestools, which stoppedandroid-v2.0.0), and names the commit it built. - CodeQL also runs when only
.mjs/.cjsfiles change, andverify-dist.mjsfinds<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-virtualand 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
Interand shipped no font file at all, so it had always rendered insystem-ui. - A warm amber palette, replacing the Tailwind 3 defaults the previous
version kept "until the palette rework", plus a skip link, a
:focus-visiblerule and aprefers-reduced-motionblock — none of which had ever existed. - A brand mark that is geometry, not a font glyph. The old icon drew "▶"
as SVG
<text>insystem-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 withVideoGamestructured 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[]andpublisher[]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/timegains 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:imageis 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.xmlgenerated 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 reachesdist/, 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_logandcommit_jobsare pruned after 180 days, as the privacy policy now says.npm run dev:adminruns the real handlers against an in-memory database, so the admin can be worked on without deploying it.
🧮 Data you can trust
data/index.jsoncarries a SHA-256 per shard, andlast_updatedchanges 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 publisheddesktop-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
limitdisabled the SQL bound.Math.min(Number("-1") || 50, 200)is-1, and SQLite treats a negative LIMIT as unlimited — so?limit=-1dumped the entire never-pruned audit log. Clamped. - A token with a missing or non-numeric
expnever expired.expis now required and numeric. - The JWT is no longer accepted from a cookie on writes. Only the
Cf-Access-Jwt-Assertionheader, 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_imageis 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-httpremoved along with itshttps://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 plainfetchto an endpoint that sends CORS headers.- Real paths, no hash router.
tauri::manager::get_asset()resolves/games/730through 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.mdsays 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/*, soimg-srcstays'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 bothwheelandmousewheelwith 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 Gamessweeps the Steam store daily into a review queue; the maintainer approves at/admin(behind Cloudflare Access). Approval queues the game foringest_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>.jsonand 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) orscripts/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.
descriptionis 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 frommainbefore 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
minSdk24→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-runtauri 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 30floor 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 existingisAndroid()from external-open.ts) — re-renders on resize / rotation. No new i18n strings.
📚 Docs & transparency
- New docs/android-support.md (+ Vietnamese mirror i18n/vi/android-support.md): minimum requirement, full rationale (security/EOL, WebView/React compatibility, edge-to-edge), tested-device matrix (emulator Android 11→16, real vivo 1907 on Android 12), and a worldwide version-share + security-EOL table with cited sources (apilevels.com, StatCounter, endoflife.date, Android Security Bulletins). Reused as the GitHub Discussion announcement.
- Updated TAURI.md, pc_spec.md (+ VN mirror) with the new Android test-device section, the release-android.yml release-notes template, and the README (version badge
3.4.1→3.4.2, new Android 11+ badge + Quick-links row).
[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 wrapsmodule.exports = classinto 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 buildecharts-for-react/esm/core, which has a cleanexport 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/openpgpremain lazy async chunks (not eager-preloaded inindex.html).
⚠️ glib advisory (Linux desktop) — acknowledged, no upstream fix
- The Dependabot alert for the
glibcrate (GHSA-wrw7-89jp-8q8g, medium, Linux-only) cannot be resolved within Tauri 2.x: the latestwebkit2gtkcrate (2.0.2) pinsglib ^0.18,tao/wrypingtk ^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.
[v3.4.0] – 2026-06-13 (The "Legal Consent Gate" Edition)
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.
⚖️ First-run consent gate (web + desktop)
- 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+HashRouterin 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):localStoragekeyf2p:legal_consentholding{ version, acceptedAt }. ATERMS_VERSIONconstant 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 Pages404.htmlredirect, or an#/error/:codedeep 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 blockswindow.opento external HTTPS) as well as on the web. - Shared legal list — the
LEGAL_DOCSarray (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 fromLEGAL_DOCS); only the gate chrome is bilingual.
🪟 Windows installer license page
- tauri.conf.json now sets
bundle.licenseFileto a new LICENSE_AGREEMENT.rtf. Tauri v2 surfaces this as a mandatory "I Agree" license page in both Windows targets built bytargets: "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_VERSIONmechanism is the only way to re-prompt updated installs. - Desktop window-close on decline needs the
core:window:allow-closepermission, 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 corrected3.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 nowReact.lazyvia a newlazyWithRetryhelper (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 existingLoadingState. - echarts (~666 KB raw) — new LazyEChart.tsx wrapper is the single dynamic boundary for
EChart.tsx(which keeps theecharts.use([...])registration). All 15 chart components swap one import line; a fixed-heightanimate-pulseskeleton 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.jsonstays bundled (it'sfallbackLng— a missing key can never render raw),vi.jsonbecomes a dynamic import.initI18n()preloads the detected locale beforei18n.init, and main.tsx awaits it before first render — no flash of raw keys, verified with a hard reload underf2p:lang=vi.setLanguage()is now async and loads the bundle before switching. Also syncs<html lang>(was hardcodedvifor everyone). - manualChunks fix — forcing
echarts/openpgpintomanualChunksmade 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.htmlnow modulepreloads onlyreact+query. - Net effect: eager JS
~1746 KB → ~494 KBraw (~574 → ~163 KBgzip). 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/PwaIndicatorpalettes), monoERROR {{code}}badge, i18n'd title/description, and three actions (Go home / Reload / Report issue → GitHub Issues). Fullerrors.*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/:codedeep links viaErrorCodeRoute(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 ownf2p:lang,noindex, absolute link back to/free-steam-games-list/#/. Excluded from the SW precache viaglobIgnoresin vite.config.ts — SW-controlled clients getnavigateFallbackand never see it.
🛡️ Error boundaries + stale-deploy resilience
- New ErrorBoundary.tsx (own ~40-line class, no new dep) with a
resetKeyprop — navigating away clears a stuck error without remounting the page subtree on every navigation (whichkeywould 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. lazyWithRetryhandles the deploy-mid-session case: a chunk 404 triggers ONE auto-reload per tab (sessionStorageflag, 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
ErrorStateupgraded in place (contract preserved): offline detection swaps in theerrors.offline.*copy +WifiOfficon, plus Retry / Report-issue action buttons. All 17 call sites now passonRetry={() => void q.refetch()}. - Expired/revoked token on session restore (stores/auth.ts
hydrate()catch) now fires a Sonner toast with the sharederrors.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/addstays 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 anonErrorfallback 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);webpProxyUrlis 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 +useMemofor the command palette's game scan.
🧰 Tooling & misc
rollup-plugin-visualizerdevDependency +npm run analyze(vite build --mode analyze→dist/stats.htmltreemap, gzip/brotli sizes).- index.html:
preconnecthints forraw.githubusercontent.com(shard fetches, crossorigin) andshared.akamai.steamstatic.com(thumbnails). npm audit fix— react-router open-redirect advisory GHSA-2j2x-hqr9-3h42 (react-router-dom6.30.x patch line);npm auditandpip-auditboth 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— newCOMING_SOONstatus, added to theREMOVABLEset.check_game_health()now reads the Steamappdetailsflagrelease_date.coming_soonright after the API response resolves (before theis_freecheck) and returnsHealthResult(COMING_SOON, …)for unreleased titles.- Effect:
ingest_new.pyrejects coming-soon entries from the queue and logs them toremoved_games.jsonlwith reason "Not yet released (coming soon)" — the same pathNOT_FREEalready 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_comingsoonHTML block — it's already fetched during the health check and is authoritative. No schema change.
🧹 Web dead-code cleanup (knip)
- New
knipsweep (config inweb/knip.json). Removed two unused files:src/components/common/UpdateChecker.tsx— the Tauri auto-update component, never wired intoLayout.tsxsince Phase 9, so the frontend update check never actually ran — andsrc/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 removedUpdateChecker). vite.config.ts— dropped the now-stale@tanstack/react-tableentry from themanualChunks.tablegroup.- knip's remaining "unused export" findings inside the
src/lib/*port modules are intentional API surface; they're set towarnsonpm run knipstays 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 ofmigrate_to_shards.py. scripts/core/data_store.py— dropped the unusedEXTENSION_FIELDSimport. The constant stays defined inconstants.pyas the documented MANUAL/ARRAY/EXTENSION field-class trio (mirrored inweb/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.jsondevDependency +npm run knipscript +web/knip.json. Finds unused files / exports / dependencies in the TypeScript SPA. - vulture + pip-audit — new
requirements-dev.txt; vulture config in a new rootpyproject.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/aboutpage (web/src/pages/About.tsx), andweb/README.mdno 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, andoverflow-hiddenclipped 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>loadsheaderToCapsule(g.header_image)(the smallercapsule_184x69.jpgvariant, ~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 anonErrorhandler that falls back to the originalheader.jpg; the v3.2.5 mobile card component didn't port it.GameDetailDrawerusesg.header_imagedirectly, which is why the image always appeared once a card was tapped. - Fix: add the same
onErrorfallback to the mobile card<img>— on a 404 it swapssrctog.header_image, with anel.src !== g.header_imageguard 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 callsdocument.getElementById(id).scrollIntoView({ behavior: "smooth", block: "start" }). Theid={anchor}attribute on each family<Card>stays the same — only the click target changes. - Root cause:
main.tsx:24usesHashRouter. Anchor links inside a hash-routed page produce URLs like#/charts/anti-cheat/list#vac. HashRouter parses the trailing#vacas a fresh route, the regex doesn't match, and the<Route path="*" element={<Navigate to="/" replace />}>fallback inApp.tsxsends 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 existinguseFiltersstore. GamesTable.tsxwraps the desktop scroll container inhidden md:blockand renders<MobileGameCards>insidemd:hidden. No new state, no behaviour drift between views.AntiCheatList.tsxsidebar changes fromhidden w-48 shrink-0 lg:blocktohidden md:block md:w-40 lg:w-48— visible on tablets too. Belowmd, a horizontal scrollable chip rail above the content provides the same family-jump nav.KpiCards.tsxgridsm: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. Insertsmd(tablet, 3 cols) andlg(small laptop, 4 cols) rungs so the 7 KPIs don't double-stack awkwardly.
🧹 games/ cleanup + smart regen
- Deleted 93 per-genre
<genre>.mdfiles (action.md,fps.md,visual-novel.md, …). Web app/games?genre=Xis the canonical genre filter since v3.0; no inbound link audit hit anything beyondgames/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.pydrops the genre loop entirely and rewrites thegames/README.mdtemplate 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 computessha256of sorted(link, name, genre, reviews, current_players, anti_cheat, is_kernel_ac, status)tuples and writes the digest togames/.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 forscrollevents 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.tsxcreates auseRef<HTMLElement>on<main>, passes it asscrollRef. Single mount, no per-page wiring.- i18n:
common.backToTopadded toen.json("Back to top") andvi.json("Lên đầu trang") foraria-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.pydeleted — superseded by thepoli0981/.githubreusable workflow; no.github/workflows/*.ymlorbash/*.shreferenced it.scripts/migrate_to_shards.pydeleted — 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 livebash/*.shwrappers and stay.
🪓 Component splits
web/src/components/games/EditGameDrawer.tsx(718 LOC) → 7 focused files underedit/:EditGameDrawer.tsxkeeps the save handler, dialog shell, view-toggle wiring.EditFormFields.tsx,EditJsonView.tsx(withJsonDiff),EditChangePreview.tsx,ViewToggle.tsxextract the four UI regions.form-utils.tsexportsgameToForm+formToPatch;types.tsre-exports theFormState+Viewtypes.
web/src/components/games/GamesTable.tsx(568 LOC) → container + 5 files undertable/:GamesTable.tsxkeeps the virtualizer (useVirtualizerownership at container level so row-height stays single-source), filters, fuzzy search, sort, and paging.columns.tsxextracts theCOLS: ColDef[]array (12 columns) +TOTAL_WIDTH+SELECT_COL_WIDTHconstants.TableHeader.tsx,TableRow.tsx(memoised withReact.memo),TableToolbar.tsx,ExportMenu.tsxextract 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 ofTopOnlineBarbut with offline-tier thresholds (20k/1.5k/300) calibrated to thetop_offline.pyscale instead of the online-only 100k/10k/1k palette. Filterstype_game !== "online" && status === "active", top 100 bycurrent_players.web/src/pages/TopOffline.tsx— new page at/top-offline, layout mirror ofTopOnlinePage, registered inApp.tsxandSidebar.tsx(Trophy icon).web/src/components/charts/AddedPerMonthBar.tsx— aggregatesrecords[*].added_atintoYYYY-MMbuckets, renders an ECharts bar. Added as a third card to the existingcharts/Time.tsxpage alongsideReleaseYearHistogram+AddedCumulativeLine.
🗑️ Removed-games dedup
scripts/core/data_store.py— newdedup_removed(records)keeps the latest entry per appid (compared byremoved_atISO timestamp, lexicographic order matches chronological forYYYY-MM-DDTHH:MM:SSZ). Records without a resolvable appid are dropped.scripts/purge_unhealthy.py:41-43andscripts/ingest_new.py:106-108— both call sites now writededup_removed(existing + log)instead ofexisting.extend(log). Samesave_jsonlatomic-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 → 37records. 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.mdregenerated 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}updatedTop 50 → Top 100in bothen.jsonandvi.json.
🛡️ Anti-cheat list
scripts/generate_anti_cheat_list.py(new) — buckets active games by canonical AC name (ANTI_CHEAT_PATTERNSkeys), with substring-match fallback for free-text values. Unrecognised values land in anOtherbucket with a stderr warning. Outputgames/anti-cheat-list.md: H1 + TOC + per-family H2 sections, each a 6-column table sorted bycurrent_playersdesc.bash/anti_cheat.sh+.github/workflows/anti-cheat-list.yml(new) — weekly Sunday 06:00 UTC cron + manual dispatch. Uses the samedata-writeconcurrency group as the other table-generation workflows.web/src/pages/AntiCheatList.tsx(new) —/charts/anti-cheat/listpage mirrors the MD: collapsible per-family sections + sticky AC-name sidebar nav. Uses existinguseGameshook; canonicalises client-side via a TS port of the Python patterns table. i18n keysantiCheatList.*added to en + vi.
📉 Delisted charts
web/src/hooks/useRemovedGames.ts(new) — fetchesscripts/removed_games.jsonlfrom 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-MMofremoved_at, stacked bystatus_code(not_free/unavailable/ fallbackother).web/src/components/charts/DelistedReasonBreakdown.tsx(new) — ECharts donut bystatus_code.web/src/pages/charts/Delisted.tsx(new) —/charts/delistedpage renders both charts. Sidebar nav link withWifiOfficon.web/src/components/charts/KpiCards.tsx— new optionalremovedCountprop; when set, renders a 7th "Removed (all-time)" KPI alongside the existing in-catalog "Delisted" badge. Wired fromDashboard.tsxviauseRemovedGames().data?.length. Grid bumps fromxl:grid-cols-6toxl: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 toen.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 inEditGameDrawer.tsx(2),Add.tsx(2 insidereportToast),BulkEditDrawer.tsx(2), andBulkActionBar.tsx(2) toopenExternal()fromweb/src/lib/external-open.ts— completes the follow-up migration flagged in v3.2.2's CHANGELOG. The Tauri webview was silently blocking the rawwindow.open(...)for external HTTPS URLs, so "View commit" did nothing on desktop. - Each
toast.success(...)with a "View commit" action now setsduration: 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.successand the follow-up emit fired bypollCommitVerification(...).then(...)(same toastid, sodurationmust 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—FormFieldsderiveslockAC = form.type_game === "offline"and threadsdisabled={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-resetsanti_cheat="",anti_cheat_note="",is_kernel_ac="unknown"whenkey === "type_game" && value === "offline". This keeps theformToPatch()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 inOverrideFields+ theSingleAdd.setOv()setter.OverrideFieldscombines the existing busy-statedisabledprop with the new lock viaacDisabled = 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 existingvalidation.ts"kernel?" badge rule for online + missing-kernel is untouched.- New i18n key
edit.acLockedOfflineadded toweb/src/i18n/locales/en.jsonandvi.json, rendered as atext-xs text-muted-foregroundhint under the AC note whenlockACis true.
🪦 Mark dead games workflow path fix
.github/workflows/mark-dead-games.yml—cache-dependency-path: scripts/requirements.txtand the subsequentpip install -r scripts/requirements.txtboth pointed at a path that doesn't exist. The file lives at the repo root (requirements.txt), consistent with the pathcodeql.yml:25already uses.- Fix: both lines now reference
requirements.txtat the root. Thesetup-pythoncache lookup no longer errors withNo 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_dispatchwithdry_run=trueis 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.
🔗 Desktop Ctrl+K external link
- New
web/src/lib/external-open.ts— lazy-detects the Tauri runtime via__TAURI_INTERNALS__, opens external URLs through@tauri-apps/plugin-shellon desktop (capabilityshell:allow-openalready granted inweb/src-tauri/capabilities/default.json), falls back towindow.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 throughopenExternal(). The Tauri webview was silently blocking the rawwindow.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 toopenExternal()— same desktop silent-fail will hit them when triggered.
🩺 Health → Games filter restoration
web/src/pages/Games.tsx— addsuseSearchParams+ auseEffectthat mirrors the URL?search=parameter intouseFilters.searchon 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 ofif (term)) lets?search=explicitly clear the filter — useful for shareable "no filter" links.
🪟 Tauri single-instance enforcement
web/src-tauri/Cargo.toml— addstauri-plugin-single-instance = "2"under the existing desktop-onlycfg(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 callsunminimize()+show()+set_focus()on the existingmainwindow. Without this, every Start-menu / shortcut / file-association invocation spawned a freshf2p-tracker.exethat 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)readsdata.get("categories", [])and returns"online"when any description containsonline,mmo,massively multiplayer,cross-platform multiplayer, ormulti-player. Pureshared/split screendescriptions 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 byis_empty(game.get("type_game"))so manual prefills intemp_info.jsonlremain authoritative — theMANUAL_FIELDSmerge indata_store.merge_extension_data()and the override re-apply iningest_new.pyare unchanged. - The legacy default-to-
"offline"at the end offetch_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--applyflag (dry-run by default). Reusescore.data_store.load_main/save_mainso 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/*.mdregenerated viascripts/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_ENUMextended 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.tsxis facet-driven (auto-updates from the records), so it now shows the deduplicated canonical names. TheEditGameDrawercombobox 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) andweb/public/sitemap.xml(5 entries: site root, GitHub repo, all-games / top-online / changelog markdown). - New hook
web/src/hooks/useDocumentTitle.ts— setsdocument.titleto<page> · Steam F2P Trackerand re-runs on language change. Wired into all 18 routes (Dashboard / Games / TopOnline / Health / Activity / Add / About / Donate / Settings / 9 charts). - VitePWA already emits
manifest.webmanifestfromvite.config.ts; no manual manifest needed.
💬 Auto-create GitHub Discussion on release
- New
.github/workflows/announce-release-discussion.yml— fires onrelease: published(plusworkflow_dispatchwith ataginput for re-runs). - Implemented via
actions/github-script@v8+ GraphQLcreateDiscussion(REST has no equivalent). - Resolves the discussion category by slug — defaults to
Announcements, falls back toGeneralwith a logged warning, then to the first available category. - Idempotent: a GraphQL search runs first; if a discussion with the same title exists, the workflow skips with
core.notice()and returns the existing URL via output. Re-runningworkflow_dispatchis therefore a no-op. - Permissions:
contents: read,discussions: write— both granted byGITHUB_TOKENdefaults once Discussions is enabled on the repo.
💖 Donate page
- New
web/src/pages/Donate.tsxroute at/donate— grid of 5 platform cards (GitHub Sponsors, Ko-fi, Buy Me a Coffee, Patreon, PayPal) sourced from.github/FUNDING.yml. - Each card has a tinted icon ring, label, short description, and an "Open" button (
target="_blank" rel="noopener noreferrer"). - New nav item in
web/src/components/layout/Sidebar.tsxSECONDARY group (between About and Settings);Hearticon from lucide. - Full EN + VI i18n keys under
donate.*(title / subtitle / cta / footnote + per-platform label & desc).
📖 Dev docs
- New
docs/pc_spec.md(EN) +docs/i18n/vi/pc_spec.md(VI) — maintainer hardware spec mirroringE:\spec.txt(CPU / GPU / RAM / IDE) plus iPhone test-device list. - New
docs/dev_env.md(EN) +docs/i18n/vi/dev_env.md(VI) — IDE map (PyCharm / WebStorm / RustRover 2026.x), toolchain table (Python 3.12 / Node ≥ 22 / Rust stable / Tauri 2), per-area dev workflow (web / Tauri / Python pipeline), Git + GPG conventions, branch + PR flow. - New
web/src-tauri/TAURI.md— desktop build prerequisites (incl. CI's exactapt-getline), local + production build commands, signing + auto-update notes, troubleshooting. AUTHORS.md— new "Dev info" table (GitHub handle, IDE channel, toolchain versions, link map to all the above).- README "Docs" section — links the four new docs.
🤖 Telegram bot user-guide pointer
- New
docs/telegram-bot.md— one-page pointer to the externaltelegram-scraper-bot/docs/USER_GUIDE.md, bot source repo, plus a paragraph each on what the bot does and the whitelist lifecycle. CONTRIBUTING.md— section 3 (@my_skull_bot) gets a 3-line callout with the user guide link, bot source URL, and the new in-repo summary doc.web/src/pages/About.tsx— Maintainer card's privacy note now includes a "Bot user guide & source" sub-card with the same three links.
🩺 Health bucket split
web/src/pages/Health.tsx—gatherIssues()adds a fifthIssueGroup:OnlineAcUnknownfor games withtype_game === "online"andanti_cheat ∈ {"", "-"}. Previously these games were silently dropped from all categories; now they have a discoverable home.- Edge-case fix: the existing "Kernel" filter compared
(r.anti_cheat ?? "-") !== "-", missing the empty-string case. Both filters now use a normalised(r.anti_cheat ?? "").trim(). ShieldQuestionicon (lucide). EN + VI i18n keys:health.groupOnlineAcUnknown+…Desc.
🎮 Steam Desktop direct link
- New helper
web/src/lib/steam-link.ts—steamProtocolUrl(appid)returnssteam://store/<appid>,steamWebUrl(appid)returns the regular HTTPS store URL. web/src/components/games/GameDetailDrawer.tsx— single store link replaced by two buttons rendered side-by-side: a primary "Steam Desktop" (steam://) and an outline "Web" (https://). Tooltip on the desktop button explains the fallback path.- Works in both web build (browser shows protocol prompt if Steam is installed, silent fail otherwise — Web button is the safety net) and Tauri build (Tauri 2 allows
steam://navigation by default; no allow-list change needed). - EN + VI i18n:
detail.openOnSteamDesktop,detail.openOnSteamDesktopHint,detail.openOnSteamWeb.
🛌 Bi-weekly offline-player leaderboard
- New
scripts/top_offline.py— clones thetop_online.pyshape but filters_is_offline(g)(non-emptytype_game ≠ "online"). Emitsgames/top-offline.md(top 100 single-player F2P concurrents, 10-column format identical to top-online). - Calibrated tier thresholds (
_TIERS) lower than online (offline games rarely break 6-figure concurrents) —🔥 Mega ≥ 20k,⭐ Hot ≥ 5k,🟢 Healthy ≥ 1.5k,🟡 Stable ≥ 300,🟠 Low ≥ 50,🔴 Quiet ≥ 10,💀 Idle <10. - New
bash/offline.shmatches the shape ofbash/online.sh(pip install requests → run script → conditional commit). - New
.github/workflows/top-offline.yml— cron0 5 1,15 * *(1st + 15th of each month at 05:00 UTC) plusworkflow_dispatch. Shares the unifieddata-writeconcurrency group. - Health page (
web/src/pages/Health.tsx) — new manual trigger button "Top offline" (next to the existing "Top online" trigger). - Bug fix during implementation:
scripts/core/fetcher.py:update_players_only()had a hardcodedtype_game == "online"filter that would have made the offline workflow refresh zero rows. Extended with atype_filterkwarg ("online"default for backward compat,"offline", or"all");top_offline.pypassestype_filter="offline"(excludes both online and empty/unclassified type).
🔢 Versioning
| Surface | Old | New |
|---|---|---|
| Repo public-facing | 3.1.0 | 3.2.0 |
web/package.json |
1.1.0 | 1.2.0 |
web/src-tauri/Cargo.toml |
1.1.0 | 1.2.0 |
web/src-tauri/tauri.conf.json |
1.1.0 | 1.2.0 |
| Git tag (signed) | v3.1.0 |
v3.2.0 |
| Desktop tag (signed) | desktop-v1.1.0 |
desktop-v1.2.0 |
[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 onworkflow_run: workflows: ["*"]and were filtered out by their reusable callee'sif:— 95–100 % of runs showed as "skipped". Replaced the catch-all with explicit lists of source workflowname:strings per wrapper, plus job-levelif: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 usecapsule_184x69.jpginstead ofheader.jpg(~80 % bandwidth reduction at the same 120 px render width).- Web app
GamesTable+CommandPalette— capsule swap with explicitwidth/heightto eliminate CLS, plusonErrorfallback toheader.jpgfor the ~5 % of games without a capsule variant. GameDetailDrawer—<picture>element with WebP source viaimages.weserv.nlproxy + JPEG fallback. Lazy-loaded, explicit dimensions.vite.config.ts— newCacheFirstruntime cache forimages.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 UTCflags online games released >1 year ago whosecurrent_players == 0for ≥14 days (configurable viaDEAD_GAME_DAYSenv or--daysCLI). On trigger:is_dead = true+"💀 Dead game"appended tonotes(idempotent). - State model: ISO timestamp
zero_player_since(robust against schedule drift), not a streak counter. - Mark mechanism: additive
is_dead: bool+ note.statusstays"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 0for auditing without writes. - New helper
append_note_idempotent()inscripts/core/data_store.py. Retrofitted ontocheck_dead_links.pyto fix duplicate"💀 Delisted"accumulation on reruns. - Schema migration via
_SKELETON_TEMPLATEonly (no one-shot script). Both the Python pipeline and the React app inherit defaults via existingmigrate_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-reviewscheck-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.mdat repo root — handle map for the maintainer, AI-assistant disclosure, MIT licensing reminder.username.txtextended withtelegram bot,telegram user, andemaillines (canonical machine-readable handle map mirrored byAUTHORS.md).assets/qr/— QR-code PNGs for@my_skull_botand@SkullMute0011(mirrored toweb/public/qr/so the SPA can serve them). Generated viapython -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 Telegramuser_idhandling.CONTRIBUTING.mdrewrite — adds the@my_skull_botflow as a first-class contribution path (finduser_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 theuser_iddata 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-updaterwired intoweb/src-tauri/. Endpoint pinned to the Releases page so installed clients fetchlatest.jsonon 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 inmain.rswithout declaring[lib]inCargo.toml. Cargo's implicit lib name isf2p_tracker(hyphens → underscores from the package name) so the call failed to resolve andcargo buildblew up. Added the explicit Tauri-2-template-style block:The triple crate-type keeps the door open for future[lib] name = "f2p_tracker_lib" crate-type = ["staticlib", "cdylib", "rlib"]tauri ios init/tauri android initwork thatlib.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,Topbartooltips/aria-labels,Settingsrate-limit panel,BulkActionBarconfirm dialog,GamesTabletooltips, andCommandPaletteresolve throughuseTranslation. Long-form About prose stays English per thesettings.languageHintpolicy. Enum values (anti-cheat / genre / type_game / safe) stay dataset-stable. - Third-party deps audit. Walked
web/package.jsonagainstAbout → Stack & third-partyanddocs/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.mdrestructured 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.locknow committed for reproducible desktop builds.
🔑 Phase 10.1 — minisign keypair rotation (#58)
desktop-v1.0.0was failing at the final sign-updater-bundle step: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 expectedfailed to decode secret key: incorrect updater private key password: Missing comment in secret keyuntrusted comment: minisign encrypted secret keyheader 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/.gitignoreextended (*.key,f2p-tracker{,.pub}) as a guardrail in case keys ever land insrc-tauri/during dev. - New pubkey baked into
tauri.conf.jsonplugins.updater.pubkey. GH secretsTAURI_SIGNING_PRIVATE_KEYandTAURI_SIGNING_PRIVATE_KEY_PASSWORDrotated viagh 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.0was 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 bumpdesktop-v1.0.xinstead 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
\nafter the commit message so our signed bytes matchverification.payloadbyte-for-byte. Verified viagh 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 propagatesgenre/type_game/anti_cheat/notes/safestraight intotemp_info.jsonl), GamesTable pagination 50/100/200/500/all + hidden scrollbar + per-row validation badge, per-game permalinks/games/:appidwith friendly 404 drawer, verify-after-commit polling (toast updates withverification.reasononce GitHub confirms), CSV/JSON export of the filtered subset, About page (repo + dev info fromusername.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
contentat 1 MB;data/data_001.jsonlis 1.49 MB so the read came back empty and every edit threw "Record not found". NewgetRepoFileText()helper falls back to the/git/blobs/{sha}endpoint for oversize files. - Phase 6.2 — stale-after-edit fix: bumped
data/index.json.last_updatedin every shard-modifying commit AND switched the SW cache toNetworkFirst(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 fromnotes.txt(genre best-effort, English-only, test-data leakage, unsigned-commit dev artefacts), refreshedbug_report.yml, workflow Node 20 → 24 + actions versions bumped.
🌍 i18n — vi / en (Phase 8, this release)
react-i18next+i18next-browser-languagedetector. Resource filessrc/i18n/locales/{en,vi}.json.- Auto-detect from
navigator.languageon 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. Singlemainwindow, fixed 1400 × 900, no resize, no maximise, dark theme, centred at startup.tauri-plugin-shellfor opening external links to Steam / GitHub from the embedded UI.- New
release-desktop.ymlworkflow: matrixubuntu-latest/windows-latest/macos-latest, Apple Silicon + Intel universal binaries,tauri-apps/tauri-action. Triggered bydesktop-v*tags or manual workflow run. Each run creates a draft GitHub Release with.msi/.dmg/.AppImage/.debassets. npm run tauri:devandnpm run tauri:buildfromweb/for local builds.
📦 Versioning
- Repo version badge 2.1.0 → 3.0.0.
web/package.json0.1.0 → 1.0.0 (web app considered first-stable).web/src-tauri/Cargo.tomlandtauri.conf.jsonship at1.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) andrelease-desktop.yml(Phase 8).
[v2.1.0] - 2026-03-28 (The "Extension-Ready + Performance" Edition)
💥 Breaking Changes
descfield removed from schema. Usedescriptiononly. Migration script handles upgrade automatically.free_typefield removed (unreliable from API, extension handles classification client-side).jsonlinespip dependency dropped – all I/O now uses stdlibjson(faster, zero deps).fetcher.pyfunction 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}booleanstags(list) – all user-defined Steam tags including hidden overflowanti_cheat_note(str) – raw anti-cheat name from store pageis_kernel_ac(bool|null) –true= kernel-level,false= non-kernel,null= unknown
developernormalized: string → list everywhere (API, extension, migration).descmerged intodescription, then dropped. One field, no duplication.
🔌 Extension Data Integration
- New
merge_extension_data()indata_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.pynow 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→ checksdata-price-finalper DLC row. Only markshas_paid_dlc=trueif at least one DLC has actual non-zero price (API just lists DLC IDs with no prices). - Tags: parses
.app_tagelements includingdisplay:noneoverflow tags (APIappdetailsdoesn't return user tags at all).
- Language table: parses
- 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_checkernow caches API response inHealthResult.data.ingest_new.pypassesprefetched_details=health.datatofetch_full()→ skips redundantfetch_app_details()call. Saves 1 API request per game (300 games = ~450s saved). - Dropped jsonlines dependency:
load_jsonl()usesjson.loads()line-by-line,save_jsonl()usesjson.dumps()+f.write()directly. ~20-30% faster I/O for large files, zero pip deps for core. - Pre-compiled regex:
scraper.pycompiles all 8 patterns at import time, not per-call. 300 games = 8 compiles instead of 2400. - Faster
is_empty(): usesfrozensetlookup for empty string variants, early returns forNone/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 ofappend()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 existingdata.jsonlrecords: adds missing fields, normalizes types, drops deprecated fields. Idempotent.
🐛 Bug Fixes
languagescorrupted: API HTML string"Brazil<br>languages with full audio"was parsed as"Brazillanguages...". Fixed by switching to HTML table scraping.subtitlesalwaysfalse: API has no subtitle breakdown. Fixed by parsing store page language table ( Interface/Audio/Subtitles columns).has_paid_dlcfalse positives: Games with free-only DLC were markedtrue. Fixed by scraping actualdata-price-finalattributes.descriptionduplicated: Bothdescanddescriptionstored same text. Unified todescriptiononly.
🧹 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.jsontodata.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 ✨