- 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>
- operations.md: verification gate setup (bot token, Transform Rule,
header check, GATE_SECRET last, smoke tests, off switch); Web Analytics
is injected by the zone (checked live), not a build token; staging is
deployed by hand from any branch; a release checklist replaces the
finished v4 release order; the unused repo secrets can go.
- CLAUDE.md: gate, chart and changelog notes, three new gotchas, current
counts, .rpm, announce-discussion.yml is local, current state.
- READMEs (EN/VI): the quick check, list layout on phones, .rpm,
TanStack Query only, the build monitor, cf_build_status.sh.
- dev_env (EN/VI): GATE_* secrets, PKCS#1 keys work as downloaded.
- webapp/README, TAURI.md, THIRD_PARTY.md, CONTRIBUTING (EN/VI): lazy
routes, .rpm, Cargo.lock is committed, squash or merge commit.
- _headers: caching for favicon.svg and the web manifest; comments.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Implements the approved mockup (Free Itch Games, dark and light).
- Tailwind CSS 4 via @tailwindcss/vite (no PostCSS / tailwind.config), design
tokens in src/index.css, tw-animate-css, self-hosted Geist / Geist Mono.
- A sticky top nav (global search with the / shortcut, display menu for
theme / language / density / 18+, phone sheet menu) and a footer replace the
sidebar; the window scrolls, with scroll restoration on back / forward.
- Welcome page at / (catalog status, features, recently added) replaces the
dashboard.
- Games: search, genre / platform / status / tags / language / input / engine,
minimum rating, plays-in-browser, sort and page live in the URL
(lib/game-filters.ts, unit-tested); facet counts ignore their own filter;
a table on desktop, a list on phones, 100 per page. Counts show the whole
catalog while 18+ games are hidden.
- New game detail page (breadcrumb back to the same list, facts, tags that
open the matching list, copy link, report a problem), searchable Removed
page, simpler Settings, restyled error pages and charts header.
- Legal gate is an overlay above the page (deep links land where they
pointed), with translated document names; no "Leave" button in the apps.
- Cached data stays on screen when a background refresh fails (offline).
- Numbers and dates follow the language (lib/format.ts).
- New favicon, PWA icons and OG image from the same tokens
(scripts/gen_assets.py uses the Geist fonts from node_modules).
- Removed: sidebar, dashboard, data-table components, TanStack Table /
Virtual, sonner and toast settings, the unused Select primitive; 81 unused
i18n keys; prefs now persist only the keys still in use.
- Review fixes: routers without startTransition (useSearchParams was stale,
so quick filter clicks and typed searches overwrote each other or pulled
the visitor back from a game); paging starts at the top and Back returns
to the old position; the 18+ confirmation is an in-app dialog
(window.confirm is a no-op in the macOS app); the apps show only the legal
gate until it is accepted (covers load from itch.io there); breadcrumb goes
back; named popovers, list semantics, IME-safe Enter, English plurals,
pointer cursor, --brand-soft without color-mix, copy-link fallback.
- wrangler.jsonc: id of the production D1 database (created by command,
0001_init applied); runbook notes that R2 must be enabled first.
- Docs: CLAUDE.md, CHANGELOG, webapp README / TAURI.md, THIRD_PARTY,
ACKNOWLEDGEMENTS, docs/operations.md; Dependabot groups for Tailwind 4.
Co-Authored-By: Claude Opus 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>
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>
- Wire in knip (webapp) and vulture (Python) as dead-code detectors
- Remove 8 unused deps, the unwired Tauri scrape-preview scaffold, and
~20 unused exports/types across the webapp
- Add docs/THIRD_PARTY.md attributing the dev tooling; trim TAURI.md
- Bump version badges, about.ts, and CHANGELOG to 3.5.2
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>