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:
1 parent
fdf0645829
commit
251369ede6
16 files changed
+972
-807
No files matched your search
@@ -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
@@ -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 🚀 |
|
||||
@@ -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.
|
||||
@@ -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.
|
||||
@@ -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.
|
||||
@@ -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>.
|
||||
@@ -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).
|
||||
@@ -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.
|
||||
@@ -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`.
|
||||
@@ -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.
|
||||
@@ -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`.
|
||||
@@ -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.
|
||||
@@ -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.
|
||||
@@ -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).
|
||||
@@ -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.
|
||||
@@ -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.
|
||||
Reference in new issue
Block a user