Dependabot #190-#194 combined with Zustand 5.1.0, soupsieve 4.1, coverage 7.17.3, Ruff 0.17.5 and a cargo update (wry 0.57.2, tauri-plugin-opener 2.7.3), each past a 3-day cooldown; Wrangler 4.161.0 with regenerated Worker types; tapable held at 2.3.3. Version 4.6.2 with a short changelog entry.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The project moves to maintenance mode (stable, feature-complete): docs, templates and badges (EN + VI). Qodana analysis in CI for the TypeScript / JavaScript, Python and Rust projects, with the findings of its first reports fixed. Version 4.6.1.
Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
Accessibility pass for the website and the apps (WCAG 2.2 AA target) and the accessibility statement: root ACCESSIBILITY.md + docs/i18n/vi/ACCESSIBILITY.md, the accessibility issue form, a default PR template; focus management, the '/' shortcut switch, chart names and data tables, contrast tokens with a CI check, Windows contrast themes; a docs sync of verified mismatches; version 4.6.0 with the two deps sweeps since 4.5.0 (#176, #182).
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Every request that runs the Worker is counted per client (IPv4, or IPv6
/64): RL_SITE 120/min (app pages, public /api, the old apps' /data JSON,
misses), RL_IMG 600/min (covers), RL_ADMIN 300/min (/admin + /api/admin);
RL_SUGGEST 5 and RL_GATE 20 stay on top for their POSTs. Verified bots are
not counted. Over a limit: 429 + Retry-After 60 (JSON for the API, covers,
files and /data with CORS; a script-less EN/VI page for app pages). Fails
open.
Every rate-limit namespace moves to 8801-8806 (staging 8901-8906):
namespace ids are account-wide, and other Workers on the account use
1001-1006, so RL_SUGGEST / RL_GATE shared their counters.
docs/operations.md section 1 step 15: the zone's WAF rate-limiting rule as
the first layer (Free plan: one rule, IP, 10 s; 300 requests / 10 s).
[skip-discuss]
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The first SonarQube Cloud scan reported 57 issues. 45 are fixed in code, the 11 on the saved itch.io test pages leave the scan via .sonarcloud.properties, and css:S8776 (Tailwind's @utility nesting) is a false positive to mark on SonarQube Cloud.
Worker: trailing slashes and the gate cookie's padding are trimmed by trimEnd() instead of /\/+$/ (quadratic on the public 404 path); the feed and collection parsers lose their backtracking regexes; compareCodeUnits keeps the code-unit sorts (the rule's localeCompare is locale-dependent); Number.*, DEFAULT_SIZES, crypto.randomUUID; i18n-edit.mjs reads stdin. Pipeline: the NSFW notices are one selector list, either class (the rule's ".a.b" would need both), each tested; plain if-guards; update_info.main returns None; no plain-http adapter; [[ ]] in cf_build_status.sh.
Supply chain: requirements*.txt are hash-locked pip-tools compiles of requirements*.in (on Python 3.14, which Dependabot reads from the header), installed with --require-hashes --only-binary :all: in block scalars; npm ci --ignore-scripts in CI and the release builds (verified by manual release runs on all platforms); npm run cf:check.
Release 4.4.2: also ships the toolchain upgrade (#149, #154) and Dependabot #141-#148, #150, #152, #153. CLAUDE.md gotchas 40 and 41.
[skip-discuss]
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The browser extension (poli0981/itch-f2p-extension) and the Telegram bot (poli0981/telegram-scraper-bot) are archived. Removed: POST /api/ingest (ingest.ts, requireService, the idempotency store, RL_INGEST, ACCESS_AUD_INGEST; it never received a game), the admin's "Browser extension" auto-approve source and "Extension" queue label, and the About page's Telegram numeric-ID note. No D1 migration: the idempotency table and the 'ext' CHECK stay.
Policies (Privacy, ToS, EULA + installer RTF, Disclaimer, Security; EN + VI) drop the extension / ingest wording; Last updated 2026-10-16, LEGAL_VERSION unchanged. Docs, CLAUDE.md and pipeline comments updated.
Release 4.4.1 (also ships #131, #135, #136, #137).
[skip-discuss]
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Admin: add games from any list or itch.io collection (Check first, batches of 200, per-game ingest tracking from scripts/state/ingest_outcomes.json), followed collections and auto-approve run by the cron in one [auto] commit, bulk remove/edit up to 100 games in one commit, New games, Activity and Settings pages. D1 migration 0002 (applied to production before this merge). Policies (ToS, Privacy, Disclaimer, EN + VI) cover approval by the maintainer's rules; LEGAL_VERSION 2026-10-13.
Web: the theme button shows the theme in use, no dark-mode flash (pre-paint script, hash in three CSPs), Charts tabs stay mounted (no rebuilt charts or replayed animations), 300 ms entrances, scrollbar gutter on mouse devices.
Release 4.4.0 (changelog also covers #130).
[skip-discuss]
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Dependabot moved the npm package to 2.7.0 (#109) while Cargo.lock kept the crate at 2.6.0; `tauri build` refuses mismatched major/minor versions, so every v4.3.0 release build failed before compiling. `cargo update -p tauri-plugin-opener` locks 2.7.0 and drops the windows 0.61 crates only 2.6.0 used. Checked with `npx tauri info` and `cargo check --locked`.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
itch.io game pages now carry an "AI Disclosure" row (AI Assisted, then what it was used for), a "Content" row ("No generative AI was used", /games/tag-no-ai) and an "Accessibility" row. The scraper reads them into three optional fields (ai_disclosure, ai_content, accessibility), which the daily refresh keeps current; description becomes the creator's tagline (og:description), else the first sentence as before; whitespace inside titles and links is collapsed. A --full re-scrape keeps a known release_date / thumbnail (itch.io shows "Published" only for a few weeks).
Web app: "Generative AI" and "Accessibility" filters on /games (?ai=, ?access=), game-page rows, three charts (Overview: Generative AI; Discovery: Accessibility Features, What AI Was Used For). EN/VI strings, docs, changelog, version 4.3.0.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- Catalog packs: the build emits /data/pack/manifest-v1.json plus
content-hashed deflate-raw packs (columns + dictionaries); the site and
the apps read them (about 264 KB on a first visit instead of about 520 KB
of JSON). Descriptions live in their own packs and load on demand (a game
page: its chunk; a search: all of them).
- The IndexedDB cache is stored as compressed bytes by a small binary
persister (replaces @tanstack/query-async-storage-persister); fflate is
the lazy fallback where the browser has no Compression Streams.
- The readable /data/*.json goes only to apps 4.0-4.1.1 (Tauri Origin);
everyone else gets a 410 with links to the repository
(worker/legacy-data.ts, five positive run_worker_first entries).
- /img: exact width strings only, fallback originals and missing images
kept at the edge for a day, failed background puts are logged.
- Themed scrollbars and a "Hide scrollbars" setting (Settings and the
display menu); chart cards no longer block their list scrollbars.
- Policies (LEGAL_VERSION 2026-10-03): data reuse goes through the
repository. Docs, changelog and version 4.2.0.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- contact@ / legal@ / privacy@ / security@ / takedown@poli0981.dev
(Google Workspace aliases) replace the @freeitchgames.win addresses in
the policies (EN + VI), READMEs, issue templates, security.txt and the
installer EULA.
- Privacy Policy: Google Workspace replaces Cloudflare Email Routing as
the email processor (provider table, transfers, contact section).
- About page: website, contact email and the poli0981.dev/links hub;
mailto: links open without a blank tab; the apps may open mailto:.
- LEGAL_VERSION 2026-09-29, so the legal gate asks once more.
- Version 4.1.1 (about.ts, package.json, tauri.conf.json, Cargo.toml/lock).
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
The Privacy Policy said the Project's code sets no cookies and that
Turnstile runs only on the Suggest page. With the verification gate:
- Privacy (EN/VI): the Turnstile check before the site loads (about once
per 48 hours, verified bots exempt, /data open), the __Host-fig_gate
cookie (issue time + signature, 48 h, strictly necessary), the
webapp.gate storage entry, retention, Cloudflare's role.
- ToS (EN/VI): don't circumvent the verification check or share its cookie.
- EULA (EN/VI/RTF): list the .rpm package v4.0.0 already shipped.
- LEGAL_VERSION and the About page date → 2026-09-24, so the legal gate
asks everyone once more.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
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>
- Games marked nsfw=Yes are left out of the table, dashboard and charts
unless the visitor opts in (Settings -> Content, after confirming they
are 18+; stored only in this browser). Their detail pages show a notice
instead. The admin app still sees everything.
- /deleted is now /removed (301 from the Worker, redirect in the SPA,
sitemap and canonical updated); <html lang> follows the language.
- Legal links: the gate lists only the documents being accepted (ToS,
Privacy, Disclaimer, and the EULA inside the apps) and asks to confirm
the visitor is 16+; new "Licenses & notice", "Data license" and
"Content removal" links; the retired Telegram bot link is gone.
LEGAL_VERSION 2026-09-18, so everyone is asked once more.
- Version 4.0.0 in about.ts, package.json (+ "license": "MIT"),
tauri.conf.json (+ bundle copyright), Cargo.toml / Cargo.lock.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
BREAKING: the public web app has no sign-in anymore and uses real paths
(BrowserRouter); /add and /workflows are gone (admin comes in Phase 4).
Platform
- wrangler.jsonc: Worker (worker/index.ts) + static assets with SPA
fallback; only /img/* and /api/* run the Worker. R2 binding THUMBS,
`staging` env for the v4 pre-release Worker. worker-configuration.d.ts
from `wrangler types` (checked in CI with --check).
- vite-plugins/catalog-data.ts bundles data_game + deleted log into
dist/data (build fails on bad JSON / index mismatch), emits urls.json
(thumbnail allow-list) and a real-path sitemap; version.json carries
the build stamp so data-only rebuilds keep identical JS.
- Data is read same-origin from /data (Tauri: https://freeitchgames.win/data,
CORS *); chunks load with allSettled.
- worker/img.ts: /img/<160|640>/<itch path> serves a WebP rendered once
per image+width by Image Transformations and stored in R2 (edge cache
→ R2 → transform); catalog allow-list, fixed upstream host, hotlink
block, streamed original on transform failure, 403/404 upstream → 404.
15 vitest cases.
- Enforced CSP (same-origin + Web Analytics/Turnstile), cache headers for
/assets, /data, og/icons; security.txt; robots disallows /api, /admin.
App
- Remove PAT/GPG sign-in, bulk edit/delete, undo, workflow dispatch,
Octokit and OpenPGP (and ~220 write-path i18n keys); Settings keeps
language/theme/density/notifications only.
- react-router 8 (unified package), React 19.3, TanStack/Recharts/etc.
minors, Vite 8 rolldown codeSplitting groups; legacy #/ links are
rewritten to paths; old PAT/GPG localStorage keys are cleared; reload
once on vite:preloadError after a deploy.
- GameThumb uses the /img proxy (referrerPolicy no-referrer, N/A-safe).
Tauri
- Real CSP, drop the unused http plugin + capability, read-only
descriptions, rust-version 1.88, drop the time pin, commit Cargo.lock.
Also: remove the GitHub Pages redirect workflow/stub (deployed by v4
Phase 0); add scripts/i18n-edit.mjs (TS-parser based key maintenance for
en.ts/vi.ts).
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Ship the webapp as a sideloadable arm64-v8a .apk alongside the desktop
installers — the same React + Tauri app running in an Android WebView.
- Fix the bundle identifier to be Android-valid (alphanumeric — Android
rejects hyphens, Tauri rejects underscores):
com.poli0981.free-games-itchio-webapp -> com.poli0981.freegamesitchio.
release_desktop.yml now reads the macOS .pkg --identifier from config.
- Realign Tauri/Cargo/UI versions to 3.8.0 (sane, monotonic versionCode).
- Add bundle.android.minSdkVersion 24.
- New release_android.yml: arm64-v8a build, post-signed with zipalign +
apksigner (gen/ stays gitignored — no Gradle edits). Attaches to the
draft Release on a v* tag; uploads a workflow artifact on manual dispatch.
- Mobile UX: Android back button -> router history (useBackButton hook),
safe-area insets, platform-aware sidebar badge (Desktop/Mobile app).
- Add @tauri-apps/api dependency; docs in TAURI.md, README(.vi), CLAUDE.md.
Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
v3.7.0's desktop installers failed config validation on all platforms:
@tauri-apps/cli 2.11.0's NsisConfig has no `license` key (added in a later
release), so `bundle.windows.nsis.license` was rejected.
Switch to the top-level `bundle.licenseFile` (valid in 2.11.0) -> RTF EULA.
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.
Bumps about.ts version 3.7.0 -> 3.7.1; adds CHANGELOG [3.7.1]. Web feature set
is identical to v3.7.0.
Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Web: full-screen first-launch legal gate (LegalGate) blocks the app until the
user accepts the current LEGAL_VERSION; persists as prefs.acceptedLegalVersion
in localStorage (no cookie). Reuses LEGAL_LINKS; re-prompts on LEGAL_VERSION bump.
Built on raw Radix Dialog (focus-trapped, no close-X, Esc/outside-click disabled).
Desktop: Windows NSIS installer shows an EULA "I Agree" page via
bundle.windows.nsis.license -> src-tauri/installer/EULA.txt.
Charts: /charts split into four lazy per-tab chunks (charts/tabs/*). Each tab
imports its chart components directly (index.ts barrel removed) so the bundler
keeps each tab's components in its own chunk; non-default tabs' component code
loads only on activation. Recharts still loads with the default Overview tab.
Also: about.ts version -> 3.7.0 + Opus 4.8 credit; Privacy Policy localStorage
key note (EN + VI); CHANGELOG + CLAUDE.md updates.
Verified: eslint, tsc -b, knip, npm audit (0 vulns), ruff, vulture all clean;
browser smoke test of gate (appear / accept / persist / version-bump re-prompt)
and per-tab lazy loading (reach-tab + its charts load only on tab click).
Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
- time 0.3.48 (released 2026-06-12) fails to compile inside tauri-utils
(E0119 conflicting From impls, time-rs/time#783); with no committed
Cargo.lock, CI resolved it fresh and the v3.6.0 desktop build failed
- Pin time = "=0.3.47" in webapp/src-tauri/Cargo.toml (the version all
releases through v3.5.2 built with); remove once upstream fix ships
- Bump version badges, about.ts, CHANGELOG to 3.6.1 (web unchanged from
v3.6.0; no Tauri version bump - no binary behavior change)
Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
- Add tauri-plugin-single-instance v2, registered first in builder chain
- Bump desktop binary version 0.1.0 -> 0.1.1 (boundary change)
- Bump app version 3.2.0 -> 3.2.1, README badges, About page
Fixes duplicate-process bug: each launch used to spawn a new
free-games-itchio-webapp.exe instead of focusing the existing window.
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Rewrote the four English legal docs (DISCLAIMER, EULA, ToS, PrivacyPolicy) to
be tighter and more enforceable while keeping the project's voice — TL;DR, numbered
sections, definitions, severability, governing law (Vietnam), explicit "not legal
advice" notice, removal-request path. PrivacyPolicy now includes per-storage
table and PAT lifecycle steps.
Added Vietnamese translations for all six policy / community docs under
docs/i18n/vi/ plus a top-level README.vi.md. Each VI file notes that the English
version is the controlling text for legal interpretation.
About page: new "Legal & policies" Card listing Disclaimer, EULA, ToS, Privacy,
Code of Conduct, Security, License (MIT), and Changelog with a pointer to the
Vietnamese translations. New LegalLink interface + LEGAL_LINKS const in
webapp/src/lib/about.ts following the THIRD_PARTY/SOCIAL_LINKS pattern.
Optional UI:
- Tauri desktop: maximize button disabled (maximizable: false in
tauri.conf.json). Window remains resizable.
- DataTable: scrollbar hidden via new .scrollbar-hide Tailwind utility added to
webapp/src/index.css; scrolling still works.
Bookkeeping: README badge bumped to 3.1.4 + Vietnamese language badge + pointer
to README.vi.md and docs/i18n/vi/. CHANGELOG entry for 3.1.4.
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
- Add tauri-plugin-opener (Rust + JS) so external links open via the OS
browser on the desktop app. Capability scoped to opener:allow-open-url
for https://* only.
- New <ExtLink> component (webapp/src/components/ext-link.tsx) used app-wide
so the offline link bug can't recur.
- About page: new Developer card, Found-a-bug CTA, and Find-me-elsewhere
social grid (X, YouTube, 2x Discord, Patreon, Ko-fi, Steam, Bluesky,
Mastodon).
- Rewrite webapp/README.md from Vite boilerplate to actual webapp docs;
refresh CONTRIBUTING.md, docs/ACKNOWLEDGEMENTS.md, docs/My_Stuff.md, and
README.md with the new contact handles.
- Bump version badge to 3.1.2 + CHANGELOG entry.
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Two release-blocking fixes for v3.0.0.
## Tauri build was failing on every platform
tauri.conf.json referenced icons/32x32.png, icons/128x128.png,
icons/128x128@2x.png, icons/icon.icns, icons/icon.ico — none of which
existed. release_desktop.yml therefore failed at the bundle step on
all three runners.
Generated a 1024×1024 placeholder source PNG (blue panel + white "I"
glyph for Itch.io) and ran `tauri icon` to populate src-tauri/icons/
with the full standard set: the 5 desktop assets the conf needs, plus
the Windows Store / iOS / Android sizes Tauri's CLI emits by default
(harmless to ship; useful if the project ever targets mobile).
The 1024×1024 source itself is added to src-tauri/.gitignore — only
the generated icons are committed. Replacing the placeholder later is
just `npm run tauri icon -- path/to/new-source.png` + commit.
## Fine-grained PAT was getting 403 on workflow_dispatch
Settings page hint told users to give the PAT contents:write +
workflow:write. workflow:write controls editing .github/workflows/*.yml
files (which the webapp doesn't do); the actual call we make,
POST /actions/workflows/{file}/dispatches, requires Actions: Write
instead. Fine-grained PATs created from that hint hit 403; classic
PATs worked because the classic `workflow` scope happens to cover
both.
Rewrote the hint as a checklist:
- Contents: Read and write (edits / deletes / queueing URLs)
- Actions: Read and write (dispatching the scraper workflow)
plus a note that classic `workflow` tokens still work but grant
broader access.
SECURITY.md was already correct on this from the v3.0.0 docs pass.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
The same React build can now ship as a native Win/macOS/Linux app via
Tauri 2. Web users still get the GitHub Pages SPA; desktop users get
a ~10 MB installer that can scrape itch.io directly without CORS.
src-tauri/:
- Cargo.toml: tauri 2 + tauri-plugin-http 2, edition 2021. Release
profile uses panic=abort, lto=true, opt-level='s', strip — minimizes
the bundled binary.
- tauri.conf.json: window 1280x800 (min 900x600), bundle targets all
platforms, identifier com.poli0981.free-games-itchio-webapp.
- src/main.rs + src/lib.rs: minimal builder + one Tauri command
(runtime_info) so the frontend can confirm desktop mode.
- capabilities/default.json: scopes the http plugin to itch.io,
img.itch.zone, api.github.com, raw.githubusercontent.com.
Frontend plumbing:
- lib/runtime.ts: isTauri() probes window.__TAURI_INTERNALS__ to
branch features at runtime. getRuntimeInfo() lazy-imports
@tauri-apps/api/core only on desktop, so web bundles aren't bloated.
- lib/tauri-scrape.ts: tauriScrapePreview(url) uses the http plugin to
fetch an itch.io page and pulls og:title / og:description / og:image
out of the HTML. Full 23-field extraction stays in scripts/scraper.py
and runs in CI; porting to Rust is tracked as Phase 8b in TAURI.md.
- Sidebar gains a small "Desktop mode (Tauri)" badge above the theme
toggle when running native.
- vite.config.ts: when TAURI_ENV_PLATFORM is set, build to ./dist (not
../docs/app), drop sourcemaps, and target ES2022 — the bundled
WebView2/WKWebView/WebKitGTK all support modern JS.
- package.json scripts: tauri / tauri:dev / tauri:build.
CI:
- .github/workflows/release_desktop.yml: builds for macOS (universal),
Ubuntu 22.04, and Windows on tag v* via tauri-apps/tauri-action,
caches cargo with Swatinem/rust-cache, installs Linux WebKit deps,
and uploads the bundle to a draft GitHub Release.
Docs:
- webapp/TAURI.md: prereqs (rustup + platform deps), how to dev, how
to build installers, how to add new Rust commands, roadmap to a
full Rust scrape (Phase 8b).
.gitignore picks up the Cargo target/, generated gen/, and Cargo.lock
under src-tauri.
Note: Local `npm run tauri:dev` requires a Rust toolchain
(https://rustup.rs); the GitHub Actions workflow installs it
automatically. The web build still works without Rust installed.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>