SonarQube Cloud analyses in GitHub Actions instead of Automatic
Analysis, with test coverage (sonarcloud.yml): token (skips Dependabot
and fork PRs, which get no SONAR_TOKEN) → coverage (pytest-cov and
Vitest v8, no secrets) → scan (sonarqube-scan-action v8.3.0, full
history, sonar.projectVersion from webapp/package.json).
sonar-project.properties replaces .sonarcloud.properties: tests marked
as tests, coverage exclusions for code without unit tests by design,
Python 3.14 (the analyzer has no 3.15 yet), binary images and the
SQLite migrations (claimed by the PL/SQL analyzer, which only warned)
left out.
Adds pytest-cov / coverage (dev lock recompiled on Python 3.14) and
@vitest/coverage-v8 (Dependabot group with vitest). Docs: CLAUDE.md
gotcha 41, THIRD_PARTY, dev_env, CONTRIBUTING (EN + VI).
Co-Authored-By: Claude Opus 5.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>
- Add webapp/wrangler.jsonc (Workers static assets from ./dist, SPA
fallback, workers_dev/preview_urls off) and build the web app to
webapp/dist. The config-less Workers Builds deploy was serving the raw
webapp/ source tree (blank page, /package.json and /src/* public).
- npm audit fix in-range (vite 8.3.0, react-router-dom 7.18.4, postcss
8.5.28, transitive fixes): closes all Dependabot alerts, audit = 0.
Add wrangler as a pinned devDependency, engines node >=22.22,
.node-version 24.
- public/_headers: Referrer-Policy, frame denial, Permissions-Policy,
COOP, CSP report-only; immutable cache for hashed /assets/*.
- release_android.yml: Node 24 action majors (setup-java v6,
upload-artifact v7, setup-android v4, checkout/setup-node v7),
SHA-pinned, timeout + concurrency, tag via env.
- GitHub Pages now publishes only a redirect stub (pages-redirect/)
that keeps #/ routes and clears the old PAT/GPG localStorage keys;
drop notify-deploy.yml.
- .gitattributes: fix invalid '* text = auto' / '* eol = lf'; binary
rules; stop export-ignoring README/policy docs. .gitignore: local
contacts/QR assets, wrangler state, .dev.vars, keystores.
- Scraper workflows: unbuffered UTF-8 logs; pause the schedules of
check_paid/check_alive/update_reviews/update_status (full passes over
2,600+ games exceed their timeouts and lose all work).
- Point canonical/og/manifest/sitemap/robots and doc links at
freeitchgames.win; regenerate OG image (fit title); interim Cloudflare
notice in the Privacy Policy.
Co-authored-by: Claude Opus 5 <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>
Bootstrap webapp/ subfolder with React 19 + TypeScript 6 + Vite 5 + Tailwind v3,
shadcn/ui base primitives (Button, Card), HashRouter + TanStack Query provider,
Sonner Toaster, sidebar nav with 8 routes (Dashboard, Games, Game Detail, Add,
Charts, Workflows, Deleted, Settings) + 404 fallback. All routes are skeleton
stubs ready for live data wiring in Phase 1+.
Vite config: base './' for relative asset paths, outputs to docs/app/ for
GitHub Pages deploy. Path alias @/* -> ./src/*.
Game type schema (23 fields) defined in types/game.ts. Slugify + formatNumber
helpers in lib/utils.ts.
docs/app/ added to root .gitignore — built output not committed; CI deploy
workflow will produce it (Phase 7).
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
When game_info.json reaches 500 entries, data is automatically split
into numbered files (game_info_001.json, game_info_002.json, etc.).
New data_store.py module handles load/save/rebalance for all scripts.
Also removes CSV export pipeline (export_csv.py, pandas dependency)
and cleans up unused files.
Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>