Files
free-games-itchio-list/CHANGELOG.md
T
poli0981andClaude Opus 5 6f4a956855 docs: v4.0.0 licenses, policies and documentation (v4 Phase 5)
Licenses
- Code stays MIT (LICENSE: 2025-2026 poli0981 (SkullMute)). The catalog
  data (data_game/LICENSE.md) and the documentation are CC BY 4.0 (full
  legal code in LICENSES/CC-BY-4.0.txt); creators' descriptions, cover
  images, names and trademarks are excluded. NOTICE.md: license map and
  non-affiliation with itch.io.

Policies (English + Vietnamese mirrors, dated 2026-09-18, applying from
4.0.0)
- Terms of Use now cover the website and the public data, with the
  content-removal / copyright process, prohibited uses (bulk scraping,
  /img abuse, /admin and ingest access, Suggest spam), 18+ opt-in and
  Vietnamese law with the consumer-rights reservation.
- Privacy Policy rewritten for Cloudflare as processor: exact browser
  storage, cookies, Turnstile, D1 retention (Suggest notes 180 days,
  idempotency 7 days), rights under Law No. 91/2025/QH15 and the GDPR.
- EULA covers only the desktop and Android apps (also the installer RTF).
- Disclaimer, Security Policy (private reporting, scope, safe harbor) and
  Code of Conduct (Contributor Covenant 2.1) rewritten; PAT, GPG and
  Telegram-bot material removed.

Docs and templates
- README / CONTRIBUTING (EN + VI), webapp/README, TAURI.md, dev_env
  (EN + VI), THIRD_PARTY, ACKNOWLEDGEMENTS; new docs/operations.md
  (Cloudflare + GitHub setup, v4 release order, routine tasks).
- CLAUDE.md rewritten for the v4 architecture; CHANGELOG [4.0.0].
- Issue templates: config.yml (Suggest page + private security reports),
  "Add games" points to /suggest, "Remove a game" gained a rights-holder
  section; PR templates updated; CODEOWNERS.
- Dependabot npm version updates resume with the v4 merge (limit 5).

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-18 17:55:02 +07:00

57 KiB
Raw Blame History

Changelog

All notable changes to this project will be documented here.

[4.0.0] - Unreleased (freeitchgames.win on Cloudflare: read-only site, review queue, new pipeline)

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.

Website & Worker

  • The site is served by a Cloudflare Worker with static assets (webapp/wrangler.jsonc, 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 in Settings 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 (~195 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.
  • Code stays MIT (LICENSE, now "2025-2026 poli0981 (SkullMute)"); the catalog data (data_game/LICENSE.md) and the documentation are CC BY 4.0 (LICENSES/CC-BY-4.0.txt); creators' descriptions, cover images and trademarks are excluded. 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 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 (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 applies it to the latest main, validates, and 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 (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 (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 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). 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, Android Security Bulletins, StatCounter version share (May 2026), 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 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.
  • 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). 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).

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, 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) 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. 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/). 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). 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/) 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 (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 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/.
  • 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, run via cd webapp && npm run knip.
  • vulture configured for the Python pipeline ([tool.vulture] in pyproject.toml) — it catches dead functions, classes, and attributes that ruff's F rules don't.
  • docs/THIRD_PARTY.md — a new doc attributing the dev-only tooling (knip, vulture, ruff, ESLint, TypeScript), cross-linked from 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. It was documented but never wired into any UI; 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: 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; columns.tsx is now a pure column-definition module.

Fixed

  • react-hooks/exhaustive-deps in routes/games.tsx and data-table/faceted-filter.tsx: values built with ?? [] created a fresh array every render, defeating the useMemos 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 _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.
  • 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 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.
  • 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 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. 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 gained four new cards backed by extended preferences in 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; toasts are gated through a new AppToaster wrapper that reads prefs.
  • Mobile card view for the games table. New webapp/src/lib/use-is-mobile.ts (matchMedia('(max-width: 767px)')) and webapp/src/components/data-table/mobile-card-list.tsx. Below the md breakpoint, DataTable 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 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 v2 in 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. Desktop binary boundary change → bumped Cargo.toml and 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 (shadcn pattern over the existing @radix-ui/react-dialog) and a MobileTopBar in 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. 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, icon-192.png, icon-512.png — Add to Home Screen on iOS without a service worker. Generator script: webapp/scripts/gen_assets.py.
  • SEO infrastructure. 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 and sitemap.xml added under webapp/public/.
  • OG image. webapp/public/og.png (1200×630) + og.webp generated by gen_assets.py. Brand-coloured (#863bff purple, cyan accent) with project name, tagline, and URL.
  • Per-route titles. New useDocumentTitle 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 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.vi.md, and the new issue template game_via_bot.yml. Vietnamese mirror in docs/i18n/vi/CONTRIBUTING.md.
  • Privacy + ToS clauses for the bot path. docs/ToS.md §14 and docs/PrivacyPolicy.md §15 (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 — 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 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 and the hero in 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:

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).


Added

  • Vietnamese translations under 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.

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) — 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.

[1.0.4] - 2026-01-11 (Added Games + New Features ⭐)

Added Games

Added 33 games. See #22 and #23.

New Features

  • Delete game with correct link in delete_game.py. See #20.
  • Export JSON → .csv/.xlsx in export_csv.py. See #21.
  • Check duplicate data in JSON file in check_duplicate.py. See #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.

[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): 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 for easy manual adds (Actions process daily).
  • Full docs: DISCLAIMER, PRIVACY, TERMS, EULA, SECURITY, CODE_OF_CONDUCT, CONTRIBUTING, ACKNOWLEDGEMENTS.
  • Issue and PR templates for bugs, features, and game submissions.
  • Badges, TOC, and example table in README.

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.