Files
free-games-itchio-list/docs/dev_env.md
T
poli0981andClaude Opus 4.7 ac8db6ab1d release(v3.5.0): charts expansion, game-count history, pipeline cleanup (#46)
- Add 6 charts (game-count line, genre treemap, KPI cards, deletions
  over time, deletion reasons, most-rated) and split charts.tsx into a
  charts/ module (one file per chart, shared chart-card + palette).
- Track catalog size over time: data_store.py appends data_game/
  count_history.json daily; backfill_count_history.py seeds it from git.
- Add scripts/json_io.py with shared load/save and a URL-keyed
  dedup_deleted so the deleted-games log can't double-log re-added games.
- Add a scroll-to-top button and a ruff config (pyproject.toml).
- Refactor docs for v3.5.0 (CHANGELOG, README badges, CLAUDE.md).

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-20 13:32:52 +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 ../docs/app/ (NOT webapp/dist)
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