docs(changelog): one file per minor version under changelog/

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

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

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
poli0981andClaude Opus 5.5 committed 2026-09-24 18:01:52 +07:00
1 parent fdf0645829
commit 251369ede6
16 files changed
+972 -807

No files matched your search

+5 -4
View File
@@ -2,9 +2,9 @@ name: Announce to Discussion
# Two triggers, two destinations:
# 1. release:published → Announcements category
# 2. push touching CHANGELOG.md → General (docs-only edits no longer post;
# put user-facing changes in the changelog). Add `[skip-discuss]` to the
# head-commit message to opt out.
# 2. push touching the changelog (CHANGELOG.md index or changelog/**) →
# General (docs-only edits don't post; put user-facing changes in the
# changelog). Add `[skip-discuss]` to the head-commit message to opt out.
#
# No pre-flight needed — repo ID and category IDs are auto-discovered at
# runtime via GraphQL (by category slug: "announcements" / "general").
@@ -17,6 +17,7 @@ on:
branches: [main]
paths:
- 'CHANGELOG.md'
- 'changelog/**'
workflow_dispatch:
inputs:
mode:
@@ -163,7 +164,7 @@ jobs:
id: changes
run: |
set -euo pipefail
git diff --name-only HEAD^ HEAD -- CHANGELOG.md > changed.txt || true
git diff --name-only HEAD^ HEAD -- CHANGELOG.md changelog/ > changed.txt || true
if [ ! -s changed.txt ]; then
echo "no-docs-changed=true" >> "$GITHUB_OUTPUT"
fi
+54 -803
View File
@@ -1,805 +1,56 @@
# Changelog
All notable changes to this project will be documented here.
## [4.0.0] - 2026-09-18 (freeitchgames.win on Cloudflare: read-only site, review queue, new design)
Version 4 moves the website to **https://freeitchgames.win** on Cloudflare, makes it read-only for
everyone (no sign-in), adds a maintainer-only admin with a review queue for new games, replaces the
failing data crawls with a rotating refresh, and splits the licenses (code MIT, data and docs
CC BY 4.0).
### Upgrade notes
- **The web app no longer signs in or edits.** The GitHub-token (PAT) sign-in, in-app editing, the
Add / Workflows pages and GPG commit signing are gone; on first load the app deletes the
encrypted token and key it stored before. Suggest games at https://freeitchgames.win/suggest.
- **Old links keep working**: `…github.io/free-games-itchio-list/#/x` redirects to the new site,
and `#/x` links become `/x`.
- **Desktop and Android apps** are read-only viewers too; they read the catalog from
freeitchgames.win. Install 4.0.0 over 3.x as usual.
- **New legal terms** (ToS, Privacy Policy, EULA for the apps only, Disclaimer): the site asks you to
accept them again once.
### New design
- A clean, table-first interface under the name **Free Itch Games**: a top navigation bar with a
global search (press `/`) and a display menu (theme, language, density, 18+) replaces the
sidebar, and a **Welcome** page at `/` (catalog status, recently added games) replaces the
dashboard.
- **Games**: search plus filters for genre, platform, status, tags, language, input, engine,
minimum rating and "plays in browser", each showing how many games it would match. The search,
filters, sort and page are kept in the URL, so a filtered list can be bookmarked or shared. Phones
get a list layout.
- A new game page (cover, key facts, tags that open the matching list, "Report a problem"), a
searchable removed-games page and a simpler Settings page.
- The first-visit legal gate is now a dialog over the page, so a shared link opens where it
pointed once the terms are accepted.
- Tailwind CSS 4, the self-hosted Geist typefaces, new icons and social preview image; numbers and
dates follow the chosen language.
### Website & Worker
- The site is served by a Cloudflare Worker with static assets ([`webapp/wrangler.jsonc`](webapp/wrangler.jsonc),
[`webapp/worker/`](webapp/worker)) and the catalog JSON is bundled into every build (`/data/*`,
plus a sitemap), so each data commit republishes the site; the desktop/Android apps read the same
files. Real URL paths instead of `#/` routes, per-page canonical URLs, and real 404s for unknown
pages and missing files (a stale script after a deploy can no longer be cached as HTML).
- **Cover images** are resized once to small WebP copies (Cloudflare Image Transformations + R2)
and served from `/img/…` — about 4 KB instead of up to 3 MB per cover. Only catalog covers are
served.
- **18+ games are hidden by default**; a visitor can show them (Settings or the display menu) after
confirming they are 18 or older (stored only in their browser). The removed-games page is now
`/removed` (`/deleted` redirects there). Aggregate, cookieless Cloudflare Web Analytics.
- Enforced Content-Security-Policy and security headers; faster first load (~175 KB gzip, charts
load only when opened); browser floor Safari/iOS 15.4.
- React Router 8, React 19.3, Vite 8 (rolldown), vitest; unused sign-in dependencies (Octokit,
OpenPGP.js) removed; Tauri drops its HTTP plugin and `Cargo.lock` is committed.
### Adding games: review queue
- **Suggest page** (`/suggest`): anyone can send an itch.io link (+ optional note); protected by
Cloudflare Turnstile and a rate limit.
- **Browser extension API** (`POST /api/ingest`, Cloudflare Access service token, idempotent) —
the extension no longer needs a GitHub token.
- **RSS discovery**: every 4 hours the Worker reads one itch.io "new & popular free" feed.
- Everything lands in a **review queue** (Cloudflare D1). The maintainer approves or rejects it in
the new **admin** (`/admin`, Cloudflare Access), which also edits the three maintainer fields,
removes games with a public reason (deleting their resized covers) and restores removed games.
Approved games are committed by a GitHub App (verified commits) and scraped by the pipeline.
### Licenses & legal
- Code stays **MIT** (`LICENSE`, now "2025-2026 poli0981 (SkullMute)"); the catalog data
([`data_game/LICENSE.md`](data_game/LICENSE.md)) and the documentation are **CC BY 4.0**
([`LICENSES/CC-BY-4.0.txt`](LICENSES/CC-BY-4.0.txt)); creators' descriptions, cover images and
trademarks are excluded. [`NOTICE.md`](NOTICE.md) sums it up: not affiliated with itch.io.
- Rewritten Terms of Use (with a content-removal process), Privacy Policy (Cloudflare as
processor, exact browser storage, retention, rights under Vietnam's Law No. 91/2025/QH15 and the
GDPR), Disclaimer, Security Policy and Code of Conduct, in English and Vietnamese. The EULA now
covers only the desktop and Android apps. Contact addresses: legal@, privacy@, security@ and
takedown@freeitchgames.win.
- Issue templates: "Add games" points to the Suggest page, "Remove a game" gained a
rights-holder section; `CODEOWNERS` added.
### Fixed
- **freeitchgames.win served the unbuilt `webapp/` source tree** (blank page; `/package.json`,
`/src/*` publicly readable). The Vite web build now goes to `webapp/dist`, which
[`webapp/wrangler.jsonc`](webapp/wrangler.jsonc) deploys (`workers_dev`/`preview_urls` off).
- **All 15 Dependabot alerts / npm audit** — lockfile refreshed in-range (vite 8.3.0,
react-router-dom 7.18.4, postcss 8.5.28, patched transitive deps); `npm audit` reports 0.
- **Android release workflow** moved off Node 20 actions (setup-java v6, upload-artifact v7,
setup-android v4, checkout/setup-node v7), SHA-pinned, with a timeout and the tag passed via env.
- **`.gitattributes`** — `* text = auto` / `* eol = lf` were invalid (spaces around `=`); now
`* text=auto eol=lf` with binary rules, and legal/policy docs ship in source archives again.
- OG image, manifest (`start_url`/`scope`/`id` = `/`), canonical/og URLs, sitemap and robots now
point at freeitchgames.win; OG title no longer overflows.
### Data pipeline (rewrite)
- **One rotating refresh replaces four failing crawls.** `check_paid` / `check_alive` /
`update_reviews` / `update_status` each fetched all 2,600+ pages sequentially, overran their
job timeouts and — saving only at the end — lost every run since late June (with no alert,
because a timeout ends as *cancelled*). The new [`scripts/refresh.py`](scripts/refresh.py)
(`refresh.yml`, daily) checks one seventh of the catalog with **one request per game**, so every
game is re-checked weekly (~86% fewer requests to itch.io), and updates alive / paid / rating /
status (+ backfills release date, thumbnail, `updated_at`) from that single page.
- **Safer removals:** a game is removed only when the same 404/410 or paid status is seen again at
least 20 hours after it was first seen (single flaky responses no longer delete games). A
mass-change guard withholds removals — and alerts — when a run would remove or newly strike more
than max(10, 10%) of the games it checked (the signature of an itch.io markup change rather than
a real wave of paid games); withheld games stay withheld in later runs until a healthy check or
an explicit `allow_mass_removal` dispatch, checkpoints of an interrupted scan never remove games,
and `apply_patch.py` re-checks the limits. Overlapping scans can no longer undo each other's
newer checks.
- **Scan → patch → apply:** scanners emit a URL-keyed patch; [`apply_patch.py`](scripts/apply_patch.py)
applies it to the latest `main`, validates, and [`bash/commit_push.sh`](bash/commit_push.sh)
retries on push races. Concurrent writers (extension, workflows, future admin) no longer clobber
each other; checkpoints + an in-script deadline keep partial work.
- **Ingest** (`update.yml`, now runs as soon as the queue changes): canonical URLs, skips games in
the deleted log (the removed-then-re-added bug), retries transient failures (3 attempts at least
6 hours apart; rate limiting never counts) instead of dropping them, stamps `added_at`, and never
wipes links queued meanwhile. A dispatched `url` is processed first and kept in the queue until it
reaches a final outcome, and queued runs wait in FIFO order (`queue: max`) instead of replacing
each other.
- `force_update.yml` runs `refresh.py --full` in rotating batches (a full re-scrape no longer times out).
- Honest `FreeItchGamesBot` User-Agent, explicit 429 / Retry-After handling (capped), unbuffered
logs, run summaries, Discord alerts on failure / cancel / rate limit.
- `data_store.py` keeps games in their chunk and only writes changed bytes; `index.json` /
`count_history.json` change only when data does — no more no-op commits.
- New [`validate.py`](scripts/validate.py) (schema, canonical URLs, duplicates, index consistency)
gates every pipeline commit and runs in the new Python CI with a network-free pytest suite.
Normalized one invalid `safe_virus` value (`"y"` → `"Yes"`).
### Removed
- `lists/*.md` genre tables, `generate_md.py`, `generate_table.yml`, `deleted_games.txt`,
`log_deleted.*` — the catalog is web-only (freeitchgames.win).
- Telegram bot ingest (`bot-ingest.yml`, `game_via_bot` issue template) — retired.
- The web app's sign-in, editing, Add and Workflows pages, GPG signing, and the GitHub Pages
deployment (`deploy_webapp.yml`, `notify-deploy.yml`, `pages-redirect/`; Pages keeps serving the
redirect stub it last published).
- `notify-ci-failure.yml` (replaced by in-workflow notifications) and the old per-task bash wrappers.
### CI / security
- All actions SHA-pinned at current majors; `permissions: {}` by default with per-job grants;
reusable workflows pinned by SHA with only the secrets they need; script-injection patterns in
`announce-discussion.yml` fixed (and it now posts only for `CHANGELOG.md` changes).
- Release: one `create-release` job makes the draft that desktop (tauri-action v1, `releaseId`) and
Android upload into; release builds use no dependency caches. Publish with
`gh release edit vX --draft=false`.
- `.github/dependabot.yml` (npm / pip / actions / cargo), Python and web-app PR checks, and an
hourly check of main's latest Cloudflare Workers Build that posts each failed build to Discord
once (a `check_run` relay would miss the pipeline's own data commits).
- One refresh pipeline (scan → apply) runs at a time, so overlapping refresh / force-update runs
can't undo each other.
- Cancelling a refresh / force-update or a desktop release run now really stops it (`!cancelled()`
instead of `always()` on the push / build jobs).
### Changed
- The old GitHub Pages address serves a redirect stub that forwards to freeitchgames.win
(keeping `#/` routes) and deletes the old app's token and key storage on that origin.
- Security headers in [`webapp/public/_headers`](webapp/public/_headers) (CSP, Referrer-Policy,
frame denial, Permissions-Policy, COOP) and immutable caching for hashed `/assets/*`.
- Pipeline logs are unbuffered UTF-8.
## [3.9.0] - 2026-06-15 (Android minSdk → 11 / API 30)
### Changed
- **Android APK floor raised from API 24 (Android 7.0) to API 30 (Android 11).**
`minSdkVersion` in [`webapp/src-tauri/tauri.conf.json`](webapp/src-tauri/tauri.conf.json)
`bundle.android` is now `30`. Because Android's package installer refuses any APK whose
`minSdkVersion` exceeds the device API level, this **is** the install block — the app simply
can't install on Android < 11 ("app not installed / incompatible"); no runtime check by design.
Rationale, stated honestly:
- **Not a JS-feature floor** — the System WebView is independently updatable down to API 24, so
SubtleCrypto / OpenPGP.js / IndexedDB / ES2020 already work on older OSes. That's not the
binding constraint.
- **Security + patch availability** — Android 11 added scoped-storage enforcement, one-time /
auto-reset permissions, and a tighter sandbox; pre-11 releases are also off Google's AOSP
monthly Security Bulletins (Android 10 ended 2023-03-06, Android 11 ended 2024-02-05; only
14 / 15 / 16 remain as of mid-2026).
- **Tested range** — we validate only on Android 11+ (emulator 11 → latest; real phone
vivo 1907 / Android 12 — see [`docs/pc_spec.md`](docs/pc_spec.md)). Shipping an untested floor
was the real risk.
- **Reach cost is small** — API 30+ ≈ 86.9% of active devices (was 96.6% at API 24); only the
pre-2020 long tail is dropped.
Data sources: [endoflife.date/android](https://endoflife.date/android),
[Android Security Bulletins](https://source.android.com/docs/security/bulletin),
[StatCounter version share](https://gs.statcounter.com/android-version-market-share/mobile/worldwide/) (May 2026),
[apilevels.com](https://apilevels.com/) (StatCounter cumulative distribution, Apr 2026).
### Notes
- `versionCode` re-derives to `3009000` (gotcha #18). The web and desktop builds are unaffected by
the Android floor. The `about.ts` version bump busts the IndexedDB catalog cache (harmless).
## [3.8.0] - 2026-06-15 (Android APK target 📱)
### Added
- **Android APK build & packaging via Tauri mobile.** The same React + Tauri app now ships as a
sideloadable **arm64-v8a `.apk`** (no Play Store), built and **post-signed** (`zipalign` →
`apksigner`) by [`.github/workflows/release_android.yml`](.github/workflows/release_android.yml)
and attached to the same draft Release as the desktop installers (manual `workflow_dispatch`
uploads it as a downloadable workflow artifact instead). `gen/android` stays gitignored — signing
is a post-build step, not a Gradle edit. New repo secrets: `ANDROID_KEYSTORE_BASE64` /
`ANDROID_KEYSTORE_PASSWORD` / `ANDROID_KEY_ALIAS`. Full build/signing docs in
[`webapp/TAURI.md`](webapp/TAURI.md).
- **Mobile UX** — the Android hardware / gesture back button is wired to in-app router history
(`useBackButton`), safe-area insets are respected, and the sidebar shows a platform-aware badge
("Mobile app" / "Desktop app").
- Added dependency: `@tauri-apps/api`.
### Changed
- **Bundle `identifier` is now alphanumeric** — `com.poli0981.freegamesitchio` (was the hyphenated
`com.poli0981.free-games-itchio-webapp`). Android rejects hyphens in the app id (`android init`
panics) and Tauri's validator rejects underscores, so alphanumeric is the only form valid on
both. Tauri uses one identifier across all platforms, so this also changed the **desktop** bundle
ID (a one-time OS-level reinstall).
- **Realigned versions** — `tauri.conf.json` / `Cargo.toml` / `about.ts` set to `3.8.0` (was a
long-standing `0.1.1` vs `3.x` drift), so `versionCode` / `versionName` are sensible and
monotonic.
### Notes
- CI: the Android JDK setup must **not** use `cache: gradle` — `gen/android` is gitignored and
generated mid-job, so there are no gradle files at checkout to key on (it hard-fails). rust-cache
+ npm cache still apply.
## [3.7.1] - 2026-06-14 (Hotfix — desktop build vs invalid Tauri NSIS license key)
### Fixed
- **v3.7.0's desktop installers never built.** The NSIS EULA was wired via
`bundle.windows.nsis.license`, but `@tauri-apps/cli` 2.11.0's `NsisConfig`
has no `license` key (it was added in a later release), so every platform
failed config validation at the `Build Tauri app` step. Switched to the
top-level `bundle.licenseFile` (valid in 2.11.0) pointing at an **RTF** EULA
([`webapp/src-tauri/installer/EULA.rtf`](webapp/src-tauri/installer/EULA.rtf)).
RTF satisfies **both** Windows bundlers — WiX (`.msi`) requires RTF and NSIS
(`.exe`) auto-detects it — so both installers show the "I Agree" page. The
previous plain-text `EULA.txt` would also have broken the WiX/`.msi` build.
### Notes
- Web feature set is identical to v3.7.0 (which deployed fine); this tag exists
to produce the desktop installers. `about.ts` version bump also busts the
IndexedDB catalog cache, which is harmless. No Tauri version bump
(`tauri.conf.json` stays `0.1.1`).
## [3.7.0] - 2026-06-14 (Legal-acceptance gates + per-tab chart lazy-loading)
### Added
- **First-launch legal-acceptance gate** — on first visit (and in every fresh
incognito session, since `localStorage` starts empty there) the app shows a
full-screen, non-dismissible gate before the main UI. It links the License,
EULA, Privacy Policy, Disclaimer, Terms of Use, Code of Conduct, and Security
Policy (reusing `LEGAL_LINKS`), and requires ticking a checkbox to continue.
New component [`webapp/src/components/legal-gate.tsx`](webapp/src/components/legal-gate.tsx),
built on raw Radix Dialog primitives (focus-trapped, no close-X, Esc /
outside-click disabled). Acceptance persists as `acceptedLegalVersion` in the
existing `webapp.prefs` localStorage blob — **no cookie** (consistent with the
"no cookies" privacy stance). A `LEGAL_VERSION` constant
([`webapp/src/stores/prefs.ts`](webapp/src/stores/prefs.ts)) lets a future
policy edit re-prompt every user with a one-line bump.
- **Windows installer EULA page** — both Windows installers (the NSIS `.exe`
and the WiX `.msi`) now show an "I Agree" license step before installing,
wired via the top-level `bundle.licenseFile` →
[`webapp/src-tauri/installer/EULA.rtf`](webapp/src-tauri/installer/EULA.rtf).
RTF is used so both bundlers render it (WiX requires RTF; NSIS auto-detects
it). The in-app gate above covers first-run consent on macOS / Linux, whose
installers have no equivalent step.
### Changed
- **Charts route split into four lazy per-tab chunks**
([`webapp/src/components/charts/tabs/`](webapp/src/components/charts/tabs)).
Each tab imports its chart components directly (the `charts/index.ts` barrel
was removed so the bundler keeps each tab's components in its own chunk).
Result: only the default **Overview** tab's components load when `/charts`
opens; the Reach / Quality / Discovery component code downloads on first
click. Recharts itself (the ~380 KB `vendor-charts` chunk) still loads with
Overview — unavoidable since the default tab renders charts — but it was
already deferred to the lazy `/charts` route, so it never touches app startup.
- `about.ts` version → 3.7.0 (also busts the IndexedDB catalog cache, harmless);
Claude Code co-author credit updated to Opus 4.8.
### Notes
- Images, routes, and OpenPGP were already lazy-loaded; this release closes the
remaining gap (charts). No Tauri version bump (`tauri.conf.json` stays
`0.1.1`) — the NSIS license is a bundler-config addition, not a binary change.
## [3.6.1] - 2026-06-12 (Hotfix — desktop build vs broken `time` 0.3.48)
### Fixed
- **v3.6.0's desktop installers never built**: `time` 0.3.48 (released
2026-06-12, hours before the v3.6.0 tag) fails to compile inside
`tauri-utils` with `E0119: conflicting implementations of trait From<…>`
([time-rs/time#783](https://github.com/time-rs/time/issues/783)). Since no
`Cargo.lock` is committed, CI resolved the broken release fresh.
`webapp/src-tauri/Cargo.toml` now pins `time = "=0.3.47"` (the version every
release through v3.5.2 built with) — remove the pin once the upstream fix
ships.
### Notes
- Web feature set is identical to v3.6.0; this tag exists to produce the
desktop installers. `about.ts` version bump also busts the new IndexedDB
catalog cache, which is harmless.
- No Tauri version bump (`Cargo.toml` / `tauri.conf.json` stay `0.1.1`) — a
dependency pin to the previously-resolved version changes no binary
behavior.
## [3.6.0] - 2026-06-12 (i18n EN/VI + offline cache + custom error pages)
### Added
- **Bilingual UI (English / Tiếng Việt)** — a minimal typed i18n layer
([`webapp/src/lib/i18n/`](webapp/src/lib/i18n)) with ~340 keys covering every
route, dialog, chart, and toast. The Vietnamese dictionary is a **lazy-loaded
chunk**: it is only downloaded the first time the language is switched to VI
(or on startup when VI is the persisted preference). Switcher lives in
Settings → Appearance; the preference persists in `webapp.prefs`.
- **Offline-first catalog cache** — the react-query cache for the public
catalog queries (`db`, `deleted`, `count-history`) now persists to
**IndexedDB** (`@tanstack/react-query-persist-client` +
`@tanstack/query-async-storage-persister` + `idb-keyval`). Revisits paint
instantly from cache (~2 MB of JSON no longer re-downloaded cold) and
revalidate in the background. Cache busts automatically on each release
(`buster = APP.version`, `maxAge` 7 days). PAT-gated data is never persisted.
- **Custom error pages** — a status-aware
[`ErrorPage`](webapp/src/components/error-page.tsx) (400, 401, 403, 404, 408,
419, 429, 500, 502, 503, 504, offline, unknown) wired into every route's
error branch with the *real* HTTP status (`fetchRaw` now throws a typed
`HttpError`), plus:
- a route-level **ErrorBoundary** that detects stale-chunk failures after a
redeploy and offers a one-click reload ("New version available"),
- a hidden `/#/errors/:code` preview route,
- a static `webapp/public/404.html` served by
GitHub Pages for bad path URLs (bilingual, dark-mode aware, zero JS).
### Changed
- `ReactQueryDevtools` is now explicitly gated behind `import.meta.env.DEV`.
- Game thumbnails render through a shared
[`GameThumb`](webapp/src/components/game-thumb.tsx) that falls back to the
muted placeholder when a cover 404s; the Settings avatar is now lazy-loaded.
- `idb-keyval` returns (removed as unused in v3.5.2 — it has a real consumer
now); `THIRD_PARTY` in `about.ts` lists the three new data-layer deps.
### Notes
- The About page's legal/credits data intentionally stays English (controlling
language for legal interpretation); Vietnamese policy docs remain under
[`docs/i18n/vi/`](docs/i18n/vi).
- No Tauri / Rust binary boundary change — `Cargo.toml` / `tauri.conf.json`
stay at `0.1.1`.
## [3.5.2] - 2026-05-23 (Dead-code cleanup — knip + vulture)
### Added
- **knip** (v6) wired into the webapp as the unused-files / exports /
dependencies detector — config in [`webapp/knip.json`](webapp/knip.json),
run via `cd webapp && npm run knip`.
- **vulture** configured for the Python pipeline (`[tool.vulture]` in
[`pyproject.toml`](pyproject.toml)) — it catches dead functions, classes, and
attributes that ruff's `F` rules don't.
- **[`docs/THIRD_PARTY.md`](docs/THIRD_PARTY.md)** — a new doc attributing the
dev-only tooling (knip, vulture, ruff, ESLint, TypeScript), cross-linked from
[`docs/ACKNOWLEDGEMENTS.md`](docs/ACKNOWLEDGEMENTS.md).
### Removed
- **8 unused webapp dependencies**: `react-hook-form`, `@hookform/resolvers`,
`zod`, `idb-keyval`, `@radix-ui/react-dropdown-menu`,
`@radix-ui/react-tooltip`, `@tauri-apps/plugin-http`, `@tauri-apps/api`.
- **The unwired Tauri Phase-8b scrape-preview scaffold** —
`webapp/src/lib/tauri-scrape.ts` and `getRuntimeInfo` / `RuntimeInfo` in
[`runtime.ts`](webapp/src/lib/runtime.ts). It was documented but never wired
into any UI; [`webapp/TAURI.md`](webapp/TAURI.md) was trimmed to match.
- **~20 unused webapp exports / types** — dead helpers (`findChunkFor`,
`indexByUrl`, `rawUrl`, `useIndex`, `isIdleExpired`, …), the unused
`EDITABLE_FIELDS` / `READONLY_FIELDS` constants, and 7 unused shadcn/ui
primitive exports. Exports used only inside their own module were demoted
from `export` rather than deleted.
### Changed
- `webapp/src/lib/about.ts` `THIRD_PARTY` array trimmed to match the removed
dependencies.
### Notes
- DX / code-quality only — no runtime behaviour change. `isIdleExpired` was
already dead (nothing called it), so PAT idle auto-lock is unchanged — still
not enforced.
- No Tauri / Rust binary boundary change — `Cargo.toml` and `tauri.conf.json`
stay at `0.1.1`. The Rust `tauri-plugin-http` crate is now unreferenced from
the front-end — a candidate for a future Rust-side cleanup.
- knip + vulture join `npm run lint`, `ruff check`, and `npm audit` as the
standing pre-release QA pass.
## [3.5.1] - 2026-05-20 (Lint cleanup — zero ESLint problems)
### Changed
- **`npm run lint` now runs clean — 0 errors, 0 warnings** (down from 17 errors + 5 warnings, all pre-existing; v3.5.0 added none).
- [`webapp/eslint.config.js`](webapp/eslint.config.js): `react-refresh/only-export-components` is turned off for `src/components/ui/**` — the vendored shadcn primitives intentionally mix component and variant/constant exports and cannot satisfy the rule without forking upstream. The rule stays on for all other app code.
- `react-hooks/incompatible-library` is turned off — it only flagged TanStack Table's `useReactTable`, whose API is not React-Compiler-memoizable by design (not actionable).
- **`SortableHeader` extracted** into its own [`webapp/src/components/data-table/sortable-header.tsx`](webapp/src/components/data-table/sortable-header.tsx); [`columns.tsx`](webapp/src/components/data-table/columns.tsx) is now a pure column-definition module.
### Fixed
- **`react-hooks/exhaustive-deps`** in [`routes/games.tsx`](webapp/src/routes/games.tsx) and [`data-table/faceted-filter.tsx`](webapp/src/components/data-table/faceted-filter.tsx): values built with `?? []` created a fresh array every render, defeating the `useMemo`s that depended on them. `data` is now wrapped in `useMemo`; the faceted-filter `selected` memo was restructured to depend on a stable value.
### Notes
- DX / code-quality only — no runtime behaviour change. No Tauri / Rust binary change (`Cargo.toml` / `tauri.conf.json` stay `0.1.1`); no `THIRD_PARTY` change.
---
## [3.5.0] - 2026-05-20 (Charts expansion + game-count history + pipeline cleanup)
### Added
- **Six new charts on `/charts`.**
- **Game count over time** — a `LineChart` of the catalog size by day, backed by a new `data_game/count_history.json` (date-keyed `{date, total}` series). [`scripts/data_store.py`](scripts/data_store.py) `_append_count_history()` upserts today's total on every catalog write (last-write-wins per UTC day). `scripts/backfill_count_history.py` is a one-time dev tool that reconstructs the series from git history (`data_game/index.json`, plus the pre-refactor `scripts/game_info.json`). The webapp loads it via `loadCountHistory` / `useCountHistory`.
- **Genre treemap** — a Recharts `Treemap` with a custom cell renderer that hides labels on rectangles too small to fit them, so it stays legible on mobile.
- **KPI summary cards** — total games / online / NSFW / deleted / average rating, above the Overview grid.
- **Deletions over time** (bar, by month), **Deletion reasons** (pie: became-paid vs page-removed), and **Most rated games** (top 10 by `rating_count`).
- **Scroll-to-top button** — a floating bottom-right button that appears after scrolling the main pane. New [`webapp/src/components/scroll-to-top.tsx`](webapp/src/components/scroll-to-top.tsx).
- **Python linting** — `ruff` config in a new root `pyproject.toml`; run `ruff check scripts/`.
### Changed
- **`charts.tsx` split into a module.** The monolith is now a `webapp/src/components/charts/` folder — one file per chart, a shared `chart-card.tsx` (`ChartCard` + `PALETTE`), and an `index.ts` barrel. 16 charts across the 4 tabs.
- **`scripts/json_io.py`** — new shared module. `load_json` / `save_json` (previously copy-pasted into both `check_alive.py` and `check_paid.py`) live here now, alongside `dedup_deleted`.
- README + README.vi badges bumped to `3.5.0`.
### Fixed
- **The deleted-games log can no longer accumulate duplicate URLs.** `check_alive.py` and `check_paid.py` appended to `scripts/deleted_games.json` with no guard — a game removed, re-added by the scraper, then removed again would be logged twice. The new `dedup_deleted()` (keyed by URL, keeping the earliest `deleted_at`) runs on every write and inside `log_deleted.py`. Two genuinely different games that share a title but have different urls are kept separate.
### Notes
- No Tauri / Rust binary boundary change — `Cargo.toml` and `tauri.conf.json` stay at `0.1.1`, no `THIRD_PARTY` entries change (Recharts already shipped; `Treemap` / `LineChart` need no new dependency).
- `data_game/count_history.json` is auto-committed by the scrape workflows — the bash wrappers already `git add data_game/` wholesale, so no workflow changes were needed.
- The dead-code sweep found the project already tidy (TS strict mode + ESLint catch unused webapp code). `webapp/src/lib/tauri-scrape.ts` `tauriScrapePreview` was reviewed and intentionally kept as a Phase-8b stub.
---
## [3.4.1] - 2026-05-17 (Hotfix: DataTable column alignment + Discussion-announce auto-discovery)
### Fixed
- **DataTable columns misaligned at desktop widths.** Header used native table-layout (`<table className="w-full">` + `<th style={{width}}>`) while body rows used flex layout (`position: absolute` + `flex w-full`, cells with `flex: 0 0 Npx` / `1 1 0`). Native table-layout stretched the 8 size-less columns to fill the container based on content, but the absolutely-positioned body `<tr>` never participated in table layout — so its flex children stayed at their fixed flex-basis. Result: at the Tauri default 1280×800 window (and any viewport wider than the natural sum of header content widths) header columns drifted off the cells below them. [`webapp/src/components/data-table/data-table.tsx`](webapp/src/components/data-table/data-table.tsx) now renders the header `<tr>` with `flex w-full` and each `<th>` with `flex h-10 items-center` + the same `flex: 0 0 Npx` / `1 1 0` style block as the body `<td>` — header and body now compute width identically. Helper `priorityHeaderClass` (which emitted `table-cell` variants) is gone; the existing `priorityClass` (`flex` variants) now drives both. No change to column definitions in [`columns.tsx`](webapp/src/components/data-table/columns.tsx).
- **`announce-discussion.yml` was a silent no-op since v3.2.0.** Both jobs (`announce-release`, `announce-docs`) gated on three repo variables (`DISCUSSION_REPO_ID`, `DISCUSSION_ANNOUNCEMENTS_CATEGORY_ID`, `DISCUSSION_GENERAL_CATEGORY_ID`) that had never been configured — the validation step printed `::warning::… Skipping.` and `exit 0`, so every release silently failed to post to Discussions without surfacing a failed run. Replaced the two validation steps with a `Discover Discussion IDs` step that queries `gh api graphql` for `repository.id` and looks up the category by slug (`announcements` / `general`). Zero config now — works on any repo with Discussions enabled. Fails loudly with a clear `::error::` message if Discussions isn't enabled or the expected category is missing. Dropped the dependency on `vars.DISCUSSION_*` and removed every `if: steps.validate.outputs.ids_ok == 'true'` gate.
### Changed
- **README + README.vi badges** bumped to `3.4.1`.
### Notes
- This is a webapp + CI hotfix. No Python pipeline changes, no Tauri / Rust binary boundary change — `Cargo.toml` and `tauri.conf.json` stay at `0.1.1`, no THIRD_PARTY entries change.
- The leftover `DISCUSSION_REPO_ID` / `DISCUSSION_ANNOUNCEMENTS_CATEGORY_ID` / `DISCUSSION_GENERAL_CATEGORY_ID` repo variables (if you set them earlier) are now unused and can be removed from Settings → Variables.
---
## [3.4.0] - 2026-05-16 (Periodic refresh workflows + UTF-8 round-trip fix)
### Added
- **Update reviews — bi-weekly workflow.** New `scripts/update_reviews.py`, wrapper `bash/update_reviews.sh`, and `.github/workflows/update_reviews.yml` re-scrape every existing game's itch.io page on the 1st and 15th of each month (05:00 UTC) and write fresh `rating` + `rating_count`. Network errors / 404 keep the old values. Touches only those two fields — everything else (annotations, metadata) is left alone.
- **Update status — monthly workflow.** New `scripts/update_status.py`, `bash/update_status.sh`, and `.github/workflows/update_status.yml` refresh the `status` field on the 1st of each month (06:00 UTC). Same skip-on-error semantics.
- **Force update — manual emergency button.** New `scripts/force_update.py`, `bash/force_update.sh`, and [`.github/workflows/force_update.yml`](.github/workflows/force_update.yml) accept an optional `url` input. Empty input re-scrapes every game; a single URL targets just that one. `workflow_dispatch` only — no schedule. Every run preserves the three user-editable annotations (`safe_virus`, `notes`, `nsfw`) per the read/write field convention in [CLAUDE.md](CLAUDE.md). Doubles as the canonical repair tool for mojibake left by older webapp commits — re-scrape pulls clean UTF-8 from itch.io.
- **`generate_table.yml` chained on the three new workflows** so `lists/*.md` stay in sync after any data mutation.
### Fixed
- **UTF-8 mojibake on webapp commits.** `webapp/src/lib/github/contents.ts` `readFileWithSha` and `webapp/src/lib/github/git-data.ts` `bulkDeleteGames` were decoding GitHub's base64 content with `atob` alone, producing a Latin-1 binary string. Multi-byte UTF-8 sequences (e.g. Vietnamese `ã` = `0xC3 0xA3`) became two Latin-1 code points (`ã`); the next write re-encoded them as UTF-8 bytes, double-corrupting on every edit. Confirmed live damage in `data_game/game_info_002.json` (`BotÃÂão Esquerdo` was originally `Botão Esquerdo`). Extracted a shared helper `webapp/src/lib/github/encoding.ts` (`base64ToUtf8` / `utf8ToBase64`) that uses `TextDecoder('utf-8')` / `TextEncoder` and routes both call sites through it. Write path was already correct.
### Notes
- **Repair existing mojibake**: after this release deploys, run `Force update` once via `workflow_dispatch` with no input. It re-scrapes every game (~15–25 min) and writes back clean UTF-8 while preserving manual annotations. `generate_table.yml` will then auto-regenerate the markdown lists.
- **Browser cache**: anyone editing via the webapp should hard-refresh once after the new build lands so they're not using the pre-fix bundle (which would continue to mangle non-Latin chars on the next edit).
- **README + README.vi badges** bumped to `3.4.0`. No Tauri / Rust binary change — `Cargo.toml` and `tauri.conf.json` stay at `0.1.1`.
---
## [3.3.0] - 2026-05-16 (Mobile polish + Settings + in-browser GPG commit signing)
### Added
- **In-browser GPG commit signing.** Every write the webapp makes (single-file edits, bulk edit/delete, queueing URLs) can now be GPG-signed client-side. New `webapp/src/lib/gpg/` module: `canonicalize.ts` builds the exact byte string Git would hash, `sign.ts` lazy-imports `openpgp` and exposes `loadPrivateKey` / `signCommit` / `verifyDetached`, `storage.ts` wraps localStorage helpers. Verified byte-for-byte against `git cat-file commit <sha>` so the signed canonical exactly matches what GitHub will recompute (no trailing-newline drift). Private keys are decrypted once at import and re-encrypted with the webapp passphrase (AES-GCM, same scheme as the PAT) — `openpgp` is loaded only when the Commit Signing card is opened or a commit is being signed (`vendor-openpgp` chunk, ~129 KB gz, lazy).
- **Settings → Commit signing card.** New `webapp/src/components/settings/gpg-card.tsx` — three states (not configured / locked / unlocked) with Import (paste armored or upload `.asc`), Unlock, Test sign (round-trip verify), Copy public key, Lock, Remove. Shows the imported key's UIDs as badges and flags a clear mismatch warning if the configured commit-author email isn't in the key's UID list (the most common cause of GitHub's "Someone may be trying to trick you" warning). After import, primary UID email auto-populates Commit author so commits Verify on the first try.
- **Settings Phase A — Appearance / Session / Commit author / Notifications cards.** [`webapp/src/routes/settings.tsx`](webapp/src/routes/settings.tsx) gained four new cards backed by extended preferences in [`webapp/src/stores/prefs.ts`](webapp/src/stores/prefs.ts): theme picker (Light / Dark / System), layout density (Normal / Compact), sidebar collapse mirror, idle-timeout slider (5 / 15 / 30 / 60 / 120 min — replaces the hard-coded 30-min constant in `auth.ts`), commit-author name/email override, toast enable + duration. Density applies via `html[data-density='compact']` rules in [`index.css`](webapp/src/index.css); toasts are gated through a new [`AppToaster`](webapp/src/components/app-toaster.tsx) wrapper that reads prefs.
- **Mobile card view for the games table.** New [`webapp/src/lib/use-is-mobile.ts`](webapp/src/lib/use-is-mobile.ts) (`matchMedia('(max-width: 767px)')`) and [`webapp/src/components/data-table/mobile-card-list.tsx`](webapp/src/components/data-table/mobile-card-list.tsx). Below the `md` breakpoint, [`DataTable`](webapp/src/components/data-table/data-table.tsx) renders a stacked card list (thumbnail + name + dev + genre/status/NSFW/safe badges, tap-to-detail, selection checkbox) instead of the 9-column virtualized table that overflowed at 430 px. Pagination is shared between both views.
- **Workflows route mobile fallback.** `workflows.tsx` now dual-renders the action picker — a `<Select>` dropdown below `md`, the existing `TabsList` at `md` and above. Fixes the overflow from five `whitespace-nowrap` triggers in an `inline-flex` TabsList at 430 px viewport.
### Changed
- **All write paths route through the Git Data API.** `webapp/src/lib/github/contents.ts` `putFile` (`PUT /repos/.../contents/{path}`) is gone — that endpoint authors commits as the PAT and never accepts a `signature` field. Replaced with `commitSingleFile` which delegates to `atomicCommit` so single-file edits (game annotations, `temp_link.json` queue) get the same signer plumbing as bulk operations. `atomicCommit` gained an optional `signer` parameter (defaulting to `getSignerIfEnabled()`) that, when present, builds the canonical commit object, signs detached binary-mode via openpgp, and passes `author` / `committer` / `signature` to `git.createCommit`. Commit author identity falls back through prefs override → imported key's primary UID email → GitHub user.
- **About page** lists `OpenPGP.js` 6.3 under Data dependencies; the [`webapp/vite.config.ts`](webapp/vite.config.ts) `manualChunks` rule emits a dedicated `vendor-openpgp` chunk so the cost is only paid when a user opens the signing card.
- **README + README.vi badges** bumped to `3.3.0`.
### Fixed
- **Workflows `/workflows` tabs no longer overflow on mobile.** Pre-fix: five `whitespace-nowrap` triggers in an `inline-flex` TabsList blew past a 430 px viewport.
- **DataTable no longer overflows on mobile.** Pre-fix: nine fixed-width columns minus three responsive-hidden ones still exceeded 430 px.
---
## [3.2.1] - 2026-05-11 (Hotfix: single-instance enforcement on desktop)
### Fixed
- **Desktop app spawned a new process on every launch.** Each double-click of the installed app added another `free-games-itchio-webapp.exe` (Windows) / equivalent on macOS+Linux to the task list instead of focusing the existing window. Added [`tauri-plugin-single-instance`](https://tauri.app/plugin/single-instance/) v2 in [`webapp/src-tauri/src/lib.rs`](webapp/src-tauri/src/lib.rs) — second launch now unminimizes + focuses the running window and exits its own process before creating a duplicate. Plugin registered first in the builder chain per Tauri 2 docs so duplicate processes die before initializing HTTP/opener plugins. Gated by `#[cfg(desktop)]` + matching `cfg(not(android, ios))` in [`Cargo.toml`](webapp/src-tauri/Cargo.toml). Desktop binary boundary change → bumped [`Cargo.toml`](webapp/src-tauri/Cargo.toml) and [`tauri.conf.json`](webapp/src-tauri/tauri.conf.json) from `0.1.0` to `0.1.1` (first time these have moved since v3.0.0).
### Changed
- **README + README.vi badges** bumped to `3.2.1`.
- **About page** lists `tauri-plugin-single-instance` v2 under Desktop dependencies.
---
## [3.2.0] - 2026-05-10 (CI cleanup + mobile + SEO + Telegram bot path + auto-discussion)
### Added
- **Mobile drawer navigation.** New [`webapp/src/components/ui/sheet.tsx`](webapp/src/components/ui/sheet.tsx) (shadcn pattern over the existing `@radix-ui/react-dialog`) and a `MobileTopBar` in [`webapp/src/components/sidebar.tsx`](webapp/src/components/sidebar.tsx). Below `md`, the sidebar collapses behind a hamburger; above, the desktop sidebar behaves as before. Touch targets in the nav now meet the 44pt iOS HIG minimum on small screens.
- **DataTable column priorities.** Each column declares `meta.priority: 1 | 2 | 3` in [`columns.tsx`](webapp/src/components/data-table/columns.tsx). [`data-table.tsx`](webapp/src/components/data-table/data-table.tsx) hides priority 2 below `md` and priority 3 below `lg`, so the table is usable on a phone without horizontal scrolling through every column.
- **PWA manifest + icons.** [`webapp/public/manifest.webmanifest`](webapp/public/manifest.webmanifest), [`icon-192.png`](webapp/public/icon-192.png), [`icon-512.png`](webapp/public/icon-512.png) — Add to Home Screen on iOS without a service worker. Generator script: [`webapp/scripts/gen_assets.py`](webapp/scripts/gen_assets.py).
- **SEO infrastructure.** [`webapp/index.html`](webapp/index.html) now ships description, theme-color (per scheme), Open Graph (title/description/image/url/type/locale), Twitter card (`summary_large_image`), `canonical`, `apple-touch-icon`, `manifest`, and `preconnect` to `img.itch.zone` + `raw.githubusercontent.com`. [`robots.txt`](webapp/public/robots.txt) and `sitemap.xml` added under `webapp/public/`.
- **OG image.** [`webapp/public/og.png`](webapp/public/og.png) (1200×630) + [`og.webp`](webapp/public/og.webp) generated by `gen_assets.py`. Brand-coloured (`#863bff` purple, cyan accent) with project name, tagline, and URL.
- **Per-route titles.** New [`useDocumentTitle`](webapp/src/hooks/useDocumentTitle.ts) hook (no `react-helmet-async` dependency). Each route now sets a contextual title (`Charts — Itch.io Free Games Database`, etc.); game-detail uses the game name.
- **Hash-anchor scroll.** [`App.tsx`](webapp/src/App.tsx) now wires a `ScrollToHash` listener so links like `/about#support` scroll to the matching element under HashRouter.
- **About page Telegram entries.** New `messaging` social group with **Telegram (DM)** and **Telegram bot (game submission)** plus a privacy reminder to never paste a numeric ID into public channels. About also surfaces all five FUNDING.yml destinations (GitHub Sponsors, Patreon, Ko-fi, Buy Me a Coffee, PayPal) with a footnote on PayPal explaining the legal-name receipt.
- **Sidebar Support link.** Persistent heart-icon link from the sidebar (collapsed and expanded) to `/about#support`.
- **Telegram bot contribution flow.** `CONTRIBUTING.md §1b` describes the bot path (DM owner → numeric ID added to local whitelist → bot dispatches `bot-ingest.yml`). Cross-linked from [README.md](README.md), [README.vi.md](README.vi.md), and the new issue template `game_via_bot.yml`. Vietnamese mirror in [`docs/i18n/vi/CONTRIBUTING.md`](docs/i18n/vi/CONTRIBUTING.md).
- **Privacy + ToS clauses for the bot path.** [`docs/ToS.md §14`](docs/ToS.md) and [`docs/PrivacyPolicy.md §15`](docs/PrivacyPolicy.md) (plus VI mirrors) document Telegram-ID handling: opt-in, operator-side whitelist only, never committed to this repo, removable on DM.
- **`docs/pc_spec.md` + `docs/dev_env.md` (EN + VI).** Maintainer hardware spec, mobile test devices (iPhone 14 Pro / 13 Pro Max, iOS 26.x on Chrome + Brave), and dev-env toolchain (Python 3.12, Node ≥ 22, Rust stable, JetBrains 2026.x). Cross-linked from README and CONTRIBUTING.
- **Auto-create GitHub Discussion workflow.** [`announce-discussion.yml`](.github/workflows/announce-discussion.yml) — on `release: published` posts to the **Announcements** category; on push to `docs/**` / `CHANGELOG.md` / `README*.md` posts to **General**, gated by `[skip-discuss]` in the head-commit message and a quiet skip on `bot-ingest:` commits. Uses `gh api graphql` directly (no third-party action). Setup: configure repo variables `DISCUSSION_REPO_ID`, `DISCUSSION_ANNOUNCEMENTS_CATEGORY_ID`, `DISCUSSION_GENERAL_CATEGORY_ID` (run the GraphQL pre-flight query in the workflow header to fetch them).
### Changed
- **CI notify wrappers.** `notify-ci-failure.yml`, `notify-deploy.yml`, and [`notify-release-pipeline.yml`](.github/workflows/notify-release-pipeline.yml) replace `workflows: ["*"]` with explicit allowlists. Every workflow run no longer fans out to all three wrappers; the Actions tab is much quieter and the per-event reusable filtering is what it always should have been.
- **`bot-ingest.yml` cleanup.** Removed a dead final step that referenced a non-existent `${{ secrets.BOT_TOKEN }}` and a `result.txt` file. The Python `success`/`failure` Telegram callback steps above already handle both outcomes.
- **Image hints.** Game thumbnails in [`columns.tsx`](webapp/src/components/data-table/columns.tsx) and the hero in [`game-detail.tsx`](webapp/src/routes/game-detail.tsx) now declare `width`/`height` (CLS), `decoding="async"`, and `fetchPriority` (high for hero, low for table rows). itch.io thumbnails remain external — full WebP recompression is intentionally deferred (would require an image proxy).
- **About support card** mirrors `.github/FUNDING.yml` exactly: 5 entries (GitHub Sponsors, Patreon, Ko-fi, BMC, PayPal).
- **README + README.vi badges** bumped to `3.2.0`.
### Fixed
- **Bot ingest workflow** had a broken final telegram callback step (wrong secret name + missing input file). Removed; the working callback steps above are unaffected.
### Setup notes for maintainers (one-time, post-merge)
To enable the auto-discussion workflow, run once:
```sh
gh api graphql -f query='query{repository(owner:"poli0981",name:"free-games-itchio-list"){
id
discussionCategories(first:20){nodes{id slug name}}
}}'
```
Then in repo Settings → Secrets and variables → Actions → Variables, add:
- `DISCUSSION_REPO_ID` — the `repository.id` from the response.
- `DISCUSSION_ANNOUNCEMENTS_CATEGORY_ID` — the `id` of the Announcements category.
- `DISCUSSION_GENERAL_CATEGORY_ID` — the `id` of the General category.
Without these set, the workflow runs but no-ops with a warning (safe default).
---
## [3.1.4] - 2026-05-05 (Legal docs rewrite + Vietnamese i18n + Legal Card + UI polish)
### Added
- **Vietnamese translations** under [`docs/i18n/vi/`](docs/i18n/vi/) — full
translations of the four legal docs (DISCLAIMER, EULA, ToS, PrivacyPolicy)
plus CONTRIBUTING, CODE_OF_CONDUCT, and SECURITY. Each file notes that the
English version is the controlling text for legal interpretation.
- **`README.vi.md`** at repo root — Vietnamese mirror of the main README, with a
language badge and a link back to the English version.
- **About page → "Legal & policies" Card** — single place to access all policy
files (Disclaimer, EULA, ToS, Privacy, Code of Conduct, Security, License,
Changelog) plus a pointer to the Vietnamese translations.
- **`webapp/src/lib/about.ts`**: `LegalLink` interface + `LEGAL_LINKS` array +
`LEGAL_VI_INDEX_URL`. Same structured pattern as `THIRD_PARTY` and
`SOCIAL_LINKS`.
### Changed
- **`docs/DISCLAIMER.md`, `docs/EULA.md`, `docs/ToS.md`, `docs/PrivacyPolicy.md`**:
rewritten to be tighter and more enforceable while keeping the project's voice.
Each doc now has a TL;DR, numbered sections, definitions, severability,
governing law (Socialist Republic of Vietnam), explicit "not legal advice"
notice, and a removal-request path. Privacy Policy adds a per-storage table
for what the webapp persists locally and a step-by-step PAT lifecycle.
- **`README.md`** version badge → 3.1.4 plus a Vietnamese language badge and a
short pointer to `README.vi.md` and `docs/i18n/vi/`.
### Optional UI
- **Tauri desktop**: maximize button is now disabled (`maximizable: false` in
`webapp/src-tauri/tauri.conf.json`). Window is still resizable; only the
full-window-maximize action is locked.
- **DataTable**: scrollbar hidden via a new `.scrollbar-hide` Tailwind utility
added to `webapp/src/index.css`. Scrolling still works; the chrome is gone.
---
## [3.1.3] - 2026-05-05 (Credit Claude Code as AI co-author)
### Added
- **About page**: new **"AI co-authors"** Card listing both Grok (xAI) and
Claude Code (Anthropic — Claude Opus 4.7, 1M context) with their roles
in the repo's history. Each entry is linked + tagged with vendor and model.
- `webapp/src/lib/about.ts`: new `AiTool` interface + `AI_TOOLS` array so the
AI credit data is structured the same way as `THIRD_PARTY` and `SOCIAL_LINKS`.
### Changed
- **`docs/ACKNOWLEDGEMENTS.md`, `docs/My_Stuff.md`, `CONTRIBUTING.md`**:
surface Claude Code alongside Grok wherever the existing AI credit lived.
Grok references stay — both buddies share the workload now (Grok carried the
Python pipeline + v2.0.0 rewrite; Claude Code drove v3.0.0 webapp/Tauri and
v3.1.2). `My_Stuff.md` "The Real MVP" is now plural.
- `DEV.blurb` on the About page reflects the two-buddy reality.
---
## [3.1.2] - 2026-05-05 (Offline link fix + About expansion + docs sweep)
### Fixed
- **Tauri desktop**: external links (itch.io, GitHub, third-party home pages) now
open in the user's default browser instead of doing nothing. Added
`tauri-plugin-opener` (Rust + JS) and a scoped `opener:allow-open-url`
capability locked to `https://*` (no `file://` / `javascript:` schemes).
### Added
- **About page**: three new sections — Developer card, "Found a bug?" CTA that
opens the bug-report issue template, and "Find me elsewhere" with X, YouTube,
two Discord servers (Repo discussion / Game chat), Patreon, Ko-fi, Steam,
Bluesky, and Mastodon.
- **`<ExtLink>`** ([`webapp/src/components/ext-link.tsx`](webapp/src/components/ext-link.tsx))
— runtime-aware external-link wrapper used app-wide so the offline link bug
can't recur. On web it renders a plain `<a target="_blank">`; on Tauri it
routes through `tauri-plugin-opener`. All existing external `<a>` tags in
About, the sidebar footer, and Game Detail now use it.
### Changed
- **`webapp/README.md`**: rewritten from Vite boilerplate to actual webapp docs
(routes, dev/build commands, code-split layout, deploy, Tauri reference).
- **`CONTRIBUTING.md`, `docs/ACKNOWLEDGEMENTS.md`, `docs/My_Stuff.md`,
`README.md`**: refreshed contact / social handles. The "if I ever make a
Discord" line is finally obsolete — both servers exist.
---
## [3.0.0] - 2026-05-04 (Webapp + Desktop 🖥️📊)
A React + TypeScript SPA on top of the same JSON catalog, plus a Tauri 2 desktop wrapper.
The Python pipeline from 2.0.0 is untouched and still drives the daily data updates.
### Added (Webapp)
- **`webapp/`** — Vite + React 19 + TypeScript 6 + Tailwind v3 + shadcn/ui (Radix primitives).
Code-split, ~163 KB gzip initial load. Reads from `raw.githubusercontent.com` (public, no auth);
writes use a fine-grained GitHub PAT held only in memory after passphrase unlock.
- **8 routes**: Dashboard (KPIs), Games (virtualized DataTable + faceted filters), Game Detail
(23-field read view + edit form for `safe_virus` / `notes` / `nsfw`), Add (single URL +
bulk), Charts (9 Recharts visualizations in 4 tabs), Workflows (run history + Dispatch),
Deleted (tombstone log), Settings (PAT + theme), About (license attribution).
- **PAT encryption** — AES-GCM 256-bit, PBKDF2-SHA256 (100k iterations) with per-token salt.
Encrypted blob in localStorage; decrypted token in memory only.
- **Atomic bulk operations** — Bulk edit / delete via GitHub Git Data API (single commit for N
files), 20-entry undo stack with one-click revert.
- **Workflow dispatch from UI** — Add a single URL or queue a bulk batch directly to
`update.yml` via `workflow_dispatch`. Polls run status every 5 s and refreshes the table on
completion.
- **Sync button + manual refresh** — invalidate all data queries on demand; spinner reflects
in-flight state.
- **Collapsible sidebar** with rail mode (240 px ↔ 56 px).
- **Dark / Light / System theme** with `prefers-color-scheme` listener.
- **About page** — third-party license attribution by category, app version + build date.
### Added (Desktop wrapper)
- **`webapp/src-tauri/`** — Tauri 2 scaffold (Rust + WebView). Same React build, ~10 MB
installer.
- **`tauri-plugin-http`** scoped to `*.itch.io`, `img.itch.zone`, `api.github.com`,
`raw.githubusercontent.com`. Lets the desktop bypass CORS for direct itch.io previews.
- **`webapp/TAURI.md`** — local prerequisites (rustup + platform deps), dev/build commands,
roadmap to a full Rust scrape (Phase 8b).
### Added (CI)
- **`.github/workflows/deploy_webapp.yml`** — build `webapp/` and publish `docs/app/` to
GitHub Pages on push to `main` that touches `webapp/`. One-time setup: repo Settings →
Pages → Source = "GitHub Actions".
- **`.github/workflows/release_desktop.yml`** — multi-platform Tauri build via
`tauri-apps/tauri-action` on tag `v*`. Uploads `.msi` / `.dmg` / `.AppImage` to a draft
GitHub Release.
### Changed (Python pipeline)
- **`scripts/update_info.py`** now reads an optional `INPUT_URL` env var (forwarded by
`update.yml` from `workflow_dispatch.inputs.url`) and appends it to the queue. Backwards
compatible: the daily cron still processes `temp_link.json` exactly as before.
- **`.github/workflows/update.yml`** gains `workflow_dispatch.inputs.url` so the webapp can
trigger a single-URL scrape.
---
## [2.0.0] - 2026-03-26 (Major Rewrite 🔧⭐)
### Rewritten
- **`scraper.py`** — new shared module extracted from `update_info.py`. All scraping logic, session management, rate-limiting, and parsing utilities live here. Used by every script that touches itch.io.
- **`update_info.py`** — fully rewritten. Uses `scraper.py` module, `requests.Session` with automatic retry (backoff on 429/5xx), and random delays between requests.
- **`generate_md.py`** — fully rewritten with pipe-character escaping and all new data fields.
### Added
- **Free game detection** — `update_info.py` now checks if a game is free before scraping. Paid games are skipped automatically. Detection logic parses `div.buy_row` for price tags and button text.
- **`check_paid.py`** — new script. Re-checks every game in the list to see if it became paid. Paid games are removed and logged to `deleted_games.json` with reason and timestamp.
- **`check_alive.py`** — new script. Verifies that all game URLs still exist. Pages returning 404 or 410 are removed and logged. Transient errors (403, 5xx, timeouts) are kept.
- **`log_deleted.py`** — new script. Converts `deleted_games.json` → `deleted_games.txt` (human-readable log sorted by date).
- **`deleted_games.json`** — structured log of all removed games with URL, name, reason, and deletion timestamp.
- **New data fields** scraped from itch.io info table: `status`, `platforms`, `publisher`, `release_date`, `made_with`, `rating`, `rating_count`, `average_session`, `languages`, `inputs`. All fields default to `N/A` when not found.
- **Author/Authors handling** — scraper now checks both `Author` and `Authors` keys (itch.io uses either depending on the page).
- **Release date parsing** — extracted from `<abbr title="...">` for full datetime instead of abbreviated text.
- **NSFW detection** expanded — now also checks game description text and adds `sexual` keyword.
### Added (GitHub Actions)
- **`check_paid.yml`** — runs every 2 days at 04:00 UTC. Removes games that became paid.
- **`check_alive.yml`** — runs every 2 days at 07:00 UTC (staggered 3h after check_paid). Removes dead links.
- **`log_deleted.yml`** — runs after check_paid or check_alive completes. Exports deletion log.
- **`generate_table.yml`** — now triggers after update, check_paid, and check_alive workflows (not just update).
- **`update_csv.yml`** — now triggers after table generation (chained workflow).
### Improved
- **Rate limiting** — random delays (2.5–5s between requests, 15–30s batch pause every 20 requests) to avoid itch.io IP bans. Lighter delays (1–2.5s) for HEAD/status checks.
- **Retry logic** — `requests.Session` with `HTTPAdapter` + `Retry` (3 attempts, exponential backoff 2→4→8s) on 429/500/502/503/504.
- **Network error safety** — games are never deleted on transient network failures. Only confirmed 404/410 or confirmed paid status triggers removal.
- **Markdown table integrity** — pipe characters (`|`) in game data are escaped to prevent table breakage.
- **All fields use `N/A` consistently** — replaced mixed `""`, `"Unknown"`, `"No description"` with uniform `N/A` fallback.
### Changed
- Markdown table columns expanded: added Genre, Tags, Status, Platforms, Publisher, Release Date, Made With, Rating, Session, Languages, Inputs.
- README rewritten with updated architecture diagram, project structure, field documentation.
- Workflow action versions updated to `actions/checkout@v6` and `actions/setup-python@v6` with Python 3.14.
---
## [1.0.5] - 2026-01-12 (Hotfix 🔧)
### Fixed
- UTF-8 decode issue when running `scripts/update_info.py`. See [#16](https://github.com/poli0981/free-games-itchio-list/issues/16).
## [1.0.4] - 2026-01-11 (Added Games + New Features ⭐)
### Added Games
Added 33 games. See [#22](https://github.com/poli0981/free-games-itchio-list/issues/22) and [#23](https://github.com/poli0981/free-games-itchio-list/issues/23).
### New Features
- Delete game with correct link in `delete_game.py`. See [#20](https://github.com/poli0981/free-games-itchio-list/issues/20).
- Export JSON → `.csv`/`.xlsx` in `export_csv.py`. See [#21](https://github.com/poli0981/free-games-itchio-list/issues/21).
- Check duplicate data in JSON file in `check_duplicate.py`. See [#19](https://github.com/poli0981/free-games-itchio-list/issues/19).
## [1.0.3] - Date unknown (Improvements ⚙️)
### Improved
- Optimized workflow scheduling.
## [1.0.2] - Date unknown (Hotfix 🔧)
### Fixed
- `temp_link.json` not resetting to `[]` after GitHub Actions run.
## [1.0.1] - 2025-12-31 (Hotfix 🔧)
### Fixed
- Rewrote and added 2 issue templates.
- Updated [CONTRIBUTING](CONTRIBUTING.md).
## [1.0.0] - 2025-12-28 (Initial Release 🚀)
### Added
- Full curated list of free itch.io games with auto-daily updates via GitHub Actions.
- Scraping script ([`update_info.py`](scripts/update_info.py)): add links → scrape title, dev, genre, description, NSFW flag, thumbnail.
- MD table generator (`generate_md.py`): split by genre, 300 max per file, in `/lists/`.
- Columns: No | Thumb | Name | Dev | Short Desc | Link | Safe | Notes | NSFW.
- [`temp_link.json`](/scripts/temp_link.json) for easy manual adds (Actions process daily).
- Full docs: [DISCLAIMER](/docs/DISCLAIMER.md), [PRIVACY](/docs/PrivacyPolicy.md), [TERMS](/docs/ToS.md), [EULA](/docs/EULA.md), [SECURITY](SECURITY.md), [CODE_OF_CONDUCT](CODE_OF_CONDUCT.md), [CONTRIBUTING](CONTRIBUTING.md), [ACKNOWLEDGEMENTS](/docs/ACKNOWLEDGEMENTS.md).
- Issue and PR templates for bugs, features, and game submissions.
- Badges, TOC, and example table in [README](README.md).
### Fixed
- Multiple scrape bugs (itch.io HTML structure changes).
- Description length overflow → truncated to first sentence + "(see more on itch.io)".
- Table numbering resets per file, primary genre used for grouping.
All notable changes to this project, newest first. The notes of each release live in
[`changelog/`](changelog/), one file per minor version: `changelog/<major>.x/ver<major>.<minor>.x.md`.
**Latest release: [4.1.0](changelog/4.x/ver4.1.x.md#410---2026-09-24-verification-check-readable-charts-changelog-folder) (2026-09-24) — Verification check, readable charts, changelog folder.**
## 4.x
| Version | Date | Highlights |
|---|---|---|
| [4.1.0](changelog/4.x/ver4.1.x.md#410---2026-09-24-verification-check-readable-charts-changelog-folder) | 2026-09-24 | Verification check, readable charts, changelog folder |
| <a name="400---2026-09-18-freeitchgameswin-on-cloudflare-read-only-site-review-queue-new-design"></a>[4.0.0](changelog/4.x/ver4.0.x.md#400---2026-09-18-freeitchgameswin-on-cloudflare-read-only-site-review-queue-new-design) | 2026-09-18 | freeitchgames.win on Cloudflare: read-only site, review queue, new design |
## 3.x
| Version | Date | Highlights |
|---|---|---|
| <a name="390---2026-06-15-android-minsdk--11--api-30"></a>[3.9.0](changelog/3.x/ver3.9.x.md#390---2026-06-15-android-minsdk--11--api-30) | 2026-06-15 | Android minSdk → 11 / API 30 |
| <a name="380---2026-06-15-android-apk-target-"></a>[3.8.0](changelog/3.x/ver3.8.x.md#380---2026-06-15-android-apk-target-) | 2026-06-15 | Android APK target 📱 |
| <a name="371---2026-06-14-hotfix--desktop-build-vs-invalid-tauri-nsis-license-key"></a>[3.7.1](changelog/3.x/ver3.7.x.md#371---2026-06-14-hotfix--desktop-build-vs-invalid-tauri-nsis-license-key) | 2026-06-14 | Hotfix — desktop build vs invalid Tauri NSIS license key |
| <a name="370---2026-06-14-legal-acceptance-gates--per-tab-chart-lazy-loading"></a>[3.7.0](changelog/3.x/ver3.7.x.md#370---2026-06-14-legal-acceptance-gates--per-tab-chart-lazy-loading) | 2026-06-14 | Legal-acceptance gates + per-tab chart lazy-loading |
| <a name="361---2026-06-12-hotfix--desktop-build-vs-broken-time-0348"></a>[3.6.1](changelog/3.x/ver3.6.x.md#361---2026-06-12-hotfix--desktop-build-vs-broken-time-0348) | 2026-06-12 | Hotfix — desktop build vs broken `time` 0.3.48 |
| <a name="360---2026-06-12-i18n-envi--offline-cache--custom-error-pages"></a>[3.6.0](changelog/3.x/ver3.6.x.md#360---2026-06-12-i18n-envi--offline-cache--custom-error-pages) | 2026-06-12 | i18n EN/VI + offline cache + custom error pages |
| <a name="352---2026-05-23-dead-code-cleanup--knip--vulture"></a>[3.5.2](changelog/3.x/ver3.5.x.md#352---2026-05-23-dead-code-cleanup--knip--vulture) | 2026-05-23 | Dead-code cleanup — knip + vulture |
| <a name="351---2026-05-20-lint-cleanup--zero-eslint-problems"></a>[3.5.1](changelog/3.x/ver3.5.x.md#351---2026-05-20-lint-cleanup--zero-eslint-problems) | 2026-05-20 | Lint cleanup — zero ESLint problems |
| <a name="350---2026-05-20-charts-expansion--game-count-history--pipeline-cleanup"></a>[3.5.0](changelog/3.x/ver3.5.x.md#350---2026-05-20-charts-expansion--game-count-history--pipeline-cleanup) | 2026-05-20 | Charts expansion + game-count history + pipeline cleanup |
| <a name="341---2026-05-17-hotfix-datatable-column-alignment--discussion-announce-auto-discovery"></a>[3.4.1](changelog/3.x/ver3.4.x.md#341---2026-05-17-hotfix-datatable-column-alignment--discussion-announce-auto-discovery) | 2026-05-17 | Hotfix: DataTable column alignment + Discussion-announce auto-discovery |
| <a name="340---2026-05-16-periodic-refresh-workflows--utf-8-round-trip-fix"></a>[3.4.0](changelog/3.x/ver3.4.x.md#340---2026-05-16-periodic-refresh-workflows--utf-8-round-trip-fix) | 2026-05-16 | Periodic refresh workflows + UTF-8 round-trip fix |
| <a name="330---2026-05-16-mobile-polish--settings--in-browser-gpg-commit-signing"></a>[3.3.0](changelog/3.x/ver3.3.x.md#330---2026-05-16-mobile-polish--settings--in-browser-gpg-commit-signing) | 2026-05-16 | Mobile polish + Settings + in-browser GPG commit signing |
| <a name="321---2026-05-11-hotfix-single-instance-enforcement-on-desktop"></a>[3.2.1](changelog/3.x/ver3.2.x.md#321---2026-05-11-hotfix-single-instance-enforcement-on-desktop) | 2026-05-11 | Hotfix: single-instance enforcement on desktop |
| <a name="320---2026-05-10-ci-cleanup--mobile--seo--telegram-bot-path--auto-discussion"></a>[3.2.0](changelog/3.x/ver3.2.x.md#320---2026-05-10-ci-cleanup--mobile--seo--telegram-bot-path--auto-discussion) | 2026-05-10 | CI cleanup + mobile + SEO + Telegram bot path + auto-discussion |
| <a name="314---2026-05-05-legal-docs-rewrite--vietnamese-i18n--legal-card--ui-polish"></a>[3.1.4](changelog/3.x/ver3.1.x.md#314---2026-05-05-legal-docs-rewrite--vietnamese-i18n--legal-card--ui-polish) | 2026-05-05 | Legal docs rewrite + Vietnamese i18n + Legal Card + UI polish |
| <a name="313---2026-05-05-credit-claude-code-as-ai-co-author"></a>[3.1.3](changelog/3.x/ver3.1.x.md#313---2026-05-05-credit-claude-code-as-ai-co-author) | 2026-05-05 | Credit Claude Code as AI co-author |
| <a name="312---2026-05-05-offline-link-fix--about-expansion--docs-sweep"></a>[3.1.2](changelog/3.x/ver3.1.x.md#312---2026-05-05-offline-link-fix--about-expansion--docs-sweep) | 2026-05-05 | Offline link fix + About expansion + docs sweep |
| [3.1.1](changelog/3.x/ver3.1.x.md#311---2026-05-04-cross-compile-macos-x86_64-from-apple-silicon) | 2026-05-04 | Cross-compile macOS x86_64 from Apple Silicon |
| [3.1.0](changelog/3.x/ver3.1.x.md#310---2026-05-04-macos-dmg-fix--pkg-installer--pagination) | 2026-05-04 | macOS DMG fix + .pkg installer + pagination |
| [3.0.1](changelog/3.x/ver3.0.x.md#301---2026-05-04-tauri-icons--fine-grained-pat-fix) | 2026-05-04 | Tauri icons + fine-grained PAT fix |
| <a name="300---2026-05-04-webapp--desktop-️"></a>[3.0.0](changelog/3.x/ver3.0.x.md#300---2026-05-04-webapp--desktop-️) | 2026-05-04 | Webapp + Desktop 🖥️📊 |
## 2.x
| Version | Date | Highlights |
|---|---|---|
| <a name="200---2026-03-26-major-rewrite-"></a>[2.0.0](changelog/2.x/ver2.0.x.md#200---2026-03-26-major-rewrite-) | 2026-03-26 | Major Rewrite 🔧⭐ |
## 1.x
| Version | Date | Highlights |
|---|---|---|
| <a name="105---2026-01-12-hotfix-"></a>[1.0.5](changelog/1.x/ver1.0.x.md#105---2026-01-12-hotfix-) | 2026-01-12 | Hotfix 🔧 |
| <a name="104---2026-01-11-added-games--new-features-"></a>[1.0.4](changelog/1.x/ver1.0.x.md#104---2026-01-11-added-games--new-features-) | 2026-01-11 | Added Games + New Features ⭐ |
| <a name="103---date-unknown-improvements-️"></a>[1.0.3](changelog/1.x/ver1.0.x.md#103---2026-01-01-improvements-️) | 2026-01-01 | Improvements ⚙️ |
| <a name="102---date-unknown-hotfix-"></a>[1.0.2](changelog/1.x/ver1.0.x.md#102---2026-01-01-hotfix-) | 2026-01-01 | Hotfix 🔧 |
| <a name="101---2025-12-31-hotfix-"></a>[1.0.1](changelog/1.x/ver1.0.x.md#101---2025-12-31-hotfix-) | 2025-12-31 | Hotfix 🔧 |
| <a name="100---2025-12-28-initial-release-"></a>[1.0.0](changelog/1.x/ver1.0.x.md#100---2025-12-28-initial-release-) | 2025-12-28 | Initial Release 🚀 |
+60
View File
@@ -0,0 +1,60 @@
# Changelog — 1.0.x
Release notes for 1.0.0 – 1.0.5, newest first. Every version: [CHANGELOG.md](../../CHANGELOG.md).
## [1.0.5] - 2026-01-12 (Hotfix 🔧)
### Fixed
- UTF-8 decode issue when running `scripts/update_info.py`. See [#16](https://github.com/poli0981/free-games-itchio-list/issues/16).
---
## [1.0.4] - 2026-01-11 (Added Games + New Features ⭐)
### Added Games
Added 33 games. See [#22](https://github.com/poli0981/free-games-itchio-list/issues/22) and [#23](https://github.com/poli0981/free-games-itchio-list/issues/23).
### New Features
- Delete game with correct link in `delete_game.py`. See [#20](https://github.com/poli0981/free-games-itchio-list/issues/20).
- Export JSON → `.csv`/`.xlsx` in `export_csv.py`. See [#21](https://github.com/poli0981/free-games-itchio-list/issues/21).
- Check duplicate data in JSON file in `check_duplicate.py`. See [#19](https://github.com/poli0981/free-games-itchio-list/issues/19).
---
## [1.0.3] - 2026-01-01 (Improvements ⚙️)
### Improved
- Optimized workflow scheduling.
---
## [1.0.2] - 2026-01-01 (Hotfix 🔧)
### Fixed
- `temp_link.json` not resetting to `[]` after GitHub Actions run.
---
## [1.0.1] - 2025-12-31 (Hotfix 🔧)
### Fixed
- Rewrote and added 2 issue templates.
- Updated [CONTRIBUTING](../../CONTRIBUTING.md).
---
## [1.0.0] - 2025-12-28 (Initial Release 🚀)
### Added
- Full curated list of free itch.io games with auto-daily updates via GitHub Actions.
- Scraping script ([`update_info.py`](../../scripts/update_info.py)): add links → scrape title, dev, genre, description, NSFW flag, thumbnail.
- MD table generator (`generate_md.py`): split by genre, 300 max per file, in `/lists/`.
- Columns: No | Thumb | Name | Dev | Short Desc | Link | Safe | Notes | NSFW.
- [`temp_link.json`](/scripts/temp_link.json) for easy manual adds (Actions process daily).
- Full docs: [DISCLAIMER](/docs/DISCLAIMER.md), [PRIVACY](/docs/PrivacyPolicy.md), [TERMS](/docs/ToS.md), [EULA](/docs/EULA.md), [SECURITY](../../SECURITY.md), [CODE_OF_CONDUCT](../../CODE_OF_CONDUCT.md), [CONTRIBUTING](../../CONTRIBUTING.md), [ACKNOWLEDGEMENTS](/docs/ACKNOWLEDGEMENTS.md).
- Issue and PR templates for bugs, features, and game submissions.
- Badges, TOC, and example table in [README](../../README.md).
### Fixed
- Multiple scrape bugs (itch.io HTML structure changes).
- Description length overflow → truncated to first sentence + "(see more on itch.io)".
- Table numbering resets per file, primary genre used for grouping.
+40
View File
@@ -0,0 +1,40 @@
# Changelog — 2.0.x
Release notes for 2.0.0, newest first. Every version: [CHANGELOG.md](../../CHANGELOG.md).
## [2.0.0] - 2026-03-26 (Major Rewrite 🔧⭐)
### Rewritten
- **`scraper.py`** — new shared module extracted from `update_info.py`. All scraping logic, session management, rate-limiting, and parsing utilities live here. Used by every script that touches itch.io.
- **`update_info.py`** — fully rewritten. Uses `scraper.py` module, `requests.Session` with automatic retry (backoff on 429/5xx), and random delays between requests.
- **`generate_md.py`** — fully rewritten with pipe-character escaping and all new data fields.
### Added
- **Free game detection** — `update_info.py` now checks if a game is free before scraping. Paid games are skipped automatically. Detection logic parses `div.buy_row` for price tags and button text.
- **`check_paid.py`** — new script. Re-checks every game in the list to see if it became paid. Paid games are removed and logged to `deleted_games.json` with reason and timestamp.
- **`check_alive.py`** — new script. Verifies that all game URLs still exist. Pages returning 404 or 410 are removed and logged. Transient errors (403, 5xx, timeouts) are kept.
- **`log_deleted.py`** — new script. Converts `deleted_games.json` → `deleted_games.txt` (human-readable log sorted by date).
- **`deleted_games.json`** — structured log of all removed games with URL, name, reason, and deletion timestamp.
- **New data fields** scraped from itch.io info table: `status`, `platforms`, `publisher`, `release_date`, `made_with`, `rating`, `rating_count`, `average_session`, `languages`, `inputs`. All fields default to `N/A` when not found.
- **Author/Authors handling** — scraper now checks both `Author` and `Authors` keys (itch.io uses either depending on the page).
- **Release date parsing** — extracted from `<abbr title="...">` for full datetime instead of abbreviated text.
- **NSFW detection** expanded — now also checks game description text and adds `sexual` keyword.
### Added (GitHub Actions)
- **`check_paid.yml`** — runs every 2 days at 04:00 UTC. Removes games that became paid.
- **`check_alive.yml`** — runs every 2 days at 07:00 UTC (staggered 3h after check_paid). Removes dead links.
- **`log_deleted.yml`** — runs after check_paid or check_alive completes. Exports deletion log.
- **`generate_table.yml`** — now triggers after update, check_paid, and check_alive workflows (not just update).
- **`update_csv.yml`** — now triggers after table generation (chained workflow).
### Improved
- **Rate limiting** — random delays (2.5–5s between requests, 15–30s batch pause every 20 requests) to avoid itch.io IP bans. Lighter delays (1–2.5s) for HEAD/status checks.
- **Retry logic** — `requests.Session` with `HTTPAdapter` + `Retry` (3 attempts, exponential backoff 2→4→8s) on 429/500/502/503/504.
- **Network error safety** — games are never deleted on transient network failures. Only confirmed 404/410 or confirmed paid status triggers removal.
- **Markdown table integrity** — pipe characters (`|`) in game data are escaped to prevent table breakage.
- **All fields use `N/A` consistently** — replaced mixed `""`, `"Unknown"`, `"No description"` with uniform `N/A` fallback.
### Changed
- Markdown table columns expanded: added Genre, Tags, Status, Platforms, Publisher, Release Date, Made With, Rating, Session, Languages, Inputs.
- README rewritten with updated architecture diagram, project structure, field documentation.
- Workflow action versions updated to `actions/checkout@v6` and `actions/setup-python@v6` with Python 3.14.
+58
View File
@@ -0,0 +1,58 @@
# Changelog — 3.0.x
Release notes for 3.0.0 – 3.0.1, newest first. Every version: [CHANGELOG.md](../../CHANGELOG.md).
## [3.0.1] - 2026-05-04 (Tauri icons + fine-grained PAT fix)
This release has no changelog entry of its own; its notes are on GitHub: <https://github.com/poli0981/free-games-itchio-list/releases/tag/v3.0.1>.
---
## [3.0.0] - 2026-05-04 (Webapp + Desktop 🖥️📊)
A React + TypeScript SPA on top of the same JSON catalog, plus a Tauri 2 desktop wrapper.
The Python pipeline from 2.0.0 is untouched and still drives the daily data updates.
### Added (Webapp)
- **`webapp/`** — Vite + React 19 + TypeScript 6 + Tailwind v3 + shadcn/ui (Radix primitives).
Code-split, ~163 KB gzip initial load. Reads from `raw.githubusercontent.com` (public, no auth);
writes use a fine-grained GitHub PAT held only in memory after passphrase unlock.
- **8 routes**: Dashboard (KPIs), Games (virtualized DataTable + faceted filters), Game Detail
(23-field read view + edit form for `safe_virus` / `notes` / `nsfw`), Add (single URL +
bulk), Charts (9 Recharts visualizations in 4 tabs), Workflows (run history + Dispatch),
Deleted (tombstone log), Settings (PAT + theme), About (license attribution).
- **PAT encryption** — AES-GCM 256-bit, PBKDF2-SHA256 (100k iterations) with per-token salt.
Encrypted blob in localStorage; decrypted token in memory only.
- **Atomic bulk operations** — Bulk edit / delete via GitHub Git Data API (single commit for N
files), 20-entry undo stack with one-click revert.
- **Workflow dispatch from UI** — Add a single URL or queue a bulk batch directly to
`update.yml` via `workflow_dispatch`. Polls run status every 5 s and refreshes the table on
completion.
- **Sync button + manual refresh** — invalidate all data queries on demand; spinner reflects
in-flight state.
- **Collapsible sidebar** with rail mode (240 px ↔ 56 px).
- **Dark / Light / System theme** with `prefers-color-scheme` listener.
- **About page** — third-party license attribution by category, app version + build date.
### Added (Desktop wrapper)
- **`webapp/src-tauri/`** — Tauri 2 scaffold (Rust + WebView). Same React build, ~10 MB
installer.
- **`tauri-plugin-http`** scoped to `*.itch.io`, `img.itch.zone`, `api.github.com`,
`raw.githubusercontent.com`. Lets the desktop bypass CORS for direct itch.io previews.
- **`webapp/TAURI.md`** — local prerequisites (rustup + platform deps), dev/build commands,
roadmap to a full Rust scrape (Phase 8b).
### Added (CI)
- **`.github/workflows/deploy_webapp.yml`** — build `webapp/` and publish `docs/app/` to
GitHub Pages on push to `main` that touches `webapp/`. One-time setup: repo Settings →
Pages → Source = "GitHub Actions".
- **`.github/workflows/release_desktop.yml`** — multi-platform Tauri build via
`tauri-apps/tauri-action` on tag `v*`. Uploads `.msi` / `.dmg` / `.AppImage` to a draft
GitHub Release.
### Changed (Python pipeline)
- **`scripts/update_info.py`** now reads an optional `INPUT_URL` env var (forwarded by
`update.yml` from `workflow_dispatch.inputs.url`) and appends it to the queue. Backwards
compatible: the daily cron still processes `temp_link.json` exactly as before.
- **`.github/workflows/update.yml`** gains `workflow_dispatch.inputs.url` so the webapp can
trigger a single-URL scrape.
+95
View File
@@ -0,0 +1,95 @@
# Changelog — 3.1.x
Release notes for 3.1.0 – 3.1.4, newest first. Every version: [CHANGELOG.md](../../CHANGELOG.md).
## [3.1.4] - 2026-05-05 (Legal docs rewrite + Vietnamese i18n + Legal Card + UI polish)
### Added
- **Vietnamese translations** under [`docs/i18n/vi/`](../../docs/i18n/vi/) — full
translations of the four legal docs (DISCLAIMER, EULA, ToS, PrivacyPolicy)
plus CONTRIBUTING, CODE_OF_CONDUCT, and SECURITY. Each file notes that the
English version is the controlling text for legal interpretation.
- **`README.vi.md`** at repo root — Vietnamese mirror of the main README, with a
language badge and a link back to the English version.
- **About page → "Legal & policies" Card** — single place to access all policy
files (Disclaimer, EULA, ToS, Privacy, Code of Conduct, Security, License,
Changelog) plus a pointer to the Vietnamese translations.
- **`webapp/src/lib/about.ts`**: `LegalLink` interface + `LEGAL_LINKS` array +
`LEGAL_VI_INDEX_URL`. Same structured pattern as `THIRD_PARTY` and
`SOCIAL_LINKS`.
### Changed
- **`docs/DISCLAIMER.md`, `docs/EULA.md`, `docs/ToS.md`, `docs/PrivacyPolicy.md`**:
rewritten to be tighter and more enforceable while keeping the project's voice.
Each doc now has a TL;DR, numbered sections, definitions, severability,
governing law (Socialist Republic of Vietnam), explicit "not legal advice"
notice, and a removal-request path. Privacy Policy adds a per-storage table
for what the webapp persists locally and a step-by-step PAT lifecycle.
- **`README.md`** version badge → 3.1.4 plus a Vietnamese language badge and a
short pointer to `README.vi.md` and `docs/i18n/vi/`.
### Optional UI
- **Tauri desktop**: maximize button is now disabled (`maximizable: false` in
`webapp/src-tauri/tauri.conf.json`). Window is still resizable; only the
full-window-maximize action is locked.
- **DataTable**: scrollbar hidden via a new `.scrollbar-hide` Tailwind utility
added to `webapp/src/index.css`. Scrolling still works; the chrome is gone.
---
## [3.1.3] - 2026-05-05 (Credit Claude Code as AI co-author)
### Added
- **About page**: new **"AI co-authors"** Card listing both Grok (xAI) and
Claude Code (Anthropic — Claude Opus 4.7, 1M context) with their roles
in the repo's history. Each entry is linked + tagged with vendor and model.
- `webapp/src/lib/about.ts`: new `AiTool` interface + `AI_TOOLS` array so the
AI credit data is structured the same way as `THIRD_PARTY` and `SOCIAL_LINKS`.
### Changed
- **`docs/ACKNOWLEDGEMENTS.md`, `docs/My_Stuff.md`, `CONTRIBUTING.md`**:
surface Claude Code alongside Grok wherever the existing AI credit lived.
Grok references stay — both buddies share the workload now (Grok carried the
Python pipeline + v2.0.0 rewrite; Claude Code drove v3.0.0 webapp/Tauri and
v3.1.2). `My_Stuff.md` "The Real MVP" is now plural.
- `DEV.blurb` on the About page reflects the two-buddy reality.
---
## [3.1.2] - 2026-05-05 (Offline link fix + About expansion + docs sweep)
### Fixed
- **Tauri desktop**: external links (itch.io, GitHub, third-party home pages) now
open in the user's default browser instead of doing nothing. Added
`tauri-plugin-opener` (Rust + JS) and a scoped `opener:allow-open-url`
capability locked to `https://*` (no `file://` / `javascript:` schemes).
### Added
- **About page**: three new sections — Developer card, "Found a bug?" CTA that
opens the bug-report issue template, and "Find me elsewhere" with X, YouTube,
two Discord servers (Repo discussion / Game chat), Patreon, Ko-fi, Steam,
Bluesky, and Mastodon.
- **`<ExtLink>`** ([`webapp/src/components/ext-link.tsx`](../../webapp/src/components/ext-link.tsx))
— runtime-aware external-link wrapper used app-wide so the offline link bug
can't recur. On web it renders a plain `<a target="_blank">`; on Tauri it
routes through `tauri-plugin-opener`. All existing external `<a>` tags in
About, the sidebar footer, and Game Detail now use it.
### Changed
- **`webapp/README.md`**: rewritten from Vite boilerplate to actual webapp docs
(routes, dev/build commands, code-split layout, deploy, Tauri reference).
- **`CONTRIBUTING.md`, `docs/ACKNOWLEDGEMENTS.md`, `docs/My_Stuff.md`,
`README.md`**: refreshed contact / social handles. The "if I ever make a
Discord" line is finally obsolete — both servers exist.
---
## [3.1.1] - 2026-05-04 (Cross-compile macOS x86_64 from Apple Silicon)
This release has no changelog entry of its own; its notes are on GitHub: <https://github.com/poli0981/free-games-itchio-list/releases/tag/v3.1.1>.
---
## [3.1.0] - 2026-05-04 (macOS DMG fix + .pkg installer + pagination)
This release has no changelog entry of its own; its notes are on GitHub: <https://github.com/poli0981/free-games-itchio-list/releases/tag/v3.1.0>.
+65
View File
@@ -0,0 +1,65 @@
# Changelog — 3.2.x
Release notes for 3.2.0 – 3.2.1, newest first. Every version: [CHANGELOG.md](../../CHANGELOG.md).
## [3.2.1] - 2026-05-11 (Hotfix: single-instance enforcement on desktop)
### Fixed
- **Desktop app spawned a new process on every launch.** Each double-click of the installed app added another `free-games-itchio-webapp.exe` (Windows) / equivalent on macOS+Linux to the task list instead of focusing the existing window. Added [`tauri-plugin-single-instance`](https://tauri.app/plugin/single-instance/) v2 in [`webapp/src-tauri/src/lib.rs`](../../webapp/src-tauri/src/lib.rs) — second launch now unminimizes + focuses the running window and exits its own process before creating a duplicate. Plugin registered first in the builder chain per Tauri 2 docs so duplicate processes die before initializing HTTP/opener plugins. Gated by `#[cfg(desktop)]` + matching `cfg(not(android, ios))` in [`Cargo.toml`](../../webapp/src-tauri/Cargo.toml). Desktop binary boundary change → bumped [`Cargo.toml`](../../webapp/src-tauri/Cargo.toml) and [`tauri.conf.json`](../../webapp/src-tauri/tauri.conf.json) from `0.1.0` to `0.1.1` (first time these have moved since v3.0.0).
### Changed
- **README + README.vi badges** bumped to `3.2.1`.
- **About page** lists `tauri-plugin-single-instance` v2 under Desktop dependencies.
---
## [3.2.0] - 2026-05-10 (CI cleanup + mobile + SEO + Telegram bot path + auto-discussion)
### Added
- **Mobile drawer navigation.** New [`webapp/src/components/ui/sheet.tsx`](../../webapp/src/components/ui/sheet.tsx) (shadcn pattern over the existing `@radix-ui/react-dialog`) and a `MobileTopBar` in [`webapp/src/components/sidebar.tsx`](https://github.com/poli0981/free-games-itchio-list/blob/v3.2.0/webapp/src/components/sidebar.tsx). Below `md`, the sidebar collapses behind a hamburger; above, the desktop sidebar behaves as before. Touch targets in the nav now meet the 44pt iOS HIG minimum on small screens.
- **DataTable column priorities.** Each column declares `meta.priority: 1 | 2 | 3` in [`columns.tsx`](https://github.com/poli0981/free-games-itchio-list/blob/v3.2.0/webapp/src/components/data-table/columns.tsx). [`data-table.tsx`](https://github.com/poli0981/free-games-itchio-list/blob/v3.2.0/webapp/src/components/data-table/data-table.tsx) hides priority 2 below `md` and priority 3 below `lg`, so the table is usable on a phone without horizontal scrolling through every column.
- **PWA manifest + icons.** [`webapp/public/manifest.webmanifest`](../../webapp/public/manifest.webmanifest), [`icon-192.png`](../../webapp/public/icon-192.png), [`icon-512.png`](../../webapp/public/icon-512.png) — Add to Home Screen on iOS without a service worker. Generator script: [`webapp/scripts/gen_assets.py`](../../webapp/scripts/gen_assets.py).
- **SEO infrastructure.** [`webapp/index.html`](../../webapp/index.html) now ships description, theme-color (per scheme), Open Graph (title/description/image/url/type/locale), Twitter card (`summary_large_image`), `canonical`, `apple-touch-icon`, `manifest`, and `preconnect` to `img.itch.zone` + `raw.githubusercontent.com`. [`robots.txt`](../../webapp/public/robots.txt) and `sitemap.xml` added under `webapp/public/`.
- **OG image.** [`webapp/public/og.png`](../../webapp/public/og.png) (1200×630) + [`og.webp`](../../webapp/public/og.webp) generated by `gen_assets.py`. Brand-coloured (`#863bff` purple, cyan accent) with project name, tagline, and URL.
- **Per-route titles.** New [`useDocumentTitle`](../../webapp/src/hooks/useDocumentTitle.ts) hook (no `react-helmet-async` dependency). Each route now sets a contextual title (`Charts — Itch.io Free Games Database`, etc.); game-detail uses the game name.
- **Hash-anchor scroll.** [`App.tsx`](../../webapp/src/App.tsx) now wires a `ScrollToHash` listener so links like `/about#support` scroll to the matching element under HashRouter.
- **About page Telegram entries.** New `messaging` social group with **Telegram (DM)** and **Telegram bot (game submission)** plus a privacy reminder to never paste a numeric ID into public channels. About also surfaces all five FUNDING.yml destinations (GitHub Sponsors, Patreon, Ko-fi, Buy Me a Coffee, PayPal) with a footnote on PayPal explaining the legal-name receipt.
- **Sidebar Support link.** Persistent heart-icon link from the sidebar (collapsed and expanded) to `/about#support`.
- **Telegram bot contribution flow.** `CONTRIBUTING.md §1b` describes the bot path (DM owner → numeric ID added to local whitelist → bot dispatches `bot-ingest.yml`). Cross-linked from [README.md](../../README.md), [README.vi.md](../../README.vi.md), and the new issue template `game_via_bot.yml`. Vietnamese mirror in [`docs/i18n/vi/CONTRIBUTING.md`](../../docs/i18n/vi/CONTRIBUTING.md).
- **Privacy + ToS clauses for the bot path.** [`docs/ToS.md §14`](../../docs/ToS.md) and [`docs/PrivacyPolicy.md §15`](../../docs/PrivacyPolicy.md) (plus VI mirrors) document Telegram-ID handling: opt-in, operator-side whitelist only, never committed to this repo, removable on DM.
- **`docs/pc_spec.md` + `docs/dev_env.md` (EN + VI).** Maintainer hardware spec, mobile test devices (iPhone 14 Pro / 13 Pro Max, iOS 26.x on Chrome + Brave), and dev-env toolchain (Python 3.12, Node ≥ 22, Rust stable, JetBrains 2026.x). Cross-linked from README and CONTRIBUTING.
- **Auto-create GitHub Discussion workflow.** [`announce-discussion.yml`](../../.github/workflows/announce-discussion.yml) — on `release: published` posts to the **Announcements** category; on push to `docs/**` / `CHANGELOG.md` / `README*.md` posts to **General**, gated by `[skip-discuss]` in the head-commit message and a quiet skip on `bot-ingest:` commits. Uses `gh api graphql` directly (no third-party action). Setup: configure repo variables `DISCUSSION_REPO_ID`, `DISCUSSION_ANNOUNCEMENTS_CATEGORY_ID`, `DISCUSSION_GENERAL_CATEGORY_ID` (run the GraphQL pre-flight query in the workflow header to fetch them).
### Changed
- **CI notify wrappers.** `notify-ci-failure.yml`, `notify-deploy.yml`, and [`notify-release-pipeline.yml`](../../.github/workflows/notify-release-pipeline.yml) replace `workflows: ["*"]` with explicit allowlists. Every workflow run no longer fans out to all three wrappers; the Actions tab is much quieter and the per-event reusable filtering is what it always should have been.
- **`bot-ingest.yml` cleanup.** Removed a dead final step that referenced a non-existent `${{ secrets.BOT_TOKEN }}` and a `result.txt` file. The Python `success`/`failure` Telegram callback steps above already handle both outcomes.
- **Image hints.** Game thumbnails in [`columns.tsx`](https://github.com/poli0981/free-games-itchio-list/blob/v3.2.0/webapp/src/components/data-table/columns.tsx) and the hero in [`game-detail.tsx`](../../webapp/src/routes/game-detail.tsx) now declare `width`/`height` (CLS), `decoding="async"`, and `fetchPriority` (high for hero, low for table rows). itch.io thumbnails remain external — full WebP recompression is intentionally deferred (would require an image proxy).
- **About support card** mirrors `.github/FUNDING.yml` exactly: 5 entries (GitHub Sponsors, Patreon, Ko-fi, BMC, PayPal).
- **README + README.vi badges** bumped to `3.2.0`.
### Fixed
- **Bot ingest workflow** had a broken final telegram callback step (wrong secret name + missing input file). Removed; the working callback steps above are unaffected.
### Setup notes for maintainers (one-time, post-merge)
To enable the auto-discussion workflow, run once:
```sh
gh api graphql -f query='query{repository(owner:"poli0981",name:"free-games-itchio-list"){
id
discussionCategories(first:20){nodes{id slug name}}
}}'
```
Then in repo Settings → Secrets and variables → Actions → Variables, add:
- `DISCUSSION_REPO_ID` — the `repository.id` from the response.
- `DISCUSSION_ANNOUNCEMENTS_CATEGORY_ID` — the `id` of the Announcements category.
- `DISCUSSION_GENERAL_CATEGORY_ID` — the `id` of the General category.
Without these set, the workflow runs but no-ops with a warning (safe default).
+24
View File
@@ -0,0 +1,24 @@
# Changelog — 3.3.x
Release notes for 3.3.0, newest first. Every version: [CHANGELOG.md](../../CHANGELOG.md).
## [3.3.0] - 2026-05-16 (Mobile polish + Settings + in-browser GPG commit signing)
### Added
- **In-browser GPG commit signing.** Every write the webapp makes (single-file edits, bulk edit/delete, queueing URLs) can now be GPG-signed client-side. New `webapp/src/lib/gpg/` module: `canonicalize.ts` builds the exact byte string Git would hash, `sign.ts` lazy-imports `openpgp` and exposes `loadPrivateKey` / `signCommit` / `verifyDetached`, `storage.ts` wraps localStorage helpers. Verified byte-for-byte against `git cat-file commit <sha>` so the signed canonical exactly matches what GitHub will recompute (no trailing-newline drift). Private keys are decrypted once at import and re-encrypted with the webapp passphrase (AES-GCM, same scheme as the PAT) — `openpgp` is loaded only when the Commit Signing card is opened or a commit is being signed (`vendor-openpgp` chunk, ~129 KB gz, lazy).
- **Settings → Commit signing card.** New `webapp/src/components/settings/gpg-card.tsx` — three states (not configured / locked / unlocked) with Import (paste armored or upload `.asc`), Unlock, Test sign (round-trip verify), Copy public key, Lock, Remove. Shows the imported key's UIDs as badges and flags a clear mismatch warning if the configured commit-author email isn't in the key's UID list (the most common cause of GitHub's "Someone may be trying to trick you" warning). After import, primary UID email auto-populates Commit author so commits Verify on the first try.
- **Settings Phase A — Appearance / Session / Commit author / Notifications cards.** [`webapp/src/routes/settings.tsx`](../../webapp/src/routes/settings.tsx) gained four new cards backed by extended preferences in [`webapp/src/stores/prefs.ts`](../../webapp/src/stores/prefs.ts): theme picker (Light / Dark / System), layout density (Normal / Compact), sidebar collapse mirror, idle-timeout slider (5 / 15 / 30 / 60 / 120 min — replaces the hard-coded 30-min constant in `auth.ts`), commit-author name/email override, toast enable + duration. Density applies via `html[data-density='compact']` rules in [`index.css`](../../webapp/src/index.css); toasts are gated through a new [`AppToaster`](https://github.com/poli0981/free-games-itchio-list/blob/v3.3.0/webapp/src/components/app-toaster.tsx) wrapper that reads prefs.
- **Mobile card view for the games table.** New [`webapp/src/lib/use-is-mobile.ts`](../../webapp/src/lib/use-is-mobile.ts) (`matchMedia('(max-width: 767px)')`) and [`webapp/src/components/data-table/mobile-card-list.tsx`](https://github.com/poli0981/free-games-itchio-list/blob/v3.3.0/webapp/src/components/data-table/mobile-card-list.tsx). Below the `md` breakpoint, [`DataTable`](https://github.com/poli0981/free-games-itchio-list/blob/v3.3.0/webapp/src/components/data-table/data-table.tsx) renders a stacked card list (thumbnail + name + dev + genre/status/NSFW/safe badges, tap-to-detail, selection checkbox) instead of the 9-column virtualized table that overflowed at 430 px. Pagination is shared between both views.
- **Workflows route mobile fallback.** `workflows.tsx` now dual-renders the action picker — a `<Select>` dropdown below `md`, the existing `TabsList` at `md` and above. Fixes the overflow from five `whitespace-nowrap` triggers in an `inline-flex` TabsList at 430 px viewport.
### Changed
- **All write paths route through the Git Data API.** `webapp/src/lib/github/contents.ts` `putFile` (`PUT /repos/.../contents/{path}`) is gone — that endpoint authors commits as the PAT and never accepts a `signature` field. Replaced with `commitSingleFile` which delegates to `atomicCommit` so single-file edits (game annotations, `temp_link.json` queue) get the same signer plumbing as bulk operations. `atomicCommit` gained an optional `signer` parameter (defaulting to `getSignerIfEnabled()`) that, when present, builds the canonical commit object, signs detached binary-mode via openpgp, and passes `author` / `committer` / `signature` to `git.createCommit`. Commit author identity falls back through prefs override → imported key's primary UID email → GitHub user.
- **About page** lists `OpenPGP.js` 6.3 under Data dependencies; the [`webapp/vite.config.ts`](../../webapp/vite.config.ts) `manualChunks` rule emits a dedicated `vendor-openpgp` chunk so the cost is only paid when a user opens the signing card.
- **README + README.vi badges** bumped to `3.3.0`.
### Fixed
- **Workflows `/workflows` tabs no longer overflow on mobile.** Pre-fix: five `whitespace-nowrap` triggers in an `inline-flex` TabsList blew past a 430 px viewport.
- **DataTable no longer overflows on mobile.** Pre-fix: nine fixed-width columns minus three responsive-hidden ones still exceeded 430 px.
+40
View File
@@ -0,0 +1,40 @@
# Changelog — 3.4.x
Release notes for 3.4.0 – 3.4.1, newest first. Every version: [CHANGELOG.md](../../CHANGELOG.md).
## [3.4.1] - 2026-05-17 (Hotfix: DataTable column alignment + Discussion-announce auto-discovery)
### Fixed
- **DataTable columns misaligned at desktop widths.** Header used native table-layout (`<table className="w-full">` + `<th style={{width}}>`) while body rows used flex layout (`position: absolute` + `flex w-full`, cells with `flex: 0 0 Npx` / `1 1 0`). Native table-layout stretched the 8 size-less columns to fill the container based on content, but the absolutely-positioned body `<tr>` never participated in table layout — so its flex children stayed at their fixed flex-basis. Result: at the Tauri default 1280×800 window (and any viewport wider than the natural sum of header content widths) header columns drifted off the cells below them. [`webapp/src/components/data-table/data-table.tsx`](https://github.com/poli0981/free-games-itchio-list/blob/v3.4.1/webapp/src/components/data-table/data-table.tsx) now renders the header `<tr>` with `flex w-full` and each `<th>` with `flex h-10 items-center` + the same `flex: 0 0 Npx` / `1 1 0` style block as the body `<td>` — header and body now compute width identically. Helper `priorityHeaderClass` (which emitted `table-cell` variants) is gone; the existing `priorityClass` (`flex` variants) now drives both. No change to column definitions in [`columns.tsx`](https://github.com/poli0981/free-games-itchio-list/blob/v3.4.1/webapp/src/components/data-table/columns.tsx).
- **`announce-discussion.yml` was a silent no-op since v3.2.0.** Both jobs (`announce-release`, `announce-docs`) gated on three repo variables (`DISCUSSION_REPO_ID`, `DISCUSSION_ANNOUNCEMENTS_CATEGORY_ID`, `DISCUSSION_GENERAL_CATEGORY_ID`) that had never been configured — the validation step printed `::warning::… Skipping.` and `exit 0`, so every release silently failed to post to Discussions without surfacing a failed run. Replaced the two validation steps with a `Discover Discussion IDs` step that queries `gh api graphql` for `repository.id` and looks up the category by slug (`announcements` / `general`). Zero config now — works on any repo with Discussions enabled. Fails loudly with a clear `::error::` message if Discussions isn't enabled or the expected category is missing. Dropped the dependency on `vars.DISCUSSION_*` and removed every `if: steps.validate.outputs.ids_ok == 'true'` gate.
### Changed
- **README + README.vi badges** bumped to `3.4.1`.
### Notes
- This is a webapp + CI hotfix. No Python pipeline changes, no Tauri / Rust binary boundary change — `Cargo.toml` and `tauri.conf.json` stay at `0.1.1`, no THIRD_PARTY entries change.
- The leftover `DISCUSSION_REPO_ID` / `DISCUSSION_ANNOUNCEMENTS_CATEGORY_ID` / `DISCUSSION_GENERAL_CATEGORY_ID` repo variables (if you set them earlier) are now unused and can be removed from Settings → Variables.
---
## [3.4.0] - 2026-05-16 (Periodic refresh workflows + UTF-8 round-trip fix)
### Added
- **Update reviews — bi-weekly workflow.** New `scripts/update_reviews.py`, wrapper `bash/update_reviews.sh`, and `.github/workflows/update_reviews.yml` re-scrape every existing game's itch.io page on the 1st and 15th of each month (05:00 UTC) and write fresh `rating` + `rating_count`. Network errors / 404 keep the old values. Touches only those two fields — everything else (annotations, metadata) is left alone.
- **Update status — monthly workflow.** New `scripts/update_status.py`, `bash/update_status.sh`, and `.github/workflows/update_status.yml` refresh the `status` field on the 1st of each month (06:00 UTC). Same skip-on-error semantics.
- **Force update — manual emergency button.** New `scripts/force_update.py`, `bash/force_update.sh`, and [`.github/workflows/force_update.yml`](../../.github/workflows/force_update.yml) accept an optional `url` input. Empty input re-scrapes every game; a single URL targets just that one. `workflow_dispatch` only — no schedule. Every run preserves the three user-editable annotations (`safe_virus`, `notes`, `nsfw`) per the read/write field convention in [CLAUDE.md](../../CLAUDE.md). Doubles as the canonical repair tool for mojibake left by older webapp commits — re-scrape pulls clean UTF-8 from itch.io.
- **`generate_table.yml` chained on the three new workflows** so `lists/*.md` stay in sync after any data mutation.
### Fixed
- **UTF-8 mojibake on webapp commits.** `webapp/src/lib/github/contents.ts` `readFileWithSha` and `webapp/src/lib/github/git-data.ts` `bulkDeleteGames` were decoding GitHub's base64 content with `atob` alone, producing a Latin-1 binary string. Multi-byte UTF-8 sequences (e.g. Vietnamese `ã` = `0xC3 0xA3`) became two Latin-1 code points (`ã`); the next write re-encoded them as UTF-8 bytes, double-corrupting on every edit. Confirmed live damage in `data_game/game_info_002.json` (`BotÃÂão Esquerdo` was originally `Botão Esquerdo`). Extracted a shared helper `webapp/src/lib/github/encoding.ts` (`base64ToUtf8` / `utf8ToBase64`) that uses `TextDecoder('utf-8')` / `TextEncoder` and routes both call sites through it. Write path was already correct.
### Notes
- **Repair existing mojibake**: after this release deploys, run `Force update` once via `workflow_dispatch` with no input. It re-scrapes every game (~15–25 min) and writes back clean UTF-8 while preserving manual annotations. `generate_table.yml` will then auto-regenerate the markdown lists.
- **Browser cache**: anyone editing via the webapp should hard-refresh once after the new build lands so they're not using the pre-fix bundle (which would continue to mangle non-Latin chars on the next edit).
- **README + README.vi badges** bumped to `3.4.0`. No Tauri / Rust binary change — `Cargo.toml` and `tauri.conf.json` stay at `0.1.1`.
+97
View File
@@ -0,0 +1,97 @@
# Changelog — 3.5.x
Release notes for 3.5.0 – 3.5.2, newest first. Every version: [CHANGELOG.md](../../CHANGELOG.md).
## [3.5.2] - 2026-05-23 (Dead-code cleanup — knip + vulture)
### Added
- **knip** (v6) wired into the webapp as the unused-files / exports /
dependencies detector — config in [`webapp/knip.json`](../../webapp/knip.json),
run via `cd webapp && npm run knip`.
- **vulture** configured for the Python pipeline (`[tool.vulture]` in
[`pyproject.toml`](../../pyproject.toml)) — it catches dead functions, classes, and
attributes that ruff's `F` rules don't.
- **[`docs/THIRD_PARTY.md`](../../docs/THIRD_PARTY.md)** — a new doc attributing the
dev-only tooling (knip, vulture, ruff, ESLint, TypeScript), cross-linked from
[`docs/ACKNOWLEDGEMENTS.md`](../../docs/ACKNOWLEDGEMENTS.md).
### Removed
- **8 unused webapp dependencies**: `react-hook-form`, `@hookform/resolvers`,
`zod`, `idb-keyval`, `@radix-ui/react-dropdown-menu`,
`@radix-ui/react-tooltip`, `@tauri-apps/plugin-http`, `@tauri-apps/api`.
- **The unwired Tauri Phase-8b scrape-preview scaffold** —
`webapp/src/lib/tauri-scrape.ts` and `getRuntimeInfo` / `RuntimeInfo` in
[`runtime.ts`](../../webapp/src/lib/runtime.ts). It was documented but never wired
into any UI; [`webapp/TAURI.md`](../../webapp/TAURI.md) was trimmed to match.
- **~20 unused webapp exports / types** — dead helpers (`findChunkFor`,
`indexByUrl`, `rawUrl`, `useIndex`, `isIdleExpired`, …), the unused
`EDITABLE_FIELDS` / `READONLY_FIELDS` constants, and 7 unused shadcn/ui
primitive exports. Exports used only inside their own module were demoted
from `export` rather than deleted.
### Changed
- `webapp/src/lib/about.ts` `THIRD_PARTY` array trimmed to match the removed
dependencies.
### Notes
- DX / code-quality only — no runtime behaviour change. `isIdleExpired` was
already dead (nothing called it), so PAT idle auto-lock is unchanged — still
not enforced.
- No Tauri / Rust binary boundary change — `Cargo.toml` and `tauri.conf.json`
stay at `0.1.1`. The Rust `tauri-plugin-http` crate is now unreferenced from
the front-end — a candidate for a future Rust-side cleanup.
- knip + vulture join `npm run lint`, `ruff check`, and `npm audit` as the
standing pre-release QA pass.
---
## [3.5.1] - 2026-05-20 (Lint cleanup — zero ESLint problems)
### Changed
- **`npm run lint` now runs clean — 0 errors, 0 warnings** (down from 17 errors + 5 warnings, all pre-existing; v3.5.0 added none).
- [`webapp/eslint.config.js`](../../webapp/eslint.config.js): `react-refresh/only-export-components` is turned off for `src/components/ui/**` — the vendored shadcn primitives intentionally mix component and variant/constant exports and cannot satisfy the rule without forking upstream. The rule stays on for all other app code.
- `react-hooks/incompatible-library` is turned off — it only flagged TanStack Table's `useReactTable`, whose API is not React-Compiler-memoizable by design (not actionable).
- **`SortableHeader` extracted** into its own [`webapp/src/components/data-table/sortable-header.tsx`](https://github.com/poli0981/free-games-itchio-list/blob/v3.5.1/webapp/src/components/data-table/sortable-header.tsx); [`columns.tsx`](https://github.com/poli0981/free-games-itchio-list/blob/v3.5.1/webapp/src/components/data-table/columns.tsx) is now a pure column-definition module.
### Fixed
- **`react-hooks/exhaustive-deps`** in [`routes/games.tsx`](../../webapp/src/routes/games.tsx) and [`data-table/faceted-filter.tsx`](https://github.com/poli0981/free-games-itchio-list/blob/v3.5.1/webapp/src/components/data-table/faceted-filter.tsx): values built with `?? []` created a fresh array every render, defeating the `useMemo`s that depended on them. `data` is now wrapped in `useMemo`; the faceted-filter `selected` memo was restructured to depend on a stable value.
### Notes
- DX / code-quality only — no runtime behaviour change. No Tauri / Rust binary change (`Cargo.toml` / `tauri.conf.json` stay `0.1.1`); no `THIRD_PARTY` change.
---
## [3.5.0] - 2026-05-20 (Charts expansion + game-count history + pipeline cleanup)
### Added
- **Six new charts on `/charts`.**
- **Game count over time** — a `LineChart` of the catalog size by day, backed by a new `data_game/count_history.json` (date-keyed `{date, total}` series). [`scripts/data_store.py`](../../scripts/data_store.py) `_append_count_history()` upserts today's total on every catalog write (last-write-wins per UTC day). `scripts/backfill_count_history.py` is a one-time dev tool that reconstructs the series from git history (`data_game/index.json`, plus the pre-refactor `scripts/game_info.json`). The webapp loads it via `loadCountHistory` / `useCountHistory`.
- **Genre treemap** — a Recharts `Treemap` with a custom cell renderer that hides labels on rectangles too small to fit them, so it stays legible on mobile.
- **KPI summary cards** — total games / online / NSFW / deleted / average rating, above the Overview grid.
- **Deletions over time** (bar, by month), **Deletion reasons** (pie: became-paid vs page-removed), and **Most rated games** (top 10 by `rating_count`).
- **Scroll-to-top button** — a floating bottom-right button that appears after scrolling the main pane. New [`webapp/src/components/scroll-to-top.tsx`](../../webapp/src/components/scroll-to-top.tsx).
- **Python linting** — `ruff` config in a new root `pyproject.toml`; run `ruff check scripts/`.
### Changed
- **`charts.tsx` split into a module.** The monolith is now a `webapp/src/components/charts/` folder — one file per chart, a shared `chart-card.tsx` (`ChartCard` + `PALETTE`), and an `index.ts` barrel. 16 charts across the 4 tabs.
- **`scripts/json_io.py`** — new shared module. `load_json` / `save_json` (previously copy-pasted into both `check_alive.py` and `check_paid.py`) live here now, alongside `dedup_deleted`.
- README + README.vi badges bumped to `3.5.0`.
### Fixed
- **The deleted-games log can no longer accumulate duplicate URLs.** `check_alive.py` and `check_paid.py` appended to `scripts/deleted_games.json` with no guard — a game removed, re-added by the scraper, then removed again would be logged twice. The new `dedup_deleted()` (keyed by URL, keeping the earliest `deleted_at`) runs on every write and inside `log_deleted.py`. Two genuinely different games that share a title but have different urls are kept separate.
### Notes
- No Tauri / Rust binary boundary change — `Cargo.toml` and `tauri.conf.json` stay at `0.1.1`, no `THIRD_PARTY` entries change (Recharts already shipped; `Treemap` / `LineChart` need no new dependency).
- `data_game/count_history.json` is auto-committed by the scrape workflows — the bash wrappers already `git add data_game/` wholesale, so no workflow changes were needed.
- The dead-code sweep found the project already tidy (TS strict mode + ESLint catch unused webapp code). `webapp/src/lib/tauri-scrape.ts` `tauriScrapePreview` was reviewed and intentionally kept as a Phase-8b stub.
+72
View File
@@ -0,0 +1,72 @@
# Changelog — 3.6.x
Release notes for 3.6.0 – 3.6.1, newest first. Every version: [CHANGELOG.md](../../CHANGELOG.md).
## [3.6.1] - 2026-06-12 (Hotfix — desktop build vs broken `time` 0.3.48)
### Fixed
- **v3.6.0's desktop installers never built**: `time` 0.3.48 (released
2026-06-12, hours before the v3.6.0 tag) fails to compile inside
`tauri-utils` with `E0119: conflicting implementations of trait From<…>`
([time-rs/time#783](https://github.com/time-rs/time/issues/783)). Since no
`Cargo.lock` is committed, CI resolved the broken release fresh.
`webapp/src-tauri/Cargo.toml` now pins `time = "=0.3.47"` (the version every
release through v3.5.2 built with) — remove the pin once the upstream fix
ships.
### Notes
- Web feature set is identical to v3.6.0; this tag exists to produce the
desktop installers. `about.ts` version bump also busts the new IndexedDB
catalog cache, which is harmless.
- No Tauri version bump (`Cargo.toml` / `tauri.conf.json` stay `0.1.1`) — a
dependency pin to the previously-resolved version changes no binary
behavior.
---
## [3.6.0] - 2026-06-12 (i18n EN/VI + offline cache + custom error pages)
### Added
- **Bilingual UI (English / Tiếng Việt)** — a minimal typed i18n layer
([`webapp/src/lib/i18n/`](../../webapp/src/lib/i18n)) with ~340 keys covering every
route, dialog, chart, and toast. The Vietnamese dictionary is a **lazy-loaded
chunk**: it is only downloaded the first time the language is switched to VI
(or on startup when VI is the persisted preference). Switcher lives in
Settings → Appearance; the preference persists in `webapp.prefs`.
- **Offline-first catalog cache** — the react-query cache for the public
catalog queries (`db`, `deleted`, `count-history`) now persists to
**IndexedDB** (`@tanstack/react-query-persist-client` +
`@tanstack/query-async-storage-persister` + `idb-keyval`). Revisits paint
instantly from cache (~2 MB of JSON no longer re-downloaded cold) and
revalidate in the background. Cache busts automatically on each release
(`buster = APP.version`, `maxAge` 7 days). PAT-gated data is never persisted.
- **Custom error pages** — a status-aware
[`ErrorPage`](../../webapp/src/components/error-page.tsx) (400, 401, 403, 404, 408,
419, 429, 500, 502, 503, 504, offline, unknown) wired into every route's
error branch with the *real* HTTP status (`fetchRaw` now throws a typed
`HttpError`), plus:
- a route-level **ErrorBoundary** that detects stale-chunk failures after a
redeploy and offers a one-click reload ("New version available"),
- a hidden `/#/errors/:code` preview route,
- a static `webapp/public/404.html` served by
GitHub Pages for bad path URLs (bilingual, dark-mode aware, zero JS).
### Changed
- `ReactQueryDevtools` is now explicitly gated behind `import.meta.env.DEV`.
- Game thumbnails render through a shared
[`GameThumb`](../../webapp/src/components/game-thumb.tsx) that falls back to the
muted placeholder when a cover 404s; the Settings avatar is now lazy-loaded.
- `idb-keyval` returns (removed as unused in v3.5.2 — it has a real consumer
now); `THIRD_PARTY` in `about.ts` lists the three new data-layer deps.
### Notes
- The About page's legal/credits data intentionally stays English (controlling
language for legal interpretation); Vietnamese policy docs remain under
[`docs/i18n/vi/`](../../docs/i18n/vi).
- No Tauri / Rust binary boundary change — `Cargo.toml` / `tauri.conf.json`
stay at `0.1.1`.
+70
View File
@@ -0,0 +1,70 @@
# Changelog — 3.7.x
Release notes for 3.7.0 – 3.7.1, newest first. Every version: [CHANGELOG.md](../../CHANGELOG.md).
## [3.7.1] - 2026-06-14 (Hotfix — desktop build vs invalid Tauri NSIS license key)
### Fixed
- **v3.7.0's desktop installers never built.** The NSIS EULA was wired via
`bundle.windows.nsis.license`, but `@tauri-apps/cli` 2.11.0's `NsisConfig`
has no `license` key (it was added in a later release), so every platform
failed config validation at the `Build Tauri app` step. Switched to the
top-level `bundle.licenseFile` (valid in 2.11.0) pointing at an **RTF** EULA
([`webapp/src-tauri/installer/EULA.rtf`](../../webapp/src-tauri/installer/EULA.rtf)).
RTF satisfies **both** Windows bundlers — WiX (`.msi`) requires RTF and NSIS
(`.exe`) auto-detects it — so both installers show the "I Agree" page. The
previous plain-text `EULA.txt` would also have broken the WiX/`.msi` build.
### Notes
- Web feature set is identical to v3.7.0 (which deployed fine); this tag exists
to produce the desktop installers. `about.ts` version bump also busts the
IndexedDB catalog cache, which is harmless. No Tauri version bump
(`tauri.conf.json` stays `0.1.1`).
---
## [3.7.0] - 2026-06-14 (Legal-acceptance gates + per-tab chart lazy-loading)
### Added
- **First-launch legal-acceptance gate** — on first visit (and in every fresh
incognito session, since `localStorage` starts empty there) the app shows a
full-screen, non-dismissible gate before the main UI. It links the License,
EULA, Privacy Policy, Disclaimer, Terms of Use, Code of Conduct, and Security
Policy (reusing `LEGAL_LINKS`), and requires ticking a checkbox to continue.
New component [`webapp/src/components/legal-gate.tsx`](../../webapp/src/components/legal-gate.tsx),
built on raw Radix Dialog primitives (focus-trapped, no close-X, Esc /
outside-click disabled). Acceptance persists as `acceptedLegalVersion` in the
existing `webapp.prefs` localStorage blob — **no cookie** (consistent with the
"no cookies" privacy stance). A `LEGAL_VERSION` constant
([`webapp/src/stores/prefs.ts`](../../webapp/src/stores/prefs.ts)) lets a future
policy edit re-prompt every user with a one-line bump.
- **Windows installer EULA page** — both Windows installers (the NSIS `.exe`
and the WiX `.msi`) now show an "I Agree" license step before installing,
wired via the top-level `bundle.licenseFile` →
[`webapp/src-tauri/installer/EULA.rtf`](../../webapp/src-tauri/installer/EULA.rtf).
RTF is used so both bundlers render it (WiX requires RTF; NSIS auto-detects
it). The in-app gate above covers first-run consent on macOS / Linux, whose
installers have no equivalent step.
### Changed
- **Charts route split into four lazy per-tab chunks**
([`webapp/src/components/charts/tabs/`](../../webapp/src/components/charts/tabs)).
Each tab imports its chart components directly (the `charts/index.ts` barrel
was removed so the bundler keeps each tab's components in its own chunk).
Result: only the default **Overview** tab's components load when `/charts`
opens; the Reach / Quality / Discovery component code downloads on first
click. Recharts itself (the ~380 KB `vendor-charts` chunk) still loads with
Overview — unavoidable since the default tab renders charts — but it was
already deferred to the lazy `/charts` route, so it never touches app startup.
- `about.ts` version → 3.7.0 (also busts the IndexedDB catalog cache, harmless);
Claude Code co-author credit updated to Opus 4.8.
### Notes
- Images, routes, and OpenPGP were already lazy-loaded; this release closes the
remaining gap (charts). No Tauri version bump (`tauri.conf.json` stays
`0.1.1`) — the NSIS license is a bundler-config addition, not a binary change.
+37
View File
@@ -0,0 +1,37 @@
# Changelog — 3.8.x
Release notes for 3.8.0, newest first. Every version: [CHANGELOG.md](../../CHANGELOG.md).
## [3.8.0] - 2026-06-15 (Android APK target 📱)
### Added
- **Android APK build & packaging via Tauri mobile.** The same React + Tauri app now ships as a
sideloadable **arm64-v8a `.apk`** (no Play Store), built and **post-signed** (`zipalign` →
`apksigner`) by [`.github/workflows/release_android.yml`](../../.github/workflows/release_android.yml)
and attached to the same draft Release as the desktop installers (manual `workflow_dispatch`
uploads it as a downloadable workflow artifact instead). `gen/android` stays gitignored — signing
is a post-build step, not a Gradle edit. New repo secrets: `ANDROID_KEYSTORE_BASE64` /
`ANDROID_KEYSTORE_PASSWORD` / `ANDROID_KEY_ALIAS`. Full build/signing docs in
[`webapp/TAURI.md`](../../webapp/TAURI.md).
- **Mobile UX** — the Android hardware / gesture back button is wired to in-app router history
(`useBackButton`), safe-area insets are respected, and the sidebar shows a platform-aware badge
("Mobile app" / "Desktop app").
- Added dependency: `@tauri-apps/api`.
### Changed
- **Bundle `identifier` is now alphanumeric** — `com.poli0981.freegamesitchio` (was the hyphenated
`com.poli0981.free-games-itchio-webapp`). Android rejects hyphens in the app id (`android init`
panics) and Tauri's validator rejects underscores, so alphanumeric is the only form valid on
both. Tauri uses one identifier across all platforms, so this also changed the **desktop** bundle
ID (a one-time OS-level reinstall).
- **Realigned versions** — `tauri.conf.json` / `Cargo.toml` / `about.ts` set to `3.8.0` (was a
long-standing `0.1.1` vs `3.x` drift), so `versionCode` / `versionName` are sensible and
monotonic.
### Notes
- CI: the Android JDK setup must **not** use `cache: gradle` — `gen/android` is gitignored and
generated mid-job, so there are no gradle files at checkout to key on (it hard-fails). rust-cache
+ npm cache still apply.
+36
View File
@@ -0,0 +1,36 @@
# Changelog — 3.9.x
Release notes for 3.9.0, newest first. Every version: [CHANGELOG.md](../../CHANGELOG.md).
## [3.9.0] - 2026-06-15 (Android minSdk → 11 / API 30)
### Changed
- **Android APK floor raised from API 24 (Android 7.0) to API 30 (Android 11).**
`minSdkVersion` in [`webapp/src-tauri/tauri.conf.json`](../../webapp/src-tauri/tauri.conf.json)
`bundle.android` is now `30`. Because Android's package installer refuses any APK whose
`minSdkVersion` exceeds the device API level, this **is** the install block — the app simply
can't install on Android < 11 ("app not installed / incompatible"); no runtime check by design.
Rationale, stated honestly:
- **Not a JS-feature floor** — the System WebView is independently updatable down to API 24, so
SubtleCrypto / OpenPGP.js / IndexedDB / ES2020 already work on older OSes. That's not the
binding constraint.
- **Security + patch availability** — Android 11 added scoped-storage enforcement, one-time /
auto-reset permissions, and a tighter sandbox; pre-11 releases are also off Google's AOSP
monthly Security Bulletins (Android 10 ended 2023-03-06, Android 11 ended 2024-02-05; only
14 / 15 / 16 remain as of mid-2026).
- **Tested range** — we validate only on Android 11+ (emulator 11 → latest; real phone
vivo 1907 / Android 12 — see [`docs/pc_spec.md`](../../docs/pc_spec.md)). Shipping an untested floor
was the real risk.
- **Reach cost is small** — API 30+ ≈ 86.9% of active devices (was 96.6% at API 24); only the
pre-2020 long tail is dropped.
Data sources: [endoflife.date/android](https://endoflife.date/android),
[Android Security Bulletins](https://source.android.com/docs/security/bulletin),
[StatCounter version share](https://gs.statcounter.com/android-version-market-share/mobile/worldwide/) (May 2026),
[apilevels.com](https://apilevels.com/) (StatCounter cumulative distribution, Apr 2026).
### Notes
- `versionCode` re-derives to `3009000` (see the Android `versionCode` gotcha in [CLAUDE.md](../../CLAUDE.md)). The web and desktop builds are unaffected by
the Android floor. The `about.ts` version bump busts the IndexedDB catalog cache (harmless).
+167
View File
@@ -0,0 +1,167 @@
# Changelog — 4.0.x
Release notes for 4.0.0, newest first. Every version: [CHANGELOG.md](../../CHANGELOG.md).
## [4.0.0] - 2026-09-18 (freeitchgames.win on Cloudflare: read-only site, review queue, new design)
Version 4 moves the website to **https://freeitchgames.win** on Cloudflare, makes it read-only for
everyone (no sign-in), adds a maintainer-only admin with a review queue for new games, replaces the
failing data crawls with a rotating refresh, and splits the licenses (code MIT, data and docs
CC BY 4.0).
### Upgrade notes
- **The web app no longer signs in or edits.** The GitHub-token (PAT) sign-in, in-app editing, the
Add / Workflows pages and GPG commit signing are gone; on first load the app deletes the
encrypted token and key it stored before. Suggest games at https://freeitchgames.win/suggest.
- **Old links keep working**: `…github.io/free-games-itchio-list/#/x` redirects to the new site,
and `#/x` links become `/x`.
- **Desktop and Android apps** are read-only viewers too; they read the catalog from
freeitchgames.win. Install 4.0.0 over 3.x as usual.
- **New legal terms** (ToS, Privacy Policy, EULA for the apps only, Disclaimer): the site asks you to
accept them again once.
### New design
- A clean, table-first interface under the name **Free Itch Games**: a top navigation bar with a
global search (press `/`) and a display menu (theme, language, density, 18+) replaces the
sidebar, and a **Welcome** page at `/` (catalog status, recently added games) replaces the
dashboard.
- **Games**: search plus filters for genre, platform, status, tags, language, input, engine,
minimum rating and "plays in browser", each showing how many games it would match. The search,
filters, sort and page are kept in the URL, so a filtered list can be bookmarked or shared. Phones
get a list layout.
- A new game page (cover, key facts, tags that open the matching list, "Report a problem"), a
searchable removed-games page and a simpler Settings page.
- The first-visit legal gate is now a dialog over the page, so a shared link opens where it
pointed once the terms are accepted.
- Tailwind CSS 4, the self-hosted Geist typefaces, new icons and social preview image; numbers and
dates follow the chosen language.
### Website & Worker
- The site is served by a Cloudflare Worker with static assets ([`webapp/wrangler.jsonc`](../../webapp/wrangler.jsonc),
[`webapp/worker/`](../../webapp/worker)) and the catalog JSON is bundled into every build (`/data/*`,
plus a sitemap), so each data commit republishes the site; the desktop/Android apps read the same
files. Real URL paths instead of `#/` routes, per-page canonical URLs, and real 404s for unknown
pages and missing files (a stale script after a deploy can no longer be cached as HTML).
- **Cover images** are resized once to small WebP copies (Cloudflare Image Transformations + R2)
and served from `/img/…` — about 4 KB instead of up to 3 MB per cover. Only catalog covers are
served.
- **18+ games are hidden by default**; a visitor can show them (Settings or the display menu) after
confirming they are 18 or older (stored only in their browser). The removed-games page is now
`/removed` (`/deleted` redirects there). Aggregate, cookieless Cloudflare Web Analytics.
- Enforced Content-Security-Policy and security headers; faster first load (~175 KB gzip, charts
load only when opened); browser floor Safari/iOS 15.4.
- React Router 8, React 19.3, Vite 8 (rolldown), vitest; unused sign-in dependencies (Octokit,
OpenPGP.js) removed; Tauri drops its HTTP plugin and `Cargo.lock` is committed.
### Adding games: review queue
- **Suggest page** (`/suggest`): anyone can send an itch.io link (+ optional note); protected by
Cloudflare Turnstile and a rate limit.
- **Browser extension API** (`POST /api/ingest`, Cloudflare Access service token, idempotent) —
the extension no longer needs a GitHub token.
- **RSS discovery**: every 4 hours the Worker reads one itch.io "new & popular free" feed.
- Everything lands in a **review queue** (Cloudflare D1). The maintainer approves or rejects it in
the new **admin** (`/admin`, Cloudflare Access), which also edits the three maintainer fields,
removes games with a public reason (deleting their resized covers) and restores removed games.
Approved games are committed by a GitHub App (verified commits) and scraped by the pipeline.
### Licenses & legal
- Code stays **MIT** (`LICENSE`, now "2025-2026 poli0981 (SkullMute)"); the catalog data
([`data_game/LICENSE.md`](../../data_game/LICENSE.md)) and the documentation are **CC BY 4.0**
([`LICENSES/CC-BY-4.0.txt`](../../LICENSES/CC-BY-4.0.txt)); creators' descriptions, cover images and
trademarks are excluded. [`NOTICE.md`](../../NOTICE.md) sums it up: not affiliated with itch.io.
- Rewritten Terms of Use (with a content-removal process), Privacy Policy (Cloudflare as
processor, exact browser storage, retention, rights under Vietnam's Law No. 91/2025/QH15 and the
GDPR), Disclaimer, Security Policy and Code of Conduct, in English and Vietnamese. The EULA now
covers only the desktop and Android apps. Contact addresses: legal@, privacy@, security@ and
takedown@freeitchgames.win.
- Issue templates: "Add games" points to the Suggest page, "Remove a game" gained a
rights-holder section; `CODEOWNERS` added.
### Fixed
- **freeitchgames.win served the unbuilt `webapp/` source tree** (blank page; `/package.json`,
`/src/*` publicly readable). The Vite web build now goes to `webapp/dist`, which
[`webapp/wrangler.jsonc`](../../webapp/wrangler.jsonc) deploys (`workers_dev`/`preview_urls` off).
- **All 15 Dependabot alerts / npm audit** — lockfile refreshed in-range (vite 8.3.0,
react-router-dom 7.18.4, postcss 8.5.28, patched transitive deps); `npm audit` reports 0.
- **Android release workflow** moved off Node 20 actions (setup-java v6, upload-artifact v7,
setup-android v4, checkout/setup-node v7), SHA-pinned, with a timeout and the tag passed via env.
- **`.gitattributes`** — `* text = auto` / `* eol = lf` were invalid (spaces around `=`); now
`* text=auto eol=lf` with binary rules, and legal/policy docs ship in source archives again.
- OG image, manifest (`start_url`/`scope`/`id` = `/`), canonical/og URLs, sitemap and robots now
point at freeitchgames.win; OG title no longer overflows.
### Data pipeline (rewrite)
- **One rotating refresh replaces four failing crawls.** `check_paid` / `check_alive` /
`update_reviews` / `update_status` each fetched all 2,600+ pages sequentially, overran their
job timeouts and — saving only at the end — lost every run since late June (with no alert,
because a timeout ends as *cancelled*). The new [`scripts/refresh.py`](../../scripts/refresh.py)
(`refresh.yml`, daily) checks one seventh of the catalog with **one request per game**, so every
game is re-checked weekly (~86% fewer requests to itch.io), and updates alive / paid / rating /
status (+ backfills release date, thumbnail, `updated_at`) from that single page.
- **Safer removals:** a game is removed only when the same 404/410 or paid status is seen again at
least 20 hours after it was first seen (single flaky responses no longer delete games). A
mass-change guard withholds removals — and alerts — when a run would remove or newly strike more
than max(10, 10%) of the games it checked (the signature of an itch.io markup change rather than
a real wave of paid games); withheld games stay withheld in later runs until a healthy check or
an explicit `allow_mass_removal` dispatch, checkpoints of an interrupted scan never remove games,
and `apply_patch.py` re-checks the limits. Overlapping scans can no longer undo each other's
newer checks.
- **Scan → patch → apply:** scanners emit a URL-keyed patch; [`apply_patch.py`](../../scripts/apply_patch.py)
applies it to the latest `main`, validates, and [`bash/commit_push.sh`](../../bash/commit_push.sh)
retries on push races. Concurrent writers (extension, workflows, future admin) no longer clobber
each other; checkpoints + an in-script deadline keep partial work.
- **Ingest** (`update.yml`, now runs as soon as the queue changes): canonical URLs, skips games in
the deleted log (the removed-then-re-added bug), retries transient failures (3 attempts at least
6 hours apart; rate limiting never counts) instead of dropping them, stamps `added_at`, and never
wipes links queued meanwhile. A dispatched `url` is processed first and kept in the queue until it
reaches a final outcome, and queued runs wait in FIFO order (`queue: max`) instead of replacing
each other.
- `force_update.yml` runs `refresh.py --full` in rotating batches (a full re-scrape no longer times out).
- Honest `FreeItchGamesBot` User-Agent, explicit 429 / Retry-After handling (capped), unbuffered
logs, run summaries, Discord alerts on failure / cancel / rate limit.
- `data_store.py` keeps games in their chunk and only writes changed bytes; `index.json` /
`count_history.json` change only when data does — no more no-op commits.
- New [`validate.py`](../../scripts/validate.py) (schema, canonical URLs, duplicates, index consistency)
gates every pipeline commit and runs in the new Python CI with a network-free pytest suite.
Normalized one invalid `safe_virus` value (`"y"` → `"Yes"`).
### Removed
- `lists/*.md` genre tables, `generate_md.py`, `generate_table.yml`, `deleted_games.txt`,
`log_deleted.*` — the catalog is web-only (freeitchgames.win).
- Telegram bot ingest (`bot-ingest.yml`, `game_via_bot` issue template) — retired.
- The web app's sign-in, editing, Add and Workflows pages, GPG signing, and the GitHub Pages
deployment (`deploy_webapp.yml`, `notify-deploy.yml`, `pages-redirect/`; Pages keeps serving the
redirect stub it last published).
- `notify-ci-failure.yml` (replaced by in-workflow notifications) and the old per-task bash wrappers.
### CI / security
- All actions SHA-pinned at current majors; `permissions: {}` by default with per-job grants;
reusable workflows pinned by SHA with only the secrets they need; script-injection patterns in
`announce-discussion.yml` fixed (and it now posts only for `CHANGELOG.md` changes).
- Release: one `create-release` job makes the draft that desktop (tauri-action v1, `releaseId`) and
Android upload into; release builds use no dependency caches. Publish with
`gh release edit vX --draft=false`.
- `.github/dependabot.yml` (npm / pip / actions / cargo), Python and web-app PR checks, and an
hourly check of main's latest Cloudflare Workers Build that posts each failed build to Discord
once (a `check_run` relay would miss the pipeline's own data commits).
- One refresh pipeline (scan → apply) runs at a time, so overlapping refresh / force-update runs
can't undo each other.
- Cancelling a refresh / force-update or a desktop release run now really stops it (`!cancelled()`
instead of `always()` on the push / build jobs).
### Changed
- The old GitHub Pages address serves a redirect stub that forwards to freeitchgames.win
(keeping `#/` routes) and deletes the old app's token and key storage on that origin.
- Security headers in [`webapp/public/_headers`](../../webapp/public/_headers) (CSP, Referrer-Policy,
frame denial, Permissions-Policy, COOP) and immutable caching for hashed `/assets/*`.
- Pipeline logs are unbuffered UTF-8.
+52
View File
@@ -0,0 +1,52 @@
# Changelog — 4.1.x
Release notes for 4.1.0, newest first. Every version: [CHANGELOG.md](../../CHANGELOG.md).
## [4.1.0] - 2026-09-24 (Verification check, readable charts, changelog folder)
Version 4.1 puts a quick Cloudflare Turnstile check in front of the website, makes the charts'
hover tooltips readable again, and moves this changelog into one file per version.
### Upgrade notes
- **Updated Privacy Policy, Terms of Use and EULA** (the new verification cookie; `.rpm` listed):
the site and the apps ask you to accept them again once.
- **Website**: the first visit, then about once every 48 hours, shows a short "Quick check" page run
by Cloudflare Turnstile. It usually passes by itself, and the page you opened loads right after.
- **Desktop and Android apps** have no check. Install 4.1.0 over 4.0.0 as usual.
### Added
- **Verification gate** (web only). Until a browser passes a Turnstile check, the Worker answers app
pages with a self-contained verification page ([`webapp/worker/gate-page.ts`](../../webapp/worker/gate-page.ts))
and `/img` covers with 403, so nothing of the site loads before the check. Passing sets
`__Host-fig_gate` (HttpOnly, host-only, an HMAC-signed issue time) for `BOT_GATE_TTL_HOURS` (48),
and the page reloads into the link that was asked for. `/data`, `/assets`, robots, sitemap, the
social image, `/api/*` and `/admin*` stay open. Verified search and link-preview bots pass with the
token a Cloudflare Transform Rule adds; clients that only claim to be a crawler get a 503. The gate
stays off until it is configured, and deleting `GATE_SECRET` switches it off at once
([`webapp/worker/gate.ts`](../../webapp/worker/gate.ts), [`docs/operations.md`](../../docs/operations.md)).
- `GET /api/verify` reports the pass. A tab whose pass ran out checks again when it is shown (or when a
cover fails) and reloads into the verification page.
### Fixed
- **Chart hover was hard to read**: the band behind the hovered bar was black and tooltips had no
background, because the chart colours wrapped the hex design tokens in `hsl()`. Tooltips now use the
popover colours, translated series names ("Games" instead of `count`), locale-formatted numbers,
each slice's share on the pies that cover the whole, and formatted dates on the game-count chart.
Clicking a chart no longer draws a black focus ring or pins the tooltip on the first item; keyboard
focus keeps the purple ring. Pie seams and treemap cells follow the theme.
- **Suggest form**: the Turnstile check now also requires this site's hostname and the `suggest`
action (a token from one page can't be spent on another), and answers 503 instead of "failed" when
Turnstile is unreachable.
- **Admin approvals** (live since 2026-09-20): the Worker accepts the GitHub App private key as GitHub
downloads it (PKCS#1), not only PKCS#8.
### Changed
- The changelog is split per version under [`changelog/`](../); [`CHANGELOG.md`](../../CHANGELOG.md)
is now the index, and old links to its entries still land on the right row.
- Docs brought up to date: the operations runbook (verification gate setup, Web Analytics injected by
the zone, a release checklist), the development setup, the READMEs, `CLAUDE.md` and the Tauri notes.
- [`webapp/public/_headers`](../../webapp/public/_headers): caching for the favicon and the web manifest.