Files
free-games-itchio-list/docs/ACKNOWLEDGEMENTS.md
T
poli0981andClaude Opus 5 6f4a956855 docs: v4.0.0 licenses, policies and documentation (v4 Phase 5)
Licenses
- Code stays MIT (LICENSE: 2025-2026 poli0981 (SkullMute)). The catalog
  data (data_game/LICENSE.md) and the documentation are CC BY 4.0 (full
  legal code in LICENSES/CC-BY-4.0.txt); creators' descriptions, cover
  images, names and trademarks are excluded. NOTICE.md: license map and
  non-affiliation with itch.io.

Policies (English + Vietnamese mirrors, dated 2026-09-18, applying from
4.0.0)
- Terms of Use now cover the website and the public data, with the
  content-removal / copyright process, prohibited uses (bulk scraping,
  /img abuse, /admin and ingest access, Suggest spam), 18+ opt-in and
  Vietnamese law with the consumer-rights reservation.
- Privacy Policy rewritten for Cloudflare as processor: exact browser
  storage, cookies, Turnstile, D1 retention (Suggest notes 180 days,
  idempotency 7 days), rights under Law No. 91/2025/QH15 and the GDPR.
- EULA covers only the desktop and Android apps (also the installer RTF).
- Disclaimer, Security Policy (private reporting, scope, safe harbor) and
  Code of Conduct (Contributor Covenant 2.1) rewritten; PAT, GPG and
  Telegram-bot material removed.

Docs and templates
- README / CONTRIBUTING (EN + VI), webapp/README, TAURI.md, dev_env
  (EN + VI), THIRD_PARTY, ACKNOWLEDGEMENTS; new docs/operations.md
  (Cloudflare + GitHub setup, v4 release order, routine tasks).
- CLAUDE.md rewritten for the v4 architecture; CHANGELOG [4.0.0].
- Issue templates: config.yml (Suggest page + private security reports),
  "Add games" points to /suggest, "Remove a game" gained a rights-holder
  section; PR templates updated; CODEOWNERS.
- Dependabot npm version updates resume with the v4 merge (limit 5).

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-18 17:55:02 +07:00

4.9 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 6, Vite 8, React Router 8, Zustand 5
  • UI: Tailwind CSS, shadcn/ui (pattern), Radix UI primitives, lucide-react, sonner, class-variance-authority, tailwind-merge, clsx, Recharts
  • Data: TanStack Query / Table / Virtual, 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.

Browser extension — the other way in

poli0981/itch-f2p-extension (GPL-3.0, separate repo) lets me queue itch.io games straight from the browser. It sends them through an authenticated API into the same review queue as the public Suggest page and the RSS discovery. Nothing goes live until I approve it. (The old Telegram bot did this job in v3 and is now retired.)

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 :)))