- 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>
2.5 KiB
Development environment
Tooling the maintainer uses to write and test code in this repo. You don't need exactly the same setup to contribute — anything compatible with the required language toolchains works. This is for reproducibility.
IDEs
JetBrains 2026.x (paid lineup):
- PyCharm — Python pipeline (
scripts/,bash/wrappers). - WebStorm —
webapp/(React + TypeScript + Vite). - RustRover —
webapp/src-tauri/(Tauri 2 native shell).
VS Code, Sublime, vim, etc. all work fine; nothing JetBrains-specific is checked into the repo.
Language toolchains
| Stack | Required | Used for |
|---|---|---|
| Python | 3.12 | Scraper / data pipeline (scripts/) |
| Node.js | ≥ 22 (LTS) | Webapp build + dev server |
| npm | ships with Node 22 | Webapp deps |
| Rust | stable (via rustup) |
Tauri desktop build |
| Git | recent | Repo history + signed commits |
Quick start
Python pipeline
pip install -r scripts/requirements.txt # if/when present, else: beautifulsoup4 requests
python scripts/update_info.py
ruff check scripts/ # lint Python (pip install ruff; config in root pyproject.toml)
The pipeline reads scripts/temp_link.json (a JSON array of itch.io URLs)
and writes to data_game/game_info_NNN.json. See CLAUDE.md
for the data layer overview.
Webapp (web)
cd webapp
npm install
npm run dev # http://localhost:5173 with HMR
npm run build # writes to webapp/dist/ (web + Tauri)
npm run lint
Webapp (Tauri desktop)
cd webapp
npm run tauri:dev # native window + HMR
npm run tauri:build # native installers
Platform prerequisites (WebView2 on Windows 10, Xcode CLT on macOS,
libwebkit2gtk-4.1-dev on Debian/Ubuntu) are documented in
webapp/TAURI.md.
Mobile testing
Webapp UI changes that touch responsive layout, navigation, or the data
table must be smoke-tested on a real iOS device before tagging a release.
See pc_spec.md for the test devices.
Git hygiene
- Tag releases from
origin/mainonly (per release_pipeline note in CHANGELOG and CLAUDE.md). - Signed commits + signed tags via
gpg-agent(commit.gpgsign=true). - Never commit
webapp/dist/,webapp/src-tauri/target/,Cargo.lock, or a real GitHub PAT.
See also
pc_spec.md— hardware spec.webapp/TAURI.md— Tauri build details.CONTRIBUTING.md— contribution flows.