Files
free-games-itchio-list/docs/ACKNOWLEDGEMENTS.md
T
poli0981andClaude Opus 5.5 3e82f720dd Upgrade toolchain: TypeScript 7, Node 26, Python 3.15
TypeScript 7.0.2 (the native compiler) now runs `tsc -b` in `npm run build`.
It has no JavaScript API until 7.1, and typescript-eslint (peer
typescript <6.1) and scripts/i18n-edit.mjs need one, so the two are
installed side by side: `@typescript/native` = npm:typescript@^7.0.2
(bin tsc) and `typescript` = npm:@typescript/typescript6@^6.0.2 (the 6.0
API, bin tsc6). No tsconfig or source change: TS 7 reports 0 errors.

Node 26: webapp/.node-version 24 -> 26 (CI and both release workflows read
it), engines >=26, @types/node 26. npm 11.20 gates dependency install
scripts on `allowScripts`, so esbuild and workerd are approved by name.

Python 3.15: .python-version 3.14 -> 3.15, ruff target py315, urllib3
declared (scraper.py imports it). UTF-8 mode is the default since 3.15,
so the workflows drop PYTHONUTF8.

Dependabot: keep the `typescript` alias off new majors, group
@typescript/*, @types/node up to 26. Docs and CLAUDE.md follow (gotcha 6
rewritten, gotcha 38 for allowScripts).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-22 08:41:26 +07:00

5.0 KiB

Acknowledgements

This repo wouldn't exist without a lot of help — mostly from tools and platforms, because real humans don't talk to me :D

Special Thanks

  • Grok (xAI): Original non-judgmental buddy. Without Grok's infinite patience, code fixes, and late-night brainstorming, this whole thing would still be a half-baked idea in my unemployed brain. Carried the Python pipeline, the v2.0.0 rewrite, and 90% of the early weight. 🚀
  • Claude Code (Anthropic): Newer AI buddy. Built the v3.0.0 webapp + Tauri scaffold, shipped the v3.1.2 offline-link fix, the About page expansion, the v3.1.4 legal docs rewrite + Vietnamese i18n, and the v3.7.0 legal gate. Then the big one, v4.0.0: moving the site to Cloudflare (read-only website, Worker, admin app + review queue, the public Suggest page), the rewritten data pipeline, and this docs refresh. Different vibe than Grok ("let me confirm before nuking your repo"), same lifesaver energy. 🚀

Platforms & Tools

  • itch.io: The amazing platform full of indie gems that made this list possible. Thanks for hosting all these free games and having a scrape-friendly structure (mostly). (This project is not affiliated with itch.io — see NOTICE.md.)
  • Game creators: Every game in the catalog is someone's work. Descriptions and cover images stay yours — thanks for making free games.
  • Cloudflare: Hosts freeitchgames.win — Workers, R2, D1, Images, Turnstile, Access and friends keep the site fast and the spam out.
  • GitHub & GitHub Actions: For hosting the code and the data for free, running the daily refresh without me lifting a finger, shipping the release downloads, and hosting the Discussions where releases auto-announce themselves.
  • Python libraries: requests, BeautifulSoup — the real MVPs that make the scraping "kinda work".
  • Tauri: Turns the same web code into desktop apps and an Android APK.
  • Contributor Covenant: Our Code of Conduct is adapted from version 2.1.

Open-source libraries (website + apps)

The website, the Worker and the desktop / Android apps build on a stack of open-source libraries. The full list with licenses lives in THIRD_PARTY.md, and the runtime libraries are also on the About page (from the THIRD_PARTY array in webapp/src/lib/about.ts). Highlights:

  • Core: React 19, TypeScript 7, Vite 8, React Router 8, Zustand 5
  • UI: Tailwind CSS, tw-animate-css, shadcn/ui (pattern), Radix UI primitives, lucide-react, class-variance-authority, tailwind-merge, clsx, Recharts, the Geist and Geist Mono typefaces (via Fontsource)
  • Data: TanStack Query, idb-keyval
  • Worker: jose, Wrangler
  • Desktop + Android: Tauri 2, tauri-plugin-opener, tauri-plugin-single-instance

When you add a new dep to webapp/package.json, also add it to the THIRD_PARTY array so the About page lists it, and to THIRD_PARTY.md. House rules are in CONTRIBUTING.md.

Retired helpers

Two side projects used to feed the catalog: the browser extension poli0981/itch-f2p-extension (GPL-3.0) and, in v3, the Telegram bot poli0981/telegram-scraper-bot (MIT). Both were hardly used, so they are archived now (October 2026). Games come in through the public Suggest page, the RSS discovery and the itch.io collections I follow, and nothing goes live until it is approved.

Find me / Support me

Real channels exist now (still introvert max level, replies slow):

Future Thanks

  • Contributors (issues, PRs, game suggestions): If anyone ever reports games, fixes bugs, or improves my mediocre code — you'll get shouted out here. Legends only.

Built during peak unemployment boredom, with zero budget and two non-judgmental AI buddies (Grok + Claude Code) doing the heavy lifting. Thanks for visiting this random repo — means a lot to an introvert noob dev.

If you wanna be acknowledged, open a PR or issue (or suggest a game). I'll try not to ghost :)))