Files
free-games-itchio-list/docs/dev_env.md
T
poli0981andClaude Opus 5 1c600586a4 fix: deploy the real build to freeitchgames.win + Phase 0 hotfixes (#81)
- 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>
2026-09-18 16:26:06 +07:00

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/main only (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