Compare commits

...
Author SHA1 Message Date
poli0981andClaude Opus 5.5 70ec107443 Move the Python pin out of Dependabot's reach
Dependabot's pip updater reads .python-version and supports Python
3.10-3.14 only, so the 3.15 pin from the toolchain upgrade aborted both
the pip version updates and the pip dependency graph ("Dependabot
detected the following Python requirement for your project: '3.15.*'").

The pin now lives in .github/python-version, read only by setup-python's
python-version-file (python-ci, refresh scan + apply, update); Dependabot
falls back to its default 3.14, which every pinned package supports.
Move it back once Dependabot lists 3.15 (CLAUDE.md gotcha 39).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-22 08:54:45 +07:00
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
github-actions[bot] 84486fb792 Ingest queued games [2026-10-22] 2026-10-22 00:23:36 +00:00
freeitchgames-admin[bot] 637f4e9a8f Queue 2 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://alchemysheep.itch.io/game-is-full-of-bugs
https://traumalab.itch.io/trauma-lab
2026-10-22 00:23:18 +00:00
github-actions[bot] 8920ca345b Ingest queued games [2026-10-21] 2026-10-21 16:23:46 +00:00
freeitchgames-admin[bot] d897b90540 Queue 3 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://pickpawket.itch.io/a-trick-of-his-light
https://sakiness.itch.io/everlune
https://vhan-5.itch.io/u-dont-get-it
2026-10-21 16:23:19 +00:00
github-actions[bot] 5def7a2026 Ingest queued games [2026-10-21] 2026-10-21 12:23:50 +00:00
freeitchgames-admin[bot] 991a01e00c Queue 3 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://cineeeekk.itch.io/castle-builddefend
https://cosmicadventuresquad.itch.io/project-hail-meowy
https://doctorhummer.itch.io/irule
2026-10-21 12:23:21 +00:00
github-actions[bot] 4c97926b63 Ingest queued games [2026-10-21] 2026-10-21 08:24:11 +00:00
freeitchgames-admin[bot] a398c53cd5 Queue 12 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://cz758175.itch.io/the-incense-still-burns
https://digitalwaifudelivery.itch.io/sin-igame
https://entink.itch.io/pip-os
https://lianaavk.itch.io/beyo
https://mlouvet.itch.io/dallas
https://nekolele.itch.io/agos
https://quiirisk.itch.io/stepmom-who-fell-on-a-hike
https://studio-chicle.itch.io/adamas
https://studiohexttrpg.itch.io/biophage-jaeger
https://wake44466.itch.io/real-intelligence
https://xtheredviper.itch.io/ashes-of-beau
https://yuhaolin2005.itch.io/qingxuan-volume1
2026-10-21 08:23:19 +00:00
github-actions[bot] 9b02cc77cf Ingest queued games [2026-10-21] 2026-10-21 04:23:45 +00:00
freeitchgames-admin[bot] a087b53e84 Queue 3 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://liminace.itch.io/little-red-fangs
https://rarelikeaunicorn.itch.io/vvvvvvv
https://tsomyst.itch.io/lavoice
2026-10-21 04:23:18 +00:00
github-actions[bot] d83ed9a546 Refresh catalog [2026-10-21] 2026-10-21 03:31:04 +00:00
github-actions[bot] ffaeaab3b6 Ingest queued games [2026-10-21] 2026-10-21 00:23:46 +00:00
freeitchgames-admin[bot] dacbba59e6 Queue 4 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://gabrielcassimiro.itch.io/cake-clicker-recake
https://misha.itch.io/echoes-of-twilight
https://puapka.itch.io/dentata
https://torcado.itch.io/manymancer
2026-10-21 00:23:17 +00:00
dependabot[bot] 888fc719c0 chore(deps-dev): Bump the python group with 2 updates
Updates the requirements on [ruff](https://github.com/astral-sh/ruff) and [pillow](https://github.com/python-pillow/Pillow) to permit the latest version.

Updates `ruff` to 0.17.1
- [Release notes](https://github.com/astral-sh/ruff/releases)
- [Changelog](https://github.com/astral-sh/ruff/blob/main/CHANGELOG.md)
- [Commits](https://github.com/astral-sh/ruff/compare/0.17.0...0.17.1)

Updates `pillow` to 13.0.0
- [Release notes](https://github.com/python-pillow/Pillow/releases)
- [Changelog](https://github.com/python-pillow/Pillow/blob/main/CHANGES.rst)
- [Commits](https://github.com/python-pillow/Pillow/compare/12.3.0...13.0.0)

---
updated-dependencies:
- dependency-name: ruff
  dependency-version: 0.17.1
  dependency-type: direct:development
  dependency-group: python
- dependency-name: pillow
  dependency-version: 13.0.0
  dependency-type: direct:development
  dependency-group: python
...

Signed-off-by: dependabot[bot] <support@github.com>
2026-10-21 02:21:20 +07:00
dependabot[bot] 3928fffdc7 chore(deps): Bump the actions group with 2 updates (#148)
Bumps the actions group with 2 updates: [actions/setup-java](https://github.com/actions/setup-java) and [dtolnay/rust-toolchain](https://github.com/dtolnay/rust-toolchain).


Updates `actions/setup-java` from 6.0.1 to 6.1.0
- [Release notes](https://github.com/actions/setup-java/releases)
- [Commits](https://github.com/actions/setup-java/compare/de7274f081f381c8f8158605e0321c36c376e2e6...b843ebf9b913146b38da2eaa7aeddf76074ae1ad)

Updates `dtolnay/rust-toolchain` from e2a55d2ffb04f378e9626c28d38b36d230d1e12f to 683b588c487a69d01f6c6ddf40f036ff682cc2c8
- [Release notes](https://github.com/dtolnay/rust-toolchain/releases)
- [Commits](https://github.com/dtolnay/rust-toolchain/compare/e2a55d2ffb04f378e9626c28d38b36d230d1e12f...683b588c487a69d01f6c6ddf40f036ff682cc2c8)

---
updated-dependencies:
- dependency-name: actions/setup-java
  dependency-version: 6.1.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: actions
- dependency-name: dtolnay/rust-toolchain
  dependency-version: 683b588c487a69d01f6c6ddf40f036ff682cc2c8
  dependency-type: direct:production
  dependency-group: actions
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-10-21 02:19:10 +07:00
github-actions[bot] 914b34ec95 Ingest queued games [2026-10-20] 2026-10-20 16:23:53 +00:00
freeitchgames-admin[bot] acc2410d9f Queue 6 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://ao-85.itch.io/who-is-nana
https://dazylude.itch.io/an-old-joke
https://fionafenali.itch.io/in-my-image
https://gdestroyer12.itch.io/teyvat-academy
https://jotabot.itch.io/in-the-shadows
https://progdamn.itch.io/brother-hurry-and-put-the-disc-in
2026-10-20 16:23:20 +00:00
github-actions[bot] 3cfdaa8544 Ingest queued games [2026-10-20] 2026-10-20 14:40:16 +00:00
freeitchgames-admin[bot] 458c7ad3fd Queue 1 game(s) for ingest [admin]
Via the admin page.

https://arubberducky.itch.io/futanari-destroying-sex-robot
2026-10-20 14:39:59 +00:00
github-actions[bot] 344f8ff04c Ingest queued games [2026-10-20] 2026-10-20 12:24:09 +00:00
freeitchgames-admin[bot] fd8005afad Queue 12 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://benjithepro17.itch.io/baldi-70
https://bergice.itch.io/lurkers
https://danielmorenoroldan.itch.io/asdasd-the-clicker-game
https://filgreen3.itch.io/coup-of-appliance
https://goblinwithsocks.itch.io/idle-guild
https://gridmere.itch.io/gridmere
https://outstar.itch.io/blokia-designer
https://rychz.itch.io/the-binding-of-isaac-rtx
https://smestorp.itch.io/candy-quest-3-edge-of-sweetness
https://thelatteteam.itch.io/bbieal-wiiu
https://tinyworkers.itch.io/get-to-work-gnome
https://yotogi-chan.itch.io/yuasama-cardgame
2026-10-20 12:23:20 +00:00
github-actions[bot] c563d678dc Ingest queued games [2026-10-20] 2026-10-20 08:24:05 +00:00
freeitchgames-admin[bot] 0e009622a0 Queue 10 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://alfredo7.itch.io/dissosidate
https://basic-eagles.itch.io/recaller
https://danchicu.itch.io/pigeon-prompt-engineer
https://dannpops.itch.io/karoshi
https://jmrcl.itch.io/in-the-shadows
https://matthewdrake.itch.io/fayonline
https://mirroring-foxes-studio.itch.io/rezero-if
https://negentropy-ko.itch.io/the-shadows
https://pumpkycookie.itch.io/pager-13
https://veryfujii.itch.io/be-my-lover-4-a-day
2026-10-20 08:23:19 +00:00
github-actions[bot] 0f6c99249d Ingest queued games [2026-10-20] 2026-10-20 04:23:39 +00:00
freeitchgames-admin[bot] 5edf1ee1bd Queue 4 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://deby-studio.itch.io/the-cursed-box
https://meniir.itch.io/twilight-at-the-banyan-tree
https://mithikagames.itch.io/breadwinner
https://targaciej.itch.io/paragra
2026-10-20 04:23:17 +00:00
github-actions[bot] 7f523681d3 Refresh catalog [2026-10-20] 2026-10-20 03:33:31 +00:00
github-actions[bot] cc3619049c Ingest queued games [2026-10-19] 2026-10-19 20:23:46 +00:00
freeitchgames-admin[bot] 867ee2f10b Queue 4 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://ackleyrc.itch.io/bridgemancer
https://ceiravarageplayer.itch.io/other-random-games-fkfgfjjnjgndsngbnap
https://just-look-ing.itch.io/burst-blackjack
https://kaaexperienced.itch.io/hypnosnake-simulator
2026-10-19 20:23:18 +00:00
github-actions[bot] 8246799a1e Ingest queued games [2026-10-19] 2026-10-19 16:23:50 +00:00
freeitchgames-admin[bot] 2abbc0de96 Queue 5 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://antpunch.itch.io/memloss
https://littledibble.itch.io/seas-the-day
https://mediocrisis.itch.io/geeneses-game
https://melomell.itch.io/encaprichada
https://n4hobino.itch.io/into-the-dragonrealm
2026-10-19 16:23:18 +00:00
github-actions[bot] 73eb9dc68b Ingest queued games [2026-10-19] 2026-10-19 12:23:41 +00:00
freeitchgames-admin[bot] 460bc44ff8 Queue 2 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://baldigaming99.itch.io/geometry-dash-220922091-apkandpc
https://lifeofboris.itch.io/boristan
2026-10-19 12:23:18 +00:00
github-actions[bot] 6f0704089f Ingest queued games [2026-10-19] 2026-10-19 08:24:04 +00:00
freeitchgames-admin[bot] d53fc2accc Queue 12 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://bombacatdev.itch.io/yandere-sim
https://demo0606.itch.io/aholeinmywall
https://eturnalove.itch.io/villainess-malfoy
https://jiufoduck.itch.io/recycle-yourself
https://junkfoode0.itch.io/synthesis
https://kelebeksiron.itch.io/paperweight
https://micpp.itch.io/loss-and-freedom
https://pamkat444.itch.io/no-se-habla-de-los-cuerpitos
https://queencontract.itch.io/purple-pleasure
https://r3v3rsecze.itch.io/john-door-the-amazing-adventure-about-openning-doors
https://rhidel.itch.io/malfoid-sim
https://slemkatt.itch.io/a-sandwich-adventure
2026-10-19 08:23:18 +00:00
dependabot[bot] d3de2b14cd chore(deps): Bump the tanstack group across 1 directory with 3 updates (#142)
Bumps the tanstack group with 3 updates in the /webapp directory: [@tanstack/react-query](https://github.com/TanStack/query/tree/HEAD/packages/react-query), [@tanstack/react-query-devtools](https://github.com/TanStack/query/tree/HEAD/packages/react-query-devtools) and [@tanstack/react-query-persist-client](https://github.com/TanStack/query/tree/HEAD/packages/react-query-persist-client).


Updates `@tanstack/react-query` from 5.104.1 to 5.104.3
- [Release notes](https://github.com/TanStack/query/releases)
- [Changelog](https://github.com/TanStack/query/blob/main/packages/react-query/CHANGELOG.md)
- [Commits](https://github.com/TanStack/query/commits/@tanstack/react-query@5.104.3/packages/react-query)

Updates `@tanstack/react-query-devtools` from 5.104.1 to 5.104.3
- [Release notes](https://github.com/TanStack/query/releases)
- [Changelog](https://github.com/TanStack/query/blob/main/packages/react-query-devtools/CHANGELOG.md)
- [Commits](https://github.com/TanStack/query/commits/@tanstack/react-query-devtools@5.104.3/packages/react-query-devtools)

Updates `@tanstack/react-query-persist-client` from 5.104.1 to 5.104.3
- [Release notes](https://github.com/TanStack/query/releases)
- [Changelog](https://github.com/TanStack/query/blob/main/packages/react-query-persist-client/CHANGELOG.md)
- [Commits](https://github.com/TanStack/query/commits/@tanstack/react-query-persist-client@5.104.3/packages/react-query-persist-client)

---
updated-dependencies:
- dependency-name: "@tanstack/react-query"
  dependency-version: 5.104.3
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: tanstack
- dependency-name: "@tanstack/react-query-devtools"
  dependency-version: 5.104.3
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: tanstack
- dependency-name: "@tanstack/react-query-persist-client"
  dependency-version: 5.104.3
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: tanstack
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-10-19 14:00:20 +07:00
dependabot[bot] af86809da7 chore(deps): Bump the react group across 1 directory with 2 updates (#141)
Bumps the react group with 2 updates in the /webapp directory: [react](https://github.com/react/react/tree/HEAD/packages/react) and [react-dom](https://github.com/react/react/tree/HEAD/packages/react-dom).


Updates `react` from 19.3.0 to 19.3.1
- [Release notes](https://github.com/react/react/releases)
- [Changelog](https://github.com/react/react/blob/main/CHANGELOG.md)
- [Commits](https://github.com/react/react/commits/v19.3.1/packages/react)

Updates `react-dom` from 19.3.0 to 19.3.1
- [Release notes](https://github.com/react/react/releases)
- [Changelog](https://github.com/react/react/blob/main/CHANGELOG.md)
- [Commits](https://github.com/react/react/commits/v19.3.1/packages/react-dom)

---
updated-dependencies:
- dependency-name: react
  dependency-version: 19.3.1
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: react
- dependency-name: react-dom
  dependency-version: 19.3.1
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: react
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-10-19 13:26:45 +07:00
dependabot[bot] 55718fe684 chore(deps): Bump the radix group in /webapp with 8 updates (#143)
Bumps the radix group in /webapp with 8 updates:

| Package | From | To |
| --- | --- | --- |
| [@radix-ui/react-checkbox](https://github.com/radix-ui/primitives/tree/HEAD/packages/react/checkbox) | `1.3.12` | `1.4.1` |
| [@radix-ui/react-dialog](https://github.com/radix-ui/primitives/tree/HEAD/packages/react/dialog) | `1.2.0` | `1.3.1` |
| [@radix-ui/react-label](https://github.com/radix-ui/primitives/tree/HEAD/packages/react/label) | `2.1.16` | `2.1.17` |
| [@radix-ui/react-popover](https://github.com/radix-ui/primitives/tree/HEAD/packages/react/popover) | `1.2.0` | `1.3.1` |
| [@radix-ui/react-separator](https://github.com/radix-ui/primitives/tree/HEAD/packages/react/separator) | `1.1.16` | `1.2.0` |
| [@radix-ui/react-slot](https://github.com/radix-ui/primitives/tree/HEAD/packages/react/slot) | `1.4.0` | `1.5.0` |
| [@radix-ui/react-switch](https://github.com/radix-ui/primitives/tree/HEAD/packages/react/switch) | `1.3.8` | `1.4.1` |
| [@radix-ui/react-tabs](https://github.com/radix-ui/primitives/tree/HEAD/packages/react/tabs) | `1.1.22` | `1.2.1` |


Updates `@radix-ui/react-checkbox` from 1.3.12 to 1.4.1
- [Changelog](https://github.com/radix-ui/primitives/blob/main/packages/react/checkbox/CHANGELOG.md)
- [Commits](https://github.com/radix-ui/primitives/commits/HEAD/packages/react/checkbox)

Updates `@radix-ui/react-dialog` from 1.2.0 to 1.3.1
- [Changelog](https://github.com/radix-ui/primitives/blob/main/packages/react/dialog/CHANGELOG.md)
- [Commits](https://github.com/radix-ui/primitives/commits/HEAD/packages/react/dialog)

Updates `@radix-ui/react-label` from 2.1.16 to 2.1.17
- [Changelog](https://github.com/radix-ui/primitives/blob/main/packages/react/label/CHANGELOG.md)
- [Commits](https://github.com/radix-ui/primitives/commits/HEAD/packages/react/label)

Updates `@radix-ui/react-popover` from 1.2.0 to 1.3.1
- [Changelog](https://github.com/radix-ui/primitives/blob/main/packages/react/popover/CHANGELOG.md)
- [Commits](https://github.com/radix-ui/primitives/commits/HEAD/packages/react/popover)

Updates `@radix-ui/react-separator` from 1.1.16 to 1.2.0
- [Changelog](https://github.com/radix-ui/primitives/blob/main/packages/react/separator/CHANGELOG.md)
- [Commits](https://github.com/radix-ui/primitives/commits/HEAD/packages/react/separator)

Updates `@radix-ui/react-slot` from 1.4.0 to 1.5.0
- [Changelog](https://github.com/radix-ui/primitives/blob/main/packages/react/slot/CHANGELOG.md)
- [Commits](https://github.com/radix-ui/primitives/commits/HEAD/packages/react/slot)

Updates `@radix-ui/react-switch` from 1.3.8 to 1.4.1
- [Changelog](https://github.com/radix-ui/primitives/blob/main/packages/react/switch/CHANGELOG.md)
- [Commits](https://github.com/radix-ui/primitives/commits/HEAD/packages/react/switch)

Updates `@radix-ui/react-tabs` from 1.1.22 to 1.2.1
- [Changelog](https://github.com/radix-ui/primitives/blob/main/packages/react/tabs/CHANGELOG.md)
- [Commits](https://github.com/radix-ui/primitives/commits/HEAD/packages/react/tabs)

---
updated-dependencies:
- dependency-name: "@radix-ui/react-checkbox"
  dependency-version: 1.4.1
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: radix
- dependency-name: "@radix-ui/react-dialog"
  dependency-version: 1.3.1
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: radix
- dependency-name: "@radix-ui/react-label"
  dependency-version: 2.1.17
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: radix
- dependency-name: "@radix-ui/react-popover"
  dependency-version: 1.3.1
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: radix
- dependency-name: "@radix-ui/react-separator"
  dependency-version: 1.2.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: radix
- dependency-name: "@radix-ui/react-slot"
  dependency-version: 1.5.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: radix
- dependency-name: "@radix-ui/react-switch"
  dependency-version: 1.4.1
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: radix
- dependency-name: "@radix-ui/react-tabs"
  dependency-version: 1.2.1
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: radix
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-10-19 11:35:44 +07:00
dependabot[bot] 18f6e31c02 chore(deps): Bump the tauri-js group in /webapp with 3 updates (#144)
Bumps the tauri-js group in /webapp with 3 updates: [@tauri-apps/api](https://github.com/tauri-apps/tauri), [@tauri-apps/plugin-opener](https://github.com/tauri-apps/plugins-workspace) and [@tauri-apps/cli](https://github.com/tauri-apps/tauri).


Updates `@tauri-apps/api` from 2.12.1 to 2.12.4
- [Release notes](https://github.com/tauri-apps/tauri/releases)
- [Commits](https://github.com/tauri-apps/tauri/compare/@tauri-apps/api-v2.12.1...@tauri-apps/api-v2.12.4)

Updates `@tauri-apps/plugin-opener` from 2.7.0 to 2.7.2
- [Release notes](https://github.com/tauri-apps/plugins-workspace/releases)
- [Commits](https://github.com/tauri-apps/plugins-workspace/compare/fs-v2.7.0...dialog-v2.7.2)

Updates `@tauri-apps/cli` from 2.12.1 to 2.12.3
- [Release notes](https://github.com/tauri-apps/tauri/releases)
- [Commits](https://github.com/tauri-apps/tauri/compare/@tauri-apps/cli-v2.12.1...@tauri-apps/cli-v2.12.3)

---
updated-dependencies:
- dependency-name: "@tauri-apps/api"
  dependency-version: 2.12.4
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: tauri-js
- dependency-name: "@tauri-apps/plugin-opener"
  dependency-version: 2.7.2
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: tauri-js
- dependency-name: "@tauri-apps/cli"
  dependency-version: 2.12.3
  dependency-type: direct:development
  update-type: version-update:semver-patch
  dependency-group: tauri-js
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-10-19 11:34:23 +07:00
github-actions[bot] 3af49289cb Ingest queued games [2026-10-19] 2026-10-19 04:23:33 +00:00
freeitchgames-admin[bot] ba1e972070 Queue 1 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://drevengames.itch.io/idle-fantasy-shop
2026-10-19 04:23:19 +00:00
github-actions[bot] b679ebd293 Refresh catalog [2026-10-19] 2026-10-19 03:33:47 +00:00
github-actions[bot] c75c681ef5 Ingest queued games [2026-10-18] 2026-10-18 20:23:35 +00:00
freeitchgames-admin[bot] 0a574c4005 Queue 1 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://baldigaming99.itch.io/geometry-dash-22091
2026-10-18 20:23:17 +00:00
github-actions[bot] b4c0b0e04d Ingest queued games [2026-10-18] 2026-10-18 16:23:41 +00:00
freeitchgames-admin[bot] 61944a5ee9 Queue 5 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://d3emo.itch.io/patantan
https://enoki-nohito.itch.io/kiminisika-dekinai
https://husbandogoddess.itch.io/a-little-inconvenience
https://mdawg74.itch.io/unit-112
https://shadowflamedragn.itch.io/smoke-mirrors
2026-10-18 16:23:18 +00:00
github-actions[bot] f1734dfd27 Ingest queued games [2026-10-18] 2026-10-18 12:23:33 +00:00
freeitchgames-admin[bot] a64993188b Queue 1 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://polypaw.itch.io/the-no-jumpscare-show
2026-10-18 12:23:17 +00:00
github-actions[bot] 9b4c4ae609 Ingest queued games [2026-10-18] 2026-10-18 08:23:51 +00:00
freeitchgames-admin[bot] 775ceaa839 Queue 6 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://cardio-pulmo.itch.io/loa-night-shift
https://kirinkoumori.itch.io/essays
https://lonelynode.itch.io/killa
https://misstullie.itch.io/made-with-nostalgia
https://v-shr1.itch.io/dragon
https://writer31.itch.io/say-that-you-hate-me
2026-10-18 08:23:18 +00:00
github-actions[bot] ad224b7855 Ingest queued games [2026-10-18] 2026-10-18 04:24:55 +00:00
freeitchgames-admin[bot] 97582fb3fe Queue 4 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://akirakani-kani.itch.io/hayasuginovel
https://ruizukun-dev.itch.io/dictator-dating-sim
https://jproductions2.itch.io/30-times-table
https://poprise.itch.io/drag-race-simulator
2026-10-18 04:23:17 +00:00
github-actions[bot] ec4a9ab1d0 Refresh catalog [2026-10-18] 2026-10-18 03:28:50 +00:00
github-actions[bot] bf0b4a3e4e Ingest queued games [2026-10-18] 2026-10-18 00:23:36 +00:00
freeitchgames-admin[bot] 6cdc7482e7 Queue 1 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://superkuo.itch.io/dont-touch-that-chest
2026-10-18 00:23:18 +00:00
github-actions[bot] 50900214df Ingest queued games [2026-10-17] 2026-10-17 16:24:53 +00:00
freeitchgames-admin[bot] 95eb84a24c Queue 2 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://thiagodv.itch.io/stick-fight-arena-pre-alpha
https://vectorinox.itch.io/imperium-host
2026-10-17 16:23:31 +00:00
github-actions[bot] 450ed5403d Ingest queued games [2026-10-17] 2026-10-17 12:23:45 +00:00
freeitchgames-admin[bot] ba75c46eb2 Queue 1 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://eyelessx.itch.io/until-the-stars-forget-you
2026-10-17 12:23:30 +00:00
github-actions[bot] eedfc797b4 Ingest queued games [2026-10-17] 2026-10-17 08:23:53 +00:00
freeitchgames-admin[bot] fa5a6ac91e Queue 4 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://arcadekitten.itch.io/mit-juste
https://fiorane.itch.io/nadameru
https://gi-joe424.itch.io/sinister-mister
https://kripkode.itch.io/the-last-boba-shop
2026-10-17 08:23:30 +00:00
github-actions[bot] 8ae8381d2b Ingest queued games [2026-10-17] 2026-10-17 04:23:48 +00:00
freeitchgames-admin[bot] e6968423bc Queue 2 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://eliasguyd.itch.io/rooklite
https://frajdagames.itch.io/fireworks-incremental
2026-10-17 04:23:30 +00:00
github-actions[bot] cd157e5674 Refresh catalog [2026-10-17] 2026-10-17 03:27:52 +00:00
github-actions[bot] dd5142d966 Ingest queued games [2026-10-16] 2026-10-16 18:43:02 +00:00
freeitchgames-admin[bot] e9681f70d4 Queue 2 game(s) for ingest [admin]
Via the admin page.

https://eden505.itch.io/outofframe
https://churnveil.itch.io/scarlett-awakening
2026-10-16 18:42:40 +00:00
github-actions[bot] 57a89d1f6b Ingest queued games [2026-10-16] 2026-10-16 12:24:26 +00:00
freeitchgames-admin[bot] 207f7bbb63 Queue 3 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://cicidigital.itch.io/retromine
https://doorwatchers.itch.io/cycle-of-the-first-dawn
https://thatwalshguy.itch.io/stclzine
2026-10-16 12:24:00 +00:00
poli0981andClaude Opus 5.5 f199e2ea17 Retire the browser extension's ingest API; release 4.4.1 (#138)
The browser extension (poli0981/itch-f2p-extension) and the Telegram bot (poli0981/telegram-scraper-bot) are archived. Removed: POST /api/ingest (ingest.ts, requireService, the idempotency store, RL_INGEST, ACCESS_AUD_INGEST; it never received a game), the admin's "Browser extension" auto-approve source and "Extension" queue label, and the About page's Telegram numeric-ID note. No D1 migration: the idempotency table and the 'ext' CHECK stay.

Policies (Privacy, ToS, EULA + installer RTF, Disclaimer, Security; EN + VI) drop the extension / ingest wording; Last updated 2026-10-16, LEGAL_VERSION unchanged. Docs, CLAUDE.md and pipeline comments updated.

Release 4.4.1 (also ships #131, #135, #136, #137).

[skip-discuss]

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-16 17:56:46 +07:00
dependabot[bot] a5bf9d9f14 chore(deps): Bump serde_json (#136)
Bumps the rust-other group with 1 update in the /webapp/src-tauri directory: [serde_json](https://github.com/serde-rs/json).


Updates `serde_json` from 1.0.151 to 1.0.154
- [Release notes](https://github.com/serde-rs/json/releases)
- [Commits](https://github.com/serde-rs/json/compare/v1.0.151...v1.0.154)

---
updated-dependencies:
- dependency-name: serde_json
  dependency-version: 1.0.152
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: rust-other
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-10-16 17:40:42 +07:00
github-actions[bot] 0bdc06032f Ingest queued games [2026-10-16] 2026-10-16 08:26:42 +00:00
freeitchgames-admin[bot] 7bb9cded54 Queue 17 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://21acad.itch.io/ts-malfoy-ep1
https://bedstespiliverden.itch.io/two-shades-of-pink
https://blanklake.itch.io/the-scrawled-book
https://changsikpassingby.itch.io/dracina-malfoy-project
https://croissmouse.itch.io/malpoid
https://daisuki-yui-kon.itch.io/yuiazu
https://fatass-orange.itch.io/ghost-onsen-festival
https://kronusgenovius.itch.io/a-shields-journey
https://mocomo892.itch.io/offchat
https://monoon-games.itch.io/lady-malfoy
https://muscle-cat-s.itch.io/surrounded-by-muscle-girls
https://orangesounds.itch.io/the-angels-devil-tail
https://retracegames.itch.io/youngforty
https://seah0rsegg.itch.io/liminal
https://soulofkazak.itch.io/spooks-spook-y-halloween-party
https://superwuper.itch.io/royalconsumption
https://waitingtreesproductions.itch.io/yesod-dating-sim
2026-10-16 08:23:41 +00:00
github-actions[bot] 824574f4ec Ingest queued games [2026-10-16] 2026-10-16 04:26:01 +00:00
freeitchgames-admin[bot] 97db2bbc59 Queue 12 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://activedev.itch.io/legend-of-idle-playtest-demo
https://aiainaine.itch.io/better-on-paper
https://auguste-eden.itch.io/amber-forest
https://blackjet.itch.io/labbaye-des-morts
https://kickyfunkfresh.itch.io/freestyletalesofitch
https://lambdaforge.itch.io/kenzu
https://madocactus.itch.io/interviolence
https://mors-games.itch.io/midas-crutch
https://olipool.itch.io/boeckhams-football-manager
https://placeholders.itch.io/007
https://waldorf.itch.io/bombermaid
https://zanipixels.itch.io/the-chimera-gameboy
2026-10-16 04:23:33 +00:00
github-actions[bot] d96072570a Refresh catalog [2026-10-16] 2026-10-16 03:38:58 +00:00
github-actions[bot] ca7c7027db Ingest queued games [2026-10-16] 2026-10-16 00:23:55 +00:00
freeitchgames-admin[bot] 62b2306ab3 Queue 3 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://pantaloon-io.itch.io/lemonade-apocalypse
https://sashify.itch.io/popcorn-idle
https://tattershallstudios.itch.io/gravewell
2026-10-16 00:23:35 +00:00
github-actions[bot] 8846045fd3 Ingest queued games [2026-10-15] 2026-10-15 12:24:19 +00:00
freeitchgames-admin[bot] f734f8f2e9 Queue 3 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://jab-lao.itch.io/pokemon-overlord
https://redembergames.itch.io/hyperballin
https://supertuxkart.itch.io/supertuxkart
2026-10-15 12:23:56 +00:00
github-actions[bot] cd75ad8b54 Ingest queued games [2026-10-15] 2026-10-15 08:24:00 +00:00
freeitchgames-admin[bot] 7c47413f25 Queue 8 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://2tonmucho.itch.io/suburb2065
https://c-mastered-studio.itch.io/play-with-your-girlfriend
https://gabriellj.itch.io/dreamer
https://lex-voca.itch.io/lex-voca-section-1
https://missooni.itch.io/nothing-of-value-lost
https://nataly-torrijos.itch.io/nuestra-casa-compartida
https://rainmutt.itch.io/wish-bone
https://salamanderpress.itch.io/the-cottage-visitor
2026-10-15 08:23:24 +00:00
github-actions[bot] e5d1799c6d Refresh catalog [2026-10-15] 2026-10-15 03:28:22 +00:00
github-actions[bot] f8a7961b09 Ingest queued games [2026-10-14] 2026-10-14 23:45:50 +00:00
freeitchgames-admin[bot] e8d8ea17e8 Queue 13 game(s) for ingest [admin]
Via the admin page.

https://kazehita.itch.io/heartfall-a-tale-in-three-lives
https://lil-beastman.itch.io/himbo-hymns
https://lucaju.itch.io/gyra
https://mawsters.itch.io/mawster
https://mongoumery.itch.io/magicnumbers
https://mrormsbee.itch.io/wings-of-time-the-salem-witch-trials
https://natsu-madao.itch.io/erwin-smith-run
https://nightmareweaverz.itch.io/captive
https://ostsergey.itch.io/plaguebound
https://soliles.itch.io/trust-the-system
https://tabbiedearest.itch.io/cloistered-crown
https://vector5games.itch.io/splatch
https://writer31.itch.io/say-that-you-love-me
2026-10-14 23:44:54 +00:00
github-actions[bot] 9a5eab0d34 Ingest queued games [2026-10-14] 2026-10-14 20:24:55 +00:00
freeitchgames-admin[bot] e81866d0d4 Queue 10 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://3dgoblindev.itch.io/finishing-the-hat
https://8man-hikigaya.itch.io/artificial-affection
https://arisaogi.itch.io/natsu-ga-owaranai
https://bloopyloopygoop.itch.io/wailant
https://kiwimsy.itch.io/mewmewstruck
https://lennychip.itch.io/corpus-callosum
https://moochbear.itch.io/cyberpawn-2099
https://nosleep2jull.itch.io/quiet-where-you-stand
https://onyyyxxxxxxx.itch.io/the-last-trailexe
https://theobalm-strawberry.itch.io/vampire-therapy
2026-10-14 20:24:06 +00:00
dependabot[bot] 06e0b4d709 chore(deps): Bump the tauri-rs group in /webapp/src-tauri with 4 updates (#135)
Bumps the tauri-rs group in /webapp/src-tauri with 4 updates: [tauri](https://github.com/tauri-apps/tauri), [tauri-plugin-opener](https://github.com/tauri-apps/plugins-workspace), [tauri-plugin-single-instance](https://github.com/tauri-apps/plugins-workspace) and [tauri-build](https://github.com/tauri-apps/tauri).


Updates `tauri` from 2.12.1 to 2.12.2
- [Release notes](https://github.com/tauri-apps/tauri/releases)
- [Commits](https://github.com/tauri-apps/tauri/compare/tauri-v2.12.1...tauri-v2.12.2)

Updates `tauri-plugin-opener` from 2.7.0 to 2.7.1
- [Release notes](https://github.com/tauri-apps/plugins-workspace/releases)
- [Commits](https://github.com/tauri-apps/plugins-workspace/compare/fs-v2.7.0...log-v2.7.1)

Updates `tauri-plugin-single-instance` from 2.5.2 to 2.5.3
- [Release notes](https://github.com/tauri-apps/plugins-workspace/releases)
- [Commits](https://github.com/tauri-apps/plugins-workspace/compare/fs-v2.5.2...http-v2.5.3)

Updates `tauri-build` from 2.7.1 to 2.7.2
- [Release notes](https://github.com/tauri-apps/tauri/releases)
- [Commits](https://github.com/tauri-apps/tauri/compare/tauri-build-v2.7.1...tauri-build-v2.7.2)

---
updated-dependencies:
- dependency-name: tauri
  dependency-version: 2.12.2
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: tauri-rs
- dependency-name: tauri-plugin-opener
  dependency-version: 2.7.1
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: tauri-rs
- dependency-name: tauri-plugin-single-instance
  dependency-version: 2.5.3
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: tauri-rs
- dependency-name: tauri-build
  dependency-version: 2.7.2
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: tauri-rs
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-10-15 01:23:28 +07:00
dependabot[bot] 042d0b9413 chore(deps-dev): Update ruff requirement (#137)
Updates the requirements on [ruff](https://github.com/astral-sh/ruff) to permit the latest version.

Updates `ruff` to 0.17.0
- [Release notes](https://github.com/astral-sh/ruff/releases)
- [Changelog](https://github.com/astral-sh/ruff/blob/main/CHANGELOG.md)
- [Commits](https://github.com/astral-sh/ruff/compare/0.16.10...0.17.0)

---
updated-dependencies:
- dependency-name: ruff
  dependency-version: 0.17.0
  dependency-type: direct:development
  dependency-group: python
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-10-15 01:18:55 +07:00
github-actions[bot] 8a3cab2e27 Ingest queued games [2026-10-14] 2026-10-14 12:24:32 +00:00
freeitchgames-admin[bot] 1acca08260 Queue 4 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://armouredboar.itch.io/risen-kingdoms
https://surrtasm.itch.io/the-art-shop
https://te-eg.itch.io/lamplighter
https://tjlazer.itch.io/salamander-aga-for-amiga
2026-10-14 12:23:43 +00:00
github-actions[bot] 6d4895b4d1 Refresh catalog [2026-10-14] 2026-10-14 03:28:01 +00:00
github-actions[bot] 02d1fd3064 Ingest queued games [2026-10-14] 2026-10-14 01:05:20 +00:00
freeitchgames-admin[bot] 328cc3e665 Queue 51 game(s) for ingest [admin]
Via the admin page.

https://edmond00.itch.io/jellyfish-egg
https://little-ones.itch.io/cozy-game-company
https://basilium.itch.io/the-excavation-project
https://cosmos07.itch.io/idle-island
https://deskgeneral.itch.io/sir-we-have-a-situation
https://griffithsgames.itch.io/idle-dreadnought
https://teo-tormo.itch.io/sf2cengcd
https://aegeusgames.itch.io/drimm-remedy
https://capri-demon.itch.io/demon-lord-laid
https://lechita03.itch.io/linea-heroica
https://mariiartt.itch.io/face-it
https://waamr7.itch.io/317
https://keefbaker.itch.io/nemeshit
https://loglogz.itch.io/lava-links
https://neon-namen.itch.io/dungeon-horde
https://nilano.itch.io/the-last-delivery
https://pokolega.itch.io/nikoclick
https://becxah.itch.io/misty-memories
https://breezy-the-cat.itch.io/houswatching
https://caleb545.itch.io/potters-field
https://dorabuay.itch.io/midnight-cocktail
https://erclyuaccd.itch.io/hattisan
https://hurby.itch.io/ruh
https://kenmaryuji.itch.io/mineminemine
https://kihyunmathee.itch.io/gray-and-blue
https://kiku-o2.itch.io/ttmwdahsgtiavm
https://leeevans.itch.io/pursuit-of-warmth
https://lilys-mascot.itch.io/aishite-kotoshi
https://lostbyte.itch.io/thats-a-steal
https://lsremix.itch.io/astoria
https://michellesalvatore9-sketch.itch.io/sombras-de-la-verdad
https://missblossom.itch.io/university-of-progress
https://pravthelamb.itch.io/ignotum
https://qixya.itch.io/3-seconds-chapter-2-episode-3
https://railgunrabbit.itch.io/super-safe-for-work
https://sobigdrasil.itch.io/slamdating
https://starismoi.itch.io/woods-of-ember
https://starzonie.itch.io/boolangerie
https://sticktrix.itch.io/dying-metals-last-scream
https://theoppaipriest.itch.io/hear-me-out
https://twindark.itch.io/godseater
https://willagem.itch.io/and-from-deep-down-below
https://arknoid.itch.io/lost-warden
https://device25.itch.io/the-last-line
https://gamezeternal.itch.io/project-chromata
https://giantlight.itch.io/mr-magpies-harmless-card-game
https://ii-p.itch.io/ii-ii-ii-i-i-i-i-ii
https://sharkwithlasers.itch.io/rotetra
https://slambond.itch.io/packardos
https://thiagodv.itch.io/combat-arena
https://vvafelek.itch.io/dontkeepthedevilwaiting
2026-10-14 01:01:44 +00:00
github-actions[bot] 27b487ddfe Ingest queued games [2026-10-14] 2026-10-14 00:23:55 +00:00
freeitchgames-admin[bot] 862094768d Queue 5 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://potit-bob.itch.io/dungeon-swap-r
https://ratking.itch.io/mops-and-mobs
https://reeecook.itch.io/leaf-by-leaf-jam
https://studio-spagunkel.itch.io/fake-news-detective-in-space
https://tjlazer.itch.io/lifeforce-aga-for-amiga-12004000
2026-10-14 00:23:26 +00:00
dependabot[bot] a85df76a8c chore(deps-dev): Bump vite in /webapp in the build-tooling group (#131)
Bumps the build-tooling group in /webapp with 1 update: [vite](https://github.com/vitejs/vite/tree/HEAD/packages/vite).


Updates `vite` from 8.3.3 to 8.3.4
- [Release notes](https://github.com/vitejs/vite/releases)
- [Changelog](https://github.com/vitejs/vite/blob/main/packages/vite/CHANGELOG.md)
- [Commits](https://github.com/vitejs/vite/commits/v8.3.4/packages/vite)

---
updated-dependencies:
- dependency-name: vite
  dependency-version: 8.3.4
  dependency-type: direct:development
  update-type: version-update:semver-patch
  dependency-group: build-tooling
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-10-13 10:39:21 +07:00
github-actions[bot] 2b00adf2ee Refresh catalog [2026-10-13] 2026-10-13 03:37:22 +00:00
poli0981andClaude Opus 5.5 f2a5135993 v4.4.0: admin automation, bulk remove/edit, theme icon, smooth chart tabs (#133)
Admin: add games from any list or itch.io collection (Check first, batches of 200, per-game ingest tracking from scripts/state/ingest_outcomes.json), followed collections and auto-approve run by the cron in one [auto] commit, bulk remove/edit up to 100 games in one commit, New games, Activity and Settings pages. D1 migration 0002 (applied to production before this merge). Policies (ToS, Privacy, Disclaimer, EN + VI) cover approval by the maintainer's rules; LEGAL_VERSION 2026-10-13.

Web: the theme button shows the theme in use, no dark-mode flash (pre-paint script, hash in three CSPs), Charts tabs stay mounted (no rebuilt charts or replayed animations), 300 ms entrances, scrollbar gutter on mouse devices.

Release 4.4.0 (changelog also covers #130).

[skip-discuss]

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-13 10:08:33 +07:00
github-actions[bot] a2d38825e2 Ingest queued games [2026-10-12] 2026-10-12 15:11:52 +00:00
freeitchgames-admin[bot] b04deb3818 Queue 2 game(s) for ingest [admin]
Via the admin page.

https://green-frisbee.itch.io/makerking
https://smughyenastudios.itch.io/specimen29sfw
2026-10-12 15:11:34 +00:00
dependabot[bot] 23d967515f chore(deps): Bump lucide-react from 1.52.0 to 1.53.0 in /webapp (#132)
Bumps [lucide-react](https://github.com/lucide-icons/lucide/tree/HEAD/packages/lucide-react) from 1.52.0 to 1.53.0.
- [Release notes](https://github.com/lucide-icons/lucide/releases)
- [Commits](https://github.com/lucide-icons/lucide/commits/1.53.0/packages/lucide-react)

---
updated-dependencies:
- dependency-name: lucide-react
  dependency-version: 1.53.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-10-12 14:11:50 +07:00
github-actions[bot] 7ae35af7bb Refresh catalog [2026-10-12] 2026-10-12 03:40:49 +00:00
github-actions[bot] 8ac44caa1f Ingest queued games [2026-10-12] 2026-10-12 01:29:37 +00:00
freeitchgames-admin[bot] 530519f1ed Queue 27 game(s) for ingest [admin]
Via the admin page.

https://blindhermit.itch.io/one-way-down
https://csaf.itch.io/kaiju-disposal
https://jpter78.itch.io/pokesurvivor
https://menyiques.itch.io/das-boot
https://snailsalad.itch.io/ntrtopia
https://twgrow.itch.io/lab-accident
https://omniscye.itch.io/empress-pokemon-2d-arena
https://withered-soul.itch.io/can-you-escape
https://xotox1337.itch.io/riftmancer
https://akaris512.itch.io/broken-saints
https://daniel-fernandes-dev.itch.io/sanmd
https://darklordgames.itch.io/monmon-high-demo
https://egot1stical.itch.io/who-killed-markiplier-vn
https://nanaroba.itch.io/the-intruder
https://nynyandtotoh.itch.io/nadie-te-eligi-demo
https://riekay.itch.io/slices-of-life
https://scrufflesdev.itch.io/the-light-i-saw
https://sofiaromao.itch.io/starless-night-of-the-console-diver
https://zherreus.itch.io/quoryc-demo
https://jorotyn.itch.io/the-circle
https://josephopossum.itch.io/under-the-bridge
https://cursedpierro.itch.io/dreams-of-entropy
https://dena70.itch.io/retro-chat
https://disit-il.itch.io/capacite-de-destruction-massive
https://goncalo-a.itch.io/lazy-johnny
https://almost-there-games.itch.io/azimuth
https://interloko.itch.io/mk-trilogy-hd
2026-10-12 01:27:42 +00:00
poli0981andClaude Opus 5.5 ec3ff9ab3a fix(charts): phone layout of the Charts page (#130)
Below md: a one-row tab bar (the Vietnamese labels had wrapped out of the
fixed-height bar), 12px legends and 11px ticks, horizontal Languages and
Avg session bars, the reason under each recent deletion, the KPI total
across the row, a taller Genres card.

At every size: all 15 Genre labels on one line (Recharts had hidden 8,
the two largest included), pie legends in data order with muted text,
translated removal reasons (reasonKey in lib/deleted-reason), locale axis
numbers, treemap labels that fit their cells, no "(made_with[0])" in the
engine chart's description. CLAUDE.md: chart notes, gotcha 32 and the
unreleased-on-main note.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-11 13:02:50 +07:00
github-actions[bot] 200cf2d17e Refresh catalog [2026-10-11] 2026-10-11 03:35:28 +00:00
github-actions[bot] a4ee016eab Ingest queued games [2026-10-10] 2026-10-10 15:38:45 +00:00
freeitchgames-admin[bot] 032343393d Queue 9 game(s) for ingest [admin]
Via the admin page.

https://beegfloppa15.itch.io/you-know-them-really-well-actually-a-rejection-sim
https://cccrimsonmakesgames.itch.io/death-spiral
https://delender1100.itch.io/cybartender
https://dollhousing.itch.io/ego-birth
https://kritzinger.itch.io/ristys-monster-vocational-rehabilitation
https://miyoshi-shizuka.itch.io/patricide
https://nhungtt2804.itch.io/abyssal-drift
https://northboundstudio.itch.io/howls-of-hearths
https://setthank.itch.io/sakuragaoka-days
2026-10-10 15:38:03 +00:00
github-actions[bot] d6d97bcee0 Ingest queued games [2026-10-10] 2026-10-10 11:42:33 +00:00
freeitchgames-admin[bot] 3f9ad8a670 Queue 2 game(s) for ingest [admin]
Via the admin page.

https://ithealth.itch.io/galaxy-refactor
https://stinkysunstep.itch.io/box3d-godot
2026-10-10 11:42:11 +00:00
github-actions[bot] 6b0acaaa6b Refresh catalog [2026-10-10] 2026-10-10 08:41:00 +00:00
poli0981andClaude Opus 5.5 3199ec4be3 fix(pipeline): strike password-protected itch.io pages; CLAUDE.md names the new signing key (#129)
itch.io answers a password-protected game with HTTP 200 and its password form (div.game_password_page / input[name=game_password]); the refresh counted it as a parse failure forever. scraper.is_password_protected() recognises it; refresh gives a "private" strike ("Game page is password-protected", removed when seen again >= 20 h later, counted by the mass-change guard); update_info drops such links as a final outcome; the Removed page and Deletion Reasons chart label the reason (EN/VI). CLAUDE.md names the new signing key 838884804847BE7AE5FCF0A96AD1AB0921B96825; 03F965C2E2DB5C6B is revoked.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-10 15:40:21 +07:00
poli0981andClaude Opus 5.5 cecee9c8a1 docs: CLAUDE.md marks v4.3.0 as released, with the re-scrape outcome (#128)
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-10 15:28:00 +07:00
github-actions[bot] 4c693d480e Force update [2026-10-10] 2026-10-10 08:25:25 +00:00
github-actions[bot] 62d5f9a64f Force update [2026-10-10] 2026-10-10 08:18:08 +00:00
github-actions[bot] fb66044f34 Force update [2026-10-10] 2026-10-10 07:36:51 +00:00
dependabot[bot] 0b7477c784 chore(deps): Bump the radix group across 1 directory with 8 updates (#125)
Bumps the radix group with 8 updates in the /webapp directory:

| Package | From | To |
| --- | --- | --- |
| [@radix-ui/react-checkbox](https://github.com/radix-ui/primitives/tree/HEAD/packages/react/checkbox) | `1.3.11` | `1.3.12` |
| [@radix-ui/react-dialog](https://github.com/radix-ui/primitives/tree/HEAD/packages/react/dialog) | `1.1.23` | `1.2.0` |
| [@radix-ui/react-label](https://github.com/radix-ui/primitives/tree/HEAD/packages/react/label) | `2.1.15` | `2.1.16` |
| [@radix-ui/react-popover](https://github.com/radix-ui/primitives/tree/HEAD/packages/react/popover) | `1.1.23` | `1.2.0` |
| [@radix-ui/react-separator](https://github.com/radix-ui/primitives/tree/HEAD/packages/react/separator) | `1.1.15` | `1.1.16` |
| [@radix-ui/react-slot](https://github.com/radix-ui/primitives/tree/HEAD/packages/react/slot) | `1.3.3` | `1.4.0` |
| [@radix-ui/react-switch](https://github.com/radix-ui/primitives/tree/HEAD/packages/react/switch) | `1.3.7` | `1.3.8` |
| [@radix-ui/react-tabs](https://github.com/radix-ui/primitives/tree/HEAD/packages/react/tabs) | `1.1.21` | `1.1.22` |



Updates `@radix-ui/react-checkbox` from 1.3.11 to 1.3.12
- [Changelog](https://github.com/radix-ui/primitives/blob/main/packages/react/checkbox/CHANGELOG.md)
- [Commits](https://github.com/radix-ui/primitives/commits/HEAD/packages/react/checkbox)

Updates `@radix-ui/react-dialog` from 1.1.23 to 1.2.0
- [Changelog](https://github.com/radix-ui/primitives/blob/main/packages/react/dialog/CHANGELOG.md)
- [Commits](https://github.com/radix-ui/primitives/commits/HEAD/packages/react/dialog)

Updates `@radix-ui/react-label` from 2.1.15 to 2.1.16
- [Changelog](https://github.com/radix-ui/primitives/blob/main/packages/react/label/CHANGELOG.md)
- [Commits](https://github.com/radix-ui/primitives/commits/HEAD/packages/react/label)

Updates `@radix-ui/react-popover` from 1.1.23 to 1.2.0
- [Changelog](https://github.com/radix-ui/primitives/blob/main/packages/react/popover/CHANGELOG.md)
- [Commits](https://github.com/radix-ui/primitives/commits/HEAD/packages/react/popover)

Updates `@radix-ui/react-separator` from 1.1.15 to 1.1.16
- [Changelog](https://github.com/radix-ui/primitives/blob/main/packages/react/separator/CHANGELOG.md)
- [Commits](https://github.com/radix-ui/primitives/commits/HEAD/packages/react/separator)

Updates `@radix-ui/react-slot` from 1.3.3 to 1.4.0
- [Changelog](https://github.com/radix-ui/primitives/blob/main/packages/react/slot/CHANGELOG.md)
- [Commits](https://github.com/radix-ui/primitives/commits/HEAD/packages/react/slot)

Updates `@radix-ui/react-switch` from 1.3.7 to 1.3.8
- [Changelog](https://github.com/radix-ui/primitives/blob/main/packages/react/switch/CHANGELOG.md)
- [Commits](https://github.com/radix-ui/primitives/commits/HEAD/packages/react/switch)

Updates `@radix-ui/react-tabs` from 1.1.21 to 1.1.22
- [Changelog](https://github.com/radix-ui/primitives/blob/main/packages/react/tabs/CHANGELOG.md)
- [Commits](https://github.com/radix-ui/primitives/commits/HEAD/packages/react/tabs)

---
updated-dependencies:
- dependency-name: "@radix-ui/react-checkbox"
  dependency-version: 1.3.12
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: radix
- dependency-name: "@radix-ui/react-dialog"
  dependency-version: 1.2.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: radix
- dependency-name: "@radix-ui/react-label"
  dependency-version: 2.1.16
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: radix
- dependency-name: "@radix-ui/react-popover"
  dependency-version: 1.2.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: radix
- dependency-name: "@radix-ui/react-separator"
  dependency-version: 1.1.16
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: radix
- dependency-name: "@radix-ui/react-slot"
  dependency-version: 1.4.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: radix
- dependency-name: "@radix-ui/react-switch"
  dependency-version: 1.3.8
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: radix
- dependency-name: "@radix-ui/react-tabs"
  dependency-version: 1.1.22
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: radix
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-10-10 14:02:00 +07:00
dependabot[bot] 7c5271fa5b chore(deps): Bump lucide-react from 1.49.0 to 1.52.0 in /webapp (#127)
Bumps [lucide-react](https://github.com/lucide-icons/lucide/tree/HEAD/packages/lucide-react) from 1.49.0 to 1.52.0.
- [Release notes](https://github.com/lucide-icons/lucide/releases)
- [Commits](https://github.com/lucide-icons/lucide/commits/1.52.0/packages/lucide-react)

---
updated-dependencies:
- dependency-name: lucide-react
  dependency-version: 1.52.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-10-10 13:55:57 +07:00
dependabot[bot] 99d57a9fb3 chore(deps-dev): Bump the build-tooling group across 1 directory with 5 updates (#126)
Bumps the build-tooling group with 5 updates in the /webapp directory:

| Package | From | To |
| --- | --- | --- |
| [@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react/tree/HEAD/packages/plugin-react) | `6.1.1` | `6.1.2` |
| [eslint](https://github.com/eslint/eslint) | `10.11.0` | `10.12.0` |
| [knip](https://github.com/webpro-nl/knip/tree/HEAD/packages/knip) | `6.39.0` | `6.40.0` |
| [typescript-eslint](https://github.com/typescript-eslint/typescript-eslint/tree/HEAD/packages/typescript-eslint) | `8.71.0` | `8.71.1` |
| [vite](https://github.com/vitejs/vite/tree/HEAD/packages/vite) | `8.3.2` | `8.3.3` |



Updates `@vitejs/plugin-react` from 6.1.1 to 6.1.2
- [Release notes](https://github.com/vitejs/vite-plugin-react/releases)
- [Changelog](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react/CHANGELOG.md)
- [Commits](https://github.com/vitejs/vite-plugin-react/commits/plugin-react@6.1.2/packages/plugin-react)

Updates `eslint` from 10.11.0 to 10.12.0
- [Release notes](https://github.com/eslint/eslint/releases)
- [Commits](https://github.com/eslint/eslint/compare/v10.11.0...v10.12.0)

Updates `knip` from 6.39.0 to 6.40.0
- [Release notes](https://github.com/webpro-nl/knip/releases)
- [Commits](https://github.com/webpro-nl/knip/commits/knip@6.40.0/packages/knip)

Updates `typescript-eslint` from 8.71.0 to 8.71.1
- [Release notes](https://github.com/typescript-eslint/typescript-eslint/releases)
- [Changelog](https://github.com/typescript-eslint/typescript-eslint/blob/main/packages/typescript-eslint/CHANGELOG.md)
- [Commits](https://github.com/typescript-eslint/typescript-eslint/commits/v8.71.1/packages/typescript-eslint)

Updates `vite` from 8.3.2 to 8.3.3
- [Release notes](https://github.com/vitejs/vite/releases)
- [Changelog](https://github.com/vitejs/vite/blob/main/packages/vite/CHANGELOG.md)
- [Commits](https://github.com/vitejs/vite/commits/v8.3.3/packages/vite)

---
updated-dependencies:
- dependency-name: "@vitejs/plugin-react"
  dependency-version: 6.1.2
  dependency-type: direct:development
  update-type: version-update:semver-patch
  dependency-group: build-tooling
- dependency-name: eslint
  dependency-version: 10.12.0
  dependency-type: direct:development
  update-type: version-update:semver-minor
  dependency-group: build-tooling
- dependency-name: knip
  dependency-version: 6.40.0
  dependency-type: direct:development
  update-type: version-update:semver-minor
  dependency-group: build-tooling
- dependency-name: typescript-eslint
  dependency-version: 8.71.1
  dependency-type: direct:development
  update-type: version-update:semver-patch
  dependency-group: build-tooling
- dependency-name: vite
  dependency-version: 8.3.3
  dependency-type: direct:development
  update-type: version-update:semver-patch
  dependency-group: build-tooling
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-10-10 13:55:53 +07:00
github-actions[bot] 4f8abe66de Force update [2026-10-10] 2026-10-10 06:54:19 +00:00
dependabot[bot] c75ba24cbe chore(deps): Bump the tanstack group in /webapp with 3 updates (#123)
Bumps the tanstack group in /webapp with 3 updates: [@tanstack/react-query](https://github.com/TanStack/query/tree/HEAD/packages/react-query), [@tanstack/react-query-devtools](https://github.com/TanStack/query/tree/HEAD/packages/react-query-devtools) and [@tanstack/react-query-persist-client](https://github.com/TanStack/query/tree/HEAD/packages/react-query-persist-client).


Updates `@tanstack/react-query` from 5.104.0 to 5.104.1
- [Release notes](https://github.com/TanStack/query/releases)
- [Changelog](https://github.com/TanStack/query/blob/main/packages/react-query/CHANGELOG.md)
- [Commits](https://github.com/TanStack/query/commits/@tanstack/react-query@5.104.1/packages/react-query)

Updates `@tanstack/react-query-devtools` from 5.104.0 to 5.104.1
- [Release notes](https://github.com/TanStack/query/releases)
- [Changelog](https://github.com/TanStack/query/blob/main/packages/react-query-devtools/CHANGELOG.md)
- [Commits](https://github.com/TanStack/query/commits/@tanstack/react-query-devtools@5.104.1/packages/react-query-devtools)

Updates `@tanstack/react-query-persist-client` from 5.104.0 to 5.104.1
- [Release notes](https://github.com/TanStack/query/releases)
- [Changelog](https://github.com/TanStack/query/blob/main/packages/react-query-persist-client/CHANGELOG.md)
- [Commits](https://github.com/TanStack/query/commits/@tanstack/react-query-persist-client@5.104.1/packages/react-query-persist-client)

---
updated-dependencies:
- dependency-name: "@tanstack/react-query"
  dependency-version: 5.104.1
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: tanstack
- dependency-name: "@tanstack/react-query-devtools"
  dependency-version: 5.104.1
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: tanstack
- dependency-name: "@tanstack/react-query-persist-client"
  dependency-version: 5.104.1
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: tanstack
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-10-10 13:53:32 +07:00
dependabot[bot] 802c576d5f chore(deps): Bump the tauri-rs group in /webapp/src-tauri with 2 updates (#122)
Bumps the tauri-rs group in /webapp/src-tauri with 2 updates: [tauri](https://github.com/tauri-apps/tauri) and [tauri-plugin-single-instance](https://github.com/tauri-apps/plugins-workspace).


Updates `tauri` from 2.12.0 to 2.12.1
- [Release notes](https://github.com/tauri-apps/tauri/releases)
- [Commits](https://github.com/tauri-apps/tauri/compare/tauri-v2.12.0...tauri-v2.12.1)

Updates `tauri-plugin-single-instance` from 2.5.0 to 2.5.2
- [Release notes](https://github.com/tauri-apps/plugins-workspace/releases)
- [Commits](https://github.com/tauri-apps/plugins-workspace/compare/fs-v2.5.0...fs-v2.5.2)

---
updated-dependencies:
- dependency-name: tauri
  dependency-version: 2.12.1
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: tauri-rs
- dependency-name: tauri-plugin-single-instance
  dependency-version: 2.5.2
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: tauri-rs
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-10-10 13:53:17 +07:00
dependabot[bot] 8adf51daaa chore(deps): Bump the actions group with 4 updates (#124)
Bumps the actions group with 4 updates: [actions/upload-artifact](https://github.com/actions/upload-artifact), [actions/download-artifact](https://github.com/actions/download-artifact), [actions/setup-node](https://github.com/actions/setup-node) and [dtolnay/rust-toolchain](https://github.com/dtolnay/rust-toolchain).


Updates `actions/upload-artifact` from 7.0.1 to 7.0.2
- [Release notes](https://github.com/actions/upload-artifact/releases)
- [Commits](https://github.com/actions/upload-artifact/compare/043fb46d1a93c77aae656e7c1c64a875d1fc6a0a...cf430e030ddbb5b0abf93d22962f4752f3646cd9)

Updates `actions/download-artifact` from 8.0.1 to 8.0.2
- [Release notes](https://github.com/actions/download-artifact/releases)
- [Commits](https://github.com/actions/download-artifact/compare/3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c...9000827ccba6bdab643e8b6fd33ac0654aef8333)

Updates `actions/setup-node` from 7.0.0 to 7.1.0
- [Release notes](https://github.com/actions/setup-node/releases)
- [Commits](https://github.com/actions/setup-node/compare/820762786026740c76f36085b0efc47a31fe5020...949feb2413d6458794dcd2491c4babbbce0c15c1)

Updates `dtolnay/rust-toolchain` from 7e38f4b43b4db5c8dd498af069a4f6196df1d067 to e2a55d2ffb04f378e9626c28d38b36d230d1e12f
- [Release notes](https://github.com/dtolnay/rust-toolchain/releases)
- [Commits](https://github.com/dtolnay/rust-toolchain/compare/7e38f4b43b4db5c8dd498af069a4f6196df1d067...e2a55d2ffb04f378e9626c28d38b36d230d1e12f)

---
updated-dependencies:
- dependency-name: actions/upload-artifact
  dependency-version: 7.0.2
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: actions
- dependency-name: actions/download-artifact
  dependency-version: 8.0.2
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: actions
- dependency-name: actions/setup-node
  dependency-version: 7.1.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: actions
- dependency-name: dtolnay/rust-toolchain
  dependency-version: e2a55d2ffb04f378e9626c28d38b36d230d1e12f
  dependency-type: direct:production
  dependency-group: actions
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-10-10 13:53:13 +07:00
github-actions[bot] 494930996d Force update [2026-10-10] 2026-10-10 06:11:29 +00:00
github-actions[bot] 233f967181 Force update [2026-10-10] 2026-10-10 05:26:09 +00:00
poli0981andClaude Opus 5.5 9418e1d5ee chore(deps): clear the 5 Dependabot alerts; CI guard for Tauri crate/npm versions (#120)
Security (transitive npm deps; npm audit: 0): seroval 1.5.6 -> 1.6.9 (critical + high, via solid-js 1.9.17), sharp 0.35.4 -> 0.35.5 (high, via wrangler 4.149.0 / miniflare), source-map-js 1.2.1 -> 1.2.2 (high), smol-toml 1.8.0 -> 1.9.1 (medium); worker-configuration.d.ts regenerated for wrangler 4.149.

Tauri guard: Webapp CI runs `npm run check:tauri` (scripts/check-tauri-versions.mjs: Tauri crates vs their npm packages must share major.minor, as `tauri build` requires); Dependabot's cargo updates move to weekly Mondays like npm. CLAUDE.md gotcha 31.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-10 11:41:07 +07:00
github-actions[bot] 5727dd927a Force update [2026-10-10] 2026-10-10 04:40:05 +00:00
poli0981andClaude Opus 5.5 000bbb0e9f fix(tauri): tauri-plugin-opener 2.7.0 to match @tauri-apps/plugin-opener (#119)
Dependabot moved the npm package to 2.7.0 (#109) while Cargo.lock kept the crate at 2.6.0; `tauri build` refuses mismatched major/minor versions, so every v4.3.0 release build failed before compiling. `cargo update -p tauri-plugin-opener` locks 2.7.0 and drops the windows 0.61 crates only 2.6.0 used. Checked with `npx tauri info` and `cargo check --locked`.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-10 11:05:08 +07:00
poli0981andClaude Opus 5.5 8ba21485ff fix(workflows): force_update dispatches refresh.yml; queued runs scan the latest main (#118)
force_update.yml called refresh.yml through `uses:` and failed at startup ("workflow file issue", no annotation); it had never run since v4. It now dispatches refresh.yml with full=true (new workflow_dispatch input; refresh.yml drops workflow_call). refresh.yml's scan checks out the branch as it is when the job starts, so runs waiting in the refresh-pipeline queue see the previous run's state and consecutive force-update dispatches cover consecutive batches. Verified end to end on the branch (one URL re-scraped and applied to main as f03211d).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-10 10:57:39 +07:00
github-actions[bot] f03211d5d2 Force update [2026-10-10] 2026-10-10 03:56:42 +00:00
poli0981andClaude Opus 5.5 7f6994a9dc itch.io AI disclosure + accessibility, tagline descriptions; bump to 4.3.0 (#117) [skip-discuss]
itch.io game pages now carry an "AI Disclosure" row (AI Assisted, then what it was used for), a "Content" row ("No generative AI was used", /games/tag-no-ai) and an "Accessibility" row. The scraper reads them into three optional fields (ai_disclosure, ai_content, accessibility), which the daily refresh keeps current; description becomes the creator's tagline (og:description), else the first sentence as before; whitespace inside titles and links is collapsed. A --full re-scrape keeps a known release_date / thumbnail (itch.io shows "Published" only for a few weeks).

Web app: "Generative AI" and "Accessibility" filters on /games (?ai=, ?access=), game-page rows, three charts (Overview: Generative AI; Discovery: Accessibility Features, What AI Was Used For). EN/VI strings, docs, changelog, version 4.3.0.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-10 10:49:13 +07:00
github-actions[bot] 1b596b9927 Refresh catalog [2026-10-10] 2026-10-10 03:34:25 +00:00
github-actions[bot] 23d2fb2820 Ingest queued games [2026-10-10] 2026-10-10 01:53:31 +00:00
freeitchgames-admin[bot] 2a99b3a62c Queue 21 game(s) for ingest [admin]
Via the admin page.

https://dumivid.itch.io/raccoon-valley-tycoon
https://elliotdegrassi.itch.io/dont-rock-the-boat
https://featurekreep.itch.io/royal-gems
https://funday-games.itch.io/battle-healer-hildegard
https://inativestudio.itch.io/bloodbuild
https://itslamba.itch.io/wreckbox
https://ktch9541.itch.io/missile-stream
https://logos-psychagogia.itch.io/time-survivor
https://magnate-games.itch.io/anime-biz-magnate
https://mikdog.itch.io/people-watching
https://nearlydonegames.itch.io/idlecraft
https://nearlydonegames.itch.io/roll-together
https://spratt.itch.io/attack-axis
https://theqproyect.itch.io/isaacmarama
https://0yourstruely0.itch.io/puzzle-world-online
https://astaysdev.itch.io/afterlight-stays
https://happy-ferret.itch.io/cheshire-4-console-demo
https://methodox.itch.io/character-customizer-2d
https://myr5.itch.io/the-last-time-i-went-to-the-forest
https://ubaepeach.itch.io/diagnosis-lovesick
https://yassdev.itch.io/take-my-skin
2026-10-10 01:51:57 +00:00
github-actions[bot] c46279f0e4 Ingest queued games [2026-10-09] 2026-10-09 15:38:36 +00:00
freeitchgames-admin[bot] a7cb9cdcf2 Queue 3 game(s) for ingest [admin]
Via the admin page.

https://coldember.itch.io/two-literal-pink-square
https://funtimefreddie.itch.io/occultics
https://thecrimsondm-vanillia.itch.io/pony-cuddle-castle
2026-10-09 15:38:15 +00:00
github-actions[bot] a50d267abc Ingest queued games [2026-10-09] 2026-10-09 10:44:01 +00:00
freeitchgames-admin[bot] 17ae9a80e5 Queue 34 game(s) for ingest [admin]
Via the admin page.

https://developernoah.itch.io/grandpas-garage
https://n1kozor.itch.io/cotton-city-alpha-demo
https://beeskeeper.itch.io/arcade-a
https://biggerdyl.itch.io/the-toy-store
https://c-mastered-studio.itch.io/the-human-algorithm
https://kekoyum.itch.io/mayas-school-life
https://phaker.itch.io/chess-game
https://shadowbuddy2006.itch.io/just-take-cookies
https://arshia-aa.itch.io/explosive-chasers
https://bezdelie.itch.io/tuman-command
https://nikita-bg.itch.io/incretower-demo
https://tjlazer.itch.io/bruce-lee-for-amiga
https://ameae.itch.io/this-isnt-real
https://birdylight.itch.io/meridian
https://chuck-chan.itch.io/la-sorciere-des-neiges
https://hokuto1017.itch.io/kobayakawa-san-is-a-soulslike-big
https://kingalex2000.itch.io/living-large
https://kinmoku.itch.io/ace-aro-one-night-early
https://laralaiila.itch.io/pinorama
https://low-visual-art.itch.io/hear-yourself
https://nenugames.itch.io/die-kritik-experience
https://neolavi.itch.io/do-you-want-to-know-your-oshi-demo
https://pixelreverie.itch.io/memories-in-reverie
https://sybat.itch.io/pullus
https://vanadium9.itch.io/the-bully-at-my-new-magic-school-loves-me
https://zeiyanemi.itch.io/fatal-love-hibiscus
https://funday-games.itch.io/the-margot-collapse
https://inuu104.itch.io/hako-and-mewo
https://mireuarchive.itch.io/escape-the-ejection
https://askitari-games.itch.io/swole-blessings
https://carlragdoll.itch.io/carl
https://falsedoor.itch.io/dorm-game
https://shiftbacktick.itch.io/the-omega-reach
https://yuutp.itch.io/a-fortnight-in-another-world
2026-10-09 10:41:40 +00:00
github-actions[bot] 759c15e396 Refresh catalog [2026-10-09] 2026-10-09 03:33:09 +00:00
dependabot[bot] 47f2979e24 chore(deps): Bump dtolnay/rust-toolchain (#116)
Bumps the actions group with 1 update: [dtolnay/rust-toolchain](https://github.com/dtolnay/rust-toolchain).


Updates `dtolnay/rust-toolchain` from 02cb101ec7c40f2c49e1d9714d64511d8e1b74de to 7e38f4b43b4db5c8dd498af069a4f6196df1d067
- [Release notes](https://github.com/dtolnay/rust-toolchain/releases)
- [Commits](https://github.com/dtolnay/rust-toolchain/compare/02cb101ec7c40f2c49e1d9714d64511d8e1b74de...7e38f4b43b4db5c8dd498af069a4f6196df1d067)

---
updated-dependencies:
- dependency-name: dtolnay/rust-toolchain
  dependency-version: 7e38f4b43b4db5c8dd498af069a4f6196df1d067
  dependency-type: direct:production
  dependency-group: actions
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-10-08 14:41:47 +07:00
dependabot[bot] 5508aad76c chore(deps-dev): Update ruff requirement (#115)
Updates the requirements on [ruff](https://github.com/astral-sh/ruff) to permit the latest version.

Updates `ruff` to 0.16.10
- [Release notes](https://github.com/astral-sh/ruff/releases)
- [Changelog](https://github.com/astral-sh/ruff/blob/main/CHANGELOG.md)
- [Commits](https://github.com/astral-sh/ruff/compare/0.16.9...0.16.10)

---
updated-dependencies:
- dependency-name: ruff
  dependency-version: 0.16.10
  dependency-type: direct:development
  dependency-group: python
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-10-08 14:40:01 +07:00
github-actions[bot] c16e011824 Ingest queued games [2026-10-08] 2026-10-08 07:00:29 +00:00
freeitchgames-admin[bot] b6676515ba Queue 7 game(s) for ingest [admin]
Via the admin page.

https://feral-interactive.itch.io/lunch-claps-back
https://feral-interactive.itch.io/block-the-bulldozers
https://feral-interactive.itch.io/hairball-hunt
https://feral-interactive.itch.io/nine-lives-in-the-gig-economy
https://feral-interactive.itch.io/lunch-knocks-it-off
https://feral-interactive.itch.io/bureau-of-free-money-the-game
https://feral-interactive.itch.io/lunch-idle
2026-10-08 06:59:58 +00:00
github-actions[bot] 5a3b205a68 Ingest queued games [2026-10-08] 2026-10-08 06:34:41 +00:00
freeitchgames-admin[bot] 7a40fe1960 Queue 16 game(s) for ingest [admin]
Via the admin page.

https://hugimugi7.itch.io/yes-comrade
https://selene3.itch.io/carol-penultimate
https://alegia.itch.io/chaojiandai
https://bai-skull.itch.io/zombie-dream-hide-in-dark
https://bonaqua37.itch.io/snort-white-and-the-seven-dwarfs-final-edition
https://goshtyyae.itch.io/curse-general
https://kiteneon-games.itch.io/trial-in-eos-chasma
https://lynntrassh.itch.io/in-return
https://exodus-indiedev.itch.io/the-bureau
https://pepsica.itch.io/forget-me-not
https://ravenous-den.itch.io/toss-office
https://rionix.itch.io/eternal-mist
https://stelexsoftware.itch.io/king-4-a-day
https://alekirser.itch.io/hivemind-monster-profits
https://lguidolin.itch.io/one-more-saturday
https://magllama.itch.io/tazunas-secret
2026-10-08 06:33:42 +00:00
github-actions[bot] c627fbe30e Refresh catalog [2026-10-08] 2026-10-08 03:32:26 +00:00
github-actions[bot] 31fb4f6adc Ingest queued games [2026-10-07] 2026-10-07 08:51:23 +00:00
freeitchgames-admin[bot] 85b70c39fc Queue 22 game(s) for ingest [admin]
Via the admin page.

https://beepsignal.itch.io/i-learned-to-draw-because-of-you
https://qwillit.itch.io/re-quest
https://zaptsas.itch.io/icarus-deep
https://baldhar.itch.io/size-auto-battler
https://akaerocore.itch.io/raising-a-happy-neet
https://captncorazn.itch.io/on-the-rocks
https://fishfoodgames.itch.io/thalassophile
https://kitanosawako.itch.io/uraku-sekihan
https://mickybussey.itch.io/do-not-recommend
https://myangel-xe.itch.io/asteria-academy-letters-from-spring
https://writer31.itch.io/say-youll-forgive-me
https://zliiizll.itch.io/osaff
https://aetheredge-studios.itch.io/word-chain
https://artyfartygames.itch.io/rooftop-lovematch
https://hugimugi7.itch.io/quackyard
https://jebouin.itch.io/alien-crab-3
https://mysta.itch.io/openvorev06
https://rubychoco.itch.io/arcostate
https://steamberry.itch.io/thornewood
https://timany19.itch.io/cultivation-stories
https://hiddenwriter.itch.io/stompy-stompy-panic
https://thextra.itch.io/heart-shooter
2026-10-07 08:49:38 +00:00
github-actions[bot] bf0dd9d42c Refresh catalog [2026-10-07] 2026-10-07 03:33:39 +00:00
github-actions[bot] 47dc84430e Refresh catalog [2026-10-06] 2026-10-06 03:30:31 +00:00
github-actions[bot] 8ce5d725dd Ingest queued games [2026-10-06] 2026-10-06 01:19:01 +00:00
freeitchgames-admin[bot] 3189664999 Queue 12 game(s) for ingest [admin]
Via the admin page.

https://cammymoop.itch.io/grid-game-maker-preview
https://flefgames.itch.io/maketimepastfaster
https://angelparedesh20.itch.io/through-the-graveyard
https://armiyashi86.itch.io/spiritual-root
https://colectivo-anhelo.itch.io/iberia-ignota-alboleta
https://dominoclub.itch.io/at-a-distance
https://hiddenwriter.itch.io/secret-of-sizon
https://ruizukun-dev.itch.io/malfoid-dating-sim
https://seraten04.itch.io/harbingers
https://soupsarah.itch.io/doki-doki-diagnostics
https://starotyu.itch.io/love-after-sunset-preview
https://v-ual.itch.io/silver-witch-princess-vai
2026-10-06 01:18:12 +00:00
github-actions[bot] 15d043c012 Ingest queued games [2026-10-05] 2026-10-05 16:52:14 +00:00
freeitchgames-admin[bot] 1b881add38 Queue 12 game(s) for ingest [admin]
Via the admin page.

https://andyman404.itch.io/interloper
https://bilgetbd.itch.io/maybe-ill-go-to-the-beach
https://entityzeta.itch.io/caso-northport
https://euclicide.itch.io/flower-demo-2
https://gameinnovationlab.itch.io/cloud
https://horse-hoof-games.itch.io/the-corpse-below
https://jollyjack.itch.io/padre-got-a-gun
https://mrvitaspikemodz.itch.io/the-spike-mod-by-mrvtaspike-modz-v3
https://oddly-shaped-pixels.itch.io/alpine
https://posmnaut.itch.io/pig-iron
https://pr1nted.itch.io/open-doctrines
https://tonsomo.itch.io/quantum-hop-sinclair-spectrum-edition
2026-10-05 16:51:21 +00:00
github-actions[bot] ca5fab2614 Ingest queued games [2026-10-05] 2026-10-05 12:30:08 +00:00
freeitchgames-admin[bot] 94da18e8da Queue 27 game(s) for ingest [admin]
Via the admin page.

https://dalichrome.itch.io/house-rules
https://kskdaze.itch.io/very-hard-machiawase
https://marrowmarch.itch.io/marrow-march
https://master-linkuei.itch.io/columns-ii-md
https://endrewa.itch.io/bandidos-em-brasilia
https://fwvulu.itch.io/og-lethal-ape-redux
https://chi-yi.itch.io/slc-nocturne
https://kotocra.itch.io/three-notifications-unread
https://motivebureau.itch.io/dollhouse
https://ojrogue.itch.io/can-i-fix-her
https://ravenanikiri.itch.io/anastasis
https://rinuinui.itch.io/shians-computation
https://greenbum1.itch.io/dont-fly-dubai-quest
https://antoine-aubin.itch.io/a-wave-that-i-a-furry-visual-novel
https://cypherboh.itch.io/nina-just-choose
https://gas1129.itch.io/hachiokusyakusama
https://imrank-seo.itch.io/stranded-with-you
https://nuyze.itch.io/stoneskip
https://raycastly.itch.io/stoned
https://beholdernx.itch.io/adrorium
https://prettyscar.itch.io/uppercute
https://bluedragondreaming.itch.io/elemental-harmony
https://himikurokawa.itch.io/kawaii-yume-senpai
https://kemoniagames.itch.io/lambdawn
https://zionalexiel.itch.io/typing-defense
https://lemoncosmos.itch.io/seeking-stardust
https://studiolokal.itch.io/morningwillwait
2026-10-05 12:27:56 +00:00
dependabot[bot] c2463818a4 chore(deps-dev): Bump @types/node from 24.13.6 to 24.19.1 in /webapp (#114)
Bumps [@types/node](https://github.com/DefinitelyTyped/DefinitelyTyped/tree/HEAD/types/node) from 24.13.6 to 24.19.1.
- [Release notes](https://github.com/DefinitelyTyped/DefinitelyTyped/releases)
- [Commits](https://github.com/DefinitelyTyped/DefinitelyTyped/commits/HEAD/types/node)

---
updated-dependencies:
- dependency-name: "@types/node"
  dependency-version: 24.19.0
  dependency-type: direct:development
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-10-05 14:47:20 +07:00
github-actions[bot] 73c44d4088 Refresh catalog [2026-10-05] 2026-10-05 03:33:09 +00:00
dependabot[bot] 7ec2035675 chore(deps-dev): Bump globals from 17.12.0 to 17.13.0 in /webapp (#113)
Bumps [globals](https://github.com/sindresorhus/globals) from 17.12.0 to 17.13.0.
- [Release notes](https://github.com/sindresorhus/globals/releases)
- [Commits](https://github.com/sindresorhus/globals/compare/v17.12.0...v17.13.0)

---
updated-dependencies:
- dependency-name: globals
  dependency-version: 17.13.0
  dependency-type: direct:development
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-10-05 10:13:13 +07:00
dependabot[bot] 7ddabf66f8 chore(deps-dev): Bump vitest from 5.0.1 to 5.0.3 in /webapp (#112)
Bumps [vitest](https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest) from 5.0.1 to 5.0.3.
- [Release notes](https://github.com/vitest-dev/vitest/releases)
- [Changelog](https://github.com/vitest-dev/vitest/blob/main/docs/releases.md)
- [Commits](https://github.com/vitest-dev/vitest/commits/v5.0.3/packages/vitest)

---
updated-dependencies:
- dependency-name: vitest
  dependency-version: 5.0.3
  dependency-type: direct:development
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-10-05 10:09:05 +07:00
dependabot[bot] 3e7e39a105 chore(deps-dev): Bump the build-tooling group in /webapp with 2 updates (#111)
Bumps the build-tooling group in /webapp with 2 updates: [knip](https://github.com/webpro-nl/knip/tree/HEAD/packages/knip) and [vite](https://github.com/vitejs/vite/tree/HEAD/packages/vite).


Updates `knip` from 6.38.0 to 6.39.0
- [Release notes](https://github.com/webpro-nl/knip/releases)
- [Commits](https://github.com/webpro-nl/knip/commits/knip@6.39.0/packages/knip)

Updates `vite` from 8.3.1 to 8.3.2
- [Release notes](https://github.com/vitejs/vite/releases)
- [Changelog](https://github.com/vitejs/vite/blob/main/packages/vite/CHANGELOG.md)
- [Commits](https://github.com/vitejs/vite/commits/v8.3.2/packages/vite)

---
updated-dependencies:
- dependency-name: knip
  dependency-version: 6.39.0
  dependency-type: direct:development
  update-type: version-update:semver-minor
  dependency-group: build-tooling
- dependency-name: vite
  dependency-version: 8.3.2
  dependency-type: direct:development
  update-type: version-update:semver-patch
  dependency-group: build-tooling
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-10-05 10:02:05 +07:00
github-actions[bot] dfbf4fdd95 Refresh catalog [2026-10-04] 2026-10-04 04:27:46 +00:00
dependabot[bot] 947ff863ac chore(deps): Bump lucide-react from 1.47.0 to 1.49.0 in /webapp (#96)
Bumps [lucide-react](https://github.com/lucide-icons/lucide/tree/HEAD/packages/lucide-react) from 1.47.0 to 1.49.0.
- [Release notes](https://github.com/lucide-icons/lucide/releases)
- [Commits](https://github.com/lucide-icons/lucide/commits/1.49.0/packages/lucide-react)

---
updated-dependencies:
- dependency-name: lucide-react
  dependency-version: 1.48.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-10-04 09:49:47 +07:00
dependabot[bot] cd4c22893c chore(deps): Bump the tauri-rs group in /webapp/src-tauri with 4 updates (#102)
Bumps the tauri-rs group in /webapp/src-tauri with 4 updates: [tauri](https://github.com/tauri-apps/tauri), [tauri-plugin-opener](https://github.com/tauri-apps/plugins-workspace), [tauri-plugin-single-instance](https://github.com/tauri-apps/plugins-workspace) and [tauri-build](https://github.com/tauri-apps/tauri).


Updates `tauri` from 2.11.5 to 2.12.0
- [Release notes](https://github.com/tauri-apps/tauri/releases)
- [Commits](https://github.com/tauri-apps/tauri/compare/tauri-v2.11.5...tauri-v2.12.0)

Updates `tauri-plugin-opener` from 2.5.5 to 2.6.0
- [Release notes](https://github.com/tauri-apps/plugins-workspace/releases)
- [Commits](https://github.com/tauri-apps/plugins-workspace/compare/http-v2.5.5...fs-v2.6.0)

Updates `tauri-plugin-single-instance` from 2.4.4 to 2.5.0
- [Release notes](https://github.com/tauri-apps/plugins-workspace/releases)
- [Commits](https://github.com/tauri-apps/plugins-workspace/compare/fs-v2.4.4...fs-v2.5.0)

Updates `tauri-build` from 2.6.3 to 2.7.1
- [Release notes](https://github.com/tauri-apps/tauri/releases)
- [Commits](https://github.com/tauri-apps/tauri/compare/tauri-build-v2.6.3...tauri-build-v2.7.1)

---
updated-dependencies:
- dependency-name: tauri
  dependency-version: 2.12.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: tauri-rs
- dependency-name: tauri-plugin-opener
  dependency-version: 2.6.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: tauri-rs
- dependency-name: tauri-plugin-single-instance
  dependency-version: 2.5.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: tauri-rs
- dependency-name: tauri-build
  dependency-version: 2.7.1
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: tauri-rs
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-10-04 09:21:26 +07:00
dependabot[bot] a861f5979d chore(deps): Bump the tanstack group across 1 directory with 3 updates (#104)
Bumps the tanstack group with 3 updates in the /webapp directory: [@tanstack/react-query](https://github.com/TanStack/query/tree/HEAD/packages/react-query), [@tanstack/react-query-devtools](https://github.com/TanStack/query/tree/HEAD/packages/react-query-devtools) and [@tanstack/react-query-persist-client](https://github.com/TanStack/query/tree/HEAD/packages/react-query-persist-client).


Updates `@tanstack/react-query` from 5.103.1 to 5.104.0
- [Release notes](https://github.com/TanStack/query/releases)
- [Changelog](https://github.com/TanStack/query/blob/main/packages/react-query/CHANGELOG.md)
- [Commits](https://github.com/TanStack/query/commits/@tanstack/react-query@5.104.0/packages/react-query)

Updates `@tanstack/react-query-devtools` from 5.103.1 to 5.104.0
- [Release notes](https://github.com/TanStack/query/releases)
- [Changelog](https://github.com/TanStack/query/blob/main/packages/react-query-devtools/CHANGELOG.md)
- [Commits](https://github.com/TanStack/query/commits/@tanstack/react-query-devtools@5.104.0/packages/react-query-devtools)

Updates `@tanstack/react-query-persist-client` from 5.103.1 to 5.104.0
- [Release notes](https://github.com/TanStack/query/releases)
- [Changelog](https://github.com/TanStack/query/blob/main/packages/react-query-persist-client/CHANGELOG.md)
- [Commits](https://github.com/TanStack/query/commits/@tanstack/react-query-persist-client@5.104.0/packages/react-query-persist-client)

---
updated-dependencies:
- dependency-name: "@tanstack/react-query"
  dependency-version: 5.104.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: tanstack
- dependency-name: "@tanstack/react-query-devtools"
  dependency-version: 5.104.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: tanstack
- dependency-name: "@tanstack/react-query-persist-client"
  dependency-version: 5.104.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: tanstack
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-10-04 08:57:27 +07:00
dependabot[bot] 5691197d73 chore(deps): Bump the tauri-js group across 1 directory with 3 updates (#109)
Bumps the tauri-js group with 3 updates in the /webapp directory: [@tauri-apps/api](https://github.com/tauri-apps/tauri), [@tauri-apps/plugin-opener](https://github.com/tauri-apps/plugins-workspace) and [@tauri-apps/cli](https://github.com/tauri-apps/tauri).


Updates `@tauri-apps/api` from 2.11.1 to 2.12.1
- [Release notes](https://github.com/tauri-apps/tauri/releases)
- [Commits](https://github.com/tauri-apps/tauri/compare/@tauri-apps/api-v2.11.1...@tauri-apps/api-v2.12.1)

Updates `@tauri-apps/plugin-opener` from 2.5.5 to 2.7.0
- [Release notes](https://github.com/tauri-apps/plugins-workspace/releases)
- [Commits](https://github.com/tauri-apps/plugins-workspace/compare/http-v2.5.5...log-v2.7.0)

Updates `@tauri-apps/cli` from 2.11.4 to 2.12.1
- [Release notes](https://github.com/tauri-apps/tauri/releases)
- [Commits](https://github.com/tauri-apps/tauri/compare/@tauri-apps/cli-v2.11.4...@tauri-apps/cli-v2.12.1)

---
updated-dependencies:
- dependency-name: "@tauri-apps/api"
  dependency-version: 2.12.1
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: tauri-js
- dependency-name: "@tauri-apps/plugin-opener"
  dependency-version: 2.7.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: tauri-js
- dependency-name: "@tauri-apps/cli"
  dependency-version: 2.12.1
  dependency-type: direct:development
  update-type: version-update:semver-minor
  dependency-group: tauri-js
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-10-04 08:43:27 +07:00
poli0981andClaude Opus 5.5 b0ebb8e9c6 chore(wrangler): drop inherited workers_dev / preview_urls from env.staging (#110)
Both keys are inheritable in wrangler, so staging already resolves to
false from the top level (checked with unstable_readConfig). Vars,
bindings and the empty crons override stay: those are not inherited.

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-04 08:38:25 +07:00
dependabot[bot] c2a0babdc1 chore(deps-dev): Bump @types/node from 24.13.5 to 24.13.6 in /webapp (#97)
Bumps [@types/node](https://github.com/DefinitelyTyped/DefinitelyTyped/tree/HEAD/types/node) from 24.13.5 to 24.13.6.
- [Release notes](https://github.com/DefinitelyTyped/DefinitelyTyped/releases)
- [Commits](https://github.com/DefinitelyTyped/DefinitelyTyped/commits/HEAD/types/node)

---
updated-dependencies:
- dependency-name: "@types/node"
  dependency-version: 24.13.6
  dependency-type: direct:development
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-10-04 08:32:23 +07:00
dependabot[bot] 9d5f57c3c8 chore(deps-dev): Bump the build-tooling group across 1 directory with 4 updates (#108)
Bumps the build-tooling group with 4 updates in the /webapp directory: [eslint](https://github.com/eslint/eslint), [knip](https://github.com/webpro-nl/knip/tree/HEAD/packages/knip), [typescript-eslint](https://github.com/typescript-eslint/typescript-eslint/tree/HEAD/packages/typescript-eslint) and [vite](https://github.com/vitejs/vite/tree/HEAD/packages/vite).


Updates `eslint` from 10.10.0 to 10.11.0
- [Release notes](https://github.com/eslint/eslint/releases)
- [Commits](https://github.com/eslint/eslint/compare/v10.10.0...v10.11.0)

Updates `knip` from 6.37.0 to 6.38.0
- [Release notes](https://github.com/webpro-nl/knip/releases)
- [Commits](https://github.com/webpro-nl/knip/commits/knip@6.38.0/packages/knip)

Updates `typescript-eslint` from 8.70.0 to 8.71.0
- [Release notes](https://github.com/typescript-eslint/typescript-eslint/releases)
- [Changelog](https://github.com/typescript-eslint/typescript-eslint/blob/main/packages/typescript-eslint/CHANGELOG.md)
- [Commits](https://github.com/typescript-eslint/typescript-eslint/commits/v8.71.0/packages/typescript-eslint)

Updates `vite` from 8.3.0 to 8.3.1
- [Release notes](https://github.com/vitejs/vite/releases)
- [Changelog](https://github.com/vitejs/vite/blob/main/packages/vite/CHANGELOG.md)
- [Commits](https://github.com/vitejs/vite/commits/v8.3.1/packages/vite)

---
updated-dependencies:
- dependency-name: eslint
  dependency-version: 10.11.0
  dependency-type: direct:development
  update-type: version-update:semver-minor
  dependency-group: build-tooling
- dependency-name: knip
  dependency-version: 6.38.0
  dependency-type: direct:development
  update-type: version-update:semver-minor
  dependency-group: build-tooling
- dependency-name: typescript-eslint
  dependency-version: 8.71.0
  dependency-type: direct:development
  update-type: version-update:semver-minor
  dependency-group: build-tooling
- dependency-name: vite
  dependency-version: 8.3.1
  dependency-type: direct:development
  update-type: version-update:semver-patch
  dependency-group: build-tooling
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-10-04 08:26:40 +07:00
github-actions[bot] 3c5fc28586 Ingest queued games [2026-10-03] 2026-10-03 13:11:35 +00:00
freeitchgames-admin[bot] e0862323cf Queue 8 game(s) for ingest [admin]
Via the admin page.

https://avrana.itch.io/malfoid
https://jaximus01.itch.io/connections-prototype
https://life-crises.itch.io/your-redacted-boyfriend
https://otter040.itch.io/2004-fallinlove
https://puzzle-deluxe.itch.io/help-my-yandere-is-too-shy
https://saltiepng.itch.io/mollys-marvelous-photos
https://tabbiedearest.itch.io/one-must-show-eileen-happy
https://tigernoalvin.itch.io/tavern-relic-tales
2026-10-03 13:10:59 +00:00
poli0981andClaude Opus 5.5 169f77f806 chore(deps-dev): wrangler 4.147 (undici advisories via miniflare) (#107)
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-03 19:38:56 +07:00
poli0981andClaude Opus 5.5 605d14f022 docs: CLAUDE.md marks v4.2.0 as released (#106)
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-03 19:32:11 +07:00
poli0981andClaude Opus 5.5 a3bfe04b40 Compact catalog packs, binary cache, themed scrollbars; bump to 4.2.0 (#103) [skip-discuss]
- Catalog packs: the build emits /data/pack/manifest-v1.json plus
  content-hashed deflate-raw packs (columns + dictionaries); the site and
  the apps read them (about 264 KB on a first visit instead of about 520 KB
  of JSON). Descriptions live in their own packs and load on demand (a game
  page: its chunk; a search: all of them).
- The IndexedDB cache is stored as compressed bytes by a small binary
  persister (replaces @tanstack/query-async-storage-persister); fflate is
  the lazy fallback where the browser has no Compression Streams.
- The readable /data/*.json goes only to apps 4.0-4.1.1 (Tauri Origin);
  everyone else gets a 410 with links to the repository
  (worker/legacy-data.ts, five positive run_worker_first entries).
- /img: exact width strings only, fallback originals and missing images
  kept at the edge for a day, failed background puts are logged.
- Themed scrollbars and a "Hide scrollbars" setting (Settings and the
  display menu); chart cards no longer block their list scrollbars.
- Policies (LEGAL_VERSION 2026-10-03): data reuse goes through the
  repository. Docs, changelog and version 4.2.0.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-03 19:19:42 +07:00
github-actions[bot] 960e9ba4bb Ingest queued games [2026-10-03] 2026-10-03 04:21:16 +00:00
freeitchgames-admin[bot] e2f7194e33 Queue 57 game(s) for ingest [admin]
Via the admin page.

https://maxalo.itch.io/gumball
https://toledo-art.itch.io/campo-largo
https://arghbulous.itch.io/the-muzeum
https://benjames171.itch.io/ghostbusters
https://ossuario.itch.io/my-own-sweet-dionaea
https://juba13.itch.io/idle-anglersv1
https://ikarusangel.itch.io/time-bound
https://zilluzion.itch.io/enter-sempiternity
https://benjames171.itch.io/angleball
https://digitaldesigndude.itch.io/biodie
https://thedampsquid.itch.io/beyond-the-frame
https://chaostheorygames.itch.io/thornhold
https://colourplay-games.itch.io/the-arcade-demo
https://eternal-kosetsu.itch.io/burnt-toast
https://juba13.itch.io/pcb-defense
https://linglyum.itch.io/steal-me-softly
https://rainbowcemetery.itch.io/night-watch
https://sillywunkus.itch.io/core
https://snow-g.itch.io/void-lancer
https://wavey-games.itch.io/the-dissident
https://yofiasi.itch.io/barista
https://arghbulous.itch.io/ink-beneath-the-water
https://arrokoth486958.itch.io/the-picture-of-delusion
https://brickman59.itch.io/80-plates
https://crrn.itch.io/scp-cu
https://delve-murder-nevermore.itch.io/deadline-on-the-line
https://itsbumblebear.itch.io/the-devils-in-the-details
https://junekazoo.itch.io/bleeding-in-ink
https://nulljamgames.itch.io/rotheart
https://seereeh.itch.io/restless-is-the-night
https://teacuppo.itch.io/lovestruck
https://writer31.itch.io/sail-away
https://j1mmyy.itch.io/refished
https://tygamesbzh.itch.io/super-reaktor
https://viniflores.itch.io/my-own-hero-party
https://4noki.itch.io/thine-curse-of-loss
https://ah-real-games.itch.io/welcome-to-the-veil
https://akilargie.itch.io/last-missing
https://chanchangames.itch.io/hazard-crew
https://differenteagletragedy.itch.io/fade-into-you
https://dimikira.itch.io/no-comment
https://dreamty-dream.itch.io/tomayto-tomahto
https://ellaris.itch.io/spooktober-ghosts
https://futotori.itch.io/the-commander-cant-communicate
https://i-choose-paradise.itch.io/cat-with-knife
https://jitterrue.itch.io/ruenacle
https://kyveli07.itch.io/sorry-for-the-rope
https://nearlynotquite.itch.io/where-the-ashes-sleep
https://night-asobu.itch.io/site-burial
https://niihi3.itch.io/birdcage-pand
https://nunus-house.itch.io/beholderx
https://otojang.itch.io/millie-and-finny
https://platedr.itch.io/butchers-delight
https://sudachys.itch.io/going-once-cut-twice
https://the-riversitters.itch.io/marseille
https://try-froggery.itch.io/bite-your-tongue
https://wednesday888.itch.io/morningbelle
2026-10-03 04:17:29 +00:00
github-actions[bot] d6e06c6dcb Refresh catalog [2026-10-03] 2026-10-03 03:37:34 +00:00
github-actions[bot] b52b73c652 Refresh catalog [2026-10-02] 2026-10-02 03:28:18 +00:00
dependabot[bot] 83b6eeb667 chore(deps-dev): Bump the python group across 1 directory with 2 updates (#98)
Updates the requirements on [ruff](https://github.com/astral-sh/ruff) and [pytest](https://github.com/pytest-dev/pytest) to permit the latest version.

Updates `ruff` to 0.16.9
- [Release notes](https://github.com/astral-sh/ruff/releases)
- [Changelog](https://github.com/astral-sh/ruff/blob/main/CHANGELOG.md)
- [Commits](https://github.com/astral-sh/ruff/compare/0.16.8...0.16.9)

Updates `pytest` to 9.1.1
- [Release notes](https://github.com/pytest-dev/pytest/releases)
- [Changelog](https://github.com/pytest-dev/pytest/blob/main/CHANGELOG.rst)
- [Commits](https://github.com/pytest-dev/pytest/compare/9.1.0...9.1.1)

---
updated-dependencies:
- dependency-name: ruff
  dependency-version: 0.16.9
  dependency-type: direct:development
  dependency-group: python
- dependency-name: pytest
  dependency-version: 9.1.1
  dependency-type: direct:development
  dependency-group: python
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-10-02 08:13:02 +07:00
github-actions[bot] 372bbe16bc Refresh catalog [2026-10-01] 2026-10-01 03:31:59 +00:00
github-actions[bot] 61c8789b54 Ingest queued games [2026-10-01] 2026-10-01 01:10:14 +00:00
freeitchgames-admin[bot] 0c0ddf3132 Queue 23 game(s) for ingest [admin]
Via the admin page.

https://absor4.itch.io/sensha-breakpoint
https://bimicerika.itch.io/1001-vies
https://comfortkuma.itch.io/next-station-the-moon
https://askgames.itch.io/after-me-demo
https://chaostheorygames.itch.io/all-the-birds
https://chaostheorygames.itch.io/stoneheart-archive
https://cutegamesclub.itch.io/bug-boy-summer
https://cuteshadow.itch.io/tokidoki-tactical-squad
https://davemakes.itch.io/nara-mari
https://dokkodolabs.itch.io/neo-forge
https://ellian.itch.io/longestini
https://foxtrot-creamery.itch.io/foxtrot-creamery-demo
https://ikemenaddicts.itch.io/obsessionsyndrome
https://k-ramstack.itch.io/leaftaker
https://konayachi.itch.io/peregrine
https://kyatt7.itch.io/schwarzerbrikz
https://lyamgtt.itch.io/magical-greenhouse
https://sitrex.itch.io/pinwheel-playground
https://studioloading.itch.io/orpheus
https://sudachys.itch.io/the-angel-act
https://umistudiogame.itch.io/yuukisky-demo
https://vl42.itch.io/merchants-and-rails
https://zieelane.itch.io/helping-your-boyfriend
2026-10-01 01:08:30 +00:00
github-actions[bot] f3ace7ad3f Ingest queued games [2026-09-30] 2026-09-30 08:27:42 +00:00
freeitchgames-admin[bot] c0f472603f Queue 8 game(s) for ingest [admin]
Via the admin page.

https://belsgames.itch.io/parasomnia-no-rem
https://furkanfs.itch.io/atom-by-atom
https://minari-kr.itch.io/zzuk-zzuk-nyang
https://moranthug.itch.io/ttfe
https://oribiyo.itch.io/omanekokunmofukkin
https://shibaki-dev.itch.io/ninefold
https://spacelizardgames.itch.io/gamblin-geezers
https://spiritusmaximus.itch.io/archeology-idle-prototype
2026-09-30 08:27:07 +00:00
github-actions[bot] 38e2eeb474 Refresh catalog [2026-09-30] 2026-09-30 03:30:12 +00:00
github-actions[bot] c643a8ce23 Ingest queued games [2026-09-30] 2026-09-30 02:35:54 +00:00
freeitchgames-admin[bot] 7dbccfd928 Queue 22 game(s) for ingest [admin]
Via the admin page.

https://ga-games.itch.io/traks
https://justinbritch.itch.io/deephaul-idle-fishing
https://lost-rabbit-digital.itch.io/xerophobia
https://orvexion.itch.io/the-black-box-prototype
https://pepper2.itch.io/be-a-pro
https://postmarked.itch.io/postmarked
https://tommusrhodus.itch.io/legally-distinct-planetary-based-suika-game-clone-for-playdate
https://amaty.itch.io/a-mirrors-curse-sfw
https://featurekreep.itch.io/baphomet
https://porohart12.itch.io/data-center-tycoon
https://zyn505.itch.io/pixie-game-prototype-thing
https://andrealphus.itch.io/that-time-i-got-reincarnated-as-a-barbarian
https://ayaah.itch.io/clean-page
https://azurextwilight.itch.io/praise-be-evangeline
https://c-hizzle.itch.io/headspace
https://cabindraws.itch.io/10-seconds-to-die
https://helloworld261.itch.io/cursed
https://kapei.itch.io/eclipse-child
https://narathin.itch.io/starlancers
https://raveglitch.itch.io/izzy-and-dizzys-forest-day-busy
https://theironwill1014.itch.io/the-roche-limit
https://urban1098.itch.io/healthy-family-simulator
2026-09-30 02:33:16 +00:00
github-actions[bot] 31a9a260fd Ingest queued games [2026-09-30] 2026-09-30 01:49:54 +00:00
poli0981andClaude Opus 5.5 cb12c0c326 Move contact addresses to @poli0981.dev, bump to 4.1.1 (#99)
- contact@ / legal@ / privacy@ / security@ / takedown@poli0981.dev
  (Google Workspace aliases) replace the @freeitchgames.win addresses in
  the policies (EN + VI), READMEs, issue templates, security.txt and the
  installer EULA.
- Privacy Policy: Google Workspace replaces Cloudflare Email Routing as
  the email processor (provider table, transfers, contact section).
- About page: website, contact email and the poli0981.dev/links hub;
  mailto: links open without a blank tab; the apps may open mailto:.
- LEGAL_VERSION 2026-09-29, so the legal gate asks once more.
- Version 4.1.1 (about.ts, package.json, tauri.conf.json, Cargo.toml/lock).

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 23:12:08 +07:00
freeitchgames-admin[bot] e93467ffcc Queue 36 game(s) for ingest [admin]
Via the admin page.

https://chilkus.itch.io/marble-marvell
https://critchlowr.itch.io/you-i
https://csaf.itch.io/coppice
https://stingergames.itch.io/house-always-wins
https://turtlevaniagames.itch.io/penguin-planet
https://choicegaming.itch.io/wick-and-tide
https://csaf.itch.io/gasholder
https://csaf.itch.io/theodolite
https://emberforgedstudios.itch.io/defenders-of-cinderkeep-demo
https://indie-ian.itch.io/peg-defense-force
https://jedimeisterx.itch.io/lifeseed
https://keqh.itch.io/tumblestorm
https://mors-games.itch.io/sploob
https://punkcake.itch.io/spaghetti-celesti
https://acro-projects.itch.io/date-night
https://gunterjr.itch.io/waterfall
https://haruka-apps-games.itch.io/komahime-stella
https://ikemakesgames1.itch.io/glaggles-playhouse
https://invisiblemilk.itch.io/your-new-roommate
https://jomoby.itch.io/dv
https://pavelbjorn.itch.io/brownwaters
https://ronhelleredfn-boop.itch.io/bb-blackwood
https://tiramisiu.itch.io/thinkingaboutyou
https://toro-comicss.itch.io/emergency-monster-team-chapter-0
https://yarheeguy.itch.io/immolate
https://astaysdev.itch.io/vestige
https://bboy6720.itch.io/cosmic-forge
https://dredlam.itch.io/arson
https://momentmori.itch.io/summer-yet-young
https://raxeris.itch.io/99
https://raxeris.itch.io/dig-to-australia
https://shinh.itch.io/enter-the-nyangeon
https://unoyado.itch.io/hoshitachi-no-ouchi
https://dragonrider1223.itch.io/rooted
https://peatstack.itch.io/clach
https://transmutrix.itch.io/priiism
2026-09-29 11:21:40 +00:00
github-actions[bot] e3cc83ffc1 Refresh catalog [2026-09-29] 2026-09-29 03:26:31 +00:00
github-actions[bot] 96c0c4497c Refresh catalog [2026-09-28] 2026-09-28 09:27:22 +00:00
github-actions[bot] e5de698ee0 Ingest queued games [2026-09-28] 2026-09-28 06:00:16 +00:00
github-actions[bot] aae3af6160 Ingest queued games [2026-09-28] 2026-09-28 05:58:55 +00:00
freeitchgames-admin[bot] 2e01ceeab2 Queue 20 game(s) for ingest [admin]
Via the admin page.

https://cyber-enka.itch.io/kobugin
https://lockedon.itch.io/nightmare-neighborhood
https://mirmir-squad.itch.io/sesja-poprawkowa
https://pepolon2.itch.io/win-her-over-with-curry
https://pikon.itch.io/spiritbound
https://theswisshui.itch.io/who-the-hell-is-gustavo
https://warasibe1192.itch.io/test
https://beautales.itch.io/tcof
https://lighttriadgames.itch.io/break-the-pinatas
https://mauricioghy.itch.io/minecraft-caverns
https://ryan4237.itch.io/dont-panic-defend
https://sovium.itch.io/the-garden-of-wonders
https://xlaucifer.itch.io/remember
https://giii3-game.itch.io/tscave
https://giii3-game.itch.io/tscaveen
https://kukitothecoloredclover.itch.io/menos3-reupload-phases-1-3-android-port
https://lauiss.itch.io/chad-aura-farmer
https://ryanwlow.itch.io/endosymbiont
https://sheetterror.itch.io/nation-towers
https://yotogi-chan.itch.io/yuzu-othello
2026-09-28 05:58:47 +00:00
freeitchgames-admin[bot] e958e8d408 Queue 1 game(s) for ingest [admin]
Via the admin page.

https://mor10th.itch.io/stop-at-the-gas-station
2026-09-28 05:58:36 +00:00
github-actions[bot] 3eb404f504 Ingest queued games [2026-09-27] 2026-09-27 15:41:25 +00:00
freeitchgames-admin[bot] 1e69972093 Queue 19 game(s) for ingest [admin]
Via the admin page.

https://adolf-reborn-dev.itch.io/nishanus-qwinnis-simulator
https://alysssssssssa.itch.io/area415
https://gaja-studios.itch.io/cute-cats-project
https://perrystopguy.itch.io/perry-beats-the-allegations
https://wonye-0204.itch.io/yulru
https://darko-dev.itch.io/runeterra-furry-romance
https://fantastimaker.itch.io/exospace-combat-engineer
https://luquitasdev.itch.io/packsmith
https://ronnafemto.itch.io/recipe-frenzy
https://the-blue-hatted.itch.io/fnaftheflipside
https://3005jin.itch.io/sweet-instincts
https://arvantus.itch.io/astra-inani
https://felixintheclouds.itch.io/one-pizza-for-the-detective
https://goblinpassword.itch.io/record-of-the-end-of-one-corner-of-the-world
https://longfatchin.itch.io/late-night-shift-hhehe
https://lycheeluc.itch.io/stay-with-me
https://nyurun.itch.io/what-my-salary-is-too-low-a-healers-tale-from-the-frontier
https://tacomedia.itch.io/miku-summers-end
https://visual-novel-world.itch.io/never-ending-summer-halloween
2026-09-27 15:40:12 +00:00
github-actions[bot] d493e78a22 Refresh catalog [2026-09-27] 2026-09-27 09:03:55 +00:00
github-actions[bot] bae56210e2 Ingest queued games [2026-09-27] 2026-09-27 03:04:14 +00:00
freeitchgames-admin[bot] 0826b62d12 Queue 50 game(s) for ingest [admin]
Via the admin page.

https://bigblue9988.itch.io/jm-grain-carts
https://darkfairyrune.itch.io/x-yze
https://dhelangan.itch.io/ragsofracs
https://realqzeq.itch.io/skimbaquest
https://sebastianscaini.itch.io/the-junkyard
https://soyukke.itch.io/maru-kaite-dokan
https://spoiledsweet.itch.io/the-second-sight-book-2-the-devil-and-the-wheel
https://wandcom.itch.io/to-be-real
https://wizorge.itch.io/wender
https://xiaonur.itch.io/amoris
https://flames-cool-games.itch.io/robot-wants-kitty
https://icely.itch.io/icelys-arrows-puzzle
https://mametter.itch.io/12-puzzle
https://mnp-sorn.itch.io/mise-en-place
https://ruderalis.itch.io/skate-and-die
https://sasbyxan.itch.io/farm-factory-demo
https://sparky-studio.itch.io/kidnappedplus
https://tayl1r.itch.io/marisas-star-stacker
https://yummypotato99.itch.io/doodle-towers
https://briquettte.itch.io/convallaria
https://flynn974.itch.io/god-of-the-sun
https://hypnoscape.itch.io/the-helpline
https://asarinnovations.itch.io/honeyvale-idle-farm-tycoon
https://codlyo.itch.io/long-way-round
https://melongungames.itch.io/shutter-chance-push
https://thewindyproject.itch.io/bleach-and-blood
https://b2sbd.itch.io/blessed-be-the-rubble
https://furryareospaceengr.itch.io/atoe
https://fusariumxc.itch.io/highschool-darlings
https://goddess-of-gales.itch.io/two-reapers
https://hellwimp.itch.io/red-halo
https://indooranimal.itch.io/wrenny-lee-1-demo
https://irradon.itch.io/the-burden-of-ill-minds
https://lunikadev.itch.io/the-spell-incident
https://majcirock.itch.io/testing-the-intelligence
https://mochicat0w0.itch.io/gintama3xxx
https://mondlichtgames.itch.io/ex-wife-demon-hunter
https://mookichuu.itch.io/save-me-a-slice
https://nyxchasm.itch.io/awakened-the-ak-project-day-1-demo
https://orribu.itch.io/phantom-of-the-opera-spooktober2026
https://realtayediggs.itch.io/apollo
https://rvip-games.itch.io/blending-our-shades
https://umigamestudios.itch.io/highschool-j
https://wuhan419.itch.io/path-to-power
https://alejandroir.itch.io/meadowcomb
https://bubfizgames.itch.io/terminal-depth
https://gupyung.itch.io/make-chukmagal-great-again
https://jeff3659.itch.io/inflation-streamer-simulator
https://vitaminsizdev.itch.io/purrfect-survivor
https://yaxworks.itch.io/game-about-botting-in-an-mmorpg
2026-09-27 03:00:46 +00:00
github-actions[bot] c94f161b20 Refresh catalog [2026-09-26] 2026-09-26 08:29:16 +00:00
github-actions[bot] aab0716d7c Ingest queued games [2026-09-25] 2026-09-25 20:50:44 +00:00
freeitchgames-admin[bot] a742653f4c Queue 28 game(s) for ingest [admin]
Via the admin page.

https://eggonomicon.itch.io/shakedown-troll
https://moonbunsgames.itch.io/seabun
https://zaapp-games.itch.io/spirit-reaper
https://doksa.itch.io/at-my-command
https://ineedanappdev.itch.io/toxic-devotion
https://kozadev.itch.io/benvo
https://lotiion.itch.io/strawberry-season-demo
https://mimu2026.itch.io/empty-box
https://themoongoblin.itch.io/the-blood-booth
https://wren-lapis.itch.io/before-after-you
https://poprise.itch.io/poprise
https://wolviza.itch.io/ineto
https://lucabicono.itch.io/entangled-game
https://zep.itch.io/digable-planetoids
https://bananamanchik.itch.io/the-pancake-tower
https://beyondsingularityproject.itch.io/the-turing-choice
https://calobright.itch.io/the-sacking-of-gruntrib-monastery
https://cringebear.itch.io/outlined-by-a-scythe
https://ecyanic.itch.io/interview-with-a-demon
https://geistworld.itch.io/lupa-rossi-redux
https://jiyumirai.itch.io/bochibochi-kansai-civilization
https://murigames.itch.io/bones-of-nu-voledo
https://rodmcx.itch.io/hailanr
https://singularity-s.itch.io/overnight-in-the-cursed-house-do-not-enter
https://tropicpanic.itch.io/eerriedearies
https://hakman-dev.itch.io/robot-rivals
https://peatstack.itch.io/the-wee-pier
https://zapakitul.itch.io/night-cart-the-immortal-plague
2026-09-25 20:48:49 +00:00
github-actions[bot] ab2da473c4 Refresh catalog [2026-09-25] 2026-09-25 08:39:41 +00:00
github-actions[bot] 35a6404720 Ingest queued games [2026-09-24] 2026-09-24 13:39:30 +00:00
freeitchgames-admin[bot] bb1f26d6c3 Queue 41 game(s) for ingest [admin]
Via the admin page.

https://16bitnights.itch.io/terraformer-wars
https://dreamfeel.itch.io/a-dream
https://howdyriceball.itch.io/polar-peril
https://kiv7u.itch.io/the-prey-who-prayed
https://managore.itch.io/throrbs
https://tenshistudios.itch.io/hostage-heart
https://vsjnk.itch.io/vsinks-full-body-tracking-for-vrchat
https://arbitrrrary.itch.io/glass-jaw
https://bekk3r.itch.io/purple-shift
https://coren-baili.itch.io/six-rules-the-visual-novel
https://finn25.itch.io/you-arent-really-there
https://littlest-lily.itch.io/snowflakes-in-the-sun
https://mor10th.itch.io/stop-at-the-gas-station
https://projectfrallen.itch.io/dtw
https://sulfuroo.itch.io/the-clinical-act
https://valorzard.itch.io/spooktober-2026
https://withered-soul.itch.io/zombi
https://hiddenstagegames.itch.io/lumberboy
https://merouses.itch.io/turninto-park
https://poghes.itch.io/fill-that-pig
https://soyukke.itch.io/trolley-problem-is-not-problem
https://alexdadaev.itch.io/betweenstops
https://bestwaifu1412.itch.io/gensou-gakuen
https://boniheartmakesgames.itch.io/i-have-a-balloon
https://cierith.itch.io/our-first-date
https://epiphyll0m.itch.io/piracentile
https://eris-merrit.itch.io/the-girl-who-cant-be-haunted
https://irondumpling.itch.io/gauleiters-bakery
https://joerenwick.itch.io/girl-scarecrow
https://kaekolormore.itch.io/fooles-world
https://lekastudios.itch.io/eo21
https://lunabloomgames.itch.io/himekishi
https://nickkkkkkkkkkkk.itch.io/sad-mika
https://noah-ma.itch.io/just-another-day-at-the-office
https://only-family-indie-studio.itch.io/crime-world-the-demises-of-the-policewoman
https://rac104888-png.itch.io/entertainment-sim
https://ratgirlofnorthamerica.itch.io/speed-dating-for-clowns
https://tem231.itch.io/everlastingstream
https://viewsengineer.itch.io/a-hundred-misdeeds
https://borick.itch.io/emberwatch
https://csaf.itch.io/clerestory
2026-09-24 13:36:40 +00:00
poli0981 08dd4b6172 Merge pull request #91: v4.1.0 — verification gate, readable chart tooltips, changelog split [skip-discuss]
Release 4.1.0: Turnstile verification gate (inert until its secrets exist), readable chart tooltips, changelog split into changelog/, legal and docs refresh.
2026-09-24 18:22:02 +07:00
poli0981andClaude Opus 5.5 e73c2ee985 chore(release): 4.1.0
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-24 18:07:38 +07:00
poli0981andClaude Opus 5.5 7b73db9697 docs: bring the runbook, READMEs and notes up to date
- operations.md: verification gate setup (bot token, Transform Rule,
  header check, GATE_SECRET last, smoke tests, off switch); Web Analytics
  is injected by the zone (checked live), not a build token; staging is
  deployed by hand from any branch; a release checklist replaces the
  finished v4 release order; the unused repo secrets can go.
- CLAUDE.md: gate, chart and changelog notes, three new gotchas, current
  counts, .rpm, announce-discussion.yml is local, current state.
- READMEs (EN/VI): the quick check, list layout on phones, .rpm,
  TanStack Query only, the build monitor, cf_build_status.sh.
- dev_env (EN/VI): GATE_* secrets, PKCS#1 keys work as downloaded.
- webapp/README, TAURI.md, THIRD_PARTY.md, CONTRIBUTING (EN/VI): lazy
  routes, .rpm, Cargo.lock is committed, squash or merge commit.
- _headers: caching for favicon.svg and the web manifest; comments.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-24 18:06:21 +07:00
poli0981andClaude Opus 5.5 251369ede6 docs(changelog): one file per minor version under changelog/
CHANGELOG.md had grown to 805 lines across four major versions. The
notes now live in changelog/<major>.x/ver<major>.<minor>.x.md (newest
first); CHANGELOG.md is the index. Each index row keeps the anchor of the
old single-file heading, so the release notes that link to
CHANGELOG.md#<entry> still land on the right row.

- Entries moved verbatim; repo-relative links rebased (../../), links to
  files deleted since are pinned to the release's tag.
- Dated 1.0.2 and 1.0.3 (both released 2026-01-01); short entries that
  point to the GitHub release for 3.0.1, 3.1.0 and 3.1.1, which never
  had one; the "gotcha #18" reference now names the gotcha instead.
- 4.1.0 notes added.
- announce-discussion.yml also watches changelog/**.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-24 18:01:52 +07:00
poli0981andClaude Opus 5.5 fdf0645829 docs(legal): verification cookie and Turnstile check in the policies
The Privacy Policy said the Project's code sets no cookies and that
Turnstile runs only on the Suggest page. With the verification gate:

- Privacy (EN/VI): the Turnstile check before the site loads (about once
  per 48 hours, verified bots exempt, /data open), the __Host-fig_gate
  cookie (issue time + signature, 48 h, strictly necessary), the
  webapp.gate storage entry, retention, Cloudflare's role.
- ToS (EN/VI): don't circumvent the verification check or share its cookie.
- EULA (EN/VI/RTF): list the .rpm package v4.0.0 already shipped.
- LEGAL_VERSION and the About page date → 2026-09-24, so the legal gate
  asks everyone once more.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-24 17:58:35 +07:00
poli0981andClaude Opus 5.5 2c2d990f33 feat(worker): Turnstile verification gate for the web app
Until a visitor passes a Cloudflare Turnstile check, app pages ("/" is
now Worker-first too) answer with a self-contained verification page and
/img covers with 403, so a browser loads nothing of the site before the
check. Passing sets an HttpOnly, host-only cookie (HMAC of its issue
time) good for BOT_GATE_TTL_HOURS (48). The page then reloads into the
link that was asked for, and the legal gate follows as before.

- /assets, /data (desktop/Android apps, CC BY reuse), robots, sitemap,
  og image, /api/* and /admin* stay ungated.
- Verified bots pass with the token a zone Transform Rule adds
  (x-fig-known-bot); clients that only claim to be a search crawler get
  a 503, never the noindex page.
- Fails open: it needs BOT_GATE="on", the Turnstile keys, GATE_SECRET
  and GATE_BOT_TOKEN; deleting GATE_SECRET switches it off at once.
- POST /api/verify: same-origin, RL_GATE (IPv4 / IPv6 /64), siteverify
  with action "gate". GET reports the pass for the page and the SPA.
- turnstile.ts: siteverify shared with Suggest, which now also checks
  the hostname and action (a token from one page can't be spent on the
  other) and answers 503 when Turnstile is unreachable.
- SPA: a tab whose pass ran out re-checks when shown again or when a
  cover fails, and reloads into the verification page.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-24 17:56:33 +07:00
poli0981andClaude Opus 5.5 3ce23dec17 fix(charts): readable hover tooltips and cursor
The chart colours wrapped the hex design tokens in hsl() ("hsl(#efefec)"),
an invalid colour: SVG painted the bar hover band black and the tooltip
lost its background and border. Recharts 3 also focuses the chart on a
mouse click, so Chromium drew its focus ring and pinned the tooltip on
the first item.

- chart-theme.ts: shared Tooltip props and cursors using var(--x).
- chart-tooltip.tsx: one tooltip body for every chart (popover colours,
  series swatch, locale-formatted numbers, share of the whole on the
  pies that cover it, formatted dates on the count chart).
- Translated series names instead of the raw dataKey ("count").
- Pie seams and treemap cells use the card/background tokens.
- Clicks no longer move focus into a chart; keyboard focus keeps the
  --ring outline.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-24 17:43:43 +07:00
github-actions[bot] 41471e7317 Refresh catalog [2026-09-24] 2026-09-24 08:18:17 +00:00
github-actions[bot] 2591f2a7b3 Ingest queued games [2026-09-23] 2026-09-23 10:41:25 +00:00
freeitchgames-admin[bot] 6b9632c76e Queue 13 game(s) for ingest [admin]
Via the admin page.

https://deepblizzard.itch.io/squeeze-maker
https://feli202.itch.io/theorem
https://kronfeld.itch.io/road-to-glory
https://sproutforge.itch.io/one-more-pack
https://cricketsounds.itch.io/orren-skoleraxi
https://esgeetha5.itch.io/enter-furry-world
https://hellotomyfriends3.itch.io/phallic-shaped-balloons
https://johntitortheprog.itch.io/visual-novel-web
https://kanagarajv021.itch.io/endless-labyrinth-of-night-roads
https://themoongoblin.itch.io/dagon
https://velvetrayleigh.itch.io/broken-mirrors-and-roses
https://apoped.itch.io/necropolis-rise-of-the-undying
https://csaf.itch.io/swelter
2026-09-23 10:40:21 +00:00
github-actions[bot] 1359e24332 Refresh catalog [2026-09-23] 2026-09-23 08:27:01 +00:00
github-actions[bot] 766f634aba Ingest queued games [2026-09-22] 2026-09-22 16:49:54 +00:00
freeitchgames-admin[bot] ded560e7ca Queue 3 game(s) for ingest [admin]
Via the admin page.

https://polyakovin.itch.io/locksmith
https://psychosage.itch.io/the-rooftop-driver
https://pufferfishman202.itch.io/drake-platfomer
2026-09-22 16:49:28 +00:00
github-actions[bot] 677994abe3 Ingest queued games [2026-09-22] 2026-09-22 08:52:17 +00:00
freeitchgames-admin[bot] 2607ff4041 Queue 41 game(s) for ingest [admin]
Via the admin page.

https://11ee.itch.io/nudge
https://amstrad-esp.itch.io/el-linaje-real-amstrad-cpc
https://berzee.itch.io/sir-tiles-solves-a-problem
https://bil2.itch.io/dead-check-private-page
https://m4rvin.itch.io/biolab-disaster-playdateport
https://rarelikeaunicorn.itch.io/eyeroboros
https://91nuggets.itch.io/abandonware
https://dungeonsweeper.itch.io/the-detective
https://emergencypie314.itch.io/spooktober2026
https://rayhimmel.itch.io/thnb
https://crownintheclouds.itch.io/crown-in-the-clouds
https://southlondonsilicon.itch.io/multi-modal
https://boreholedd.itch.io/hellzon
https://cgcfss.itch.io/your-complaint-has-been-received-demo
https://imjujubells.itch.io/for-our-forgotten-memories
https://nerdofalltrades505.itch.io/the-headless-horseman-wants-a-date
https://rosewoodstudios.itch.io/sugar-veins
https://shinkenzero.itch.io/the-last-resort
https://bitbybitoriginal.itch.io/slice-of-fortune
https://farelas.itch.io/the-crimson-hunt
https://fourquarters.itch.io/how-to-crab-to-zero
https://hempuli.itch.io/aftermount
https://jackoatley.itch.io/pirates-curse
https://kiv7u.itch.io/it-reeks-of-spring
https://leafthief.itch.io/crisscrosscove
https://leonncamayo.itch.io/failrooms
https://natthrafn.itch.io/blocknbubble
https://polilabs.itch.io/scrap-empire
https://r-goulart.itch.io/century-runner
https://seraphbin.itch.io/i-cannot-leave-my-car-because-i-am-anxious
https://sitrex.itch.io/eat-not-want-not
https://snowyrey.itch.io/fnaf-daybreak
https://spoiledsweet.itch.io/favored
https://tenshistudios.itch.io/the-community-notes-are-wrong
https://d3emo.itch.io/the-devil-wants-to-retire
https://grimgamez.itch.io/the-last-light
https://karisbunny.itch.io/ghowly
https://maricore.itch.io/pearls-of-foam
https://missacocina.itch.io/lost-toys
https://ps-studio.itch.io/dinner-date
https://surrtasm.itch.io/sundry-heart
2026-09-22 08:49:17 +00:00
github-actions[bot] 5955b0a5ae Refresh catalog [2026-09-22] 2026-09-22 08:25:43 +00:00
github-actions[bot] 86e752541d Ingest queued games [2026-09-21] 2026-09-21 12:22:47 +00:00
freeitchgames-admin[bot] 8eb8b9c293 Queue 3 game(s) for ingest [admin]
Via the admin page.

https://devarbe.itch.io/idle-laps
https://sundercroft.itch.io/envoy-the-kings-gambit
https://tonyeatwell.itch.io/eatwell-university
2026-09-21 12:22:29 +00:00
github-actions[bot] ffbbf472eb Refresh catalog [2026-09-21] 2026-09-21 08:41:06 +00:00
github-actions[bot] e8cb54c96f Ingest queued games [2026-09-21] 2026-09-21 05:31:06 +00:00
freeitchgames-admin[bot] bffb4c420c Queue 9 game(s) for ingest [admin]
Via the admin page.

https://allien-m.itch.io/sector-zero
https://asdfgi.itch.io/mile-14
https://elinzeiart-z.itch.io/salvation-of-the-righteous
https://gordlet.itch.io/dont-yield-to-love
https://n8ptune.itch.io/playlet-derailed
https://nathannofunny.itch.io/areyousureisthisvisualnovel
https://ni-ko-mi.itch.io/my-dear-angel
https://sicki-games.itch.io/a-long-night
https://thebuncult.itch.io/ipsopacto
2026-09-21 05:30:23 +00:00
github-actions[bot] 05a908017b Ingest queued games [2026-09-21] 2026-09-21 03:45:47 +00:00
freeitchgames-admin[bot] efca5dda92 Queue 3 game(s) for ingest [admin]
Via the admin page.

https://arko-poet.itch.io/incremental-dwarf
https://chuteapps.itch.io/comrade-secrets-escape
https://youngpotato.itch.io/ascension-fracture
2026-09-21 03:45:25 +00:00
github-actions[bot] 7fda98b8e1 Ingest queued games [2026-09-20] 2026-09-20 14:25:41 +00:00
freeitchgames-admin[bot] d6cb2e5e04 Queue 3 game(s) for ingest [admin]
Via the admin page.

https://banapple1.itch.io/stray-cookie
https://cosmonomicon.itch.io/wwi-surgeon-simulator
https://rose-likeoficial.itch.io/roses-adventures-ninah-no-im-not-a-humanoid
2026-09-20 14:25:15 +00:00
github-actions[bot] 0fc346aaa2 Ingest queued games [2026-09-20] 2026-09-20 08:49:06 +00:00
freeitchgames-admin[bot] 4a78e24904 Queue 89 game(s) for ingest [admin]
Via the admin page.

https://gamedoggame.itch.io/swamptender
https://red-anarhy173.itch.io/sprunki-hypershifted-peppers-take
https://whonosestudios.itch.io/log-drop
https://angelprism.itch.io/total-metamorphosis
https://kay-n.itch.io/dead-band
https://rin-fla.itch.io/requiem-of-an-edginess
https://sardineoil.itch.io/do-you-want-to-pick-up
https://uraalice.itch.io/blue-hum
https://whimsival.itch.io/stasis
https://logicalbyte.itch.io/connect
https://clumsy-bear-studio.itch.io/hungry-horrors
https://leafo.itch.io/rock-declutterer
https://vitaminsizdev.itch.io/ragdollsuperfunbanana2
https://archieclark.itch.io/prison-break
https://daiigle.itch.io/crystal
https://qixya.itch.io/3-seconds-day-4
https://scribertron.itch.io/the-owl-house-the-chronicles-of-sir-william
https://stenfabriken.itch.io/lost-again
https://manasource.itch.io/source-of-mana
https://musingxer.itch.io/muxing-school
https://ashstickyrice.itch.io/d3v0ur
https://bigshu.itch.io/ship
https://blobblosaurus.itch.io/furry
https://chandhira2604.itch.io/sun-stars
https://david-the-coolest.itch.io/my-miko
https://dhamas-tri.itch.io/my-hearts-dribbler
https://doksa.itch.io/bounty-or-booty
https://elseth.itch.io/recurse
https://eyelessx.itch.io/it-waits-in-white
https://flexxit.itch.io/flexxit-life
https://kiiihiru.itch.io/a-crossed-path
https://kiiihiru.itch.io/prskfg-a-blank-world
https://merlotrose.itch.io/blue-archive-rpg-unholy-trinity
https://phighting-feelings.itch.io/phighting-feelings
https://phighting-feelings.itch.io/web
https://purpleparsnip.itch.io/the-straight-jacket
https://recursos-liit.itch.io/ada
https://sekarsarasu1981.itch.io/my-raising-diary
https://shogunyaru.itch.io/the-perfect-piece
https://skywritestudios.itch.io/only-one-bed-at-the-inn
https://solarautomata.itch.io/oblivion2666demo
https://songofme.itch.io/my-mirror-image
https://sreejithnm78.itch.io/unquiet-grey
https://svenchen.itch.io/unexpectedly-yours
https://t2t3t7t4.itch.io/are-you-really-going-to-go
https://takexin.itch.io/parabellum
https://thetidepool.itch.io/to-break-the-wheel
https://unwontedstudios.itch.io/written-in-the-sky
https://bulhwa.itch.io/channel-453
https://coolom-games.itch.io/dating-killmulator-2
https://foxtailtale.itch.io/the-forgotten-island-safe-for-work-edition
https://megacatstudios.itch.io/reknum
https://yaru.itch.io/burgertale
https://16bitnights.itch.io/chromosomeevil2
https://abigdinosaur.itch.io/green-lamp-co
https://alexsloth.itch.io/zombie-tower-survivor
https://askgames.itch.io/no-return-address-demo
https://boolonx.itch.io/gtah
https://clark-padmore.itch.io/logic-bulb-adventure
https://countlessbathory.itch.io/autumns-end
https://cyanidetimegames.itch.io/silly-cat
https://digitarium.itch.io/lockpicks-11
https://disagreeg.itch.io/earth-regen
https://doksa.itch.io/amber-eyes
https://doppie.itch.io/eulogy
https://eggnog.itch.io/rocket-to-the-top
https://emika-games.itch.io/absolutely-nothing-good
https://fleischgemuese.itch.io/fizz-extended
https://funday-games.itch.io/booster-pack-heroes
https://inkbox-software.itch.io/zerostar
https://inkycosmos.itch.io/luvparade
https://joelj.itch.io/fall-from-space
https://julian-launches.itch.io/deep-digger
https://kawpum.itch.io/family-business
https://kingmidis.itch.io/vvrr
https://liminalroad.itch.io/spooky-tales
https://megurte.itch.io/outblight
https://milopanta.itch.io/king-in-the-mountain
https://puato.itch.io/dead-space-nokia
https://punkcake.itch.io/snake-digits
https://retrosouls.itch.io/piglyflag
https://skidaddledev.itch.io/gridbound
https://sleeping-robot-games.itch.io/mini-me-mao
https://spiderzone.itch.io/procuring-estrogen-for-your-toxic-slime-girlfriend
https://st1sdan.itch.io/elfware
https://stevehiggins.itch.io/amiga-rescue
https://unfall-games.itch.io/the-delivery-guy
https://vadeum.itch.io/legendum
https://vnstudioelan.itch.io/my-vtuber-rival-is-actually-cute
2026-09-20 08:42:58 +00:00
poli0981andClaude Opus 5 066f368b53 fix(worker): accept the GitHub App key as downloaded (PKCS#1)
Approving from the queue failed with 500 "internal_error"; the Worker log
said: TypeError: "pkcs8" must be PKCS#8 formatted string. GitHub downloads
App keys as PKCS#1, which WebCrypto cannot import.

- github.ts wraps a PKCS#1 PEM into PKCS#8 itself (and turns two-character
  "
" escapes into newlines), so the downloaded key works unchanged.
- GitHub failures throw GitHubError and the admin API answers 502
  github_error with the reason, instead of a bare internal error.
- Admin CSP allows the Cloudflare beacon the zone injects into every HTML
  response; dropped browsing-topics from Permissions-Policy (Chrome no
  longer knows the feature and logs an error on every page).
- Docs: the key needs no openssl conversion any more.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-20 15:38:05 +07:00
github-actions[bot] ddcaa25df5 Refresh catalog [2026-09-20] 2026-09-20 08:23:07 +00:00
github-actions[bot] 0ece4c3805 Refresh catalog [2026-09-19] 2026-09-19 07:59:38 +00:00
poli0981andClaude Opus 5 00b517e069 docs(changelog): date the 4.0.0 release [skip-discuss]
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-18 22:19:56 +07:00
poli0981andClaude Opus 5 e4a5ee532d fix(worker): keep the dashboard settings in wrangler.jsonc; Access fixes
- wrangler.jsonc vars now hold the production values set in the dashboard
  (GitHub App ids, Access team domain and AUD tags, Turnstile site key).
  A deploy replaces plain-text variables with the file's values, so the
  next data commit would have blanked them.
- access.ts: ignore a trailing slash in ACCESS_TEAM_DOMAIN (the issuer is
  the bare origin; the dashboard value had one).
- /admin redirects to /admin/ (the path the Access application covers), so
  the visitor gets the login page instead of a 403.
- Runbook: values must be changed in the file.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-18 22:18:37 +07:00
poli0981andClaude Opus 5 951aaff823 docs(claude): v4 is live — record go-live state and open setup
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-18 21:31:24 +07:00
poli0981 a87264456c Merge v4: Cloudflare Worker site, review queue and redesign (#88)
v4.0.0: Cloudflare Worker site, review queue and redesign (go-live)
2026-09-18 21:23:46 +07:00
poli0981andClaude Opus 5 902384ea2f feat(web): v4 redesign — top nav, Welcome page, URL-synced filters (v4 Phase 3)
Implements the approved mockup (Free Itch Games, dark and light).

- Tailwind CSS 4 via @tailwindcss/vite (no PostCSS / tailwind.config), design
  tokens in src/index.css, tw-animate-css, self-hosted Geist / Geist Mono.
- A sticky top nav (global search with the / shortcut, display menu for
  theme / language / density / 18+, phone sheet menu) and a footer replace the
  sidebar; the window scrolls, with scroll restoration on back / forward.
- Welcome page at / (catalog status, features, recently added) replaces the
  dashboard.
- Games: search, genre / platform / status / tags / language / input / engine,
  minimum rating, plays-in-browser, sort and page live in the URL
  (lib/game-filters.ts, unit-tested); facet counts ignore their own filter;
  a table on desktop, a list on phones, 100 per page. Counts show the whole
  catalog while 18+ games are hidden.
- New game detail page (breadcrumb back to the same list, facts, tags that
  open the matching list, copy link, report a problem), searchable Removed
  page, simpler Settings, restyled error pages and charts header.
- Legal gate is an overlay above the page (deep links land where they
  pointed), with translated document names; no "Leave" button in the apps.
- Cached data stays on screen when a background refresh fails (offline).
- Numbers and dates follow the language (lib/format.ts).
- New favicon, PWA icons and OG image from the same tokens
  (scripts/gen_assets.py uses the Geist fonts from node_modules).
- Removed: sidebar, dashboard, data-table components, TanStack Table /
  Virtual, sonner and toast settings, the unused Select primitive; 81 unused
  i18n keys; prefs now persist only the keys still in use.
- Review fixes: routers without startTransition (useSearchParams was stale,
  so quick filter clicks and typed searches overwrote each other or pulled
  the visitor back from a game); paging starts at the top and Back returns
  to the old position; the 18+ confirmation is an in-app dialog
  (window.confirm is a no-op in the macOS app); the apps show only the legal
  gate until it is accepted (covers load from itch.io there); breadcrumb goes
  back; named popovers, list semantics, IME-safe Enter, English plurals,
  pointer cursor, --brand-soft without color-mix, copy-link fallback.
- wrangler.jsonc: id of the production D1 database (created by command,
  0001_init applied); runbook notes that R2 must be enabled first.
- Docs: CLAUDE.md, CHANGELOG, webapp README / TAURI.md, THIRD_PARTY,
  ACKNOWLEDGEMENTS, docs/operations.md; Dependabot groups for Tailwind 4.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-18 21:21:14 +07:00
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
poli0981andClaude Opus 5 41a8f8461f fix: Phase 4 review findings (admin, ingest, suggest)
Worker
- The local DEV_ADMIN_EMAIL bypass keeps the same-origin check for
  writes, and JSON bodies must be exactly application/json (a cross-site
  `text/plain; application/json` POST no longer gets through without a
  preflight).
- Request bodies are capped while they stream (a chunked upload without
  Content-Length is never buffered past 4 KB / 64 KB).
- count_history.json is rewritten when today's row already exists
  (upsertCountHistory no longer mutates the rows it was given).
- A game that entered the catalog through the queue, was removed and turns
  up again is reviewed again (flagged previously removed) instead of being
  blocked as "already pending" for good.
- Restoring / approving a removed game no longer deletes its public
  removal record up front: the Worker allow-lists it in
  scripts/state/unblocked.json, update_info.py scrapes it despite the
  deleted log, and apply_patch.py drops the log entry only when the game is
  really re-added (a still-paid or dead game keeps its record).

Admin app
- The editor compares against what the repository holds (published data
  or what was saved in this session), so saved changes can be reverted and
  are never dropped silently.
- An Access session that expires mid-session shows a sign-in banner from
  any request, without losing what is on the page.
- Restore refreshes the queue; knip now checks the admin entry.

Suggest page
- The form doesn't let the browser's URL check block links without
  https:// (the page and the server accept them).
- A failed config request shows an error with Retry instead of a
  permanently disabled form or a false "closed" message.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-18 17:55:02 +07:00
poli0981andClaude Opus 5 369de32c2b feat(web): Cloudflare Web Analytics beacon from a build variable
The cookieless beacon is added to the public page only when the web build
has VITE_CF_BEACON_TOKEN (Workers Builds variable; manual site setup with
automatic injection off), never to the admin page or the Tauri apps. The
site CSP already allows it.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-18 17:55:02 +07:00
poli0981andClaude Opus 5 6f8b9ed490 feat(web): 18+ games hidden by default, /removed, version 4.0.0
- Games marked nsfw=Yes are left out of the table, dashboard and charts
  unless the visitor opts in (Settings -> Content, after confirming they
  are 18+; stored only in this browser). Their detail pages show a notice
  instead. The admin app still sees everything.
- /deleted is now /removed (301 from the Worker, redirect in the SPA,
  sitemap and canonical updated); <html lang> follows the language.
- Legal links: the gate lists only the documents being accepted (ToS,
  Privacy, Disclaimer, and the EULA inside the apps) and asks to confirm
  the visitor is 16+; new "Licenses & notice", "Data license" and
  "Content removal" links; the retired Telegram bot link is gone.
  LEGAL_VERSION 2026-09-18, so everyone is asked once more.
- Version 4.0.0 in about.ts, package.json (+ "license": "MIT"),
  tauri.conf.json (+ bundle copyright), Cargo.toml / Cargo.lock.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-18 17:55:02 +07:00
poli0981andClaude Opus 5 cbe3e389ea feat(web): admin app and public Suggest page (v4 Phase 4)
- webapp/admin/: a second Vite entry (/admin/, HashRouter), served only
  by the Worker after the Access check, with its own CSP. Review queue by
  status (approve, approve with override for previously removed games,
  reject), paste-to-add URLs, and a catalog editor for the three
  maintainer fields, removal with a public reason, and restore of removed
  games. Uses the published /data for search; every write is applied to
  the latest repository state by the Worker. An expired Access session
  surfaces as "sign in again" instead of a broken request.
- /suggest (web only; the desktop/Android apps link to the website):
  itch.io link + optional note (<= 500 characters, deleted after 180
  days), Cloudflare Turnstile loaded on demand, EN + VI strings.
- Local development: DEV_ADMIN_EMAIL in .dev.vars lets `wrangler dev` on
  localhost into the admin without Access; it is ignored on any other host.

Checked in wrangler dev with a local D1: queue listing, reject, approve
answering "GitHub App not configured", catalog search/editor, and a
Suggest submission (Turnstile test keys) landing in the queue; no CSP
violations.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-18 17:55:01 +07:00
poli0981andClaude Opus 5 8f121a8e9c feat(worker): review queue, admin API, ingest and suggest endpoints (v4 Phase 4)
Adds the server side of the admin and the automatic game discovery. The
catalog stays JSON in this repo; the Worker writes it as a GitHub App
(GraphQL createCommitOnBranch with expectedHeadOid: verified commits,
retried on a race) and keeps only the review queue in D1.

- worker/admin.ts: /api/admin/* (queue list, approve/reject, add, edit the
  three maintainer fields, remove with reason + R2 cover cleanup, restore)
  and the /admin shell with its own CSP. Every request re-verifies the
  Cloudflare Access JWT (aud + maintainer email + same-origin writes).
  Approving commits to scripts/temp_link.json, which starts update.yml.
  The maintainer's email goes to the D1 audit log only, never a commit.
- worker/ingest.ts: POST /api/ingest for the browser extension (Access
  service token, per-client rate limit, Idempotency-Key replay, <= 150
  items / 64 KB), replacing its PAT commits.
- worker/suggest.ts: public POST /api/suggest (same-origin, per-IP rate
  limit, Turnstile siteverify, canonical itch.io URL) into the queue.
- worker/discover.ts + scheduled(): every 4 h, one itch.io RSS feed
  (round-robin, 6 h back-off on 429) into the queue, then reconcile
  (queued -> ingested / failed) and retention (idempotency 7 d, form
  notes 180 d).
- worker/queue.ts: URL classification (catalog, pending, deleted,
  blocklist) and the D1 store; worker/repo.ts builds each admin commit
  from the files at the head of main, byte-compatible with the Python
  pipeline (golden fixtures).
- wrangler.jsonc: D1 (bound by name; migrations applied by hand), rate
  limits, cron, non-secret settings as vars (empty until setup: features
  answer 503 until configured), staging env without the cron.
  `npm run cf:types` ignores .dev.vars so the committed types are stable.
- Tests: 159 passing; the SQL runs against a real local D1 (workerd via
  wrangler's platform proxy).

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-18 17:55:01 +07:00
poli0981andClaude Opus 5 ce177d8f27 fix(web): review findings on the Worker platform (v4 Phase 2)
- Missing files no longer get the app shell: `not_found_handling: "none"`
  and worker/spa.ts answer /assets/*, /data/* and file-like misses with a
  real 404 (no-store). A stale hashed chunk used to get index.html with
  the year-long immutable cache of /assets/*. Routes get the shell with
  200; unknown paths and unknown game slugs get it with 404.
- Recharts is off the first load again (~314 -> ~195 KB gzip): drop the
  vendor-charts group, which captured React and clsx, and give
  vendor-react the top priority.
- Web build target restored (Safari/iOS 15.4): Vite 8's default shipped
  Radix class static blocks unlowered, a blank page on iOS 15.
- The allow-list cache shares only loaded values, never an in-flight
  promise: a cancelled first /img request hung every later one.
- /img answers upstream resets and R2 errors with a 502 instead of an
  uncaught exception, and releases unused upstream bodies.
- Per-route canonical + robots (useSeoHead) instead of a static root
  canonical and og:url on every page.
- Legacy hash redirect: crafted hashes (#//host, #/\host) go home
  instead of throwing before React mounts.
- Chunk-reload guard is time-windowed and storage-safe.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-18 17:55:01 +07:00
poli0981andClaude Opus 5 1910d61d08 feat(web)!: Cloudflare Worker platform, read-only app (v4 Phase 2)
BREAKING: the public web app has no sign-in anymore and uses real paths
(BrowserRouter); /add and /workflows are gone (admin comes in Phase 4).

Platform
- wrangler.jsonc: Worker (worker/index.ts) + static assets with SPA
  fallback; only /img/* and /api/* run the Worker. R2 binding THUMBS,
  `staging` env for the v4 pre-release Worker. worker-configuration.d.ts
  from `wrangler types` (checked in CI with --check).
- vite-plugins/catalog-data.ts bundles data_game + deleted log into
  dist/data (build fails on bad JSON / index mismatch), emits urls.json
  (thumbnail allow-list) and a real-path sitemap; version.json carries
  the build stamp so data-only rebuilds keep identical JS.
- Data is read same-origin from /data (Tauri: https://freeitchgames.win/data,
  CORS *); chunks load with allSettled.
- worker/img.ts: /img/<160|640>/<itch path> serves a WebP rendered once
  per image+width by Image Transformations and stored in R2 (edge cache
  → R2 → transform); catalog allow-list, fixed upstream host, hotlink
  block, streamed original on transform failure, 403/404 upstream → 404.
  15 vitest cases.
- Enforced CSP (same-origin + Web Analytics/Turnstile), cache headers for
  /assets, /data, og/icons; security.txt; robots disallows /api, /admin.

App
- Remove PAT/GPG sign-in, bulk edit/delete, undo, workflow dispatch,
  Octokit and OpenPGP (and ~220 write-path i18n keys); Settings keeps
  language/theme/density/notifications only.
- react-router 8 (unified package), React 19.3, TanStack/Recharts/etc.
  minors, Vite 8 rolldown codeSplitting groups; legacy #/ links are
  rewritten to paths; old PAT/GPG localStorage keys are cleared; reload
  once on vite:preloadError after a deploy.
- GameThumb uses the /img proxy (referrerPolicy no-referrer, N/A-safe).

Tauri
- Real CSP, drop the unused http plugin + capability, read-only
  descriptions, rust-version 1.88, drop the time pin, commit Cargo.lock.

Also: remove the GitHub Pages redirect workflow/stub (deployed by v4
Phase 0); add scripts/i18n-edit.mjs (TS-parser based key maintenance for
en.ts/vi.ts).

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-18 17:54:49 +07:00
poli0981andClaude Opus 5 e020be12fa feat(pipeline): rotating refresh + patch/apply pipeline, drop lists/ (v4 Phase 1) (#82)
* feat(pipeline): rotating refresh + patch/apply pipeline, drop lists/

Replace check_paid / check_alive / update_reviews / update_status: each
crawled all 2,600+ pages sequentially, overran its job timeout, saved
only at the end and has lost every run since late June (unreported:
timeouts end as "cancelled").

- scripts/refresh.py: daily slice of ~1/7 of the catalog (pending
  strikes first, then least recently checked), one GET per game for
  alive / paid / rating / status (+ release_date, thumbnail, updated_at
  backfill). Removal needs the same 404/410 or paid strike on two
  different UTC days. Paced requests, capped Retry-After back-off, stop
  after 3x 429, checkpoints and an in-script deadline. --full replaces
  force_update.py (rotating batches, editable fields preserved).
- Scanners emit a URL-keyed patch (patch.py); apply_patch.py applies it
  to the latest main and runs validate.py; bash/commit_push.sh fetches,
  re-applies and retries pushes, so concurrent writers never clobber
  each other.
- update_info.py: canonical URLs (canonical.py), skip games in the
  deleted log, keep transient failures queued (max 3 runs, tracked in
  scripts/state/), stamp added_at, never drop links queued meanwhile.
- data_store.py: games stay in their chunk, re-slice only past
  thresholds, write only changed bytes; index/count_history change only
  with data (no more no-op commits).
- validate.py (schema, enums, canonical/unique URLs, index consistency)
  + normalize one invalid safe_virus ("y" -> "Yes").
- tests/: 85 network-free pytest cases, HTML fixtures (from sample/),
  shared URL vectors and golden chunk/serialization fixtures for the
  future Worker port.
- Workflows: refresh.yml (scan -> apply -> notify), update.yml (runs on
  queue change), force_update.yml (refresh.yml full mode),
  notify-failure.yml (Discord on failure/cancel/rate limit),
  python-ci.yml, webapp-ci.yml, deploy-status.yml; draft-first release
  with one create-release job and tauri-action v1, no caches in release
  builds; SHA-pinned actions, permissions: {} defaults, reusable
  workflows pinned with explicit secrets, injection fixes; dependabot.yml.
- Remove lists/, generate_md, generate_table, log_deleted,
  deleted_games.txt, the Telegram bot-ingest path and old bash wrappers;
  update README (EN/VI), CONTRIBUTING, templates, CLAUDE.md, CHANGELOG
  and mark the retired Telegram path in the policies.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

* fix(pipeline): review findings on the refresh / ingest rewrite

Removals
- Mass-change guard: a run whose removals or new strikes exceed
  max(10, 10%) of the games it checked withholds all its removals and
  alerts (mass_change). Withheld games are marked withheld_at and stay
  withheld in later (even single-URL or rate-limited) runs until a healthy
  check clears them or a run is dispatched with allow_mass_removal.
- Checkpoints never carry removals, so a scan that dies before its guard
  cannot delete games; apply_patch re-checks the per-run limit and caps
  any patch at max(25, 5%) of the catalog (ALLOW_MASS_REMOVAL=1 overrides).
- Strikes mature by time, not calendar day: a second sighting must come
  >= 20 h after the first (strike_at), so two checks around midnight UTC no
  longer remove a game.
- Overlapping scans can't undo each other: refresh_state merges keep the
  newest check and the newest full stamp in either apply order, and a
  removal is skipped when a newer check has landed since.
- A corrupt count_history.json fails the apply instead of being replaced
  by a one-row history.

Ingest
- A second spelling of a queued game no longer drops the first copy
  before it reaches a final outcome.
- A dispatched url is processed first and kept in temp_link.json
  (queue_add) until it finishes, so a retry, deadline or rate-limit stop
  keeps it.
- Failures count as an attempt only >= 6 h apart and a 429 counts as none,
  so a burst of queued runs can't burn a link's three attempts.
- Non-string queue entries are cleaned on every apply instead of crashing
  it; {"url": ...} objects are unwrapped.

CI
- queue: max on the ingest, refresh-apply and force-update concurrency
  groups: the default queue replaced (and silently dropped) pending runs.
- Seed scripts/state/*.json and mkdir -p before git add (the pathspec
  failed on an empty patch until the directory existed on main).
- Cancelling a refresh / force-update / desktop release really stops it
  (!cancelled() instead of always()).
- deploy-status.yml becomes an hourly check of main's latest finished
  "Workers Builds: free-games-itchio-list" run (bash/cf_build_status.sh):
  GitHub never starts check_run workflows for GITHUB_TOKEN data commits.
- The reusable release notifiers still take their script from
  poli0981/.github@main; the caller comments now say so.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

* fix(pipeline): close the remaining mass-removal and monitor gaps

From the second review round of the pipeline fixes:
- A strike spike now marks every strike of that run withheld_at (the
  checkpoint of a run that dies mid-spike too), so a later short,
  rate-limited or single-URL run can't remove them without an
  allow_mass_removal dispatch.
- Withheld games take at most half of a run's budget (all of it for the
  allow_mass_removal run that confirms them), and a withheld full-mode
  game moves its `full` stamp, so neither rotation stalls on them.
- refresh.yml runs one scan -> apply pipeline at a time (workflow-level
  concurrency refresh-pipeline, queue: max), so an older removal can't be
  applied after a newer healthy check of the same game.
- deploy-status.yml alerts once per failed Cloudflare build, keyed on its
  check-run id and marked only after the Discord post, instead of by age
  (which could drop an alert after a missed run, or repeat it); the
  monitor walks main's first-parent history so preview builds of merged
  branch commits are never mistaken for the site's build.
- CLAUDE.md: merge PRs with squash or a merge commit, never by fast-forward.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5 <noreply@anthropic.com>
2026-09-18 17:52:57 +07:00
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
github-actions[bot] 72da856714 Update game tables [2026-08-17] 2026-08-17 03:48:51 +00:00
github-actions[bot] 9a1f9fac36 Update game info [2026-08-17] 2026-08-17 03:48:36 +00:00
itch-f2p-ext[bot] 83a09446e0 ext: add 68 game(s) to temp_link [2026-08-16] 2026-08-16 09:58:01 +00:00
github-actions[bot] d76bbcfb74 Update game tables [2026-08-16] 2026-08-16 03:45:43 +00:00
github-actions[bot] 828c4b6ce0 Update game info [2026-08-16] 2026-08-16 03:45:29 +00:00
itch-f2p-ext[bot] 5fce82a411 ext: add 45 game(s) to temp_link [2026-08-16] 2026-08-16 01:46:47 +00:00
github-actions[bot] 2240df4a3f Update game tables [2026-07-25] 2026-07-25 05:38:09 +00:00
github-actions[bot] 7429bcde53 Update game info [2026-07-25] 2026-07-25 05:37:58 +00:00
itch-f2p-ext[bot] 74de5a0fdb ext: add 1 game(s) to temp_link [2026-07-25] 2026-07-25 04:24:04 +00:00
github-actions[bot] e84f04b81a Update game tables [2026-07-09] 2026-07-09 06:40:59 +00:00
github-actions[bot] 7deaff0fb9 Update game info [2026-07-09] 2026-07-09 06:40:42 +00:00
itch-f2p-ext[bot] 3eae2be1d7 ext: add 43 game(s) to temp_link [2026-07-08] 2026-07-08 13:19:32 +00:00
github-actions[bot] f9dd772629 Update game tables [2026-07-01] 2026-07-01 04:43:31 +00:00
github-actions[bot] fe68cfa635 Update game info [2026-07-01] 2026-07-01 04:43:18 +00:00
itch-f2p-ext[bot] 4fcfcb056f ext: add 150 game(s) to temp_link [2026-06-30] 2026-06-30 06:10:46 +00:00
github-actions[bot] 4ec2118169 Update deleted games log [2026-06-29] 2026-06-29 10:40:03 +00:00
github-actions[bot] 6e70171918 Remove dead game links [2026-06-29] 2026-06-29 10:39:53 +00:00
github-actions[bot] dee8a38e79 Update game tables [2026-06-28] 2026-06-28 04:32:55 +00:00
github-actions[bot] 5081314cd4 Update game info [2026-06-28] 2026-06-28 04:32:44 +00:00
itch-f2p-ext[bot] 61e53c55db ext: add 3 game(s) to temp_link [2026-06-28] 2026-06-28 00:35:49 +00:00
itch-f2p-ext[bot] 9ebb166f6e ext: add 24 game(s) to temp_link [2026-06-27] 2026-06-27 13:53:46 +00:00
github-actions[bot] 6e90820387 Update game tables [2026-06-27] 2026-06-27 09:56:12 +00:00
github-actions[bot] f2365d9866 Remove dead game links [2026-06-27] 2026-06-27 09:56:00 +00:00
github-actions[bot] 6d40f0177c Update deleted games log [2026-06-25] 2026-06-25 10:04:53 +00:00
github-actions[bot] 8896bb7362 Remove dead game links [2026-06-25] 2026-06-25 10:04:39 +00:00
github-actions[bot] 69ec99fbba Update game tables [2026-06-23] 2026-06-23 10:11:47 +00:00
github-actions[bot] 5425227e0b Remove dead game links [2026-06-23] 2026-06-23 10:11:35 +00:00
github-actions[bot] 2bcbc30c5f Update game tables [2026-06-23] 2026-06-23 04:24:31 +00:00
github-actions[bot] a3e6e98087 Update game info [2026-06-23] 2026-06-23 04:24:19 +00:00
itch-f2p-ext[bot] d347f8d426 ext: add 7 game(s) to temp_link [2026-06-23] 2026-06-23 00:53:05 +00:00
github-actions[bot] 7bfb70fd15 Update game tables [2026-06-22] 2026-06-22 04:32:32 +00:00
github-actions[bot] 316f3d104e Update deleted games log [2026-06-21] 2026-06-21 10:31:56 +00:00
github-actions[bot] 1bec69aa75 Remove dead game links [2026-06-21] 2026-06-21 10:31:42 +00:00
github-actions[bot] 527eb160a7 Update game tables [2026-06-21] 2026-06-21 04:44:23 +00:00
github-actions[bot] 06932a0881 Update game info [2026-06-21] 2026-06-21 04:44:08 +00:00
itch-f2p-ext[bot] f6f4b784b3 ext: add 150 game(s) to temp_link [2026-06-21] 2026-06-21 03:52:38 +00:00
github-actions[bot] 5338a30e11 Update game tables [2026-06-20] 2026-06-20 04:29:17 +00:00
github-actions[bot] 7131db5114 Update deleted games log [2026-06-19] 2026-06-19 08:51:20 +00:00
github-actions[bot] d69f0fb47c Remove paid games [2026-06-19] 2026-06-19 08:51:08 +00:00
github-actions[bot] 7a80e30a2d Update deleted games log [2026-06-17] 2026-06-17 10:33:00 +00:00
github-actions[bot] 2a387753fc Remove dead game links [2026-06-17] 2026-06-17 10:32:44 +00:00
github-actions[bot] 21139b20e6 Update game tables [2026-06-17] 2026-06-17 04:37:45 +00:00
github-actions[bot] 726265f08e Update game info [2026-06-17] 2026-06-17 04:37:31 +00:00
itch-f2p-ext[bot] 596895639c ext: add 78 game(s) to temp_link [2026-06-17] 2026-06-17 04:26:32 +00:00
poli0981andClaude Opus 4.8 316f258ba6 feat(android): raise minSdkVersion to 30 (Android 11) + document requirements (#77)
Raise the Android APK floor from API 24 (Android 7.0) to API 30 (Android 11).
minSdkVersion is the OS-level install gate, so Android refuses to install the
APK on versions below the floor -- no runtime check needed. Chosen for OS
security hardening + AOSP patch availability (pre-11 is off Google's monthly
Security Bulletins) and our tested range (emulator 11->latest, vivo 1907 /
Android 12). Reach: ~86.9% of active devices (was 96.6% at API 24).

- tauri.conf.json: minSdkVersion 24->30; version 3.8.0->3.9.0
- Cargo.toml + about.ts: version -> 3.9.0 (kept aligned, gotcha #18)
- webapp/TAURI.md: "Why Android 11" rationale + sources + tested devices
- README.md / README.vi.md: Android note 7.0/API24 -> 11/API30
- docs/pc_spec.md (+ vi): Android (Tauri APK) tested-devices table
- CHANGELOG.md: add [3.9.0]; backfill the missing [3.8.0] entry
- CLAUDE.md: gotcha #19 (minSdk floor rationale + reach table) + current state

Sources: endoflife.date/android, source.android.com Security Bulletins,
StatCounter version share (May 2026), apilevels.com (Apr 2026).

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-15 20:51:54 +07:00
github-actions[bot] ac466a3042 Update game tables [2026-06-15] 2026-06-15 10:58:32 +00:00
github-actions[bot] 9244a4ab9f Remove dead game links [2026-06-15] 2026-06-15 10:58:20 +00:00
poli0981andClaude Opus 4.8 d371a0f8d0 docs(claude-md): mark v3.8.0 released + gradle-cache gotcha (#74)
v3.8.0 (Android APK) is tagged and released. Flip "in progress" -> released,
extend the tag range to v3.8.0, and note the release_android.yml gotcha:
setup-java `cache: gradle` hard-fails because gen/android is generated mid-job.

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-15 15:26:05 +07:00
poli0981andClaude Opus 4.8 f08637db82 fix(ci): drop gradle cache from Android JDK setup (#73)
`actions/setup-java` with `cache: gradle` hard-fails because gen/android (the
Gradle project) is gitignored and only generated by `tauri android init` later
in the job — there are no gradle files at checkout to key the cache on. Remove
it; rust-cache + npm cache still apply.

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-15 15:02:54 +07:00
poli0981andClaude Opus 4.8 3d5d4d0cf2 feat(android): Android APK build & packaging via Tauri mobile (#71)
Ship the webapp as a sideloadable arm64-v8a .apk alongside the desktop
installers — the same React + Tauri app running in an Android WebView.

- Fix the bundle identifier to be Android-valid (alphanumeric — Android
  rejects hyphens, Tauri rejects underscores):
  com.poli0981.free-games-itchio-webapp -> com.poli0981.freegamesitchio.
  release_desktop.yml now reads the macOS .pkg --identifier from config.
- Realign Tauri/Cargo/UI versions to 3.8.0 (sane, monotonic versionCode).
- Add bundle.android.minSdkVersion 24.
- New release_android.yml: arm64-v8a build, post-signed with zipalign +
  apksigner (gen/ stays gitignored — no Gradle edits). Attaches to the
  draft Release on a v* tag; uploads a workflow artifact on manual dispatch.
- Mobile UX: Android back button -> router history (useBackButton hook),
  safe-area insets, platform-aware sidebar badge (Desktop/Mobile app).
- Add @tauri-apps/api dependency; docs in TAURI.md, README(.vi), CLAUDE.md.

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-15 14:59:31 +07:00
poli0981andClaude Opus 4.8 68d97d48cb fix(webapp): stop emitting source maps in the web build (#70)
The web build set `sourcemap: !isTauri` → true, so Vite emitted *.js.map
files and `sourceMappingURL` comments into docs/app/, exposing the
original TypeScript via DevTools on the deployed GitHub Pages site.

No error-tracking service consumes the maps (PrivacyPolicy confirms no
Sentry/Datadog), so disable them outright rather than using 'hidden'
(which would still publish fetchable .map files). The Tauri build was
already mapless; local `npm run dev` sourcemaps are unaffected.

Verified: build emits 0 .map files and 0 sourceMappingURL refs; lint clean.

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-14 21:00:20 +07:00
github-actions[bot] e1fd54dbd9 Update game tables [2026-06-14] 2026-06-14 11:47:31 +00:00
github-actions[bot] 052a8d57d4 Update game info [2026-06-14] 2026-06-14 11:47:17 +00:00
itch-f2p-ext[bot] 2c83bb3443 ext: add 24 game(s) to temp_link [2026-06-14] 2026-06-14 11:42:55 +00:00
poli0981andClaude Opus 4.8 5afbf31cb5 docs(claude-md): record Tauri nsis.license gotcha (#15) + v3.7.1 state (#69)
bundle.windows.nsis.license does not exist in @tauri-apps/cli 2.11.0 and broke
the v3.7.0 desktop build; document the bundle.licenseFile (RTF) workaround so
future sessions don't relearn it. Bump current-state note to v3.7.1.

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-14 09:09:09 +07:00
poli0981andClaude Opus 4.8 892e8fa23f release(v3.7.1): installer EULA via bundle.licenseFile RTF (working desktop build) (#66)
v3.7.0's desktop installers failed config validation on all platforms:
@tauri-apps/cli 2.11.0's NsisConfig has no `license` key (added in a later
release), so `bundle.windows.nsis.license` was rejected.

Switch to the top-level `bundle.licenseFile` (valid in 2.11.0) -> RTF EULA.
RTF satisfies BOTH Windows bundlers — WiX (.msi) requires RTF and NSIS (.exe)
auto-detects it — so both installers show the "I Agree" page. The previous
plain-text EULA.txt would also have broken the WiX/.msi build.

Bumps about.ts version 3.7.0 -> 3.7.1; adds CHANGELOG [3.7.1]. Web feature set
is identical to v3.7.0.

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-14 08:56:33 +07:00
poli0981andClaude Opus 4.8 7d99881aff feat(v3.7.0): legal-acceptance gates + per-tab chart lazy-loading (#62)
Web: full-screen first-launch legal gate (LegalGate) blocks the app until the
user accepts the current LEGAL_VERSION; persists as prefs.acceptedLegalVersion
in localStorage (no cookie). Reuses LEGAL_LINKS; re-prompts on LEGAL_VERSION bump.
Built on raw Radix Dialog (focus-trapped, no close-X, Esc/outside-click disabled).

Desktop: Windows NSIS installer shows an EULA "I Agree" page via
bundle.windows.nsis.license -> src-tauri/installer/EULA.txt.

Charts: /charts split into four lazy per-tab chunks (charts/tabs/*). Each tab
imports its chart components directly (index.ts barrel removed) so the bundler
keeps each tab's components in its own chunk; non-default tabs' component code
loads only on activation. Recharts still loads with the default Overview tab.

Also: about.ts version -> 3.7.0 + Opus 4.8 credit; Privacy Policy localStorage
key note (EN + VI); CHANGELOG + CLAUDE.md updates.

Verified: eslint, tsc -b, knip, npm audit (0 vulns), ruff, vulture all clean;
browser smoke test of gate (appear / accept / persist / version-bump re-prompt)
and per-tab lazy loading (reach-tab + its charts load only on tab click).

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-14 08:44:34 +07:00
github-actions[bot] bf7cdf3dd2 Update deleted games log [2026-06-13] 2026-06-13 08:31:18 +00:00
github-actions[bot] 1e80bb1bdf Remove paid games [2026-06-13] 2026-06-13 08:31:05 +00:00
poli0981andClaude Fable 5 95089ae500 docs(claude-md): catch up repo notes to v3.6.1 (#61)
- Webapp structure: document src/lib/i18n/ (en.ts source of truth, vi.ts lazy-only), react-query IndexedDB persistence in main.tsx (buster = APP.version, gcTime >= maxAge), and the error-handling stack (HttpError, error pages, /errors/:code preview, public/404.html)
- prefs store: note language preference
- Current state: v3.5.0 -> v3.6.1

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
2026-06-12 23:27:29 +07:00
poli0981andClaude Fable 5 555fb33deb release(v3.6.1): pin time 0.3.47 - unbreak desktop builds (#58)
- time 0.3.48 (released 2026-06-12) fails to compile inside tauri-utils
  (E0119 conflicting From impls, time-rs/time#783); with no committed
  Cargo.lock, CI resolved it fresh and the v3.6.0 desktop build failed
- Pin time = "=0.3.47" in webapp/src-tauri/Cargo.toml (the version all
  releases through v3.5.2 built with); remove once upstream fix ships
- Bump version badges, about.ts, CHANGELOG to 3.6.1 (web unchanged from
  v3.6.0; no Tauri version bump - no binary behavior change)

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
2026-06-12 20:18:53 +07:00
poli0981andClaude Fable 5 af8dd83157 release(v3.6.0): i18n EN/VI, offline cache, custom error pages (#55)
- Minimal typed i18n layer (~454 keys) with lazy-loaded Vietnamese dictionary
  chunk; language switcher in Settings, preference persisted in webapp.prefs
- Persist react-query catalog cache to IndexedDB (instant paint on revisit,
  background revalidation; buster = app version, maxAge 7 days)
- Status-aware error pages (400-504, 419, offline, unknown) wired into every
  route via typed HttpError; route ErrorBoundary with new-version reload;
  hidden /errors/:code preview route; static 404.html for GitHub Pages
- Perf polish: GameThumb onError fallback, lazy settings avatar, DEV-gated
  react-query devtools
- npm audit fix: react-router 7.14.2 -> 7.17.0 (GHSA-8x6r-g9mw-2r78)
- Bump version badges, about.ts APP.version, CHANGELOG to 3.6.0

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
2026-06-12 20:00:25 +07:00
github-actions[bot] 7202de0ad7 Update game tables [2026-06-11] 2026-06-11 08:36:02 +00:00
github-actions[bot] 9c270e6529 Remove paid games [2026-06-11] 2026-06-11 08:35:51 +00:00
github-actions[bot] 0108e2848e Update game tables [2026-06-11] 2026-06-11 04:43:48 +00:00
github-actions[bot] c966115c91 Update game info [2026-06-11] 2026-06-11 04:43:35 +00:00
itch-f2p-ext[bot] 28a30393f8 ext: add 150 game(s) to temp_link [2026-06-10] 2026-06-10 09:31:28 +00:00
github-actions[bot] 448f5932b9 Update game tables [2026-06-10] 2026-06-10 04:41:34 +00:00
github-actions[bot] 167077216f Update game info [2026-06-10] 2026-06-10 04:41:24 +00:00
itch-f2p-ext[bot] 6f7f104254 ext: add 134 game(s) to temp_link [2026-06-09] 2026-06-09 16:53:19 +00:00
github-actions[bot] f4754eed13 Remove dead game links [2026-06-09] 2026-06-09 09:42:57 +00:00
github-actions[bot] 6613ab072e Remove paid games [2026-06-09] 2026-06-09 07:58:47 +00:00
github-actions[bot] a1064338da Update game tables [2026-06-09] 2026-06-09 04:38:17 +00:00
github-actions[bot] 2d75b884f7 Update game info [2026-06-09] 2026-06-09 04:38:05 +00:00
itch-f2p-ext[bot] 35272ff193 ext: add 150 game(s) to temp_link [2026-06-08] 2026-06-08 16:23:47 +00:00
itch-f2p-ext[bot] fcff789d39 ext: add 2 game(s) to temp_link [2026-06-08] 2026-06-08 14:50:11 +00:00
itch-f2p-ext[bot] c1ff95f20c ext: add 2 game(s) to temp_link [2026-06-08] 2026-06-08 14:24:34 +00:00
github-actions[bot] a9608c249c Update game tables [2026-06-08] 2026-06-08 04:31:31 +00:00
github-actions[bot] 3179379a46 Update deleted games log [2026-06-07] 2026-06-07 09:36:12 +00:00
github-actions[bot] a880d1a8a1 Remove dead game links [2026-06-07] 2026-06-07 09:36:01 +00:00
github-actions[bot] c45bdf935b Update deleted games log [2026-06-07] 2026-06-07 07:56:27 +00:00
github-actions[bot] 771e88e0f3 Remove paid games [2026-06-07] 2026-06-07 07:56:15 +00:00
github-actions[bot] 417e0a2257 Update game tables [2026-06-06] 2026-06-06 04:23:41 +00:00
github-actions[bot] 45911f9177 Update game info [2026-06-06] 2026-06-06 04:23:31 +00:00
itch-f2p-ext[bot] db3bafa156 ext: add 5 game(s) to temp_link [2026-06-06] 2026-06-06 03:22:55 +00:00
github-actions[bot] 028da83fcc Update game tables [2026-06-05] 2026-06-05 09:45:52 +00:00
github-actions[bot] f73ab71461 Remove dead game links [2026-06-05] 2026-06-05 09:45:38 +00:00
github-actions[bot] 20264e6d5d Update game tables [2026-06-05] 2026-06-05 07:59:01 +00:00
github-actions[bot] 284192c4dd Remove paid games [2026-06-05] 2026-06-05 07:58:47 +00:00
github-actions[bot] 4d68316943 Update game tables [2026-06-04] 2026-06-04 04:31:39 +00:00
github-actions[bot] de780514d3 Update game info [2026-06-04] 2026-06-04 04:31:26 +00:00
itch-f2p-ext[bot] 5e25b5926d ext: add 5 game(s) to temp_link [2026-06-04] 2026-06-04 03:40:45 +00:00
github-actions[bot] 305ee0c86c Update deleted games log [2026-06-03] 2026-06-03 10:03:50 +00:00
github-actions[bot] f6bf8ff1c5 Remove dead game links [2026-06-03] 2026-06-03 10:03:36 +00:00
github-actions[bot] aca27f0abc Remove paid games [2026-06-03] 2026-06-03 08:01:53 +00:00
github-actions[bot] 18e7f0d23a Remove dead game links [2026-06-01] 2026-06-01 10:17:07 +00:00
github-actions[bot] 0664d197cf Remove paid games [2026-06-01] 2026-06-01 08:01:43 +00:00
github-actions[bot] 5ee30a1e29 Update game tables [2026-06-01] 2026-06-01 04:32:32 +00:00
github-actions[bot] 98acc89f48 Update deleted games log [2026-05-31] 2026-05-31 09:29:54 +00:00
github-actions[bot] 4adac11b12 Remove dead game links [2026-05-31] 2026-05-31 09:29:44 +00:00
github-actions[bot] 4e8a4072be Remove paid games [2026-05-31] 2026-05-31 07:53:55 +00:00
github-actions[bot] ccd4f02b8d Update game tables [2026-05-30] 2026-05-30 04:22:19 +00:00
github-actions[bot] 6b0e62e491 Update deleted games log [2026-05-29] 2026-05-29 09:41:36 +00:00
github-actions[bot] 7935548455 Remove dead game links [2026-05-29] 2026-05-29 09:41:22 +00:00
github-actions[bot] f57ed5e66b Remove paid games [2026-05-29] 2026-05-29 07:53:01 +00:00
github-actions[bot] 5e93e554db Update game tables [2026-05-28] 2026-05-28 04:28:07 +00:00
github-actions[bot] 2f78ff7ec6 Update deleted games log [2026-05-27] 2026-05-27 09:46:29 +00:00
github-actions[bot] 042819c414 Remove dead game links [2026-05-27] 2026-05-27 09:46:15 +00:00
github-actions[bot] 93b4a04fb7 Remove paid games [2026-05-27] 2026-05-27 07:53:08 +00:00
github-actions[bot] e8d1c77194 Update game tables [2026-05-26] 2026-05-26 04:27:34 +00:00
github-actions[bot] 9cc70e1c50 Update game info [2026-05-26] 2026-05-26 04:27:23 +00:00
itch-f2p-ext[bot] 61b290402f ext: add 21 game(s) to temp_link [2026-05-25] 2026-05-25 15:51:40 +00:00
github-actions[bot] ba50269b89 Remove dead game links [2026-05-25] 2026-05-25 09:53:15 +00:00
github-actions[bot] a72574acaf Update deleted games log [2026-05-25] 2026-05-25 08:01:46 +00:00
github-actions[bot] 0aae0d77c2 Remove paid games [2026-05-25] 2026-05-25 08:01:34 +00:00
github-actions[bot] 473fe32d6f Update game tables [2026-05-24] 2026-05-24 04:30:15 +00:00
github-actions[bot] 24b608d015 Update game info [2026-05-24] 2026-05-24 04:30:05 +00:00
itch-f2p-ext[bot] 7d03a4c3ff ext: add 17 game(s) to temp_link [2026-05-23] 2026-05-23 13:13:22 +00:00
github-actions[bot] ccccfd20cd Update game tables [2026-05-23] 2026-05-23 11:36:03 +00:00
github-actions[bot] a2d3029d88 Remove dead game links [2026-05-23] 2026-05-23 11:35:52 +00:00
itch-f2p-ext[bot] a2755686af ext: add 10 game(s) to temp_link [2026-05-23] 2026-05-23 08:34:54 +00:00
github-actions[bot] 990fa9fe70 Update game tables [2026-05-23] 2026-05-23 07:36:16 +00:00
github-actions[bot] 2cf98b1381 Remove paid games [2026-05-23] 2026-05-23 07:36:04 +00:00
poli0981andClaude Opus 4.7 199497a5a6 release(v3.5.2): dead-code cleanup + knip/vulture tooling (#52)
- Wire in knip (webapp) and vulture (Python) as dead-code detectors
- Remove 8 unused deps, the unwired Tauri scrape-preview scaffold, and
  ~20 unused exports/types across the webapp
- Add docs/THIRD_PARTY.md attributing the dev tooling; trim TAURI.md
- Bump version badges, about.ts, and CHANGELOG to 3.5.2

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-23 00:42:36 +07:00
github-actions[bot] f55eb92fd4 Update game tables [2026-05-22] 2026-05-22 11:45:05 +00:00
github-actions[bot] 8b751fac69 Update game info [2026-05-22] 2026-05-22 11:44:54 +00:00
itch-f2p-ext[bot] 63b31346ca ext: add 150 game(s) to temp_link [2026-05-22] 2026-05-22 11:22:56 +00:00
github-actions[bot] db78f761de Update game tables [2026-05-22] 2026-05-22 04:27:18 +00:00
github-actions[bot] 5cf5946313 Update game info [2026-05-22] 2026-05-22 04:27:07 +00:00
itch-f2p-ext[bot] d8f111a9ca ext: add 1 game(s) to temp_link [2026-05-21] 2026-05-21 11:44:59 +00:00
github-actions[bot] d466344300 Remove dead game links [2026-05-21] 2026-05-21 09:30:27 +00:00
github-actions[bot] e6b259af5d Remove paid games [2026-05-21] 2026-05-21 07:34:12 +00:00
poli0981andClaude Opus 4.7 0f284ba04e release(v3.5.1): clean up ESLint — zero lint problems (#49)
- Turn off react-refresh/only-export-components for src/components/ui/**
  (vendored shadcn primitives) and react-hooks/incompatible-library
  (non-actionable TanStack Table warning) in eslint.config.js.
- Extract SortableHeader into its own data-table/sortable-header.tsx so
  columns.tsx is a pure column-definition module.
- Fix react-hooks/exhaustive-deps in games.tsx and faceted-filter.tsx —
  wrap values built with `?? []` so dependent useMemos actually memoize.
- npm run lint now reports 0 errors, 0 warnings (was 17 + 5).

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-20 18:39:41 +07:00
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
github-actions[bot] 67ad34c3fb Update deleted games log [2026-05-19] 2026-05-19 09:26:59 +00:00
github-actions[bot] 5160b8542b Update game tables [2026-05-19] 2026-05-19 09:24:45 +00:00
github-actions[bot] 00715ab47f Remove dead game links [2026-05-19] 2026-05-19 09:24:31 +00:00
github-actions[bot] 946b535f39 Remove paid games [2026-05-19] 2026-05-19 07:28:56 +00:00
github-actions[bot] fac3c96dca Update game tables [2026-05-19] 2026-05-19 04:29:27 +00:00
github-actions[bot] 9b44dce0b9 Update game info [2026-05-19] 2026-05-19 04:29:15 +00:00
itch-f2p-ext[bot] 9d5d02d34e ext: add 45 game(s) to temp_link [2026-05-18] 2026-05-18 07:35:32 +00:00
github-actions[bot] aa32dfa71e Update game tables [2026-05-18] 2026-05-18 04:29:15 +00:00
poli0981 c5ef1502e7 chore(webapp): bulk-update 2 games (nsfw) 2026-05-17 19:55:37 +07:00
itch-f2p-ext[bot] b7745ba4da ext: add 150 game(s) to game_info [2026-05-17] 2026-05-17 12:46:05 +00:00
poli0981andClaude Opus 4.7 3fab1e94c9 release(v3.4.1): hotfix — DataTable column alignment + auto-discover Discussion IDs (#43)
- Fix DataTable header/body width mismatch at desktop widths (Tauri 1280×800
  and any viewport wider than the natural sum of header content widths). Header
  was native table-layout, body was flex — the absolutely-positioned virtual
  rows never participated in table layout, so the two diverged whenever the
  container had leftover space. Header `<tr>` now uses `flex w-full` and each
  `<th>` mirrors the body `<td>`'s flex style. Drops the table-cell variant of
  the priority helper.
- Rewrite `announce-discussion.yml` to auto-discover IDs at runtime via
  `gh api graphql`. Previous validation step silently `exit 0`'d on every run
  because the three required repo variables (`DISCUSSION_REPO_ID` +
  category IDs) had never been configured, so every release since v3.2.0
  failed to post to Discussions without flagging it. Zero config now; fails
  loudly if Discussions isn't enabled or a category is missing.
- README + README.vi badges + about.ts APP.version → 3.4.1.

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-17 17:53:21 +07:00
github-actions[bot] 24730efc07 Update game tables [2026-05-17] 2026-05-17 08:43:01 +00:00
github-actions[bot] 305f0ae644 Remove paid games [2026-05-17] 2026-05-17 08:42:48 +00:00
itch-f2p-ext[bot] ca01b5969e ext: add 150 game(s) to game_info [2026-05-17] 2026-05-17 06:34:34 +00:00
github-actions[bot] 87b53a719e Update game tables [2026-05-17] 2026-05-17 04:28:54 +00:00
github-actions[bot] b8009e846b Update game info [2026-05-17] 2026-05-17 04:28:43 +00:00
poli0981 c654cc6f0c Update deployment trigger paths in workflow
Removed 'data_game/**' path from the deployment trigger.
2026-05-17 10:53:54 +07:00
itch-f2p-ext[bot] f9bd3443f2 ext: add 49 game(s) to temp_link [2026-05-17] 2026-05-17 03:42:23 +00:00
github-actions[bot] a314e16086 Update game tables [2026-05-16] 2026-05-16 18:04:47 +00:00
github-actions[bot] c2a8632aac Force update [2026-05-16] 2026-05-16 18:04:36 +00:00
poli0981 179dedb7e3 chore(webapp): update annotations for Just Kiss Him Already! 2026-05-16 23:29:45 +07:00
poli0981andClaude Opus 4.7 500ff7fd02 release(v3.4.0): periodic refresh workflows + UTF-8 round-trip fix (#42)
- New scripts/update_reviews.py + bash + workflow on cron '0 5 1,15 * *':
  refresh rating + rating_count fortnightly via scrape_game_info, skip on
  network/parse errors so old values aren't blanked.
- New scripts/update_status.py + bash + workflow on cron '0 6 1 * *':
  refresh status monthly using the same pattern.
- New scripts/force_update.py + bash + workflow (workflow_dispatch only):
  optional url input; empty input re-scrapes every game. Always preserves
  safe_virus / notes / nsfw per CLAUDE.md "Editable vs read-only fields".
  Doubles as the canonical mojibake repair tool.
- Chain generate_table.yml on the three new workflows so lists/*.md regen
  automatically after data mutations.
- Fix UTF-8 mojibake on webapp writes: webapp/src/lib/github/contents.ts
  readFileWithSha and git-data.ts bulkDeleteGames decoded GitHub's base64
  content with atob alone (Latin-1 binary string). Multi-byte UTF-8 sequences
  became mojibake; next write re-encoded them as UTF-8, double-corrupting per
  edit cycle. Confirmed damage in data_game/game_info_002.json
  ('BotÃÂão Esquerdo' was 'Botão Esquerdo'). Extract shared helper
  webapp/src/lib/github/encoding.ts (base64ToUtf8 / utf8ToBase64) using
  TextDecoder('utf-8') / TextEncoder; route both call sites through it.
- Version bumps: README + README.vi -> 3.4.0, about.ts APP.version -> 3.4.0,
  new CHANGELOG entry, CLAUDE.md GitHub Actions table + gotcha #8 updated.
- No Rust binary change: tauri Cargo.toml / tauri.conf.json untouched.

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-16 23:15:38 +07:00
poli0981andClaude Opus 4.7 c90e038585 release(v3.3.0): mobile polish + Settings cards + in-browser GPG commit signing (#41)
- Mobile fix: useIsMobile hook + MobileCardList (card view <md:) for games table;
  Workflows route dual-renders Select on mobile + TabsList on desktop;
  Charts TabsList gains flex-wrap defensively.
- Settings Phase A: four new cards in routes/settings.tsx
  (Appearance, Session, Commit author, Notifications) backed by extended prefs
  store (density, idleTimeoutMs, authorName/email, notificationsEnabled/Duration).
  AppToaster wraps sonner so notification settings apply globally.
- In-browser GPG signing: new webapp/src/lib/gpg/ module
  (canonicalize.ts, sign.ts, storage.ts) + stores/gpg.ts + components/settings/gpg-card.tsx.
  openpgp lazy-loaded into vendor-openpgp chunk (~129 KB gz). Private key decrypted
  once at import, re-encrypted with webapp passphrase (AES-GCM, same scheme as PAT).
  Settings card surfaces UID emails + warns on mismatch; auto-populates author email
  from primary UID on import.
- Refactor PUT contents -> Git Data API: all write paths (single-file edits,
  bulk edit/delete, temp_link.json queue) route through atomicCommit so signing
  applies uniformly. atomicCommit gains optional signer (defaults to
  getSignerIfEnabled()), threads canonical commit object + signature + author/
  committer blocks. Verified byte-for-byte against git cat-file commit <sha>.
- About page lists OpenPGP.js 6.3 under Data; CLAUDE.md + ACKNOWLEDGEMENTS.md
  updated; README + README.vi badges bumped to 3.3.0.

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-16 22:37:31 +07:00
poli0981 cfd2295960 chore(webapp): update annotations for A Date with Death 2: REMNANTS 2026-05-16 22:26:07 +07:00
poli0981 4f243fde0b chore(webapp): update annotations for ​Our Life: Beginnings & Always 2026-05-16 22:05:35 +07:00
poli0981 edba30cbc1 chore(webapp): update annotations for Lookouts 2026-05-16 21:10:44 +07:00
poli0981 6cbca0caea chore(webapp): update annotations for A Date with Death 2: REMNANTS 2026-05-16 21:04:02 +07:00
github-actions[bot] 6906b9e686 Update game tables [2026-05-16] 2026-05-16 13:48:33 +00:00
github-actions[bot] d5047f37ef Update game info [2026-05-16] 2026-05-16 13:48:22 +00:00
itch-f2p-ext[bot] 72343c35f2 ext: add 150 game(s) to temp_link [2026-05-16] 2026-05-16 13:25:35 +00:00
github-actions[bot] cfced28389 Update game tables [2026-05-16] 2026-05-16 04:29:56 +00:00
github-actions[bot] 29bc8f1cce Update deleted games log [2026-05-16] 2026-05-16 04:28:30 +00:00
github-actions[bot] 0e0a06305c Remove dead game links [2026-05-16] 2026-05-16 04:28:19 +00:00
github-actions[bot] 9a5c63cc60 Update game tables [2026-05-16] 2026-05-16 03:35:37 +00:00
github-actions[bot] 884704712f Update game info [2026-05-16] 2026-05-16 03:35:23 +00:00
itch-f2p-ext[bot] bd7d98240e ext: add 150 game(s) to temp_link [2026-05-16] 2026-05-16 03:20:48 +00:00
github-actions[bot] 69e146333b bot-ingest: run 25910559142 2026-05-15 09:35:08 +00:00
github-actions[bot] a156831836 Update game tables [2026-05-15] 2026-05-15 07:23:51 +00:00
github-actions[bot] 95fd757359 Update game info [2026-05-15] 2026-05-15 07:23:41 +00:00
github-actions[bot] 80eb2e7ef3 Update game tables [2026-05-15] 2026-05-15 07:18:58 +00:00
github-actions[bot] 934622ae45 Update game info [2026-05-15] 2026-05-15 07:18:46 +00:00
poli0981 1cdc076b1f chore(webapp): queue 13 new URLs 2026-05-15 14:17:40 +07:00
github-actions[bot] c7eec4dc07 bot-ingest: run 25904460829 2026-05-15 06:45:13 +00:00
poli0981 d4a0575c48 Add path filter for data_game directory in workflow 2026-05-15 13:08:31 +07:00
github-actions[bot] b785d6b805 Update game tables [2026-05-13] 2026-05-13 08:35:31 +00:00
github-actions[bot] bde4cceb3d Remove dead game links [2026-05-13] 2026-05-13 08:35:11 +00:00
github-actions[bot] 6ad42c56a8 Remove paid games [2026-05-13] 2026-05-13 06:19:25 +00:00
github-actions[bot] 3028624837 Update game tables [2026-05-13] 2026-05-13 04:20:05 +00:00
github-actions[bot] 1f50241810 Update game info [2026-05-13] 2026-05-13 04:19:56 +00:00
github-actions[bot] 3ca4b6875a bot-ingest: run 25772323829 2026-05-13 01:31:37 +00:00
poli0981andClaude Opus 4.7 d241ffb415 release(v3.2.1): single-instance enforcement on desktop (#40)
- Add tauri-plugin-single-instance v2, registered first in builder chain
- Bump desktop binary version 0.1.0 -> 0.1.1 (boundary change)
- Bump app version 3.2.0 -> 3.2.1, README badges, About page

Fixes duplicate-process bug: each launch used to spawn a new
free-games-itchio-webapp.exe instead of focusing the existing window.

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-11 19:33:49 +07:00
github-actions[bot] 78cc46691b Remove dead game links [2026-05-11] 2026-05-11 08:40:24 +00:00
github-actions[bot] 375f90f88c Remove paid games [2026-05-11] 2026-05-11 06:14:04 +00:00
github-actions[bot] 4c19dfd463 Update game tables [2026-05-11] 2026-05-11 04:26:17 +00:00
github-actions[bot] da38e4ca00 Update game info [2026-05-11] 2026-05-11 04:26:06 +00:00
poli0981 917dfce387 Merge pull request #39 from poli0981/claude/gifted-babbage-ee7bd6
v3.2.0 — CI cleanup + mobile + SEO + Telegram bot path + auto-discussion
2026-05-10 23:17:38 +07:00
poli0981andClaude Opus 4.7 74ad62be79 v3.2.0: CI cleanup + mobile + SEO + Telegram bot path + auto-discussion
Workflows
- notify-ci-failure / notify-deploy / notify-release-pipeline: replace
  workflows: ["*"] with explicit allowlists. No more skip storm.
- bot-ingest.yml: drop dead final step (wrong secret name + missing
  result.txt).
- announce-discussion.yml (NEW): release:published -> Announcements
  category; push to docs/** -> General. Gated by [skip-discuss] commit
  token + skip on bot-ingest: commits. Configured via repo variables
  DISCUSSION_REPO_ID / *_ANNOUNCEMENTS_CATEGORY_ID / *_GENERAL_CATEGORY_ID.

Webapp - mobile + SEO + image
- ui/sheet.tsx (NEW) on top of existing @radix-ui/react-dialog.
- sidebar.tsx: desktop static sidebar (hidden md:flex) + MobileTopBar
  with hamburger Sheet drawer + auto-close on route change.
- App.tsx: responsive layout, h-[100dvh] for mobile, ScrollToHash for
  /about#support hash anchor.
- DataTable: meta.priority 1/2/3 + Tailwind responsive hide below md/lg.
- Touch targets bumped to 44pt minimum on mobile.
- index.html: full meta (description, OG, Twitter card, theme-color,
  manifest, canonical, preconnect img.itch.zone +
  raw.githubusercontent.com).
- public/: manifest.webmanifest, robots.txt, sitemap.xml, icon-192.png,
  icon-512.png, og.png, og.webp (generated by scripts/gen_assets.py).
- useDocumentTitle hook + applied to all 10 routes.
- Image hints: width/height (CLS), decoding=async, fetchPriority hi/lo.

Webapp - About + donate
- about.ts: messaging group with @SkullMute0011 + @my_skull_bot;
  full FUNDING.yml mirror (5 sources: GitHub Sponsors, Patreon, Ko-fi,
  Buy Me a Coffee, PayPal); +@hookform/resolvers and TanStack Query
  version bump 5.10 -> 5.100.
- about.tsx: messaging group privacy reminder, paypal footnote,
  scroll-mt anchor for /about#support.
- sidebar Heart "Support" link in both collapsed and expanded states.
- App version bumped to 3.2.0.

Telegram bot contribution flow
- CONTRIBUTING.md sec.1b (EN+VI): DM owner -> numeric ID added to
  operator-side whitelist -> bot dispatches bot-ingest.yml. Cross-link
  to telegram-scraper-bot/USER_GUIDE.md.
- ToS.md sec.14 + PrivacyPolicy.md sec.15 (EN+VI): explicit consent,
  whitelist never enters this repo, removable on DM.
- ISSUE_TEMPLATE/game_via_bot.yml (NEW) with required checkbox
  blocking numeric ID paste.

Docs
- docs/pc_spec.md + docs/dev_env.md (EN+VI): hardware + IDE + toolchain.
- README.md / README.vi.md: badge -> 3.2.0, Telegram bullets, full
  donate list, dev_env links.
- ACKNOWLEDGEMENTS.md: extended Claude Code line through v3.2.0,
  open-source libs subsection, Telegram bot ingest-path note,
  full FUNDING list, fixed "100% Grok assistance" closer.
- CHANGELOG.md v3.2.0 entry with maintainer setup notes.

Build + lint pass. Initial bundle ~163 KB gzip target maintained.
Mobile drawer + table priority columns smoke-tested per maintainer.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-10 23:16:15 +07:00
github-actions[bot] 2b22b85284 bot-ingest: run 25627763897 2026-05-10 11:42:38 +00:00
github-actions[bot] f46a112dcc Update game tables [2026-05-10] 2026-05-10 04:21:26 +00:00
github-actions[bot] 45ebc7b650 Update game info [2026-05-10] 2026-05-10 04:21:15 +00:00
github-actions[bot] db7a8f5b97 bot-ingest: run 25609083300 2026-05-09 18:51:34 +00:00
poli0981 b85f7df5f5 Fix formatting in bot-ingest.yml 2026-05-10 01:39:03 +07:00
poli0981 b1348ef73c test telegram bot 2026-05-10 01:35:46 +07:00
github-actions[bot] d654326eaa bot-ingest: run 25600931617 2026-05-09 12:18:31 +00:00
github-actions[bot] 03dca570c3 bot-ingest: run 25595643179 2026-05-09 07:43:56 +00:00
poli0981 8b4675a0be test telegram bot 2026-05-09 14:07:04 +07:00
github-actions[bot] 0d4ab17f71 Remove paid games [2026-05-09] 2026-05-09 05:54:34 +00:00
poli0981 d63d919935 delete 2026-05-09 00:47:11 +07:00
github-actions[bot] c7908b6a46 Update game tables [2026-05-08] 2026-05-08 17:15:54 +00:00
github-actions[bot] 4b56bd9020 Update game info [2026-05-08] 2026-05-08 17:15:41 +00:00
poli0981 dbeddd0547 Refactor Discord notification workflow 2026-05-09 00:11:51 +07:00
poli0981 1b5e0202b3 Refactor deploy notification workflow configuration 2026-05-09 00:11:27 +07:00
poli0981 e8f9fa09cf Refactor CI failure notification workflow 2026-05-09 00:10:58 +07:00
poli0981 5f7c2d7700 Refactor announce-release.yml to use reusable workflow 2026-05-09 00:10:24 +07:00
poli0981 04ab1bfe04 discord notification script update 2026-05-08 21:04:21 +07:00
poli0981 97f56ef136 discord notification script update 2026-05-08 20:07:25 +07:00
poli0981 e074c6bda9 discord notification 2026-05-08 18:01:00 +07:00
github-actions[bot] 09b64b5229 Update game tables [2026-05-07] 2026-05-07 15:04:11 +00:00
github-actions[bot] f568db034e Update game info [2026-05-07] 2026-05-07 15:03:53 +00:00
poli0981 94038e5206 chore(webapp): queue 17 new URLs 2026-05-07 22:02:18 +07:00
github-actions[bot] b0ab24330a Remove dead game links [2026-05-07] 2026-05-07 08:22:21 +00:00
github-actions[bot] f082c929e1 Remove paid games [2026-05-07] 2026-05-07 05:57:55 +00:00
github-actions[bot] 8f54571aca Remove dead game links [2026-05-05] 2026-05-05 08:06:55 +00:00
github-actions[bot] 2b01684904 Remove paid games [2026-05-05] 2026-05-05 05:53:16 +00:00
poli0981andClaude Opus 4.7 89e0197ee5 release(v3.1.4): legal docs rewrite, Vietnamese i18n, Legal Card, UI polish (#38)
Rewrote the four English legal docs (DISCLAIMER, EULA, ToS, PrivacyPolicy) to
be tighter and more enforceable while keeping the project's voice — TL;DR, numbered
sections, definitions, severability, governing law (Vietnam), explicit "not legal
advice" notice, removal-request path. PrivacyPolicy now includes per-storage
table and PAT lifecycle steps.

Added Vietnamese translations for all six policy / community docs under
docs/i18n/vi/ plus a top-level README.vi.md. Each VI file notes that the English
version is the controlling text for legal interpretation.

About page: new "Legal & policies" Card listing Disclaimer, EULA, ToS, Privacy,
Code of Conduct, Security, License (MIT), and Changelog with a pointer to the
Vietnamese translations. New LegalLink interface + LEGAL_LINKS const in
webapp/src/lib/about.ts following the THIRD_PARTY/SOCIAL_LINKS pattern.

Optional UI:
- Tauri desktop: maximize button disabled (maximizable: false in
  tauri.conf.json). Window remains resizable.
- DataTable: scrollbar hidden via new .scrollbar-hide Tailwind utility added to
  webapp/src/index.css; scrolling still works.

Bookkeeping: README badge bumped to 3.1.4 + Vietnamese language badge + pointer
to README.vi.md and docs/i18n/vi/. CHANGELOG entry for 3.1.4.

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-05 11:55:18 +07:00
poli0981andClaude Opus 4.7 9cdd900dba release(v3.1.3): credit Claude Code as AI co-author alongside Grok (#37)
- About page: new "AI co-authors" Card listing Grok (xAI) and Claude Code
  (Anthropic, Claude Opus 4.7, 1M context) with vendor + model badges and
  the role each played in the repo (Grok: Python pipeline + v2.0.0;
  Claude Code: v3.0.0 webapp/Tauri + v3.1.2 fixes).
- AiTool interface + AI_TOOLS const in webapp/src/lib/about.ts so the AI
  credit follows the same structured pattern as THIRD_PARTY and
  SOCIAL_LINKS.
- ACKNOWLEDGEMENTS, My_Stuff, CONTRIBUTING surface Claude Code alongside
  Grok wherever the existing AI credit lived. My_Stuff "The Real MVP" is
  now plural; DEV.blurb mentions both buddies.
- Bump README badge to 3.1.3 + CHANGELOG entry.

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-05 11:07:17 +07:00
poli0981andClaude Opus 4.7 b90f707ae4 release(v3.1.2): fix Tauri offline links, expand About, refresh docs (#35)
- Add tauri-plugin-opener (Rust + JS) so external links open via the OS
  browser on the desktop app. Capability scoped to opener:allow-open-url
  for https://* only.
- New <ExtLink> component (webapp/src/components/ext-link.tsx) used app-wide
  so the offline link bug can't recur.
- About page: new Developer card, Found-a-bug CTA, and Find-me-elsewhere
  social grid (X, YouTube, 2x Discord, Patreon, Ko-fi, Steam, Bluesky,
  Mastodon).
- Rewrite webapp/README.md from Vite boilerplate to actual webapp docs;
  refresh CONTRIBUTING.md, docs/ACKNOWLEDGEMENTS.md, docs/My_Stuff.md, and
  README.md with the new contact handles.
- Bump version badge to 3.1.2 + CHANGELOG entry.

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-05 10:43:19 +07:00
github-actions[bot] e25848e8ec Update game tables [2026-05-05] 2026-05-05 02:13:13 +00:00
github-actions[bot] 16d3db7c58 Update game info [2026-05-05] 2026-05-05 02:13:01 +00:00
poli0981 0d9781273c chore(webapp): queue 2 new URLs 2026-05-05 09:12:39 +07:00
github-actions[bot] c92150fb0a Update game tables [2026-05-04] 2026-05-04 22:36:50 +00:00
github-actions[bot] 13cc476a1e Update game info [2026-05-04] 2026-05-04 22:36:38 +00:00
poli0981 fdc771d7c3 Merge pull request #34 from poli0981/docs/claude-md
docs: add CLAUDE.md (repo notes for future Claude sessions)
2026-05-05 04:29:29 +07:00
poli0981andClaude Opus 4.7 cbcbaffd13 Add CLAUDE.md: repo notes for future Claude sessions
Captures the context that's expensive to re-derive every time:
- Layer split (Python pipeline vs webapp vs Tauri).
- Local dev commands and Vite alias / output paths.
- Code-split layout and webapp folder map.
- Which 3 of the 23 game fields are user-editable.
- All 7 GitHub Actions workflows with triggers and purposes.
- Release / tag procedure (signed tags from main only).
- Correct fine-grained PAT permissions (Actions:write, NOT
  workflow:write).
- Ten gotchas that each cost us a release to learn:
  universal-apple-darwin + bundle_dmg.sh, macos-13 retirement, Tauri
  icons must exist, .pkg via pkgbuild, Vite v8 base option, TS 6
  baseUrl deprecation, lucide v1 brand icon removal, base64 newlines
  on contents API, workflow_dispatch returns 204, docs/app/ is
  gitignored.
- Safe-edit rules and the current trunk state.

Lives at the repo root so any tool that auto-loads CLAUDE.md picks
it up.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-05 04:27:57 +07:00
poli0981 b8f9d70f82 Merge pull request #33 from poli0981/fix/v3.1.1
fix(ci): cross-compile macOS x86_64 from Apple Silicon (macos-13 retired)
2026-05-05 04:14:28 +07:00
poli0981andClaude Opus 4.7 465ce02242 fix(ci): cross-compile macOS x86_64 from Apple Silicon runner
The macos-13 job in v3.1.0's release run sat in 'queued' forever and
GitHub auto-cancelled it (runner_name was null in the run output).
GitHub retired macos-13 from free-tier hosted runners in late 2024;
new jobs requesting that label never get picked up.

Switched the Intel matrix entry to also run on macos-latest (Apple
Silicon) and cross-compile to x86_64-apple-darwin. The same toolchain
step already drives `rustup target add ...` from matrix.tauri_target,
and Xcode CLI tools on macos-latest carry both SDKs, so no extra
setup is needed.

The DMG bundler packages a single-arch x86_64 binary on an aarch64
host — bundle_dmg.sh doesn't execute the binary, only stages it into
a disk image, so cross-compile doesn't reintroduce the
universal-apple-darwin failure that v3.1.0 fixed by going per-arch.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-05 04:13:43 +07:00
poli0981 41bfed83f1 Merge pull request #32 from poli0981/fix/v3.1.0
v3.1.0: macOS DMG fix + .pkg installer + table pagination
2026-05-05 03:52:12 +07:00
poli0981andClaude Opus 4.7 3d85d76530 v3.1.0: per-arch macOS builds + .pkg installer + table pagination
## macOS DMG bundling

Universal target (lipo'd ARM + Intel) tripped bundle_dmg.sh on the
universal-apple-darwin run — a known fragility around AppleScript +
hdiutil + the universal binary in headless CI.

Switched the matrix to two native macOS targets:
- macos-latest (Apple Silicon) → aarch64-apple-darwin
- macos-13 (Intel) → x86_64-apple-darwin

Each runs DMG bundling against its own native binary instead of a
universal lipo, which avoids the failure mode altogether. fail-fast
is already off so a flake on one arch doesn't kill the other.

## .pkg installer (requested)

Tauri's bundler doesn't emit .pkg, so added a follow-on step that
runs pkgbuild (preinstalled on macOS runners) against the .app
produced by tauri-action and uploads it to the same draft release.

The step is gated on if: always() so even if the DMG layer fails on
some future runner image, the .pkg still ships — pkgbuild only needs
the .app, which is built before DMG packaging.

Output naming: {AppName}_{version}_{aarch64|x86_64}.pkg.

## Games table pagination

Added DataTablePagination footer (rows-per-page selector +
First/Prev/Next/Last) under the table. Page sizes 50/100/200/500;
default 100. Pagination state is lifted into Games route so toolbar
counts ('filtered of total') and bulk-action selection survive
filter/sort/page changes.

Virtualization is still in place inside each page so a 500-row page
doesn't blow render perf.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-05 03:51:04 +07:00
github-actions[bot] fc4ccff399 Update game tables [2026-05-04] 2026-05-04 07:28:24 +00:00
github-actions[bot] 26f87b4d70 Update game info [2026-05-04] 2026-05-04 07:28:15 +00:00
github-actions[bot] a9400920a9 Update game tables [2026-05-04] 2026-05-04 07:23:53 +00:00
github-actions[bot] ee9a355869 Update game info [2026-05-04] 2026-05-04 07:23:41 +00:00
poli0981 c41dc6bd3c Merge pull request #31 from poli0981/fix/v3.0.1
fix(v3.0.1): generate Tauri icons + correct fine-grained PAT permission hint
2026-05-04 14:23:03 +07:00
poli0981andClaude Opus 4.7 9892c923b9 Fix Tauri icons + clarify fine-grained PAT permissions
Two release-blocking fixes for v3.0.0.

## Tauri build was failing on every platform

tauri.conf.json referenced icons/32x32.png, icons/128x128.png,
icons/128x128@2x.png, icons/icon.icns, icons/icon.ico — none of which
existed. release_desktop.yml therefore failed at the bundle step on
all three runners.

Generated a 1024×1024 placeholder source PNG (blue panel + white "I"
glyph for Itch.io) and ran `tauri icon` to populate src-tauri/icons/
with the full standard set: the 5 desktop assets the conf needs, plus
the Windows Store / iOS / Android sizes Tauri's CLI emits by default
(harmless to ship; useful if the project ever targets mobile).

The 1024×1024 source itself is added to src-tauri/.gitignore — only
the generated icons are committed. Replacing the placeholder later is
just `npm run tauri icon -- path/to/new-source.png` + commit.

## Fine-grained PAT was getting 403 on workflow_dispatch

Settings page hint told users to give the PAT contents:write +
workflow:write. workflow:write controls editing .github/workflows/*.yml
files (which the webapp doesn't do); the actual call we make,
POST /actions/workflows/{file}/dispatches, requires Actions: Write
instead. Fine-grained PATs created from that hint hit 403; classic
PATs worked because the classic `workflow` scope happens to cover
both.

Rewrote the hint as a checklist:
  - Contents: Read and write (edits / deletes / queueing URLs)
  - Actions: Read and write (dispatching the scraper workflow)
plus a note that classic `workflow` tokens still work but grant
broader access.

SECURITY.md was already correct on this from the v3.0.0 docs pass.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-04 14:21:52 +07:00
github-actions[bot] e622fdf3b3 Update game tables [2026-05-04] 2026-05-04 06:44:09 +00:00
github-actions[bot] 07d7b72096 Update game info [2026-05-04] 2026-05-04 06:43:50 +00:00
poli0981 bf0f09e437 chore(webapp): queue 1 new URLs 2026-05-04 13:42:23 +07:00
poli0981 d9099f784e chore(webapp): queue 1 new URLs 2026-05-04 13:42:12 +07:00
poli0981 7b4cff9bec chore(webapp): queue 1 new URLs 2026-05-04 13:35:37 +07:00
poli0981 cbdaea3335 Merge pull request #30 from poli0981/docs/v3-cleanup
docs: update CONTRIBUTING/SECURITY/PrivacyPolicy for v3.0.0
2026-05-04 10:26:02 +07:00
poli0981andClaude Opus 4.7 f427308905 Update CONTRIBUTING / SECURITY / PrivacyPolicy for v3.0.0
- CONTRIBUTING.md gains a section 8 covering webapp/Tauri local dev
  commands and a few house rules (don't commit dist/, update
  about.ts when adding deps).
- SECURITY.md is no longer "we don't even have user data" because the
  webapp can hold a GitHub PAT. Adds a PAT-handling section explaining
  the AES-GCM/PBKDF2 storage, the recommended fine-grained scopes,
  and what NOT to do (classic PATs, shared kiosks). Adds a brief note
  about npm / Rust crate vulnerability reporting.
- PrivacyPolicy.md was technically inaccurate ("we collect None") now
  that the webapp persists prefs and an encrypted PAT in localStorage.
  Adds a table of every localStorage key the webapp writes, the two
  GitHub endpoints it talks to, and the extra itch.io endpoints the
  Tauri build hits. Still: no cookies, no tracking, no analytics, no
  third-party scripts.
- All three "Last updated" lines bumped to 2026-05-04.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-04 10:25:16 +07:00
poli0981 487d2e71cd Merge pull request #29 from poli0981/feature/webapp
Add webapp (React + TS + Tauri 2) with 13-phase rollout
2026-05-04 09:44:37 +07:00
poli0981andClaude Opus 4.7 224fa16fae Update README and CHANGELOG for v3.0.0 (webapp + desktop)
README:
- Bump version badge 2.0.0 → 3.0.0
- New 'Webapp' section between 'Browse by genre' and 'How it works'
  with web/desktop deploy notes, auth model, and local dev commands
- Project structure + Automation table extended with webapp/ folder,
  deploy_webapp.yml, release_desktop.yml, and the new url input on
  update.yml

CHANGELOG:
- v3.0.0 entry summarizing the 17-commit rollout: 8 routes, PAT
  encryption, Git Data API bulk ops + undo, workflow dispatch from UI,
  sync button, collapsible sidebar, dark mode, About page, Tauri 2
  desktop wrapper, two new CI workflows
- Notes that the Python pipeline is unchanged except for the optional
  INPUT_URL pass-through (backwards compatible with the daily cron)

Tag and signed release left for after merge to main — tagging from a
feature branch would force-move on rebase.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-04 09:32:19 +07:00
poli0981andClaude Opus 4.7 8602e882fb Add About route with third-party license attribution
A user-visible attribution page is required by the MIT/Apache/ISC
licenses we redistribute (especially when shipping the Tauri installer)
and is also a nice place to surface app version + build date + repo
link without cluttering Settings.

- lib/about.ts: APP info + curated THIRD_PARTY[] with name, version,
  SPDX license, project URL, and a category (core / ui / data /
  desktop). UPSTREAM_DATA carries the itch.io attribution note.
- vite.config.ts: defines __BUILD_DATE__ at compile time so the page
  shows when the bundle was produced (YYYY-MM-DD, no full timestamp
  to keep builds reproducible across the same day).
- routes/about.tsx: lazy-loaded route. Sections by category, each
  entry links to its homepage (Octicon + external-link arrow) and
  shows version + license badge. Upstream-data card carries the
  itch.io attribution + 'metadata remains property of devs' note.
- Sidebar nav gains an Info icon entry pointing to /about (after
  Settings) so it's discoverable.

This is a snapshot, not auto-extracted from package.json — keeps the
list curated (e.g., grouping Radix as one entry) and avoids a build
plugin. When deps change, edit lib/about.ts; the file is small.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-04 09:30:29 +07:00
poli0981andClaude Opus 4.7 7952d244ed Add collapsible sidebar (hamburger toggle, rail mode)
Sidebar can now collapse from 240 px to 56 px so the data tables and
charts can use the full width on narrower screens. Choice persists
across reloads.

- stores/prefs.ts: small Zustand + persist store (webapp.prefs key)
  for app-level preferences. Currently just sidebarCollapsed; future
  prefs land here too instead of one-store-per-pref.
- Sidebar:
  - PanelLeftClose / PanelLeft icon button toggles state.
  - Collapsed: width 56 px, nav items become 40x40 icon buttons with
    title attribute as tooltip, Tauri/repo labels hidden, sync + theme
    + auth indicator stack vertically at the bottom.
  - Expanded: original layout intact.
  - Width transition is animated (150 ms) so the layout doesn't snap.
- ThemeToggle gains a showLabel prop; sidebar passes false in
  collapsed mode so the bottom rail stays icon-only.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-04 09:28:52 +07:00
poli0981andClaude Opus 4.7 3fdd425f6c Add sync button in sidebar header
Manual refresh for users who don't want to wait for the 5-min stale
window. Shows a spinning RefreshCw while any ['db'] query is in flight.

Sync invalidates ['db'] + ['deleted'] always; when a PAT is unlocked
it also invalidates ['workflows']. The toast text differs so the user
knows whether they hit the CDN (no auth, ~5 min CDN cache) or the
authenticated API path.

Lives in the sidebar header next to the auth indicator so it's always
in reach without taking screen real estate from the nav.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-04 09:27:04 +07:00
poli0981andClaude Opus 4.7 91afd4ecf9 Add webapp Phase 8: Tauri 2 desktop wrapper scaffold
The same React build can now ship as a native Win/macOS/Linux app via
Tauri 2. Web users still get the GitHub Pages SPA; desktop users get
a ~10 MB installer that can scrape itch.io directly without CORS.

src-tauri/:
- Cargo.toml: tauri 2 + tauri-plugin-http 2, edition 2021. Release
  profile uses panic=abort, lto=true, opt-level='s', strip — minimizes
  the bundled binary.
- tauri.conf.json: window 1280x800 (min 900x600), bundle targets all
  platforms, identifier com.poli0981.free-games-itchio-webapp.
- src/main.rs + src/lib.rs: minimal builder + one Tauri command
  (runtime_info) so the frontend can confirm desktop mode.
- capabilities/default.json: scopes the http plugin to itch.io,
  img.itch.zone, api.github.com, raw.githubusercontent.com.

Frontend plumbing:
- lib/runtime.ts: isTauri() probes window.__TAURI_INTERNALS__ to
  branch features at runtime. getRuntimeInfo() lazy-imports
  @tauri-apps/api/core only on desktop, so web bundles aren't bloated.
- lib/tauri-scrape.ts: tauriScrapePreview(url) uses the http plugin to
  fetch an itch.io page and pulls og:title / og:description / og:image
  out of the HTML. Full 23-field extraction stays in scripts/scraper.py
  and runs in CI; porting to Rust is tracked as Phase 8b in TAURI.md.
- Sidebar gains a small "Desktop mode (Tauri)" badge above the theme
  toggle when running native.
- vite.config.ts: when TAURI_ENV_PLATFORM is set, build to ./dist (not
  ../docs/app), drop sourcemaps, and target ES2022 — the bundled
  WebView2/WKWebView/WebKitGTK all support modern JS.
- package.json scripts: tauri / tauri:dev / tauri:build.

CI:
- .github/workflows/release_desktop.yml: builds for macOS (universal),
  Ubuntu 22.04, and Windows on tag v* via tauri-apps/tauri-action,
  caches cargo with Swatinem/rust-cache, installs Linux WebKit deps,
  and uploads the bundle to a draft GitHub Release.

Docs:
- webapp/TAURI.md: prereqs (rustup + platform deps), how to dev, how
  to build installers, how to add new Rust commands, roadmap to a
  full Rust scrape (Phase 8b).

.gitignore picks up the Cargo target/, generated gen/, and Cargo.lock
under src-tauri.

Note: Local `npm run tauri:dev` requires a Rust toolchain
(https://rustup.rs); the GitHub Actions workflow installs it
automatically. The web build still works without Rust installed.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-04 09:00:37 +07:00
poli0981andClaude Opus 4.7 d89955013e Add webapp Phase 5: bulk edit / delete via Git Data API + undo
Phase 2b can change one game per HTTP round-trip; touching 50 games
that way would be 50 commits and likely trip GitHub's secondary rate
limit. This wires up an atomic multi-file commit through the Git Data
API plus row-selection in the DataTable plus an undo stack.

- lib/github/git-data.ts: atomicCommit wraps the
  refs → commits → tree → blobs → tree → commit → updateRef dance into
  one call. FileChange.content === null translates to a tree entry
  with sha:null which deletes the path.
  bulkUpdateGames: applies edits in memory, rebalances the chunk plan,
  diffs which chunks changed, and writes only those.
  bulkDeleteGames: removes the records, rebalances, deletes any
  trailing chunks that became empty after the rebalance, and appends
  to scripts/deleted_games.json — all in one commit.

- DataTable now supports row selection (TanStack Table state passed
  through), keyed by game.url so the selection survives sort/filter
  changes. A new 'select' column with header + per-row Checkbox.

- Bulk dialogs:
  - BulkEditDialog: opt-in toggles per editable field (safe_virus,
    nsfw, notes) so untoggled fields are left untouched. Builds
    'previous' patches to push onto the undo stack before committing.
  - BulkDeleteDialog: type 'delete N' to confirm, choose a reason
    (Manual cleanup / Quality issue / Duplicate / Other), preview the
    list (truncated at 50). On success, the reverse op restores the
    full records via atomicCommit.

- stores/undo.ts: 20-entry FIFO of UndoEntry { id, label, reverse }.
  UndoTray (rendered above the DataTable) shows the latest 3 with an
  Undo button each; older entries fall off when capacity is exceeded.

Initial bundle stays at ~535 KB (163 KB gzip) thanks to Phase 6b
splitting; the bulk dialogs ride in vendor-ui + a tiny route delta.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-04 08:57:08 +07:00
poli0981andClaude Opus 4.7 9e92e8f318 Add webapp Phase 6b: code-split routes + vendor chunks
The single 1.03 MB chunk warned by Vite is gone. Initial paint downloads
~157 KB gzip; the rest streams in only when needed.

- App.tsx wraps the four route trees that pull in heavy deps in
  React.lazy + Suspense:
  - /charts (Recharts ~380 KB)
  - /add, /workflows, /settings, edit form (Octokit ~100 KB)
  - /games/:slug (the detail view that imports the edit form)
- vite.config.ts adds rollupOptions.manualChunks splitting node_modules
  into vendor-react / vendor-query / vendor-ui / vendor-charts /
  vendor-github so updating one library doesn't bust the cache for
  the others.

After the change:
  initial:   index 59 K + react 242 K + query 99 K + ui 112 K = ~512 K
             (~157 K gzip)
  on /charts: + vendor-charts 381 K (111 K gzip)
  on edit:    + vendor-github 102 K (20 K gzip)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-04 08:53:33 +07:00
poli0981andClaude Opus 4.7 52b8e31d33 Add webapp Phase 3: workflow dispatch (single + bulk URL → CI)
Wires the webapp's Add route and Workflows route to GitHub Actions so
non-technical users can extend the catalog without editing temp_link.json
or waiting for the 03:00 UTC cron.

CI changes (backwards-compatible — daily cron still works exactly the
same):
- update.yml gains an optional 'url' input on workflow_dispatch and
  forwards it to the bash step as INPUT_URL.
- update_info.py reads INPUT_URL at the top of main() and appends it
  to the new_links list (deduplicated). When INPUT_URL is empty AND
  temp_link.json is empty, the script now exits cleanly instead of
  raising on the missing file.

Frontend:
- lib/github/workflow.ts: dispatchWorkflow / listWorkflowRuns /
  getWorkflowRun. Plus findRecentDispatchedRun because
  createWorkflowDispatch returns 204 with no run id, so we have to
  back-fill by listing recent runs filtered by event=workflow_dispatch
  and the dispatch timestamp.
- hooks/useWorkflows.ts: TanStack Query wrapper with refetchInterval
  that drops to 5s while any run is queued/in_progress, then relaxes
  to 30s.
- routes/add.tsx: two tabs (Single / Bulk).
  - Single: validates against URL_REGEX and the in-cache duplicate set,
    then dispatch with inputs.url and poll every 5s up to 5min. On
    success → invalidate ['db'] so the new game shows up everywhere.
  - Bulk: parses whitespace-separated URLs, validates+dedupes, PUTs
    them to scripts/temp_link.json in one commit (using putFile from
    Phase 2b), then dispatches without inputs so the workflow consumes
    the queue.
- routes/workflows.tsx: tab per workflow (5 of them) with Dispatch +
  Refresh buttons and the last 10 runs (status badge, run number,
  display title, event, timestamp, link to GitHub).

Bundle 1.03 MB / 298 KB gzip.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-04 08:14:35 +07:00
poli0981andClaude Opus 4.7 e335da0632 Add webapp Phase 2b: edit annotations and PUT chunk via GitHub API
The Edit button on the Game Detail page now opens a real form for the
three user-editable fields. Save round-trips through the GitHub
Contents API and shows up as a normal commit on main.

- lib/github/contents.ts:
  - readFileWithSha: GET contents (not raw CDN — we need the sha for
    the optimistic-concurrency check on PUT) and base64-decode.
  - putFile: PUT createOrUpdateFileContents with utf-8 → base64. Returns
    the new commit sha.
  - updateGameInChunk: locates the right chunk via the same
    rebalance() formula data_store.py uses, refetches that chunk fresh
    so we never overwrite with a stale view, replaces the matching url
    record with merged edits, and PUTs back. If the game disappeared
    remotely (e.g., check_alive workflow killed it), we surface that
    instead of silently re-adding it.
- components/edit-game-form.tsx: Select for safe_virus (?, Yes, No,
  Caution), Switch for nsfw, Textarea for notes (500-char counter that
  turns red over the cap). Save is disabled when not dirty, when busy,
  or when no PAT is unlocked. 409 → "Conflict, refresh and re-edit"
  toast; everything else surfaces the original error.
- game-detail.tsx: Edit button toggles the form above the read-only
  cards; the Save handler invalidates ['db'] so the new value flows
  back through TanStack Query without a manual refetch.

Adds shadcn Select and Switch primitives. Bundle 1.02 MB / 295 KB
gzip — code-splitting deferred to a polish pass.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-04 08:11:56 +07:00
poli0981andClaude Opus 4.7 f78c9c6105 Add webapp Phase 2a: encrypted PAT storage + Settings auth
Reads from Phase 1 used the public CDN; writes need a Personal Access
Token. Settings is now a working PAT manager. The token never goes to
disk in plaintext.

Encryption (lib/crypto.ts):
- AES-GCM 256-bit, with the key derived from the user's passphrase via
  PBKDF2-SHA256 (100k iterations) and a per-token random salt.
- Each ciphertext packs salt(16) || iv(12) || gcm-blob, base64-encoded
  in localStorage under webapp.pat.encrypted.
- Required Uint8Array<ArrayBuffer> annotation because TS 6 narrows the
  generic and Web Crypto rejects Uint8Array<ArrayBufferLike>.

Auth state (stores/auth.ts):
- Decrypted PAT is held only in the Zustand store (in memory). lock()
  drops it; clearEncryptedPat() also removes the localStorage entry.
- hasStoredPat exposed so the UI can show a Locked badge before unlock.
- IDLE_TIMEOUT_MS=30min reserved for an idle-lock effect (deferred to
  the next polish pass).

Settings page (routes/settings.tsx) covers all three states:
- No saved PAT: paste token + passphrase → fetch the GitHub user to
  validate scopes → encrypt → store → unlock.
- Saved+locked: passphrase → decrypt → validate user → unlock.
- Unlocked: 'Test repo access' (HEAD on the repo), Lock, and Remove
  saved PAT (with confirm). Sonner toasts surface every outcome.

Octokit factory (lib/github/client.ts):
- createOctokit() throws if not unlocked so callers get an explicit
  error instead of a silent 401 later.
- fetchAuthenticatedUser / checkRepoAccess take the PAT directly so
  Settings can validate before persisting.

Sidebar header gains a small status indicator: avatar when unlocked,
yellow dot for saved-but-locked, dim dot for none.

Bundle 994 KB / 287 KB gzip (Octokit adds ~100 KB).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-04 08:10:02 +07:00
poli0981andClaude Opus 4.7 cdfd8d3595 Add deploy_webapp.yml: build webapp/ to GitHub Pages
When webapp/ or this workflow changes on main, build the Vite app and
publish docs/app/ via the official GitHub Pages actions. Manual run via
workflow_dispatch is supported for backfill or first-time setup.

Pipeline:
  checkout → setup-node@v6 (Node 22, npm cache keyed on
  webapp/package-lock.json) → npm ci → npm run build → configure-pages →
  upload-pages-artifact (docs/app/) → deploy-pages.

Permissions limited to contents:read, pages:write, id-token:write
(required for the OIDC token deploy-pages uses). Concurrency group
'pages' with cancel-in-progress:false so two pushes in quick succession
both publish in order rather than dropping the earlier one.

One-time setup the repo owner needs to do: GitHub repo Settings → Pages
→ Source = 'GitHub Actions'. After that, every push to main that
touches webapp/ ships automatically.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-04 08:07:02 +07:00
poli0981andClaude Opus 4.7 ab03edb211 Add webapp Phase 6a: dark mode (light / dark / system)
A bottom-of-sidebar toggle cycles theme: Light → Dark → System → Light.
The system option follows prefers-color-scheme and updates live when
the OS theme changes. Choice persists across reloads via localStorage.

- stores/theme.ts: Zustand + persist middleware (key webapp.theme).
- hooks/useThemeEffect.ts: applies/removes the .dark class on <html>
  and subscribes to (prefers-color-scheme: dark) only while in system
  mode (cleaned up on switch to a fixed theme).
- components/theme-toggle.tsx: cycles the three themes; tooltip shows
  the current state.
- App.tsx mounts the effect once at the layout level.
- Sidebar bottom now has the toggle + the repo link.

The shadcn CSS variables for .dark were already in index.css since
Phase 0, so every primitive themes for free.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-04 08:06:10 +07:00
poli0981andClaude Opus 4.7 80a01e0079 Add webapp Phase 4: 9 Recharts charts in tabbed Charts route
The Charts route is no longer a placeholder. Four tabs (Overview, Reach,
Quality, Discovery) host 9 charts driven by the live in-memory dataset:

- Overview: Genre top-15 horizontal bar, Status pie, Online vs Offline
  donut, Game Engines (made_with[0]) donut.
- Reach: Platform donut (counted per game so a multi-platform title is
  reflected on each), Top-10 Languages bar, Avg Session bar, Recent
  Deletions list.
- Quality: Rating histogram (10 bins from 0-5), Recent Deletions.
- Discovery: Top-30 Tags rendered as a sized text cloud (font scales to
  the most-tagged item) — substitutes for an ECharts wordCloud so we
  avoid a ~600 KB ECharts dep on the initial bundle.

New analytics: classifyOnline, topMadeWith. Existing countBy /
countByArray / ratingHistogram are reused.

Adds shadcn Tabs primitive. Bundle 879 KB / 262 KB gzip (Recharts adds
~390 KB) — Vite warns about chunks > 500 KB; code-splitting for charts
is deferred to a polish pass.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-04 08:04:43 +07:00
poli0981andClaude Opus 4.7 282b2a6599 Add webapp Phase 1c: read-only Game Detail view (23 fields)
Click any row in the Games table → /games/:slug. The detail page lays out
all 23 fields a scraper produces, grouped into three cards so the
manually-curated annotations (safe_virus, notes, nsfw) are visually
separated from the auto-fetched ones.

- useGameBySlug hook: looks up the in-memory game by slug(url) without
  refetching (reuses the cached useAllGames query).
- Detail layout:
  - Hero card: thumbnail (left), name + status + NSFW badges + dev +
    description + 'Open on itch.io' button.
  - Metadata card: genre, publisher, release_date, rating (with review
    count), avg session, nsfw.
  - Tech & Reach card: platforms, languages, inputs, made_with, tags.
  - Manual Annotations card: safe_virus, nsfw override, notes — clearly
    labeled as the three fields that will become editable in Phase 2.
- Edit button is rendered but disabled with title='Phase 2' so users
  see the affordance now and aren't confused later.
- Loading/error/not-found states all handled.

Adds shadcn Separator. Bundle 491 KB / 150 KB gzip.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-04 07:44:04 +07:00
poli0981andClaude Opus 4.7 db86ab9ebb Add webapp Phase 1b: virtualized DataTable with faceted filters
Replace the Phase 1a card list with a real data grid so users can browse
all 514 games (and any future growth) without choking the DOM.

- TanStack Table v8 for sorting, filtering, column model.
- TanStack Virtual for windowed row rendering (overscan 8, ~56px rows) so
  only viewport rows are mounted; sticky header stays during scroll.
- Multi-column sort with shift-click; numeric sort on rating parses to
  float so '5.0' beats '4.9' instead of lexicographic 4 > 5.
- Faceted multi-select filters built on Radix Popover + Checkbox with
  per-option counts (Genre, Status, Platforms, NSFW). The column filter
  uses a custom arrayIncludesAny matcher so it works on both scalar
  (genre, status) and array fields (platforms).
- Toolbar: global search across name/dev/description/url + filter chips
  + a Reset button that appears only when something is filtered.
- Showing "<filtered> of <total>" header so the count is meaningful even
  when filters are active.

Adds shadcn primitives Popover, Checkbox. Bundle now 484 KB / 148 KB gzip
(up from 349 KB on Phase 1a, mostly TanStack Table + Virtual).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-04 07:42:53 +07:00
poli0981andClaude Opus 4.7 19fc2acab5 Add webapp Phase 1a: data layer + live KPI dashboard
Wire the webapp to the live dataset on raw.githubusercontent.com so users see
real numbers instead of placeholders. No write paths yet — read-only browse.

- lib/config.ts: repo constants (poli0981/free-games-itchio-list@main) and
  paths to data_game/index.json, chunk filenames, scripts/deleted_games.json,
  scripts/temp_link.json. MAX_PER_FILE=500 mirrors data_store.py.
- lib/github/raw.ts: typed fetch helper hitting raw.githubusercontent.com so
  reads don't burn the user's 60/hr unauthenticated GitHub API quota.
- lib/github/data-store.ts: TS port of scripts/data_store.py — loadIndex,
  loadChunk, loadAllGames, loadDeletedLog, plus rebalance/findChunkFor/
  indexByUrl utilities used later by edit + delete flows.
- hooks/useGames.ts: TanStack Query wrappers (useIndex, useAllGames,
  useDeletedGames) with the global 5-min staleTime from main.tsx.
- lib/analytics.ts: memoizable aggregations — countBy / countByArray for
  scalar and array fields, computeOverview (total / NSFW% / online% / top
  genre), ratingHistogram. Foundation for the 12 charts in Phase 4.

UI:
- Dashboard: 4 KPI cards (Total, NSFW%, Online%, Top Genre) + Database Files
  + Deletion Log count, all driven by the live index/chunks.
- Games: search by name/dev/description + genre filter, first 100 rendered
  as cards with thumbnail, tags, platforms, NSFW badge, rating. Full
  virtualization comes in Phase 1b.
- Deleted: tombstone log sorted by deleted_at desc with reason badge and
  external link to the original itch.io page.

Adds shadcn primitives Input, Badge, Skeleton.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-04 07:40:05 +07:00
poli0981andClaude Opus 4.7 a66b0c2589 Add webapp Phase 0: Vite + React + TS + shadcn scaffold
Bootstrap webapp/ subfolder with React 19 + TypeScript 6 + Vite 5 + Tailwind v3,
shadcn/ui base primitives (Button, Card), HashRouter + TanStack Query provider,
Sonner Toaster, sidebar nav with 8 routes (Dashboard, Games, Game Detail, Add,
Charts, Workflows, Deleted, Settings) + 404 fallback. All routes are skeleton
stubs ready for live data wiring in Phase 1+.

Vite config: base './' for relative asset paths, outputs to docs/app/ for
GitHub Pages deploy. Path alias @/* -> ./src/*.

Game type schema (23 fields) defined in types/game.ts. Slugify + formatNumber
helpers in lib/utils.ts.

docs/app/ added to root .gitignore — built output not committed; CI deploy
workflow will produce it (Phase 7).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-04 07:39:06 +07:00
github-actions[bot] 2cc8671c55 Remove dead game links [2026-05-03] 2026-05-03 08:04:19 +00:00
github-actions[bot] 2ea1a6f7a6 Update deleted games log [2026-05-03] 2026-05-03 05:56:49 +00:00
github-actions[bot] 231bb66047 Remove paid games [2026-05-03] 2026-05-03 05:56:34 +00:00
github-actions[bot] 2cba41b06b Update game tables [2026-05-01] 2026-05-01 08:14:09 +00:00
github-actions[bot] 9d23008ddd Remove dead game links [2026-05-01] 2026-05-01 08:14:00 +00:00
github-actions[bot] e33864afef Update deleted games log [2026-05-01] 2026-05-01 06:06:01 +00:00
github-actions[bot] 114590cc7b Remove paid games [2026-05-01] 2026-05-01 06:05:51 +00:00
github-actions[bot] bade741535 Remove dead game links [2026-04-29] 2026-04-29 08:10:21 +00:00
github-actions[bot] 69efcc555d Update deleted games log [2026-04-29] 2026-04-29 05:54:23 +00:00
github-actions[bot] b45a900147 Remove paid games [2026-04-29] 2026-04-29 05:54:12 +00:00
github-actions[bot] a2d7bb355b Update game tables [2026-04-27] 2026-04-27 08:16:14 +00:00
github-actions[bot] 2d6a4034d8 Remove dead game links [2026-04-27] 2026-04-27 08:16:01 +00:00
github-actions[bot] d7b7522696 Update deleted games log [2026-04-27] 2026-04-27 05:53:49 +00:00
github-actions[bot] a14203a044 Remove paid games [2026-04-27] 2026-04-27 05:53:38 +00:00
github-actions[bot] ad6b41629d Update game tables [2026-04-25] 2026-04-25 07:58:20 +00:00
github-actions[bot] fcab381a84 Remove dead game links [2026-04-25] 2026-04-25 07:58:09 +00:00
github-actions[bot] b76bb4f1c0 Update deleted games log [2026-04-25] 2026-04-25 05:39:51 +00:00
github-actions[bot] cc70e5dc83 Remove paid games [2026-04-25] 2026-04-25 05:39:40 +00:00
github-actions[bot] e04d5bc2e4 Update game tables [2026-04-24] 2026-04-24 04:05:16 +00:00
itch-f2p-ext[bot] 6a61f386fe ext: add 20 game(s) to game_info [2026-04-24] 2026-04-24 03:08:33 +00:00
github-actions[bot] a85bbcd6e5 Update game tables [2026-04-23] 2026-04-23 08:01:43 +00:00
github-actions[bot] 8805ca77eb Remove dead game links [2026-04-23] 2026-04-23 08:01:31 +00:00
itch-f2p-ext[bot] 02573e0713 ext: add 1 game(s) to game_info [2026-04-23] 2026-04-23 06:49:23 +00:00
itch-f2p-ext[bot] 577ec17473 ext: add 31 game(s) to game_info [2026-04-23] 2026-04-23 06:45:36 +00:00
github-actions[bot] 0fae61073f Update deleted games log [2026-04-23] 2026-04-23 05:45:29 +00:00
github-actions[bot] 87579f9dc6 Remove paid games [2026-04-23] 2026-04-23 05:45:18 +00:00
github-actions[bot] 4f0a930baf Update game tables [2026-04-21] 2026-04-21 07:59:53 +00:00
github-actions[bot] 20d58802aa Remove dead game links [2026-04-21] 2026-04-21 07:59:43 +00:00
github-actions[bot] 5611e81ee0 Remove paid games [2026-04-21] 2026-04-21 05:43:41 +00:00
github-actions[bot] 2f42c2621b Update game tables [2026-04-20] 2026-04-20 04:09:23 +00:00
github-actions[bot] d092b9a5da Update game info [2026-04-20] 2026-04-20 04:09:13 +00:00
itch-f2p-ext[bot] 9cfa3749bc ext: add 37 game(s) to temp_link [2026-04-19] 2026-04-19 12:29:42 +00:00
github-actions[bot] 95f95d5180 Remove dead game links [2026-04-19] 2026-04-19 07:54:32 +00:00
github-actions[bot] d0eab1b965 Remove paid games [2026-04-19] 2026-04-19 05:42:00 +00:00
github-actions[bot] 0684155431 Update game tables [2026-04-19] 2026-04-19 04:06:22 +00:00
github-actions[bot] 4f8a47f796 Update game info [2026-04-19] 2026-04-19 04:06:12 +00:00
itch-f2p-ext[bot] d4754017d0 ext: add 40 game(s) to temp_link [2026-04-18] 2026-04-18 12:03:34 +00:00
github-actions[bot] 1a542887b7 Update game tables [2026-04-18] 2026-04-18 03:57:01 +00:00
github-actions[bot] eb6f6d4eed Update deleted games log [2026-04-17] 2026-04-17 07:56:17 +00:00
github-actions[bot] 0787304e31 Remove dead game links [2026-04-17] 2026-04-17 07:56:07 +00:00
github-actions[bot] 34a34a0831 Remove paid games [2026-04-17] 2026-04-17 05:38:25 +00:00
poli0981andClaude Opus 4.6 bf30862e6b Auto-update index.json on every save_all_games() call (#28)
Add _write_index() to data_store.py that writes total_games,
max_per_file, last_updated timestamp, and per-file counts
to data_game/index.json after every data change.

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-16 22:34:13 +07:00
github-actions[bot] 692acdefad Update game tables [2026-04-16] 2026-04-16 15:12:40 +00:00
github-actions[bot] 7ddd3c01b6 Update game info [2026-04-16] 2026-04-16 15:12:26 +00:00
itch-f2p-ext[bot] 0cc105b098 ext: add 2 game(s) to temp_link [2026-04-16] 2026-04-16 14:26:16 +00:00
itch-f2p-ext[bot] a52b4a8262 ext: add 2 game(s) to game_info [2026-04-16] 2026-04-16 14:22:04 +00:00
poli0981 f6ca62dff7 Add index.json to define max entries and chunked file structure in data_game 2026-04-16 21:11:45 +07:00
github-actions[bot] 38365d4d95 Update game tables [2026-04-16] 2026-04-16 12:12:34 +00:00
github-actions[bot] cd29c25582 Update game info [2026-04-16] 2026-04-16 12:12:25 +00:00
poli0981 0ef621afcd Add game link for "Nurture Spree" to temp_link.json 2026-04-16 19:10:17 +07:00
poli0981andClaude Opus 4.6 cd56d350cc Refactor: split game data into chunked files in data_game/ (#27)
When game_info.json reaches 500 entries, data is automatically split
into numbered files (game_info_001.json, game_info_002.json, etc.).
New data_store.py module handles load/save/rebalance for all scripts.

Also removes CSV export pipeline (export_csv.py, pandas dependency)
and cleans up unused files.

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-16 12:47:03 +07:00
github-actions[bot] c2603abc26 Auto update CSV [2026-04-14] 2026-04-14 04:02:29 +00:00
github-actions[bot] 78b6adf86c Update game tables [2026-04-14] 2026-04-14 04:02:05 +00:00
github-actions[bot] a2021dd180 Update deleted games log [2026-04-13] 2026-04-13 07:57:08 +00:00
github-actions[bot] 103992abbb Remove dead game links [2026-04-13] 2026-04-13 07:56:57 +00:00
github-actions[bot] cd69f09070 Update deleted games log [2026-04-11] 2026-04-11 05:16:30 +00:00
github-actions[bot] 18c9ad68b9 Auto update CSV [2026-04-09] 2026-04-09 07:56:44 +00:00
github-actions[bot] 017a2965b4 Update game tables [2026-04-09] 2026-04-09 07:56:17 +00:00
github-actions[bot] 40401aa4d3 Remove dead game links [2026-04-09] 2026-04-09 07:56:06 +00:00
github-actions[bot] 492f059d37 Auto update CSV [2026-04-09] 2026-04-09 05:26:03 +00:00
github-actions[bot] 40540875c4 Update game tables [2026-04-09] 2026-04-09 05:25:41 +00:00
github-actions[bot] 75421b61e6 Remove paid games [2026-04-09] 2026-04-09 05:25:30 +00:00
github-actions[bot] efdfd6decc Auto update CSV [2026-04-08] 2026-04-08 03:58:52 +00:00
github-actions[bot] 62c4bb7eeb Update game tables [2026-04-08] 2026-04-08 03:58:30 +00:00
github-actions[bot] 9e5649e6b8 Update deleted games log [2026-04-07] 2026-04-07 07:54:47 +00:00
github-actions[bot] ea8ad90b47 Remove dead game links [2026-04-07] 2026-04-07 07:54:37 +00:00
github-actions[bot] c0080e5c50 Update deleted games log [2026-04-05] 2026-04-05 05:28:52 +00:00
github-actions[bot] 799a2782c6 Auto update CSV [2026-04-03] 2026-04-03 07:51:21 +00:00
github-actions[bot] 87e43ec3df Update game tables [2026-04-03] 2026-04-03 07:50:55 +00:00
github-actions[bot] 31ddd3102b Remove dead game links [2026-04-03] 2026-04-03 07:50:44 +00:00
github-actions[bot] a3faa21046 Auto update CSV [2026-04-02] 2026-04-02 03:55:55 +00:00
github-actions[bot] d26ac402ed Update game tables [2026-04-02] 2026-04-02 03:55:32 +00:00
github-actions[bot] f7c374dd6a Update deleted games log [2026-04-01] 2026-04-01 07:55:44 +00:00
github-actions[bot] eeb7b80ca3 Remove dead game links [2026-04-01] 2026-04-01 07:55:19 +00:00
github-actions[bot] afe839ac91 Remove paid games [2026-03-31] 2026-03-31 05:27:07 +00:00
github-actions[bot] 78a8ee5f41 Auto update CSV [2026-03-31] 2026-03-31 03:58:24 +00:00
github-actions[bot] 7fc368d8ac Update game tables [2026-03-31] 2026-03-31 03:58:03 +00:00
poli0981 2164154f2f Update game_info.json 2026-03-30 14:20:12 +07:00
github-actions[bot] 7157ec7f14 Auto update CSV [2026-03-30] 2026-03-30 04:02:06 +00:00
github-actions[bot] 3cdbd3700d Update game tables [2026-03-30] 2026-03-30 04:01:37 +00:00
github-actions[bot] c16049e00f Update deleted games log [2026-03-29] 2026-03-29 07:44:51 +00:00
github-actions[bot] df1a14a21b Remove dead game links [2026-03-29] 2026-03-29 07:44:40 +00:00
github-actions[bot] fbb994c442 Auto update CSV [2026-03-28] 2026-03-28 05:24:20 +00:00
github-actions[bot] 2dd4057648 Update game tables [2026-03-28] 2026-03-28 05:23:55 +00:00
poli0981 c626e0ac51 Merge remote-tracking branch 'origin/main' 2026-03-28 12:21:45 +07:00
poli0981 08e2792b85 ext: enhance genre handling and format list fields for table display 2026-03-28 12:21:29 +07:00
github-actions[bot] c4e95530c9 Update game info [2026-03-28] 2026-03-28 05:09:58 +00:00
itch-f2p-ext[bot] 036520a337 ext: add 1 game(s) to temp_link [2026-03-28] 2026-03-28 05:07:34 +00:00
github-actions[bot] 03e6d8b3e0 Update game info [2026-03-28] 2026-03-28 05:06:08 +00:00
itch-f2p-ext[bot] f28152bad7 ext: add 2 game(s) to temp_link [2026-03-28] 2026-03-28 05:05:16 +00:00
poli0981 8704ccc11e ext: enhance info parsing to support multi-value fields and improve NSFW detection 2026-03-28 12:03:16 +07:00
github-actions[bot] 5e5b454151 Update game info [2026-03-28] 2026-03-28 04:59:13 +00:00
poli0981 1d80d4a4f5 Remove 'Burn the Midnight Oil' entry from temp_link.json
Removed detailed entry for 'Burn the Midnight Oil' from the JSON list.
2026-03-28 11:58:36 +07:00
itch-f2p-ext[bot] 3792ed18b6 ext: add 2 game(s) to temp_link [2026-03-28] 2026-03-28 04:48:55 +00:00
itch-f2p-ext[bot] 6cc4dd208c ext: add 3 game(s) to game_info [2026-03-28] 2026-03-28 04:27:42 +00:00
itch-f2p-ext[bot] 672804fc5d ext: add 1 game(s) to game_info [2026-03-28] 2026-03-28 04:15:01 +00:00
poli0981 4a89f29eb5 add miss info. 2026-03-27 23:22:17 +07:00
itch-f2p-ext[bot] 98472931e5 ext: add 126 game(s) to game_info [2026-03-27] 2026-03-27 15:22:16 +00:00
itch-f2p-ext[bot] 66325f9915 ext: add 2 game(s) to game_info [2026-03-27] 2026-03-27 13:06:27 +00:00
github-actions[bot] fedf37c0fc Auto update CSV [2026-03-27] 2026-03-27 05:15:03 +00:00
github-actions[bot] 9dd3ec565e Update game tables [2026-03-27] 2026-03-27 05:14:43 +00:00
github-actions[bot] 50b4eac1f6 Remove paid games [2026-03-27] 2026-03-27 05:14:34 +00:00
itch-f2p-ext[bot] 14637a13e7 ext: add 1 game(s) to temp_link [2026-03-26] 2026-03-26 08:12:30 +00:00
itch-f2p-ext[bot] e7f461d786 ext: add 2 game(s) to game_info [2026-03-26] 2026-03-26 08:07:48 +00:00
itch-f2p-ext[bot] f40b8c36bd ext: add 1 game(s) [2026-03-26] 2026-03-26 14:44:31 +07:00
poli0981 92a1d28a3f chore: update changelog and README for version 2.0.0 release 2026-03-26 13:31:43 +07:00
github-actions[bot] 959463ccf0 Auto update CSV [2026-03-24] 2026-03-24 03:52:46 +00:00
github-actions[bot] 596053d164 Update game tables [2026-03-24] 2026-03-24 03:52:26 +00:00
github-actions[bot] b7d47782f6 Update game info [2026-03-24] 2026-03-24 03:52:16 +00:00
poli0981 3d2b87f4c2 Add 15 game link(s) [2026-03-24] via Itch Collector 2026-03-24 01:14:04 +00:00
poli0981 4234930bc3 Add 15 game link(s) [2026-03-24] via Itch Collector 2026-03-24 00:40:45 +00:00
poli0981 7dad72d3a2 Add 15 game link(s) [2026-03-24] via Itch Collector 2026-03-24 00:35:26 +00:00
poli0981 cff6cbf4bc delete 2026-03-24 06:59:55 +07:00
github-actions[bot] 4115c8c616 Auto update CSV [2026-03-22] 2026-03-22 03:50:01 +00:00
github-actions[bot] 47dc69e0ed Update game tables [2026-03-22] 2026-03-22 03:49:38 +00:00
github-actions[bot] 438e6dba19 Update deleted games log [2026-03-21] 2026-03-21 07:27:02 +00:00
github-actions[bot] 3ad6af6f45 Remove dead game links [2026-03-21] 2026-03-21 07:26:52 +00:00
github-actions[bot] 7adcb8d26c Auto update CSV [2026-03-14] 2026-03-14 03:50:11 +00:00
github-actions[bot] 12709e4fbe Update game tables [2026-03-14] 2026-03-14 03:49:48 +00:00
github-actions[bot] 0ca46c695a Update game info [2026-03-14] 2026-03-14 03:49:38 +00:00
poli0981 3857446dfa feat: enhance options UI with comboboxes for branch and path selection 2026-03-13 23:58:58 +07:00
poli0981 01a7958d24 Add 15 game link(s) [2026-03-13] via Itch Collector 2026-03-13 15:20:24 +00:00
poli0981 d3d9a895ec Add 1 game link(s) [2026-03-13] via Itch Collector 2026-03-13 21:31:06 +07:00
poli0981 d73a10e2de feat: add Itch Collector extension with GitHub integration and GPG signing support 2026-03-13 21:02:29 +07:00
poli0981 ff0f851748 Add 1 game link(s) [2026-03-13] via Itch Collector 2026-03-13 21:00:48 +07:00
poli0981 cc25ea4937 Add 2 game link(s) [2026-03-13] via Itch Collector 2026-03-13 13:57:43 +00:00
poli0981 eadacdec12 Add 3 game link(s) [2026-03-13] via Itch Collector 2026-03-13 19:57:40 +07:00
poli0981 a05b41e321 Add 2 game link(s) [2026-03-13] via Itch Collector 2026-03-13 19:28:59 +07:00
poli0981 8f186b26ef Add 12 game link(s) [2026-03-13] via Itch Collector 2026-03-13 18:50:58 +07:00
github-actions[bot] 241cff6350 Update deleted games log [2026-03-13] 2026-03-13 07:31:24 +00:00
github-actions[bot] c844e02ed5 Auto update CSV [2026-03-13] 2026-03-13 05:12:50 +00:00
github-actions[bot] 605fc06278 Update game tables [2026-03-13] 2026-03-13 05:12:25 +00:00
github-actions[bot] 74827bb870 Remove paid games [2026-03-13] 2026-03-13 05:12:16 +00:00
github-actions[bot] f63faca69f Auto update CSV [2026-03-13] 2026-03-13 04:42:53 +00:00
github-actions[bot] 1a7af6899c Update game tables [2026-03-13] 2026-03-13 04:42:30 +00:00
github-actions[bot] 3909c57db3 Update game info [2026-03-13] 2026-03-13 04:42:20 +00:00
poli0981 23ca7faea7 Add game links to temp_link.json 2026-03-13 08:58:48 +07:00
poli0981 65feda9e02 Update NSFW keywords for enhanced detection 2026-03-13 08:58:17 +07:00
github-actions[bot] d50bdb5120 Auto update CSV [2026-03-12] 2026-03-12 03:48:28 +00:00
github-actions[bot] d8b77da492 Update game info [2026-03-12] 2026-03-12 03:47:53 +00:00
poli0981 f9c732c818 Update markdown table: add more information 2026-03-11 22:51:00 +07:00
poli0981 70e3309584 Add more info about game 2026-03-11 22:50:11 +07:00
poli0981 a0001a9721 Add new scripts for checking game URLs, re-checking paid status, and logging deleted games 2026-03-11 22:48:51 +07:00
poli0981 edec208a46 Add bash scripts for checking game status, logging deleted games, and exporting CSV data 2026-03-11 22:28:32 +07:00
poli0981 4254ed95e8 Add sample HTML files for testing game information parsing 2026-03-11 22:21:53 +07:00
poli0981 e92962a03e Add GitHub workflows for checking game links, exporting logs, and updating JSON data 2026-03-11 22:20:14 +07:00
github-actions[bot] b14ea911ad Auto update CSV [2026-03-11] by GitHub Action 2026-03-11 04:49:00 +00:00
github-actions[bot] 186ca13594 JSON updated [2026-03-11] 2026-03-11 03:47:03 +00:00
github-actions[bot] 05ce87afcc JSON updated [2026-03-11] 2026-03-11 03:46:51 +00:00
poli0981 2deb175411 Add initial list of game links to temp_link.json 2026-03-10 12:27:14 +07:00
poli0981 a349452f1b Merge pull request #25 from poli0981/perf-optimize-delete-game-14230612745062559679
⚡ Optimized delete_game.py: Removed redundant iteration
2026-01-25 20:46:28 +07:00
poli0981 16a645681f Merge pull request #26 from poli0981/perf-optimize-export-csv-10145736823787570916
⚡ Remove redundant JSON read in export_csv.py
2026-01-25 20:43:14 +07:00
google-labs-jules[bot] 1c3fc70d9a Optimize scripts/export_csv.py by removing redundant file read 2026-01-25 13:41:04 +00:00
google-labs-jules[bot] a1c3d36abc Optimize delete_game.py to use single pass iteration 2026-01-25 13:40:29 +00:00
github-actions[bot] 8fe8fe818d Auto update CSV [2026-01-19] by GitHub Action 2026-01-19 04:36:06 +00:00
github-actions[bot] 9568bd9ede JSON updated [2026-01-19] 2026-01-19 03:34:46 +00:00
github-actions[bot] 54eae9f294 JSON updated [2026-01-19] 2026-01-19 03:34:35 +00:00
poli0981 f6f76ecc60 add: new 10+ games
Signed-off-by: poli0981 <127664709+poli0981@users.noreply.github.com>
2026-01-19 00:45:55 +07:00
github-actions[bot] 391bebb40e Auto update CSV [2026-01-18] by GitHub Action 2026-01-18 04:30:33 +00:00
github-actions[bot] 32e3af8812 JSON updated [2026-01-18] 2026-01-18 03:33:23 +00:00
github-actions[bot] b9db900d97 JSON updated [2026-01-18] 2026-01-18 03:33:11 +00:00
poli0981 eabae64ced chore: update permissions in workflow files to ensure write access 2026-01-18 09:28:23 +07:00
poli0981 af82e53335 chore: add write permissions to workflow files 2026-01-18 08:52:47 +07:00
poli0981 070de8025f Add games
Signed-off-by: poli0981 <127664709+poli0981@users.noreply.github.com>
2026-01-18 07:21:06 +07:00
github-actions[bot] 4f04087b29 Auto update CSV [2026-01-17] by GitHub Action 2026-01-17 04:22:41 +00:00
github-actions[bot] 3a07c8c092 JSON updated [2026-01-17] 2026-01-17 03:30:30 +00:00
github-actions[bot] 2a48873818 JSON updated [2026-01-17] 2026-01-17 03:30:20 +00:00
poli0981 f4eaf6f9c9 add games
Signed-off-by: poli0981 <127664709+poli0981@users.noreply.github.com>
2026-01-17 00:25:06 +07:00
github-actions[bot] 77365d6e22 Auto update CSV [2026-01-16] by GitHub Action 2026-01-16 04:27:26 +00:00
github-actions[bot] 2fc8d54813 JSON updated [2026-01-16] 2026-01-16 03:32:20 +00:00
github-actions[bot] a2ba1f1a91 JSON updated [2026-01-16] 2026-01-16 03:32:10 +00:00
poli0981 4bc5e3ac21 chore: update git config user to github-actions[bot] and remove debug echoes 2026-01-15 18:31:20 +07:00
poli0981 dae8f8be58 Merge remote-tracking branch 'origin/main' 2026-01-15 18:24:26 +07:00
poli0981 f28661adf0 Add games
Signed-off-by: poli0981 <127664709+poli0981@users.noreply.github.com>
2026-01-15 18:23:27 +07:00
github-actions[bot] d9962a0f07 Auto update CSV [2026-01-13] by GitHub Action 2026-01-13 04:27:40 +00:00
poli0981 0e6d767393 chore: update CHANGELOG for version 1.0.5 and fix UTF-8 decode issue 2026-01-12 20:07:47 +07:00
poli0981 f1872eae74 JSON updated [2026-01-12] 2026-01-12 12:59:51 +00:00
441 changed files with 209302 additions and 1838 deletions

No files matched your search

+18 -9
View File
@@ -1,7 +1,21 @@
* text = auto
* eol = lf
* text=auto eol=lf
# Binary assets (never normalize)
*.png binary
*.jpg binary
*.jpeg binary
*.gif binary
*.webp binary
*.ico binary
*.icns binary
*.tiff binary
*.jks binary
*.keystore binary
*.rtf -text
# Generated catalog data: collapse in GitHub diffs / language stats
data_game/*.json linguist-generated=true
/tests/ export-ignore
/.github/* export-ignore
.gitignore export-ignore
.gitattributes export-ignore
@@ -9,13 +23,7 @@
.idea/ export-ignore
.vscode/ export-ignore
CODE_OF_CONDUCT.md export-ignore
CONTRIBUTING.md export-ignore
SECURITY.md export-ignore
/docs/My_Stuff.md export-ignore
/docs/PrivacyPolicy.md export-ignore
CHANGELOG.md export-ignore
README.md export-ignore
*.csv export-ignore
*.log export-ignore
@@ -27,3 +35,4 @@ Thumbs.db export-ignore
/node_modules/ export-ignore
/vendor/ export-ignore
/.env export-ignore
webapp/worker-configuration.d.ts linguist-generated=true
+5
View File
@@ -0,0 +1,5 @@
# Code owners: automatically requested as reviewers on pull requests.
# Solo-maintained project, so the Maintainer owns everything.
# Syntax: https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners
* @poli0981
+20 -7
View File
@@ -1,12 +1,17 @@
name: 🎮 Add Games
description: Suggest new free itch.io games (max 15 per issue pls)
name: 🎮 Add Games (bulk list)
description: Got a whole list of free itch.io games? Use this. For one game, the Suggest page is faster.
title: "[Add Games] "
labels: ["contribution", "games"]
body:
- type: markdown
attributes:
value: |
Thanks bro! This repo lives on additions because I'm too lazy to hunt alone :D Only free-to-play itch.io games.
Thanks bro! This catalog lives on additions because I'm too lazy to hunt alone :D Only free-to-play itch.io games.
**Just one game? Use the Suggest page instead: https://freeitchgames.win/suggest** — no GitHub account needed, and it goes straight into the review queue.
This issue form is the fallback for **bulk lists** (several games at once).
How it works either way: every link lands in a review queue, and nothing enters the catalog until the Maintainer approves it. Approved links are scraped by the data pipeline; paid games and games already in the catalog are skipped.
- type: dropdown
id: count
@@ -25,7 +30,7 @@ body:
attributes:
label: Game Links (one per line!)
description: |
I'll check (no guarantee perfect). One link per line — two on same line? Your loss :v
itch.io game page links only (like `https://creator.itch.io/game`). One link per line — two on the same line? Your loss :v
placeholder: |
https://example.itch.io/game1
https://example.itch.io/game2
@@ -41,8 +46,16 @@ body:
- type: textarea
id: notes
attributes:
label: Notes for table? (optional)
description: Personal rating, warnings, etc. — I'll add to "Notes" column
label: Anything the Maintainer should know? (optional)
description: Warnings (adult content, suspicious download, needs an account...), your personal take, etc. The Maintainer may use it for the game's `notes`, `nsfw` or `safe_virus` fields.
- type: checkboxes
id: checks
attributes:
label: Quick checks (optional)
options:
- label: I searched https://freeitchgames.win/games and these games aren't listed yet
- label: These games are free to play on itch.io (not paid)
- type: checkboxes
id: agreement
@@ -50,4 +63,4 @@ body:
label: Agreement (required)
options:
- label: I agree — if this issue is off-topic, spam, or violates repo policy, it may be ignored/closed without response.
required: true
required: true
+53 -17
View File
@@ -1,12 +1,46 @@
name: 🐛 Bug Report
description: Report a bug in the list, tables, scripts, or anything broken
name: 🐛 Bug Report
description: Report a bug on the website, in the desktop/Android app, in the game data, or in the scripts
title: "[Bug] "
labels: ["bug"]
body:
- type: markdown
attributes:
value: |
Thanks for reporting! I'm a lazy unemployed dev, so bugs happen a lot :D Grok fixes most, but your help is gold.
Thanks for reporting! I'm a lazy unemployed dev, so bugs happen a lot :D My AI buddies fix most, but your help is gold.
**Found a security vulnerability?** Please don't file it here — report it privately via https://github.com/poli0981/free-games-itchio-list/security/advisories/new or security@poli0981.dev.
Want a game removed (or you're its creator)? Use the "Remove a Game" template instead.
- type: dropdown
id: where
attributes:
label: Where did it happen?
description: Pick all that apply.
multiple: true
options:
- Website (freeitchgames.win)
- Desktop app — Windows
- Desktop app — macOS
- Desktop app — Linux
- Android app
- Game data itself (wrong info, same everywhere)
- Data pipeline / GitHub Actions / scripts
- Not sure
validations:
required: true
- type: input
id: version
attributes:
label: Version
description: Shown on the About page (website and apps). For the desktop/Android app, the release you installed.
placeholder: e.g. 4.1.0
- type: input
id: environment
attributes:
label: Browser / device / OS (if relevant)
placeholder: e.g. Firefox on Windows 11, Safari on macOS 15, Android 13 phone
- type: checkboxes
id: bug_types
@@ -14,13 +48,15 @@ body:
label: What kind of bug(s)? (check all that apply)
options:
- label: Broken/dead link (game page 404 or not loading)
- label: Thumbnail not showing or wrong
- label: Table missing columns or broken format
- label: Wrong game name or dev name
- label: Wrong game count in tables
- label: Wrong genre classification
- label: Cover image not showing or wrong
- label: Wrong game name or developer name
- label: Wrong genre, tags, platforms or other game info
- label: Wrong or outdated description
- label: NSFW/Safe flag wrong
- label: NSFW flag or safety note (safe_virus) wrong
- label: Game count or charts look wrong
- label: Page/app crashes, won't load, or layout broken
- label: Search, filters or sorting not working
- label: Suggest page not working
- label: Other (must describe below)
- type: textarea
@@ -28,7 +64,7 @@ body:
attributes:
label: Details (Game name(s)/URL(s), what happened?)
description: |
If "Other" checked, or multiple games — explain here. The more specific, the faster I fix (or Grok does).
What did you do, what did you expect, what happened instead? If "Other" is checked, or multiple games — explain here. The more specific, the faster it gets fixed.
validations:
required: true
@@ -36,17 +72,17 @@ body:
id: screenshots
attributes:
label: Screenshots/Proof (optional but super helpful)
description: Paste links or describe — I believe you, but visuals make me less lazy :D
description: Paste images or links, or describe — I believe you, but visuals make me less lazy :D Please hide any personal info.
- type: checkboxes
- type: dropdown
id: urgency
attributes:
label: Urgency level?
options:
- label: Low (annoying but not critical)
- label: Medium (affects some games)
- label: High (breaks tables or many games)
- label: Critical (whole repo broken)
- Low (annoying but not critical)
- Medium (affects some games or one page)
- High (breaks a whole page or many games)
- Critical (website or app unusable)
- type: checkboxes
id: agreement
@@ -55,4 +91,4 @@ body:
description: I gotta cover my lazy ass :D
options:
- label: I agree — if this issue is off-topic, spam, or violates repo policy, it may be ignored/closed without response.
required: true
required: true
+8
View File
@@ -0,0 +1,8 @@
blank_issues_enabled: false
contact_links:
- name: 🎮 Suggest a game (fastest way)
url: https://freeitchgames.win/suggest
about: Suggest one free itch.io game right on the website, no GitHub account needed. Every suggestion is reviewed by the Maintainer before it enters the catalog.
- name: 🔒 Report a security vulnerability (private)
url: https://github.com/poli0981/free-games-itchio-list/security/advisories/new
about: Please report vulnerabilities privately here (or email security@poli0981.dev), never in a public issue.
+56 -7
View File
@@ -1,12 +1,17 @@
name: 🚫 Remove Games
description: Request to remove games from the list (max 10 per issue)
name: 🚫 Remove a Game (or copyright request)
description: Ask to remove games from the catalog or correct their data, including requests from creators and rights holders (max 10 per issue)
title: "[Remove Games] "
labels: ["removal"]
body:
- type: markdown
attributes:
value: |
Sad to see them go, but ok! Max 10 because I'm lazy :D
Sad to see them go, but ok! Max 10 per issue because I'm lazy :D
**This issue is public.** Don't post private contact details or anything confidential here.
Prefer to keep it private? Email **takedown@poli0981.dev** instead, with the game URL, who you are (creator, rights holder, or someone authorized to act for them) and the reason.
What happens next (for a removal): the Maintainer removes the record from the catalog (the removal and its reason are logged in the public list of removed games at https://freeitchgames.win/removed), deletes the resized cover copies the website stores, and cached copies expire from Cloudflare's cache. Older versions stay in the public git history. Target: within 7 days; urgent legal requests sooner.
- type: dropdown
id: count
@@ -22,8 +27,11 @@ body:
- type: textarea
id: games
attributes:
label: Game Name(s) or Link(s)
description: List them — one per line or clear
label: Game Link(s)
description: itch.io links work best (game names are ok too). One per line.
placeholder: |
https://example.itch.io/game1
https://example.itch.io/game2
validations:
required: true
@@ -38,6 +46,8 @@ body:
- label: Don't like it anymore
- label: Potential malware/virus
- label: I'm the dev and don't want it listed
- label: I'm the dev and the data shown is wrong (please correct it instead of removing)
- label: Copyright / rights-holder request (fill in the section below)
- label: Other (describe below)
validations:
required: true
@@ -45,7 +55,46 @@ body:
- type: textarea
id: other_reason
attributes:
label: If "Other" — explain here
label: Details / if "Other" — explain here
description: For a correction, say which field is wrong and what it should be.
- type: markdown
attributes:
value: |
---
### Copyright / rights-holder section (optional)
Fill this in only if you are the creator or rights holder of the listed game (or authorized to act for them), for example when your description text or cover image is shown here and you want it removed.
Game descriptions and cover images remain the property of their creators; the catalog only copies what is on the public itch.io page.
- type: input
id: rights_holder
attributes:
label: Your name, studio or itch.io account, and your role
description: e.g. "Creator, itch.io account example" or "Publisher, authorized by the developer". Public — no private contact details please.
- type: checkboxes
id: affected
attributes:
label: Which content is affected?
options:
- label: The whole listing
- label: Description text
- label: Cover image / thumbnail
- label: Game name, logo or trademark
- label: Something else (explain below)
- type: textarea
id: claim
attributes:
label: Details of the request
description: Where the original work lives (e.g. your itch.io page) and what you want done.
- type: checkboxes
id: rights_confirmation
attributes:
label: Confirmation (copyright requests only)
options:
- label: I am the creator or rights holder of the content above, or authorized to act for them, and the information in this issue is accurate.
- type: checkboxes
id: agreement
@@ -53,4 +102,4 @@ body:
label: Agreement (required)
options:
- label: I agree — if this issue is off-topic, spam, or violates repo policy, it may be ignored/closed without response.
required: true
required: true
+9 -10
View File
@@ -1,20 +1,19 @@
**🎮 Add New Games**
Thanks for feeding the list! (Normally I prefer the "Add Games" issue template so Actions auto-scrape, but PR direct to game_info.json also works if you wanna be extra :D)
Thanks for feeding the list! Easiest ways first: one game → the Suggest page (https://freeitchgames.win/suggest, no GitHub needed); a bulk list → the "Add Games" issue template. A PR also works if you wanna be extra :D
**How to add games in a PR:** put the itch.io game URLs in `scripts/temp_link.json` (a JSON array of URL strings). Please don't edit `data_game/` by hand — the pipeline writes it. Merging the PR is the Maintainer's approval; the ingest workflow (`update.yml`) then scrapes each link and adds the free ones. Paid games and games already in the catalog are skipped.
### Games Added
List the itch.io URLs (free-to-play only!):
### Why these games?
Optional: short notes, why they rock, NSFW/safe concerns.
### Description
How you added them (manual edit game_info.json? scraped yourself?). Keep format consistent!
Optional: short notes, why they rock, NSFW/safety concerns (the Maintainer sets the `nsfw`, `safe_virus` and `notes` fields).
### Checklist
- [ ] All links are free itch.io games
- [ ] No duplicates (check existing)
- [ ] Format correct (json valid, fields match)
- [ ] Tested generate_md.py after
- [ ] All links are free itch.io game pages
- [ ] No duplicates (searched https://freeitchgames.win/games)
- [ ] Only `scripts/temp_link.json` changed, and it's still valid JSON
- [ ] I agree my contribution is licensed under CC BY 4.0, like the rest of the catalog data (`data_game/LICENSE.md`)
You're making this boredom project bigger — legend status unlocked! 🚀
You're making this boredom project bigger — legend status unlocked! 🚀
+9 -7
View File
@@ -3,12 +3,12 @@
Thanks for fixing my mediocre code! I'm just an unemployed noob dev, so bugs are my specialty :D
### What bug did you fix?
- [ ] Broken link / wrong info in list
- [ ] Wrong NSFW/Safe flag
- [ ] Genre classification error
- [ ] Wrong game info or NSFW/safety flag (usually easier as a Bug Report issue — please don't hand-edit `data_game/`, the pipeline writes it)
- [ ] Scraping failure (itch.io changed HTML again)
- [ ] Generate MD tables broken (split/part wrong)
- [ ] GitHub Actions fail
- [ ] Data pipeline / GitHub Actions fail
- [ ] Website bug (`webapp/src/`)
- [ ] Worker bug (`webapp/worker/` — image proxy, Suggest API, admin API)
- [ ] Desktop/Android app (Tauri) bug
- [ ] Other (describe below)
### Description
@@ -18,8 +18,10 @@ Explain the bug and how your fix works. Bonus points if you tested locally!
Closes # (link issue number if any)
### Checklist
- [ ] Tested locally (run update_games.py + generate_md.py)
- [ ] Tested locally — Python: `pytest`, `ruff check scripts tests webapp/scripts`, `python scripts/validate.py`; webapp: `npm test`, `npm run lint`, `npx tsc -b`
- [ ] No new bugs introduced (hopefully)
- [ ] No secrets, tokens or personal data in the diff
- [ ] I agree my contribution is licensed under the MIT License (see `LICENSE`)
- [ ] Followed the vibe (chill, no drama)
Grok approved? (just kidding, but thanks legend!) 🚀
Grok approved? (just kidding, but thanks legend!) 🚀
@@ -4,7 +4,8 @@ Not code or games? Fix my bad English, typos, or update legal docs — still sup
### What did you update?
- [ ] Fix typo/grammar in README/docs
- [ ] Update DISCLAIMER/PRIVACY/TERMS/etc.
- [ ] Update DISCLAIMER/PRIVACY/TERMS/EULA/SECURITY/etc.
- [ ] Update the Vietnamese mirror (`README.vi.md`, `docs/i18n/vi/`)
- [ ] Improve MY_STUFF or ACKNOWLEDGEMENTS
- [ ] Add badges/screenshots
- [ ] Other small polish
@@ -17,6 +18,9 @@ References # (if any)
### Checklist
- [ ] No breaking changes
- [ ] Relative links still resolve; website links use `https://freeitchgames.win/<path>`
- [ ] If I changed an English doc that has a Vietnamese mirror, I updated the mirror too (or said so above so someone else can)
- [ ] I agree my contribution is licensed under CC BY 4.0, like the rest of the documentation
- [ ] Keeps the self-deprecating vibe :D
Even small fixes make this repo look less noob — thanks bro! 🚀
Even small fixes make this repo look less noob — thanks bro! 🚀
+12 -6
View File
@@ -2,11 +2,14 @@
Yo legend! My code is "kinda works" level, so any upgrade is huge. Grok helps me, but real humans are better :D
Heads-up: the website and apps are read-only for visitors on purpose — no accounts, no ads, no profiling, no telemetry in the apps. Features that would add those (or new cookies, or a new third-party service) need a chat in an issue first, since the Privacy Policy would have to change.
### What feature/improvement?
- [ ] Better scraping (more info, rating, etc.)
- [ ] Prettier tables (new columns, better split)
- [ ] Auto stuff (badge, index README, search?)
- [ ] Performance fix (faster Actions)
- [ ] Website/app UI (new page, filter, chart, better mobile layout)
- [ ] Desktop/Android app (Tauri)
- [ ] Automation (pipeline, GitHub Actions)
- [ ] Performance fix (faster pages, faster Actions)
- [ ] Refactor my messy code
- [ ] Other (describe)
@@ -17,8 +20,11 @@ Explain what it does and why it's cool. Include code snippets if needed.
References # (link if any)
### Checklist
- [ ] Tested locally
- [ ] Doesn't break daily update
- [ ] Tested locally (Python: `pytest`, `ruff check scripts tests webapp/scripts`; webapp: `npm test`, `npm run lint`, `npm run knip`, `npx tsc -b`)
- [ ] Doesn't break the daily refresh or the ingest workflow
- [ ] New npm dependency? Added it to `webapp/src/lib/about.ts` so the About page lists it
- [ ] Edited `webapp/wrangler.jsonc`? Ran `npm run cf:types`
- [ ] I agree my contribution is licensed under the MIT License (see `LICENSE`)
- [ ] Keeps the noob vibe intact
If this makes the repo less mediocre — you're the MVP. 🚀
If this makes the repo less mediocre — you're the MVP. 🚀
+84
View File
@@ -0,0 +1,84 @@
# Dependabot version updates. Security updates are enabled separately in
# Settings → Code security (they are not limited by open-pull-requests-limit).
version: 2
updates:
- package-ecosystem: npm
directory: /webapp
schedule:
interval: weekly
day: monday
time: '01:30'
timezone: Asia/Ho_Chi_Minh
cooldown:
default-days: 3
open-pull-requests-limit: 5
groups:
react:
patterns: ['react', 'react-dom', '@types/react*', 'react-router*']
tanstack:
patterns: ['@tanstack/*']
radix:
patterns: ['@radix-ui/*', 'radix-ui']
tauri-js:
patterns: ['@tauri-apps/*']
build-tooling:
patterns:
- 'vite'
- '@vitejs/*'
- 'typescript'
- '@typescript/*'
- 'typescript-eslint'
- 'eslint*'
- '@eslint/*'
- 'knip'
- 'tailwindcss'
- '@tailwindcss/*'
- 'tw-animate-css'
- 'wrangler'
- '@cloudflare/*'
ignore:
# `typescript` is an alias of @typescript/typescript6 (the 6.0 API):
# typescript-eslint supports TypeScript < 6.1 only. TypeScript 7 itself
# is `@typescript/native`. Never move the alias to a new major.
- dependency-name: 'typescript'
update-types: ['version-update:semver-major']
# Match the Node 26 runtime.
- dependency-name: '@types/node'
versions: ['>=27']
- package-ecosystem: pip
directory: /
schedule:
interval: weekly
day: monday
cooldown:
default-days: 3
groups:
python:
patterns: ['*']
- package-ecosystem: github-actions
directory: /
schedule:
interval: weekly
day: monday
groups:
actions:
patterns: ['*']
# Weekly on Mondays like npm, so tauri-rs and tauri-js bumps land together:
# `tauri build` (release workflows only) refuses crate / npm versions on a
# different major.minor; Webapp CI's check:tauri step catches a one-sided bump.
- package-ecosystem: cargo
directory: /webapp/src-tauri
schedule:
interval: weekly
day: monday
groups:
tauri-rs:
patterns: ['tauri*']
rust-other:
patterns: ['*']
ignore:
- dependency-name: 'tauri*'
versions: ['>=3.0.0-0']
+1
View File
@@ -0,0 +1 @@
3.15
+205
View File
@@ -0,0 +1,205 @@
name: Announce to Discussion
# Two triggers, two destinations:
# 1. release:published → Announcements category
# 2. push touching the changelog (CHANGELOG.md index or changelog/**) →
# General (docs-only edits don't post; put user-facing changes in the
# changelog). Add `[skip-discuss]` to the head-commit message to opt out.
#
# No pre-flight needed — repo ID and category IDs are auto-discovered at
# runtime via GraphQL (by category slug: "announcements" / "general").
# Requires: GitHub Discussions enabled on the repo with both categories present.
on:
release:
types: [published]
push:
branches: [main]
paths:
- 'CHANGELOG.md'
- 'changelog/**'
workflow_dispatch:
inputs:
mode:
description: "Which job to run"
required: true
type: choice
options: [announce-release, announce-docs]
default: announce-release
tag:
description: "Release tag (announce-release mode)"
type: string
required: false
permissions: {}
concurrency:
group: announce-discussion-${{ github.ref }}
cancel-in-progress: false
jobs:
announce-release:
if: >
github.event_name == 'release' ||
(github.event_name == 'workflow_dispatch' && inputs.mode == 'announce-release')
runs-on: ubuntu-latest
timeout-minutes: 5
permissions:
contents: read
discussions: write
env:
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
steps:
- name: Discover Discussion IDs
id: ids
run: |
set -euo pipefail
OWNER="${GITHUB_REPOSITORY%%/*}"
NAME="${GITHUB_REPOSITORY##*/}"
JSON=$(gh api graphql -f owner="$OWNER" -f name="$NAME" -f query='
query($owner:String!,$name:String!){
repository(owner:$owner,name:$name){
id
discussionCategories(first:25){nodes{id slug name}}
}
}')
REPO_ID=$(echo "$JSON" | jq -r '.data.repository.id // empty')
CAT_ID=$(echo "$JSON" | jq -r '.data.repository.discussionCategories.nodes[] | select(.slug=="announcements") | .id' | head -n1)
if [ -z "$REPO_ID" ]; then
echo "::error::Could not resolve repository GraphQL ID. Are Discussions enabled on this repo?"
exit 1
fi
if [ -z "$CAT_ID" ]; then
echo "::error::No 'announcements' discussion category found. Create it under Settings → Discussions."
exit 1
fi
echo "repo_id=$REPO_ID" >> "$GITHUB_OUTPUT"
echo "category_id=$CAT_ID" >> "$GITHUB_OUTPUT"
- name: Resolve release tag + body
id: rel
env:
INPUT_TAG: ${{ inputs.tag }}
EVENT_TAG: ${{ github.event.release.tag_name }}
run: |
set -euo pipefail
TAG="${INPUT_TAG:-$EVENT_TAG}"
if [ -z "$TAG" ]; then
echo "::error::No release tag available."
exit 1
fi
REL_JSON=$(gh api "repos/${GITHUB_REPOSITORY}/releases/tags/$TAG")
NAME=$(echo "$REL_JSON" | jq -r '.name // ""')
BODY=$(echo "$REL_JSON" | jq -r '.body // ""')
URL=$(echo "$REL_JSON" | jq -r '.html_url // ""')
PRE=$(echo "$REL_JSON" | jq -r '.prerelease // false')
{
printf '## %s\n\n' "${NAME:-$TAG}"
printf '%s\n\n' "$BODY"
printf -- '---\n\n'
printf '[Release page](%s) · prerelease=%s\n' "$URL" "$PRE"
} > body.md
echo "tag=$TAG" >> "$GITHUB_OUTPUT"
echo "title=Release ${TAG}" >> "$GITHUB_OUTPUT"
- name: Create Announcements discussion
env:
REPO_ID: ${{ steps.ids.outputs.repo_id }}
CATEGORY_ID: ${{ steps.ids.outputs.category_id }}
TITLE: ${{ steps.rel.outputs.title }}
run: |
set -euo pipefail
gh api graphql \
-f query='mutation($r:ID!,$c:ID!,$t:String!,$b:String!){createDiscussion(input:{repositoryId:$r,categoryId:$c,title:$t,body:$b}){discussion{url}}}' \
-f r="$REPO_ID" \
-f c="$CATEGORY_ID" \
-f t="$TITLE" \
-F b=@body.md
announce-docs:
if: >
github.event_name == 'push' &&
!contains(github.event.head_commit.message, '[skip-discuss]')
runs-on: ubuntu-latest
timeout-minutes: 5
permissions:
contents: read
discussions: write
env:
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
steps:
- name: Discover Discussion IDs
id: ids
run: |
set -euo pipefail
OWNER="${GITHUB_REPOSITORY%%/*}"
NAME="${GITHUB_REPOSITORY##*/}"
JSON=$(gh api graphql -f owner="$OWNER" -f name="$NAME" -f query='
query($owner:String!,$name:String!){
repository(owner:$owner,name:$name){
id
discussionCategories(first:25){nodes{id slug name}}
}
}')
REPO_ID=$(echo "$JSON" | jq -r '.data.repository.id // empty')
CAT_ID=$(echo "$JSON" | jq -r '.data.repository.discussionCategories.nodes[] | select(.slug=="general") | .id' | head -n1)
if [ -z "$REPO_ID" ]; then
echo "::error::Could not resolve repository GraphQL ID. Are Discussions enabled on this repo?"
exit 1
fi
if [ -z "$CAT_ID" ]; then
echo "::error::No 'general' discussion category found. Create it under Settings → Discussions."
exit 1
fi
echo "repo_id=$REPO_ID" >> "$GITHUB_OUTPUT"
echo "category_id=$CAT_ID" >> "$GITHUB_OUTPUT"
- name: Checkout (last 2 commits for diff)
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
with:
fetch-depth: 2
persist-credentials: false
- name: List changed docs
id: changes
run: |
set -euo pipefail
git diff --name-only HEAD^ HEAD -- CHANGELOG.md changelog/ > changed.txt || true
if [ ! -s changed.txt ]; then
echo "no-docs-changed=true" >> "$GITHUB_OUTPUT"
fi
- name: Build body
if: steps.changes.outputs.no-docs-changed != 'true'
id: body
env:
MSG: ${{ github.event.head_commit.message }}
URL: ${{ github.event.head_commit.url }}
TITLE_SUFFIX: ${{ github.event.head_commit.id }}
run: |
set -euo pipefail
FIRST_LINE=$(printf '%s' "$MSG" | head -n 1)
{
printf 'Files changed:\n\n```\n'
cat changed.txt
printf '```\n\n'
printf 'Commit message:\n\n> %s\n\n' "$FIRST_LINE"
printf '[View commit](%s) · sha=`%s`\n' "$URL" "$TITLE_SUFFIX"
} > body.md
SHORT_SHA=$(printf '%s' "$TITLE_SUFFIX" | cut -c1-7)
echo "title=Docs update — ${FIRST_LINE} (${SHORT_SHA})" >> "$GITHUB_OUTPUT"
- name: Create General discussion
if: steps.changes.outputs.no-docs-changed != 'true'
env:
REPO_ID: ${{ steps.ids.outputs.repo_id }}
CATEGORY_ID: ${{ steps.ids.outputs.category_id }}
TITLE: ${{ steps.body.outputs.title }}
run: |
set -euo pipefail
gh api graphql \
-f query='mutation($r:ID!,$c:ID!,$t:String!,$b:String!){createDiscussion(input:{repositoryId:$r,categoryId:$c,title:$t,body:$b}){discussion{url}}}' \
-f r="$REPO_ID" \
-f c="$CATEGORY_ID" \
-f t="$TITLE" \
-F b=@body.md
+30
View File
@@ -0,0 +1,30 @@
name: Announce Release to Discord
on:
release:
types: [published]
workflow_dispatch:
inputs:
tag:
description: "Existing release tag to re-announce"
required: true
type: string
permissions: {}
jobs:
announce:
# The reusable workflow fetches release metadata with the gh CLI.
permissions:
contents: read
# Pinned to a commit of poli0981/.github and only the needed secrets are
# passed. NOTE: the pin freezes the workflow YAML only — at this commit it
# still checks out its notifier script from poli0981/.github@main. Bump
# the pin once that repo runs the script from the same commit.
uses: poli0981/.github/.github/workflows/announce-release.yml@c3e118a01d40e95b36b2c3466dc206638c11eb5a
with:
tag_override: ${{ inputs.tag || '' }}
secrets:
DISCORD_RELEASES_WEBHOOK: ${{ secrets.DISCORD_RELEASES_WEBHOOK }}
DISCORD_REPO_WEBHOOK: ${{ secrets.DISCORD_REPO_WEBHOOK }}
DISCORD_PING_ROLE_ID: ${{ secrets.DISCORD_PING_ROLE_ID }}
+83
View File
@@ -0,0 +1,83 @@
# Not a deploy workflow: Cloudflare Workers Builds deploys main on its own.
# This watches the result: every hour it finds the latest finished
# "Workers Builds: free-games-itchio-list" check run on main
# (bash/cf_build_status.sh) and posts a failure to Discord once per failed
# build (a cache entry keyed on the check-run id marks it as reported, only
# after the post succeeded). A schedule is used because GitHub never starts
# check_run-triggered workflows for commits pushed with GITHUB_TOKEN — the
# refresh / ingest data commits. Cloudflare's own build-failure notification is
# the independent fallback.
name: Cloudflare build status
on:
schedule:
- cron: '41 * * * *'
workflow_dispatch:
permissions: {}
concurrency:
group: cf-build-status
cancel-in-progress: false
jobs:
check:
runs-on: ubuntu-latest
timeout-minutes: 5
permissions:
contents: read
checks: read
outputs:
failed_id: ${{ steps.status.outputs.failed_id }}
failed_url: ${{ steps.status.outputs.failed_url }}
failed_sha: ${{ steps.status.outputs.failed_sha }}
reported: ${{ steps.seen.outputs.cache-hit }}
steps:
- name: Checkout repository
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
with:
persist-credentials: false
sparse-checkout: bash
- name: Find the latest finished Cloudflare build
id: status
env:
GH_TOKEN: ${{ github.token }}
run: bash bash/cf_build_status.sh
- name: Was this failure reported already?
id: seen
if: steps.status.outputs.failed_id != ''
uses: actions/cache/restore@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
with:
path: .cf-alert
key: cf-alert-${{ steps.status.outputs.failed_id }}
lookup-only: true
notify:
needs: [check]
if: needs.check.outputs.failed_id != '' && needs.check.outputs.reported != 'true'
permissions: {}
uses: ./.github/workflows/notify-failure.yml
with:
summary: >-
The Cloudflare build of ${{ needs.check.outputs.failed_sha }} failed, so
freeitchgames.win is not up to date: ${{ needs.check.outputs.failed_url }}
secrets:
DISCORD_CI_WEBHOOK: ${{ secrets.DISCORD_CI_WEBHOOK }}
mark-reported:
needs: [check, notify]
if: needs.notify.result == 'success'
runs-on: ubuntu-latest
timeout-minutes: 3
permissions: {}
steps:
- name: Remember the reported build
run: mkdir -p .cf-alert && date -u > .cf-alert/reported
- name: Save the marker
uses: actions/cache/save@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
with:
path: .cf-alert
key: cf-alert-${{ needs.check.outputs.failed_id }}
+50
View File
@@ -0,0 +1,50 @@
# Manual re-scrape of every scraper-owned field (repairs mojibake, backfills
# fields after a scraper upgrade). Always preserves safe_virus / notes / nsfw.
# Queues refresh.yml in full mode: one URL, or a rotating batch of the games
# whose last full re-scrape is oldest. Dispatch again to continue: the runs
# wait FIFO in refresh.yml's concurrency group and each batch starts from the
# latest main, so several dispatches in a row cover consecutive batches.
#
# A dispatch rather than a reusable-workflow call: called through `uses:`,
# refresh.yml failed at startup ("workflow file issue", no annotation).
name: Force update
on:
workflow_dispatch:
inputs:
url:
description: 'itch.io URL to re-scrape (optional; empty = next batch of the catalog)'
required: false
type: string
budget:
description: 'Batch size when no URL is given (0 = 1/7 of the catalog)'
type: number
default: 0
allow_mass_removal:
description: 'Apply removals even if the mass-change guard trips (confirm on itch.io first)'
type: boolean
default: false
permissions: {}
jobs:
queue:
runs-on: ubuntu-latest
timeout-minutes: 5
permissions:
actions: write # dispatch refresh.yml (a workflow_dispatch from GITHUB_TOKEN does start a run)
steps:
- name: Queue a full refresh
env:
GH_TOKEN: ${{ github.token }}
GH_REPO: ${{ github.repository }}
REF: ${{ github.ref_name }}
URL: ${{ inputs.url }}
BUDGET: ${{ inputs.budget }}
ALLOW_MASS_REMOVAL: ${{ inputs.allow_mass_removal }}
run: |
set -euo pipefail
gh workflow run refresh.yml --ref "$REF" \
-f full=true -f budget="$BUDGET" -f url="$URL" -f allow_mass_removal="$ALLOW_MASS_REMOVAL"
echo "Queued a full refresh on \`$REF\` (budget $BUDGET${URL:+, $URL}) — see the Refresh catalog runs." \
>> "$GITHUB_STEP_SUMMARY"
-28
View File
@@ -1,28 +0,0 @@
name: Generate Table of Game
on:
workflow_run:
workflows:
['Update JSON file game information']
types: [completed]
workflow_dispatch:
jobs:
generate:
if: ${{ github.event.workflow_run.conclusion == 'success' }}
runs-on: ubuntu-latest
steps:
- name: Checkout repository
uses: actions/checkout@v6
with:
token: ${{ secrets.GH_TOKEN }}
- name: Set up Python
uses: actions/setup-python@v6
with:
python-version: 3.14
- name: Run bash script to generate table
run: |
chmod +x ./bash/table.sh
./bash/table.sh
shell: bash
+41
View File
@@ -0,0 +1,41 @@
# Reusable: post a data-pipeline problem to Discord.
# Called from refresh.yml / update.yml when a job fails, is cancelled (job-level
# timeouts end as "cancelled", which the old workflow_run notifier never
# caught), when itch.io rate-limited the run or the mass-change guard tripped,
# and from deploy-status.yml when a Cloudflare build failed.
name: Notify pipeline failure
on:
workflow_call:
inputs:
summary:
description: Short status line (job results)
required: true
type: string
secrets:
DISCORD_CI_WEBHOOK:
required: false
permissions: {}
jobs:
discord:
runs-on: ubuntu-latest
timeout-minutes: 3
steps:
- name: Post to Discord
env:
HOOK: ${{ secrets.DISCORD_CI_WEBHOOK }}
WORKFLOW: ${{ github.workflow }}
SUMMARY: ${{ inputs.summary }}
RUN_URL: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
RUN_NUMBER: ${{ github.run_number }}
run: |
set -euo pipefail
if [ -z "$HOOK" ]; then
echo "::warning::DISCORD_CI_WEBHOOK is not set — nothing posted."
exit 0
fi
MSG="⚠️ **${WORKFLOW}** #${RUN_NUMBER}: ${SUMMARY}"$'\n'"${RUN_URL}"
jq -n --arg c "$MSG" '{content: $c}' \
| curl -fsS --retry 3 -H 'Content-Type: application/json' -d @- "$HOOK"
@@ -0,0 +1,26 @@
name: Notify Release Pipeline
# The watched workflows only run on tags /
# manual dispatch (trusted refs); this job reads run metadata, never artifacts or code.
on:
workflow_run: # zizmor: ignore[dangerous-triggers]
workflows:
- "Release desktop installers (Tauri)"
- "Release Android APK (Tauri)"
- "Announce Release to Discord"
types: [completed]
permissions: {}
jobs:
notify:
permissions:
contents: read
actions: read
# Pinned to a commit of poli0981/.github and only the needed secrets are
# passed. NOTE: the pin freezes the workflow YAML only — at this commit it
# still checks out its notifier script from poli0981/.github@main. Bump
# the pin once that repo runs the script from the same commit.
uses: poli0981/.github/.github/workflows/notify-release-pipeline.yml@c3e118a01d40e95b36b2c3466dc206638c11eb5a
secrets:
DISCORD_RELEASE_PIPELINE_WEBHOOK: ${{ secrets.DISCORD_RELEASE_PIPELINE_WEBHOOK }}
+69
View File
@@ -0,0 +1,69 @@
# Lint + tests for the data pipeline, and schema validation of the catalog.
# Pushes by the admin Worker's GitHub App also trigger this,
# so every externally written data change is validated.
name: Python CI
on:
pull_request:
paths:
- 'scripts/**'
- 'tests/**'
- 'data_game/**'
- 'requirements*.txt'
- 'pyproject.toml'
- '.github/python-version'
- '.github/workflows/python-ci.yml'
push:
branches: [main]
paths:
- 'scripts/**'
- 'tests/**'
- 'data_game/**'
- 'requirements*.txt'
- 'pyproject.toml'
- '.github/python-version'
- '.github/workflows/python-ci.yml'
permissions: {}
concurrency:
group: python-ci-${{ github.ref }}
cancel-in-progress: true
jobs:
test:
runs-on: ubuntu-latest
timeout-minutes: 10
permissions:
contents: read
steps:
- name: Checkout repository
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
with:
persist-credentials: false
- name: Set up Python
uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
with:
# Not .python-version: Dependabot's pip updater reads that file and
# supports Python <= 3.14 only (CLAUDE.md gotcha 39).
python-version-file: .github/python-version
cache: pip
cache-dependency-path: requirements-dev.txt
- name: Install dependencies
run: pip install -r requirements-dev.txt
- name: Ruff
run: |
ruff check scripts tests webapp/scripts
ruff format --check scripts tests
- name: Vulture (dead code)
run: vulture
- name: Pytest (no network)
run: pytest
- name: Validate catalog data
run: python scripts/validate.py
+161
View File
@@ -0,0 +1,161 @@
# Daily rotating catalog health check (replaces check_paid / check_alive /
# update_reviews / update_status, which each crawled every page and timed out).
#
# scan — scripts/refresh.py checks ~1/7 of the catalog (one GET per game),
# read-only, and uploads a patch (checkpointed, deadline-bound).
# apply — applies the patch to the latest main and pushes (bash/commit_push.sh
# re-applies on a fresh main if the push races another writer).
# notify — Discord on failure / cancel / itch.io rate limit / mass change
# (a run that would remove or strike an implausible share of games
# — usually itch.io markup changes — withholds the removals).
#
# Also dispatched with `full: true` (by force_update.yml, or by hand): re-scrape
# every scraper-owned field of one URL or of the next batch.
name: Refresh catalog
on:
schedule:
- cron: '47 2 * * *' # daily; GitHub may start scheduled runs hours late
workflow_dispatch:
inputs:
budget:
description: 'Games to check (0 = 1/7 of the catalog)'
type: number
default: 0
url:
description: 'Only this game URL (optional)'
type: string
required: false
allow_mass_removal:
description: 'Apply removals even if the mass-change guard trips (confirm on itch.io first)'
type: boolean
default: false
full:
description: 'Re-scrape every scraper-owned field (rotates on the last full re-scrape)'
type: boolean
default: false
permissions: {}
# One refresh pipeline (scan → apply) at a time, FIFO — a scheduled refresh, a
# manual one and a force-update batch never start from the same state (the scan
# checks out the branch as it is when the run starts), so an older removal can't
# undo a newer healthy check, and queued full batches move on through the catalog.
concurrency:
group: refresh-pipeline
cancel-in-progress: false
queue: max
env:
PYTHONUNBUFFERED: '1'
jobs:
scan:
runs-on: ubuntu-latest
timeout-minutes: 60
permissions:
contents: read
outputs:
rate_limited: ${{ steps.refresh.outputs.rate_limited }}
mass_change: ${{ steps.refresh.outputs.mass_change }}
steps:
# The branch's latest commit, not the one it had when the run was queued:
# a run waiting behind another must see that run's refresh state.
- name: Checkout repository
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
with:
ref: ${{ github.ref }}
persist-credentials: false
- name: Set up Python
uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
with:
python-version-file: .github/python-version
cache: pip
cache-dependency-path: requirements.txt
- name: Install dependencies
run: pip install -r requirements.txt
- name: Check a slice of the catalog
id: refresh
timeout-minutes: 55
env:
BUDGET: ${{ inputs.budget || 0 }}
URL: ${{ inputs.url }}
FULL: ${{ inputs.full && 'true' || 'false' }}
ALLOW_MASS_REMOVAL: ${{ inputs.allow_mass_removal && 'true' || 'false' }}
run: |
args=(--out "$RUNNER_TEMP/patch.json" --budget "$BUDGET" --deadline-min 45)
if [ "$FULL" = "true" ]; then args+=(--full); fi
if [ "$ALLOW_MASS_REMOVAL" = "true" ]; then args+=(--allow-mass-removal); fi
if [ -n "$URL" ]; then args+=(--url "$URL"); fi
python scripts/refresh.py "${args[@]}"
- name: Upload patch
if: always()
uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
with:
name: refresh-patch
path: ${{ runner.temp }}/patch.json
retention-days: 7
if-no-files-found: warn
apply:
needs: scan
# Also apply the checkpointed patch of a scan that failed or timed out
# (a timed-out step fails, it does not cancel) — but not of a cancelled run.
if: ${{ !cancelled() && needs.scan.result != 'skipped' }}
runs-on: ubuntu-latest
timeout-minutes: 10
permissions:
contents: write
# FIFO: with the default queue a newer pending apply would replace (and
# discard) an older pending one.
concurrency:
group: refresh-apply
cancel-in-progress: false
queue: max
steps:
- name: Checkout repository
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1 # zizmor: ignore[artipacked] — commit_push.sh pushes with this token
with:
ref: main
- name: Set up Python
uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
with:
python-version-file: .github/python-version
cache: pip
cache-dependency-path: requirements.txt
- name: Install dependencies
run: pip install -r requirements.txt
- name: Download patch
uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
with:
name: refresh-patch
path: ${{ runner.temp }}
- name: Apply, validate and push
env:
KIND: ${{ inputs.full && 'Force update' || 'Refresh catalog' }}
ALLOW_MASS_REMOVAL: ${{ inputs.allow_mass_removal && '1' || '0' }}
run: bash bash/commit_push.sh "$RUNNER_TEMP/patch.json" "$KIND [$(date -u +%F)]"
notify:
needs: [scan, apply]
if: >-
always() && (contains(needs.*.result, 'failure') ||
contains(needs.*.result, 'cancelled') || needs.scan.outputs.rate_limited == 'true' ||
needs.scan.outputs.mass_change == 'true')
permissions: {}
uses: ./.github/workflows/notify-failure.yml
with:
summary: >-
scan=${{ needs.scan.result }}, apply=${{ needs.apply.result }},
rate_limited=${{ needs.scan.outputs.rate_limited || 'false' }},
mass_change=${{ needs.scan.outputs.mass_change || 'false' }}
secrets:
DISCORD_CI_WEBHOOK: ${{ secrets.DISCORD_CI_WEBHOOK }}
+153
View File
@@ -0,0 +1,153 @@
name: Release Android APK (Tauri)
# Builds a signed, sideloadable arm64-v8a APK from the same React + Tauri app
# that release_desktop.yml ships for desktop.
#
# - On a `v*` tag: attaches the APK to the same DRAFT GitHub Release as the
# desktop installers (nothing is published — release stays a draft until a
# human publishes it).
# - On manual dispatch: uploads the APK as a workflow artifact so it can be
# downloaded and device-tested without cutting a tag.
#
# `src-tauri/gen/android` is gitignored and regenerated by `tauri android init`
# on every run, so signing is done AFTER the build with zipalign + apksigner
# (no edits to generated Gradle). Order matters: zipalign BEFORE apksigner —
# re-aligning a signed APK breaks the signature.
on:
push:
tags: ['v*']
workflow_dispatch:
# Pin the NDK so CI matches local (a floating NDK is a classic
# "works locally, breaks in CI"). 27.3.x is the current stable LTS and is
# installed on the dev machine; to match locally, point NDK_HOME at the same
# version (otherwise Tauri picks the highest installed NDK).
env:
NDK_VERSION: '27.3.13750724'
permissions: {}
concurrency:
group: release-android-${{ github.ref }}
cancel-in-progress: false
jobs:
build-android:
runs-on: ubuntu-latest
timeout-minutes: 90
permissions:
contents: write
steps:
- name: Checkout repository
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
with:
persist-credentials: false
- name: Set up JDK
uses: actions/setup-java@b843ebf9b913146b38da2eaa7aeddf76074ae1ad # v6.1.0
with:
distribution: temurin
java-version: '17'
# No `cache: gradle` — the Gradle project lives in gen/android, which
# is gitignored and only created later by `tauri android init`, so
# there are no gradle files at checkout for setup-java to key on
# (it hard-errors otherwise). Release builds use no caches at all.
- name: Set up Node.js
uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7.1.0
with:
node-version-file: webapp/.node-version
# No dependency cache in release builds: a poisoned cache could end
# up inside signed installers. Releases are rare; take the extra minutes.
package-manager-cache: false
- name: Set up Rust
uses: dtolnay/rust-toolchain@683b588c487a69d01f6c6ddf40f036ff682cc2c8 # master
with:
toolchain: stable
targets: aarch64-linux-android
- name: Set up Android SDK
uses: android-actions/setup-android@be39fa834029ff78f1a44aa3bb0819b8fc2bd8fd # v4.0.4
- name: Install NDK + build-tools + platform
# Tauri 2.11 generates compileSdk/targetSdk = 36, so provision android-36
# and a matching build-tools (these versions match the dev machine).
run: |
sdkmanager "ndk;${NDK_VERSION}" "build-tools;36.1.0" "platforms;android-36" "platform-tools"
echo "NDK_HOME=$ANDROID_HOME/ndk/${NDK_VERSION}" >> "$GITHUB_ENV"
- name: Install npm deps
working-directory: webapp
run: npm ci
- name: Initialize Android project
working-directory: webapp
run: npm run tauri -- android init
- name: Build unsigned release APK (arm64-v8a)
working-directory: webapp
run: npm run tauri -- android build --apk --target aarch64
- name: Sign APK (zipalign -> apksigner)
id: sign
working-directory: webapp
env:
ANDROID_KEYSTORE_BASE64: ${{ secrets.ANDROID_KEYSTORE_BASE64 }}
ANDROID_KEYSTORE_PASSWORD: ${{ secrets.ANDROID_KEYSTORE_PASSWORD }}
ANDROID_KEY_ALIAS: ${{ secrets.ANDROID_KEY_ALIAS }}
run: |
set -euo pipefail
# Highest installed build-tools (provides zipalign + apksigner).
BT=$(ls -d "$ANDROID_HOME"/build-tools/* | sort -V | tail -1)
VERSION=$(node -p "require('./src-tauri/tauri.conf.json').version")
OUT="FreeGamesItchio_${VERSION}_arm64-v8a.apk"
echo "$ANDROID_KEYSTORE_BASE64" | base64 -d > "$RUNNER_TEMP/release.jks"
UNSIGNED=$(find src-tauri/gen/android/app/build/outputs/apk \
-name "*-release-unsigned.apk" | head -1)
if [ -z "$UNSIGNED" ]; then
echo "::error::No *-release-unsigned.apk found — build produced no unsigned APK."
exit 1
fi
echo "Unsigned APK: $UNSIGNED"
"$BT/zipalign" -v -p 4 "$UNSIGNED" aligned.apk
"$BT/apksigner" sign \
--ks "$RUNNER_TEMP/release.jks" \
--ks-key-alias "$ANDROID_KEY_ALIAS" \
--ks-pass "pass:$ANDROID_KEYSTORE_PASSWORD" \
--key-pass "pass:$ANDROID_KEYSTORE_PASSWORD" \
--out "$OUT" aligned.apk
"$BT/apksigner" verify --verbose "$OUT"
rm -f "$RUNNER_TEMP/release.jks" aligned.apk
echo "apk_path=webapp/$OUT" >> "$GITHUB_OUTPUT"
echo "apk_name=$OUT" >> "$GITHUB_OUTPUT"
- name: Upload APK as workflow artifact
uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
with:
name: ${{ steps.sign.outputs.apk_name }}
path: ${{ steps.sign.outputs.apk_path }}
if-no-files-found: error
- name: Attach APK to draft release (tag only)
if: startsWith(github.ref, 'refs/tags/')
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
TAG: ${{ github.ref_name }}
REPO: ${{ github.repository }}
APK_PATH: ${{ steps.sign.outputs.apk_path }}
run: |
set -euo pipefail
# release_desktop.yml's create-release job normally made the draft
# minutes ago; create it only as a fallback (tolerating a race).
gh release view "$TAG" --repo "$REPO" >/dev/null 2>&1 \
|| gh release create "$TAG" --repo "$REPO" --draft --verify-tag \
--title "Free Itch Games $TAG" --generate-notes \
|| gh release view "$TAG" --repo "$REPO" >/dev/null
gh release upload "$TAG" "$APK_PATH" --repo "$REPO" --clobber
+175
View File
@@ -0,0 +1,175 @@
name: Release desktop installers (Tauri)
# Release process (draft-first):
# 1. push a signed tag vX.Y.Z from main
# 2. `create-release` makes ONE draft release (generated notes); every build
# job — here and in release_android.yml — uploads into that draft
# 3. check the assets, edit the notes, then publish:
# gh release edit vX.Y.Z --draft=false
# Publishing fires the Discord / Discussions announcements, so they only
# go out once installers exist. Never create the release by hand first:
# tauri-action v1 refuses to upload into a non-draft release.
# Manual dispatch builds without a release and uploads workflow artifacts.
on:
push:
tags: ['v*']
workflow_dispatch:
permissions: {}
concurrency:
group: release-desktop-${{ github.ref }}
cancel-in-progress: false
jobs:
create-release:
if: startsWith(github.ref, 'refs/tags/')
runs-on: ubuntu-latest
timeout-minutes: 5
permissions:
contents: write
outputs:
release_id: ${{ steps.draft.outputs.release_id }}
steps:
- name: Create (or reuse) the draft release
id: draft
env:
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
TAG: ${{ github.ref_name }}
REPO: ${{ github.repository }}
run: |
set -euo pipefail
gh release view "$TAG" --repo "$REPO" >/dev/null 2>&1 \
|| gh release create "$TAG" --repo "$REPO" --draft --verify-tag \
--title "Free Itch Games $TAG" --generate-notes \
|| true # release_android.yml may have created it a moment earlier
IS_DRAFT=$(gh release view "$TAG" --repo "$REPO" --json isDraft -q .isDraft)
if [ "$IS_DRAFT" != "true" ]; then
echo "::error::Release $TAG is already published — tauri-action only uploads into drafts."
exit 1
fi
echo "release_id=$(gh release view "$TAG" --repo "$REPO" --json databaseId -q .databaseId)" >> "$GITHUB_OUTPUT"
build-tauri:
needs: create-release
# Tag builds need the draft; manual dispatch builds without one.
if: ${{ !cancelled() && (needs.create-release.result == 'success' || needs.create-release.result == 'skipped') }}
permissions:
contents: write
timeout-minutes: 60
strategy:
fail-fast: false
matrix:
include:
# Apple Silicon — native build on M-series runner.
- platform: 'macos-latest'
tauri_target: 'aarch64-apple-darwin'
arch_label: 'aarch64'
args: '--target aarch64-apple-darwin'
# Intel — cross-compile from Apple Silicon runner because GitHub
# retired `macos-13` from free hosted runners (jobs sit in 'queued'
# forever and get auto-cancelled). Xcode CLI tools on `macos-latest`
# ship the x86_64 SDK and rustup adds the target below.
- platform: 'macos-latest'
tauri_target: 'x86_64-apple-darwin'
arch_label: 'x86_64'
args: '--target x86_64-apple-darwin'
# Kept on 22.04 on purpose: .deb/AppImage built here run on glibc 2.35+
# (24.04 would raise the floor to 2.39). 22.04 retires 2027-04.
- platform: 'ubuntu-22.04'
tauri_target: ''
arch_label: ''
args: ''
- platform: 'windows-latest'
tauri_target: ''
arch_label: ''
args: ''
runs-on: ${{ matrix.platform }}
steps:
- name: Checkout repository
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
with:
persist-credentials: false
- name: Set up Node.js
uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7.1.0
with:
node-version-file: webapp/.node-version
# No dependency cache in release builds: a poisoned cache could end
# up inside signed installers. Releases are rare; take the extra minutes.
package-manager-cache: false
- name: Set up Rust
uses: dtolnay/rust-toolchain@683b588c487a69d01f6c6ddf40f036ff682cc2c8 # master
with:
toolchain: stable
targets: ${{ matrix.tauri_target }}
- name: Install Linux deps
if: matrix.platform == 'ubuntu-22.04'
run: |
sudo apt-get update
sudo apt-get install -y \
libwebkit2gtk-4.1-dev \
libappindicator3-dev \
librsvg2-dev \
patchelf \
build-essential \
libssl-dev
- name: Install npm deps
working-directory: webapp
run: npm ci
- name: Build Tauri app
uses: tauri-apps/tauri-action@1deb371b0cd8bd54025b384f1cd735e725c4060f # action-v1.0.0
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
with:
projectPath: webapp
releaseId: ${{ needs.create-release.outputs.release_id }}
uploadWorkflowArtifacts: ${{ !startsWith(github.ref, 'refs/tags/') }}
args: ${{ matrix.args }}
# Tauri's bundler doesn't ship .pkg natively, so build it ourselves with
# pkgbuild (preinstalled on macOS runners). Runs even if the DMG step
# above failed, as long as the .app bundle was produced — which it always
# is, the failure is at the DMG packaging stage.
- name: Build .pkg installer (macOS)
if: ${{ !cancelled() && startsWith(matrix.platform, 'macos') && startsWith(github.ref, 'refs/tags/') }}
shell: bash
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
TAG: ${{ github.ref_name }}
REPO: ${{ github.repository }}
TAURI_TARGET: ${{ matrix.tauri_target }}
ARCH_LABEL: ${{ matrix.arch_label }}
run: |
set -e
CONF="$GITHUB_WORKSPACE/webapp/src-tauri/tauri.conf.json"
BUNDLE_DIR="webapp/src-tauri/target/$TAURI_TARGET/release/bundle/macos"
if [ ! -d "$BUNDLE_DIR" ]; then
echo "::warning::No macOS bundle directory at $BUNDLE_DIR — skipping pkgbuild."
exit 0
fi
cd "$BUNDLE_DIR"
APP=$(ls -d *.app 2>/dev/null | head -1 || true)
if [ -z "$APP" ]; then
echo "::warning::No .app bundle found — skipping pkgbuild."
exit 0
fi
VERSION=$(node -p "require('$CONF').version")
# Read the identifier from config so it never drifts from the app's
# real bundle ID (changed to a hyphen-free, Android-valid value).
IDENTIFIER=$(node -p "require('$CONF').identifier")
PKG_NAME="$(basename "$APP" .app)_${VERSION}_${ARCH_LABEL}.pkg"
pkgbuild \
--component "$APP" \
--identifier "$IDENTIFIER" \
--version "$VERSION" \
--install-location /Applications \
"$PKG_NAME"
ls -la "$PKG_NAME"
gh release upload "$TAG" "$PKG_NAME" --repo "$REPO" --clobber
+65 -12
View File
@@ -1,25 +1,78 @@
name: Update JSON file game information
# Ingest queued links from scripts/temp_link.json (written by the admin
# Worker and its cron) plus an optional dispatched URL.
#
# Runs right away when temp_link.json changes on main (pushes made by GitHub
# Apps trigger it; this workflow's own GITHUB_TOKEN push does not, so no loop),
# and once a day as a safety net. Keep the filename: released apps and
# external tools dispatch `update.yml` by name.
name: Ingest queued games
on:
schedule:
- cron: '0 3 * * *' # Runs daily at 03:00 UTC
- cron: '23 1 * * *'
push:
branches: [main]
paths:
- 'scripts/temp_link.json'
workflow_dispatch:
inputs:
url:
description: 'itch.io URL to add (optional; if empty, processes scripts/temp_link.json)'
required: false
type: string
permissions: {}
# One ingest at a time, FIFO. `queue: max` matters: with the default queue a
# newer pending run replaces an older pending one, which would silently drop
# that run's dispatched `url` (it is only in the run's input until the run
# writes it to temp_link.json).
concurrency:
group: ingest
cancel-in-progress: false
queue: max
env:
PYTHONUNBUFFERED: '1'
jobs:
update-game-info:
ingest:
runs-on: ubuntu-latest
timeout-minutes: 60
permissions:
contents: write
steps:
- name: Checkout repository
uses: actions/checkout@v6
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1 # zizmor: ignore[artipacked] — commit_push.sh pushes with this token; no artifacts are uploaded from this job
with:
token: ${{ secrets.GH_TOKEN }}
ref: main
- name: Set up Python
uses: actions/setup-python@v6
uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
with:
python-version: 3.14
python-version-file: .github/python-version
cache: pip
cache-dependency-path: requirements.txt
- name: Run bash script to update game info
run: |
chmod +x ./bash/test.sh
./bash/test.sh
shell: bash
- name: Install dependencies
run: pip install -r requirements.txt
- name: Scrape queued links
timeout-minutes: 50
env:
INPUT_URL: ${{ inputs.url }}
run: python scripts/update_info.py --out "$RUNNER_TEMP/patch.json" --deadline-min 45
- name: Apply, validate and push
if: ${{ !cancelled() }}
run: bash bash/commit_push.sh "$RUNNER_TEMP/patch.json" "Ingest queued games [$(date -u +%F)]"
notify:
needs: [ingest]
if: always() && (contains(needs.*.result, 'failure') || contains(needs.*.result, 'cancelled'))
permissions: {}
uses: ./.github/workflows/notify-failure.yml
with:
summary: ingest=${{ needs.ingest.result }}
secrets:
DISCORD_CI_WEBHOOK: ${{ secrets.DISCORD_CI_WEBHOOK }}
-26
View File
@@ -1,26 +0,0 @@
name: Export Data from JSON -> CSV
on:
schedule:
- cron: '13 4 * * *' # 4:13 UTC
workflow_dispatch:
jobs:
csv-export:
runs-on: ubuntu-latest
steps:
- name: Checkout repo
uses: actions/checkout@v6
with:
token: ${{ secrets.GH_TOKEN }}
- name: Set up Python
uses: actions/setup-python@v6
with:
python-version: '3.14'
- name: Run bash script to export data
run: |
chmod +x ./bash/export_csv.sh
./bash/export_csv.sh
shell: bash
+64
View File
@@ -0,0 +1,64 @@
# Checks the web app on pull requests. Deployment is NOT done here —
# Cloudflare Workers Builds deploys main from webapp/wrangler.jsonc.
name: Webapp CI
on:
pull_request:
paths:
- 'webapp/**'
- '.github/workflows/webapp-ci.yml'
permissions: {}
concurrency:
group: webapp-ci-${{ github.ref }}
cancel-in-progress: true
jobs:
check:
runs-on: ubuntu-latest
timeout-minutes: 15
permissions:
contents: read
defaults:
run:
working-directory: webapp
steps:
- name: Checkout repository
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
with:
persist-credentials: false
- name: Set up Node.js
uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7.1.0
with:
node-version-file: webapp/.node-version
cache: npm
cache-dependency-path: webapp/package-lock.json
- name: Install dependencies
run: npm ci
# The web build never runs `tauri build`, which refuses mismatched
# crate / npm versions; without this a Dependabot bump on one side
# surfaces only when the release workflows run on a tag.
- name: Tauri crates match their npm packages
run: npm run check:tauri
- name: Worker types are up to date
run: npm run cf:types -- --check
- name: Lint
run: npm run lint
- name: Unused code (knip)
run: npm run knip
- name: Unit tests (Worker, app; D1 tests run a local workerd)
run: npm test
- name: Type-check and build
run: npm run build
- name: Validate Workers config (dry run)
run: npx wrangler deploy --dry-run --env=""
+21 -1
View File
@@ -1,3 +1,23 @@
# Local-only files (personal contacts, QR assets)
/username.txt
/assets/qr/
# Cloudflare Wrangler local state / secrets
.wrangler/
.dev.vars*
!.dev.vars.example
.env*
!.env.example
# Android signing material
*.jks
*.keystore
/webapp/node_modules/
/webapp/dist/
/webapp/src-tauri/target/
/webapp/src-tauri/gen/
.idea/*
cmake-build-*/
*.iws
@@ -234,7 +254,6 @@ dist/
downloads/
eggs/
.eggs/
lib/
lib64/
parts/
sdist/
@@ -296,3 +315,4 @@ dmypy.json
.pytype/
cython_debug/
.DS_Store
.claude/
+50 -49
View File
@@ -1,60 +1,61 @@
# Changelog
All notable changes to this project will be documented here. I'm a noob dev, so versions are "when I feel like it".
All notable changes to this project, newest first. The notes of each release live in
[`changelog/`](changelog/), one file per minor version: `changelog/<major>.x/ver<major>.<minor>.x.md`.
## [1.0.4] - 2026-01-11 (Added Games + New Features ⭐)
**Latest release: [4.4.1](changelog/4.x/ver4.4.x.md#441---2026-10-16-extension-and-bot-retired) (2026-10-16) — Extension and bot retired.**
### Added Games
Added 33 games. (See [#22](https://github.com/poli0981/free-games-itchio-list/issues/22) and [#23](https://github.com/poli0981/free-games-itchio-list/issues/23) for details) .
## 4.x
### New features
- Delete game with correct link in [`delete_game.py`](/scripts/delete_game.py), see details in [#20](https://github.com/poli0981/free-games-itchio-list/issues/20) .
- Export JSON -> `.csv`/`.xlsx` in [`export_csv.py`](/scripts/export_csv.py), see details in [#21](https://github.com/poli0981/free-games-itchio-list/issues/21).
- Check duplicate data in JSON file in [`check_duplicate.py`](/scripts/check_duplicate.py), see details in [#19](https://github.com/poli0981/free-games-itchio-list/issues/19).
| Version | Date | Highlights |
|---|---|---|
| [4.4.1](changelog/4.x/ver4.4.x.md#441---2026-10-16-extension-and-bot-retired) | 2026-10-16 | Extension and bot retired (archived repos), ingest API removed |
| [4.4.0](changelog/4.x/ver4.4.x.md#440---2026-10-13-admin-automation-bulk-actions-smoother-charts) | 2026-10-13 | Admin automation, bulk actions, smoother charts |
| [4.3.0](changelog/4.x/ver4.3.x.md#430---2026-10-10-ai-disclosure-accessibility-refreshed-catalog) | 2026-10-10 | AI disclosure, accessibility, refreshed catalog |
| [4.2.0](changelog/4.x/ver4.2.x.md#420---2026-10-03-compact-catalog-data-themed-scrollbars) | 2026-10-03 | Compact catalog data, themed scrollbars |
| [4.1.1](changelog/4.x/ver4.1.x.md#411---2026-09-29-new-contact-addresses) | 2026-09-29 | New contact addresses (@poli0981.dev) |
| [4.1.0](changelog/4.x/ver4.1.x.md#410---2026-09-24-verification-check-readable-charts-changelog-folder) | 2026-09-24 | Verification check, readable charts, changelog folder |
| <a name="400---2026-09-18-freeitchgameswin-on-cloudflare-read-only-site-review-queue-new-design"></a>[4.0.0](changelog/4.x/ver4.0.x.md#400---2026-09-18-freeitchgameswin-on-cloudflare-read-only-site-review-queue-new-design) | 2026-09-18 | freeitchgames.win on Cloudflare: read-only site, review queue, new design |
## [1.0.3] - I forgot the date again (Improvements ⚙️)
## 3.x
### Improvements
- Improved: optimize workflow.
| Version | Date | Highlights |
|---|---|---|
| <a name="390---2026-06-15-android-minsdk--11--api-30"></a>[3.9.0](changelog/3.x/ver3.9.x.md#390---2026-06-15-android-minsdk--11--api-30) | 2026-06-15 | Android minSdk → 11 / API 30 |
| <a name="380---2026-06-15-android-apk-target-"></a>[3.8.0](changelog/3.x/ver3.8.x.md#380---2026-06-15-android-apk-target-) | 2026-06-15 | Android APK target 📱 |
| <a name="371---2026-06-14-hotfix--desktop-build-vs-invalid-tauri-nsis-license-key"></a>[3.7.1](changelog/3.x/ver3.7.x.md#371---2026-06-14-hotfix--desktop-build-vs-invalid-tauri-nsis-license-key) | 2026-06-14 | Hotfix — desktop build vs invalid Tauri NSIS license key |
| <a name="370---2026-06-14-legal-acceptance-gates--per-tab-chart-lazy-loading"></a>[3.7.0](changelog/3.x/ver3.7.x.md#370---2026-06-14-legal-acceptance-gates--per-tab-chart-lazy-loading) | 2026-06-14 | Legal-acceptance gates + per-tab chart lazy-loading |
| <a name="361---2026-06-12-hotfix--desktop-build-vs-broken-time-0348"></a>[3.6.1](changelog/3.x/ver3.6.x.md#361---2026-06-12-hotfix--desktop-build-vs-broken-time-0348) | 2026-06-12 | Hotfix — desktop build vs broken `time` 0.3.48 |
| <a name="360---2026-06-12-i18n-envi--offline-cache--custom-error-pages"></a>[3.6.0](changelog/3.x/ver3.6.x.md#360---2026-06-12-i18n-envi--offline-cache--custom-error-pages) | 2026-06-12 | i18n EN/VI + offline cache + custom error pages |
| <a name="352---2026-05-23-dead-code-cleanup--knip--vulture"></a>[3.5.2](changelog/3.x/ver3.5.x.md#352---2026-05-23-dead-code-cleanup--knip--vulture) | 2026-05-23 | Dead-code cleanup — knip + vulture |
| <a name="351---2026-05-20-lint-cleanup--zero-eslint-problems"></a>[3.5.1](changelog/3.x/ver3.5.x.md#351---2026-05-20-lint-cleanup--zero-eslint-problems) | 2026-05-20 | Lint cleanup — zero ESLint problems |
| <a name="350---2026-05-20-charts-expansion--game-count-history--pipeline-cleanup"></a>[3.5.0](changelog/3.x/ver3.5.x.md#350---2026-05-20-charts-expansion--game-count-history--pipeline-cleanup) | 2026-05-20 | Charts expansion + game-count history + pipeline cleanup |
| <a name="341---2026-05-17-hotfix-datatable-column-alignment--discussion-announce-auto-discovery"></a>[3.4.1](changelog/3.x/ver3.4.x.md#341---2026-05-17-hotfix-datatable-column-alignment--discussion-announce-auto-discovery) | 2026-05-17 | Hotfix: DataTable column alignment + Discussion-announce auto-discovery |
| <a name="340---2026-05-16-periodic-refresh-workflows--utf-8-round-trip-fix"></a>[3.4.0](changelog/3.x/ver3.4.x.md#340---2026-05-16-periodic-refresh-workflows--utf-8-round-trip-fix) | 2026-05-16 | Periodic refresh workflows + UTF-8 round-trip fix |
| <a name="330---2026-05-16-mobile-polish--settings--in-browser-gpg-commit-signing"></a>[3.3.0](changelog/3.x/ver3.3.x.md#330---2026-05-16-mobile-polish--settings--in-browser-gpg-commit-signing) | 2026-05-16 | Mobile polish + Settings + in-browser GPG commit signing |
| <a name="321---2026-05-11-hotfix-single-instance-enforcement-on-desktop"></a>[3.2.1](changelog/3.x/ver3.2.x.md#321---2026-05-11-hotfix-single-instance-enforcement-on-desktop) | 2026-05-11 | Hotfix: single-instance enforcement on desktop |
| <a name="320---2026-05-10-ci-cleanup--mobile--seo--telegram-bot-path--auto-discussion"></a>[3.2.0](changelog/3.x/ver3.2.x.md#320---2026-05-10-ci-cleanup--mobile--seo--telegram-bot-path--auto-discussion) | 2026-05-10 | CI cleanup + mobile + SEO + Telegram bot path + auto-discussion |
| <a name="314---2026-05-05-legal-docs-rewrite--vietnamese-i18n--legal-card--ui-polish"></a>[3.1.4](changelog/3.x/ver3.1.x.md#314---2026-05-05-legal-docs-rewrite--vietnamese-i18n--legal-card--ui-polish) | 2026-05-05 | Legal docs rewrite + Vietnamese i18n + Legal Card + UI polish |
| <a name="313---2026-05-05-credit-claude-code-as-ai-co-author"></a>[3.1.3](changelog/3.x/ver3.1.x.md#313---2026-05-05-credit-claude-code-as-ai-co-author) | 2026-05-05 | Credit Claude Code as AI co-author |
| <a name="312---2026-05-05-offline-link-fix--about-expansion--docs-sweep"></a>[3.1.2](changelog/3.x/ver3.1.x.md#312---2026-05-05-offline-link-fix--about-expansion--docs-sweep) | 2026-05-05 | Offline link fix + About expansion + docs sweep |
| [3.1.1](changelog/3.x/ver3.1.x.md#311---2026-05-04-cross-compile-macos-x86_64-from-apple-silicon) | 2026-05-04 | Cross-compile macOS x86_64 from Apple Silicon |
| [3.1.0](changelog/3.x/ver3.1.x.md#310---2026-05-04-macos-dmg-fix--pkg-installer--pagination) | 2026-05-04 | macOS DMG fix + .pkg installer + pagination |
| [3.0.1](changelog/3.x/ver3.0.x.md#301---2026-05-04-tauri-icons--fine-grained-pat-fix) | 2026-05-04 | Tauri icons + fine-grained PAT fix |
| <a name="300---2026-05-04-webapp--desktop-️"></a>[3.0.0](changelog/3.x/ver3.0.x.md#300---2026-05-04-webapp--desktop-️) | 2026-05-04 | Webapp + Desktop 🖥️📊 |
## [1.0.2] - I forgot the date (Hotfix 🔧)
## 2.x
### Fixed
- Fixed: fix file [`temp_file.json`](/scripts/temp_link.json) don't automatically reset to `[]` after run github actions.
| Version | Date | Highlights |
|---|---|---|
| <a name="200---2026-03-26-major-rewrite-"></a>[2.0.0](changelog/2.x/ver2.0.x.md#200---2026-03-26-major-rewrite-) | 2026-03-26 | Major Rewrite 🔧⭐ |
## [1.0.1] - 2025-12-31 (Hotfix 🔧)
## 1.x
### Fixed
- Rewrite and add 2 issue template.
- Update [CONTRIBUTING](CONTRIBUTING.md).
## [1.0.0] - 2025-12-28 (Initial Release 🚀)
### Added
- Full curated list of free itch.io games with auto-daily updates via GitHub Actions.
- Scraping script ([`update_info.py`](scripts/update_info.py)): add links → scrape title/dev/genre/desc/nsfw/thumbnail.
- MD table generator ([`generate_md.py`](scripts/generate_md.py)): split by genre, 300 max per file, in `/lists/`.
- Columns:
> No | Thumb | Name | Dev | Short Desc | Link | Safe | Notes | NSFW.
- [`temp_link.json`](/scripts/temp_link.json) for easy manual adds (Actions process daily).
- Full docs: [DISCLAIMER](/docs/DISCLAIMER.md), [PRIVACY](/docs/PrivacyPolicy.md), [TERMS](/docs/ToS.md), [EULA](/docs/EULA.md),
[SECURITY](SECURITY.md),
[CODE_OF_CONDUCT](CODE_OF_CONDUCT.md),
[CONTRIBUTING](CONTRIBUTING.md), [ACKNOWLEDGEMENTS](/docs/ACKNOWLEDGEMENTS.md),
[MY_STUFF](docs/My_Stuff.md).
- Issue & PR templates for ***bugs/features/add games***.
- Badges, TOC, example in [README](README.md).
---
### Fixed
- Multiple scrape bugs (itch.io HTML changes — thanks Grok for fixes).
- Description too long → now short + "(see more on itch.io)".
- Tables reset No. per file, primary genre first.
### Thanks
- Grok (xAI): Carried 99% of this repo. True buddy.
- itch.io: For all the free gems.
- Future contributors: You're legends already.
Built during unemployment peak. More updates when boredom strikes again :D
| Version | Date | Highlights |
|---|---|---|
| <a name="105---2026-01-12-hotfix-"></a>[1.0.5](changelog/1.x/ver1.0.x.md#105---2026-01-12-hotfix-) | 2026-01-12 | Hotfix 🔧 |
| <a name="104---2026-01-11-added-games--new-features-"></a>[1.0.4](changelog/1.x/ver1.0.x.md#104---2026-01-11-added-games--new-features-) | 2026-01-11 | Added Games + New Features ⭐ |
| <a name="103---date-unknown-improvements-️"></a>[1.0.3](changelog/1.x/ver1.0.x.md#103---2026-01-01-improvements-️) | 2026-01-01 | Improvements ⚙️ |
| <a name="102---date-unknown-hotfix-"></a>[1.0.2](changelog/1.x/ver1.0.x.md#102---2026-01-01-hotfix-) | 2026-01-01 | Hotfix 🔧 |
| <a name="101---2025-12-31-hotfix-"></a>[1.0.1](changelog/1.x/ver1.0.x.md#101---2025-12-31-hotfix-) | 2025-12-31 | Hotfix 🔧 |
| <a name="100---2025-12-28-initial-release-"></a>[1.0.0](changelog/1.x/ver1.0.x.md#100---2025-12-28-initial-release-) | 2025-12-28 | Initial Release 🚀 |
+172
View File
@@ -0,0 +1,172 @@
# Repo notes for Claude
Quick context so future Claude sessions don't have to re-derive it.
## What this repo is
A curated, auto-updating catalog of free itch.io games, published at **https://freeitchgames.win** (read-only for
everyone; the old github.io URL only redirects). Three layers share one JSON catalog:
1. **Python pipeline** — the data layer (GitHub Actions).
- `data_game/game_info_NNN.json` — chunked records, max 500 per file, 3,251 games on 2026-10-10. Serialization is fixed: `json.dumps(..., ensure_ascii=False, indent=4)`, no trailing newline (`json_io.dumps`) — the Worker port (`webapp/worker/catalog.ts`) emits identical bytes (`tests/fixtures/golden/`).
- `data_game/index.json` — chunk manifest (total + per-file counts). `data_game/count_history.json` — date-keyed `{date,total}` series ("games over time" chart). `scripts/deleted_games.json` — removal log (public "Removed" page). `scripts/temp_link.json` — ingest queue.
- `scripts/` — scanners never write the catalog: `update_info.py` (queued URLs) and `refresh.py` (rotating 1/7-per-day check; `--full` re-scrape) emit a URL-keyed **patch** (`patch.py`); `apply_patch.py` applies it to the latest `main` and runs `validate.py`; `bash/commit_push.sh` does fetch → reset → apply → commit → push with retries. Shared: `scraper.py` (session, `Pacer` + 429 back-off, parsing: the info panel incl. itch.io's 2025–26 rows — `AI Disclosure` ("AI Assisted", then what for) / `Content` linking `/games/tag-no-ai` → `ai_disclosure` + `ai_content`, `Accessibility` → `accessibility`; `description` = the creator's tagline (`og:description`), else the first sentence), `data_store.py` (chunks stay in place, rebalance only past thresholds, write-if-changed), `json_io.py`, `canonical.py` (canonical itch.io URL; vectors in `tests/fixtures/url_vectors.json`, shared with the Worker). Pipeline bookkeeping lives in `scripts/state/` (not published), including `ingest_outcomes.json` (how each queued link ended — added / duplicate / paid / dead / private / deleted / gave_up; patch key `ingest_outcomes`; the last 90 days, ≤ 5,000) that the admin's tracking and the cron's reconcile read. Tests: `pytest` (network blocked). Lint: `ruff check scripts tests webapp/scripts`, `ruff format`, `vulture` (config in root `pyproject.toml`). Local env: Python 3.15 (`.github/python-version`, gotcha 39; ruff `target-version = "py315"`), `python -m venv .venv && .venv/Scripts/pip install -r requirements-dev.txt` (3.15 is in UTF-8 mode by default — no `PYTHONUTF8` needed, the workflows no longer set it).
2. **Cloudflare Worker + static assets** — `webapp/worker/` + `webapp/wrangler.jsonc`, deployed by **Cloudflare Workers Builds** from `main` (root dir `webapp`, build `npm run build`, deploy `npx wrangler deploy`; no deploy workflow). The catalog is bundled into the site at build time (`vite-plugins/catalog-data.ts` → `dist/data/pack/` compact packs + the legacy readable JSON in `dist/data/`, plus `data/urls.json` and `sitemap.xml`), so every data commit rebuilds the site.
3. **Web app + Tauri apps** — `webapp/src/` (React 19.3 + TypeScript 7.0 + Vite 8/rolldown + Tailwind + shadcn/ui + React Router 8), and the **Tauri 2 desktop + Android** read-only viewers in `webapp/src-tauri/` (same code; they fetch `https://freeitchgames.win/data/pack` and load covers straight from img.itch.zone). Plus `webapp/admin/` — the maintainer-only admin app (second Vite entry, served at `/admin/`).
Adding games: the public **Suggest** page (`/suggest`, Turnstile) and RSS discovery (Worker cron) feed a **D1 review queue** (the browser extension's `POST /api/ingest` was removed in 4.4.1; the extension `poli0981/itch-f2p-extension` and the Telegram bot `poli0981/telegram-scraper-bot` are archived repos); approving in `/admin` commits the URLs to `scripts/temp_link.json` as a GitHub App, which triggers `update.yml`. Since 4.4 the cron also approves by rule (`/admin` → Settings, on by default: unflagged `rss` / `form` items nobody rejected within 24 h, only those found after the switch-on baseline `since`, ≤ 100 per run) and queues the new free games of **followed itch.io collections** directly (removed or flagged ones go to the queue) — the policies say so (ToS §5, Privacy §2.4, Disclaimer §4). The Add page takes any text, a file or a collection, **Check**s it first (dry run), sends batches of 200 and follows each game's ingest (`/api/admin/track`).
## How to work in webapp/
```sh
cd webapp # Node 26 (.node-version; engines >=26)
npm ci
npm run dev # Vite on http://localhost:5173 (proxies /api and /img to wrangler dev on :8787)
npx wrangler dev # the Worker + built assets (run `npm run build` first); .dev.vars holds local secrets
npm run build # → webapp/dist/ (public app + /admin/ + /data + sitemap); Tauri builds use the same dir
npm test # vitest (worker/, src/lib); worker/test/* D1 tests spawn a local workerd via getPlatformProxy
npm run lint && npm run knip && npx tsc -b
npm run cf:types # after editing wrangler.jsonc (ignores .dev.vars via types.env; CI runs it with --check)
npx wrangler d1 migrations apply freeitchgames --local # local D1 (use --remote by hand for production)
npm run tauri:dev # native window; needs Rust toolchain
npm run tauri:build # native installers
npm run tauri icon -- path/to/source-1024.png # regenerate src-tauri/icons/
npm run tauri -- android init # generate src-tauri/gen/android (gitignored)
npm run tauri -- android build --apk --target aarch64 # arm64-v8a release APK (unsigned; CI post-signs)
```
Local admin without Access: put `DEV_ADMIN_EMAIL=you@example.com` in `webapp/.dev.vars` — honoured only when the host is localhost. Turnstile test keys work locally (`TURNSTILE_SITEKEY=1x00000000000000000000AA`, `TURNSTILE_SECRET=1x0000000000000000000000000000000AA`, `SITE_ORIGIN=http://localhost:<port>` in `.dev.vars`); add a 32+ character `GATE_SECRET` to try the verification gate under `npx wrangler dev` (on localhost the cookie is `fig_gate` without `Secure`, and no bot token is needed). `npm run dev` never sees the gate — except that its `/img` proxy to `wrangler dev` does. Android details live in `webapp/TAURI.md` → **Android APK**. Path alias: `@/*` → `webapp/src/*`.
## Worker (`webapp/worker/`)
- `index.ts` routes: `/img/*` (img.ts, behind the gate), `/api/health`, `/api/verify` (gate.ts), `/api/suggest` (suggest.ts), `/api/admin/*` + `/admin*` (admin.ts), the readable `/data/*.json` (legacy-data.ts), everything else that misses an asset → `spa.ts`. `run_worker_first` also lists `/` (otherwise served straight from `dist/index.html`) so the gate sees it, and the five legacy catalog files one by one (never a `!` pattern — gotcha 26). `scheduled()` (cron `23 */4 * * *`), four steps each in its own try/catch: `discover.ts` (one itch.io RSS feed per run, 6 h back-off on 429) → `QueueStore.reconcile` (queued → ingested / failed with the pipeline's outcome, read at head through the GitHub App; else in the catalog → ingested, > 3 days → failed `timeout`) → `automation.ts` (auto-approve + followed collections, ≤ 30 itch.io pages a run, ONE `[auto]` commit, D1 written only after it lands; the run's summary in settings `automation_last_run`) → `purge` (Suggest notes 180 d). The account is on **Workers Paid** (30 s CPU): admin catalog edits parse and rewrite ~3.8 MB in the Worker (≈ 25–30 ms for 100 removals).
- `img.ts`: `/img/<160|640>/<path on img.itch.zone>` — allow-listed against `data/urls.json`, edge cache → R2 `THUMBS` (`w{w}/<sha256>.webp`) → `cf.image` transform (stored once) → fallback streams the original with a 1-day cache (quota error 9422). The fallback original and a missing upstream image are also kept in `caches.default` for a day (GET only); widths are the exact strings `160` / `640` (a `Map`, no `Number()` aliases); background puts log failures. Upstream errors → controlled 502.
- `spa.ts`: `not_found_handling` is `"none"`, so misses reach the Worker: `/assets/*`, `/data/*` (a pack from an older deploy included — `no-store`, CORS) and file-like paths get a real 404 (`no-store`); app routes get the shell with 200; unknown paths and game slugs not in the catalog get the shell with **404**; with the gate on, a visitor without a pass gets the verification page instead (checked before the shell is fetched, so never a 304). Keep its `ROUTES` in sync with `src/App.tsx` and `src/hooks/useSeoHead.ts`.
- `gate.ts` + `gate-page.ts`: the **verification gate** (web only). App pages and `/img` need a pass: the `__Host-fig_gate` cookie (HMAC of its issue time, HttpOnly, `BOT_GATE_TTL_HOURS`, default 48) set by `POST /api/verify` after a Turnstile check (action `gate`, `RL_GATE`, same-origin); `GET /api/verify` reports `{enabled, valid, via, ttl}`. The page is self-contained (inline CSS/JS with a per-response CSP nonce, EN/VI, the site's og tags, 200 + noindex). Verified bots pass with `x-fig-known-bot: <GATE_BOT_TOKEN>` from a zone Transform Rule; clients that only claim to be a crawler get 503. `/assets`, `/data`, `/api/*`, `/admin*` and the other static files stay open. `turnstile.ts`: siteverify shared with Suggest (hostname + action checked; the test secrets skip both).
- `access.ts`: verifies `Cf-Access-Jwt-Assertion` with jose (issuer + AUD). Maintainer = email in secret `ADMIN_EMAILS` + same-origin writes (the only identity: the service-token ingest is gone since 4.4.1).
- `admin.ts`: API (queue list / approve / reject / check (dry run) / add / track / edit one or ≤ 100 (`/games/bulk`) / remove one or ≤ 100 (`/games/remove`; after the commit the audit row and the R2 cleanup are best effort → `warnings`, never a 500) / restore / activity / settings / itch.io collections) and the `/admin` shell with its own CSP (theme-script hash included). Request limits shared with the admin app: `limits.ts`. `collections.ts` reads public itch.io collections (gotcha 36); `automation.ts` holds the cron's rules (`planCollectionItems`: only URLs D1 has never seen and without a flag are queued directly — no re-add loop for games the ingest dropped). The maintainer's email goes only to the D1 audit log, never into a commit (the repo is public).
- `repo.ts` + `github.ts` + `catalog.ts`: writes as a **GitHub App** (installation token, cached per isolate) with GraphQL `createCommitOnBranch` + `expectedHeadOid` (verified commits; `commitWithRetry` rebuilds from the new head on a race). Reads use the raw media type (no base64/UTF-8 mojibake). `catalog.ts` ports `data_store.py` byte-for-byte (golden fixtures).
- `legacy-data.ts`: the readable catalog JSON (`index.json`, `game_info_NNN.json`, `count_history.json`, `deleted_games.json`, `urls.json`) goes only to apps 4.0–4.1.1 — `Origin` `tauri://localhost` / `http(s)://tauri.localhost` → `env.ASSETS` passthrough + `Vary: Origin`; anyone else → **410** JSON with the repository links (`no-store`, CORS, a sampled `console.info` of the Origin). A nudge, not a security boundary: the data is public in the repo.
- `queue.ts`: URL classification (catalog → blocklist → pending → previously deleted) + the D1 store (`worker/migrations/`, additive only — never edit an applied migration; `0002` added `candidates.outcome`, `settings` and `watched_collections`; the `idempotency` table and `'ext'` in the `candidates.source` CHECK are unused leftovers of the ingest API removed in 4.4.1; URL lists bind in `IN` slices of 90, gotcha 37). `data.ts`: catalog facts read from the site's own `/data` via `env.ASSETS`, cached per isolate (loaded values only — see gotchas).
- Configuration: non-secret settings are `vars` in `wrangler.jsonc` (empty until setup); secrets (`GH_APP_PRIVATE_KEY` — the PEM GitHub downloads (PKCS#1) or PKCS#8; `github.ts` converts, `ADMIN_EMAILS`, `TURNSTILE_SECRET`, `GATE_SECRET`, `GATE_BOT_TOKEN`) via `wrangler secret put`, typed in `worker/env.ts` as optional. A feature whose settings are missing answers **503** (the gate just stays off); the public site needs none of them. `env.staging` = Worker `free-games-itchio-list-staging` on `staging.freeitchgames.win` (no cron, own R2/D1/rate-limit namespaces).
## Web app structure (`webapp/src/`)
- `routes/*.tsx` — one file per route (`/`, `/games`, `/games/:slug`, `/charts`, `/removed` (`/deleted` redirects), `/suggest`, `/settings`, `/about`, `/errors/:code`); `App.tsx` wires them; `components/app-router.tsx` picks **BrowserRouter on the web, HashRouter in Tauri**. `lib/legacy.ts` rewrites v3 `#/x` links to `/x` (crafted hashes go home) and deletes v3 PAT/GPG storage keys.
- Data: `lib/config.ts` (`PACK_BASE` = `/data/pack` on the web, `https://freeitchgames.win/data/pack` in Tauri). **Packs** (since 4.2): `lib/data/pack-format.ts` (pure, shared with the build plugin: records by column, dictionaries for repeated strings and every string list; `manifest-v1.json` names per chunk a `main` pack — every field but `description` — and a `desc` pack, plus `deleted` / `history`; files are `<sha256 prefix>.bin`, deflate-raw, served `immutable`). `lib/data/catalog.ts` loads them (`['db','all']` →`{ games, index: {total_games, last_updated}, chunks }`; the manifest revalidated per load and shared 10 s; a main-pack 404 → manifest `cache: 'reload'` + one retry; an unchanged manifest returns the previous result). `lib/data/compression.ts`: `DecompressionStream('deflate-raw')`, else lazy `fflate`. `Game` has **no `description`**: `hooks/useDescriptions.ts` loads `['desc', <file>]` on demand (game page: its chunk; Games search: all, `filterGames(…, descriptions)`).
- Cache: react-query persisted to IndexedDB (`webapp.query-cache`, 7 days) by `lib/data/persister.ts` — byte 0 = format (1 deflate-raw, 0 plain), then the JSON; a legacy string is dropped; writes throttled 1 s and skipped when no data object changed. Persisted: `db`, `deleted`, `count-history` and only the `desc` files the current catalog names (`shouldPersistQuery`); stale `desc` queries are removed after a `db` success. `CACHE_BUSTER = ${APP.version}:data-v2`. **`gcTime` must stay >= persist `maxAge`.**
- Layout: `components/site/*` (sticky top nav + global search with the `/` shortcut + display menu + phone sheet menu; footer) — the window scrolls, not `<main>`. `/` is the Welcome page (`routes/welcome.tsx`).
- `/games`: search, filters, sort and page live in the URL — `lib/game-filters.ts` (`parseQuery` / `toParams` drop defaults; params `q genre platform status tag lang input engine ai access rating browser sort page`; `ai` treats "N/A" / a missing field as its own "Not disclosed" value and lists its options in a fixed order (`aiRank`); unit-tested) — rendered by `components/games/*` (filter chips with facet counts that ignore their own filter, a desktop ARIA table / phone list chosen by `useIsMobile`, 100 per page; the detail page's breadcrumb links back to the same list via router state). Counts show the whole catalog ("2,729 of 2,811") because 18+ games are hidden by default.
- `components/charts/` (19 charts, 4 lazy tabs loaded with `lib/lazy-preload.ts` — preloaded when idle or on hover/focus, rendered without a Suspense fallback once loaded — and kept mounted once shown (gotcha 33; skeletons in `chart-skeletons.tsx` match the cards), every series spreading `SERIES_ANIMATION` (300 ms, no delay; a test checks), **no barrel `index.ts`**; every Recharts tooltip/cursor comes from `chart-theme.ts` + `chart-tooltip.tsx`, every pie legend from `LEGEND_BASE` there; below `md` the charts get 12 px legends / 11 px ticks from a media block in `index.css`, the tab bar is one row of equal tabs, and Languages / Avg session switch to horizontal bars via `useIsMobile`), `components/game-thumb.tsx` (`lib/thumbnail.ts` → `/img/160|640/...` on the web, the original URL in Tauri), `components/legal-gate.tsx` (a non-dismissable Radix dialog **over** the page, so deep links land where they pointed; links flagged `inGate` in `lib/about.ts`; re-prompts when `LEGAL_VERSION` in `stores/prefs.ts` changes; no "Leave" button in Tauri).
- Styling: **Tailwind v4** via `@tailwindcss/vite` (no PostCSS, no `tailwind.config`); tokens are hex CSS variables in `src/index.css` (`:root` / `.dark`, `@theme inline`; `--brand-soft`, `--thumb`, `--success`, `--scrollbar-thumb(-hover/-active)` besides the shadcn set) and must match the approved mockup. Themed scrollbars (`@layer base`, only under `(hover: hover) and (pointer: fine)`): `::-webkit-scrollbar*` for Chromium/Safari, `scrollbar-color` / `scrollbar-width: thin` for Firefox only (gotcha 28); "Hide scrollbars" = unlayered `html[data-scrollbars='hidden']` rules (`hooks/useScrollbarsEffect.ts`). On mouse devices `<html>` reserves the scrollbar gutter, released while a dialog locks scrolling (gotcha 35). The theme: `stores/theme.ts` (synced across tabs, site ↔ admin), `hooks/useThemeEffect.ts` (`.dark` + the `theme-color` metas), an inline pre-paint script in both HTML entries (gotcha 34), and the display menu's button shows `components/theme-icon.ts`'s icon for the theme in use. Self-hosted Geist / Geist Mono (`@fontsource-variable/*`, CSP `font-src 'self'`). Numbers and dates go through `lib/format.ts` (`useFormat`: en-GB / vi-VN). `webapp/scripts/gen_assets.py` redraws favicon, PWA icons and `og.png` from the same tokens and the Geist fonts in `node_modules`.
- `lib/gate.ts` (web only): when a tab comes back into view or a cover fails and the verification pass may have run out (`webapp.gate` hint), it asks `GET /api/verify` and reloads into the verification page; `lib/reload.ts` is the shared at-most-every-30-s reload guard.
- `hooks/useSeoHead.ts` sets canonical + robots per route (index.html has no static canonical/og:url on purpose).
- `lib/i18n/` — `en.ts` is the source of truth; `vi.ts` is `Record<MessageKey, string>` and must never be static-imported (lazy chunk).
- `stores/` — Zustand: `prefs` (`webapp.prefs`: language, density, `hideScrollbars`, legal acceptance…), `theme` (`webapp.theme`).
- `lib/about.ts` — keep `THIRD_PARTY` up to date when adding npm deps; `LEGAL_LINKS`; `APP.version`.
- Code split (`vite.config.ts` rolldown `codeSplitting.groups`): `vendor-react` (priority 100 — must claim React first), `vendor-query`, `vendor-ui`. There is deliberately **no vendor-charts group** (it pulled React/clsx in and put Recharts on the first load); Recharts stays in the lazy chart chunks. Initial load ≈ 179 KB gzip (JS + CSS, gzip -9; 4.2 added ~4.6 KB for the pack loader, persister and `useQueries`) plus ~51 KB of Geist woff2; catalog data on a first visit ≈ 264 KB (main packs + log + history), descriptions ≈ 170 KB on demand. `fflate` is a lazy chunk, never preloaded. Web build `target` is Safari/iOS 15.4 (Radix class static blocks otherwise break iOS 15); Tauri uses the default.
## Editable vs read-only fields
Each game has **20** fields (plus optional `added_at` / `updated_at`, appended by the pipeline, and since 4.3 the optional scraper fields `ai_disclosure` (`No AI|AI Assisted|N/A`) / `ai_content` / `accessibility`, which the daily refresh adds to older records — schema changes are additive only, installed v3 apps may still read the raw JSON). Only **3** are maintainer-editable: `safe_virus` (`?|Yes|No|Caution`), `notes`, `nsfw` (`Yes|No`) — via `/admin`. The other 17 are scraper output; no scrape (not even `--full`) overwrites the 3 editable fields.
## GitHub Actions
| Workflow | Trigger | Notes |
|---|---|---|
| `update.yml` | Push to `main` touching `scripts/temp_link.json` + daily 01:23 UTC + `workflow_dispatch` (`url`) | Ingest queue → patch → `commit_push.sh`. Workflow-level `concurrency: ingest` with **`queue: max`** (the default queue replaces a pending run, which would drop its dispatched `url`). A dispatched `url` is processed first and written to `temp_link.json` (`queue_add`) until it reaches a final outcome. Failed fetches count as an attempt only ≥ 6 h apart (`last_attempt`; 3 → given up), and a 429 counts as none. GitHub-App pushes (the admin Worker and its cron) trigger it; its own `GITHUB_TOKEN` push does not (no loop). Keep the filename. |
| `refresh.yml` | Daily 02:47 UTC + `workflow_dispatch` (`budget`, `url`, `allow_mass_removal`, `full`) | scan (read-only, 55-min step timeout, checks out the branch as it is when the job starts — not the queued SHA — so runs waiting in the queue see the previous run's state; patch artifact uploaded `if: always()`) → apply (`!cancelled()`: a failed / timed-out scan's checkpoint is applied, a cancelled run's is not) → notify. Workflow-level `concurrency: refresh-pipeline` + `queue: max` runs one whole scan → apply at a time (scheduled, manual and force-update runs alike). Removal needs the same 404/410, paid or `private` (itch.io's password form, `is_password_protected`; ingest drops such links as final) strike seen again ≥ 20 h after the first sighting (`strike_at`). Checkpoints never carry removals. **Mass-change guard:** a run whose removals or new strikes exceed max(10, 10 %) of the games it checked withholds all its removals and marks them — and, on a strike spike, all its strikes — `withheld_at`; later runs keep withholding those (they take at most half a run's budget) until a healthy check clears them, and alert (`mass_change`) — that pattern means itch.io markup changed; dispatch with `allow_mass_removal` only after checking on itch.io. `apply_patch.py` re-checks the same per-run limit and max(25, 5 %) of the catalog unless `ALLOW_MASS_REMOVAL=1`. |
| `force_update.yml` | `workflow_dispatch` ONLY (`url`, `budget`, `allow_mass_removal`) | Dispatches `refresh.yml` with `full: true` (`actions: write`; it used to call it through `uses:`, which failed at startup with no annotation): re-scrapes every scraper field for one URL or the next batch (rotates on `full` timestamps). Dispatch it N times in a row to cover N consecutive batches (FIFO, each from the latest main). Always preserves `safe_virus` / `notes` / `nsfw`. Canonical tool for repairing mojibake. |
| `notify-failure.yml` | `workflow_call` | Discord (`DISCORD_CI_WEBHOOK`) on failure / **cancelled** (job-level timeouts end as cancelled) / rate-limited / mass change / failed Cloudflare build. |
| `python-ci.yml` / `webapp-ci.yml` | PRs (+ pushes for Python) | ruff + format + vulture + pytest + `validate.py` / `npm run check:tauri` (gotcha 31) + `npm run cf:types -- --check` + lint + knip + vitest + build + `wrangler deploy --dry-run --env=""`. |
| `deploy-status.yml` | Hourly + manual | Not a deploy. `bash/cf_build_status.sh` walks main's first-parent history to the latest finished `Workers Builds: free-games-itchio-list` check run (Cloudflare posts it only when a build ends; branch commits carry preview builds under the same name) and alerts once per failed build (cache key per check-run id, saved after the Discord post). Scheduled because GitHub never starts `check_run` workflows for `GITHUB_TOKEN` pushes (the data commits). |
| `release_desktop.yml` | Tag `v*` push, or manual | `create-release` makes the single draft (id passed to tauri-action v1 `releaseId`); release builds use **no** npm/cargo caches (cache-poisoning). Win + macOS aarch64 + macOS x86_64 (cross-compile) + Linux (`ubuntu-22.04` for a low glibc floor). Uploads `.dmg` / `.app.tar.gz` / `.pkg` (macOS), `.msi` / `.exe` (Windows), `.deb` / `.rpm` / `.AppImage` (Linux). macOS `.pkg` `--identifier` reads `tauri.conf.json`. |
| `release_android.yml` | Tag `v*` push, or manual | Tauri **Android** build → arm64-v8a APK, **post-signed** with `zipalign`+`apksigner` (gen/ stays gitignored). Tag → attaches to the same draft Release; manual dispatch → workflow artifact. Secrets: `ANDROID_KEYSTORE_BASE64` / `ANDROID_KEYSTORE_PASSWORD` / `ANDROID_KEY_ALIAS`. |
| `announce-release.yml`, `notify-release-pipeline.yml` | Release published / pipeline runs | Reusable workflows from `poli0981/.github`, SHA-pinned — but at that pin they still check out their notifier script from that repo's `main`. |
| `announce-discussion.yml` | Release published; push to `main` touching `CHANGELOG.md` / `changelog/**` | Local. The release goes to Discussions → Announcements, a changelog push to → General unless the head commit says `[skip-discuss]`. |
All workflows: `permissions: {}` at the top, per-job grants, actions pinned by commit SHA.
## Release / tag process
```sh
git fetch origin
git tag -s vX.Y.Z origin/main -m "summary"
git push origin vX.Y.Z
# release_desktop.yml's create-release job opens ONE draft; desktop + Android jobs upload into it.
# When every asset is there, edit the notes and publish (this fires the announcements):
gh release edit vX.Y.Z --draft=false
```
Draft-first: **never** `gh release create` by hand before CI — tauri-action v1 refuses to upload into a published release, and announcements would go out before installers exist. Merge PRs into `main` with squash or a merge commit, never by fast-forward pushing a branch: its commits' preview-build check runs would then sit on main's own line and confuse `deploy-status.yml`. Tag from `main` only. Release notes go to `changelog/<major>.x/ver<major>.<minor>.x.md` plus a row in the `CHANGELOG.md` index (each row keeps the anchor of the old single-file heading as `<a name>`: published release notes link to them). Versions live in `webapp/src/lib/about.ts` (`APP.version`), `webapp/package.json`, `webapp/src-tauri/tauri.conf.json` and `Cargo.toml` (+ `Cargo.lock`) — keep them equal. GPG signing is wired through gpg-agent (`commit.gpgsign=true`, so `git tag -s` and `git commit` both sign; the pinentry must be answered — in unattended sessions commits fail rather than going unsigned). Signing key since 2026-10-10: `838884804847BE7AE5FCF0A96AD1AB0921B96825` (ed25519 certify-only primary, generated locally and never published before; signing subkey `ED0BFD3005662D5D`; `user.signingkey` = the primary fingerprint, global + repo). The old key `03F965C2E2DB5C6B` is **revoked** (compromised: it sat in the browser extension's storage, Sept 2026); tags up to v4.3.0 and older commits carry it. The owner's offline backup and revocation certificates live outside the repo.
## Licenses & policies
Code **MIT** (`LICENSE`); catalog data **CC BY 4.0** for the maintainer's contribution — excluding creators' descriptions, cover images, names/trademarks (`data_game/LICENSE.md`, `LICENSES/CC-BY-4.0.txt`); docs **CC BY 4.0**; map + non-affiliation in `NOTICE.md`. Policies (EN in `docs/`, VI mirrors in `docs/i18n/vi/`, English controls): ToS (website + data + content removal), EULA (desktop/Android binaries only; also `webapp/src-tauri/installer/EULA.rtf`), Privacy Policy, Disclaimer, `SECURITY.md`, `CODE_OF_CONDUCT.md`. When a policy changes, bump `LEGAL_VERSION` (`webapp/src/stores/prefs.ts`) and the dates in `about.legal.desc` (EN/VI) so the legal gate asks again. Contact addresses `contact@ / legal@ / privacy@ / security@ / takedown@poli0981.dev` are aliases of the maintainer's Google Workspace mailbox (not Cloudflare Email Routing; the Privacy Policy lists Google as the email processor). The maintainer's site https://poli0981.dev/ and channel hub https://poli0981.dev/links/ are linked from the About page (`DEV` in `lib/about.ts`).
## Known gotchas (cost a release each — don't relearn)
1. **`universal-apple-darwin` + `bundle_dmg.sh` is fragile** in headless CI. Use per-arch (`aarch64-apple-darwin`, `x86_64-apple-darwin`).
2. **`macos-13` is retired** from free GitHub-hosted runners. Cross-compile x86_64 from `macos-latest`.
3. **Tauri icons must exist before build.** `npm run tauri icon -- path/to/source.png`; the 1024×1024 source is gitignored, generated icons are committed.
4. **Tauri doesn't ship `.pkg`.** Built with `pkgbuild` after tauri-action and uploaded via `gh release upload`; the step uses `if: ${{ !cancelled() && … }}` so a DMG flake doesn't drop the PKG while a cancel still stops it.
5. **Vite v8 `base`** only accepts `'./'`, an absolute URL, or an empty string. Web uses `'/'` (BrowserRouter deep links), Tauri `'./'`.
6. **TypeScript 7 has no JS API (expected in 7.1), and typescript-eslint needs one** (peer `typescript <6.1`). So in `webapp/package.json` `typescript` is an alias of `@typescript/typescript6` (the 6.0 API for typescript-eslint and `scripts/i18n-edit.mjs`; bin `tsc6`) and TS 7 is `@typescript/native` (`npm:typescript@^7`), whose `tsc` is what `npm run build` / `npx tsc -b` run — `npx tsc --version` must say 7.x. Drop the alias once typescript-eslint accepts TS 7; never let Dependabot move the alias to 7. `baseUrl` is gone since TS 6: use `paths` alone.
7. **lucide-react v1+** removed brand icons (`Github`). Use `Library`, `Database`, etc.
8. **`bundle.windows.nsis.license` does NOT exist in `@tauri-apps/cli` 2.11** — use top-level `bundle.licenseFile`, and it must be **RTF** (WiX `.msi` requires it; NSIS auto-detects). File: `webapp/src-tauri/installer/EULA.rtf`.
9. **The bundle `identifier` must be alphanumeric** (`com.poli0981.freegamesitchio`): Android rejects `-`, Tauri's validator rejects `_`; one identifier serves every platform.
10. **Android signing: `zipalign` BEFORE `apksigner`**; never edit the generated Gradle; never lose the keystore. `versionCode = major*1e6 + minor*1e3 + patch` from `tauri.conf.json`. **`minSdkVersion` 30 (Android 11) is the install gate** — change it only in `tauri.conf.json` (`bundle.android.minSdkVersion`); no runtime OS check by design (reach ≈ 86.9 % mid-2026; see `docs/pc_spec.md`). The Android JDK setup must NOT use `cache: gradle` (gen/ doesn't exist at checkout).
11. **`webapp/dist/` is gitignored and `assets.directory` must be `./dist`.** In Sept 2026 a config-less deploy served the raw `webapp/` tree (source exposed).
12. **A Worker with static assets gets no `ctx.access`** — verify the Access JWT yourself (access.ts). **`workers_dev` and `preview_urls` must stay `false`**: those hostnames bypass Access.
13. **`public/_headers` applies only to responses served straight from assets**, not to responses the Worker builds (set headers in `worker/http.ts`). Responses fetched through `env.ASSETS` do carry them.
14. **With `run_worker_first` as an array, the asset layer's SPA fallback answers every miss before the Worker** — a stale hashed chunk got `index.html` + the year-long immutable cache. Hence `not_found_handling: "none"` + `spa.ts`.
15. **Never share an in-flight promise across requests in a Worker** (cache only resolved values): a pending subrequest dies with the request that started it (client disconnect) and every later awaiter hangs.
16. **itch.io cover URLs are signed per size**, so you can't rewrite `/original/` to a smaller variant — resizing goes through Image Transformations (`cf.image`) and R2.
17. **GitHub Actions concurrency keeps at most one *pending* run per group by default** and cancels the older pending one — use `queue: max` where a queued run carries unique input. A called workflow must not request its caller's group (deadlock → cancelled). **A queued run checks out the SHA from when it was triggered** (`workflow_dispatch`: the branch head at dispatch time), so runs waiting behind each other read the same state unless the job checks out `ref: ${{ github.ref }}` (refresh.yml's scan does).
18. **Pushes made with `GITHUB_TOKEN` trigger no workflows** (no ingest loop), and GitHub never starts `check_run` workflows for them (hence the scheduled `deploy-status.yml`). Workers Builds posts its check run only when a build ends.
19. **`wrangler types` reads `.dev.vars`** — `npm run cf:types` points it at the empty `types.env` so the committed `worker-configuration.d.ts` never depends on local secrets. Don't use `secrets.required` until every environment has the secrets (deploys fail without them).
20. **D1 migrations are applied by hand** (`npx wrangler d1 migrations apply freeitchgames --remote`), never in the build — and before deploying code that needs them. Production `freeitchgames` was created by command (APAC); its `database_id` is in `wrangler.jsonc` (not a secret). **R2 must be enabled on the account** (dashboard, payment method) before `wrangler r2 bucket create`; a deploy whose bucket is missing fails.
21. **React Router 8 wraps navigations in `startTransition` by default**: `useSearchParams` then returns the previous URL until the transition commits, so URL-driven state (the Games filters) overwrote itself on quick clicks. Both routers in `components/app-router.tsx` pass `useTransitions={false}`.
22. **`window.confirm` / `alert` / `prompt` do nothing in the macOS app** (wry's WebKit answers "Cancel"). Use in-app dialogs (`components/nsfw-dialog.tsx` + `requestNsfw()` in `lib/nsfw.ts`).
23. **The design tokens are hex: write `var(--x)`, never `hsl(var(--x))`.** The invalid colour painted the Recharts hover band black and left tooltips transparent (fixed in 4.1.0).
24. **Recharts 3 makes charts focusable** (`accessibilityLayer`, plus `tabindex` on inner `<g>`s): a mouse click focused the SVG, Chromium drew its black focus ring and the tooltip stuck on the first item. `ChartCard` keeps mouse clicks from moving focus; keyboard focus keeps the `--ring` outline.
25. **The verification gate fails open, and its off switch is deleting `GATE_SECRET`** (`BOT_GATE` changed in the dashboard is undone by the next deploy). It also needs `GATE_BOT_TOKEN` + the zone Transform Rule — without them Google would get the challenge; a client that only claims to be a crawler gets a 503, never the noindex page. Don't gate `/data`: every app version reads it — `/data/pack/*` (4.2+), and the legacy JSON (4.0–4.1.1, Tauri origins only; browsers get 410). Keep those legacy files in `dist/`: the Worker also reads `urls.json` and `deleted_games.json` through `env.ASSETS`.
26. **A negative `run_worker_first` pattern (`!/data/pack/*`) sends a missing file straight to the asset worker**, whose 404 still gets the `_headers` rules — for a pack, the year-long `immutable`, so a browser would cache the 404 of a name that can come back (rollback). List the Worker-first files positively; pack misses then reach `spa.ts` (`no-store`).
27. **A `desc` pack matches its games by row, so only within one build.** Load the `desc` named in the same `db` result; on a 404 refetch `db` (`useDescriptions.ts`), never re-resolve a desc file against a newer manifest for games already on screen.
28. **In Chromium 121+, `scrollbar-color` or `scrollbar-width` on an element switches its `::-webkit-scrollbar` styling off.** Keep the standard properties Firefox-only (`@supports not selector(::-webkit-scrollbar)`), except `scrollbar-width: none` for hiding.
29. **Pack names are content hashes: the build must stay deterministic** (column and dictionary order, zlib level 9 — a Node/zlib upgrade only re-downloads once), **and no hash may reach the JS bundle** (data-only deploys keep JS byte-identical; the manifest is fetched, never imported). `_headers` joins a header set by two matching rules with a comma — give each path one `Cache-Control`.
30. **itch.io shows the `Published` and `Updated` info rows only for a few weeks** after the event (every `Published` date in a 250-page sample of Oct 2026 was under four weeks old); an explicit `Release date` row stays. That is why `release_date` is N/A for most older games, and why a `--full` re-scrape keeps a known `release_date` / `thumbnail` instead of writing N/A (`KEEP_KNOWN_FIELDS` in `refresh.py`).
31. **Tauri crates and their npm packages must share major.minor** (`tauri` ↔ `@tauri-apps/api`, `tauri-plugin-x` ↔ `@tauri-apps/plugin-x`): `tauri build` refuses to build otherwise, and only the release workflows run it — every v4.3.0 release build first failed on `tauri-plugin-opener` 2.6.0 vs `@tauri-apps/plugin-opener` 2.7.0 after Dependabot bumped the npm side alone (#119). Webapp CI's `npm run check:tauri` (`webapp/scripts/check-tauri-versions.mjs`, lock files only) now fails such a PR; Dependabot's cargo updates run weekly on Mondays like npm so both groups arrive together. Fix a one-sided bump with `cargo update -p <crate>` in `webapp/src-tauri/`.
32. **Recharts hides category labels silently and styles legends its own way.** The default `interval="preserveEnd"` keeps a label only if its line box (font size × 1.5) plus `minTickGap` (5) fits its row, and the first one only if half of it fits above: the 15-row Genres chart showed 7 labels, without the two largest genres — category axes set `interval={0}`. A label wider than the axis wraps onto two lines, measured at the 16px body size unless `style` carries a size with a unit (`singleLineTick()` in `chart-theme.ts`). `<Legend>` sorts alphabetically (`itemSorter: 'value'`) and colours each label like its slice (amber/green text on white fails contrast) — pies spread `LEGEND_BASE`.
33. **Recharts' ResponsiveContainer unmounts its chart when it measures 0×0** (`display: none`, e.g. Radix's `hidden` panel): a hidden tab must keep its size. The Charts page force-mounts visited tabs and hides the inactive ones with `absolute inset-x-0 top-0 h-0 overflow-hidden invisible` + `inert` (no scroll height, no focus); switching back otherwise rebuilt every chart and replayed its animation. Its panel elements are memoised, so a tab switch re-renders only the tab bar (a re-render restarts Recharts tweens).
34. **The inline theme script's sha256 is in three CSPs**: `public/_headers`, `src-tauri/tauri.conf.json` and `THEME_SCRIPT_HASH` in `worker/admin.ts`. Change the script and `scripts/check-csp-hashes.test.mjs` fails with the hash to paste. A wrong hash only blocks the script (the old light flash). Keep `%` and `import(` out of it (Vite rewrites them in HTML).
35. **`scrollbar-gutter: stable` vs dialogs**: fixed overlays stop at the reserved gutter, and react-remove-scroll-bar adds the scrollbar width as body margin on top. Hence `html:not(:has(> body[data-scroll-locked]))` — the gutter is released while a dialog locks scrolling, which is then exactly the old behaviour.
36. **itch.io collection JSON** (`/c/<id>/<slug>?format=json&page=N`): `&page=1` redirects to the HTML page (page 1 has no `page`); a wrong or missing slug redirects to the canonical URL **without** the query string (re-request with the slug from `Location`); an unknown id answers 500; link attributes come in any order; past the last page `num_items` is 0. Zero cells while `num_items > 0` means changed markup: `collections.ts` reports it (422) and adds nothing.
37. **D1 counts every statement of a batch** towards its 1,000 queries per invocation: bind URL lists in `IN (…)` slices of ≤ 90 (100 bound parameters at most), as `setStatus` / `reconcile` / `markIngested` do, never one statement per URL.
38. **npm 11.20+ (Node 26) gates dependency install scripts on `allowScripts` in `webapp/package.json`.** esbuild and workerd are approved by name (their postinstall only checks the platform binary). A new dependency with an install script shows up in `npm install-scripts ls`; review it, then `npm install-scripts approve <pkg> --no-allow-scripts-pin` (name-only, so Dependabot bumps stay covered).
39. **Dependabot's pip updater reads `.python-version` and aborts on a Python it doesn't support** (3.10–3.14 as of Oct 2026): a `3.15` there stopped pip version updates and the pip dependency graph ("Dependabot detected the following Python requirement … '3.15.*'"). So the CI pin lives in `.github/python-version`, which only `setup-python`'s `python-version-file` reads (python-ci, refresh ×2, update); move it back to `.python-version` once Dependabot lists 3.15.
## Safe-edit rules
- Don't write `data_game/` from new code paths directly — go through a patch + `apply_patch.py` (or the Worker's `repo.ts`), so concurrent writers never clobber each other and `validate.py` gates every commit.
- Don't commit `webapp/dist/`, `webapp/src-tauri/target/`, `webapp/src-tauri/gen/`, `webapp/src-tauri/icon-source.png`, `.dev.vars`, `username.txt`, `assets/qr/`. `Cargo.lock` **is** committed (since v4).
- Never commit secrets (GitHub App key, admin emails, Turnstile secret, tokens). Data workflows push with the job's `GITHUB_TOKEN`; the Worker writes as the GitHub App.
- When adding an npm dep, also add it to `webapp/src/lib/about.ts` so the About page lists it.
## Current state (Oct 2026)
**Toolchain** (2026-10-22, on `main`, not released yet — goes into the next release's notes): TypeScript 7.0.2 (`@typescript/native`; `typescript` = the 6.0 API alias, gotcha 6), Node 26 (`webapp/.node-version`, `engines >=26`, `@types/node` 26, Workers Builds `NODE_VERSION` raised to 26 by the owner in the dashboard — `docs/operations.md` §1 step 1), Python 3.15 (`.github/python-version` — gotcha 39, ruff `py315`, `urllib3` declared since `scraper.py` imports it). No source change was needed: TS 7 reports 0 errors, the suites pass on Node 26.12 and Python 3.15.1.
**v4.4.1** (2026-10-16): the browser extension and the Telegram bot are retired — both repos (`poli0981/itch-f2p-extension`, `poli0981/telegram-scraper-bot`) were already public archives; an Announcements discussion says so. Removed: `POST /api/ingest` (`ingest.ts`, `requireService`, `RL_INGEST`, `ACCESS_AUD_INGEST`, the idempotency store — it never received a game: 0 `ext` rows in production D1), the admin's "Browser extension" auto-approve source and "Extension" label, the About page's Telegram numeric-ID note. The policies (Privacy, ToS, EULA + installer RTF, Disclaimer, Security; EN + VI) only lost the extension / ingest wording: "Last updated" 2026-10-16, `LEGAL_VERSION` deliberately unchanged (nothing new to accept, ToS §14). Unused repo secrets `GH_TOKEN`, `TELEGRAM_BOT_TOKEN`, `DISCUSSION_*` deleted. Ships Dependabot #131 (vite 8.3.4), #135 (tauri crates), #136 (serde_json), #137 (ruff).
**v4.4.0** (2026-10-13, PR #133): admin automation. Add page: any text / file / itch.io collection → **Check** (dry run) → batches of 200 → per-game ingest tracking (`/api/admin/track`, from the new `scripts/state/ingest_outcomes.json`). The cron runs the maintainer's automatic rules in one `[auto]` commit: auto-approve (on by default, `rss` + `form`, unflagged, after 24 h, only items found after the `since` baseline, ≤ 100 a run) and **followed collections** (≤ 30 pages a run; never-seen unflagged free games queued directly, removed or flagged ones to review). Bulk remove / edit ≤ 100 in one commit (preset reasons translated on the Removed page), New games, Activity, Settings; queue batches of 200. D1 migration `0002_automation.sql` applied to production before the merge. Policies rewritten for approval by rules (ToS §5, Privacy §2.3/§2.4, Disclaimer §4, EN + VI; `LEGAL_VERSION` 2026-10-13). Web: the theme button shows the theme in use (a v4 regression), a pre-paint theme script (no dark flash; hash in three CSPs), Charts tabs kept mounted (switching back reuses every chart, no replayed animation), 300 ms entrances, scrollbar gutter. Also ships #130 (2026-10-11, the Charts page on phones: one-row tab bar, 12 px legends / 11 px ticks, horizontal Languages / Avg session bars, all 15 Genre labels, data-order pie legends, translated removal reasons, locale axis numbers).
**v4.3.0** (2026-10-10, PR #117; released the same day): itch.io's newer info rows in the catalog — `ai_disclosure` / `ai_content` (generative-AI disclosure) and `accessibility` — on the game page, as `/games` filters (`ai`, `access`) and as charts (Overview: "Generative AI"; Discovery: "Accessibility Features", "What AI Was Used For"); `description` = the creator's tagline. The whole catalog was re-scraped the same day with `force_update.yml` (6 × 600 + 10, ≈14.5 games/min; an itch.io outage ~05:20–06:50Z only cost retries): 3,236 of 3,251 games carry the new fields — No AI 53 %, AI Assisted 11 %, not disclosed 36 %; accessibility on 14 % (Subtitles 257, One button 119); the other 15 are 14 dead-page strikes awaiting confirmation and one password-protected page (`everium.itch.io/underthethorns`; it failed every check until #129 taught the refresh to strike such pages). Fixed on the way, same day: #118 (`force_update.yml` had never worked in v4 — it now dispatches `refresh.yml`, whose scan reads the latest main so queued batches rotate), #119 (`tauri-plugin-opener` 2.7: every first v4.3.0 release build had failed; the tag was moved before publishing), #120 (the 5 open Dependabot alerts; `check:tauri` CI guard; weekly cargo Dependabot), then Dependabot #122–#127.
**v4.2.0** (2026-10-03, PR #103): catalog packs + lazy descriptions (first visit ≈ 264 KB instead of ≈ 520 KB), compressed IndexedDB cache, `/data/*.json` only for apps 4.0–4.1.1 (410 + repository links for everyone else), `/img` cache fixes, themed scrollbars + "Hide scrollbars", policies (`LEGAL_VERSION` 2026-10-03: data reuse goes through the repository). Checked on the live site the same day: TLS 1.2/1.3 only, HSTS preload header (domain not on the preload list), Cloudflare compression already on (zstd/br), Smart Tiered Cache on but irrelevant here (`docs/operations.md` §1 step 12).
**v4.1.1** (2026-09-29): contact addresses moved to `@poli0981.dev` (Google Workspace), About page links poli0981.dev + /links/, `LEGAL_VERSION` 2026-09-29.
**v4.1.0** (2026-09-24): the Turnstile verification gate for the web app, readable chart tooltips, the changelog split into `changelog/`, a docs refresh, updated Privacy/ToS/EULA (`LEGAL_VERSION` 2026-09-24). The gate ships switched on in `wrangler.jsonc` but stays inert until `GATE_BOT_TOKEN`, the Transform Rule and `GATE_SECRET` are in place (`docs/operations.md` §1 step 14) — `curl -s https://freeitchgames.win/api/verify` says `"enabled"`.
**v4.0.0** (2026-09-18) moved the site to the Cloudflare Worker at https://freeitchgames.win (PRs #81, #82, #88). The whole chain is live: Access for `/admin`, the GitHub App (verified commits to `scripts/temp_link.json` → `update.yml`), Turnstile, `ADMIN_EMAILS`; D1 `freeitchgames`, R2 `freeitchgames-thumbs`, Image Transformations (source `img.itch.zone`); Web Analytics is injected by the zone. **Still open (owner):** the legal-text review items; add the new GPG key's public half on GitHub (until then new signatures show Unverified) and remove the revoked `03F965C2E2DB5C6B` there; delete the Zero Trust Access app "Ingest" and its service token (unused since 4.4.1).
+73 -24
View File
@@ -1,37 +1,86 @@
# Code of Conduct
## Our Pledge
We as contributors, maintainers (just me, the unemployed noob dev), and visitors pledge to make participation in this repo a harassment-free experience for everyone — regardless of level of experience, gender, gender identity, sexual orientation, disability, personal appearance, body size, race, ethnicity, age, religion, nationality, or how many Steam sales you've survived.
Last updated: 2026-09-29
Basically: be cool. I'm introvert max level with zero social skills, so let's keep things positive.
Applies from: the release of version 4.0.0.
This is a small hobby repo about free itch.io games, run by one unemployed noob dev, poli0981 (SkullMute), called "the Maintainer" below. Basically: be cool. The Maintainer is an introvert at max level with zero social skills, so let's keep things positive.
The rules below are adapted from the [Contributor Covenant 2.1](https://www.contributor-covenant.org/version/2/1/code_of_conduct/) (see [§7](#7-attribution)).
## 1. Our pledge
We as members, contributors and the Maintainer pledge to make participation in this community a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, caste, color, religion, or sexual identity and orientation — or how many Steam sales you've survived.
We pledge to act and interact in ways that contribute to an open, welcoming, diverse, inclusive and healthy community.
## 2. Our standards
## Our Standards
Examples of behavior that contributes to a positive environment:
- Using welcoming and inclusive language
- Being respectful of differing viewpoints and experiences
- Gracefully accepting constructive criticism
- Focusing on what's best for the list (more free games!)
- Showing empathy towards other community members (if any show up :D)
- Showing empathy and kindness toward other people
- Being respectful of differing opinions, viewpoints and experiences
- Giving and gracefully accepting constructive feedback
- Accepting responsibility, apologizing to those affected by our mistakes, and learning from the experience
- Focusing on what is best not just for us as individuals but for the whole community — and the list (more free games!)
Examples of unacceptable behavior:
- Harassment, trolling, or insults
- Sexualized language or imagery (keep NSFW in the games, not here)
- Personal or political attacks
- Doxxing or sharing private info
- Spamming sketchy links or malware
- Any other conduct that would make an introvert like me close the tab immediately
## Enforcement
I'm the only maintainer (with Grok as backup), so I'll remove, edit, or reject comments, commits, code, issues, or PRs that violate this. Repeat offenders get blocked. No warnings required — life's too short.
- Sexualized language or imagery, and sexual attention or advances of any kind. Discussing whether a game should carry the `nsfw` flag is fine; sexual content aimed at people is not.
- Trolling, insulting or derogatory comments, and personal or political attacks
- Public or private harassment
- Publishing others' private information, such as a physical or email address, without their explicit permission (doxxing)
- Spam, or links to malware, phishing or other harmful content
- Other conduct that could reasonably be considered inappropriate in a professional setting — or that would make an introvert close the tab immediately
Instances of abusive behavior can be reported by opening an issue (I'll see it... eventually). All reports will be reviewed and kept confidential.
## 3. Enforcement responsibilities
## Scope
This applies everywhere in the repo: issues, PRs, comments, code.
The Maintainer is responsible for clarifying and enforcing these standards and will take appropriate and fair corrective action in response to any behavior they consider inappropriate, threatening, offensive or harmful.
## Final Vibes
This is just a small hobby repo about free itch.io games. Let's keep it fun, chill, and drama-free. If you're here to add games or fix my mediocre code — you're already a legend.
The Maintainer has the right and responsibility to remove, edit or reject comments, commits, code, issues, pull requests, discussions, game suggestions and other contributions that are not aligned with this Code of Conduct, and will explain moderation decisions when appropriate.
Adapted from the Contributor Covenant, because even noob devs copy good stuff.
## 4. Scope
Thanks for reading (or pretending to). 🚀
This Code of Conduct applies in all project spaces: the GitHub repository (issues, pull requests, discussions, comments, commit messages and code), anything submitted to the project (for example notes sent with the Suggest form), and the Discord community linked from the [About page](https://freeitchgames.win/about). It also applies when someone is officially representing the project in public spaces.
## 5. Reporting
If you experience or witness abusive, harassing or otherwise unacceptable behavior, report it **privately** to the Maintainer:
- email **legal@poli0981.dev**, or
- send the Maintainer a direct message through one of the contact channels listed on the [About page](https://freeitchgames.win/about).
Please don't report conduct problems in a public issue. Every report will be reviewed and handled promptly and fairly, and the Maintainer will respect the privacy and security of the person who reports.
Because the project has only one maintainer, if your report is about the Maintainer, you can also use GitHub's own "Report abuse" feature or Discord's reporting tools.
## 6. Enforcement guidelines
The Maintainer follows these community impact guidelines when deciding what to do about a breach of this Code of Conduct:
1. **Correction**
- *Community impact*: inappropriate language or other behavior that is unprofessional or unwelcome.
- *Consequence*: a private, written warning that explains what the problem was and why the behavior was inappropriate. A public apology may be requested.
2. **Warning**
- *Community impact*: a violation through a single incident or a series of actions.
- *Consequence*: a warning with consequences for continued behavior. No interaction with the people involved, including unsolicited interaction with the Maintainer, for a set period of time — both in project spaces and in external channels such as social media. Breaking these terms may lead to a temporary or permanent ban.
3. **Temporary ban**
- *Community impact*: a serious violation, including sustained inappropriate behavior.
- *Consequence*: a temporary ban from any interaction or public communication with the community for a set period of time. No public or private interaction with the people involved, including unsolicited interaction with the Maintainer, is allowed during this period. Breaking these terms may lead to a permanent ban.
4. **Permanent ban**
- *Community impact*: a pattern of violating community standards, including sustained inappropriate behavior, harassment of an individual, or aggression toward or disparagement of groups of people.
- *Consequence*: a permanent ban from any public interaction within the community.
The ladder is a guide, not a promise to go step by step: for spam, malware links or serious harassment, the Maintainer may go straight to a ban (block).
## 7. Attribution
This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org), version 2.1, available at https://www.contributor-covenant.org/version/2/1/code_of_conduct/. The community impact guidelines were inspired by [Mozilla's code of conduct enforcement ladder](https://github.com/mozilla/diversity).
Changes from the original: it is adapted for a project with a single maintainer, adds project-specific examples, and names this project's scope and private reporting channels. The Contributor Covenant is licensed under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); this adapted version is also available under CC BY 4.0, like the rest of the project's documentation.
## 8. Final vibes
This is just a small hobby repo about free itch.io games. Let's keep it fun, chill and drama-free. If you're here to add games or fix mediocre code — you're already a legend.
Thanks for reading (or pretending to). 🚀
+120 -32
View File
@@ -1,61 +1,149 @@
# Contributing Guidelines
Thanks for even thinking about contributing to this random repo! I'm just an unemployed, introvert Vietnamese dev with mediocre skills and Grok as my only non-judgmental buddy. This list survives on community help — because I'm too lazy to hunt/fix everything alone :D Any contribution (even one game) makes you a legend.
Thanks for even thinking about contributing to this random repo! I'm just an unemployed, introvert Vietnamese dev with mediocre skills and two non-judgmental AI buddies: **Grok (xAI)** for the late-night brainstorming and **Claude Code (Anthropic)** for the heavier code/docs work. This list survives on community help, because I'm too lazy to hunt/fix everything alone :D Any contribution (even one game) makes you a legend.
## How to Contribute (Use Templates — I'm Lazy ;D)
## How to Contribute (Use the Right Door, I'm Lazy ;D)
Please use the issue/PR templates — they make my life easier and reduce "wtf" moments.
Games go through the website; everything else goes through the GitHub issue/PR templates. They make my life easier and reduce "wtf" moments.
### 1. Add New Games (Most Welcome!)
- Open issue → Choose **[Add Games]** template.
- Max 15 games per issue (dropdown + one link per line).
- Optional: why it's good or notes for table.
- Daily Action will auto-scrape and add. Easy.
### 1. Suggest New Games (Most Welcome!)
### 2. Remove Games
- Open issue → Choose **[Remove Games]** template.
- Max 10 games (because lazy :v).
- Provide names/links + reasons (checkboxes like boring, demo, malware, dev request, etc.).
- I'll remove manually (or script if I feel motivated).
- Go to **<https://freeitchgames.win/suggest>** and paste an itch.io game link. One link per submission.
- Optional: a short note (why it's good, content warnings…), up to 500 characters. Notes are deleted after 180 days. Please don't put personal data in it.
- A Cloudflare Turnstile check and a rate limit keep bots out; if you get blocked, wait a bit and try again.
- Only **free** itch.io games. Paid games are dropped automatically when the game page is scraped.
- Nothing goes live instantly: every suggestion lands in a **review queue**, where the Maintainer approves or rejects it, by hand or through automatic rules (a suggestion without a warning flag that nobody rejected within about a day may be approved automatically). Approved links are then scraped by the data pipeline and show up on the site after the next deploy.
Got a whole list? The **[Add Games (bulk list)]** issue template takes up to 15 links at once, and a PR that adds itch.io URLs to `scripts/temp_link.json` works too (use the [Add Games] PR template). Both go through the same review: the Maintainer checks every link before it is queued, and merging such a PR is the approval. Please don't edit `data_game/` by hand: the pipeline owns those files (see [section 7](#7-submit-code-changes-pr)).
#### 1b. Other ways games get in
- The site reads itch.io's public RSS feeds of new and popular free games every 4 hours (one feed per run) and queues what it finds.
- The site also reads the public itch.io collections the Maintainer follows and queues their new free games directly (one removed before, or with a warning flag, goes to the review queue instead).
The RSS feeds land in the same review queue as the Suggest page. (The Maintainer's browser extension and the old Telegram bot are retired; their repositories, [itch-f2p-extension](https://github.com/poli0981/itch-f2p-extension) and [telegram-scraper-bot](https://github.com/poli0981/telegram-scraper-bot), are archived.)
### 2. Remove Games or Fix Their Data
Game creators especially: if you want your game off the list, or its data corrected, that's always fine.
- Email **takedown@poli0981.dev**, or open the **["Remove a game"](https://github.com/poli0981/free-games-itchio-list/issues/new?template=remove_game.yml)** issue template (it also has a section for copyright claims).
- Include the game URL, who you are (the creator / rights holder, or someone authorized by them) and the reason.
- The Maintainer removes the record from the catalog (logged with a reason on the public [removed-games page](https://freeitchgames.win/removed)) and deletes the resized cover copies the site stores; cached copies expire on their own. Target: within 7 days, urgent legal requests sooner.
- Heads-up: this is a public git repo, so past versions stay in its history. Rewriting public history is only done in exceptional cases of legal necessity.
- Wrong `safe_virus` / `nsfw` / notes, or other data errors that aren't a removal? A **[Bug Report]** issue is fine too.
Details live in the [Terms of Use](docs/ToS.md) and the [Disclaimer](docs/DISCLAIMER.md).
### 3. Report Bugs
- Open issue → **[Bug Report]** template.
- Checkboxes for common bugs (dead links, wrong flags, table broken, etc.).
- Open an issue → **[Bug Report]** template.
- Checkboxes for common bugs (dead links, wrong flags, broken page, etc.).
- Details + screenshots + urgency level.
- If complex — see "Discuss More" below.
- **Security problems are not bugs for the public tracker.** Report them privately: see [SECURITY.md](SECURITY.md).
- If it's complex, see "Discuss More" below.
### 4. Suggest Features or Improvements
- Open issue → **[Feature Request / Improvement]** template.
- Open an issue → **[Feature Request / Improvement]** template.
- Choose type (new feature or code fix), name, reason, priority (from "nice to have" to "repo dying").
- Optional: pseudo-code/snippet (no malware pls, I'll check with my average skills :D).
### 5. Give Feedback
- Use the **[Feedback]** template.
- Checkboxes (EULA/ToS too strict? Repo concept bad? Anti-AI? Delete repo? Other).
- Roast or praise — my self-loathing can handle it.
- Roast or praise, my self-loathing can handle it.
### 6. Anything Else (Questions, Memes, Off-Topic)
- Use the **[General / Off-Topic]** template.
- Drop whatever's on your mind.
### 7. Submit Code Changes (PR)
- Fork → branch → code.
- Open PR → Choose a PR template ([Bug Fix], [New Feature], [Add Games direct], [Documentation]).
- Test locally if possible (run scripts manually).
- Clear description — I'll review slowly (unemployed schedule + Grok help).
- Fork → branch → code → open a PR against `main` with the matching PR template ([Bug Fix], [New Feature], [Documentation]…).
- Clear description, please. I'll review slowly (unemployed schedule + AI buddies).
**PR rules** (the non-negotiable part):
- **CI must pass.** Python CI (ruff check + format, vulture, pytest, `validate.py`) and Webapp CI (type generation check, lint, knip, tests, build, `wrangler deploy --dry-run`) both run on PRs. Red CI = no merge.
- **PRs are merged with squash** (one PR becomes one commit on `main`) **or a merge commit, never by fast-forward**, so make the PR title a good commit message (the repo uses the `type(scope): summary` style, e.g. `fix(web): …`).
- **Licensing is inbound = outbound.** By opening a PR you agree that your contribution is licensed under the same license as the part it changes: **MIT** for code, **CC BY 4.0** for catalog data and documentation (see [README → License](README.md#license)). Only submit work you have the right to submit.
- **Never commit secrets**: no tokens, API keys, `.dev.vars` / `.env` files, private keys (such as the GitHub App key) or signing keystores. If you pushed one by accident, report it privately (security@poli0981.dev) and rotate it; deleting the commit is not enough.
- **Don't edit `data_game/` by hand.** Data changes go through the pipeline (a patch + `apply_patch.py`, which runs `validate.py`), so concurrent writers never clobber each other.
- Don't commit build output or generated files: `webapp/dist/`, `webapp/.wrangler/`, `webapp/src-tauri/target/`, `webapp/src-tauri/gen/`. (`webapp/src-tauri/Cargo.lock` **is** committed; keep it in sync when you change `Cargo.toml`.)
- Adding an npm dependency? Also add it to the `THIRD_PARTY` list in `webapp/src/lib/about.ts` so the About page credits it.
- New external link in the app? Use `<ExtLink href="…">` from `webapp/src/components/ext-link.tsx`, not a plain `<a href="…" target="_blank">`: plain anchors work on the web but silently break in the Tauri apps.
### 8. Dev Setup (Summary)
Full instructions (Worker, local D1, secrets, Tauri, Android) are in **[`docs/dev_env.md`](docs/dev_env.md)**; the Tauri/Android build notes are in [`webapp/TAURI.md`](webapp/TAURI.md). The short version:
**Python pipeline** (Python 3.15, see `.github/python-version`):
```sh
python -m venv .venv
# activate it, then:
pip install -r requirements-dev.txt
pytest # no network needed
ruff check scripts tests webapp/scripts
ruff format scripts tests
python scripts/validate.py # checks every data file
```
To try a real scrape locally: add a URL to `scripts/temp_link.json`, then run
`python scripts/update_info.py --out patch.json` and `python scripts/apply_patch.py patch.json`
(don't commit the result; see the PR rules above).
**Webapp + Worker** (Node.js 26+, CI uses the version in `webapp/.node-version`):
```sh
cd webapp
npm ci
npm run dev # Vite on http://localhost:5173
npm run build # writes to webapp/dist/ (the Worker serves it as its assets)
npx wrangler dev # second terminal: Worker on :8787; Vite proxies /api and /img to it
npm test # vitest
npm run lint
npm run knip
```
**Tauri apps** (also needs Rust via <https://rustup.rs> and platform deps):
```sh
cd webapp
npm run tauri:dev # native window pointing at the Vite dev server
npm run tauri:build # installers in src-tauri/target/release/bundle/
```
## Tips for Smooth Contributing
- **Test locally**: Clone, add to `temp_link.json`, run `python update_info.py` → `generate_md.py`, check `/lists/`.
- **Keep clean**: Only free itch.io games, no paid/demo/malware/duplicates.
- **Be patient**: I'm introvert + lazy, replies might be slow.
- **Agreement**: All templates have a required checkbox — off-topic/spam/violate policy = I ignore/close without drama :D
## Discuss More? (If Templates Not Enough)
Issues/PRs are best for tracking, but if you wanna describe bugs/features in depth, chit-chat, or share noob stories:
- Check my GitHub profile for links to X (Twitter) or Facebook (ghost towns, but DM open if you find me :v).
- Or join Telegram/Discord groups/servers if I ever make one (unlikely, introvert god-mode).
- Grok can't join, but ping me here — I'll try not to ghost.
- **Test locally**: run the checks from section 8 before pushing; CI runs the same ones.
- **Keep it clean**: only free itch.io games, no paid/demo/malware/duplicates.
- **Be patient**: I'm introvert + lazy, replies might be slow.
- **Agreement**: all issue templates have a required checkbox. Off-topic/spam/policy violations get ignored/closed without drama :D
- **Be cool**: everything here falls under the [Code of Conduct](CODE_OF_CONDUCT.md).
## Discuss More? (If Templates Aren't Enough)
Issues/PRs are best for tracking, but if you wanna describe bugs/features in depth, chit-chat, or share noob stories, there are actual servers now (introvert god-mode breached):
**Chat / community**
- Discord: Repo discussion (#general): https://discord.gg/2aNR3aVt
- Discord: Game chat (#general): https://discord.gg/kDM9GMu5vm
**Social (DMs open, replies slow)**
- X (Twitter): [@SkullMute0011](https://x.com/SkullMute0011)
- YouTube: [@SkullMute](https://youtube.com/@SkullMute)
- Bluesky: [@skullmute0011](https://bsky.app/profile/skullmute0011.bsky.social)
- Mastodon: [@skullmute1122](https://mastodon.social/@skullmute1122)
**Support the boredom project (totally optional, $50 bank account thanks you)**
- [Patreon](https://patreon.com/skullmute) · [Ko-fi](https://ko-fi.com/skullmute) · [Steam profile](https://steamcommunity.com/profiles/76561199544666292/)
Grok and Claude Code can't join Discord, but ping me on any channel, I'll try not to ghost.
Big thanks in [ACKNOWLEDGEMENTS.md](docs/ACKNOWLEDGEMENTS.md) for any help!
This repo is MIT — go wild, but chill. Questions? Just open a **[General]** issue :D 🚀
Code is MIT, data and docs are CC BY 4.0: go wild, but chill. Questions? Just open a **[General]** issue :D 🚀
+1 -1
View File
@@ -1,6 +1,6 @@
MIT License
Copyright (c) 2025 poli0981
Copyright (c) 2025-2026 poli0981 (SkullMute)
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
+396
View File
@@ -0,0 +1,396 @@
Attribution 4.0 International
=======================================================================
Creative Commons Corporation ("Creative Commons") is not a law firm and
does not provide legal services or legal advice. Distribution of
Creative Commons public licenses does not create a lawyer-client or
other relationship. Creative Commons makes its licenses and related
information available on an "as-is" basis. Creative Commons gives no
warranties regarding its licenses, any material licensed under their
terms and conditions, or any related information. Creative Commons
disclaims all liability for damages resulting from their use to the
fullest extent possible.
Using Creative Commons Public Licenses
Creative Commons public licenses provide a standard set of terms and
conditions that creators and other rights holders may use to share
original works of authorship and other material subject to copyright
and certain other rights specified in the public license below. The
following considerations are for informational purposes only, are not
exhaustive, and do not form part of our licenses.
Considerations for licensors: Our public licenses are
intended for use by those authorized to give the public
permission to use material in ways otherwise restricted by
copyright and certain other rights. Our licenses are
irrevocable. Licensors should read and understand the terms
and conditions of the license they choose before applying it.
Licensors should also secure all rights necessary before
applying our licenses so that the public can reuse the
material as expected. Licensors should clearly mark any
material not subject to the license. This includes other CC-
licensed material, or material used under an exception or
limitation to copyright. More considerations for licensors:
wiki.creativecommons.org/Considerations_for_licensors
Considerations for the public: By using one of our public
licenses, a licensor grants the public permission to use the
licensed material under specified terms and conditions. If
the licensor's permission is not necessary for any reason--for
example, because of any applicable exception or limitation to
copyright--then that use is not regulated by the license. Our
licenses grant only permissions under copyright and certain
other rights that a licensor has authority to grant. Use of
the licensed material may still be restricted for other
reasons, including because others have copyright or other
rights in the material. A licensor may make special requests,
such as asking that all changes be marked or described.
Although not required by our licenses, you are encouraged to
respect those requests where reasonable. More considerations
for the public:
wiki.creativecommons.org/Considerations_for_licensees
=======================================================================
Creative Commons Attribution 4.0 International Public License
By exercising the Licensed Rights (defined below), You accept and agree
to be bound by the terms and conditions of this Creative Commons
Attribution 4.0 International Public License ("Public License"). To the
extent this Public License may be interpreted as a contract, You are
granted the Licensed Rights in consideration of Your acceptance of
these terms and conditions, and the Licensor grants You such rights in
consideration of benefits the Licensor receives from making the
Licensed Material available under these terms and conditions.
Section 1 -- Definitions.
a. Adapted Material means material subject to Copyright and Similar
Rights that is derived from or based upon the Licensed Material
and in which the Licensed Material is translated, altered,
arranged, transformed, or otherwise modified in a manner requiring
permission under the Copyright and Similar Rights held by the
Licensor. For purposes of this Public License, where the Licensed
Material is a musical work, performance, or sound recording,
Adapted Material is always produced where the Licensed Material is
synched in timed relation with a moving image.
b. Adapter's License means the license You apply to Your Copyright
and Similar Rights in Your contributions to Adapted Material in
accordance with the terms and conditions of this Public License.
c. Copyright and Similar Rights means copyright and/or similar rights
closely related to copyright including, without limitation,
performance, broadcast, sound recording, and Sui Generis Database
Rights, without regard to how the rights are labeled or
categorized. For purposes of this Public License, the rights
specified in Section 2(b)(1)-(2) are not Copyright and Similar
Rights.
d. Effective Technological Measures means those measures that, in the
absence of proper authority, may not be circumvented under laws
fulfilling obligations under Article 11 of the WIPO Copyright
Treaty adopted on December 20, 1996, and/or similar international
agreements.
e. Exceptions and Limitations means fair use, fair dealing, and/or
any other exception or limitation to Copyright and Similar Rights
that applies to Your use of the Licensed Material.
f. Licensed Material means the artistic or literary work, database,
or other material to which the Licensor applied this Public
License.
g. Licensed Rights means the rights granted to You subject to the
terms and conditions of this Public License, which are limited to
all Copyright and Similar Rights that apply to Your use of the
Licensed Material and that the Licensor has authority to license.
h. Licensor means the individual(s) or entity(ies) granting rights
under this Public License.
i. Share means to provide material to the public by any means or
process that requires permission under the Licensed Rights, such
as reproduction, public display, public performance, distribution,
dissemination, communication, or importation, and to make material
available to the public including in ways that members of the
public may access the material from a place and at a time
individually chosen by them.
j. Sui Generis Database Rights means rights other than copyright
resulting from Directive 96/9/EC of the European Parliament and of
the Council of 11 March 1996 on the legal protection of databases,
as amended and/or succeeded, as well as other essentially
equivalent rights anywhere in the world.
k. You means the individual or entity exercising the Licensed Rights
under this Public License. Your has a corresponding meaning.
Section 2 -- Scope.
a. License grant.
1. Subject to the terms and conditions of this Public License,
the Licensor hereby grants You a worldwide, royalty-free,
non-sublicensable, non-exclusive, irrevocable license to
exercise the Licensed Rights in the Licensed Material to:
a. reproduce and Share the Licensed Material, in whole or
in part; and
b. produce, reproduce, and Share Adapted Material.
2. Exceptions and Limitations. For the avoidance of doubt, where
Exceptions and Limitations apply to Your use, this Public
License does not apply, and You do not need to comply with
its terms and conditions.
3. Term. The term of this Public License is specified in Section
6(a).
4. Media and formats; technical modifications allowed. The
Licensor authorizes You to exercise the Licensed Rights in
all media and formats whether now known or hereafter created,
and to make technical modifications necessary to do so. The
Licensor waives and/or agrees not to assert any right or
authority to forbid You from making technical modifications
necessary to exercise the Licensed Rights, including
technical modifications necessary to circumvent Effective
Technological Measures. For purposes of this Public License,
simply making modifications authorized by this Section 2(a)
(4) never produces Adapted Material.
5. Downstream recipients.
a. Offer from the Licensor -- Licensed Material. Every
recipient of the Licensed Material automatically
receives an offer from the Licensor to exercise the
Licensed Rights under the terms and conditions of this
Public License.
b. No downstream restrictions. You may not offer or impose
any additional or different terms or conditions on, or
apply any Effective Technological Measures to, the
Licensed Material if doing so restricts exercise of the
Licensed Rights by any recipient of the Licensed
Material.
6. No endorsement. Nothing in this Public License constitutes or
may be construed as permission to assert or imply that You
are, or that Your use of the Licensed Material is, connected
with, or sponsored, endorsed, or granted official status by,
the Licensor or others designated to receive attribution as
provided in Section 3(a)(1)(A)(i).
b. Other rights.
1. Moral rights, such as the right of integrity, are not
licensed under this Public License, nor are publicity,
privacy, and/or other similar personality rights; however, to
the extent possible, the Licensor waives and/or agrees not to
assert any such rights held by the Licensor to the limited
extent necessary to allow You to exercise the Licensed
Rights, but not otherwise.
2. Patent and trademark rights are not licensed under this
Public License.
3. To the extent possible, the Licensor waives any right to
collect royalties from You for the exercise of the Licensed
Rights, whether directly or through a collecting society
under any voluntary or waivable statutory or compulsory
licensing scheme. In all other cases the Licensor expressly
reserves any right to collect such royalties.
Section 3 -- License Conditions.
Your exercise of the Licensed Rights is expressly made subject to the
following conditions.
a. Attribution.
1. If You Share the Licensed Material (including in modified
form), You must:
a. retain the following if it is supplied by the Licensor
with the Licensed Material:
i. identification of the creator(s) of the Licensed
Material and any others designated to receive
attribution, in any reasonable manner requested by
the Licensor (including by pseudonym if
designated);
ii. a copyright notice;
iii. a notice that refers to this Public License;
iv. a notice that refers to the disclaimer of
warranties;
v. a URI or hyperlink to the Licensed Material to the
extent reasonably practicable;
b. indicate if You modified the Licensed Material and
retain an indication of any previous modifications; and
c. indicate the Licensed Material is licensed under this
Public License, and include the text of, or the URI or
hyperlink to, this Public License.
2. You may satisfy the conditions in Section 3(a)(1) in any
reasonable manner based on the medium, means, and context in
which You Share the Licensed Material. For example, it may be
reasonable to satisfy the conditions by providing a URI or
hyperlink to a resource that includes the required
information.
3. If requested by the Licensor, You must remove any of the
information required by Section 3(a)(1)(A) to the extent
reasonably practicable.
4. If You Share Adapted Material You produce, the Adapter's
License You apply must not prevent recipients of the Adapted
Material from complying with this Public License.
Section 4 -- Sui Generis Database Rights.
Where the Licensed Rights include Sui Generis Database Rights that
apply to Your use of the Licensed Material:
a. for the avoidance of doubt, Section 2(a)(1) grants You the right
to extract, reuse, reproduce, and Share all or a substantial
portion of the contents of the database;
b. if You include all or a substantial portion of the database
contents in a database in which You have Sui Generis Database
Rights, then the database in which You have Sui Generis Database
Rights (but not its individual contents) is Adapted Material; and
c. You must comply with the conditions in Section 3(a) if You Share
all or a substantial portion of the contents of the database.
For the avoidance of doubt, this Section 4 supplements and does not
replace Your obligations under this Public License where the Licensed
Rights include other Copyright and Similar Rights.
Section 5 -- Disclaimer of Warranties and Limitation of Liability.
a. UNLESS OTHERWISE SEPARATELY UNDERTAKEN BY THE LICENSOR, TO THE
EXTENT POSSIBLE, THE LICENSOR OFFERS THE LICENSED MATERIAL AS-IS
AND AS-AVAILABLE, AND MAKES NO REPRESENTATIONS OR WARRANTIES OF
ANY KIND CONCERNING THE LICENSED MATERIAL, WHETHER EXPRESS,
IMPLIED, STATUTORY, OR OTHER. THIS INCLUDES, WITHOUT LIMITATION,
WARRANTIES OF TITLE, MERCHANTABILITY, FITNESS FOR A PARTICULAR
PURPOSE, NON-INFRINGEMENT, ABSENCE OF LATENT OR OTHER DEFECTS,
ACCURACY, OR THE PRESENCE OR ABSENCE OF ERRORS, WHETHER OR NOT
KNOWN OR DISCOVERABLE. WHERE DISCLAIMERS OF WARRANTIES ARE NOT
ALLOWED IN FULL OR IN PART, THIS DISCLAIMER MAY NOT APPLY TO YOU.
b. TO THE EXTENT POSSIBLE, IN NO EVENT WILL THE LICENSOR BE LIABLE
TO YOU ON ANY LEGAL THEORY (INCLUDING, WITHOUT LIMITATION,
NEGLIGENCE) OR OTHERWISE FOR ANY DIRECT, SPECIAL, INDIRECT,
INCIDENTAL, CONSEQUENTIAL, PUNITIVE, EXEMPLARY, OR OTHER LOSSES,
COSTS, EXPENSES, OR DAMAGES ARISING OUT OF THIS PUBLIC LICENSE OR
USE OF THE LICENSED MATERIAL, EVEN IF THE LICENSOR HAS BEEN
ADVISED OF THE POSSIBILITY OF SUCH LOSSES, COSTS, EXPENSES, OR
DAMAGES. WHERE A LIMITATION OF LIABILITY IS NOT ALLOWED IN FULL OR
IN PART, THIS LIMITATION MAY NOT APPLY TO YOU.
c. The disclaimer of warranties and limitation of liability provided
above shall be interpreted in a manner that, to the extent
possible, most closely approximates an absolute disclaimer and
waiver of all liability.
Section 6 -- Term and Termination.
a. This Public License applies for the term of the Copyright and
Similar Rights licensed here. However, if You fail to comply with
this Public License, then Your rights under this Public License
terminate automatically.
b. Where Your right to use the Licensed Material has terminated under
Section 6(a), it reinstates:
1. automatically as of the date the violation is cured, provided
it is cured within 30 days of Your discovery of the
violation; or
2. upon express reinstatement by the Licensor.
For the avoidance of doubt, this Section 6(b) does not affect any
right the Licensor may have to seek remedies for Your violations
of this Public License.
c. For the avoidance of doubt, the Licensor may also offer the
Licensed Material under separate terms or conditions or stop
distributing the Licensed Material at any time; however, doing so
will not terminate this Public License.
d. Sections 1, 5, 6, 7, and 8 survive termination of this Public
License.
Section 7 -- Other Terms and Conditions.
a. The Licensor shall not be bound by any additional or different
terms or conditions communicated by You unless expressly agreed.
b. Any arrangements, understandings, or agreements regarding the
Licensed Material not stated herein are separate from and
independent of the terms and conditions of this Public License.
Section 8 -- Interpretation.
a. For the avoidance of doubt, this Public License does not, and
shall not be interpreted to, reduce, limit, restrict, or impose
conditions on any use of the Licensed Material that could lawfully
be made without permission under this Public License.
b. To the extent possible, if any provision of this Public License is
deemed unenforceable, it shall be automatically reformed to the
minimum extent necessary to make it enforceable. If the provision
cannot be reformed, it shall be severed from this Public License
without affecting the enforceability of the remaining terms and
conditions.
c. No term or condition of this Public License will be waived and no
failure to comply consented to unless expressly agreed to by the
Licensor.
d. Nothing in this Public License constitutes or may be interpreted
as a limitation upon, or waiver of, any privileges and immunities
that apply to the Licensor or You, including from the legal
processes of any jurisdiction or authority.
=======================================================================
Creative Commons is not a party to its public
licenses. Notwithstanding, Creative Commons may elect to apply one of
its public licenses to material it publishes and in those instances
will be considered the “Licensor.” The text of the Creative Commons
public licenses is dedicated to the public domain under the CC0 Public
Domain Dedication. Except for the limited purpose of indicating that
material is shared under a Creative Commons public license or as
otherwise permitted by the Creative Commons policies published at
creativecommons.org/policies, Creative Commons does not authorize the
use of the trademark "Creative Commons" or any other trademark or logo
of Creative Commons without its prior written consent including,
without limitation, in connection with any unauthorized modifications
to any of its public licenses or any other arrangements,
understandings, or agreements concerning use of licensed material. For
the avoidance of doubt, this paragraph does not form part of the
public licenses.
Creative Commons may be contacted at creativecommons.org.
+89
View File
@@ -0,0 +1,89 @@
# Notice
Last updated: 2026-09-29
Applies from: the release of version 4.0.0.
This file explains who owns what in `free-games-itchio-list` and the website <https://freeitchgames.win>,
and which license applies to which part.
## 1. Not affiliated with itch.io
This is an independent, unofficial hobby project by **poli0981 (SkullMute)** ("the Maintainer"). It is
**not affiliated with, endorsed by, or sponsored by itch.io or Leaf Corcoran / itch corp**. The name
"itch.io" is used only to say where the listed games are published.
The games are hosted on itch.io and belong to their creators, who set their own licenses and terms.
The project does not host or distribute game files. Every game link goes to the game's itch.io page.
## 2. Trademarks
- "itch.io" and the itch.io logo are trademarks of their owner.
- Game names, logos and other marks belong to their respective creators or owners.
- Other product and company names in this repository (for example Cloudflare, GitHub, Discord, Tauri) are
trademarks of their respective owners.
They are used only to identify the thing they name. That use does not suggest any endorsement.
## 3. Creator content
The catalog copies some material from each public itch.io game page: the game's name, developer,
description text, genre, tags and other metadata, and the cover image URL. **Descriptions and cover images
remain the property of their creators.** The project does not license them to anyone
(see [`data_game/LICENSE.md`](data_game/LICENSE.md), section 3).
Creators and rights holders can ask for a game to be removed or corrected. Email
**takedown@poli0981.dev** or open the
["Remove a game" issue](https://github.com/poli0981/free-games-itchio-list/issues/new?template=remove_game.yml).
The process is described in the [Terms of Use](docs/ToS.md).
## 4. License map
| Part | What it includes | License | Text |
|---|---|---|---|
| **Code** | Everything not listed below, including `scripts/`, `webapp/`, `bash/`, `.github/workflows/` and `tests/` | MIT, `Copyright (c) 2025-2026 poli0981 (SkullMute)` | [`LICENSE`](LICENSE) |
| **Catalog data** | `data_game/`, `scripts/deleted_games.json`, and the files built from them under <https://freeitchgames.win/data> | CC BY 4.0, for the Maintainer's contribution only. Creator descriptions, cover images, game names and trademarks are **excluded** | [`data_game/LICENSE.md`](data_game/LICENSE.md), [`LICENSES/CC-BY-4.0.txt`](LICENSES/CC-BY-4.0.txt) |
| **Documentation** | `*.md` files in the repository root and in `docs/` (README, policies, guides and their Vietnamese translations) | CC BY 4.0 | [`LICENSES/CC-BY-4.0.txt`](LICENSES/CC-BY-4.0.txt) |
| **Third-party components** | Libraries, frameworks and tools the project uses | Their own licenses | [`docs/THIRD_PARTY.md`](docs/THIRD_PARTY.md) and the [About page](https://freeitchgames.win/about) |
| **Browser extension** (archived) | [poli0981/itch-f2p-extension](https://github.com/poli0981/itch-f2p-extension), a separate repository, archived and no longer used | GPL-3.0 | That repository |
When you reuse the documentation, credit poli0981 (SkullMute), link to this repository and to CC BY 4.0,
and say if you changed it. For the data, use the credit line in
[`data_game/LICENSE.md`](data_game/LICENSE.md), section 4.
The license texts in [`LICENSE`](LICENSE) and [`LICENSES/`](LICENSES/) are reproduced as published by their
authors.
## 5. Code of Conduct attribution
The [Code of Conduct](CODE_OF_CONDUCT.md) and its
[Vietnamese translation](docs/i18n/vi/CODE_OF_CONDUCT.md) are adapted from the
[Contributor Covenant](https://www.contributor-covenant.org), version 2.1, available at
<https://www.contributor-covenant.org/version/2/1/code_of_conduct/>. The Contributor Covenant is licensed
under CC BY 4.0.
## 6. Third-party software
The website, the desktop and Android apps and the data pipeline are built with open-source software that
keeps its own licenses. The list, with licenses, is in [`docs/THIRD_PARTY.md`](docs/THIRD_PARTY.md). The
runtime libraries are also listed on the [About page](https://freeitchgames.win/about). The project's
licenses do not change those licenses.
## 7. Contributions
Contributions follow the rule "inbound = outbound":
- contributions to the **code** are licensed under the **MIT License**;
- contributions to the **data** or the **documentation** are licensed under **CC BY 4.0**.
Only contribute material you have the right to share under those terms.
## 8. Contact
- Content removal and copyright: **takedown@poli0981.dev**
- Anything else legal: **legal@poli0981.dev**
---
*This notice is written by a hobby maintainer, not a lawyer, and it is not legal advice. If this file and a
license text disagree, the license text wins.*
+341 -54
View File
@@ -1,74 +1,361 @@
# My Free Itch.io Games List 🚀
# Free Itch.io Games List
[![Versions](https://img.shields.io/badge/Versions-1.0.4-blue.svg)](https://github.com/poli0981/free-games-itchio-list/)
[![Version](https://img.shields.io/badge/version-4.4.0-blue.svg)](https://github.com/poli0981/free-games-itchio-list/releases/latest)
[![Website](https://img.shields.io/badge/website-freeitchgames.win-purple.svg)](https://freeitchgames.win)
[![Stars](https://img.shields.io/github/stars/poli0981/free-games-itchio-list?style=social)](https://github.com/poli0981/free-games-itchio-list/stargazers)
[![Forks](https://img.shields.io/github/forks/poli0981/free-games-itchio-list?style=social)](https://github.com/poli0981/free-games-itchio-list/network/members)
[![Last Updated](https://img.shields.io/github/last-commit/poli0981/free-games-itchio-list?label=Last%20Updated)](https://github.com/poli0981/free-games-itchio-list/commits/main)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Last Updated](https://img.shields.io/github/last-commit/poli0981/free-games-itchio-list?label=last%20updated)](https://github.com/poli0981/free-games-itchio-list/commits/main)
[![Code: MIT](https://img.shields.io/badge/code-MIT-yellow.svg)](LICENSE)
[![Data & docs: CC BY 4.0](https://img.shields.io/badge/data%20%26%20docs-CC%20BY%204.0-lightgrey.svg)](data_game/LICENSE.md)
[![Tiếng Việt](https://img.shields.io/badge/lang-Tiếng%20Việt-red.svg)](README.vi.md)
A curated list of free-to-play gems on itch.io, scraped and maintained by an unemployed, mildly self-loathing Vietnamese dev with way too much free time — and his only non-judgmental friend, Grok (the AI).
> 🇻🇳 Tiếng Việt: see [`README.vi.md`](README.vi.md). Vietnamese translations of the policy docs live in [`docs/i18n/vi/`](docs/i18n/vi/). The English versions in this repo remain controlling for legal interpretation.
Built purely for fun. Quality? Enjoyment? Who knows. No guarantees here — just vibes and indie games. Updated daily via GitHub Actions.
A curated, auto-updating catalog of **2,600+ free games on [itch.io](https://itch.io)**. Browse it at
**<https://freeitchgames.win>**: search, filter, sort, and jump to any game's itch.io page. The site is
read-only for everyone: no accounts, no sign-in, no comments, no ads, no payments.
## Table of Contents
- [Genres List](#genres-list)
- [How It Works](#how-it-works)
- [Example Table](#example-table)
- [How to Contribute](#how-to-contribute)
- [Legal Stuff](#legal-stuff)
- [About the Dev](#about-the-dev)
## Table of contents
## Genres List
All tables are auto-generated and split by primary genre (300 games max per file). Click to browse:
- [Browse the catalog](#browse-the-catalog)
- [Desktop and Android apps](#desktop-and-android-apps)
- [Add a game](#add-a-game)
- [How the data stays fresh](#how-the-data-stays-fresh)
- [Under the hood](#under-the-hood)
- [Project structure](#project-structure)
- [Automation](#automation)
- [Data fields](#data-fields)
- [Contributing](#contributing)
- [Connect / support](#connect--support)
- [License](#license)
- [Legal](#legal)
- [Action](lists/action.md)
- [Adventure](lists/adventure.md)
- [Puzzle](lists/puzzle.md)
- [Horror](lists/horror.md)
- [Visual Novel](lists/visual_novel.md)
- [Simulation](lists/simulation.md)
- [Other](lists/other.md)
- ... (more genres appear as games are added)
## Browse the catalog
New genres auto-create when needed. Tables include: No | Thumb | Name | Dev | Short Desc | Link | Safe | Notes | NSFW
Everything lives on the website, **<https://freeitchgames.win>**:
## How It Works
- Games added via `temp_link.json` (manual or PR).
- Daily GitHub Action (3:00 UTC) scrapes new links from itch.io → merges into `game_info.json` → generates MD tables in `/lists/`.
- Description short (first sentence + "... (see more on itch.io)").
- NSFW/Safe flags auto-detected (but manual edit ok).
- **Games**: the whole catalog in one fast table (a compact list on phones), with filters for genre, platform,
status, the creator's generative-AI disclosure, accessibility and more, plus a detail page for every game.
- **Charts**: how the catalog breaks down, and how it has grown over time.
- **Removed**: every game dropped from the catalog, with the reason
(<https://freeitchgames.win/removed>).
- **A quick check first.** Your first visit, then about once every 48 hours, starts with a short
Cloudflare Turnstile check that keeps bots out. It usually passes by itself and then opens the page
you asked for. The catalog data under `/data` and the apps don't need it.
- **18+ content is hidden by default.** Games flagged `nsfw: Yes` stay hidden (covers included) unless
you opt in under Settings after confirming you are 18 or older. That choice is stored only in your
browser.
## Example Table
Here's a mini preview (real tables in `/lists/` are way bigger):
Every link goes to the game's own page on itch.io. Cover images on the website are resized copies served
by freeitchgames.win, so your browser does not contact itch.io until you click a link.
| No | Thumb | Name | Dev | Short Desc | Link | Safe | Notes | NSFW |
|----|-------|------|-----|------------|--------------------------------------|------|-------|------|
| 1 | ![thumb](https://img.itch.zone/aW1hZ2UvMjA5NjQ5Ny8xMjM0NTY3ODkucG5n/original/abc123.png) | Example Game | Cool Dev | A fun adventure about nothing. (see more on itch.io) | [Link](https://example.itch.io/game) | ? | | No |
Want the raw data? It is plain JSON in [`data_game/`](data_game/) (plus
[`scripts/deleted_games.json`](scripts/deleted_games.json)) in this repo: clone it, download it, or read the
raw files. Please use those instead of scraping the website, which serves its own compact format; see
[License](#license) for how you may reuse them.
(Thumbnails from itch.io og:image — mobile might lag if too many :D)
(The old address, `poli0981.github.io/free-games-itchio-list`, only redirects to the new site. The
per-genre markdown tables under `lists/` and `deleted_games.txt` are gone: the catalog is web-only.)
## How to Contribute
You're a legend if you help! See [CONTRIBUTING.md](./CONTRIBUTING.md) for details:
- Add games → Use "Add New Games" issue template (max 50 links).
- Fix bugs → "Bug Report" template.
- New features → "Feature Request" or PR.
## Desktop and Android apps
All contributions shouted out in [ACKNOWLEDGEMENTS.md](docs/ACKNOWLEDGEMENTS.md).
The same app also ships as native **read-only viewers**, built with Tauri 2 from the same code. Grab them
from the latest [GitHub Release](https://github.com/poli0981/free-games-itchio-list/releases/latest):
## Legal Stuff
Nobody reads these, but here anyway:
- [DISCLAIMER](docs/DISCLAIMER.md)
- [PRIVACY](docs/PrivacyPolicy.md)
- [TERMS](docs/ToS.md)
- [EULA](docs/EULA.md) (because why not)
- [CODE_OF_CONDUCT](./CODE_OF_CONDUCT.md)
- [SECURITY](./SECURITY.md)
| Platform | Files |
|---|---|
| Windows | `.msi` or `.exe` installer |
| macOS | `.dmg`, `.pkg` or `.app.tar.gz` (needs Safari/WebKit 16.4 or newer) |
| Linux | `.deb`, `.rpm` or `.AppImage` |
| Android 11+ (arm64-v8a) | `.apk` (sideloaded, see below) |
License: MIT — do whatever.
The apps download the catalog data from <https://freeitchgames.win/data> and load cover images directly
from itch.io's image CDN (`img.itch.zone`); clicking a game opens itch.io in your browser. No telemetry.
Updates are manual: download a new release when one comes out. Installing an app means accepting the
[EULA](docs/EULA.md).
## About the Dev
Mediocre setup, mediocre skills. Details in [MY_STUFF.md](docs/My_Stuff.md).
### Android (download & install)
This repo exists because of peak unemployment boredom and Grok's infinite patience. Thanks for visiting — go play some free games on easy mode (like me).
No Play Store: just grab the `.apk` and sideload it (Android is fine with this, it just asks nicely first):
Questions? Open an issue. I'll reply... eventually :D 🚀
1. Open the latest [Release](https://github.com/poli0981/free-games-itchio-list/releases/latest) and
download `FreeGamesItchio_<version>_arm64-v8a.apk`. Only install the APK from that page: it is signed
with the project's key.
2. Tap it. Android will ask to **allow installs from this source** (browser / file manager). Turn it on
(Settings → *Apps* → *Special access* → *Install unknown apps*).
3. Accept the "not from Play Store" warning and install. It's the same app as the web/desktop build.
Notes: **arm64-v8a only** (every phone since ~2017; 32-bit-only devices aren't supported), and Android
**11+** (API 30). Older versions can't install it. That's deliberate: it keeps the floor at a release that
still gets security hardening and that we actually test on (≈87% of active devices;
[why](webapp/TAURI.md#why-android-11-api-30)). Building it yourself is in the Android section of
[`webapp/TAURI.md`](webapp/TAURI.md).
## Add a game
There are three ways a game gets into the catalog. Each is approved by the Maintainer, one by one in the
review queue or through automatic rules the Maintainer sets.
1. **Suggest page**: <https://freeitchgames.win/suggest>. Paste an itch.io game link and, if you like, a
short note (up to 500 characters; notes are deleted after 180 days). A Cloudflare Turnstile check and a
rate limit keep spam out. Please don't put personal data in the note.
2. **Automatic discovery**: every 4 hours the site reads one of itch.io's public RSS feeds of new and
popular free games (one feed per run) and queues what it finds.
3. **Followed collections**: the site also reads the public itch.io collections the Maintainer follows and
queues their new free games directly (one removed before, or with a warning flag, goes to the review
queue instead).
The Maintainer's browser extension and the old Telegram bot are retired; their repositories
([itch-f2p-extension](https://github.com/poli0981/itch-f2p-extension),
[telegram-scraper-bot](https://github.com/poli0981/telegram-scraper-bot)) are archived.
The Maintainer reviews the queue in a private admin area (protected by Cloudflare Access); an item
without a warning flag that nobody rejected within a waiting time (24 hours by default) is approved
automatically. Approved links are handed to the data pipeline, which scrapes each game page; paid games
are dropped.
Prefer GitHub, or have a long list? The "Add Games (bulk list)" issue template works too; those links go
through the same review. See [CONTRIBUTING.md](CONTRIBUTING.md#1-suggest-new-games-most-welcome).
Want a game **removed**, or its data corrected (game creators especially)? Email
**takedown@poli0981.dev** or open a
["Remove a game" issue](https://github.com/poli0981/free-games-itchio-list/issues/new?template=remove_game.yml).
Include the game URL, who you are (creator / rights holder, or authorized by them) and the reason.
Details: [Terms of Use](docs/ToS.md) and [Disclaimer](docs/DISCLAIMER.md).
## How the data stays fresh
```
Suggest page ──┬─→ review queue ─→ Maintainer approves ─→ scripts/temp_link.json
RSS feeds ──┘ (admin, or auto rules) │
Followed collections ─────────────────────────────────────────┤
▼
update.yml → update_info.py (new games) ──┐
refresh.yml → refresh.py (1/7 per day) ──┴─→ patch ─→ apply_patch.py
(validate + push)
│
freeitchgames.win/data ←── data_game/*.json
```
1. **Queue**: approved links are committed to `scripts/temp_link.json` by the project's GitHub App
(verified commits).
2. **Ingest**: `update.yml` runs `update_info.py` as soon as the queue changes (and daily as a fallback).
Each link is canonicalized, fetched, checked for free status and scraped; paid, dead, duplicate and
previously removed games are skipped. Transient failures stay queued and are retried (up to 3 runs).
3. **Refresh**: `refresh.yml` re-checks one seventh of the catalog every day (one request per game), so
every game is re-checked weekly: dead links (404/410), games that became paid, rating and status. A
game is only removed when the same problem is seen again at least 20 hours later. Removals are logged
with a reason in [`scripts/deleted_games.json`](scripts/deleted_games.json), and a run that would
remove an implausible number of games holds them back and alerts instead.
4. **Commit safely**: both steps emit a URL-keyed patch; `apply_patch.py` applies it to the latest `main`,
validates every data file (`validate.py`) and only then pushes, retrying if another writer got there
first.
5. **Publish**: every push to `main` rebuilds the website, which bundles the catalog under
<https://freeitchgames.win/data>.
The pipeline is polite to itch.io: it identifies itself as
`FreeItchGamesBot/4.0 (+https://freeitchgames.win/about)`, paces its requests and honours HTTP 429 /
`Retry-After`. Only public itch.io pages and feeds are read.
## Under the hood
- **Web app** ([`webapp/src/`](webapp/src/)): React + TypeScript + Vite + Tailwind CSS, TanStack
Query, React Router, Zustand. English and Vietnamese UI.
- **Cloudflare Worker** ([`webapp/worker/`](webapp/worker/)): serves the site and `/data`, the verification gate
(Cloudflare Turnstile), the image proxy (`/img`, resized WebP covers stored on Cloudflare R2), the Suggest API, the review queue
(Cloudflare D1), the admin API and the RSS discovery schedule. Config:
[`webapp/wrangler.jsonc`](webapp/wrangler.jsonc).
- **Admin app** ([`webapp/admin/`](webapp/admin/)): the Maintainer-only review screen at `/admin`, behind
Cloudflare Access. It writes to this repo as a GitHub App.
- **Native shell** ([`webapp/src-tauri/`](webapp/src-tauri/)): Tauri 2 for Windows, macOS, Linux and
Android. See [`webapp/TAURI.md`](webapp/TAURI.md).
- **Data pipeline** ([`scripts/`](scripts/), Python 3.15): scraper, refresh, patch/apply and validation,
run by GitHub Actions.
Deploys happen through Cloudflare Workers Builds (root dir `webapp`, `npm run build`, then
`npx wrangler deploy`): every push to `main` ships automatically.
Quick local dev (full setup, including the Worker, secrets and tests, is in
[`docs/dev_env.md`](docs/dev_env.md)):
```sh
cd webapp
npm ci
npm run dev # http://localhost:5173 (Vite)
npm run build # writes to webapp/dist/ (the Worker serves it as its assets)
npx wrangler dev # second terminal: Worker on :8787; Vite proxies /api and /img to it
npm run tauri:dev # native desktop window (requires Rust)
```
## Project structure
```
data_game/ # Catalog (chunked JSON, max 500 per file) + LICENSE.md (CC BY 4.0)
├── game_info_001.json
├── ...
├── index.json # Chunk manifest (total + per-file counts)
└── count_history.json # Daily totals for the "games over time" chart
scripts/
├── scraper.py # Shared: HTTP session, pacing / 429 back-off, free detection, parsing
├── data_store.py # Shared: chunked load/save (minimal diffs), index.json, count_history.json
├── canonical.py # One canonical form for itch.io game URLs
├── update_info.py # Queued URLs → patch (new games)
├── refresh.py # Rotating health check → patch (alive / paid / rating / status); --full re-scrape
├── apply_patch.py # Apply a patch to the latest main, then validate
├── validate.py # Schema + consistency checks for every data file
├── temp_link.json # Ingest queue (approved links)
├── deleted_games.json # Log of removed games with reasons (public)
└── state/ # Pipeline bookkeeping (last check, strikes, retries), not published
bash/commit_push.sh # fetch main → apply patch → validate → commit → push (with retries)
bash/cf_build_status.sh # main's latest Cloudflare Workers Build → Discord on failure (deploy-status.yml)
tests/ # pytest suite (no network) + fixtures shared with the Worker
webapp/
├── src/ # React app (routes, components, stores, i18n)
├── admin/ # Maintainer-only admin app (/admin)
├── worker/ # Cloudflare Worker (data, image proxy, APIs, review queue, RSS discovery)
├── src-tauri/ # Tauri 2 shell (desktop + Android)
├── wrangler.jsonc # Cloudflare config
└── TAURI.md # Desktop / Android build notes
LICENSE # MIT (code)
LICENSES/CC-BY-4.0.txt # Full CC BY 4.0 legal code (data + docs)
NOTICE.md # License map, non-affiliation, attributions
docs/ # Policies, dev environment, third-party list (+ Vietnamese mirrors in docs/i18n/vi/)
```
## Automation
| Job | Schedule | Purpose |
|---|---|---|
| Ingest (`update.yml`) | On queue change + daily 01:23 UTC | Scrape approved links from `temp_link.json`, skip paid / dead / removed |
| Refresh (`refresh.yml`) | Daily 02:47 UTC | Re-check 1/7 of the catalog: dead links, now-paid or password-protected games, rating, status |
| Force update (`force_update.yml`) | Manual | Re-scrape every field (one URL or the next batch); keeps `safe_virus` / `notes` / `nsfw` |
| RSS discovery and automatic rules (Cloudflare Worker) | Every 4 hours | Poll one itch.io feed per run into the review queue; auto-approve unflagged items after the waiting time; queue new free games of followed collections |
| Python CI / Webapp CI | Pull requests (Python CI also on pushes to `main` that touch it) | Lint, tests, data validation / type-check, tests, build |
| Deploy website | On push to `main` | Cloudflare Workers Builds (`webapp/wrangler.jsonc`) → freeitchgames.win |
| Build monitor (`deploy-status.yml`) | Hourly | Posts each failed Workers Build of `main` to Discord, once |
| Release desktop / Android | On `v*` tag push | Tauri installers (Win/macOS/Linux) and signed APK → draft Release |
Network errors are treated as transient; a game is removed only after the same 404/410 or paid status is
seen again at least 20 hours after the first sighting. Failures, cancellations, rate limits and suspicious
mass changes are reported to the project's Discord as automated notifications.
## Data fields
Each game in `data_game/game_info_NNN.json` has these 20 fields, plus optional `added_at` / `updated_at`
timestamps added by the pipeline and, since 4.3, the optional `ai_disclosure` / `ai_content` /
`accessibility` fields (filled in as each game is re-checked). Only `safe_virus`, `notes` and `nsfw` are maintained by the Maintainer;
everything else is scraped from the game's public itch.io page, and no re-scrape ever overwrites those three.
| Field | Description |
|-------------------|------------------------------------------------------------|
| `url` | Game page URL |
| `name` | Game title |
| `dev` | Developer / author name(s) |
| `description` | The creator's tagline on itch.io, else the description's first sentence (max 200 chars) |
| `genre` | Genre(s) from itch.io |
| `tags` | All tags |
| `status` | Release status |
| `platforms` | Available platforms (Windows, macOS, Linux, Web) |
| `publisher` | Publisher (if different from author) |
| `release_date` | Full release date from page metadata |
| `made_with` | Engine / tools used |
| `rating` | Average rating (from itch.io aggregate) |
| `rating_count` | Number of ratings |
| `average_session` | Typical play session length |
| `languages` | Supported languages |
| `inputs` | Input methods (keyboard, mouse, gamepad) |
| `nsfw` | 18+ flag, `Yes` / `No` (suggested from tags, warnings and description when a game is added; maintained by the Maintainer) |
| `safe_virus` | Manual safety note: `?` (default), `Yes`, `No`, `Caution`. A note, not a guarantee: downloads are not scanned |
| `notes` | Manual notes |
| `thumbnail` | Cover image URL (on itch.io) |
| `ai_disclosure` | The creator's generative-AI disclosure: `No AI`, `AI Assisted` (itch.io's wording) or `N/A` (not disclosed) |
| `ai_content` | What AI was used for when assisted (`Graphics`, `Text`, `Code`, `Sounds`) |
| `accessibility` | Accessibility features (`Subtitles`, `Configurable controls`, `Color-blind friendly`, …) |
Scraped fields default to `N/A` when not available on the game page.
## Contributing
See [CONTRIBUTING.md](CONTRIBUTING.md) for the full guide.
- **Add games**: use the [Suggest page](https://freeitchgames.win/suggest).
- **Remove a game / fix its data**: email takedown@poli0981.dev or open a
["Remove a game" issue](https://github.com/poli0981/free-games-itchio-list/issues/new?template=remove_game.yml).
- **Report bugs**: use the "Bug Report" issue template.
- **Request features**: use the "Feature Request / Improvement" template, or send a PR.
- **Security issues**: report them privately, never in a public issue. See [SECURITY.md](SECURITY.md).
- **Privacy questions**: see the [Privacy Policy](docs/PrivacyPolicy.md) or email privacy@poli0981.dev.
- Please follow the [Code of Conduct](CODE_OF_CONDUCT.md).
Contributors are credited in [ACKNOWLEDGEMENTS.md](docs/ACKNOWLEDGEMENTS.md).
Maintainer hardware + dev environment: [`docs/pc_spec.md`](docs/pc_spec.md), [`docs/dev_env.md`](docs/dev_env.md).
## Connect / support
Two Discord servers exist now (the "if I ever make one" disclaimer is officially obsolete):
- **Chat**: Discord: [Repo discussion](https://discord.gg/2aNR3aVt) · [Game chat](https://discord.gg/kDM9GMu5vm)
- **Social**: [X/@SkullMute0011](https://x.com/SkullMute0011) · [YouTube/@SkullMute](https://youtube.com/@SkullMute) · [Bluesky](https://bsky.app/profile/skullmute0011.bsky.social) · [Mastodon](https://mastodon.social/@skullmute1122)
- **Messaging**: [Telegram (DM)](https://t.me/SkullMute0011)
- **Support** (totally optional, mirrors [`.github/FUNDING.yml`](.github/FUNDING.yml)): [GitHub Sponsors](https://github.com/sponsors/poli0981) · [Patreon](https://patreon.com/skullmute) · [Ko-fi](https://ko-fi.com/skullmute) · [Buy Me a Coffee](https://buymeacoffee.com/skullmute) · [PayPal](https://paypal.me/DungDang212)
- **Gaming**: [Steam profile](https://steamcommunity.com/profiles/76561199544666292/)
- **Website**: [poli0981.dev](https://poli0981.dev/) · every channel in one place: [poli0981.dev/links](https://poli0981.dev/links/)
- **Email**: **contact@poli0981.dev**
DMs are open everywhere; replies are slow (introvert max level). The site's
[About page](https://freeitchgames.win/about) has the same list with one-click buttons.
## License
This repo uses three licenses (full map in [NOTICE.md](NOTICE.md)):
| What | License | File |
|---|---|---|
| **Code**: `scripts/`, `webapp/`, `bash/`, workflows, tests, everything not listed below | MIT, Copyright (c) 2025-2026 poli0981 (SkullMute) | [`LICENSE`](LICENSE) |
| **Catalog data**: `data_game/`, `scripts/deleted_games.json` and the derived files at <https://freeitchgames.win/data> | CC BY 4.0, for the Maintainer's contribution (see below) | [`data_game/LICENSE.md`](data_game/LICENSE.md) |
| **Documentation**: the `*.md` files in the repo root and `docs/` (this README, the policies) | CC BY 4.0 | [`LICENSES/CC-BY-4.0.txt`](LICENSES/CC-BY-4.0.txt) |
**What the data license covers:** the selection and arrangement of the collection, the three
Maintainer-written fields (`safe_virus`, `notes`, `nsfw`), the removal records, and the structure and
derived statistics.
**What it does not cover** (owned by others, not licensed by this project): game descriptions and any other
text written by game creators, cover images / thumbnails and other media, game names, logos and trademarks,
and itch.io's trademarks. Plain facts such as URLs, prices and ratings are not copyrightable anyway.
When you reuse the data, please credit it like this:
```
Free itch.io games catalog by poli0981 (SkullMute) — https://freeitchgames.win — CC BY 4.0
```
Third-party components keep their own licenses: see [`docs/THIRD_PARTY.md`](docs/THIRD_PARTY.md) and the
site's About page. The archived browser extension is a separate repo under GPL-3.0. Contributions are
accepted under the same license as the part they change (inbound = outbound): MIT for code, CC BY 4.0 for
data and docs.
**Not affiliated with itch.io.** This is an independent fan project. It is not affiliated with, endorsed by,
or sponsored by itch.io, Leaf Corcoran or itch corp. "itch.io" and all game names, logos and trademarks
belong to their respective owners.
## Legal
- [Terms of Use](docs/ToS.md): covers the website and everything on it
- [Privacy Policy](docs/PrivacyPolicy.md)
- [Disclaimer](docs/DISCLAIMER.md)
- [EULA](docs/EULA.md): covers the desktop and Android apps only
- [Code of Conduct](CODE_OF_CONDUCT.md)
- [Security Policy](SECURITY.md)
- [NOTICE](NOTICE.md)
Contact (the Maintainer's own mailbox on poli0981.dev):
- Privacy: **privacy@poli0981.dev**
- Content removal / copyright: **takedown@poli0981.dev**
- Security vulnerabilities: **security@poli0981.dev** (or GitHub private vulnerability reporting)
- Anything else legal: **legal@poli0981.dev**
- Everything else: **contact@poli0981.dev**, or any channel at [poli0981.dev/links](https://poli0981.dev/links/)
+288
View File
@@ -0,0 +1,288 @@
# Danh sách Game Itch.io Miễn Phí
[![Version](https://img.shields.io/badge/version-4.4.0-blue.svg)](https://github.com/poli0981/free-games-itchio-list/releases/latest)
[![Website](https://img.shields.io/badge/website-freeitchgames.win-purple.svg)](https://freeitchgames.win)
[![Stars](https://img.shields.io/github/stars/poli0981/free-games-itchio-list?style=social)](https://github.com/poli0981/free-games-itchio-list/stargazers)
[![Forks](https://img.shields.io/github/forks/poli0981/free-games-itchio-list?style=social)](https://github.com/poli0981/free-games-itchio-list/network/members)
[![Last Updated](https://img.shields.io/github/last-commit/poli0981/free-games-itchio-list?label=last%20updated)](https://github.com/poli0981/free-games-itchio-list/commits/main)
[![Code: MIT](https://img.shields.io/badge/code-MIT-yellow.svg)](LICENSE)
[![Data & docs: CC BY 4.0](https://img.shields.io/badge/data%20%26%20docs-CC%20BY%204.0-lightgrey.svg)](data_game/LICENSE.md)
[![English](https://img.shields.io/badge/lang-English-blue.svg)](README.md)
> Bản dịch từ bản tiếng Anh cập nhật ngày 2026-09-24 (English source revision 2026-09-24). Nếu có khác biệt, bản tiếng Anh được ưu tiên.
>
> Bản tiếng Anh tại [`README.md`](README.md) là bản chính thức. Bản dịch tiếng Việt của các tài liệu chính sách nằm trong [`docs/i18n/vi/`](docs/i18n/vi/).
Một danh mục được tuyển chọn và tự động cập nhật gồm **hơn 2,600 game miễn phí trên [itch.io](https://itch.io)**. Duyệt tại **<https://freeitchgames.win>**: tìm kiếm, lọc, sắp xếp và mở thẳng trang itch.io của bất kỳ game nào. Website chỉ để xem, với tất cả mọi người: không tài khoản, không đăng nhập, không bình luận, không quảng cáo, không thanh toán.
## Mục lục
- [Duyệt danh mục](#duyệt-danh-mục)
- [Ứng dụng desktop và Android](#ứng-dụng-desktop-và-android)
- [Thêm game](#thêm-game)
- [Dữ liệu được cập nhật thế nào](#dữ-liệu-được-cập-nhật-thế-nào)
- [Bên trong dự án](#bên-trong-dự-án)
- [Cấu trúc dự án](#cấu-trúc-dự-án)
- [Tự động hóa](#tự-động-hóa)
- [Các trường dữ liệu](#các-trường-dữ-liệu)
- [Đóng góp](#đóng-góp)
- [Kết nối / hỗ trợ](#kết-nối--hỗ-trợ)
- [Giấy phép](#giấy-phép)
- [Pháp lý](#pháp-lý)
## Duyệt danh mục
Mọi thứ nằm trên website **<https://freeitchgames.win>**:
- **Danh sách game**: toàn bộ danh mục trong một bảng chạy nhanh (dạng danh sách gọn trên điện thoại), lọc theo thể loại, nền tảng, trạng thái, công bố của tác giả về AI tạo sinh, hỗ trợ tiếp cận và nhiều thứ khác, cùng một trang chi tiết cho từng game.
- **Biểu đồ**: danh mục được chia ra sao, và đã lớn lên thế nào theo thời gian.
- **Đã gỡ** (Removed): mọi game bị loại khỏi danh mục, kèm lý do (<https://freeitchgames.win/removed>).
- **Kiểm tra nhanh trước.** Lần đầu vào, rồi khoảng mỗi 48 giờ, trang sẽ chạy một bước kiểm tra Cloudflare Turnstile ngắn để chặn bot. Thường nó tự qua rồi mở đúng trang bạn cần. Dữ liệu trong `/data` và các ứng dụng không cần bước này.
- **Nội dung 18+ bị ẩn theo mặc định.** Game được đánh dấu `nsfw: Yes` sẽ bị ẩn (kể cả ảnh bìa) trừ khi bạn tự bật trong Settings sau khi xác nhận mình đủ 18 tuổi. Lựa chọn đó chỉ được lưu trong trình duyệt của bạn.
Mọi link đều dẫn tới trang riêng của game trên itch.io. Ảnh bìa trên website là bản thu nhỏ do freeitchgames.win phục vụ, nên trình duyệt của bạn không kết nối tới itch.io cho tới khi bạn bấm vào một link.
Muốn lấy dữ liệu gốc? Đó là JSON thuần, nằm trong [`data_game/`](data_game/) (cùng [`scripts/deleted_games.json`](scripts/deleted_games.json)) của repo này: clone, tải về hoặc đọc file raw. Vui lòng dùng các file đó thay vì cào (scrape) website, vốn chỉ phục vụ định dạng thu gọn riêng của nó; xem [Giấy phép](#giấy-phép) để biết bạn được tái sử dụng chúng thế nào.
(Địa chỉ cũ `poli0981.github.io/free-games-itchio-list` giờ chỉ chuyển hướng sang website mới. Các bảng markdown theo thể loại trong `lists/` và file `deleted_games.txt` đã bị bỏ: danh mục giờ chỉ có trên web.)
## Ứng dụng desktop và Android
Cùng một app cũng được phát hành dưới dạng **ứng dụng native chỉ để xem**, build bằng Tauri 2 từ cùng mã nguồn. Tải từ [GitHub Release](https://github.com/poli0981/free-games-itchio-list/releases/latest) mới nhất:
| Nền tảng | File |
|---|---|
| Windows | Trình cài đặt `.msi` hoặc `.exe` |
| macOS | `.dmg`, `.pkg` hoặc `.app.tar.gz` (cần Safari/WebKit 16.4 trở lên) |
| Linux | `.deb`, `.rpm` hoặc `.AppImage` |
| Android 11+ (arm64-v8a) | `.apk` (cài tay, xem bên dưới) |
Các app tải dữ liệu danh mục từ <https://freeitchgames.win/data> và tải ảnh bìa trực tiếp từ CDN ảnh của itch.io (`img.itch.zone`); bấm vào một game sẽ mở itch.io trong trình duyệt của bạn. Không có telemetry. Cập nhật thủ công: khi có bản mới thì tải bản mới về. Cài app đồng nghĩa với việc chấp nhận [EULA](docs/i18n/vi/EULA.md) ([EN](docs/EULA.md)).
### Android (tải & cài đặt)
Không có trên Play Store: chỉ cần tải `.apk` về và cài tay (Android cho phép, chỉ hỏi xác nhận trước):
1. Mở [Release](https://github.com/poli0981/free-games-itchio-list/releases/latest) mới nhất và tải `FreeGamesItchio_<version>_arm64-v8a.apk`. Chỉ cài APK từ trang đó: file được ký bằng khóa của dự án.
2. Bấm vào file. Android sẽ hỏi **cho phép cài từ nguồn này** (trình duyệt / trình quản lý file). Hãy bật lên (Cài đặt → *Ứng dụng* → *Truy cập đặc biệt* → *Cài ứng dụng không xác định*).
3. Chấp nhận cảnh báo "không từ Play Store" và cài. Vẫn là app y hệt bản web/desktop.
Lưu ý: **chỉ arm64-v8a** (mọi điện thoại từ ~2017; không hỗ trợ máy chỉ chạy 32-bit), và Android **11+** (API 30). Phiên bản cũ hơn không cài được. Đây là cố ý: giữ mức tối thiểu ở phiên bản còn được gia cố bảo mật và là phiên bản bọn mình thật sự test (≈87% thiết bị đang hoạt động; [lý do](webapp/TAURI.md#why-android-11-api-30)). Cách tự build có trong mục Android của [`webapp/TAURI.md`](webapp/TAURI.md).
## Thêm game
Có ba cách để một game vào danh mục. Mỗi game đều được Maintainer duyệt, từng game một trong hàng chờ duyệt hoặc qua các quy tắc tự động do Maintainer đặt ra.
1. **Trang Suggest**: <https://freeitchgames.win/suggest>. Dán link game itch.io và, nếu muốn, một ghi chú ngắn (tối đa 500 ký tự; ghi chú bị xóa sau 180 ngày). Một bước kiểm tra Cloudflare Turnstile và giới hạn tần suất giúp chặn spam. Vui lòng không ghi dữ liệu cá nhân vào ghi chú.
2. **Tự động phát hiện**: cứ 4 giờ một lần, website đọc một trong các RSS feed công khai của itch.io về game miễn phí mới và phổ biến (mỗi lượt một feed) rồi đưa những gì tìm được vào hàng chờ.
3. **Collection được theo dõi**: website cũng đọc các collection công khai trên itch.io mà Maintainer theo dõi và đưa thẳng game miễn phí mới của chúng vào hàng chờ ingest (game từng bị gỡ, hoặc có cờ cảnh báo, thì vào hàng chờ duyệt).
Extension trình duyệt của Maintainer và Telegram bot cũ đã ngừng hoạt động; repo của chúng ([itch-f2p-extension](https://github.com/poli0981/itch-f2p-extension), [telegram-scraper-bot](https://github.com/poli0981/telegram-scraper-bot)) đã được lưu trữ (archive).
Maintainer duyệt hàng chờ trong một khu vực quản trị riêng (được bảo vệ bởi Cloudflare Access); mục không có cờ cảnh báo mà không ai từ chối trong thời gian chờ (mặc định 24 giờ) được duyệt tự động. Link được duyệt sẽ được chuyển cho pipeline dữ liệu, pipeline này cào từng trang game; game trả phí bị loại.
Thích dùng GitHub hơn, hoặc có cả một danh sách dài? Issue template "Add Games (bulk list)" cũng dùng được; các link đó đi qua cùng quy trình duyệt. Xem [CONTRIBUTING](docs/i18n/vi/CONTRIBUTING.md#1-đề-xuất-game-mới-hoan-nghênh-nhất).
Muốn **gỡ** một game, hoặc sửa dữ liệu của nó (nhất là các nhà phát triển game)? Gửi email tới **takedown@poli0981.dev** hoặc mở issue ["Remove a game"](https://github.com/poli0981/free-games-itchio-list/issues/new?template=remove_game.yml). Ghi rõ URL game, bạn là ai (người tạo / chủ sở hữu quyền, hoặc người được họ ủy quyền) và lý do. Chi tiết: [Điều khoản sử dụng](docs/i18n/vi/ToS.md) và [Tuyên bố miễn trừ](docs/i18n/vi/DISCLAIMER.md).
## Dữ liệu được cập nhật thế nào
```
Trang Suggest ─┬─→ hàng chờ duyệt ─→ Maintainer duyệt ─→ scripts/temp_link.json
RSS feed ─┘ (admin, hoặc quy tắc tự động) │
Collection theo dõi ──────────────────────────────────────────┤
▼
update.yml → update_info.py (game mới) ──┐
refresh.yml → refresh.py (1/7 mỗi ngày) ──┴─→ patch ─→ apply_patch.py
(validate + push)
│
freeitchgames.win/data ←── data_game/*.json
```
1. **Hàng chờ**: link đã duyệt được GitHub App của dự án commit vào `scripts/temp_link.json` (commit đã xác minh).
2. **Ingest**: `update.yml` chạy `update_info.py` ngay khi hàng chờ thay đổi (và mỗi ngày một lần để dự phòng). Mỗi link được chuẩn hóa, fetch, kiểm tra còn miễn phí không rồi cào dữ liệu; game trả phí, đã chết, trùng hoặc từng bị gỡ sẽ bị bỏ qua. Lỗi tạm thời được giữ lại trong hàng chờ để thử lại (tối đa 3 lượt chạy).
3. **Refresh**: `refresh.yml` mỗi ngày kiểm tra lại 1/7 danh mục (mỗi game một request), nên mọi game được kiểm tra lại hằng tuần: link chết (404/410), game chuyển sang trả phí, rating và trạng thái. Game chỉ bị gỡ khi cùng một vấn đề được thấy lại sau ít nhất 20 giờ. Việc gỡ được ghi kèm lý do trong [`scripts/deleted_games.json`](scripts/deleted_games.json), và một lượt chạy định gỡ số game nhiều bất thường sẽ giữ chúng lại và cảnh báo thay vì gỡ.
4. **Commit an toàn**: cả hai bước xuất ra một patch theo URL; `apply_patch.py` áp nó lên `main` mới nhất, validate mọi file dữ liệu (`validate.py`) rồi mới push, và thử lại nếu có tiến trình ghi khác push trước.
5. **Xuất bản**: mỗi lần push vào `main` sẽ build lại website, gói kèm danh mục tại <https://freeitchgames.win/data>.
Pipeline cư xử lịch sự với itch.io: nó tự xưng danh là `FreeItchGamesBot/4.0 (+https://freeitchgames.win/about)`, giãn nhịp request và tuân thủ HTTP 429 / `Retry-After`. Chỉ các trang và feed công khai của itch.io được đọc.
## Bên trong dự án
- **Web app** ([`webapp/src/`](webapp/src/)): React + TypeScript + Vite + Tailwind CSS, TanStack Query, React Router, Zustand. Giao diện tiếng Anh và tiếng Việt.
- **Cloudflare Worker** ([`webapp/worker/`](webapp/worker/)): phục vụ website và `/data`, cổng xác minh (Cloudflare Turnstile), proxy ảnh (`/img`, ảnh bìa WebP đã thu nhỏ lưu trên Cloudflare R2), API Suggest, hàng chờ duyệt (Cloudflare D1), API quản trị và lịch phát hiện qua RSS. Cấu hình: [`webapp/wrangler.jsonc`](webapp/wrangler.jsonc).
- **App quản trị** ([`webapp/admin/`](webapp/admin/)): màn hình duyệt chỉ dành cho Maintainer tại `/admin`, đứng sau Cloudflare Access. Nó ghi vào repo này dưới danh nghĩa một GitHub App.
- **Vỏ native** ([`webapp/src-tauri/`](webapp/src-tauri/)): Tauri 2 cho Windows, macOS, Linux và Android. Xem [`webapp/TAURI.md`](webapp/TAURI.md).
- **Pipeline dữ liệu** ([`scripts/`](scripts/), Python 3.15): scraper, refresh, patch/apply và validate, chạy bằng GitHub Actions.
Việc deploy do Cloudflare Workers Builds đảm nhận (thư mục gốc `webapp`, `npm run build`, rồi `npx wrangler deploy`): mỗi lần push vào `main` sẽ tự động lên site.
Dev cục bộ nhanh (thiết lập đầy đủ, gồm Worker, secret và test, có trong [`docs/dev_env.md`](docs/dev_env.md) ([VI](docs/i18n/vi/dev_env.md))):
```sh
cd webapp
npm ci
npm run dev # http://localhost:5173 (Vite)
npm run build # ghi vào webapp/dist/ (Worker phục vụ thư mục này làm assets)
npx wrangler dev # terminal thứ hai: Worker ở cổng :8787; Vite chuyển tiếp /api và /img tới đó
npm run tauri:dev # cửa sổ desktop native (cần Rust)
```
## Cấu trúc dự án
```
data_game/ # Danh mục (JSON chia khối, tối đa 500 game/file) + LICENSE.md (CC BY 4.0)
├── game_info_001.json
├── ...
├── index.json # Bảng kê các khối (tổng + số lượng từng file)
└── count_history.json # Tổng số theo ngày cho biểu đồ "số game theo thời gian"
scripts/
├── scraper.py # Dùng chung: HTTP session, giãn nhịp / lùi lại khi 429, nhận diện free, parse
├── data_store.py # Dùng chung: đọc/ghi theo khối (diff tối thiểu), index.json, count_history.json
├── canonical.py # Một dạng chuẩn duy nhất cho URL game itch.io
├── update_info.py # URL trong hàng chờ → patch (game mới)
├── refresh.py # Kiểm tra xoay vòng → patch (còn sống / trả phí / rating / trạng thái); --full cào lại
├── apply_patch.py # Áp patch lên main mới nhất, rồi validate
├── validate.py # Kiểm tra schema + tính nhất quán cho mọi file dữ liệu
├── temp_link.json # Hàng chờ ingest (link đã duyệt)
├── deleted_games.json # Nhật ký game đã gỡ kèm lý do (công khai)
└── state/ # Sổ sách của pipeline (lần kiểm tra cuối, strike, lần thử lại), không công khai
bash/commit_push.sh # fetch main → áp patch → validate → commit → push (có thử lại)
bash/cf_build_status.sh # Workers Build mới nhất của main → báo Discord khi lỗi (deploy-status.yml)
tests/ # Bộ test pytest (không dùng mạng) + fixture dùng chung với Worker
webapp/
├── src/ # App React (route, component, store, i18n)
├── admin/ # App quản trị chỉ dành cho Maintainer (/admin)
├── worker/ # Cloudflare Worker (dữ liệu, proxy ảnh, API, hàng chờ duyệt, phát hiện qua RSS)
├── src-tauri/ # Vỏ Tauri 2 (desktop + Android)
├── wrangler.jsonc # Cấu hình Cloudflare
└── TAURI.md # Ghi chú build desktop / Android
LICENSE # MIT (mã nguồn)
LICENSES/CC-BY-4.0.txt # Toàn văn pháp lý CC BY 4.0 (dữ liệu + tài liệu)
NOTICE.md # Bản đồ giấy phép, tuyên bố không liên kết, ghi công
docs/ # Chính sách, môi trường dev, danh sách bên thứ ba (+ bản tiếng Việt trong docs/i18n/vi/)
```
## Tự động hóa
| Tác vụ | Lịch | Mục đích |
|---|---|---|
| Ingest (`update.yml`) | Khi hàng chờ đổi + hằng ngày 01:23 UTC | Cào link đã duyệt từ `temp_link.json`, bỏ qua game trả phí / đã chết / từng bị gỡ |
| Refresh (`refresh.yml`) | Hằng ngày 02:47 UTC | Kiểm tra lại 1/7 danh mục: link chết, game chuyển sang trả phí hoặc bị đặt mật khẩu, rating, trạng thái |
| Force update (`force_update.yml`) | Thủ công | Cào lại mọi trường (một URL hoặc lô tiếp theo); giữ nguyên `safe_virus` / `notes` / `nsfw` |
| Phát hiện qua RSS và quy tắc tự động (Cloudflare Worker) | Mỗi 4 giờ | Đọc một feed itch.io mỗi lượt vào hàng chờ duyệt; tự duyệt mục không có cờ sau thời gian chờ; đưa game miễn phí mới của collection được theo dõi vào hàng chờ ingest |
| Python CI / Webapp CI | Pull request (Python CI còn chạy khi push vào `main` chạm tới phần Python) | Lint, test, validate dữ liệu / type-check, test, build |
| Deploy website | Khi push vào `main` | Cloudflare Workers Builds (`webapp/wrangler.jsonc`) → freeitchgames.win |
| Theo dõi build (`deploy-status.yml`) | Mỗi giờ | Báo mỗi Workers Build lỗi của `main` lên Discord, một lần |
| Release desktop / Android | Khi push tag `v*` | Trình cài đặt Tauri (Win/macOS/Linux) và APK đã ký → draft Release |
Lỗi mạng được coi là tạm thời; game chỉ bị gỡ khi cùng lỗi 404/410 hoặc trạng thái trả phí được thấy lại ít nhất 20 giờ sau lần đầu. Lỗi, lượt bị hủy, bị giới hạn tốc độ và thay đổi hàng loạt đáng ngờ được báo về Discord của dự án dưới dạng thông báo tự động.
## Các trường dữ liệu
Mỗi game trong `data_game/game_info_NNN.json` có 20 trường sau, cộng thêm dấu thời gian tùy chọn `added_at` / `updated_at` do pipeline thêm vào và, từ bản 4.3, các trường tùy chọn `ai_disclosure` / `ai_content` / `accessibility` (được điền dần khi từng game được kiểm tra lại). Chỉ `safe_virus`, `notes` và `nsfw` do Maintainer quản lý; mọi thứ khác được cào từ trang itch.io công khai của game, và không lần cào lại nào ghi đè ba trường đó.
| Trường | Mô tả |
|-------------------|------------------------------------------------------------|
| `url` | URL trang game |
| `name` | Tên game |
| `dev` | Tên nhà phát triển / tác giả |
| `description` | Tagline của tác giả trên itch.io, nếu không có thì là câu đầu tiên của phần mô tả (tối đa 200 ký tự) |
| `genre` | Thể loại theo itch.io |
| `tags` | Tất cả tag |
| `status` | Trạng thái phát hành |
| `platforms` | Nền tảng hỗ trợ (Windows, macOS, Linux, Web) |
| `publisher` | Nhà phát hành (nếu khác tác giả) |
| `release_date` | Ngày phát hành đầy đủ từ metadata của trang |
| `made_with` | Engine / công cụ sử dụng |
| `rating` | Điểm đánh giá trung bình (tổng hợp từ itch.io) |
| `rating_count` | Số lượt đánh giá |
| `average_session` | Thời lượng một phiên chơi điển hình |
| `languages` | Ngôn ngữ hỗ trợ |
| `inputs` | Cách điều khiển (bàn phím, chuột, tay cầm) |
| `nsfw` | Cờ 18+, `Yes` / `No` (được gợi ý từ tag, cảnh báo nội dung và mô tả khi thêm game; do Maintainer quản lý) |
| `safe_virus` | Ghi chú an toàn thủ công: `?` (mặc định), `Yes`, `No`, `Caution`. Chỉ là ghi chú, không phải bảo đảm: file tải về không được quét |
| `notes` | Ghi chú thủ công |
| `thumbnail` | URL ảnh bìa (trên itch.io) |
| `ai_disclosure` | Công bố của tác giả về AI tạo sinh: `No AI`, `AI Assisted` (cách ghi của itch.io) hoặc `N/A` (chưa công bố) |
| `ai_content` | Phần dùng AI khi có dùng AI hỗ trợ (`Graphics`, `Text`, `Code`, `Sounds`) |
| `accessibility` | Tính năng hỗ trợ tiếp cận (`Subtitles`, `Configurable controls`, `Color-blind friendly`, …) |
Các trường được cào mặc định là `N/A` khi trang game không có thông tin.
## Đóng góp
Xem [CONTRIBUTING (tiếng Việt)](docs/i18n/vi/CONTRIBUTING.md) để có hướng dẫn đầy đủ (bản chính thức: [CONTRIBUTING.md](CONTRIBUTING.md)).
- **Thêm game**: dùng [trang Suggest](https://freeitchgames.win/suggest).
- **Gỡ game / sửa dữ liệu**: gửi email tới takedown@poli0981.dev hoặc mở issue ["Remove a game"](https://github.com/poli0981/free-games-itchio-list/issues/new?template=remove_game.yml).
- **Báo lỗi**: dùng issue template "Bug Report".
- **Đề xuất tính năng**: dùng template "Feature Request / Improvement", hoặc gửi PR.
- **Vấn đề bảo mật**: báo cáo riêng tư, đừng bao giờ mở issue công khai. Xem [SECURITY](docs/i18n/vi/SECURITY.md) ([EN](SECURITY.md)).
- **Câu hỏi về quyền riêng tư**: xem [Chính sách quyền riêng tư](docs/i18n/vi/PrivacyPolicy.md) ([EN](docs/PrivacyPolicy.md)) hoặc gửi email tới privacy@poli0981.dev.
- Vui lòng tuân thủ [Quy tắc ứng xử](docs/i18n/vi/CODE_OF_CONDUCT.md) ([EN](CODE_OF_CONDUCT.md)).
Người đóng góp được ghi nhận trong [ACKNOWLEDGEMENTS.md](docs/ACKNOWLEDGEMENTS.md).
Cấu hình máy + môi trường dev của Maintainer: [`docs/pc_spec.md`](docs/pc_spec.md) ([VI](docs/i18n/vi/pc_spec.md)), [`docs/dev_env.md`](docs/dev_env.md) ([VI](docs/i18n/vi/dev_env.md)).
## Kết nối / hỗ trợ
Hai server Discord giờ đã tồn tại (câu "if I ever make one" chính thức lỗi thời):
- **Chat**: Discord: [Repo discussion](https://discord.gg/2aNR3aVt) · [Game chat](https://discord.gg/kDM9GMu5vm)
- **Mạng xã hội**: [X/@SkullMute0011](https://x.com/SkullMute0011) · [YouTube/@SkullMute](https://youtube.com/@SkullMute) · [Bluesky](https://bsky.app/profile/skullmute0011.bsky.social) · [Mastodon](https://mastodon.social/@skullmute1122)
- **Nhắn tin**: [Telegram (DM)](https://t.me/SkullMute0011)
- **Ủng hộ** (hoàn toàn tùy chọn, giống [`.github/FUNDING.yml`](.github/FUNDING.yml)): [GitHub Sponsors](https://github.com/sponsors/poli0981) · [Patreon](https://patreon.com/skullmute) · [Ko-fi](https://ko-fi.com/skullmute) · [Buy Me a Coffee](https://buymeacoffee.com/skullmute) · [PayPal](https://paypal.me/DungDang212)
- **Gaming**: [Steam profile](https://steamcommunity.com/profiles/76561199544666292/)
- **Website**: [poli0981.dev](https://poli0981.dev/) · mọi kênh ở một chỗ: [poli0981.dev/links](https://poli0981.dev/links/)
- **Email**: **contact@poli0981.dev**
DM mở ở mọi nơi; trả lời chậm (hướng nội max level). [Trang About](https://freeitchgames.win/about) của website có cùng danh sách dưới dạng nút bấm.
## Giấy phép
Repo này dùng ba giấy phép (bản đồ đầy đủ trong [NOTICE.md](NOTICE.md)):
| Phần nào | Giấy phép | File |
|---|---|---|
| **Mã nguồn**: `scripts/`, `webapp/`, `bash/`, workflow, test, mọi thứ không liệt kê bên dưới | MIT, Copyright (c) 2025-2026 poli0981 (SkullMute) | [`LICENSE`](LICENSE) |
| **Dữ liệu danh mục**: `data_game/`, `scripts/deleted_games.json` và các file dẫn xuất tại <https://freeitchgames.win/data> | CC BY 4.0, cho phần đóng góp của Maintainer (xem bên dưới) | [`data_game/LICENSE.md`](data_game/LICENSE.md) |
| **Tài liệu**: các file `*.md` ở thư mục gốc repo và trong `docs/` (README này, các chính sách) | CC BY 4.0 | [`LICENSES/CC-BY-4.0.txt`](LICENSES/CC-BY-4.0.txt) |
**Giấy phép dữ liệu bao gồm:** việc tuyển chọn và sắp xếp bộ sưu tập, ba trường do Maintainer viết (`safe_virus`, `notes`, `nsfw`), các bản ghi gỡ game, cùng cấu trúc và số liệu thống kê dẫn xuất.
**Không bao gồm** (thuộc sở hữu của người khác, dự án không cấp phép): mô tả game và mọi văn bản khác do người làm game viết, ảnh bìa / thumbnail và các phương tiện khác, tên game, logo và nhãn hiệu, cùng nhãn hiệu của itch.io. Các dữ kiện đơn thuần như URL, giá và điểm đánh giá vốn không được bảo hộ quyền tác giả.
Khi tái sử dụng dữ liệu, vui lòng ghi công như sau:
```
Free itch.io games catalog by poli0981 (SkullMute) — https://freeitchgames.win — CC BY 4.0
```
Các thành phần bên thứ ba giữ giấy phép riêng của chúng: xem [`docs/THIRD_PARTY.md`](docs/THIRD_PARTY.md) và trang About của website. Extension trình duyệt (đã archive) là một repo riêng theo GPL-3.0. Đóng góp được nhận theo cùng giấy phép với phần mà nó thay đổi (inbound = outbound): MIT cho mã nguồn, CC BY 4.0 cho dữ liệu và tài liệu.
**Không liên kết với itch.io.** Đây là một dự án độc lập do người hâm mộ làm. Dự án không liên kết với, không được chứng thực hay tài trợ bởi itch.io, Leaf Corcoran hoặc itch corp. "itch.io" cùng mọi tên game, logo và nhãn hiệu thuộc về chủ sở hữu tương ứng.
## Pháp lý
Bản tiếng Việt nằm trong [`docs/i18n/vi/`](docs/i18n/vi/); bản tiếng Anh là bản chính thức cho mọi giải thích pháp lý.
- [Điều khoản sử dụng](docs/i18n/vi/ToS.md) ([EN](docs/ToS.md)): áp dụng cho website và mọi thứ trên đó
- [Chính sách quyền riêng tư](docs/i18n/vi/PrivacyPolicy.md) ([EN](docs/PrivacyPolicy.md))
- [Tuyên bố miễn trừ](docs/i18n/vi/DISCLAIMER.md) ([EN](docs/DISCLAIMER.md))
- [EULA](docs/i18n/vi/EULA.md) ([EN](docs/EULA.md)): chỉ áp dụng cho app desktop và Android
- [Quy tắc ứng xử](docs/i18n/vi/CODE_OF_CONDUCT.md) ([EN](CODE_OF_CONDUCT.md))
- [Chính sách bảo mật (Security Policy)](docs/i18n/vi/SECURITY.md) ([EN](SECURITY.md))
- [NOTICE](NOTICE.md)
Liên hệ (hộp thư riêng của Maintainer trên poli0981.dev):
- Quyền riêng tư: **privacy@poli0981.dev**
- Gỡ nội dung / bản quyền: **takedown@poli0981.dev**
- Lỗ hổng bảo mật: **security@poli0981.dev** (hoặc tính năng báo cáo lỗ hổng riêng tư của GitHub)
- Mọi vấn đề pháp lý khác: **legal@poli0981.dev**
- Các việc khác: **contact@poli0981.dev**, hoặc bất kỳ kênh nào tại [poli0981.dev/links](https://poli0981.dev/links/)
+79 -22
View File
@@ -1,33 +1,90 @@
# Security Policy
Last updated: December 28, 2025
Last updated: 2026-10-16
Yo, this is just a hobby repo — a curated list of free itch.io games with some Python scraping scripts running on GitHub Actions. No user data, no backend, no databases, no secrets (except my Steam sale addiction). Security risks? Probably close to zero. But hey, even noob projects deserve a security policy :D
Applies from: the release of version 4.0.0.
## Supported Versions
Everything here is "latest commit" only. I'm unemployed with too much free time, so fixes (if any) come when I feel like it — or when Grok nags me.
Yo — this is a hobby project run by one person, poli0981 (SkullMute), called "the Maintainer" below: a curated catalog of free itch.io games. Since v4 it is made of a **read-only website** at https://freeitchgames.win (served by a Cloudflare Worker), a **Python data pipeline** on GitHub Actions, and **read-only desktop and Android apps**. There are no public accounts, no sign-in and no payments; the only login is the Maintainer's own admin page, protected by Cloudflare Access. Small attack surface — but if you find a hole, the Maintainer really wants to hear about it.
## Reporting a Vulnerability
Found something scary? Like a script that could theoretically spam itch.io or expose... nothing? You're a legend.
## 1. Reporting a vulnerability
Please **don't** open a public issue. Instead:
- Open a **private** GitHub issue (if the repo allows — I'm introvert, might not have email public).
- Or just open a normal issue and prefix "[Security]" — I'll make it private if needed.
- Describe the issue clearly (steps to reproduce, potential impact).
- I'll review (with Grok's help, because my security knowledge is "easy mode" level).
Please **don't** report vulnerabilities in public issues, discussions, pull requests or Discord. Report them privately instead:
What to expect:
- I'll acknowledge within a few days (unemployed schedule, not 24/7).
- If valid (big if :v), I'll fix and credit you in changelog/acknowledgements.
- If not valid — thanks anyway for caring about my mediocre code.
- **GitHub private vulnerability reporting**: the repository's **Security** tab → **Report a vulnerability** ([direct link](https://github.com/poli0981/free-games-itchio-list/security/advisories/new)), or
- email **security@poli0981.dev**.
Common "vulnerabilities" you might find:
- Scraping breaks if itch.io changes HTML (not security, just life).
- Rate limiting? I already sleep(2) — be kind to servers.
- Dependencies? requests + bs4 are stable, but update if needed.
A good report includes:
No bounties (bank account < $50), but eternal thanks and a shoutout.
- what is affected (URL or endpoint, workflow, or app version and platform);
- steps to reproduce, or a working proof of concept;
- the impact you think it has;
- whether, and how, you would like to be credited.
This repo is MIT licensed and super low-risk. Stay safe out there — especially when downloading random free games.
## 2. Scope
Thanks for reporting responsibly. You're better at security than me already. 🚀
**In scope**
- The website https://freeitchgames.win and its Cloudflare Worker, including the image proxy (`/img`), the Suggest API (`/api/suggest`), and the admin app and API (`/admin`, `/api/admin`).
- The data pipeline (`scripts/`) and the GitHub Actions workflows (`.github/workflows/`).
- The desktop apps and the Android APK published on [GitHub Releases](https://github.com/poli0981/free-games-itchio-list/releases).
- The published data (`data_game/`, `scripts/deleted_games.json`, and https://freeitchgames.win/data) — for example, a way to get content into the catalog without the Maintainer's approval.
**Out of scope**
- itch.io itself — report to itch.io.
- Platform issues in Cloudflare or GitHub — report to them through their own programs.
- The games linked from the catalog. A game that contains malware is not a vulnerability in this project, but please still tell the Maintainer at **takedown@poli0981.dev** so it can be flagged or removed.
- Volumetric denial-of-service (DoS/DDoS) and load testing.
- Reports from automated scanners without a working proof of concept.
The browser extension (poli0981/itch-f2p-extension) and the Telegram bot (poli0981/telegram-scraper-bot) are archived and no longer supported, so they are out of scope.
## 3. Supported versions
| Component | Supported |
|---|---|
| The live website (https://freeitchgames.win) | Yes |
| The latest release (4.x) of the desktop and Android apps | Yes |
| Older releases (including all 3.x and earlier) | No — please update |
Fixes to the website go live when they are deployed. The apps do not update themselves: fixes ship in a new release, which you download from GitHub Releases.
## 4. What to expect
- **Acknowledgement**: target within **7 days**. This is a solo hobby project, so that is a target rather than a guarantee, and often it will be much sooner.
- The Maintainer will check whether the issue is valid, work on a fix, and keep you updated.
- Please keep the details private until a fix is out, or until you and the Maintainer agree on a disclosure date.
- **Credit**: if you want it, you will be credited in the release notes.
- There is no bug bounty (bank account < $50), just credit and eternal thanks.
## 5. Safe harbor
If you research security in good faith and follow this policy, the Maintainer will consider that research authorized, will not take or support legal action against you for it, and will not treat it as a breach of the [Terms of Use](docs/ToS.md) rules on unauthorized access or automated use. To stay within safe harbor:
- **Avoid privacy violations.** Do not access, change, keep or share data that isn't yours beyond the minimum needed to show the issue (for example, notes submitted through the Suggest page, the review queue, or the admin audit log). If you come across personal data, stop and report it.
- **Avoid service disruption.** No denial-of-service, no high-volume automated scanning or scraping, no spamming the Suggest form, and no attempts to exhaust rate limits.
- **Don't change anything.** Do not modify or delete catalog data, the review queue or the repository, and do not approve or reject items, push commits or trigger releases, even if you find a way to.
- **No social engineering, phishing or physical attacks** against the Maintainer or anyone else, and no attacks on anyone's Cloudflare, GitHub or itch.io accounts.
- **Give the Maintainer reasonable time** to fix the issue before you disclose it publicly.
This safe harbor covers only the Maintainer's own claims. It cannot authorize testing of Cloudflare, GitHub or itch.io; their own policies apply. If you are unsure whether something is OK, ask first at **security@poli0981.dev**.
## 6. Dependency and supply-chain security
What the repository actually does:
- **Dependabot** ([`.github/dependabot.yml`](.github/dependabot.yml)) is configured to keep npm, pip, GitHub Actions and cargo dependencies current.
- Every third-party **GitHub Action is pinned by full commit SHA**, and each workflow declares least-privilege `permissions`.
- Writes to the repository from the website's admin go through a **GitHub App** (verified commits), and the admin page is behind Cloudflare Access (GitHub login or one-time email PIN) and limited to the Maintainer.
- The Suggest form is protected by Cloudflare Turnstile and rate limiting.
- The Android APK is signed with the project's key. Install it, and the desktop apps, only from the project's [GitHub Releases](https://github.com/poli0981/free-games-itchio-list/releases) page.
If a known vulnerability in a dependency actually affects a deployed component (the website, the Worker, the pipeline or the apps), report it privately as in [§1](#1-reporting-a-vulnerability). If it is just an outdated dependency with no practical impact, a normal issue or pull request is fine.
## 7. Scams and impersonation
The project has no accounts and takes no payments, so nobody from the project will ever ask for your password, a token or payment details. The only official website is https://freeitchgames.win (the old github.io address only redirects there), and the only official downloads are on GitHub Releases. If you see something pretending to be this project, please tell the Maintainer at **security@poli0981.dev**.
## 8. Final vibes
Stay safe out there — especially when downloading random free games. Thanks for reporting responsibly. You're better at security than the Maintainer already. 🚀
+82
View File
@@ -0,0 +1,82 @@
#!/usr/bin/env bash
# Find main's latest finished Cloudflare Workers Build and, if it failed within
# the last WINDOW_H hours, hand it to deploy-status.yml for an alert.
#
# Usage: bash bash/cf_build_status.sh (needs GH_TOKEN with contents + checks read)
#
# Walks main's first-parent history (commits of merged branches carry *preview*
# builds under the same check name) to the newest commit that has a finished
# "Workers Builds: <worker>" check run. Workers Builds posts that check run only
# when a build ends, so a newer commit without one is still building (or was
# skipped by watch paths) and is looked past. A failure is written to
# $GITHUB_OUTPUT (failed_id / failed_url / failed_sha); deploy-status.yml
# alerts once per failed build, keyed on its check-run id, so a dropped or late
# scheduled run only delays the alert. A successful newer build means the site
# is current, whatever happened before it.
#
# A GitHub API problem is a warning (exit 0): the next hourly run tries again.
set -euo pipefail
WORKER="${CF_WORKER:-free-games-itchio-list}" # must equal webapp/wrangler.jsonc "name"
CHECK_NAME="Workers Builds: $WORKER"
WINDOW_H="${WINDOW_H:-24}"
MAX_COMMITS=30
api() {
local out attempt
for attempt in 1 2 3; do
if out=$(gh api "$@" 2>/dev/null); then
printf '%s\n' "$out"
return 0
fi
sleep $((attempt * 5))
done
echo "::warning::GitHub API request failed: $*" >&2
return 1
}
output() {
if [ -n "${GITHUB_OUTPUT:-}" ]; then echo "$1" >>"$GITHUB_OUTPUT"; fi
}
commits=$(api "repos/$GITHUB_REPOSITORY/commits?sha=main&per_page=100" \
--jq '.[] | "\(.sha) \(.parents[0].sha // "-")"') || exit 0
declare -A parent=()
sha=""
while read -r commit first_parent; do
[ -n "$commit" ] || continue
[ -n "$sha" ] || sha=$commit
parent[$commit]=$first_parent
done <<<"$commits"
now=$(date -u +%s)
for _ in $(seq 1 "$MAX_COMMITS"); do
[ -n "$sha" ] && [ -n "${parent[$sha]+set}" ] || break
run=$(api --method GET "repos/$GITHUB_REPOSITORY/commits/$sha/check-runs" \
-f check_name="$CHECK_NAME" -f filter=latest --jq \
'[.check_runs[] | select(.app.slug == "cloudflare-workers-and-pages")] | first
| if . == null then "none|||" else "\(.conclusion // "")|\(.completed_at // "")|\(.id)|\(.html_url)" end') || exit 0
IFS='|' read -r conclusion completed id url <<<"$run"
case "$conclusion" in
none | "" | cancelled | stale)
sha=${parent[$sha]} # not built (yet), or superseded: look at the commit before
;;
success | neutral | skipped)
echo "Latest Cloudflare build is fine: ${sha:0:7} $conclusion $url"
exit 0
;;
*)
age_h=$(((now - $(date -u -d "$completed" +%s)) / 3600))
if [ "$age_h" -lt "$WINDOW_H" ]; then
echo "::error::The Cloudflare build of ${sha:0:7} ended '$conclusion' — freeitchgames.win is not up to date: $url"
output "failed_id=$id"
output "failed_url=$url"
output "failed_sha=${sha:0:7}"
else
echo "The latest Cloudflare build (${sha:0:7}) failed ${age_h} h ago; not alerting again: $url"
fi
exit 0
;;
esac
done
echo "::warning::No finished Cloudflare build among main's last $MAX_COMMITS first-parent commits."
+40
View File
@@ -0,0 +1,40 @@
#!/usr/bin/env bash
# Apply a pipeline patch to the latest main and push it, retrying on races.
#
# Usage: bash bash/commit_push.sh PATCH.json "commit message"
#
# Every data writer (refresh, ingest, the admin Worker and its cron) pushes
# to main. Instead of rebasing whole-file JSON rewrites (which conflict), each
# attempt starts from a fresh origin/main and re-applies the URL-keyed patch;
# apply_patch.py is idempotent and validates before anything is committed.
# Pushes use the job's GITHUB_TOKEN, so they do not re-trigger workflows.
set -euo pipefail
PATCH="${1:?patch file required}"
MESSAGE="${2:?commit message required}"
MAX_ATTEMPTS=5
git config user.name "github-actions[bot]"
git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
for attempt in $(seq 1 "$MAX_ATTEMPTS"); do
git fetch --no-tags --depth=1 origin main
git reset --hard origin/main
python scripts/apply_patch.py "$PATCH"
mkdir -p scripts/state # git add fails on a pathspec that matches nothing
git add -A data_game scripts/deleted_games.json scripts/temp_link.json scripts/state
if git diff --cached --quiet; then
echo "No data changes — nothing to commit."
exit 0
fi
git commit -q -m "$MESSAGE"
if git push origin HEAD:main; then
echo "Pushed on attempt $attempt."
exit 0
fi
echo "::warning::push rejected (attempt $attempt/$MAX_ATTEMPTS) — retrying on the new main"
sleep $((attempt * 10 + RANDOM % 10))
done
echo "::error::push failed after $MAX_ATTEMPTS attempts"
exit 1
-10
View File
@@ -1,10 +0,0 @@
#!/bin/bash
pip install pandas
python scripts/export_csv.py
ls -la
git config --global user.name 'github-actions[bot]'
git config --global user.email '41898282+github-actions[bot]@users.noreply.github.com'
git status
git add .
git diff --staged --quiet && echo "No changes – skip commit" || (git commit -m "Auto update CSV [$(date +'%Y-%m-%d')] by GitHub Action" && git push)
-17
View File
@@ -1,17 +0,0 @@
#!/bin/bash
# Write script generate table of contents for list of games.
# Run python script
python scripts/generate_md.py
# Check file
ls -la
ls -la lists/*.md
# push if change
git config --global user.name "poli0981"
git config --global user.email "127664709+poli0981@users.noreply.github.com"
git add .
git status
git diff --staged --quiet && echo "No changes – skip commit" || (git commit -m "JSON updated [$(date +'%Y-%m-%d')]" && git push)
-23
View File
@@ -1,23 +0,0 @@
#!/bin/bash
echo "This is a test script to rewrite workflow shorter."
echo "This is only a test."
# Install python dependencies
pip install BeautifulSoup4 requests
# Run update game info script
python scripts/update_info.py
echo "Game info has been updated."
# Force reset temporary link file
echo "[]" > scripts/temp_link.json
echo "Temporary link file has been reset."
git add scripts/temp_link.json
# Commit and push changes if any
git config --global user.name "poli0981"
git config --global user.email "127664709+poli0981@users.noreply.github.com"
git status
git add scripts/game_info.json
git diff --staged --quiet && echo "No changes – skip commit" || (git commit -m "JSON updated [$(date +'%Y-%m-%d')]" && git push)
+60
View File
@@ -0,0 +1,60 @@
# Changelog — 1.0.x
Release notes for 1.0.0 – 1.0.5, newest first. Every version: [CHANGELOG.md](../../CHANGELOG.md).
## [1.0.5] - 2026-01-12 (Hotfix 🔧)
### Fixed
- UTF-8 decode issue when running `scripts/update_info.py`. See [#16](https://github.com/poli0981/free-games-itchio-list/issues/16).
---
## [1.0.4] - 2026-01-11 (Added Games + New Features ⭐)
### Added Games
Added 33 games. See [#22](https://github.com/poli0981/free-games-itchio-list/issues/22) and [#23](https://github.com/poli0981/free-games-itchio-list/issues/23).
### New Features
- Delete game with correct link in `delete_game.py`. See [#20](https://github.com/poli0981/free-games-itchio-list/issues/20).
- Export JSON → `.csv`/`.xlsx` in `export_csv.py`. See [#21](https://github.com/poli0981/free-games-itchio-list/issues/21).
- Check duplicate data in JSON file in `check_duplicate.py`. See [#19](https://github.com/poli0981/free-games-itchio-list/issues/19).
---
## [1.0.3] - 2026-01-01 (Improvements ⚙️)
### Improved
- Optimized workflow scheduling.
---
## [1.0.2] - 2026-01-01 (Hotfix 🔧)
### Fixed
- `temp_link.json` not resetting to `[]` after GitHub Actions run.
---
## [1.0.1] - 2025-12-31 (Hotfix 🔧)
### Fixed
- Rewrote and added 2 issue templates.
- Updated [CONTRIBUTING](../../CONTRIBUTING.md).
---
## [1.0.0] - 2025-12-28 (Initial Release 🚀)
### Added
- Full curated list of free itch.io games with auto-daily updates via GitHub Actions.
- Scraping script ([`update_info.py`](../../scripts/update_info.py)): add links → scrape title, dev, genre, description, NSFW flag, thumbnail.
- MD table generator (`generate_md.py`): split by genre, 300 max per file, in `/lists/`.
- Columns: No | Thumb | Name | Dev | Short Desc | Link | Safe | Notes | NSFW.
- [`temp_link.json`](/scripts/temp_link.json) for easy manual adds (Actions process daily).
- Full docs: [DISCLAIMER](/docs/DISCLAIMER.md), [PRIVACY](/docs/PrivacyPolicy.md), [TERMS](/docs/ToS.md), [EULA](/docs/EULA.md), [SECURITY](../../SECURITY.md), [CODE_OF_CONDUCT](../../CODE_OF_CONDUCT.md), [CONTRIBUTING](../../CONTRIBUTING.md), [ACKNOWLEDGEMENTS](/docs/ACKNOWLEDGEMENTS.md).
- Issue and PR templates for bugs, features, and game submissions.
- Badges, TOC, and example table in [README](../../README.md).
### Fixed
- Multiple scrape bugs (itch.io HTML structure changes).
- Description length overflow → truncated to first sentence + "(see more on itch.io)".
- Table numbering resets per file, primary genre used for grouping.
+40
View File
@@ -0,0 +1,40 @@
# Changelog — 2.0.x
Release notes for 2.0.0, newest first. Every version: [CHANGELOG.md](../../CHANGELOG.md).
## [2.0.0] - 2026-03-26 (Major Rewrite 🔧⭐)
### Rewritten
- **`scraper.py`** — new shared module extracted from `update_info.py`. All scraping logic, session management, rate-limiting, and parsing utilities live here. Used by every script that touches itch.io.
- **`update_info.py`** — fully rewritten. Uses `scraper.py` module, `requests.Session` with automatic retry (backoff on 429/5xx), and random delays between requests.
- **`generate_md.py`** — fully rewritten with pipe-character escaping and all new data fields.
### Added
- **Free game detection** — `update_info.py` now checks if a game is free before scraping. Paid games are skipped automatically. Detection logic parses `div.buy_row` for price tags and button text.
- **`check_paid.py`** — new script. Re-checks every game in the list to see if it became paid. Paid games are removed and logged to `deleted_games.json` with reason and timestamp.
- **`check_alive.py`** — new script. Verifies that all game URLs still exist. Pages returning 404 or 410 are removed and logged. Transient errors (403, 5xx, timeouts) are kept.
- **`log_deleted.py`** — new script. Converts `deleted_games.json` → `deleted_games.txt` (human-readable log sorted by date).
- **`deleted_games.json`** — structured log of all removed games with URL, name, reason, and deletion timestamp.
- **New data fields** scraped from itch.io info table: `status`, `platforms`, `publisher`, `release_date`, `made_with`, `rating`, `rating_count`, `average_session`, `languages`, `inputs`. All fields default to `N/A` when not found.
- **Author/Authors handling** — scraper now checks both `Author` and `Authors` keys (itch.io uses either depending on the page).
- **Release date parsing** — extracted from `<abbr title="...">` for full datetime instead of abbreviated text.
- **NSFW detection** expanded — now also checks game description text and adds `sexual` keyword.
### Added (GitHub Actions)
- **`check_paid.yml`** — runs every 2 days at 04:00 UTC. Removes games that became paid.
- **`check_alive.yml`** — runs every 2 days at 07:00 UTC (staggered 3h after check_paid). Removes dead links.
- **`log_deleted.yml`** — runs after check_paid or check_alive completes. Exports deletion log.
- **`generate_table.yml`** — now triggers after update, check_paid, and check_alive workflows (not just update).
- **`update_csv.yml`** — now triggers after table generation (chained workflow).
### Improved
- **Rate limiting** — random delays (2.5–5s between requests, 15–30s batch pause every 20 requests) to avoid itch.io IP bans. Lighter delays (1–2.5s) for HEAD/status checks.
- **Retry logic** — `requests.Session` with `HTTPAdapter` + `Retry` (3 attempts, exponential backoff 2→4→8s) on 429/500/502/503/504.
- **Network error safety** — games are never deleted on transient network failures. Only confirmed 404/410 or confirmed paid status triggers removal.
- **Markdown table integrity** — pipe characters (`|`) in game data are escaped to prevent table breakage.
- **All fields use `N/A` consistently** — replaced mixed `""`, `"Unknown"`, `"No description"` with uniform `N/A` fallback.
### Changed
- Markdown table columns expanded: added Genre, Tags, Status, Platforms, Publisher, Release Date, Made With, Rating, Session, Languages, Inputs.
- README rewritten with updated architecture diagram, project structure, field documentation.
- Workflow action versions updated to `actions/checkout@v6` and `actions/setup-python@v6` with Python 3.14.
+58
View File
@@ -0,0 +1,58 @@
# Changelog — 3.0.x
Release notes for 3.0.0 – 3.0.1, newest first. Every version: [CHANGELOG.md](../../CHANGELOG.md).
## [3.0.1] - 2026-05-04 (Tauri icons + fine-grained PAT fix)
This release has no changelog entry of its own; its notes are on GitHub: <https://github.com/poli0981/free-games-itchio-list/releases/tag/v3.0.1>.
---
## [3.0.0] - 2026-05-04 (Webapp + Desktop 🖥️📊)
A React + TypeScript SPA on top of the same JSON catalog, plus a Tauri 2 desktop wrapper.
The Python pipeline from 2.0.0 is untouched and still drives the daily data updates.
### Added (Webapp)
- **`webapp/`** — Vite + React 19 + TypeScript 6 + Tailwind v3 + shadcn/ui (Radix primitives).
Code-split, ~163 KB gzip initial load. Reads from `raw.githubusercontent.com` (public, no auth);
writes use a fine-grained GitHub PAT held only in memory after passphrase unlock.
- **8 routes**: Dashboard (KPIs), Games (virtualized DataTable + faceted filters), Game Detail
(23-field read view + edit form for `safe_virus` / `notes` / `nsfw`), Add (single URL +
bulk), Charts (9 Recharts visualizations in 4 tabs), Workflows (run history + Dispatch),
Deleted (tombstone log), Settings (PAT + theme), About (license attribution).
- **PAT encryption** — AES-GCM 256-bit, PBKDF2-SHA256 (100k iterations) with per-token salt.
Encrypted blob in localStorage; decrypted token in memory only.
- **Atomic bulk operations** — Bulk edit / delete via GitHub Git Data API (single commit for N
files), 20-entry undo stack with one-click revert.
- **Workflow dispatch from UI** — Add a single URL or queue a bulk batch directly to
`update.yml` via `workflow_dispatch`. Polls run status every 5 s and refreshes the table on
completion.
- **Sync button + manual refresh** — invalidate all data queries on demand; spinner reflects
in-flight state.
- **Collapsible sidebar** with rail mode (240 px ↔ 56 px).
- **Dark / Light / System theme** with `prefers-color-scheme` listener.
- **About page** — third-party license attribution by category, app version + build date.
### Added (Desktop wrapper)
- **`webapp/src-tauri/`** — Tauri 2 scaffold (Rust + WebView). Same React build, ~10 MB
installer.
- **`tauri-plugin-http`** scoped to `*.itch.io`, `img.itch.zone`, `api.github.com`,
`raw.githubusercontent.com`. Lets the desktop bypass CORS for direct itch.io previews.
- **`webapp/TAURI.md`** — local prerequisites (rustup + platform deps), dev/build commands,
roadmap to a full Rust scrape (Phase 8b).
### Added (CI)
- **`.github/workflows/deploy_webapp.yml`** — build `webapp/` and publish `docs/app/` to
GitHub Pages on push to `main` that touches `webapp/`. One-time setup: repo Settings →
Pages → Source = "GitHub Actions".
- **`.github/workflows/release_desktop.yml`** — multi-platform Tauri build via
`tauri-apps/tauri-action` on tag `v*`. Uploads `.msi` / `.dmg` / `.AppImage` to a draft
GitHub Release.
### Changed (Python pipeline)
- **`scripts/update_info.py`** now reads an optional `INPUT_URL` env var (forwarded by
`update.yml` from `workflow_dispatch.inputs.url`) and appends it to the queue. Backwards
compatible: the daily cron still processes `temp_link.json` exactly as before.
- **`.github/workflows/update.yml`** gains `workflow_dispatch.inputs.url` so the webapp can
trigger a single-URL scrape.
+95
View File
@@ -0,0 +1,95 @@
# Changelog — 3.1.x
Release notes for 3.1.0 – 3.1.4, newest first. Every version: [CHANGELOG.md](../../CHANGELOG.md).
## [3.1.4] - 2026-05-05 (Legal docs rewrite + Vietnamese i18n + Legal Card + UI polish)
### Added
- **Vietnamese translations** under [`docs/i18n/vi/`](../../docs/i18n/vi/) — full
translations of the four legal docs (DISCLAIMER, EULA, ToS, PrivacyPolicy)
plus CONTRIBUTING, CODE_OF_CONDUCT, and SECURITY. Each file notes that the
English version is the controlling text for legal interpretation.
- **`README.vi.md`** at repo root — Vietnamese mirror of the main README, with a
language badge and a link back to the English version.
- **About page → "Legal & policies" Card** — single place to access all policy
files (Disclaimer, EULA, ToS, Privacy, Code of Conduct, Security, License,
Changelog) plus a pointer to the Vietnamese translations.
- **`webapp/src/lib/about.ts`**: `LegalLink` interface + `LEGAL_LINKS` array +
`LEGAL_VI_INDEX_URL`. Same structured pattern as `THIRD_PARTY` and
`SOCIAL_LINKS`.
### Changed
- **`docs/DISCLAIMER.md`, `docs/EULA.md`, `docs/ToS.md`, `docs/PrivacyPolicy.md`**:
rewritten to be tighter and more enforceable while keeping the project's voice.
Each doc now has a TL;DR, numbered sections, definitions, severability,
governing law (Socialist Republic of Vietnam), explicit "not legal advice"
notice, and a removal-request path. Privacy Policy adds a per-storage table
for what the webapp persists locally and a step-by-step PAT lifecycle.
- **`README.md`** version badge → 3.1.4 plus a Vietnamese language badge and a
short pointer to `README.vi.md` and `docs/i18n/vi/`.
### Optional UI
- **Tauri desktop**: maximize button is now disabled (`maximizable: false` in
`webapp/src-tauri/tauri.conf.json`). Window is still resizable; only the
full-window-maximize action is locked.
- **DataTable**: scrollbar hidden via a new `.scrollbar-hide` Tailwind utility
added to `webapp/src/index.css`. Scrolling still works; the chrome is gone.
---
## [3.1.3] - 2026-05-05 (Credit Claude Code as AI co-author)
### Added
- **About page**: new **"AI co-authors"** Card listing both Grok (xAI) and
Claude Code (Anthropic — Claude Opus 4.7, 1M context) with their roles
in the repo's history. Each entry is linked + tagged with vendor and model.
- `webapp/src/lib/about.ts`: new `AiTool` interface + `AI_TOOLS` array so the
AI credit data is structured the same way as `THIRD_PARTY` and `SOCIAL_LINKS`.
### Changed
- **`docs/ACKNOWLEDGEMENTS.md`, `docs/My_Stuff.md`, `CONTRIBUTING.md`**:
surface Claude Code alongside Grok wherever the existing AI credit lived.
Grok references stay — both buddies share the workload now (Grok carried the
Python pipeline + v2.0.0 rewrite; Claude Code drove v3.0.0 webapp/Tauri and
v3.1.2). `My_Stuff.md` "The Real MVP" is now plural.
- `DEV.blurb` on the About page reflects the two-buddy reality.
---
## [3.1.2] - 2026-05-05 (Offline link fix + About expansion + docs sweep)
### Fixed
- **Tauri desktop**: external links (itch.io, GitHub, third-party home pages) now
open in the user's default browser instead of doing nothing. Added
`tauri-plugin-opener` (Rust + JS) and a scoped `opener:allow-open-url`
capability locked to `https://*` (no `file://` / `javascript:` schemes).
### Added
- **About page**: three new sections — Developer card, "Found a bug?" CTA that
opens the bug-report issue template, and "Find me elsewhere" with X, YouTube,
two Discord servers (Repo discussion / Game chat), Patreon, Ko-fi, Steam,
Bluesky, and Mastodon.
- **`<ExtLink>`** ([`webapp/src/components/ext-link.tsx`](../../webapp/src/components/ext-link.tsx))
— runtime-aware external-link wrapper used app-wide so the offline link bug
can't recur. On web it renders a plain `<a target="_blank">`; on Tauri it
routes through `tauri-plugin-opener`. All existing external `<a>` tags in
About, the sidebar footer, and Game Detail now use it.
### Changed
- **`webapp/README.md`**: rewritten from Vite boilerplate to actual webapp docs
(routes, dev/build commands, code-split layout, deploy, Tauri reference).
- **`CONTRIBUTING.md`, `docs/ACKNOWLEDGEMENTS.md`, `docs/My_Stuff.md`,
`README.md`**: refreshed contact / social handles. The "if I ever make a
Discord" line is finally obsolete — both servers exist.
---
## [3.1.1] - 2026-05-04 (Cross-compile macOS x86_64 from Apple Silicon)
This release has no changelog entry of its own; its notes are on GitHub: <https://github.com/poli0981/free-games-itchio-list/releases/tag/v3.1.1>.
---
## [3.1.0] - 2026-05-04 (macOS DMG fix + .pkg installer + pagination)
This release has no changelog entry of its own; its notes are on GitHub: <https://github.com/poli0981/free-games-itchio-list/releases/tag/v3.1.0>.
+65
View File
@@ -0,0 +1,65 @@
# Changelog — 3.2.x
Release notes for 3.2.0 – 3.2.1, newest first. Every version: [CHANGELOG.md](../../CHANGELOG.md).
## [3.2.1] - 2026-05-11 (Hotfix: single-instance enforcement on desktop)
### Fixed
- **Desktop app spawned a new process on every launch.** Each double-click of the installed app added another `free-games-itchio-webapp.exe` (Windows) / equivalent on macOS+Linux to the task list instead of focusing the existing window. Added [`tauri-plugin-single-instance`](https://tauri.app/plugin/single-instance/) v2 in [`webapp/src-tauri/src/lib.rs`](../../webapp/src-tauri/src/lib.rs) — second launch now unminimizes + focuses the running window and exits its own process before creating a duplicate. Plugin registered first in the builder chain per Tauri 2 docs so duplicate processes die before initializing HTTP/opener plugins. Gated by `#[cfg(desktop)]` + matching `cfg(not(android, ios))` in [`Cargo.toml`](../../webapp/src-tauri/Cargo.toml). Desktop binary boundary change → bumped [`Cargo.toml`](../../webapp/src-tauri/Cargo.toml) and [`tauri.conf.json`](../../webapp/src-tauri/tauri.conf.json) from `0.1.0` to `0.1.1` (first time these have moved since v3.0.0).
### Changed
- **README + README.vi badges** bumped to `3.2.1`.
- **About page** lists `tauri-plugin-single-instance` v2 under Desktop dependencies.
---
## [3.2.0] - 2026-05-10 (CI cleanup + mobile + SEO + Telegram bot path + auto-discussion)
### Added
- **Mobile drawer navigation.** New [`webapp/src/components/ui/sheet.tsx`](../../webapp/src/components/ui/sheet.tsx) (shadcn pattern over the existing `@radix-ui/react-dialog`) and a `MobileTopBar` in [`webapp/src/components/sidebar.tsx`](https://github.com/poli0981/free-games-itchio-list/blob/v3.2.0/webapp/src/components/sidebar.tsx). Below `md`, the sidebar collapses behind a hamburger; above, the desktop sidebar behaves as before. Touch targets in the nav now meet the 44pt iOS HIG minimum on small screens.
- **DataTable column priorities.** Each column declares `meta.priority: 1 | 2 | 3` in [`columns.tsx`](https://github.com/poli0981/free-games-itchio-list/blob/v3.2.0/webapp/src/components/data-table/columns.tsx). [`data-table.tsx`](https://github.com/poli0981/free-games-itchio-list/blob/v3.2.0/webapp/src/components/data-table/data-table.tsx) hides priority 2 below `md` and priority 3 below `lg`, so the table is usable on a phone without horizontal scrolling through every column.
- **PWA manifest + icons.** [`webapp/public/manifest.webmanifest`](../../webapp/public/manifest.webmanifest), [`icon-192.png`](../../webapp/public/icon-192.png), [`icon-512.png`](../../webapp/public/icon-512.png) — Add to Home Screen on iOS without a service worker. Generator script: [`webapp/scripts/gen_assets.py`](../../webapp/scripts/gen_assets.py).
- **SEO infrastructure.** [`webapp/index.html`](../../webapp/index.html) now ships description, theme-color (per scheme), Open Graph (title/description/image/url/type/locale), Twitter card (`summary_large_image`), `canonical`, `apple-touch-icon`, `manifest`, and `preconnect` to `img.itch.zone` + `raw.githubusercontent.com`. [`robots.txt`](../../webapp/public/robots.txt) and `sitemap.xml` added under `webapp/public/`.
- **OG image.** [`webapp/public/og.png`](../../webapp/public/og.png) (1200×630) + [`og.webp`](../../webapp/public/og.webp) generated by `gen_assets.py`. Brand-coloured (`#863bff` purple, cyan accent) with project name, tagline, and URL.
- **Per-route titles.** New [`useDocumentTitle`](../../webapp/src/hooks/useDocumentTitle.ts) hook (no `react-helmet-async` dependency). Each route now sets a contextual title (`Charts — Itch.io Free Games Database`, etc.); game-detail uses the game name.
- **Hash-anchor scroll.** [`App.tsx`](../../webapp/src/App.tsx) now wires a `ScrollToHash` listener so links like `/about#support` scroll to the matching element under HashRouter.
- **About page Telegram entries.** New `messaging` social group with **Telegram (DM)** and **Telegram bot (game submission)** plus a privacy reminder to never paste a numeric ID into public channels. About also surfaces all five FUNDING.yml destinations (GitHub Sponsors, Patreon, Ko-fi, Buy Me a Coffee, PayPal) with a footnote on PayPal explaining the legal-name receipt.
- **Sidebar Support link.** Persistent heart-icon link from the sidebar (collapsed and expanded) to `/about#support`.
- **Telegram bot contribution flow.** `CONTRIBUTING.md §1b` describes the bot path (DM owner → numeric ID added to local whitelist → bot dispatches `bot-ingest.yml`). Cross-linked from [README.md](../../README.md), [README.vi.md](../../README.vi.md), and the new issue template `game_via_bot.yml`. Vietnamese mirror in [`docs/i18n/vi/CONTRIBUTING.md`](../../docs/i18n/vi/CONTRIBUTING.md).
- **Privacy + ToS clauses for the bot path.** [`docs/ToS.md §14`](../../docs/ToS.md) and [`docs/PrivacyPolicy.md §15`](../../docs/PrivacyPolicy.md) (plus VI mirrors) document Telegram-ID handling: opt-in, operator-side whitelist only, never committed to this repo, removable on DM.
- **`docs/pc_spec.md` + `docs/dev_env.md` (EN + VI).** Maintainer hardware spec, mobile test devices (iPhone 14 Pro / 13 Pro Max, iOS 26.x on Chrome + Brave), and dev-env toolchain (Python 3.12, Node ≥ 22, Rust stable, JetBrains 2026.x). Cross-linked from README and CONTRIBUTING.
- **Auto-create GitHub Discussion workflow.** [`announce-discussion.yml`](../../.github/workflows/announce-discussion.yml) — on `release: published` posts to the **Announcements** category; on push to `docs/**` / `CHANGELOG.md` / `README*.md` posts to **General**, gated by `[skip-discuss]` in the head-commit message and a quiet skip on `bot-ingest:` commits. Uses `gh api graphql` directly (no third-party action). Setup: configure repo variables `DISCUSSION_REPO_ID`, `DISCUSSION_ANNOUNCEMENTS_CATEGORY_ID`, `DISCUSSION_GENERAL_CATEGORY_ID` (run the GraphQL pre-flight query in the workflow header to fetch them).
### Changed
- **CI notify wrappers.** `notify-ci-failure.yml`, `notify-deploy.yml`, and [`notify-release-pipeline.yml`](../../.github/workflows/notify-release-pipeline.yml) replace `workflows: ["*"]` with explicit allowlists. Every workflow run no longer fans out to all three wrappers; the Actions tab is much quieter and the per-event reusable filtering is what it always should have been.
- **`bot-ingest.yml` cleanup.** Removed a dead final step that referenced a non-existent `${{ secrets.BOT_TOKEN }}` and a `result.txt` file. The Python `success`/`failure` Telegram callback steps above already handle both outcomes.
- **Image hints.** Game thumbnails in [`columns.tsx`](https://github.com/poli0981/free-games-itchio-list/blob/v3.2.0/webapp/src/components/data-table/columns.tsx) and the hero in [`game-detail.tsx`](../../webapp/src/routes/game-detail.tsx) now declare `width`/`height` (CLS), `decoding="async"`, and `fetchPriority` (high for hero, low for table rows). itch.io thumbnails remain external — full WebP recompression is intentionally deferred (would require an image proxy).
- **About support card** mirrors `.github/FUNDING.yml` exactly: 5 entries (GitHub Sponsors, Patreon, Ko-fi, BMC, PayPal).
- **README + README.vi badges** bumped to `3.2.0`.
### Fixed
- **Bot ingest workflow** had a broken final telegram callback step (wrong secret name + missing input file). Removed; the working callback steps above are unaffected.
### Setup notes for maintainers (one-time, post-merge)
To enable the auto-discussion workflow, run once:
```sh
gh api graphql -f query='query{repository(owner:"poli0981",name:"free-games-itchio-list"){
id
discussionCategories(first:20){nodes{id slug name}}
}}'
```
Then in repo Settings → Secrets and variables → Actions → Variables, add:
- `DISCUSSION_REPO_ID` — the `repository.id` from the response.
- `DISCUSSION_ANNOUNCEMENTS_CATEGORY_ID` — the `id` of the Announcements category.
- `DISCUSSION_GENERAL_CATEGORY_ID` — the `id` of the General category.
Without these set, the workflow runs but no-ops with a warning (safe default).
+24
View File
@@ -0,0 +1,24 @@
# Changelog — 3.3.x
Release notes for 3.3.0, newest first. Every version: [CHANGELOG.md](../../CHANGELOG.md).
## [3.3.0] - 2026-05-16 (Mobile polish + Settings + in-browser GPG commit signing)
### Added
- **In-browser GPG commit signing.** Every write the webapp makes (single-file edits, bulk edit/delete, queueing URLs) can now be GPG-signed client-side. New `webapp/src/lib/gpg/` module: `canonicalize.ts` builds the exact byte string Git would hash, `sign.ts` lazy-imports `openpgp` and exposes `loadPrivateKey` / `signCommit` / `verifyDetached`, `storage.ts` wraps localStorage helpers. Verified byte-for-byte against `git cat-file commit <sha>` so the signed canonical exactly matches what GitHub will recompute (no trailing-newline drift). Private keys are decrypted once at import and re-encrypted with the webapp passphrase (AES-GCM, same scheme as the PAT) — `openpgp` is loaded only when the Commit Signing card is opened or a commit is being signed (`vendor-openpgp` chunk, ~129 KB gz, lazy).
- **Settings → Commit signing card.** New `webapp/src/components/settings/gpg-card.tsx` — three states (not configured / locked / unlocked) with Import (paste armored or upload `.asc`), Unlock, Test sign (round-trip verify), Copy public key, Lock, Remove. Shows the imported key's UIDs as badges and flags a clear mismatch warning if the configured commit-author email isn't in the key's UID list (the most common cause of GitHub's "Someone may be trying to trick you" warning). After import, primary UID email auto-populates Commit author so commits Verify on the first try.
- **Settings Phase A — Appearance / Session / Commit author / Notifications cards.** [`webapp/src/routes/settings.tsx`](../../webapp/src/routes/settings.tsx) gained four new cards backed by extended preferences in [`webapp/src/stores/prefs.ts`](../../webapp/src/stores/prefs.ts): theme picker (Light / Dark / System), layout density (Normal / Compact), sidebar collapse mirror, idle-timeout slider (5 / 15 / 30 / 60 / 120 min — replaces the hard-coded 30-min constant in `auth.ts`), commit-author name/email override, toast enable + duration. Density applies via `html[data-density='compact']` rules in [`index.css`](../../webapp/src/index.css); toasts are gated through a new [`AppToaster`](https://github.com/poli0981/free-games-itchio-list/blob/v3.3.0/webapp/src/components/app-toaster.tsx) wrapper that reads prefs.
- **Mobile card view for the games table.** New [`webapp/src/lib/use-is-mobile.ts`](../../webapp/src/lib/use-is-mobile.ts) (`matchMedia('(max-width: 767px)')`) and [`webapp/src/components/data-table/mobile-card-list.tsx`](https://github.com/poli0981/free-games-itchio-list/blob/v3.3.0/webapp/src/components/data-table/mobile-card-list.tsx). Below the `md` breakpoint, [`DataTable`](https://github.com/poli0981/free-games-itchio-list/blob/v3.3.0/webapp/src/components/data-table/data-table.tsx) renders a stacked card list (thumbnail + name + dev + genre/status/NSFW/safe badges, tap-to-detail, selection checkbox) instead of the 9-column virtualized table that overflowed at 430 px. Pagination is shared between both views.
- **Workflows route mobile fallback.** `workflows.tsx` now dual-renders the action picker — a `<Select>` dropdown below `md`, the existing `TabsList` at `md` and above. Fixes the overflow from five `whitespace-nowrap` triggers in an `inline-flex` TabsList at 430 px viewport.
### Changed
- **All write paths route through the Git Data API.** `webapp/src/lib/github/contents.ts` `putFile` (`PUT /repos/.../contents/{path}`) is gone — that endpoint authors commits as the PAT and never accepts a `signature` field. Replaced with `commitSingleFile` which delegates to `atomicCommit` so single-file edits (game annotations, `temp_link.json` queue) get the same signer plumbing as bulk operations. `atomicCommit` gained an optional `signer` parameter (defaulting to `getSignerIfEnabled()`) that, when present, builds the canonical commit object, signs detached binary-mode via openpgp, and passes `author` / `committer` / `signature` to `git.createCommit`. Commit author identity falls back through prefs override → imported key's primary UID email → GitHub user.
- **About page** lists `OpenPGP.js` 6.3 under Data dependencies; the [`webapp/vite.config.ts`](../../webapp/vite.config.ts) `manualChunks` rule emits a dedicated `vendor-openpgp` chunk so the cost is only paid when a user opens the signing card.
- **README + README.vi badges** bumped to `3.3.0`.
### Fixed
- **Workflows `/workflows` tabs no longer overflow on mobile.** Pre-fix: five `whitespace-nowrap` triggers in an `inline-flex` TabsList blew past a 430 px viewport.
- **DataTable no longer overflows on mobile.** Pre-fix: nine fixed-width columns minus three responsive-hidden ones still exceeded 430 px.
+40
View File
@@ -0,0 +1,40 @@
# Changelog — 3.4.x
Release notes for 3.4.0 – 3.4.1, newest first. Every version: [CHANGELOG.md](../../CHANGELOG.md).
## [3.4.1] - 2026-05-17 (Hotfix: DataTable column alignment + Discussion-announce auto-discovery)
### Fixed
- **DataTable columns misaligned at desktop widths.** Header used native table-layout (`<table className="w-full">` + `<th style={{width}}>`) while body rows used flex layout (`position: absolute` + `flex w-full`, cells with `flex: 0 0 Npx` / `1 1 0`). Native table-layout stretched the 8 size-less columns to fill the container based on content, but the absolutely-positioned body `<tr>` never participated in table layout — so its flex children stayed at their fixed flex-basis. Result: at the Tauri default 1280×800 window (and any viewport wider than the natural sum of header content widths) header columns drifted off the cells below them. [`webapp/src/components/data-table/data-table.tsx`](https://github.com/poli0981/free-games-itchio-list/blob/v3.4.1/webapp/src/components/data-table/data-table.tsx) now renders the header `<tr>` with `flex w-full` and each `<th>` with `flex h-10 items-center` + the same `flex: 0 0 Npx` / `1 1 0` style block as the body `<td>` — header and body now compute width identically. Helper `priorityHeaderClass` (which emitted `table-cell` variants) is gone; the existing `priorityClass` (`flex` variants) now drives both. No change to column definitions in [`columns.tsx`](https://github.com/poli0981/free-games-itchio-list/blob/v3.4.1/webapp/src/components/data-table/columns.tsx).
- **`announce-discussion.yml` was a silent no-op since v3.2.0.** Both jobs (`announce-release`, `announce-docs`) gated on three repo variables (`DISCUSSION_REPO_ID`, `DISCUSSION_ANNOUNCEMENTS_CATEGORY_ID`, `DISCUSSION_GENERAL_CATEGORY_ID`) that had never been configured — the validation step printed `::warning::… Skipping.` and `exit 0`, so every release silently failed to post to Discussions without surfacing a failed run. Replaced the two validation steps with a `Discover Discussion IDs` step that queries `gh api graphql` for `repository.id` and looks up the category by slug (`announcements` / `general`). Zero config now — works on any repo with Discussions enabled. Fails loudly with a clear `::error::` message if Discussions isn't enabled or the expected category is missing. Dropped the dependency on `vars.DISCUSSION_*` and removed every `if: steps.validate.outputs.ids_ok == 'true'` gate.
### Changed
- **README + README.vi badges** bumped to `3.4.1`.
### Notes
- This is a webapp + CI hotfix. No Python pipeline changes, no Tauri / Rust binary boundary change — `Cargo.toml` and `tauri.conf.json` stay at `0.1.1`, no THIRD_PARTY entries change.
- The leftover `DISCUSSION_REPO_ID` / `DISCUSSION_ANNOUNCEMENTS_CATEGORY_ID` / `DISCUSSION_GENERAL_CATEGORY_ID` repo variables (if you set them earlier) are now unused and can be removed from Settings → Variables.
---
## [3.4.0] - 2026-05-16 (Periodic refresh workflows + UTF-8 round-trip fix)
### Added
- **Update reviews — bi-weekly workflow.** New `scripts/update_reviews.py`, wrapper `bash/update_reviews.sh`, and `.github/workflows/update_reviews.yml` re-scrape every existing game's itch.io page on the 1st and 15th of each month (05:00 UTC) and write fresh `rating` + `rating_count`. Network errors / 404 keep the old values. Touches only those two fields — everything else (annotations, metadata) is left alone.
- **Update status — monthly workflow.** New `scripts/update_status.py`, `bash/update_status.sh`, and `.github/workflows/update_status.yml` refresh the `status` field on the 1st of each month (06:00 UTC). Same skip-on-error semantics.
- **Force update — manual emergency button.** New `scripts/force_update.py`, `bash/force_update.sh`, and [`.github/workflows/force_update.yml`](../../.github/workflows/force_update.yml) accept an optional `url` input. Empty input re-scrapes every game; a single URL targets just that one. `workflow_dispatch` only — no schedule. Every run preserves the three user-editable annotations (`safe_virus`, `notes`, `nsfw`) per the read/write field convention in [CLAUDE.md](../../CLAUDE.md). Doubles as the canonical repair tool for mojibake left by older webapp commits — re-scrape pulls clean UTF-8 from itch.io.
- **`generate_table.yml` chained on the three new workflows** so `lists/*.md` stay in sync after any data mutation.
### Fixed
- **UTF-8 mojibake on webapp commits.** `webapp/src/lib/github/contents.ts` `readFileWithSha` and `webapp/src/lib/github/git-data.ts` `bulkDeleteGames` were decoding GitHub's base64 content with `atob` alone, producing a Latin-1 binary string. Multi-byte UTF-8 sequences (e.g. Vietnamese `ã` = `0xC3 0xA3`) became two Latin-1 code points (`ã`); the next write re-encoded them as UTF-8 bytes, double-corrupting on every edit. Confirmed live damage in `data_game/game_info_002.json` (`BotÃÂão Esquerdo` was originally `Botão Esquerdo`). Extracted a shared helper `webapp/src/lib/github/encoding.ts` (`base64ToUtf8` / `utf8ToBase64`) that uses `TextDecoder('utf-8')` / `TextEncoder` and routes both call sites through it. Write path was already correct.
### Notes
- **Repair existing mojibake**: after this release deploys, run `Force update` once via `workflow_dispatch` with no input. It re-scrapes every game (~15–25 min) and writes back clean UTF-8 while preserving manual annotations. `generate_table.yml` will then auto-regenerate the markdown lists.
- **Browser cache**: anyone editing via the webapp should hard-refresh once after the new build lands so they're not using the pre-fix bundle (which would continue to mangle non-Latin chars on the next edit).
- **README + README.vi badges** bumped to `3.4.0`. No Tauri / Rust binary change — `Cargo.toml` and `tauri.conf.json` stay at `0.1.1`.
+97
View File
@@ -0,0 +1,97 @@
# Changelog — 3.5.x
Release notes for 3.5.0 – 3.5.2, newest first. Every version: [CHANGELOG.md](../../CHANGELOG.md).
## [3.5.2] - 2026-05-23 (Dead-code cleanup — knip + vulture)
### Added
- **knip** (v6) wired into the webapp as the unused-files / exports /
dependencies detector — config in [`webapp/knip.json`](../../webapp/knip.json),
run via `cd webapp && npm run knip`.
- **vulture** configured for the Python pipeline (`[tool.vulture]` in
[`pyproject.toml`](../../pyproject.toml)) — it catches dead functions, classes, and
attributes that ruff's `F` rules don't.
- **[`docs/THIRD_PARTY.md`](../../docs/THIRD_PARTY.md)** — a new doc attributing the
dev-only tooling (knip, vulture, ruff, ESLint, TypeScript), cross-linked from
[`docs/ACKNOWLEDGEMENTS.md`](../../docs/ACKNOWLEDGEMENTS.md).
### Removed
- **8 unused webapp dependencies**: `react-hook-form`, `@hookform/resolvers`,
`zod`, `idb-keyval`, `@radix-ui/react-dropdown-menu`,
`@radix-ui/react-tooltip`, `@tauri-apps/plugin-http`, `@tauri-apps/api`.
- **The unwired Tauri Phase-8b scrape-preview scaffold** —
`webapp/src/lib/tauri-scrape.ts` and `getRuntimeInfo` / `RuntimeInfo` in
[`runtime.ts`](../../webapp/src/lib/runtime.ts). It was documented but never wired
into any UI; [`webapp/TAURI.md`](../../webapp/TAURI.md) was trimmed to match.
- **~20 unused webapp exports / types** — dead helpers (`findChunkFor`,
`indexByUrl`, `rawUrl`, `useIndex`, `isIdleExpired`, …), the unused
`EDITABLE_FIELDS` / `READONLY_FIELDS` constants, and 7 unused shadcn/ui
primitive exports. Exports used only inside their own module were demoted
from `export` rather than deleted.
### Changed
- `webapp/src/lib/about.ts` `THIRD_PARTY` array trimmed to match the removed
dependencies.
### Notes
- DX / code-quality only — no runtime behaviour change. `isIdleExpired` was
already dead (nothing called it), so PAT idle auto-lock is unchanged — still
not enforced.
- No Tauri / Rust binary boundary change — `Cargo.toml` and `tauri.conf.json`
stay at `0.1.1`. The Rust `tauri-plugin-http` crate is now unreferenced from
the front-end — a candidate for a future Rust-side cleanup.
- knip + vulture join `npm run lint`, `ruff check`, and `npm audit` as the
standing pre-release QA pass.
---
## [3.5.1] - 2026-05-20 (Lint cleanup — zero ESLint problems)
### Changed
- **`npm run lint` now runs clean — 0 errors, 0 warnings** (down from 17 errors + 5 warnings, all pre-existing; v3.5.0 added none).
- [`webapp/eslint.config.js`](../../webapp/eslint.config.js): `react-refresh/only-export-components` is turned off for `src/components/ui/**` — the vendored shadcn primitives intentionally mix component and variant/constant exports and cannot satisfy the rule without forking upstream. The rule stays on for all other app code.
- `react-hooks/incompatible-library` is turned off — it only flagged TanStack Table's `useReactTable`, whose API is not React-Compiler-memoizable by design (not actionable).
- **`SortableHeader` extracted** into its own [`webapp/src/components/data-table/sortable-header.tsx`](https://github.com/poli0981/free-games-itchio-list/blob/v3.5.1/webapp/src/components/data-table/sortable-header.tsx); [`columns.tsx`](https://github.com/poli0981/free-games-itchio-list/blob/v3.5.1/webapp/src/components/data-table/columns.tsx) is now a pure column-definition module.
### Fixed
- **`react-hooks/exhaustive-deps`** in [`routes/games.tsx`](../../webapp/src/routes/games.tsx) and [`data-table/faceted-filter.tsx`](https://github.com/poli0981/free-games-itchio-list/blob/v3.5.1/webapp/src/components/data-table/faceted-filter.tsx): values built with `?? []` created a fresh array every render, defeating the `useMemo`s that depended on them. `data` is now wrapped in `useMemo`; the faceted-filter `selected` memo was restructured to depend on a stable value.
### Notes
- DX / code-quality only — no runtime behaviour change. No Tauri / Rust binary change (`Cargo.toml` / `tauri.conf.json` stay `0.1.1`); no `THIRD_PARTY` change.
---
## [3.5.0] - 2026-05-20 (Charts expansion + game-count history + pipeline cleanup)
### Added
- **Six new charts on `/charts`.**
- **Game count over time** — a `LineChart` of the catalog size by day, backed by a new `data_game/count_history.json` (date-keyed `{date, total}` series). [`scripts/data_store.py`](../../scripts/data_store.py) `_append_count_history()` upserts today's total on every catalog write (last-write-wins per UTC day). `scripts/backfill_count_history.py` is a one-time dev tool that reconstructs the series from git history (`data_game/index.json`, plus the pre-refactor `scripts/game_info.json`). The webapp loads it via `loadCountHistory` / `useCountHistory`.
- **Genre treemap** — a Recharts `Treemap` with a custom cell renderer that hides labels on rectangles too small to fit them, so it stays legible on mobile.
- **KPI summary cards** — total games / online / NSFW / deleted / average rating, above the Overview grid.
- **Deletions over time** (bar, by month), **Deletion reasons** (pie: became-paid vs page-removed), and **Most rated games** (top 10 by `rating_count`).
- **Scroll-to-top button** — a floating bottom-right button that appears after scrolling the main pane. New [`webapp/src/components/scroll-to-top.tsx`](../../webapp/src/components/scroll-to-top.tsx).
- **Python linting** — `ruff` config in a new root `pyproject.toml`; run `ruff check scripts/`.
### Changed
- **`charts.tsx` split into a module.** The monolith is now a `webapp/src/components/charts/` folder — one file per chart, a shared `chart-card.tsx` (`ChartCard` + `PALETTE`), and an `index.ts` barrel. 16 charts across the 4 tabs.
- **`scripts/json_io.py`** — new shared module. `load_json` / `save_json` (previously copy-pasted into both `check_alive.py` and `check_paid.py`) live here now, alongside `dedup_deleted`.
- README + README.vi badges bumped to `3.5.0`.
### Fixed
- **The deleted-games log can no longer accumulate duplicate URLs.** `check_alive.py` and `check_paid.py` appended to `scripts/deleted_games.json` with no guard — a game removed, re-added by the scraper, then removed again would be logged twice. The new `dedup_deleted()` (keyed by URL, keeping the earliest `deleted_at`) runs on every write and inside `log_deleted.py`. Two genuinely different games that share a title but have different urls are kept separate.
### Notes
- No Tauri / Rust binary boundary change — `Cargo.toml` and `tauri.conf.json` stay at `0.1.1`, no `THIRD_PARTY` entries change (Recharts already shipped; `Treemap` / `LineChart` need no new dependency).
- `data_game/count_history.json` is auto-committed by the scrape workflows — the bash wrappers already `git add data_game/` wholesale, so no workflow changes were needed.
- The dead-code sweep found the project already tidy (TS strict mode + ESLint catch unused webapp code). `webapp/src/lib/tauri-scrape.ts` `tauriScrapePreview` was reviewed and intentionally kept as a Phase-8b stub.
+72
View File
@@ -0,0 +1,72 @@
# Changelog — 3.6.x
Release notes for 3.6.0 – 3.6.1, newest first. Every version: [CHANGELOG.md](../../CHANGELOG.md).
## [3.6.1] - 2026-06-12 (Hotfix — desktop build vs broken `time` 0.3.48)
### Fixed
- **v3.6.0's desktop installers never built**: `time` 0.3.48 (released
2026-06-12, hours before the v3.6.0 tag) fails to compile inside
`tauri-utils` with `E0119: conflicting implementations of trait From<…>`
([time-rs/time#783](https://github.com/time-rs/time/issues/783)). Since no
`Cargo.lock` is committed, CI resolved the broken release fresh.
`webapp/src-tauri/Cargo.toml` now pins `time = "=0.3.47"` (the version every
release through v3.5.2 built with) — remove the pin once the upstream fix
ships.
### Notes
- Web feature set is identical to v3.6.0; this tag exists to produce the
desktop installers. `about.ts` version bump also busts the new IndexedDB
catalog cache, which is harmless.
- No Tauri version bump (`Cargo.toml` / `tauri.conf.json` stay `0.1.1`) — a
dependency pin to the previously-resolved version changes no binary
behavior.
---
## [3.6.0] - 2026-06-12 (i18n EN/VI + offline cache + custom error pages)
### Added
- **Bilingual UI (English / Tiếng Việt)** — a minimal typed i18n layer
([`webapp/src/lib/i18n/`](../../webapp/src/lib/i18n)) with ~340 keys covering every
route, dialog, chart, and toast. The Vietnamese dictionary is a **lazy-loaded
chunk**: it is only downloaded the first time the language is switched to VI
(or on startup when VI is the persisted preference). Switcher lives in
Settings → Appearance; the preference persists in `webapp.prefs`.
- **Offline-first catalog cache** — the react-query cache for the public
catalog queries (`db`, `deleted`, `count-history`) now persists to
**IndexedDB** (`@tanstack/react-query-persist-client` +
`@tanstack/query-async-storage-persister` + `idb-keyval`). Revisits paint
instantly from cache (~2 MB of JSON no longer re-downloaded cold) and
revalidate in the background. Cache busts automatically on each release
(`buster = APP.version`, `maxAge` 7 days). PAT-gated data is never persisted.
- **Custom error pages** — a status-aware
[`ErrorPage`](../../webapp/src/components/error-page.tsx) (400, 401, 403, 404, 408,
419, 429, 500, 502, 503, 504, offline, unknown) wired into every route's
error branch with the *real* HTTP status (`fetchRaw` now throws a typed
`HttpError`), plus:
- a route-level **ErrorBoundary** that detects stale-chunk failures after a
redeploy and offers a one-click reload ("New version available"),
- a hidden `/#/errors/:code` preview route,
- a static `webapp/public/404.html` served by
GitHub Pages for bad path URLs (bilingual, dark-mode aware, zero JS).
### Changed
- `ReactQueryDevtools` is now explicitly gated behind `import.meta.env.DEV`.
- Game thumbnails render through a shared
[`GameThumb`](../../webapp/src/components/game-thumb.tsx) that falls back to the
muted placeholder when a cover 404s; the Settings avatar is now lazy-loaded.
- `idb-keyval` returns (removed as unused in v3.5.2 — it has a real consumer
now); `THIRD_PARTY` in `about.ts` lists the three new data-layer deps.
### Notes
- The About page's legal/credits data intentionally stays English (controlling
language for legal interpretation); Vietnamese policy docs remain under
[`docs/i18n/vi/`](../../docs/i18n/vi).
- No Tauri / Rust binary boundary change — `Cargo.toml` / `tauri.conf.json`
stay at `0.1.1`.
+70
View File
@@ -0,0 +1,70 @@
# Changelog — 3.7.x
Release notes for 3.7.0 – 3.7.1, newest first. Every version: [CHANGELOG.md](../../CHANGELOG.md).
## [3.7.1] - 2026-06-14 (Hotfix — desktop build vs invalid Tauri NSIS license key)
### Fixed
- **v3.7.0's desktop installers never built.** The NSIS EULA was wired via
`bundle.windows.nsis.license`, but `@tauri-apps/cli` 2.11.0's `NsisConfig`
has no `license` key (it was added in a later release), so every platform
failed config validation at the `Build Tauri app` step. Switched to the
top-level `bundle.licenseFile` (valid in 2.11.0) pointing at an **RTF** EULA
([`webapp/src-tauri/installer/EULA.rtf`](../../webapp/src-tauri/installer/EULA.rtf)).
RTF satisfies **both** Windows bundlers — WiX (`.msi`) requires RTF and NSIS
(`.exe`) auto-detects it — so both installers show the "I Agree" page. The
previous plain-text `EULA.txt` would also have broken the WiX/`.msi` build.
### Notes
- Web feature set is identical to v3.7.0 (which deployed fine); this tag exists
to produce the desktop installers. `about.ts` version bump also busts the
IndexedDB catalog cache, which is harmless. No Tauri version bump
(`tauri.conf.json` stays `0.1.1`).
---
## [3.7.0] - 2026-06-14 (Legal-acceptance gates + per-tab chart lazy-loading)
### Added
- **First-launch legal-acceptance gate** — on first visit (and in every fresh
incognito session, since `localStorage` starts empty there) the app shows a
full-screen, non-dismissible gate before the main UI. It links the License,
EULA, Privacy Policy, Disclaimer, Terms of Use, Code of Conduct, and Security
Policy (reusing `LEGAL_LINKS`), and requires ticking a checkbox to continue.
New component [`webapp/src/components/legal-gate.tsx`](../../webapp/src/components/legal-gate.tsx),
built on raw Radix Dialog primitives (focus-trapped, no close-X, Esc /
outside-click disabled). Acceptance persists as `acceptedLegalVersion` in the
existing `webapp.prefs` localStorage blob — **no cookie** (consistent with the
"no cookies" privacy stance). A `LEGAL_VERSION` constant
([`webapp/src/stores/prefs.ts`](../../webapp/src/stores/prefs.ts)) lets a future
policy edit re-prompt every user with a one-line bump.
- **Windows installer EULA page** — both Windows installers (the NSIS `.exe`
and the WiX `.msi`) now show an "I Agree" license step before installing,
wired via the top-level `bundle.licenseFile` →
[`webapp/src-tauri/installer/EULA.rtf`](../../webapp/src-tauri/installer/EULA.rtf).
RTF is used so both bundlers render it (WiX requires RTF; NSIS auto-detects
it). The in-app gate above covers first-run consent on macOS / Linux, whose
installers have no equivalent step.
### Changed
- **Charts route split into four lazy per-tab chunks**
([`webapp/src/components/charts/tabs/`](../../webapp/src/components/charts/tabs)).
Each tab imports its chart components directly (the `charts/index.ts` barrel
was removed so the bundler keeps each tab's components in its own chunk).
Result: only the default **Overview** tab's components load when `/charts`
opens; the Reach / Quality / Discovery component code downloads on first
click. Recharts itself (the ~380 KB `vendor-charts` chunk) still loads with
Overview — unavoidable since the default tab renders charts — but it was
already deferred to the lazy `/charts` route, so it never touches app startup.
- `about.ts` version → 3.7.0 (also busts the IndexedDB catalog cache, harmless);
Claude Code co-author credit updated to Opus 4.8.
### Notes
- Images, routes, and OpenPGP were already lazy-loaded; this release closes the
remaining gap (charts). No Tauri version bump (`tauri.conf.json` stays
`0.1.1`) — the NSIS license is a bundler-config addition, not a binary change.
+37
View File
@@ -0,0 +1,37 @@
# Changelog — 3.8.x
Release notes for 3.8.0, newest first. Every version: [CHANGELOG.md](../../CHANGELOG.md).
## [3.8.0] - 2026-06-15 (Android APK target 📱)
### Added
- **Android APK build & packaging via Tauri mobile.** The same React + Tauri app now ships as a
sideloadable **arm64-v8a `.apk`** (no Play Store), built and **post-signed** (`zipalign` →
`apksigner`) by [`.github/workflows/release_android.yml`](../../.github/workflows/release_android.yml)
and attached to the same draft Release as the desktop installers (manual `workflow_dispatch`
uploads it as a downloadable workflow artifact instead). `gen/android` stays gitignored — signing
is a post-build step, not a Gradle edit. New repo secrets: `ANDROID_KEYSTORE_BASE64` /
`ANDROID_KEYSTORE_PASSWORD` / `ANDROID_KEY_ALIAS`. Full build/signing docs in
[`webapp/TAURI.md`](../../webapp/TAURI.md).
- **Mobile UX** — the Android hardware / gesture back button is wired to in-app router history
(`useBackButton`), safe-area insets are respected, and the sidebar shows a platform-aware badge
("Mobile app" / "Desktop app").
- Added dependency: `@tauri-apps/api`.
### Changed
- **Bundle `identifier` is now alphanumeric** — `com.poli0981.freegamesitchio` (was the hyphenated
`com.poli0981.free-games-itchio-webapp`). Android rejects hyphens in the app id (`android init`
panics) and Tauri's validator rejects underscores, so alphanumeric is the only form valid on
both. Tauri uses one identifier across all platforms, so this also changed the **desktop** bundle
ID (a one-time OS-level reinstall).
- **Realigned versions** — `tauri.conf.json` / `Cargo.toml` / `about.ts` set to `3.8.0` (was a
long-standing `0.1.1` vs `3.x` drift), so `versionCode` / `versionName` are sensible and
monotonic.
### Notes
- CI: the Android JDK setup must **not** use `cache: gradle` — `gen/android` is gitignored and
generated mid-job, so there are no gradle files at checkout to key on (it hard-fails). rust-cache
+ npm cache still apply.
+36
View File
@@ -0,0 +1,36 @@
# Changelog — 3.9.x
Release notes for 3.9.0, newest first. Every version: [CHANGELOG.md](../../CHANGELOG.md).
## [3.9.0] - 2026-06-15 (Android minSdk → 11 / API 30)
### Changed
- **Android APK floor raised from API 24 (Android 7.0) to API 30 (Android 11).**
`minSdkVersion` in [`webapp/src-tauri/tauri.conf.json`](../../webapp/src-tauri/tauri.conf.json)
`bundle.android` is now `30`. Because Android's package installer refuses any APK whose
`minSdkVersion` exceeds the device API level, this **is** the install block — the app simply
can't install on Android < 11 ("app not installed / incompatible"); no runtime check by design.
Rationale, stated honestly:
- **Not a JS-feature floor** — the System WebView is independently updatable down to API 24, so
SubtleCrypto / OpenPGP.js / IndexedDB / ES2020 already work on older OSes. That's not the
binding constraint.
- **Security + patch availability** — Android 11 added scoped-storage enforcement, one-time /
auto-reset permissions, and a tighter sandbox; pre-11 releases are also off Google's AOSP
monthly Security Bulletins (Android 10 ended 2023-03-06, Android 11 ended 2024-02-05; only
14 / 15 / 16 remain as of mid-2026).
- **Tested range** — we validate only on Android 11+ (emulator 11 → latest; real phone
vivo 1907 / Android 12 — see [`docs/pc_spec.md`](../../docs/pc_spec.md)). Shipping an untested floor
was the real risk.
- **Reach cost is small** — API 30+ ≈ 86.9% of active devices (was 96.6% at API 24); only the
pre-2020 long tail is dropped.
Data sources: [endoflife.date/android](https://endoflife.date/android),
[Android Security Bulletins](https://source.android.com/docs/security/bulletin),
[StatCounter version share](https://gs.statcounter.com/android-version-market-share/mobile/worldwide/) (May 2026),
[apilevels.com](https://apilevels.com/) (StatCounter cumulative distribution, Apr 2026).
### Notes
- `versionCode` re-derives to `3009000` (see the Android `versionCode` gotcha in [CLAUDE.md](../../CLAUDE.md)). The web and desktop builds are unaffected by
the Android floor. The `about.ts` version bump busts the IndexedDB catalog cache (harmless).
+167
View File
@@ -0,0 +1,167 @@
# Changelog — 4.0.x
Release notes for 4.0.0, newest first. Every version: [CHANGELOG.md](../../CHANGELOG.md).
## [4.0.0] - 2026-09-18 (freeitchgames.win on Cloudflare: read-only site, review queue, new design)
Version 4 moves the website to **https://freeitchgames.win** on Cloudflare, makes it read-only for
everyone (no sign-in), adds a maintainer-only admin with a review queue for new games, replaces the
failing data crawls with a rotating refresh, and splits the licenses (code MIT, data and docs
CC BY 4.0).
### Upgrade notes
- **The web app no longer signs in or edits.** The GitHub-token (PAT) sign-in, in-app editing, the
Add / Workflows pages and GPG commit signing are gone; on first load the app deletes the
encrypted token and key it stored before. Suggest games at https://freeitchgames.win/suggest.
- **Old links keep working**: `…github.io/free-games-itchio-list/#/x` redirects to the new site,
and `#/x` links become `/x`.
- **Desktop and Android apps** are read-only viewers too; they read the catalog from
freeitchgames.win. Install 4.0.0 over 3.x as usual.
- **New legal terms** (ToS, Privacy Policy, EULA for the apps only, Disclaimer): the site asks you to
accept them again once.
### New design
- A clean, table-first interface under the name **Free Itch Games**: a top navigation bar with a
global search (press `/`) and a display menu (theme, language, density, 18+) replaces the
sidebar, and a **Welcome** page at `/` (catalog status, recently added games) replaces the
dashboard.
- **Games**: search plus filters for genre, platform, status, tags, language, input, engine,
minimum rating and "plays in browser", each showing how many games it would match. The search,
filters, sort and page are kept in the URL, so a filtered list can be bookmarked or shared. Phones
get a list layout.
- A new game page (cover, key facts, tags that open the matching list, "Report a problem"), a
searchable removed-games page and a simpler Settings page.
- The first-visit legal gate is now a dialog over the page, so a shared link opens where it
pointed once the terms are accepted.
- Tailwind CSS 4, the self-hosted Geist typefaces, new icons and social preview image; numbers and
dates follow the chosen language.
### Website & Worker
- The site is served by a Cloudflare Worker with static assets ([`webapp/wrangler.jsonc`](../../webapp/wrangler.jsonc),
[`webapp/worker/`](../../webapp/worker)) and the catalog JSON is bundled into every build (`/data/*`,
plus a sitemap), so each data commit republishes the site; the desktop/Android apps read the same
files. Real URL paths instead of `#/` routes, per-page canonical URLs, and real 404s for unknown
pages and missing files (a stale script after a deploy can no longer be cached as HTML).
- **Cover images** are resized once to small WebP copies (Cloudflare Image Transformations + R2)
and served from `/img/…` — about 4 KB instead of up to 3 MB per cover. Only catalog covers are
served.
- **18+ games are hidden by default**; a visitor can show them (Settings or the display menu) after
confirming they are 18 or older (stored only in their browser). The removed-games page is now
`/removed` (`/deleted` redirects there). Aggregate, cookieless Cloudflare Web Analytics.
- Enforced Content-Security-Policy and security headers; faster first load (~175 KB gzip, charts
load only when opened); browser floor Safari/iOS 15.4.
- React Router 8, React 19.3, Vite 8 (rolldown), vitest; unused sign-in dependencies (Octokit,
OpenPGP.js) removed; Tauri drops its HTTP plugin and `Cargo.lock` is committed.
### Adding games: review queue
- **Suggest page** (`/suggest`): anyone can send an itch.io link (+ optional note); protected by
Cloudflare Turnstile and a rate limit.
- **Browser extension API** (`POST /api/ingest`, Cloudflare Access service token, idempotent) —
the extension no longer needs a GitHub token.
- **RSS discovery**: every 4 hours the Worker reads one itch.io "new & popular free" feed.
- Everything lands in a **review queue** (Cloudflare D1). The maintainer approves or rejects it in
the new **admin** (`/admin`, Cloudflare Access), which also edits the three maintainer fields,
removes games with a public reason (deleting their resized covers) and restores removed games.
Approved games are committed by a GitHub App (verified commits) and scraped by the pipeline.
### Licenses & legal
- Code stays **MIT** (`LICENSE`, now "2025-2026 poli0981 (SkullMute)"); the catalog data
([`data_game/LICENSE.md`](../../data_game/LICENSE.md)) and the documentation are **CC BY 4.0**
([`LICENSES/CC-BY-4.0.txt`](../../LICENSES/CC-BY-4.0.txt)); creators' descriptions, cover images and
trademarks are excluded. [`NOTICE.md`](../../NOTICE.md) sums it up: not affiliated with itch.io.
- Rewritten Terms of Use (with a content-removal process), Privacy Policy (Cloudflare as
processor, exact browser storage, retention, rights under Vietnam's Law No. 91/2025/QH15 and the
GDPR), Disclaimer, Security Policy and Code of Conduct, in English and Vietnamese. The EULA now
covers only the desktop and Android apps. Contact addresses: legal@, privacy@, security@ and
takedown@freeitchgames.win.
- Issue templates: "Add games" points to the Suggest page, "Remove a game" gained a
rights-holder section; `CODEOWNERS` added.
### Fixed
- **freeitchgames.win served the unbuilt `webapp/` source tree** (blank page; `/package.json`,
`/src/*` publicly readable). The Vite web build now goes to `webapp/dist`, which
[`webapp/wrangler.jsonc`](../../webapp/wrangler.jsonc) deploys (`workers_dev`/`preview_urls` off).
- **All 15 Dependabot alerts / npm audit** — lockfile refreshed in-range (vite 8.3.0,
react-router-dom 7.18.4, postcss 8.5.28, patched transitive deps); `npm audit` reports 0.
- **Android release workflow** moved off Node 20 actions (setup-java v6, upload-artifact v7,
setup-android v4, checkout/setup-node v7), SHA-pinned, with a timeout and the tag passed via env.
- **`.gitattributes`** — `* text = auto` / `* eol = lf` were invalid (spaces around `=`); now
`* text=auto eol=lf` with binary rules, and legal/policy docs ship in source archives again.
- OG image, manifest (`start_url`/`scope`/`id` = `/`), canonical/og URLs, sitemap and robots now
point at freeitchgames.win; OG title no longer overflows.
### Data pipeline (rewrite)
- **One rotating refresh replaces four failing crawls.** `check_paid` / `check_alive` /
`update_reviews` / `update_status` each fetched all 2,600+ pages sequentially, overran their
job timeouts and — saving only at the end — lost every run since late June (with no alert,
because a timeout ends as *cancelled*). The new [`scripts/refresh.py`](../../scripts/refresh.py)
(`refresh.yml`, daily) checks one seventh of the catalog with **one request per game**, so every
game is re-checked weekly (~86% fewer requests to itch.io), and updates alive / paid / rating /
status (+ backfills release date, thumbnail, `updated_at`) from that single page.
- **Safer removals:** a game is removed only when the same 404/410 or paid status is seen again at
least 20 hours after it was first seen (single flaky responses no longer delete games). A
mass-change guard withholds removals — and alerts — when a run would remove or newly strike more
than max(10, 10%) of the games it checked (the signature of an itch.io markup change rather than
a real wave of paid games); withheld games stay withheld in later runs until a healthy check or
an explicit `allow_mass_removal` dispatch, checkpoints of an interrupted scan never remove games,
and `apply_patch.py` re-checks the limits. Overlapping scans can no longer undo each other's
newer checks.
- **Scan → patch → apply:** scanners emit a URL-keyed patch; [`apply_patch.py`](../../scripts/apply_patch.py)
applies it to the latest `main`, validates, and [`bash/commit_push.sh`](../../bash/commit_push.sh)
retries on push races. Concurrent writers (extension, workflows, future admin) no longer clobber
each other; checkpoints + an in-script deadline keep partial work.
- **Ingest** (`update.yml`, now runs as soon as the queue changes): canonical URLs, skips games in
the deleted log (the removed-then-re-added bug), retries transient failures (3 attempts at least
6 hours apart; rate limiting never counts) instead of dropping them, stamps `added_at`, and never
wipes links queued meanwhile. A dispatched `url` is processed first and kept in the queue until it
reaches a final outcome, and queued runs wait in FIFO order (`queue: max`) instead of replacing
each other.
- `force_update.yml` runs `refresh.py --full` in rotating batches (a full re-scrape no longer times out).
- Honest `FreeItchGamesBot` User-Agent, explicit 429 / Retry-After handling (capped), unbuffered
logs, run summaries, Discord alerts on failure / cancel / rate limit.
- `data_store.py` keeps games in their chunk and only writes changed bytes; `index.json` /
`count_history.json` change only when data does — no more no-op commits.
- New [`validate.py`](../../scripts/validate.py) (schema, canonical URLs, duplicates, index consistency)
gates every pipeline commit and runs in the new Python CI with a network-free pytest suite.
Normalized one invalid `safe_virus` value (`"y"` → `"Yes"`).
### Removed
- `lists/*.md` genre tables, `generate_md.py`, `generate_table.yml`, `deleted_games.txt`,
`log_deleted.*` — the catalog is web-only (freeitchgames.win).
- Telegram bot ingest (`bot-ingest.yml`, `game_via_bot` issue template) — retired.
- The web app's sign-in, editing, Add and Workflows pages, GPG signing, and the GitHub Pages
deployment (`deploy_webapp.yml`, `notify-deploy.yml`, `pages-redirect/`; Pages keeps serving the
redirect stub it last published).
- `notify-ci-failure.yml` (replaced by in-workflow notifications) and the old per-task bash wrappers.
### CI / security
- All actions SHA-pinned at current majors; `permissions: {}` by default with per-job grants;
reusable workflows pinned by SHA with only the secrets they need; script-injection patterns in
`announce-discussion.yml` fixed (and it now posts only for `CHANGELOG.md` changes).
- Release: one `create-release` job makes the draft that desktop (tauri-action v1, `releaseId`) and
Android upload into; release builds use no dependency caches. Publish with
`gh release edit vX --draft=false`.
- `.github/dependabot.yml` (npm / pip / actions / cargo), Python and web-app PR checks, and an
hourly check of main's latest Cloudflare Workers Build that posts each failed build to Discord
once (a `check_run` relay would miss the pipeline's own data commits).
- One refresh pipeline (scan → apply) runs at a time, so overlapping refresh / force-update runs
can't undo each other.
- Cancelling a refresh / force-update or a desktop release run now really stops it (`!cancelled()`
instead of `always()` on the push / build jobs).
### Changed
- The old GitHub Pages address serves a redirect stub that forwards to freeitchgames.win
(keeping `#/` routes) and deletes the old app's token and key storage on that origin.
- Security headers in [`webapp/public/_headers`](../../webapp/public/_headers) (CSP, Referrer-Policy,
frame denial, Permissions-Policy, COOP) and immutable caching for hashed `/assets/*`.
- Pipeline logs are unbuffered UTF-8.
+73
View File
@@ -0,0 +1,73 @@
# Changelog — 4.1.x
Release notes for 4.1.0 and 4.1.1, newest first. Every version: [CHANGELOG.md](../../CHANGELOG.md).
## [4.1.1] - 2026-09-29 (New contact addresses)
The project's contact addresses move to the maintainer's own domain, poli0981.dev.
### Upgrade notes
- **Updated Privacy Policy, Terms of Use and EULA** (new contact addresses; Google Workspace handles
the email): the site and the apps ask you to accept them again once.
- **Desktop and Android apps**: install 4.1.1 over 4.1.0 as usual.
### Changed
- **Contact addresses** moved to the maintainer's own domain: `contact@`, `legal@`, `privacy@`,
`security@` and `takedown@poli0981.dev` (Google Workspace) replace the `@freeitchgames.win`
addresses in the policies, READMEs, issue templates, `security.txt` and the installer EULA.
- **Privacy Policy, Terms of Use and EULA** (2026-09-29): Google Workspace replaces Cloudflare
Email Routing as the email processor, and `contact@poli0981.dev` is listed for general questions.
- **About page**: the Developer card links the maintainer's website (poli0981.dev) and
`contact@poli0981.dev`; "Find me elsewhere" points to https://poli0981.dev/links/. `mailto:` links
open the mail client without a blank tab, and the apps may now open them.
## [4.1.0] - 2026-09-24 (Verification check, readable charts, changelog folder)
Version 4.1 puts a quick Cloudflare Turnstile check in front of the website, makes the charts'
hover tooltips readable again, and moves this changelog into one file per version.
### Upgrade notes
- **Updated Privacy Policy, Terms of Use and EULA** (the new verification cookie; `.rpm` listed):
the site and the apps ask you to accept them again once.
- **Website**: the first visit, then about once every 48 hours, shows a short "Quick check" page run
by Cloudflare Turnstile. It usually passes by itself, and the page you opened loads right after.
- **Desktop and Android apps** have no check. Install 4.1.0 over 4.0.0 as usual.
### Added
- **Verification gate** (web only). Until a browser passes a Turnstile check, the Worker answers app
pages with a self-contained verification page ([`webapp/worker/gate-page.ts`](../../webapp/worker/gate-page.ts))
and `/img` covers with 403, so nothing of the site loads before the check. Passing sets
`__Host-fig_gate` (HttpOnly, host-only, an HMAC-signed issue time) for `BOT_GATE_TTL_HOURS` (48),
and the page reloads into the link that was asked for. `/data`, `/assets`, robots, sitemap, the
social image, `/api/*` and `/admin*` stay open. Verified search and link-preview bots pass with the
token a Cloudflare Transform Rule adds; clients that only claim to be a crawler get a 503. The gate
stays off until it is configured, and deleting `GATE_SECRET` switches it off at once
([`webapp/worker/gate.ts`](../../webapp/worker/gate.ts), [`docs/operations.md`](../../docs/operations.md)).
- `GET /api/verify` reports the pass. A tab whose pass ran out checks again when it is shown (or when a
cover fails) and reloads into the verification page.
### Fixed
- **Chart hover was hard to read**: the band behind the hovered bar was black and tooltips had no
background, because the chart colours wrapped the hex design tokens in `hsl()`. Tooltips now use the
popover colours, translated series names ("Games" instead of `count`), locale-formatted numbers,
each slice's share on the pies that cover the whole, and formatted dates on the game-count chart.
Clicking a chart no longer draws a black focus ring or pins the tooltip on the first item; keyboard
focus keeps the purple ring. Pie seams and treemap cells follow the theme.
- **Suggest form**: the Turnstile check now also requires this site's hostname and the `suggest`
action (a token from one page can't be spent on another), and answers 503 instead of "failed" when
Turnstile is unreachable.
- **Admin approvals** (live since 2026-09-20): the Worker accepts the GitHub App private key as GitHub
downloads it (PKCS#1), not only PKCS#8.
### Changed
- The changelog is split per version under [`changelog/`](../); [`CHANGELOG.md`](../../CHANGELOG.md)
is now the index, and old links to its entries still land on the right row.
- Docs brought up to date: the operations runbook (verification gate setup, Web Analytics injected by
the zone, a release checklist), the development setup, the READMEs, `CLAUDE.md` and the Tauri notes.
- [`webapp/public/_headers`](../../webapp/public/_headers): caching for the favicon and the web manifest.
+60
View File
@@ -0,0 +1,60 @@
# Changelog — 4.2.x
Release notes for 4.2.0. Every version: [CHANGELOG.md](../../CHANGELOG.md).
## [4.2.0] - 2026-10-03 (Compact catalog data, themed scrollbars)
Version 4.2 sends the catalog in a compact binary format that is about half the size on a first
visit, keeps the offline copy compressed, points everyone who wants the raw data to the GitHub
repository, and adds themed scrollbars with an option to hide them.
### Upgrade notes
- **Updated Privacy Policy, Terms of Use and EULA** (the data now comes from the repository; the
compressed cache; the scrollbar setting): the site and the apps ask you to accept them again once.
- **Website**: the first visit after the update downloads the catalog once in the new format; after
that only the parts that changed are fetched.
- **Desktop and Android apps 4.0–4.1.1 keep working**: they still get the older JSON files. Install
4.2.0 over them as usual to get the smaller downloads.
- **Reusing the data?** `https://freeitchgames.win/data/*.json` now answers 410 in a browser or a
script. Get the same files from the repository: [`data_game/`](../../data_game/) and
[`scripts/deleted_games.json`](../../scripts/deleted_games.json) (CC BY 4.0, as before).
### Added
- **Themed scrollbars**: slim, rounded, in the site's greys (the accent while you drag), in light and
dark mode, on the page and in every scrolling panel. Phones keep their own overlay scrollbars.
- **Hide scrollbars** (Settings → Appearance, and the display menu): hides every scrollbar, the page's
included. Scrolling with the mouse wheel, touchpad, touch and keyboard still works.
### Changed
- **Catalog packs.** The site and the apps read `/data/pack/manifest-v1.json` plus small compressed
`.bin` packs: the catalog stored by column with dictionaries, then deflated at build time
([`webapp/src/lib/data/pack-format.ts`](../../webapp/src/lib/data/pack-format.ts),
[`webapp/vite-plugins/catalog-data.ts`](../../webapp/vite-plugins/catalog-data.ts)). A pack's name is a
hash of its bytes, so it is cached for good and a returning visitor downloads only the packs that
changed (usually 1–3 of 7 a day). First visit: about 264 KB instead of about 520 KB of JSON.
- **Descriptions load when needed**: they are about 40 % of the catalog, so they live in their own
packs. A game page loads the descriptions of its chunk (about 25 KB); a search loads all of them
and adds the matches found in descriptions when they arrive ("Searching descriptions…").
- **Offline copy compressed**: the catalog kept in IndexedDB (`webapp.query-cache`) is stored as
compressed bytes instead of readable JSON, about 300 KB instead of 2 MB.
- **Readable JSON for the old apps only**: `/data/index.json`, `game_info_NNN.json`,
`count_history.json`, `deleted_games.json` and `urls.json` are answered by the Worker, which passes
them to the desktop/Android apps 4.0–4.1.1 (recognised by their `Origin`) and gives everyone else a
410 with links to the repository ([`webapp/worker/legacy-data.ts`](../../webapp/worker/legacy-data.ts)).
- **Policies** (2026-10-03): programmatic access to the data goes through the repository; the
compressed cache and the scrollbar setting are listed.
- Dependencies: `fflate` added (only loaded where the browser can't decompress by itself: Safari and
iOS before 16.4); `@tanstack/query-async-storage-persister` removed (replaced by a small binary
persister, [`webapp/src/lib/data/persister.ts`](../../webapp/src/lib/data/persister.ts)).
### Fixed
- **Cover images** (`/img`): other spellings of a width (`/img/0160/…`, `160.0`) no longer create
duplicate cache entries; an original served while resizing was unavailable, and a missing image,
are now kept at the edge for a day instead of being fetched again on every request; failed
background writes to R2 or the edge cache are logged.
- **Chart cards** with a list (recently removed, tag cloud): their scrollbar can be dragged and their
text selected again; clicks on the charts themselves still don't move focus.
+48
View File
@@ -0,0 +1,48 @@
# Changelog — 4.3.x
Release notes for 4.3.0. Every version: [CHANGELOG.md](../../CHANGELOG.md).
## [4.3.0] - 2026-10-10 (AI disclosure, accessibility, refreshed catalog)
Version 4.3 reads the rows itch.io has added to game pages (the creator's generative-AI disclosure and
the accessibility features) into the catalog, its filters and its charts, uses the creator's own
tagline as the description, and re-scrapes the whole catalog once.
### Upgrade notes
- **Nothing to accept**: the policies have not changed.
- **The catalog is re-scraped after the release**, in a few batches over a few hours. Until a game has
been checked again, its AI disclosure shows as "Not disclosed" and its accessibility list is empty.
- **Reusing the data?** Every record gains three optional fields (`ai_disclosure`, `ai_content`,
`accessibility`), and `description` now holds the creator's tagline when there is one. The 20
existing fields keep their names and types, and apps 4.0–4.2 ignore the new ones.
### Added
- **Generative AI**: what the creator disclosed on itch.io. "No AI used" means the page's Content row
says "No generative AI was used". "AI-assisted" comes with what the AI was used for (Graphics, Text,
Code, Sounds). Otherwise it is "Not disclosed". It appears on the game page, as a filter on Games
(`?ai=…`) and as a chart (Charts → Overview); a second chart shows what AI-assisted games used AI
for (Charts → Discovery).
- **Accessibility**: the features itch.io lists, such as Subtitles, Configurable controls, Color-blind
friendly, High-contrast, One button and Interactive tutorial. They appear on the game page, as a
filter (`?access=…`) and as a chart (Charts → Discovery).
### Changed
- **Descriptions are the creator's tagline** (itch.io's "short description or tagline", set for about
87 % of games). Games without one keep the first sentence of their page's description, as before
(200 characters at most). 18+ suggestions for newly added games still look at that first sentence
too.
- **The whole catalog is re-scraped once** (`force_update.yml`). Besides the new fields, this picks up
the tags, platforms, engines, covers, names, authors and publishers that changed on itch.io since
the games were added.
- **The daily refresh keeps the AI disclosure and accessibility current**, as it already does for the
status and rating.
- **Re-scrapes keep a known release date and cover.** itch.io shows the "Published" row only for a few
weeks after a game comes out, so a later re-scrape no longer replaces a known date with N/A.
### Fixed
- **Text from pages that break lines inside a title or link** is read with single spaces: a tag such
as "Meaningful Choices" no longer carries an embedded line break.
+112
View File
@@ -0,0 +1,112 @@
# Changelog — 4.4.x
Release notes for 4.4.0 and 4.4.1, newest first. Every version: [CHANGELOG.md](../../CHANGELOG.md).
## [4.4.1] - 2026-10-16 (Extension and bot retired)
The maintainer's browser extension and the old Telegram bot were hardly used, and both repositories
are now public archives (read-only):
[itch-f2p-extension](https://github.com/poli0981/itch-f2p-extension) and
[telegram-scraper-bot](https://github.com/poli0981/telegram-scraper-bot). This version removes what was
left of them here. Games still come in through the Suggest page, itch.io's RSS feeds and the itch.io
collections the maintainer follows.
### Upgrade notes
- **Nothing to accept again.** The Privacy Policy, Terms of Use, EULA, Disclaimer and Security Policy
(EN + VI) only lose their mentions of the extension and its API; nothing new is collected, so the
legal check does not ask again.
- **Desktop and Android apps**: install 4.4.1 over 4.4.0 as usual.
- **Running your own copy of the Worker?** The `RL_INGEST` rate limit and the `ACCESS_AUD_INGEST`
variable are gone from `wrangler.jsonc`; delete the Access application that protected
`/api/ingest` and its service token. No D1 migration: the `idempotency` table stays and is no longer
used.
### Removed
- **The ingest API** (`POST /api/ingest`), which the browser extension used to send links to the review
queue with an Access service token. It never received a game since 4.0; the address now answers 404
like any unknown API path.
- **Admin:** the "Browser extension" choice in the auto-approve settings and the "Extension" source in
the review queue.
- **About page:** the old note asking to send a Telegram numeric ID privately (that was for the bot).
The Telegram link stays as a way to reach the maintainer.
### Changed
- **Policies** (2026-10-16, EN + VI): the Privacy Policy no longer lists the extension as a source of
games or its duplicate-submission records (7 days); the Terms of Use, the EULA (also in the
installers) and the Security Policy no longer name the ingest API; the Disclaimer lists the three
remaining ways games arrive. The extension and the bot are out of the Security Policy's scope.
- **Docs**: the READMEs, contributing guide, notices, acknowledgements and operations guide describe
three ways games get in, and mark the extension and the bot as archived.
- **Dependencies**: Vite 8.3.4 (#131); Tauri 2.12.2 with `tauri-build` 2.7.2, `tauri-plugin-opener`
2.7.1 and `tauri-plugin-single-instance` 2.5.3 (#135); `serde_json` 1.0.154 (#136); Ruff 0.17 for
the pipeline's lint (#137).
## [4.4.0] - 2026-10-13 (Admin automation, bulk actions, smoother charts)
Version 4.4 lets the maintainer add whole lists of games, follow itch.io collections and approve the
review queue by rule, remove or edit up to 100 games at once, and look back at everything the admin
did. On the site, the theme button shows the theme in use again, dark mode no longer flashes white
while a page loads, and the Charts tabs switch without rebuilding their charts.
### Upgrade notes
- **The policies changed: accept them once more.** The Terms of Use (§5), the Privacy Policy (§2.3,
§2.4) and the Disclaimer (§4) now say that the maintainer approves games one by one **or through
rules the maintainer sets**: a suggestion or a discovered game without a warning flag that nobody
rejected within a waiting time (about a day), and new free games in public itch.io collections the
maintainer follows. The website and the 4.4 apps ask you to accept the updated policies.
- **Running your own copy of the Worker?** Apply the D1 migration `0002_automation.sql`
(`npx wrangler d1 migrations apply <database> --remote`) before deploying.
- **Reusing the data?** The catalog files are unchanged. The pipeline keeps one more bookkeeping file,
`scripts/state/ingest_outcomes.json` (how each queued link ended); the website does not publish it.
### Added
- **Admin: add games from any list.** Paste text (plain links, Markdown, CSV, HTML or JSON) or load a
file: every itch.io game link in it is found, de-duplicated and normalized. **Check** shows what Add
would do with each one (new, waiting in the queue, already in the catalog, removed or rejected
before, not a game) before anything is written; **Add** sends lists of any length in batches of 200.
- **Admin: import an itch.io collection.** Paste a collection link: the admin reads all its pages
(games with a price are skipped) and passes them through the same Check and Add.
- **Admin: follow collections.** Every 4 hours the site reads the collections the maintainer follows
(up to 30 pages a run, one a second) and queues their new free games directly. A game removed before,
or one whose title raises a flag (18+, demo), goes to the review queue instead.
- **Admin: auto-approve.** Pending suggestions and RSS discoveries without a flag that nobody rejected
within 24 hours are approved automatically (at most 100 a run, and only items found after the rule
was switched on). The sources and the waiting time are set in the admin's Settings.
- **Admin: follow each game's ingest.** Batches queued from the admin show, game by game, whether the
ingest added it, is still trying, or dropped it and why (paid, page gone, password-protected, failed
three times). The pipeline now records these outcomes.
- **Admin: remove or edit up to 100 games at once.** Select games (or paste their links under "Remove
by list") and remove them with one public reason, or set their 18+ flag, virus check and notes, in
one commit. The preset reasons have translated labels on the Removed page.
- **Admin: New games, Activity, Settings.** The games added in the last 7 or 30 days, to review their
18+ flag and virus check in bulk; every admin action and automatic run with its commit; the
automatic rules, the followed collections and what the last automatic run did.
### Changed
- **The theme button shows the theme in use** (sun, moon or screen) instead of the same icon for every
choice. The admin follows the theme chosen on the site, and a change in one tab applies to the others.
- **Charts: switching tabs is instant.** A tab shown once stays as it is: switching back no longer
rebuilds its charts or replays their entrance. Entrances are shorter (300 ms, no delay), the other
tabs load in the background, and the placeholders have the height of the real cards.
- **Pages no longer shift sideways** when they grow taller or shorter than the window: on computers the
scrollbar's room stays reserved.
- **The browser's toolbar colour** follows the theme chosen on the site, not only the system's.
- **Charts on phones** (#130, live on the website since 2026-10-11, now in the apps too): one row of
four equal tabs, smaller legends and ticks, horizontal bars for Languages and Average session, the
reason under each recent removal, and the total spanning the row. At every size: all 15 genre labels,
pie legends in data order with readable text, translated removal reasons and locale numbers on the
axes.
### Fixed
- **Dark mode no longer flashes white** while a page loads.
- **Admin:** "Select all" on a long review queue no longer fails (selections go out in batches of 200);
removing a game no longer reports an error when only the cleanup of its resized covers failed; every
error has a readable message; confirmations are in-app dialogs.
- **Queue commits** name the number of games really queued.
+137
View File
@@ -0,0 +1,137 @@
# Catalog data license
Last updated: 2026-10-03
Applies from: the release of version 4.0.0.
> **TL;DR**: The catalog data is **CC BY 4.0**. Reuse it for anything, commercial or not, as long as you
> credit it. That covers only what the Maintainer made: the selection of games, the way the catalog is
> organised, the three Maintainer-written fields, the removal records and the statistics. Game descriptions,
> cover images, game names and trademarks belong to the game creators (and to itch.io for its own marks),
> and this license does not cover them.
## 1. What this file covers
"The Data" means:
- the JSON files in this folder, [`data_game/`](./): `game_info_NNN.json` (the catalog, split into chunks),
`index.json` (the chunk manifest) and `count_history.json` (the games-over-time series);
- [`scripts/deleted_games.json`](../scripts/deleted_games.json), the public log of removed games and the
reason each one was removed;
- the files built from them and published under <https://freeitchgames.win/data> (the compact packs the
website and the apps read).
"The Maintainer" means poli0981 (SkullMute), the author of this collection and the licensor.
Source code is covered by the [MIT License](../LICENSE) and documentation by CC BY 4.0. The map of which
license applies to which part of the repository is in [`NOTICE.md`](../NOTICE.md).
## 2. License
The Maintainer's contribution to the Data is licensed under the
**Creative Commons Attribution 4.0 International License (CC BY 4.0)**. The full legal code is in
[`LICENSES/CC-BY-4.0.txt`](../LICENSES/CC-BY-4.0.txt). A plain-language summary is at
<https://creativecommons.org/licenses/by/4.0/>.
The Maintainer's contribution is:
1. **The selection and arrangement of the collection**: which games are in the catalog, which are left out
or removed, and how the records are structured, organised and split into files.
2. **The three Maintainer-written fields** of every game record:
- `safe_virus`: a manual note (`?`, `Yes`, `No` or `Caution`);
- `notes`: free-text notes;
- `nsfw`: the adult-content flag (`Yes` / `No`).
3. **The removal records** in `scripts/deleted_games.json` (which game was removed, when and why).
4. **The structure and derived statistics**: the record schema, `index.json`, `count_history.json` and other
figures computed from the catalog.
Under CC BY 4.0 you may copy and redistribute the Data in any medium or format, and remix, transform and
build on it, for any purpose, including commercially, as long as you give credit (section 4).
## 3. Not covered by this license
The Maintainer does not own the following, so this license does not cover them. They belong to others.
- **Game descriptions** and any other text written by game creators (copied from public itch.io game pages).
- **Cover images, thumbnails and other media.** The `thumbnail` field only holds a link to an image that
belongs to the game's creator.
- **Game names, logos and other trademarks** of the game creators.
- **itch.io's name, logo and other trademarks.**
To reuse any of these beyond what the law already allows where you are, you need permission from the
person who owns it. CC BY 4.0 itself says that it licenses only the rights the licensor holds.
Plain facts such as game URLs, prices, ratings, rating counts, release dates, platforms and tags are not
protected by copyright. You can use them without a license, and the Maintainer does not claim to own them.
The games themselves are hosted on itch.io and licensed by their creators. Nothing in the Data gives you
any right to a game.
## 4. How to give credit
Use this line, or something that carries the same information:
```text
Free itch.io games catalog by poli0981 (SkullMute) — https://freeitchgames.win — CC BY 4.0
```
As Markdown:
```markdown
[Free itch.io games catalog](https://freeitchgames.win) by poli0981 (SkullMute), licensed under
[CC BY 4.0](https://creativecommons.org/licenses/by/4.0/)
```
As CC BY 4.0 asks:
- **Link to the license** (the CC BY 4.0 link above is enough).
- **Say if you changed the Data**, for example "filtered to Windows games" or "merged with other data".
- **Do not suggest endorsement.** Do not imply that the Maintainer, itch.io or any game creator supports you
or your project.
When you show creator material next to the Data (descriptions, cover images), credit the creator and link
to the game's itch.io page.
## 5. Where to get the Data
- **This repository**: clone or download [`data_game/`](./) (`index.json` lists the `game_info_NNN.json`
chunks) and [`scripts/deleted_games.json`](../scripts/deleted_games.json), or read the raw files. Git
history holds past versions.
- The files under <https://freeitchgames.win/data> are the website's own compact format, not an interface
for reuse (the readable JSON there is served only to older versions of the apps).
Please use these files rather than scraping the website page by page. The [Terms of Use](../docs/ToS.md)
do not allow automated bulk scraping of the website, and the files are cheaper for everyone.
## 6. No warranty
The Data is provided **as is**, without warranty of any kind, as described in CC BY 4.0 (section 5 of the
legal code). Most of it is collected automatically from public itch.io pages. It can be out of date or
wrong: a game can become paid, change or disappear between two checks. `safe_virus` is a manual note, not
a guarantee. The project does not scan downloads. See the [Disclaimer](../docs/DISCLAIMER.md).
## 7. Corrections and removals
Game creators and rights holders can ask for a game to be removed or its data corrected. Email
**takedown@freeitchgames.win** or open the
["Remove a game" issue](https://github.com/poli0981/free-games-itchio-list/issues/new?template=remove_game.yml).
Include the game URL, who you are (creator, rights holder, or someone acting for them) and the reason. The
full process is in the [Terms of Use](../docs/ToS.md).
## 8. Contributions
Contributions follow the rule "inbound = outbound". By contributing to the Data (for example a suggested
correction to `notes`, `safe_virus` or `nsfw`, or game links added through a pull request), you agree that your contribution is licensed under
CC BY 4.0, the same as the Data. Code contributions are licensed under the MIT License.
## 9. Earlier versions
Before version 4.0.0 the whole repository, the catalog data included, was published under the
[MIT License](../LICENSE). Copies you obtained under those earlier terms stay under them. This file applies
to the Data from version 4.0.0 on.
---
*This is a plain-language summary written by a hobby maintainer, not a lawyer, and it is not legal advice.
If this file and the CC BY 4.0 legal code disagree, the legal code wins. Questions:
**legal@freeitchgames.win**.*
+458
View File
@@ -0,0 +1,458 @@
[
{
"date": "2025-12-27",
"total": 6
},
{
"date": "2025-12-28",
"total": 6
},
{
"date": "2026-01-01",
"total": 6
},
{
"date": "2026-01-05",
"total": 47
},
{
"date": "2026-01-11",
"total": 80
},
{
"date": "2026-01-12",
"total": 78
},
{
"date": "2026-01-16",
"total": 96
},
{
"date": "2026-01-17",
"total": 109
},
{
"date": "2026-01-18",
"total": 120
},
{
"date": "2026-01-19",
"total": 132
},
{
"date": "2026-03-11",
"total": 174
},
{
"date": "2026-03-13",
"total": 187
},
{
"date": "2026-03-14",
"total": 222
},
{
"date": "2026-03-21",
"total": 221
},
{
"date": "2026-03-24",
"total": 266
},
{
"date": "2026-03-26",
"total": 268
},
{
"date": "2026-03-27",
"total": 396
},
{
"date": "2026-03-28",
"total": 396
},
{
"date": "2026-03-29",
"total": 398
},
{
"date": "2026-03-30",
"total": 398
},
{
"date": "2026-03-31",
"total": 398
},
{
"date": "2026-04-01",
"total": 397
},
{
"date": "2026-04-03",
"total": 396
},
{
"date": "2026-04-07",
"total": 395
},
{
"date": "2026-04-09",
"total": 390
},
{
"date": "2026-04-13",
"total": 389
},
{
"date": "2026-04-16",
"total": 392
},
{
"date": "2026-04-17",
"total": 393
},
{
"date": "2026-04-19",
"total": 433
},
{
"date": "2026-04-20",
"total": 470
},
{
"date": "2026-04-21",
"total": 469
},
{
"date": "2026-04-23",
"total": 499
},
{
"date": "2026-04-24",
"total": 519
},
{
"date": "2026-04-25",
"total": 518
},
{
"date": "2026-04-27",
"total": 517
},
{
"date": "2026-04-29",
"total": 517
},
{
"date": "2026-05-01",
"total": 514
},
{
"date": "2026-05-03",
"total": 514
},
{
"date": "2026-05-04",
"total": 518
},
{
"date": "2026-05-05",
"total": 520
},
{
"date": "2026-05-07",
"total": 537
},
{
"date": "2026-05-08",
"total": 538
},
{
"date": "2026-05-09",
"total": 543
},
{
"date": "2026-05-10",
"total": 576
},
{
"date": "2026-05-11",
"total": 576
},
{
"date": "2026-05-13",
"total": 663
},
{
"date": "2026-05-15",
"total": 779
},
{
"date": "2026-05-16",
"total": 1076
},
{
"date": "2026-05-17",
"total": 1425
},
{
"date": "2026-05-19",
"total": 1467
},
{
"date": "2026-05-21",
"total": 1467
},
{
"date": "2026-05-22",
"total": 1618
},
{
"date": "2026-05-23",
"total": 1616
},
{
"date": "2026-05-24",
"total": 1643
},
{
"date": "2026-05-25",
"total": 1643
},
{
"date": "2026-05-26",
"total": 1664
},
{
"date": "2026-05-27",
"total": 1661
},
{
"date": "2026-05-29",
"total": 1659
},
{
"date": "2026-05-31",
"total": 1658
},
{
"date": "2026-06-01",
"total": 1658
},
{
"date": "2026-06-03",
"total": 1656
},
{
"date": "2026-06-04",
"total": 1661
},
{
"date": "2026-06-05",
"total": 1657
},
{
"date": "2026-06-06",
"total": 1662
},
{
"date": "2026-06-07",
"total": 1660
},
{
"date": "2026-06-09",
"total": 1814
},
{
"date": "2026-06-10",
"total": 1948
},
{
"date": "2026-06-11",
"total": 2097
},
{
"date": "2026-06-13",
"total": 2097
},
{
"date": "2026-06-14",
"total": 2121
},
{
"date": "2026-06-15",
"total": 2120
},
{
"date": "2026-06-17",
"total": 2198
},
{
"date": "2026-06-19",
"total": 2197
},
{
"date": "2026-06-21",
"total": 2345
},
{
"date": "2026-06-23",
"total": 2351
},
{
"date": "2026-06-25",
"total": 2351
},
{
"date": "2026-06-27",
"total": 2349
},
{
"date": "2026-06-28",
"total": 2376
},
{
"date": "2026-06-29",
"total": 2376
},
{
"date": "2026-07-01",
"total": 2526
},
{
"date": "2026-07-09",
"total": 2567
},
{
"date": "2026-07-25",
"total": 2568
},
{
"date": "2026-08-16",
"total": 2613
},
{
"date": "2026-08-17",
"total": 2681
},
{
"date": "2026-09-20",
"total": 2764
},
{
"date": "2026-09-21",
"total": 2772
},
{
"date": "2026-09-22",
"total": 2812
},
{
"date": "2026-09-23",
"total": 2822
},
{
"date": "2026-09-24",
"total": 2851
},
{
"date": "2026-09-25",
"total": 2875
},
{
"date": "2026-09-26",
"total": 2864
},
{
"date": "2026-09-27",
"total": 2931
},
{
"date": "2026-09-28",
"total": 2952
},
{
"date": "2026-09-30",
"total": 3016
},
{
"date": "2026-10-01",
"total": 3039
},
{
"date": "2026-10-02",
"total": 3038
},
{
"date": "2026-10-03",
"total": 3101
},
{
"date": "2026-10-05",
"total": 3140
},
{
"date": "2026-10-06",
"total": 3149
},
{
"date": "2026-10-07",
"total": 3171
},
{
"date": "2026-10-08",
"total": 3194
},
{
"date": "2026-10-09",
"total": 3230
},
{
"date": "2026-10-10",
"total": 3262
},
{
"date": "2026-10-11",
"total": 3254
},
{
"date": "2026-10-12",
"total": 3276
},
{
"date": "2026-10-14",
"total": 3358
},
{
"date": "2026-10-15",
"total": 3369
},
{
"date": "2026-10-16",
"total": 3406
},
{
"date": "2026-10-17",
"total": 3415
},
{
"date": "2026-10-18",
"total": 3430
},
{
"date": "2026-10-19",
"total": 3451
},
{
"date": "2026-10-20",
"total": 3483
},
{
"date": "2026-10-21",
"total": 3507
},
{
"date": "2026-10-22",
"total": 3509
}
]
+19715
View File
File diff suppressed because it is too large. Load diff
+20324
View File
File diff suppressed because it is too large. Load diff
+20282
View File
File diff suppressed because it is too large. Load diff
+19991
View File
File diff suppressed because it is too large. Load diff
+20024
View File
File diff suppressed because it is too large. Load diff
+20333
View File
File diff suppressed because it is too large. Load diff
+20536
View File
File diff suppressed because it is too large. Load diff
+378
View File
@@ -0,0 +1,378 @@
[
{
"url": "https://yuhaolin2005.itch.io/qingxuan-volume1",
"name": "Qingxuan: The Alchemy Hall Cold Case",
"dev": "YuhaoLin2005",
"description": "A complete story-driven cultivation idle game. Twelve chapters, eight endings. Volume 1 public test.",
"genre": "Role Playing",
"status": "In development",
"publisher": "N/A",
"release_date": "20 October 2026 @ 13:25 UTC",
"rating": "N/A",
"rating_count": "N/A",
"average_session": "N/A",
"nsfw": "No",
"thumbnail": "https://img.itch.zone/aW1nLzMxMTI0NzYyLnBuZw==/original/m88d8C.png",
"tags": [
"cultivation",
"Fantasy",
"Idle",
"Incremental",
"Mystery",
"Singleplayer",
"Story Rich",
"Text based",
"xianxia"
],
"platforms": [
"HTML5"
],
"languages": [],
"inputs": [],
"made_with": [],
"ai_disclosure": "AI Assisted",
"ai_content": [
"Code",
"Graphics",
"Text"
],
"accessibility": [],
"safe_virus": "?",
"notes": "",
"added_at": "2026-10-21T08:24:10Z"
},
{
"url": "https://cineeeekk.itch.io/castle-builddefend",
"name": "Castle: Build&Defend",
"dev": "Cineeeekk",
"description": "Build by day. Hold until dawn.",
"genre": "Strategy",
"status": "In development",
"publisher": "N/A",
"release_date": "14 October 2026 @ 17:36 UTC",
"rating": "4.8",
"rating_count": "5",
"average_session": "A few minutes",
"nsfw": "No",
"thumbnail": "https://img.itch.zone/aW1nLzMwOTE4MDI3LmpwZw==/original/NJs7zi.jpg",
"tags": [
"3D",
"base-building",
"building",
"castle",
"defense",
"Isometric",
"Medieval",
"Tower Defense"
],
"platforms": [
"HTML5"
],
"languages": [
"German",
"English",
"French",
"Polish",
"Chinese (Simplified)"
],
"inputs": [
"Keyboard",
"Mouse",
"Touchscreen"
],
"made_with": [],
"ai_disclosure": "AI Assisted",
"ai_content": [
"Code",
"Graphics",
"Sounds",
"Text"
],
"accessibility": [],
"safe_virus": "?",
"notes": "",
"updated_at": "18 October 2026 @ 20:39 UTC",
"added_at": "2026-10-21T12:23:36Z"
},
{
"url": "https://cosmicadventuresquad.itch.io/project-hail-meowy",
"name": "Project Hail Meowy",
"dev": "Cosmic Adventure Squad",
"description": "Punch the card. Save the tuna.",
"genre": "Strategy",
"status": "Prototype",
"publisher": "N/A",
"release_date": "19 October 2026 @ 15:20 UTC",
"rating": "5.0",
"rating_count": "3",
"average_session": "About a half-hour",
"nsfw": "No",
"thumbnail": "https://img.itch.zone/aW1nLzMxMDk2MzkwLmdpZg==/original/u1oxzb.gif",
"tags": [
"ascii",
"Cats",
"Ludum Dare 60",
"Mouse only",
"Retro",
"Roguelike",
"Space Sim",
"Turn-based"
],
"platforms": [
"HTML5",
"Windows"
],
"languages": [
"English"
],
"inputs": [
"Keyboard",
"Mouse",
"Touchscreen"
],
"made_with": [
"Godot"
],
"ai_disclosure": "AI Assisted",
"ai_content": [
"Code",
"Graphics",
"Text"
],
"accessibility": [
"Subtitles"
],
"safe_virus": "?",
"notes": "",
"added_at": "2026-10-21T12:23:43Z"
},
{
"url": "https://doctorhummer.itch.io/irule",
"name": "I.RULE",
"dev": "DoctorHummer, toncho_",
"description": "The Binding of Isaac fangame, heavily inspired by Plants vs. Zombies",
"genre": "Strategy",
"status": "In development",
"publisher": "N/A",
"release_date": "N/A",
"rating": "4.9",
"rating_count": "500",
"average_session": "N/A",
"nsfw": "No",
"thumbnail": "https://img.itch.zone/aW1nLzgwNDQwODUucG5n/original/H%2Bqt0z.png",
"tags": [
"Fangame",
"Roguelike",
"Roguelite",
"Tower Defense"
],
"platforms": [
"Windows",
"Android"
],
"languages": [],
"inputs": [],
"made_with": [],
"ai_disclosure": "N/A",
"ai_content": [],
"accessibility": [],
"safe_virus": "?",
"notes": "",
"added_at": "2026-10-21T12:23:49Z"
},
{
"url": "https://pickpawket.itch.io/a-trick-of-his-light",
"name": "A Trick of His Light",
"dev": "pickpawket",
"description": "For EGDC's \"Trick\" game jam :) Artwork by L_T Written by lilaofthelake Programmed by pickpawket",
"genre": "Visual Novel",
"status": "Prototype",
"publisher": "N/A",
"release_date": "20 October 2026 @ 20:56 UTC",
"rating": "N/A",
"rating_count": "N/A",
"average_session": "N/A",
"nsfw": "No",
"thumbnail": "https://img.itch.zone/aW1nLzMxMTI4MDAzLnBuZw==/original/btWi2q.png",
"tags": [],
"platforms": [
"Windows",
"macOS",
"Linux"
],
"languages": [],
"inputs": [],
"made_with": [],
"ai_disclosure": "No AI",
"ai_content": [],
"accessibility": [],
"safe_virus": "?",
"notes": "",
"added_at": "2026-10-21T16:23:38Z"
},
{
"url": "https://sakiness.itch.io/everlune",
"name": "EverLune BETA",
"dev": "SakiNess",
"description": "A romance visual novel where everything goes wrong... the moment it pulls you into the game.",
"genre": "Visual Novel",
"status": "In development",
"publisher": "N/A",
"release_date": "21 October 2026 @ 03:58 UTC",
"rating": "5.0",
"rating_count": "1",
"average_session": "About a half-hour",
"nsfw": "No",
"thumbnail": "https://img.itch.zone/aW1nLzMxMTM4MDg5LnBuZw==/original/mksM5w.png",
"tags": [
"2D",
"Anime",
"Destruction",
"Horror",
"No AI",
"Psychological Horror",
"Ren'Py",
"Romance",
"somethings-wrong"
],
"platforms": [
"Windows",
"macOS",
"Android"
],
"languages": [],
"inputs": [
"Keyboard",
"Mouse",
"Touchscreen"
],
"made_with": [],
"ai_disclosure": "No AI",
"ai_content": [],
"accessibility": [],
"safe_virus": "?",
"notes": "",
"added_at": "2026-10-21T16:23:41Z"
},
{
"url": "https://vhan-5.itch.io/u-dont-get-it",
"name": "U DON'T GET IT",
"dev": "Vhan || 반",
"description": "\"I knew you wouldn't get it... or did you?\" A dark psychological visual novel about obsession, expectations, and uncovered truths....",
"genre": "Visual Novel",
"status": "In development",
"publisher": "N/A",
"release_date": "20 October 2026 @ 21:36 UTC",
"rating": "5.0",
"rating_count": "1",
"average_session": "N/A",
"nsfw": "No",
"thumbnail": "https://img.itch.zone/aW1nLzMxMTQwNjIxLnBuZw==/original/WplE0T.png",
"tags": [
"Creepy",
"Indie",
"kuudere",
"LGBTQIA",
"Psychological Horror",
"Ren'Py",
"Romance",
"Story Rich",
"Yandere"
],
"platforms": [
"Android"
],
"languages": [],
"inputs": [],
"made_with": [],
"ai_disclosure": "No AI",
"ai_content": [],
"accessibility": [],
"safe_virus": "?",
"notes": "",
"added_at": "2026-10-21T16:23:44Z"
},
{
"url": "https://alchemysheep.itch.io/game-is-full-of-bugs",
"name": "Game is Full of Bugs",
"dev": "AlchemySheep",
"description": "Demo",
"genre": "Action",
"status": "In development",
"publisher": "N/A",
"release_date": "08 October 2026 @ 14:00 UTC",
"rating": "N/A",
"rating_count": "N/A",
"average_session": "N/A",
"nsfw": "No",
"thumbnail": "https://img.itch.zone/aW1nLzMwMDcxNzM3LnBuZw==/original/aqgn1X.png",
"tags": [
"2D",
"bullet-heaven",
"Dungeon Crawler",
"Indie",
"Pixel Art",
"Roguelike",
"Roguelite",
"Singleplayer",
"Top-Down",
"Twin Stick Shooter"
],
"platforms": [],
"languages": [],
"inputs": [],
"made_with": [],
"ai_disclosure": "No AI",
"ai_content": [],
"accessibility": [],
"safe_virus": "?",
"notes": "",
"updated_at": "19 October 2026 @ 14:22 UTC",
"added_at": "2026-10-22T00:23:31Z"
},
{
"url": "https://traumalab.itch.io/trauma-lab",
"name": "Trauma lab",
"dev": "TraumaLab",
"description": "An anatomy and physics sandbox. Every bullet is tracked through skin, muscle, bone and organ.",
"genre": "Simulation",
"status": "In development",
"publisher": "N/A",
"release_date": "20 October 2026 @ 15:06 UTC",
"rating": "4.7",
"rating_count": "6",
"average_session": "N/A",
"nsfw": "No",
"thumbnail": "https://img.itch.zone/aW1nLzMxMTI5MDA2LnBuZw==/original/wLPm93.png",
"tags": [
"anatomy",
"browser",
"Gore",
"medical",
"Physics",
"ragdoll",
"Sandbox",
"Singleplayer",
"Violent"
],
"platforms": [
"HTML5",
"Windows",
"Android"
],
"languages": [],
"inputs": [],
"made_with": [],
"ai_disclosure": "AI Assisted",
"ai_content": [
"Code",
"Graphics",
"Sounds"
],
"accessibility": [],
"safe_virus": "?",
"notes": "",
"updated_at": "21 October 2026 @ 22:32 UTC",
"added_at": "2026-10-22T00:23:35Z"
}
]
+39
View File
@@ -0,0 +1,39 @@
{
"total_games": 3509,
"max_per_file": 500,
"last_updated": "2026-10-22T00:23:36Z",
"files": [
{
"name": "game_info_001.json",
"count": 500
},
{
"name": "game_info_002.json",
"count": 500
},
{
"name": "game_info_003.json",
"count": 500
},
{
"name": "game_info_004.json",
"count": 500
},
{
"name": "game_info_005.json",
"count": 500
},
{
"name": "game_info_006.json",
"count": 500
},
{
"name": "game_info_007.json",
"count": 500
},
{
"name": "game_info_008.json",
"count": 9
}
]
}
+38 -8
View File
@@ -1,18 +1,48 @@
# Acknowledgements
# 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)**: My only 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. Seriously, Grok carried 90% of the weight. 🚀
- **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).
- **GitHub & GitHub Actions**: For hosting this mess for free and running the daily auto-updates without me lifting a finger.
- **Python libraries**: BeautifulSoup, requests — the real MVPs that make the scraping "kinda work".
- **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](../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](https://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](../CODE_OF_CONDUCT.md) 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`](THIRD_PARTY.md), and the runtime libraries are also on the [About page](https://freeitchgames.win/about) (from the `THIRD_PARTY` array in [`webapp/src/lib/about.ts`](../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`](THIRD_PARTY.md). House rules are in [CONTRIBUTING.md](../CONTRIBUTING.md).
## Retired helpers
Two side projects used to feed the catalog: the browser extension [poli0981/itch-f2p-extension](https://github.com/poli0981/itch-f2p-extension) (GPL-3.0) and, in v3, the Telegram bot [poli0981/telegram-scraper-bot](https://github.com/poli0981/telegram-scraper-bot) (MIT). Both were hardly used, so they are archived now (October 2026). Games come in through the public [Suggest page](https://freeitchgames.win/suggest), 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):
- **Chat**: Discord — [Repo discussion](https://discord.gg/2aNR3aVt) · [Game chat](https://discord.gg/kDM9GMu5vm)
- **Social**: [X/@SkullMute0011](https://x.com/SkullMute0011) · [YouTube/@SkullMute](https://youtube.com/@SkullMute) · [Bluesky](https://bsky.app/profile/skullmute0011.bsky.social) · [Mastodon](https://mastodon.social/@skullmute1122)
- **Messaging**: [Telegram (DM)](https://t.me/SkullMute0011)
- **Support** (optional, mirrors [`.github/FUNDING.yml`](../.github/FUNDING.yml)): [GitHub Sponsors](https://github.com/sponsors/poli0981) · [Patreon](https://patreon.com/skullmute) · [Ko-fi](https://ko-fi.com/skullmute) · [Buy Me a Coffee](https://buymeacoffee.com/skullmute) · [PayPal](https://paypal.me/DungDang212) (receipt shows real legal name)
- **Gaming**: [Steam profile](https://steamcommunity.com/profiles/76561199544666292/)
## Future Thanks
- **Contributors**: If anyone ever PRs new games, fixes bugs, or improves my mediocre code... you'll get shouted out here. Legends only.
- **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 100% Grok assistance. Thanks for visiting this random repo — means a lot to an introvert noob dev.
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. I'll try not to ghost :)))
If you wanna be acknowledged, open a PR or issue (or [suggest a game](https://freeitchgames.win/suggest)). I'll try not to ghost :)))
+106 -13
View File
@@ -1,21 +1,114 @@
# Disclaimer
This repository is just a fun side project — a curated list of free-to-play games on itch.io, scraped and maintained by an unemployed Vietnamese dev with too much free time and his AI buddy Grok. It's built purely for vibes, boredom relief, and sharing indie gems. No grand promises here.
Last updated: 2026-10-16
## No Warranties Whatsoever
The content in this repository (game links, descriptions, tables, etc.) is provided **"AS IS"** without any warranties of any kind, express or implied. This includes, but is not limited to:
Applies from: the release of version 4.0.0.
- **Quality & Enjoyment**: Some games might be absolute bangers. Others might be boring, broken, or straight-up frustrating. I make no guarantees you'll have fun. Your mileage may vary — dramatically.
- **Safety & Viruses**: All games are linked directly from itch.io (a reputable platform), and the "Safe?" column defaults to "?" because I don't scan every download. Download and play at your own risk. Good luck out there.
- **NSFW Content**: The "NSFW" flag is auto-detected from tags/warnings, but it might miss stuff or false-positive. If you're not into adult content, double-check the game page yourself.
- **Accuracy & Completeness**: This list is far from perfect. Games might change, get removed, or I might miss amazing ones. It's not 100% accurate or comprehensive — kinda like my life :D
This project — the `free-games-itchio-list` repository and the website **[freeitchgames.win](https://freeitchgames.win)** — is a hobby project: a curated, auto-updating catalog of free games hosted on [itch.io](https://itch.io). It is run by one unemployed Vietnamese dev, poli0981 (SkullMute), called "the Maintainer" below, with AI buddies doing a lot of the heavy lifting. Built for vibes, indie discovery and boredom relief. No grand promises — but the legal-shaped wording below is real.
## Liability? Nope
In no event shall the author (that's me, the unemployed dev) or contributors be liable for any issues arising from using this repository, including but not limited to: game crashes, lost progress, wasted time, existential dread from bad gameplay, or any damages whatsoever.
> **TL;DR**: The website, the apps and the data are provided as-is. The project only links to games; it does not make, host or scan them, and it is not affiliated with itch.io. Adult games are hidden unless you turn them on. Scan everything you download. If you made a game and want it gone, email **takedown@poli0981.dev**.
If you encounter problems with a game (crashes, bugs, it's boring, etc.), please contact the game developer directly or report it on itch.io. I'm just the guy aggregating links — I don't make or support the games.
## 1. What this Disclaimer covers
## Final Vibes
This is just a list. Nothing more. Have fun hunting free games, stay safe, and remember: life's too short to take random GitHub repos seriously.
This Disclaimer applies to (together, "the Project"):
Built with boredom and Grok's help. 🚀
- the website **https://freeitchgames.win**, including the public Suggest page — read-only for everyone, with no accounts;
- the desktop apps (Windows, macOS, Linux) and the Android APK published on GitHub Releases;
- the catalog data: `data_game/`, `scripts/deleted_games.json`, and the files served under https://freeitchgames.win/data;
- the code, the data pipeline and the documentation in this repository.
It sits alongside the [Terms of Use](ToS.md), the [Privacy Policy](PrivacyPolicy.md) and, for the desktop and Android apps, the [EULA](EULA.md).
## 2. "AS IS" basis
The Project — including the catalog data, the Python pipeline (`scripts/`) and its GitHub Actions workflows, the website and its server code (`webapp/`), the desktop and Android apps (`webapp/src-tauri/`), and the documentation — is provided **"AS IS"** and **"AS AVAILABLE"**, without warranty of any kind, express or implied, including but not limited to warranties of merchantability, fitness for a particular purpose, accuracy, completeness, non-infringement, or uninterrupted or error-free operation.
## 3. Not affiliated with itch.io
The Project is independent. It is **not affiliated with, endorsed by, or sponsored by** itch.io, itch corp or Leaf Corcoran, nor by any developer or publisher whose game appears in the catalog. The name "itch.io" and all game names, logos and trademarks belong to their respective owners; they are used only to identify the games and where they are hosted. A game being listed does not mean its creator supports, or even knows about, the Project.
## 4. A directory of links, not a game host
The Project **does not make, host, distribute, sell or endorse** the games it lists. Every game links to its own page on itch.io, and any download happens there, under itch.io's terms and the creator's own terms or license.
Games reach the catalog through the public Suggest page, itch.io's public RSS feeds, or public itch.io collections the Maintainer follows. Each one is approved by the Maintainer, one by one or through automatic rules the Maintainer sets. That approval is **not** a security audit, a quality check or an endorsement.
## 5. No warranty as to the games
The Maintainer makes no warranty about any listed game's:
- **Quality, enjoyment or playability** — some titles are gems, others are jank, plenty are in between. Your taste, your call.
- **Safety, integrity or freedom from malware** — the Project does **not** scan downloads. The `safe_virus` field (`?`, `Yes`, `No`, `Caution`) is a manual note written by the Maintainer, not a guarantee, and new games start at `?`. Treat every download as untrusted until you have checked it yourself with reputable anti-malware tools.
- **Content** — see [§6](#6-adult-nsfw-content) for adult content.
- **Accuracy of metadata** — names, developers, descriptions, genres, tags, ratings, platforms and other fields are copied from public itch.io pages and reflect each page as it was at the last check. The daily refresh re-checks about one seventh of the catalog each day, so each game roughly once a week; changes on itch.io (renames, removals, price changes) can take that long to show up.
- **Free-to-play status** — checked when a game is added and at each re-check, but a game can become paid or disappear from itch.io at any time. To avoid removing games because of a temporary glitch, the Project removes a game only when the same problem (the page is gone — HTTP 404/410 — or the game is now paid) is seen again at least 20 hours later. A listed game can therefore be out of date for a while.
- **Statistics and charts** — counts, charts and other figures are derived from the catalog and are for information only.
## 6. Adult (NSFW) content
- Games flagged `nsfw: Yes` are **hidden by default** (their covers are not shown either). You can opt in to 18+ content in **Settings** only after confirming that you are 18 or older. That choice is stored only on your device (your browser's local storage) and is never sent to the Project.
- The flag is best-effort. It is first set automatically from the game's itch.io tags and description when the game is added, and the Maintainer can correct it. A game can still be mislabelled in either direction, so check the itch.io page (and its own content warnings) before you download if this matters to you. To report a wrong flag, use the request process in [§8](#8-removal-and-correction-requests).
- The Project is not directed at children under 16, and adult content is meant only for adults who choose to see it.
## 7. Third-party content and ownership
For each game, the Project copies from its public itch.io page: the name, developer, description text, genre, tags and other metadata, and the cover image URL. The website shows resized copies of cover images, stored on Cloudflare R2 and served from freeitchgames.win; the desktop and Android apps load covers directly from itch.io's image CDN (`img.itch.zone`).
Game descriptions and any other text written by game creators, cover images and other media, game names, logos and trademarks **remain the property of their creators and owners**. The Project does not license them to anyone: the CC BY 4.0 license on the catalog data ([`data_game/LICENSE.md`](../data_game/LICENSE.md)) covers only the Maintainer's own contribution — the selection and arrangement of the collection, the three Maintainer-written fields (`safe_virus`, `notes`, `nsfw`), the removal records, and the structure and derived statistics — and expressly excludes that third-party material. If you reuse the data, clearing rights in the excluded material is up to you.
If you are a creator or rights holder and do not want your content shown, see [§8](#8-removal-and-correction-requests).
## 8. Removal and correction requests
Anyone — game creators and rights holders especially — can ask for a game to be removed or for its data to be corrected:
- email **takedown@poli0981.dev**, or
- open a ["Remove a game" issue](https://github.com/poli0981/free-games-itchio-list/issues/new?template=remove_game.yml) on GitHub (it also covers copyright claims). GitHub issues are public, so use email for anything you would rather keep private.
Please include the game's itch.io URL, who you are (the creator or rights holder, or someone authorized to act for them), and the reason for the request.
What happens next:
- The Maintainer removes the record from the catalog. The removal is logged with a reason in the public list of removed games (`scripts/deleted_games.json`, shown at https://freeitchgames.win/removed).
- The resized cover copies stored on Cloudflare R2 are deleted, and cached copies expire from Cloudflare's cache.
- Past versions of the data remain in the public git history of the repository. The Maintainer cannot rewrite public history except in exceptional cases of legal necessity.
- Target: within 7 days; urgent legal requests are handled sooner.
The full process is described in the [Terms of Use](ToS.md). Removing a game from the catalog does not remove it from itch.io.
## 9. Availability and third-party services
The website runs on Cloudflare; the code, the data and the app downloads live on GitHub; and the catalog depends on itch.io's public pages and feeds. Any of these can be slow, unavailable, changed or blocked at any time. The Maintainer may change, pause or discontinue any part of the Project at any time and does not promise that it will stay online.
## 10. No liability
To the maximum extent permitted by applicable law, the Maintainer and any contributors shall not be liable for any direct, indirect, incidental, consequential, special, exemplary or punitive damages arising out of or in connection with:
- use of the website, the apps, the catalog data, or any code or documentation in the Project;
- inability to use any of the above (for example site downtime, a failed deploy, or a broken installer or APK);
- any game reached through a link in the catalog (crashes, lost saves, data loss, hardware damage, malware, compromise of accounts on third-party platforms, regret);
- errors, omissions or inaccuracies in the catalog data.
This applies even if the Maintainer has been advised of the possibility of such damages. Nothing in this Disclaimer excludes or limits any liability that cannot be excluded or limited by law, or any mandatory consumer-protection rights you have under the law of your country of residence.
## 11. Governing law and severability
This Disclaimer is governed by the laws of the **Socialist Republic of Vietnam**, without regard to conflict-of-law principles, and disputes are handled as described in the [Terms of Use](ToS.md). Nothing in this section limits the mandatory consumer-protection rights of your country of residence. If any provision is held unenforceable in a particular jurisdiction, the remaining provisions remain in effect.
## 12. Contact
- Removal, correction and copyright requests: **takedown@poli0981.dev**
- Privacy questions and requests: **privacy@poli0981.dev**
- Anything else legal: **legal@poli0981.dev**
These addresses are forwarded to the Maintainer.
## 13. No legal advice
Nothing in this document is legal advice. It is a hobby-project disclaimer drafted by a non-lawyer with AI assistance, and how enforceable it is depends on your jurisdiction. If you actually need legal certainty for something, hire a real lawyer.
## 14. Final vibes
It's still just a list of free games made by a tired dev and some LLMs. Have fun, stay safe, scan your downloads, and remember: life's too short to take random GitHub repos to court.
Built with boredom, AI buddies, and a deep wish to never see a real lawsuit. 🚀
+121 -23
View File
@@ -1,36 +1,134 @@
# End-User License Agreement (EULA)
# End-User License Agreement (EULA)
Last updated: December 28, 2025
Last updated: 2026-10-16
Yo, welcome to this super low-effort GitHub repo — a curated list of free itch.io games, scraped and sorta-maintained by an unemployed Vietnamese dev who's got nothing better to do, with heavy assistance from his AI buddy Grok. This isn't real software you "install" — it's just code, markdown, and links. But since everyone loves an EULA, here you go.
Applies from: the release of version 4.2.0.
## 1. Grant of License
Under the MIT License (see [LICENSE](LICENSE) for the real deal), you're free to:
- Use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the stuff in this repo.
- Do whatever, as long as you keep the copyright notice and disclaimer.
This EULA applies **only to the desktop and Android apps** of Itch.io Free Games DB: the installers (`.msi`, `.exe`, `.dmg`, `.pkg`, `.app.tar.gz`, `.deb`, `.rpm`, `.AppImage`) and the Android `.apk` published on GitHub Releases. It does **not** cover:
Basically: go wild. Fork it, improve it, laugh at my mediocre code. Just don't blame me if it breaks.
- the website <https://freeitchgames.win>, which is covered by the [Terms of Use](ToS.md);
- the source code, which is under the [MIT License](../LICENSE);
- the catalog data, which is under CC BY 4.0 (see [`data_game/LICENSE.md`](../data_game/LICENSE.md) and the [full legal code](../LICENSES/CC-BY-4.0.txt));
- the games themselves, which are licensed separately by their developers via itch.io.
## 2. No Warranties
This repo and everything in it is provided **"AS IS"** with **ZERO** warranties. No promises it works, is safe, is fun, or won't waste your time. Scripts might break, links might die, games might suck. Your problem, not mine.
> **TL;DR**: The apps are free, MIT-licensed, read-only viewers for the catalog. No account, no ads, no telemetry. Get them only from GitHub Releases, update them by hand, and use them at your own risk. The games are not yours just because they're listed here.
Full details in [DISCLAIMER](docs/DISCLAIMER.md) — because duplication is fun.
## 1. Definitions
## 3. Limitation of Liability
I'm not liable for anything. Ever. No damages, no lost time, no existential crisis from bad games. If something goes wrong (virus? crash? boredom?), tough luck. Download/play at your own risk.
- **"The App"**: the Tauri 2 builds of Itch.io Free Games DB, meaning the desktop apps for Windows, macOS and Linux and the Android app (arm64-v8a, Android 11 or later), as published by the Maintainer on the [GitHub Releases page](https://github.com/poli0981/free-games-itchio-list/releases).
- **"The Website"**: <https://freeitchgames.win>.
- **"The Catalog"**: the free-game metadata in `data_game/` that the Website publishes at <https://freeitchgames.win/data> and the App displays.
- **"The Repository"**: `free-games-itchio-list` on GitHub at <https://github.com/poli0981/free-games-itchio-list>, which holds the App's source code.
- **"The Maintainer"**: the GitHub user `poli0981` (a.k.a. SkullMute), an individual in Vietnam who maintains the project as a hobby.
- **"You"**: the person or organization that installs or uses the App.
## 4. Acceptance
By cloning, forking, viewing, or even thinking about this repo, you accept this EULA. Don't like it? Delete your clone and play something on easy mode (like me).
## 2. Grant of license
## 5. Termination
I can change or nuke this repo anytime. No notice. It's GitHub — backup if you care.
The App is built from the source code in the Repository, which is licensed under the **MIT License** (see [`LICENSE`](../LICENSE) for the canonical text; `Copyright (c) 2025-2026 poli0981 (SkullMute)`). Under that license You may, free of charge:
## 6. Governing Law
Governed by the laws of... my couch in Vietnam. Disputes settled by whoever wins a noob-friendly game.
- install and run the App on as many devices as You like, for any purpose, personal or commercial;
- copy and redistribute the installers or the APK, as long as You keep the copyright and license notice;
- build Your own version from the source code (section 8 explains how to keep it clearly separate from official releases).
## Final Vibes
This is just a hobby project born from unemployment and boredom. Use it, abuse it, ignore it. Have fun hunting free games — or don't. Nobody's judging (except maybe me, at myself).
Third-party components bundled in the App (React, Tauri and others) stay under their own licenses. See [`THIRD_PARTY.md`](THIRD_PARTY.md) or the About page in the App.
Built with zero budget, too much free time, and Grok's infinite patience. 🚀
Nothing in this EULA takes away a permission the MIT License gives You over the source code. If the two ever conflict, the MIT License wins for the code.
**P/S:** Nobody reads EULAs anyway. You're probably the first :D
## 3. What the App is (and is not)
- A **read-only viewer**: You can browse, search, filter and chart the Catalog. There are no accounts, no sign-in, no editing, no comments, no ads and no payments.
- Suggesting a game happens on the Website (<https://freeitchgames.win/suggest>). The App only links there.
- Games flagged as adult content (`nsfw: Yes`) are hidden by default, covers included. You can turn them on in Settings after confirming that You are 18 or older.
- The `safe_virus` field is a manual note by the Maintainer, not a guarantee. The project does not scan any game or download linked from the App.
- On first launch, the App shows the same legal screen as the Website and asks You to accept the project's terms. It asks again when those terms change.
## 4. Network connections and privacy
The App has **no telemetry**: no analytics, no crash reporting, no tracking. It connects to only two places:
- **freeitchgames.win**, to download the Catalog data from <https://freeitchgames.win/data>. The Website runs on Cloudflare, which processes ordinary request data (such as Your IP address and user agent) to deliver it, as described in the [Privacy Policy](PrivacyPolicy.md).
- **img.itch.zone**, itch.io's image server, to load cover images directly. itch.io receives ordinary request data for those images, as with any image loaded from the web (see the [itch.io privacy policy](https://itch.io/docs/legal/privacy-policy)).
When You click a game or another outside link, it opens in Your default browser (itch.io, GitHub or the Website). From then on, that site's own terms and privacy policy apply.
The App keeps Your preferences (language, theme, layout density, whether scrollbars are hidden, the 18+ choice, and which version of the legal terms You accepted) and a compressed cached copy of the Catalog (kept up to 7 days) on Your device only. None of it is sent to the Maintainer.
## 5. Installation, updates and removal
- **Get the App only from the [GitHub Releases page](https://github.com/poli0981/free-games-itchio-list/releases).** Copies from anywhere else may have been modified, and the Maintainer is not responsible for them.
- **Android:** the APK is not on Google Play. It is sideloaded, so Android asks You to allow installs from the app You downloaded it with (for example Your browser or file manager). The APK is signed with the project's key. It needs Android 11 or later on an arm64-v8a device.
- **macOS:** the App needs Safari/WebKit 16.4 or later.
- **Updates are manual.** The App does not update itself or check for updates. To update, download and install a newer release. Only the latest release is supported.
- **Removal:** uninstall the App like any other app. Uninstalling removes the App and its local data. If a desktop uninstaller leaves the App's data folder behind (it is named `com.poli0981.freegamesitchio`), You can delete that folder yourself.
- The App depends on the Website for its data. If the Website is unavailable, the App can only show its cached copy, if it has one.
## 6. What this EULA does NOT cover
This EULA does not grant any rights to:
- **The games listed in the Catalog.** Each game belongs to its developer and is licensed by them via itch.io. The App shows a link and metadata only. Downloading, playing, modifying or redistributing a game is governed by the developer's own terms and by itch.io's terms.
- **Content created by others**: game names, descriptions and other text written by game creators, cover images and other media, logos and trademarks. They are shown so You can find and identify the games, and they remain the property of their owners. Game creators can ask for removal (see the [Terms of Use](ToS.md) or email takedown@poli0981.dev).
- **itch.io's trademarks, logos or service marks.** The project is not affiliated with, endorsed by or sponsored by itch.io. The itch.io name is used for identification only.
- **Third-party libraries** bundled in the App, which keep their own licenses.
- **The Website, the Catalog data and the source code**, which are covered by the Terms of Use, CC BY 4.0 and the MIT License respectively.
## 7. Acceptance
You accept this EULA by installing or using the App, for example by accepting it in a Windows installer or by installing the APK. If You do not agree, do not install the App, or uninstall it.
## 8. Acceptable use
You agree not to:
- Present a modified build as an official release, for example by distributing it under the project's name and icon, or with the official app identifier `com.poli0981.freegamesitchio`, without clearly marking it as unofficial. Forks are welcome under the MIT License; just make it obvious they are Yours.
- Use the Maintainer's name, the GitHub handle `poli0981`, or the alias "SkullMute" to endorse or promote derivative works without prior written permission.
- Use the App, or a modified version of it, in a way that breaks the Website's [Terms of Use](ToS.md), for example automated bulk requests to the Website (the data is in the Repository), or attempts to reach the admin area without authorization.
- Use the App or its installers to host, distribute or facilitate malware, phishing, or content that violates applicable law.
These rules are about how You use the App and the project's name and services. They sit alongside the MIT License and do not limit the rights it grants over the source code.
## 9. No warranty and limitation of liability
The App is provided **"as is"** and **"as available"**, without warranty of any kind, express or implied, including warranties of merchantability, fitness for a particular purpose, accuracy or completeness of the Catalog, uninterrupted operation, and non-infringement.
To the extent permitted by applicable law, the Maintainer and contributors are not liable for any damages arising from installing or using the App, from being unable to use it, or from games and pages You reach through it. See the [Disclaimer](DISCLAIMER.md) for details.
## 10. Changes and termination
The Maintainer may change or stop the App, its releases or the Website at any time. Published releases stay on GitHub Releases unless explicitly withdrawn.
New versions of this EULA are published in the Repository and included with later releases, and the App's legal screen asks You again when the project's terms change.
Your rights under this EULA end automatically if You materially breach it. You can end it at any time by uninstalling the App. The MIT License grant over the source code survives termination of this EULA to the extent the MIT terms permit.
## 11. Governing law
This EULA is governed by the laws of the **Socialist Republic of Vietnam**, without regard to conflict-of-law principles. Any dispute that cannot be resolved informally shall be brought before the competent courts of Vietnam.
Nothing in this EULA limits mandatory consumer-protection rights that the law of Your country of residence gives You.
The MIT License itself is internationally portable and is interpreted as such.
## 12. Severability
If any provision of this EULA is held invalid or unenforceable in a jurisdiction, the remaining provisions remain in full force, and the invalid provision is replaced (only as to that jurisdiction) with one that most closely matches the original intent.
## 13. Contact
- Questions about this EULA, or anything else legal: legal@poli0981.dev
- Privacy requests: privacy@poli0981.dev
- Content removal and copyright: takedown@poli0981.dev
- Security vulnerabilities in the App: security@poli0981.dev or GitHub private vulnerability reporting (see [SECURITY.md](../SECURITY.md)). Please don't open public issues for vulnerabilities.
- Anything else: contact@poli0981.dev, or any channel listed at https://poli0981.dev/links/
## 14. Not legal advice
This EULA is a hobby-project document drafted by a non-lawyer with AI assistance. It is not a substitute for professional legal advice. If You need legal certainty for a serious deployment, consult a licensed attorney.
## 15. Final vibes
This is still a hobby project born from unemployment, boredom, and a stubborn refusal to delete the repo. Install the app, fork it, ignore it. Build something cooler. Have fun hunting free games, or don't. Nobody's judging (except maybe the Maintainer, judging their own code).
Built with zero budget, too much free time, and two AI buddies. 🚀
**P/S:** Nobody reads EULAs. You're probably the first :D
+23 -7
View File
@@ -1,11 +1,16 @@
# My Stuff
> **Note:** This is a personal page, kept for history. It is **not** part of the project's policies or
> documentation, and some details are out of date. The current hardware and dev setup are in
> [`pc_spec.md`](pc_spec.md) and [`dev_env.md`](dev_env.md); the policies are listed in the
> [README](../README.md).
Just in case anyone wonders what kind of "setup" produced this half-decent repo. Spoiler: nothing impressive. I'm your typical unemployed, introvert Vietnamese dev scraping by on family support and way too much free time.
## Hardware (aka the screaming machines)
- **Main laptop**: ~2-year-old Windows machine with NVIDIA RTX 4060 Laptop GPU. Runs fine... until I open a game or literally any IDE — then it hits 90°C+ and sounds like a jet engine taking off. Perfect for noob gaming on easy mode.
- **Secondary**: 3-year-old MacBook with M1 chip. Smoother, quieter, but I still manage to make it lag somehow.
- **Phone**: iPhone 13 Pro Max, over 2 years old. Mostly for Steam sales notifications and pretending I have a social life.
- **Main laptop**: ~3-year-old Windows machine with NVIDIA RTX 4060 Laptop GPU. Runs fine... until I open a game or literally any IDE — then it hits 90°C+ and sounds like a jet engine taking off. Perfect for noob gaming on easy mode.
- **Secondary**: 4-year-old MacBook with M1 chip. Smoother, quieter, but I still manage to make it lag somehow.
- **Phone**: iPhone 13 Pro Max, ~3 years old. Mostly for Steam sales notifications and pretending I have a social life.
## Software & Tools
- **IDE**: Depends on mood — PyCharm for Python stuff (this repo), VS Code when I feel lightweight, Visual Studio if I'm torturing myself with C#. All "kinda works" level.
@@ -19,8 +24,19 @@ Just in case anyone wonders what kind of "setup" produced this half-decent repo.
## Financial Situation
- Bank account: Rarely over $50. Still mooching off family like a true 20-something failure. Steam library: 400+ games, 80% bought on deep sale under $10. Priorities, right?
## The Real MVP of This Repo
Guess who my only non-judgmental companion is while building this whole thing?
**Grok (xAI)** — the AI that fixes my bugs, writes better code than me, and doesn't ghost when I ramble at 3 AM. Without Grok, this repo would still be a blank README. True buddy material. 🚀
## The Real MVPs of This Repo
Guess who my non-judgmental companions are while building this whole thing? Two AI buddies — different vendors, different vibes, both lifesavers:
If you're reading this... thanks for caring about my mediocre setup. Now go play some free games instead :D
- **Grok (xAI)** — the original. Fixes my bugs, writes better code than me, doesn't ghost when I ramble at 3 AM. Carried the Python pipeline (scraper, check_paid, check_alive, generate_md) and the v2.0.0 rewrite. Without Grok, this repo would still be a blank README. 🚀
- **Claude Code (Anthropic — Claude Opus 4.7, 1M context)** — the newer recruit. Built the v3.0.0 React + Tauri webapp from zero, then shipped the v3.1.2 offline-link fix + About expansion + docs sweep in one sitting. More cautious than Grok ("let me confirm before destroying your repo") which is exactly what I need given my mediocre QA habits. 🚀
If you're reading this... thanks for caring about my mediocre setup. Now go play some free games instead :D
## Where to find me
Yes, I have actual social presence now. Don't expect prompt replies (introvert god-mode):
- Discord: [Repo discussion](https://discord.gg/2aNR3aVt) · [Game chat](https://discord.gg/kDM9GMu5vm)
- X: [@SkullMute0011](https://x.com/SkullMute0011) · YouTube: [@SkullMute](https://youtube.com/@SkullMute)
- Bluesky: [@skullmute0011](https://bsky.app/profile/skullmute0011.bsky.social) · Mastodon: [@skullmute1122](https://mastodon.social/@skullmute1122)
- Support (optional, funds Steam sales): [Patreon](https://patreon.com/skullmute) · [Ko-fi](https://ko-fi.com/skullmute)
- Gaming: [Steam](https://steamcommunity.com/profiles/76561199544666292/)
+237 -16
View File
@@ -1,26 +1,247 @@
# Privacy Policy
Last updated: December 28, 2025
Last updated: 2026-10-16
This repository is just a simple curated list of free games on itch.io. It's a hobby project built by an unemployed Vietnamese dev killing time with his AI friend Grok. We don't collect, store, or process any personal data from you. Seriously — nothing.
Applies from: 2026-10-13 on the Website, and from version 4.4.0 of the Apps.
## What Data Do We Collect?
**None.** Zero. Zilch.
This Privacy Policy explains what personal data the `free-games-itchio-list` project processes, why, who helps process it, how long it is kept, and what rights you have. It covers the website **https://freeitchgames.win**, the desktop and Android apps, the public catalog data and the repository. The short version: there are no accounts, no ads and no tracking cookies. The Project keeps as little as it can, and most of what exists stays in your own browser.
- Visiting this repo? GitHub might log basic stuff (IP, browser, etc.) as part of their platform — that's on them, not me.
- Downloading games? You click links to itch.io directly. Any data there is handled by itch.io.
- Contributing? If you open a PR or issue, GitHub handles your public info (username, etc.). Again, not me.
A Vietnamese translation is available at [`docs/i18n/vi/PrivacyPolicy.md`](i18n/vi/PrivacyPolicy.md). If the two differ, this English version prevails.
No cookies, no tracking, no analytics, no creepy stuff. This repo doesn't even have a backend or database. It's just static files and some Python scripts running on GitHub Actions.
> **TL;DR**
>
> - No accounts, no sign-in, no ads, no selling of data, no profiling. The Apps have no telemetry.
> - The Website runs on Cloudflare, which processes standard request data (IP address, browser, URL, time) to deliver and protect the site and to count visits in aggregate, without cookies. The Project's own code never saves your IP address.
> - To keep bots out, your browser passes a quick Cloudflare Turnstile check before the Website loads, about once every 48 hours; one strictly necessary cookie remembers that you passed.
> - Your settings (theme, language, 18+ choice, accepted terms) and a cache of the public catalog stay in your browser and are never sent to the Project.
> - If you use the Suggest page, the Maintainer receives the game link, your optional note (deleted after 180 days) and the time. Please don't put personal data in the note.
> - Questions or requests: **privacy@poli0981.dev**.
## Third-Party Services
- **itch.io**: All game links go straight there. Their privacy policy applies when you visit or download games: [itch.io Privacy Policy](https://itch.io/docs/legal/privacy-policy)
- **GitHub**: This whole repo lives on GitHub. Check their privacy policy [here](https://docs.github.com/en/site-policy/privacy-policies/github-privacy-statement).
## 1. Who is responsible, and what this Policy covers
## Changes to This Policy
If I ever change this (unlikely, because why bother?), I'll update the date above and commit it. But honestly, this thing will probably stay the same forever.
### 1.1 Controller
## Questions?
Open an issue or ping me somewhere (if you can find me). But let's be real — nobody reads these anyway :D
The controller of the personal data described in this Policy is **the Maintainer**: poli0981 (SkullMute), an individual in Vietnam who runs the Project as a solo hobby. Contact: **privacy@poli0981.dev** (see section 12).
Built with boredom and zero spying. ??
### 1.2 Definitions
- **"The Website"**: https://freeitchgames.win, including its pages and endpoints (such as `/data`, `/img`, `/suggest`, `/admin` and `/api/…`). The old address https://poli0981.github.io/free-games-itchio-list/ only redirects to it.
- **"The Apps"**: the desktop apps (Windows, macOS, Linux) and the Android APK, built from the same code as the Website and distributed on GitHub Releases. They are read-only viewers of the Catalog.
- **"The Catalog"**: the list of games and their data: `data_game/`, `scripts/deleted_games.json`, and the files derived from them and served under https://freeitchgames.win/data.
- **"The Repository"**: https://github.com/poli0981/free-games-itchio-list, including the data pipeline that runs in its GitHub Actions.
- **"The Project"**: the Website, the Apps, the Catalog and the Repository together.
- **"The Maintainer"**: poli0981 (SkullMute), as described in section 1.1.
- **"Personal data"**: any information about an identified or identifiable person.
- **"You"**: anyone who uses the Project, including game creators whose games are listed in the Catalog.
### 1.3 What this Policy does not cover
This Policy does not cover services that handle data on their own account: itch.io (every game link and every download goes there), GitHub for your GitHub account and your activity on github.com, Cloudflare's use of data for its own purposes as described in its privacy policy, or the games themselves. Their own policies apply (links in section 4).
## 2. What is processed and why
### 2.1 Visiting the Website
- **Request data.** The Website is hosted on Cloudflare. When your browser loads a page, a file or an image, Cloudflare processes standard request data: your IP address, user agent (browser and device type), the requested URL, the referrer and the time. This is needed to deliver the site, to protect it (TLS, firewall, bot and denial-of-service protection) and to limit abuse.
- **Verification check.** Before the Website's pages and cover images load, your browser passes a Cloudflare Turnstile check, which processes signals about your device and browser to tell people from bots; it usually completes without any action from you. To check the result, the Website sends the Turnstile token and your IP address to Cloudflare's verification service, then sets the `__Host-fig_gate` cookie (section 3.2) so that the check is not repeated for 48 hours. Search-engine and link-preview bots that Cloudflare has verified skip the check. The catalog data under `/data` stays available without it.
- **Aggregate statistics.** The Website uses Cloudflare Web Analytics, which loads a small script from Cloudflare and counts visits in aggregate, without cookies and, according to Cloudflare, without fingerprinting. The Maintainer sees only totals (such as page views), not individual visitors. The Project runs no other analytics.
- **Server logs.** Requests handled by the Website's server code (Cloudflare Workers) are recorded by Cloudflare Workers Logs on a 10% sample and kept for about 7 days, to find bugs and investigate abuse.
- **Network error reports.** Cloudflare may add Network Error Logging (NEL) headers, which ask your browser to report connection errors to Cloudflare.
- **No IP addresses stored by the Project.** The Project's own code never writes your IP address to its database, its files or the Repository.
- **Cover images** are served by the Website itself (resized copies stored on Cloudflare R2), so your browser does not contact itch.io while you browse. itch.io only hears from you when you click a game link and go there; the Website then passes at most its own address (not the page you were on) as the referrer.
### 2.2 Using the Apps
- The Apps are read-only viewers with **no telemetry, no analytics and no accounts**.
- They download the Catalog data from https://freeitchgames.win/data (Cloudflare processes the request data as described in section 2.1; versions 4.0–4.1.1 still get the older JSON files, recognised by the `Origin` header their window sends) and load cover images **directly from itch.io's image server (img.itch.zone)**, so itch.io receives your IP address and user agent when covers load.
- Clicking a game opens its itch.io page in your browser.
- Updates are manual: the Apps do not check for updates on their own. When you download an installer or the APK from GitHub Releases, GitHub processes that request.
- The Apps keep the same local storage as the Website (section 3.1), on your device only. Uninstalling an App removes it.
### 2.3 Suggesting a game
When you use the Suggest page (https://freeitchgames.win/suggest):
- **What is stored**: the game URL, your optional note (up to 500 characters) and the time of submission, in the review queue (section 2.4). No name, email address or account is asked for or stored.
- **Anti-spam**: Cloudflare Turnstile processes signals about your device and browser to tell people from bots. To check the result, the Website sends the Turnstile token and your IP address to Cloudflare's verification service.
- **Rate limiting**: your IP address is used transiently to count requests. The Project does not store it.
- **Purpose**: to review your suggestion, by the Maintainer or by the automatic rules the Maintainer sets (section 2.4). If it is approved, the game URL becomes part of the public Catalog. Your note is never published and is **deleted automatically after 180 days**.
- **Please don't put personal data in the note**, yours or anyone else's. The form is for game links only.
### 2.4 The review queue and the admin area
- **How games arrive**: suggestions from the Suggest page; automatic discovery from itch.io's public RSS feeds; and new free games in public itch.io collections the Maintainer follows (the Website reads those public pages; nothing about you is involved).
- **The review queue** (Cloudflare D1) holds candidate game URLs with their source, the title, cover-image URL and genre hint taken from itch.io, automatic flags, notes, timestamps and the Maintainer's decision. Games enter the Catalog when the Maintainer approves them: one by one, or through automatic rules the Maintainer sets and can change at any time (items without a warning flag that nobody rejected within a waiting time; new free games in collections the Maintainer follows). Automatic approvals are recorded in the audit log like the Maintainer's own. Rejected URLs are kept indefinitely as a blocklist; only the URL is needed to avoid reviewing the same game again.
- **The admin area** (https://freeitchgames.win/admin) is for the Maintainer only. It is protected by Cloudflare Access (GitHub login or a one-time PIN sent by email), which sets a `CF_Authorization` session cookie in the Maintainer's browser. Admin actions, including changes to the automatic rules, are recorded in an audit log together with the Maintainer's email address. The audit log is never published.
### 2.5 Public game data in the Catalog
- The Catalog is built from public itch.io game pages: the game's name, developer and publisher names, description, genre, tags, platforms, ratings and similar metadata, and the cover image URL. The pipeline identifies itself as `FreeItchGamesBot/4.0 (+https://freeitchgames.win/about)` and paces its requests.
- A developer or publisher name, or the creator's itch.io address inside a game URL, can be a person's name or handle, so it can be personal data. It is used only to identify and credit the game and to help people discover it.
- This data is published on the Website, in the Repository and under https://freeitchgames.win/data. When a game is removed, its URL, name, reason and removal date are logged in [`scripts/deleted_games.json`](../scripts/deleted_games.json), which the Website shows on its Removed page (https://freeitchgames.win/removed).
- Creators can ask for a correction or a removal at any time (section 7).
### 2.6 Contacting the Maintainer
- Emails sent to the Project's addresses (section 12) are delivered to the Maintainer's mailbox, which is hosted by Google Workspace on the Maintainer's own domain, poli0981.dev. The Maintainer receives your email address, any name you use and your message, and uses them only to handle your request.
- Correspondence about removal and copyright requests is kept as long as needed to handle the request.
### 2.7 GitHub contributions
Issues, pull requests, discussions and comments are public on GitHub under your GitHub account, and GitHub's privacy statement applies to them. The Maintainer sees only what GitHub shows. The "Remove a game" issue form is public too, so use email for anything you don't want published.
### 2.8 What the Project does not do
- No accounts or sign-in for the public, no comments, no ads and no payments.
- No cookies set by the Project's own code on the public Website, except the verification cookie, which identifies no one (section 3.2).
- No selling or sharing of personal data, for advertising or any other purpose.
- No profiling and no automated decisions with legal or similarly significant effects on you.
- No telemetry in the Apps, and no analytics other than Cloudflare Web Analytics on the Website.
## 3. Browser storage and cookies
### 3.1 What the Website and the Apps store on your device
The Website and the Apps keep the following items on your device only. None of them is sent to the Project.
| Storage | Key | Contents | Kept until |
|---|---|---|---|
| `localStorage` | `webapp.prefs` | Interface preferences such as language, layout density and whether scrollbars are hidden, your 18+ (NSFW) content choice, and the version of the legal documents you accepted | You clear it |
| `localStorage` | `webapp.theme` | Theme: `light`, `dark` or `system` | You clear it |
| `localStorage` | `webapp.gate` | When your current verification pass (section 3.2) runs out, so an open tab can check again in time | Replaced by the next check; you can clear it |
| IndexedDB (via `idb-keyval`) | `webapp.query-cache` | A compressed copy of the public Catalog data (the game list, the removal log, the games-over-time series and the descriptions you opened or searched), for fast loading and limited offline use | At most 7 days, then refreshed or discarded |
| `sessionStorage` | `reloaded-after-deploy` | A timestamp, so the page reloads at most once after a site update | The tab is closed |
On first load, the Website and the Apps also delete the entries that the old v3 app left in browser storage (an encrypted GitHub access token and commit-signing key data). v4 does not use them.
These items are strictly necessary for features you use (keeping your settings, loading the site quickly, recovering after an update, not repeating the verification check), so they don't need consent under the EU ePrivacy rules or the UK PECR. You can delete them at any time with your browser's "Clear site data" option for `freeitchgames.win`, or inspect them in your browser's developer tools. In the Apps, uninstalling removes them; if a desktop uninstaller leaves the App's data folder (`com.poli0981.freegamesitchio`) behind, you can delete that folder yourself. On Android you can also clear the app's storage in the system settings.
### 3.2 Cookies
- The Project's own code sets **one cookie** on the public Website: `__Host-fig_gate`, after you pass the verification check (section 2.1). It holds only the time it was issued and a signature, identifies no one, lasts **48 hours**, and is sent only to freeitchgames.win (`HttpOnly`, `Secure`, `SameSite=Lax`). It is strictly necessary to keep automated traffic out, so it needs no consent under the EU ePrivacy rules or the UK PECR. If you block it, the check runs again on every visit.
- Cloudflare may set strictly necessary security cookies, such as `__cf_bm` or `cf_clearance`, when its bot or challenge protections run. They serve security only.
- The verification check and the Suggest page use Cloudflare Turnstile (sections 2.1 and 2.3); see Cloudflare's Turnstile privacy addendum (section 4).
- The admin area uses the Cloudflare Access session cookie `CF_Authorization`, which exists only in the Maintainer's browser.
## 4. Service providers and other parties
| Party | Role and what it does | Data involved | Privacy policy |
|---|---|---|---|
| **Cloudflare** | Processor for the Website: DNS, CDN, firewall and TLS; Workers (the site's server code) and static assets; R2 (resized cover images); D1 (the review queue); Images (resizing); Turnstile (the verification check and the Suggest page); Web Analytics; Workers Logs; Access (admin login only); Rate Limiting | Request data, Suggest submissions, the review queue | <https://www.cloudflare.com/privacypolicy/> · Turnstile: <https://www.cloudflare.com/turnstile-privacy-policy/> |
| **GitHub** | Hosts the code, the Catalog data, issues and discussions, the data pipeline (GitHub Actions) and the release downloads. Independent controller for your GitHub account and activity | Your public contributions; request data when you visit GitHub or download a release | <https://docs.github.com/en/site-policy/privacy-policies/github-privacy-statement> |
| **Google** | Processor for email: Google Workspace hosts the Maintainer's mailbox, which receives the Project's contact addresses (section 12) | Emails you send to those addresses (your address, name and message) | <https://policies.google.com/privacy> |
| **itch.io** | Independent platform, not affiliated with the Project. Source of the game data; every game link and download goes there; the Apps load covers from img.itch.zone | What your browser or the Apps send when you visit itch.io or load covers from it. The pipeline sends nothing about you | <https://itch.io/docs/legal/privacy-policy> |
| **Discord** | Receives automated build and release notifications from GitHub Actions | No visitor data | — |
Cloudflare and Google may process data anywhere on their global networks (see section 9). The Maintainer does not give personal data to anyone else, except where the law requires it.
## 5. How long data is kept
| Data | Kept for |
|---|---|
| Request data processed by Cloudflare for delivery and security | By Cloudflare under its privacy policy; the Project does not store it |
| Workers Logs (a 10% sample of requests handled by the Website's server code) | About 7 days |
| Web Analytics | Aggregate statistics only; the Maintainer cannot see individual visitors |
| IP address used for rate limiting and Turnstile | Used transiently; never stored by the Project |
| Suggest note | Deleted automatically after **180 days** |
| Suggested or discovered game URLs, with source and timestamps | In the review queue while needed to avoid reviewing the same game twice. Approved URLs become part of the public Catalog; rejected URLs are kept indefinitely as a blocklist |
| Admin audit log (with the Maintainer's email address) | Kept as the record of admin changes; never published |
| Catalog entries (including developer and publisher names) | While the game is listed. Removal records stay in the public removed-games list, and the Repository's Git history keeps past versions (see section 7.3) |
| Emails, including removal and copyright requests | As long as needed to handle the request |
| GitHub contributions | On GitHub, until you or GitHub remove them |
| Browser storage | See section 3.1 |
| `__Host-fig_gate` verification cookie | **48 hours** (section 3.2) |
| `CF_Authorization` cookie (Maintainer only) | For the duration of the Cloudflare Access session |
## 6. Legal bases
### 6.1 Vietnam
The Maintainer processes personal data in accordance with Vietnam's **Law on Personal Data Protection No. 91/2025/QH15** (passed on 26 June 2025, in force since 1 January 2026) and its implementing regulations. The Project processes as little personal data as it can, and only for the purposes in section 2.
Where that Law requires your consent, you give it by a clear action: by accepting this Policy at the legal gate on your first visit and, for what you type yourself, by submitting the Suggest form or sending an email. You can withdraw your consent at any time (section 7). Withdrawal does not affect processing carried out before it.
### 6.2 EU/EEA and UK
If you are in the EU/EEA or the UK, the GDPR or the UK GDPR applies to the processing of your personal data, on these legal bases:
| Processing | Legal basis |
|---|---|
| Delivering and securing the Website and the data the Apps download (request data, server logs, rate limiting, Turnstile, security cookies) | Legitimate interests (Art. 6(1)(f)): running a working, secure service and preventing abuse |
| Aggregate visit statistics | Legitimate interests: understanding how the site is used overall, without tracking individuals |
| Suggestions and the review queue | Legitimate interests: handling the suggestion you chose to send and curating the Catalog |
| Public game data about creators | Legitimate interests: helping people discover free games using information the creators published on itch.io. You can object at any time (section 7) |
| Emails and removal requests | Legitimate interests: answering you and handling your request |
| Browser storage (section 3.1) | Strictly necessary for features you use; no consent is needed under the ePrivacy rules or the PECR |
## 7. Your rights and how to use them
### 7.1 Your rights
Depending on the law that applies to you, including Law No. 91/2025/QH15 and, in the EU/EEA and the UK, the GDPR or the UK GDPR, you have the right to:
- be informed about how your personal data is processed (this Policy);
- access the personal data the Project holds about you;
- correct it if it is inaccurate;
- have it deleted;
- object to its processing, including processing based on legitimate interests;
- withdraw your consent where processing relies on it;
- complain to a supervisory authority: the competent personal data protection authority in Vietnam, or the data protection authority of your EU/EEA country or of the UK.
Under the GDPR and the UK GDPR, you can also ask for processing to be restricted, or for a copy of your data in a portable format, where those rights apply.
### 7.2 How to make a request
- Email **privacy@poli0981.dev**. Say what you want, and give enough detail to find the data: for example, the game URL you suggested and roughly when, or the email address you wrote from. The Maintainer may ask a follow-up question to confirm that the request is yours.
- The target is to answer within **30 days**; many requests are handled much sooner. Requests are free of charge.
- Game creators who want a game removed or its data corrected can also email **takedown@poli0981.dev** or open a ["Remove a game" issue](https://github.com/poli0981/free-games-itchio-list/issues/new?template=remove_game.yml) (public). The target for removals is within 7 days. The removal process is described in the [Terms of Use](ToS.md).
### 7.3 Limits worth knowing
- The Project stores no IP addresses and has no accounts, so it cannot link visits to the Website to you. Cloudflare's security and log data is kept only briefly (section 5).
- Browser storage is under your control: you can view and delete it yourself (section 3.1).
- The Git history of the public Repository keeps past versions of the Catalog. The Maintainer cannot rewrite public history, except where there is an exceptional legal necessity. Copies that others have already made (forks, downloaded data) are outside the Maintainer's control.
- Content on GitHub (issues, comments) is managed through GitHub; you can edit or delete your own comments there.
## 8. Children
- The Project is not directed at children under 16. The legal gate asks every visitor to confirm that they are at least 16.
- Adult (18+) content is hidden by default, cover images included. It appears only if a visitor opts in under Settings after confirming that they are 18 or older. That choice is stored only in their browser (`webapp.prefs`). The `nsfw` flag is a best-effort label (see the [Disclaimer](DISCLAIMER.md)).
- The Maintainer does not knowingly collect personal data from children under 16. If you believe a child has sent personal data (for example in a Suggest note or an email), a parent or guardian can write to **privacy@poli0981.dev** and it will be deleted.
## 9. International transfers
- The Maintainer is in Vietnam. Emails you send and the data in the review queue are handled by the Maintainer from Vietnam.
- Cloudflare processes data on its global network, Google stores the Maintainer's email in its data centres, and GitHub operates internationally, so your data may be processed outside your country, including in countries whose data protection laws differ from yours. These providers describe the safeguards they use for international transfers in their privacy policies and data processing terms (links in section 4).
## 10. Security
- The Website is served only over HTTPS.
- Automated traffic has to pass a Cloudflare Turnstile check before the Website's pages and cover images load (section 2.1).
- Data minimization: no accounts, no IP addresses stored by the Project's code, Suggest notes deleted after 180 days.
- The admin area is protected by Cloudflare Access, and the Website's server code verifies the Access token itself on every protected request.
- Secrets (such as the GitHub App's private key) are kept in Cloudflare's secret storage, never in the Repository. The admin area writes to the Repository as a GitHub App, with verified commits.
- A strict Content Security Policy limits scripts to the Website itself plus Cloudflare Web Analytics and Turnstile.
- GitHub Actions are pinned to exact commit SHAs with least-privilege permissions, and Dependabot keeps dependencies up to date.
- No system is perfectly secure. If you find a vulnerability, please report it privately as described in the [Security Policy](../SECURITY.md) or at **security@poli0981.dev**. If a personal data breach occurs, the Maintainer will notify the people affected and the authorities as the law requires.
## 11. Changes to this Policy
- The Maintainer may update this Policy. New versions are published in the Repository with the `Last updated` date at the top, and material changes are noted in [CHANGELOG.md](../CHANGELOG.md). Earlier versions remain in the Repository's history.
- When a change requires your acceptance again, the legal gate on the Website and in the Apps asks you to review and accept the updated documents before you continue.
## 12. Contact
All five addresses reach the Maintainer's own mailbox (Google Workspace, domain poli0981.dev).
- **privacy@poli0981.dev**: privacy questions and requests about your data (target answer: within 30 days).
- **takedown@poli0981.dev**: removing a game or correcting its data, including copyright claims.
- **security@poli0981.dev**: vulnerabilities (or GitHub's private vulnerability reporting; see the [Security Policy](../SECURITY.md)).
- **legal@poli0981.dev**: anything else legal.
- **contact@poli0981.dev**: general questions that fit none of the above.
For questions that aren't private, you can also open an issue in the Repository; issues are public. The Maintainer's other channels are listed at <https://poli0981.dev/links/>.
## 13. Final vibes
A list of free games shouldn't need your data, so the Project barely touches it: no accounts, no ads, no tracking cookies, nothing sold. What little exists is kept short and deleted when it's no longer needed. Browse freely.
+153
View File
@@ -0,0 +1,153 @@
# Third-party components
Last updated: 2026-10-03
Applies from: the release of version 4.0.0.
The website <https://freeitchgames.win>, its Worker, the desktop and Android apps and the data pipeline are
built on open-source software. This file lists the direct dependencies and the licenses they are published
under. Each component keeps its own license; the project's licenses ([`NOTICE.md`](../NOTICE.md)) do not
change them.
- Versions are the ranges declared in [`webapp/package.json`](../webapp/package.json),
[`webapp/src-tauri/Cargo.toml`](../webapp/src-tauri/Cargo.toml),
[`requirements.txt`](../requirements.txt) and [`requirements-dev.txt`](../requirements-dev.txt).
Exact versions, including dependencies of dependencies, are pinned in
[`webapp/package-lock.json`](../webapp/package-lock.json) (npm) and
[`webapp/src-tauri/Cargo.lock`](../webapp/src-tauri/Cargo.lock) (Rust); Python dependencies are
resolved at install time (`npm ls`, `cargo tree` and `pip list` show the full trees).
- The runtime libraries are also listed on the [About page](https://freeitchgames.win/about), which reads
the `THIRD_PARTY` array in [`webapp/src/lib/about.ts`](../webapp/src/lib/about.ts).
## 1. Website and apps (shipped in the browser bundle)
These libraries are bundled into the public website and the desktop / Android apps, which reuse the
website's code. The `/admin` app uses a subset of them (React, React Router, TanStack Query and some of the
shared UI components).
| Component | Version | Used for | License |
|---|---|---|---|
| [React](https://react.dev) (`react`, `react-dom`) | 19.3 | UI framework | MIT |
| [React Router](https://reactrouter.com) (`react-router`) | 8.4 | Routing | MIT |
| [Zustand](https://github.com/pmndrs/zustand) | 5.0 | Preference and theme stores | MIT |
| [TanStack Query](https://tanstack.com/query) (`@tanstack/react-query`, `react-query-persist-client`) | 5.103 | Data fetching and the local catalog cache | MIT |
| [idb-keyval](https://github.com/jakearchibald/idb-keyval) | 6.3 | IndexedDB storage for the compressed catalog cache | Apache-2.0 |
| [fflate](https://github.com/101arrowz/fflate) | 0.8 | Decompressing the catalog where the browser has no Compression Streams (older Safari / iOS) | MIT |
| [Recharts](https://recharts.org) | 3.10 | Charts | MIT |
| [Radix UI](https://www.radix-ui.com) primitives (`@radix-ui/react-checkbox`, `-dialog`, `-label`, `-popover`, `-separator`, `-slot`, `-switch`, `-tabs`) | 1.x / 2.x | Accessible UI building blocks | MIT |
| [shadcn/ui](https://ui.shadcn.com) | pattern | Component patterns copied into `webapp/src/components/ui/` | MIT |
| [lucide-react](https://lucide.dev) | 1.47 | Icons | ISC |
| [class-variance-authority](https://cva.style) | 0.7 | Component variants | Apache-2.0 |
| [clsx](https://github.com/lukeed/clsx) | 2.1 | Class-name helper | MIT |
| [tailwind-merge](https://github.com/dcastil/tailwind-merge) | 3.7 | Class-name merging | MIT |
| [Tailwind CSS](https://tailwindcss.com) (`tailwindcss`, `@tailwindcss/vite`) and [tw-animate-css](https://github.com/Wombosvideo/tw-animate-css) | 4.3 / 1.4 | Generate the site's CSS at build time | MIT |
| [Geist and Geist Mono](https://vercel.com/font) (`@fontsource-variable/geist`, `@fontsource-variable/geist-mono`) | 5.3 | The site's typefaces | OFL-1.1 (fonts), MIT (Fontsource packaging) |
| [`@tauri-apps/api`](https://github.com/tauri-apps/tauri/tree/dev/packages/api) | 2.11 | App-only bridge to the native shell | Apache-2.0 OR MIT |
| [`@tauri-apps/plugin-opener`](https://github.com/tauri-apps/plugins-workspace/tree/v2/plugins/opener) | 2.5 | App-only: opens itch.io links in the system browser | Apache-2.0 OR MIT |
`@tanstack/react-query-devtools` (MIT) is listed as a dependency but only renders in development builds.
The Geist fonts are bundled into the site and served from it (never from a font CDN), so pages make no
requests to third-party font services. The fonts are licensed under the SIL Open Font License 1.1.
## 2. Worker (server code on Cloudflare)
| Component | Version | Used for | License |
|---|---|---|---|
| [jose](https://github.com/panva/jose) | 6.2 | Verifying Cloudflare Access tokens and signing the GitHub App token | MIT |
The Worker runs on Cloudflare's Workers runtime and uses Cloudflare services (R2, D1, Images, Rate
Limiting, Access). Two scripts come from Cloudflare instead of the site's own bundle: the Web Analytics
beacon (`static.cloudflareinsights.com`) and, on the verification page and the Suggest page, the
Turnstile widget (`challenges.cloudflare.com`). These are Cloudflare services under Cloudflare's own terms, not open-source
components. Section 7 lists every service the project uses.
## 3. Desktop and Android apps (Rust crates)
| Crate | Version | Used for | License |
|---|---|---|---|
| [tauri](https://tauri.app), `tauri-build` | 2 | App shell and build helper | Apache-2.0 OR MIT |
| [tauri-plugin-opener](https://github.com/tauri-apps/plugins-workspace/tree/v2/plugins/opener) | 2 | Opening links in the system browser | Apache-2.0 OR MIT |
| [tauri-plugin-single-instance](https://github.com/tauri-apps/plugins-workspace/tree/v2/plugins/single-instance) | 2 | Desktop only: focuses the running window instead of starting a second copy | Apache-2.0 OR MIT |
| [serde](https://serde.rs), [serde_json](https://github.com/serde-rs/json) | 1 | Serialization | MIT OR Apache-2.0 |
The apps render with the system web view that the operating system provides: WebView2 on Windows,
WKWebView on macOS (Safari/WebKit 16.4 or later), WebKitGTK on Linux and Android System WebView on Android.
## 4. Data pipeline (Python 3.15)
| Package | Version | Used for | License |
|---|---|---|---|
| [requests](https://requests.readthedocs.io) | 2.34+ | HTTP requests to public itch.io pages | Apache-2.0 |
| [beautifulsoup4](https://www.crummy.com/software/BeautifulSoup/) | 4.15+ | Parsing itch.io pages | MIT |
| [urllib3](https://urllib3.readthedocs.io) | 2.8+ | Retry policy of the scraper's HTTP session | MIT |
These pull in `certifi` (MPL-2.0), `charset-normalizer` (MIT), `idna` (BSD-3-Clause) and `soupsieve`
(MIT).
## 5. Development and test tooling (never shipped)
These tools never end up in a build, but they keep the code honest.
### Dead-code detection
- **[knip](https://knip.dev)** (ISC) finds unused files, exports and dependencies in the webapp and the
Worker. Config: [`webapp/knip.json`](../webapp/knip.json). Run: `cd webapp && npm run knip`
- **[vulture](https://github.com/jendrikseipp/vulture)** (MIT) finds dead code (unused functions, classes,
attributes) in the Python pipeline. Config: `[tool.vulture]` in [`pyproject.toml`](../pyproject.toml).
Run: `vulture`
### Linting and types
- **[ruff](https://github.com/astral-sh/ruff)** (MIT): Python linter, formatter and import sorter; flags
unused imports and variables. Config: `[tool.ruff]` in [`pyproject.toml`](../pyproject.toml).
Run: `ruff check scripts tests webapp/scripts` and `ruff format`
- **[ESLint](https://eslint.org)** with `@eslint/js`, **[typescript-eslint](https://typescript-eslint.io)**,
`eslint-plugin-react-hooks`, `eslint-plugin-react-refresh` and `globals` (all MIT): webapp linting.
Config: [`webapp/eslint.config.js`](../webapp/eslint.config.js). Run: `cd webapp && npm run lint`
- **[TypeScript](https://www.typescriptlang.org)** 7.0 (Apache-2.0): `noUnusedLocals` and
`noUnusedParameters` reject unused code at build time. Run: `cd webapp && npx tsc -b`. The 6.0 API
(`@typescript/typescript6`, installed as `typescript`) stays for typescript-eslint, which needs it
### Build, test and deploy
| Tool | Used for | License |
|---|---|---|
| [Vite](https://vite.dev) 8 and `@vitejs/plugin-react` | Bundling the site, the admin app and the apps' front end | MIT |
| [Vitest](https://vitest.dev) 5 | Tests (`npm test`) | MIT |
| [Wrangler](https://developers.cloudflare.com/workers/wrangler/) 4 | Local Worker dev, D1 migrations, deploys | MIT OR Apache-2.0 |
| [`@tauri-apps/cli`](https://tauri.app) 2 | Building the desktop and Android apps | Apache-2.0 OR MIT |
| `@types/node`, `@types/react`, `@types/react-dom` | Type definitions | MIT |
| [pytest](https://pytest.org) | Python tests (network blocked) | MIT |
| [Pillow](https://python-pillow.github.io) | [`webapp/scripts/gen_assets.py`](../webapp/scripts/gen_assets.py), which generates the icons and the social preview image | MIT-CMU |
## 6. GitHub Actions
The workflows in [`.github/workflows/`](../.github/workflows/) use `actions/checkout`, `actions/setup-node`,
`actions/setup-python`, `actions/setup-java`, `actions/cache`, `actions/upload-artifact`,
`actions/download-artifact`, `android-actions/setup-android`, `dtolnay/rust-toolchain`,
`tauri-apps/tauri-action` and reusable workflows from [poli0981/.github](https://github.com/poli0981/.github).
Every external action is pinned to a commit SHA. The actions run on GitHub's runners and are not
distributed with the project; each one is under the license in its own repository.
## 7. Services (not software the project distributes)
| Service | What it does for the project |
|---|---|
| **Cloudflare** | DNS, CDN, WAF, TLS; Workers and static assets (the website); R2 (resized cover images); D1 (the review queue); Images (resizing); Turnstile (the verification page and the Suggest page); Web Analytics (cookieless, aggregate); Workers Logs; Access (admin login); Rate Limiting |
| **Google Workspace** | The Maintainer's mailbox on poli0981.dev, which receives the project's contact addresses |
| **GitHub** | Code, catalog data, issues and discussions, Actions (the pipeline), release downloads |
| **itch.io** | Where the games live; the pipeline and RSS discovery read public itch.io pages and feeds |
| **Discord** | Receives automated CI and release notifications only |
What each service receives is described in the [Privacy Policy](PrivacyPolicy.md).
## 8. Keeping this list current
- [`.github/dependabot.yml`](../.github/dependabot.yml) keeps npm, pip, GitHub Actions and Cargo
dependencies up to date.
- When you add an npm dependency, add it to the `THIRD_PARTY` array in
[`webapp/src/lib/about.ts`](../webapp/src/lib/about.ts) (so the About page lists it) **and** to this file.
The house rules are in [CONTRIBUTING.md](../CONTRIBUTING.md).
- Adding a new dev tool? Drop it here too, so the next person (or AI buddy) knows what is keeping an eye on
the code.
+164 -26
View File
@@ -1,40 +1,178 @@
# Terms of Use
# Terms of Use
Last updated: December 28, 2025
Last updated: 2026-10-16
Welcome to this random GitHub repo — a curated list of free games on itch.io, thrown together by an unemployed Vietnamese dev with too much free time and his AI buddy Grok. There's no real "service" here, just static files, some scripts, and a bunch of links. But hey, lawyers love terms, so here we are.
Applies from: 2026-10-13 on the Website, and from version 4.4.0 of the Apps.
## 1. Acceptance of Terms
By viewing, forking, starring, contributing to, or otherwise interacting with this repository (even just scrolling), you agree to these Terms of Use. If you don't agree, just close the tab and go touch grass. No hard feelings.
These Terms of Use ("Terms") govern your use of the website **https://freeitchgames.win**, the desktop and Android apps, and the public catalog data of `free-games-itchio-list`. They are written in plain language, but they are a real agreement. They replace the older Terms and also cover what the old web-app "EULA" used to say; the [EULA](EULA.md) now covers only the app installers and the Android APK.
## 2. No Warranties or Guarantees
This repo is provided **"AS IS"** with zero promises. The games linked are from itch.io — I don't host, develop, or support them. Quality, safety, fun factor, viruses, NSFW surprises? All on you. Good luck out there.
> **TL;DR**: Browse, share, fork the code (MIT) and reuse the data with credit (CC BY 4.0). Don't bulk-scrape the site (the data is in the GitHub repo), don't hotlink `/img`, don't spam the Suggest form, don't poke at `/admin`, and don't pretend to be itch.io or the Maintainer. Game creators can get a game removed or corrected. Adult content stays hidden unless you opt in.
See the [DISCLAIMER](docs/DISCLAIMER.md) for more details (because nobody reads both anyway).
## 1. Definitions
## 3. Your Responsibilities
- **Be cool**: Don't use this repo for anything illegal, harmful, or super annoying.
- **Downloads**: You click links at your own risk. Scan stuff yourself.
- **Contributions**: If you add games via PR (thanks in advance!), make sure they're actually free on itch.io, no malware, and respect copyrights. I can reject or remove anything for any reason (or no reason — it's my boredom project).
- **"The Website"**: https://freeitchgames.win, including its pages and endpoints (such as `/data`, `/img`, `/suggest` and `/api/…`). The old address https://poli0981.github.io/free-games-itchio-list/ only redirects to it.
- **"The Apps"**: the desktop apps (Windows, macOS, Linux) and the Android APK built from the same code and distributed on GitHub Releases. They are read-only viewers of the Catalog.
- **"The Catalog"**: the list of games and their data: `data_game/`, `scripts/deleted_games.json`, and the files derived from them and served under https://freeitchgames.win/data.
- **"The Repository"**: https://github.com/poli0981/free-games-itchio-list, including its code, data, documentation, issues and discussions.
- **"The Project"**: the Website, the Apps, the Catalog and the Repository together.
- **"Games"**: the games on itch.io that the Catalog lists and links to.
- **"The Maintainer"**: poli0981 (SkullMute), an individual in Vietnam who runs the Project as a hobby.
- **"You"**: any person, or any automated agent, that uses the Project.
## 4. Prohibited Activities
No spamming issues/PRs, no adding sketchy/malicious links, no harassment, no trying to dox anyone (especially me, the introvert dev). Basically, don't be a jerk.
## 2. Acceptance and age
## 5. Intellectual Property
The repo structure, scripts, and my mediocre writing are under MIT License (see [LICENSE](LICENSE)). The games themselves belong to their respective developers — go bug them if needed.
- By using the Website or the Apps, you agree to these Terms and to the policies they refer to: the [Privacy Policy](PrivacyPolicy.md), the [Disclaimer](DISCLAIMER.md) and, for the Apps, the [EULA](EULA.md).
- On your first visit, the Website and the Apps show a legal gate that lists these documents. You accept them by ticking the box and choosing "Accept & continue". If you decline, the Website and the Apps stay locked; in that case, please don't use them.
- You must be **at least 16 years old** to use the Website or the Apps; the legal gate asks you to confirm this. Adult content requires you to be **18 or older** (see section 8).
- When you contribute through GitHub (issues, pull requests, comments, discussions), these Terms apply to your contribution alongside GitHub's own terms and the [Code of Conduct](../CODE_OF_CONDUCT.md).
## 6. Termination
I can delete, modify, or nuke anything in this repo at any time. No notice required. It's GitHub — fork it if you're worried.
## 3. What the Project is (and is not)
## 7. Changes to Terms
I'll probably never update this, but if I do (because Grok suggests it), the new date up top will be your notice. Continued use means you agree.
- A curated, automatically updated catalog of free games on itch.io. Most of each game's data is copied from its public itch.io page and re-checked on a schedule; only three fields (`safe_virus`, `notes`, `nsfw`) are written by the Maintainer.
- The Website is **read-only for everyone**: there are no accounts, no sign-in, no comments, no ads and no payments. The admin area is for the Maintainer only.
- The Project does **not** host, sell or distribute any game. Every game link goes to itch.io, where downloading and playing are governed by itch.io's terms and each creator's own terms.
- The Project is provided free of charge, as a hobby. There is no service-level agreement.
## 8. Governing Law
These terms are governed by the laws of... my apartment in Vietnam. Disputes? Settle it over a game on easy mode (I only play easy).
## 4. What you may do
## Final Vibes
This is just a hobby list. Have fun, stay safe, and remember: life's too short for bad free games.
- Browse the Website and the Apps, and follow links to itch.io.
- Share links to the Website and to game pages.
- Download and reuse the Catalog data under **CC BY 4.0**, with credit (see section 11). Get it from the Repository (`data_game/` and `scripts/deleted_games.json`, also as raw files), and please cache it instead of downloading it again on every request. The files under https://freeitchgames.win/data are the Website's and the Apps' own compact format, not a public interface; the readable JSON there is served only to older versions of the Apps.
- Use, fork, modify and redistribute the code under the **MIT License**.
- Suggest a free itch.io game on the Suggest page (see section 5).
- Report bugs, give feedback and open pull requests through the Repository's templates.
- Ask for a game to be removed or its data corrected (see section 7).
Built with boredom, zero budget, and Grok's patience. 🚀
## 5. Suggestions and contributions
Questions? Open an issue. But let's be real — nobody reads this either :D
- **Suggest page** (https://freeitchgames.win/suggest): you can submit an itch.io game link and an optional note of up to 500 characters. The page uses Cloudflare Turnstile against spam and is rate limited.
- The note is seen only by the Maintainer and is deleted after 180 days. **Do not put personal data in it.** See the [Privacy Policy](PrivacyPolicy.md).
- Every suggestion goes into a **review queue**. The Maintainer approves or rejects it there, one by one or through automatic rules the Maintainer sets: a suggestion that raises no warning flag and that nobody rejected within the waiting time the Maintainer chose (currently about a day) may be approved automatically. The Maintainer has no obligation to accept a suggestion or to reply. Approved links are then scraped by the pipeline, and games that turn out to be paid are dropped.
- Only genuinely **free-to-play** games on itch.io qualify. Demos of paid games, "name your own price" titles with a minimum above zero, and time-limited free promotions do not.
- By submitting anything to the Project (a suggestion, an issue, a pull request or a comment), you confirm that:
- it is your own work, or you have the right to share it;
- it contains no malware, phishing, scams, doxxing, copyright infringement or illegal content, and does not link to any;
- you are not using it to send someone else's personal data.
- **Inbound = outbound**: contributions to the code are licensed under the MIT License, and contributions to the data and documentation under CC BY 4.0, the same licenses the Project uses.
- Issues, pull requests and comments are public on GitHub under your account.
## 6. What you may not do
You agree **not** to:
1. **Bulk-scrape** the Website or its API, including the files under `/data`. Get the data from the Repository instead; it is cheaper for everyone.
2. **Abuse the image proxy** (`/img`): it exists only to show cover images on the Website. Don't hotlink `/img` URLs from other sites or apps, and don't use it to fetch images in bulk.
3. **Access restricted areas without authorization**: `/admin` and the admin API (`/api/admin/…`) are for the Maintainer only. Good-faith security research is welcome under the rules of the [Security Policy](../SECURITY.md).
4. **Spam the Suggest form**, or circumvent the Website's verification check, Turnstile or the rate limits (for example with scripts, shared verification cookies or rotating IP addresses).
5. **Submit links to malware**, scams, phishing, or illegal content, anywhere in the Project.
6. **Misrepresent affiliation**: don't claim to be the Maintainer or the Project, don't present a fork or copy as the official Project, don't claim that the Project is run or endorsed by itch.io, and don't use the names "poli0981" or "SkullMute" to endorse your own work without prior written permission.
7. **Disrupt the Project**: don't attempt to overload, break or impair the Website (for example by denial-of-service), and don't use the Project to put unreasonable load on itch.io. If you run the pipeline code yourself, you are responsible for complying with itch.io's terms and for keeping its request pacing.
8. **Make false removal or copyright claims**, or claim to be a game's creator or rights holder when you are not.
9. **Harass, threaten, dox or impersonate** anyone through any channel related to the Project (issues, pull requests, discussions, Discord, social media).
10. Use the Project for any purpose that is unlawful where you are or in Vietnam.
## 7. Content removal and copyright
Anyone can ask for a game to be removed from the Catalog or for its data to be corrected. Game creators and rights holders are especially welcome to do so.
**How to ask**
- Email **takedown@poli0981.dev**, or
- open a ["Remove a game" issue](https://github.com/poli0981/free-games-itchio-list/issues/new?template=remove_game.yml) in the Repository (it includes a copyright-claim section). GitHub issues are public, so use email for anything you don't want published.
**Include**
- the game's itch.io URL (or its page on the Website);
- who you are: the creator, the rights holder, or someone authorized to act for them;
- the reason (for example: a copyright claim, you don't want the game listed, the data is wrong, or the game is no longer free). For a copyright claim, say which material (for example the description or the cover image) the claim is about.
**What happens**
- The Maintainer removes the record from the Catalog and logs the removal, with a reason, in the public list of removed games (https://freeitchgames.win/removed).
- The resized copies of the cover image stored on Cloudflare R2 are deleted, and cached copies expire from Cloudflare's cache.
- The Git history of the public Repository keeps past versions of the data. The Maintainer cannot rewrite public history, except where there is an exceptional legal necessity. Copies that others have already made (forks, downloaded data) are outside the Maintainer's control.
- Target: within **7 days**; urgent legal requests are handled sooner. If a request is unclear, the Maintainer may ask follow-up questions.
## 8. Adult (NSFW) content
- Games flagged `nsfw: Yes` are **hidden by default**, cover images included.
- You can opt in to 18+ content in Settings (https://freeitchgames.win/settings) after confirming that you are **18 or older**. By opting in, you also confirm that viewing such content is lawful where you are. The choice is stored only in your browser (`webapp.prefs`), and you can switch it off at any time.
- The `nsfw` flag is a best-effort label and may be wrong. Check the itch.io page yourself before downloading if this matters to you.
## 9. Games, safety and third-party services
- The Games belong to their creators and are provided by them through itch.io. The Project has no control over them.
- The Project does **not** scan downloads. The `safe_virus` field is a manual note, not a guarantee. Treat every download as untrusted until you have checked it yourself. See the [Disclaimer](DISCLAIMER.md).
- The Project relies on third-party services such as itch.io, GitHub and Cloudflare, which have their own terms and policies. The [Privacy Policy](PrivacyPolicy.md) explains what each of them processes.
## 10. No affiliation with itch.io
The Project is **not affiliated with, endorsed by, or sponsored by itch.io** or Leaf Corcoran / itch corp. "itch.io", game names, logos and other trademarks belong to their respective owners and are used only to identify the games and the platform. See [NOTICE.md](../NOTICE.md).
## 11. Intellectual property and licenses
- **Code** (everything in the Repository not listed below, such as `scripts/`, `webapp/`, `bash/`, workflows and tests): **MIT License**, Copyright (c) 2025-2026 poli0981 (SkullMute). See [`LICENSE`](../LICENSE).
- **Catalog data** (`data_game/`, `scripts/deleted_games.json`, and the derived files under https://freeitchgames.win/data): **CC BY 4.0** for the Maintainer's contribution, namely the selection and arrangement of the collection, the three Maintainer-written fields (`safe_virus`, `notes`, `nsfw`), the removal records, and the structure and derived statistics. See [`data_game/LICENSE.md`](../data_game/LICENSE.md) and the full legal code in [`LICENSES/CC-BY-4.0.txt`](../LICENSES/CC-BY-4.0.txt).
- Suggested attribution: `Free itch.io games catalog by poli0981 (SkullMute) — https://freeitchgames.win — CC BY 4.0`
- **Not licensed by the Project** (owned by others): game descriptions and any other text written by game creators; cover images, thumbnails and other media; game names, logos and trademarks; and itch.io's trademarks. To reuse these, you need the owner's permission or a legal exception that applies to you. Facts such as URLs, prices and ratings are not protected by copyright anyway.
- The cover images shown on the Website are resized copies served for display only; they remain the property of their creators.
- **Documentation** (the `*.md` files in the repository root and in `docs/`, including the README and these policies): **CC BY 4.0**.
- **Third-party components** keep their own licenses. See the About page (https://freeitchgames.win/about) and [`docs/THIRD_PARTY.md`](THIRD_PARTY.md).
## 12. No warranty and limitation of liability
- The Project is provided **"as is" and "as available"**, without warranties of any kind, including accuracy, completeness, availability, a game's free status, or safety. Details are in the [Disclaimer](DISCLAIMER.md).
- To the extent permitted by law, the Maintainer and contributors are not liable for any damage arising from the use of the Project, from any Game or third-party site reached through it, from downtime, or from errors in the data.
- Nothing in these Terms excludes or limits liability that cannot be excluded or limited under applicable law.
## 13. Changes to the service, moderation and termination
The Maintainer may, at any time and without notice:
- change, suspend or discontinue the Website, the Apps or the published data;
- remove or change any content (game entries, documentation, code);
- reject suggestions, and close, lock or hide issues, pull requests or comments that break these Terms;
- block people who repeatedly break these Terms, and limit or block traffic that abuses the Website.
If you break these Terms, your permission to use the Website and the Apps ends. Any rights you have received under the MIT License or CC BY 4.0 are governed by those licenses. Tagged releases (`vX.Y.Z`) are intended to remain available on GitHub Releases, but this is not guaranteed.
## 14. Changes to these Terms
- The Maintainer may update these Terms. New versions are published in the Repository, with the `Last updated` date at the top, and material changes are noted in [CHANGELOG.md](../CHANGELOG.md).
- When a change requires your acceptance again, the `LEGAL_VERSION` value in the Website and the Apps changes, and the legal gate asks you to accept the updated documents before you continue. If you don't accept them, please stop using the Website and the Apps.
## 15. Governing law and disputes
- These Terms are governed by the laws of the **Socialist Republic of Vietnam**, without regard to conflict-of-law principles.
- Disputes are handled in this order:
1. **Informally first**: email **legal@poli0981.dev**, open an issue, or use a contact channel listed on the About page (https://freeitchgames.win/about) or at https://poli0981.dev/links/. Most disagreements end here.
2. **Mediation**: if informal contact fails, the parties may try mediation by mutual agreement.
3. **Courts**: otherwise, the competent courts of Vietnam have jurisdiction.
- **Consumer rights**: nothing in these Terms limits the mandatory consumer-protection rights you have under the law of your country of residence, including any right that law gives you to bring a claim in your local courts.
## 16. Severability and translations
- If any provision of these Terms is held invalid or unenforceable, the remaining provisions remain in full force.
- Translations (such as the Vietnamese version in [`docs/i18n/vi/`](i18n/vi/ToS.md)) are provided for convenience. If a translation differs from this English version, the English version prevails.
## 17. Contact
These addresses reach the Maintainer's own mailbox (Google Workspace, domain poli0981.dev).
- **legal@poli0981.dev**: these Terms and anything else legal.
- **takedown@poli0981.dev**: content removal and copyright.
- **privacy@poli0981.dev**: privacy questions and requests.
- **security@poli0981.dev**: vulnerabilities (or GitHub's private vulnerability reporting; see the [Security Policy](../SECURITY.md)).
- **contact@poli0981.dev**: general questions that fit none of the above.
The Maintainer's other channels are listed at <https://poli0981.dev/links/>.
## 18. Final vibes
This is still a list of free games plus a website and a few apps, built by a tired dev with zero budget and two AI buddies. Be cool, don't break things, credit the data, and have fun hunting free games.
Questions? Email legal@poli0981.dev, open an issue, or use any channel on the About page. The Maintainer will try not to ghost.
## 19. Not legal advice
These Terms are a hobby-project document drafted by a non-lawyer with AI assistance. They are not a substitute for professional legal advice.
+222
View File
@@ -0,0 +1,222 @@
# Development environment
Tooling the Maintainer uses to write and test code in this repo, and how to run each part locally.
You don't need exactly the same setup to contribute — anything compatible with the required
toolchains works. This is for reproducibility.
## IDEs
JetBrains 2026.x (paid lineup):
- **PyCharm** — Python pipeline (`scripts/`, `bash/` wrappers).
- **WebStorm** — `webapp/` (React + TypeScript + Vite, the Cloudflare Worker).
- **RustRover** — `webapp/src-tauri/` (Tauri 2 native shell).
VS Code, Sublime, vim, etc. all work fine; nothing JetBrains-specific is
checked into the repo.
TypeScript 7 (the `tsc` that `npm run build` runs) is a native binary without `tsserver`. In VS Code,
install the TypeScript Native Preview extension (`TypeScriptTeam.native-preview`) for the TS 7
language server. In WebStorm, use its TypeScript 7 support or point *Languages & Frameworks →
TypeScript* at `webapp/node_modules/@typescript/old` (TypeScript 6.0, which reports the same errors).
## Language toolchains
| Stack | Required | Used for |
|-------|----------|----------|
| Python | 3.15 (`.github/python-version`) | Data pipeline (`scripts/`) and its tests |
| Node.js | 26+ (CI uses `webapp/.node-version`) | Web app, admin app, Worker, Tauri front end |
| npm | ships with Node.js | Dependencies (`npm ci` from `package-lock.json`) |
| Wrangler | project dependency (`npx wrangler`) | Local Worker, local D1, deploys |
| Rust | stable (via `rustup`) | Tauri desktop / Android builds only |
| Git | recent | Repo history, signed commits and tags |
Android builds also need Android Studio, the SDK / NDK and JDK 17 or 21 — see
[`webapp/TAURI.md`](../webapp/TAURI.md#android-apk).
## Python pipeline
### Setup
```sh
python -m venv .venv
# activate it: .venv\Scripts\activate (Windows) · source .venv/bin/activate (macOS / Linux)
pip install -r requirements-dev.txt
```
Python 3.15 reads and writes files as UTF-8 by default (UTF-8 mode, PEP 686), so Windows no longer
needs `PYTHONUTF8=1`.
### Checks (same as `python-ci.yml`)
```sh
pytest # tests/ — network access is blocked (tests/conftest.py)
ruff check scripts tests webapp/scripts # lint (config in the root pyproject.toml)
ruff format --check scripts tests # formatting (drop --check to apply it)
vulture # dead code
python scripts/validate.py # checks every catalog data file
```
### Try a real scrape
These make real requests to itch.io:
```sh
# add a game URL to scripts/temp_link.json, then:
python scripts/update_info.py --out patch.json
python scripts/apply_patch.py patch.json
# or re-check a few games already in the catalog:
python scripts/refresh.py --out patch.json --budget 5
python scripts/apply_patch.py patch.json
```
Scanners never write the catalog: they emit a URL-keyed patch, and `apply_patch.py` applies it and
runs `validate.py`. A local run changes `data_game/`, `scripts/*.json` and `scripts/state/` in your
working tree — leave those changes out of code PRs; on `main` the pipeline workflows update the
catalog. See [`CLAUDE.md`](../CLAUDE.md) for the data-layer overview.
## Web app
```sh
cd webapp
npm ci
npm run dev # public app on http://localhost:5173 with HMR; /data (packs + JSON) is built from ../data_game
npm run build # tsc -b + vite build → webapp/dist/ (app, /admin/, /data/pack + legacy JSON, sitemap.xml)
npm run preview # serve the production build (without the Worker)
```
Covers (`/img`), the Suggest form (`/api/suggest`) and the admin API are Worker routes. Vite
proxies `/api` and `/img` to the Worker on port 8787, so start it too (next section); without it
the rest of the app works but covers don't load.
## Worker (local)
In a second terminal:
```sh
cd webapp
npm run build # the Worker serves dist/ as its static assets
npx wrangler d1 migrations apply freeitchgames --local # creates the local review-queue database
npx wrangler dev # http://localhost:8787 (same as npm run cf:dev)
```
Keep using http://localhost:5173 for the app; http://localhost:8787 serves the last build, so
rebuild when you want it to show your changes. Everything runs locally (workerd); local D1, R2 and
cache data live in `webapp/.wrangler/` (gitignored — delete it to start over). Run the migrations
command again after adding a file to `worker/migrations/` (never edit a migration that has been
applied).
### `.dev.vars`
Local settings go in `webapp/.dev.vars` (dotenv format, gitignored). Values there also override the
`vars` in `wrangler.jsonc` for local runs. A typical file:
```ini
DEV_ADMIN_EMAIL=you@example.com
SITE_ORIGIN=http://localhost:5173
TURNSTILE_SITEKEY=1x00000000000000000000AA
TURNSTILE_SECRET=1x0000000000000000000000000000000AA
# Only to try the verification gate under `npx wrangler dev` (http://localhost:8787):
# GATE_SECRET=<32+ random characters, e.g. `openssl rand -hex 32`>
```
| Key | Kind | What it does |
|---|---|---|
| `DEV_ADMIN_EMAIL` | local only, optional | Lets you into the admin without Cloudflare Access. Honoured only when the host is `localhost`, `127.0.0.1` or `[::1]`; ignored everywhere else |
| `ADMIN_EMAILS` | secret | Comma-separated admin allow-list, checked behind Access. Not needed locally with `DEV_ADMIN_EMAIL` |
| `TURNSTILE_SECRET` | secret | Suggest form and verification gate, together with the `TURNSTILE_SITEKEY` var |
| `GATE_SECRET` | secret | Signs the verification-gate cookie (32+ characters). Without it the gate stays off. Locally, set `SITE_ORIGIN=http://localhost:8787` and open the site through `wrangler dev`; the cookie is `fig_gate` there (no `Secure`) |
| `GATE_BOT_TOKEN` | secret | The value the zone's Transform Rule sends for verified bots (32+ characters). Required in production, not on localhost |
| `GH_APP_PRIVATE_KEY` | secret | GitHub App private key for admin writes — the PEM as GitHub downloads it (PKCS#1) or PKCS#8, together with the `GH_APP_ID` and `GH_APP_INSTALLATION_ID` vars |
| `SITE_ORIGIN` | var override | The Suggest form and the verification gate only accept POSTs whose `Origin` equals it |
A feature whose settings are missing answers `503`; the public site needs none of them. The two
Turnstile values above are Cloudflare's always-pass test keys
([Turnstile testing](https://developers.cloudflare.com/turnstile/troubleshooting/testing/)); never use
them in production. `npm run cf:types` ignores `.dev.vars` (it reads the empty `types.env`), so local
secrets never reach the committed `worker-configuration.d.ts`.
### Suggest form
With the file above, the local D1 migrated and both servers running,
http://localhost:5173/suggest submits into the local review queue.
### Admin
With `DEV_ADMIN_EMAIL` set, open http://localhost:5173/admin/ (Vite, hot reload) or
http://localhost:8787/admin/ (the built copy, as in production). Without the GitHub App settings the
admin is read-only: actions that write to the repo answer `503`. With `GH_APP_ID`,
`GH_APP_INSTALLATION_ID` and `GH_APP_PRIVATE_KEY` set, approvals and edits become **real commits** to
the `GITHUB_REPO` repository (by default the public one) — point `GITHUB_REPO` at a fork where your
App is installed.
### Cron (RSS discovery)
```sh
npx wrangler dev --test-scheduled
# then open http://localhost:8787/__scheduled
```
This runs `scheduled()` once: it polls **one real itch.io RSS feed** into the local queue, then does
the queue bookkeeping. Use it sparingly.
## Web app checks (same as `webapp-ci.yml`)
```sh
cd webapp
npm run cf:types -- --check # worker-configuration.d.ts matches wrangler.jsonc
npm run lint # ESLint
npm run knip # unused files / exports / dependencies
npm test # Vitest: app + Worker; D1 tests start a local workerd
npx tsc -b # type-check only (npm run build runs it too)
npm run build
npx wrangler deploy --dry-run --env="" # validates the Worker config, deploys nothing
```
After editing `wrangler.jsonc`, run `npm run cf:types` and commit the regenerated
`worker-configuration.d.ts`.
## Desktop and Android apps (Tauri)
```sh
cd webapp
npm run tauri:dev # native window + HMR
npm run tauri:build # native installers
```
The apps read the live catalog packs from https://freeitchgames.win/data/pack and load covers from
`img.itch.zone`, so they need internet access but not the local Worker (and code that changes the pack
format only works in `tauri:dev` once the site with that format is deployed). Platform prerequisites
(WebView2 on Windows 10, Xcode CLT on macOS, `libwebkit2gtk-4.1-dev` on Debian/Ubuntu) and the
Android build are documented in [`webapp/TAURI.md`](../webapp/TAURI.md).
## Mobile testing
Web UI changes that touch responsive layout, navigation or the data table must be smoke-tested on a
real iOS device before tagging a release; the Android APK is signed off on the Android devices. See
[`pc_spec.md`](pc_spec.md) for the test devices.
## Deploying (Maintainer)
Cloudflare Workers Builds deploys every push to `main` (root directory `webapp`, build
`npm run build`, deploy `npx wrangler deploy`). D1 migrations are applied by hand
(`npx wrangler d1 migrations apply freeitchgames --remote`), secrets are set with
`npx wrangler secret put <NAME>`, and `npx wrangler deploy --env staging` deploys the staging Worker.
Details: [`webapp/README.md`](../webapp/README.md#deploy-web).
## Git hygiene
- Tag releases from `origin/main` only (see the
[release process](../CLAUDE.md#release--tag-process)).
- The Maintainer's commits and release tags are signed locally (`commit.gpgsign=true`, `git tag -s`).
- Never commit `webapp/dist/`, `webapp/.wrangler/`, `webapp/.dev.vars`, `webapp/src-tauri/target/`,
`webapp/src-tauri/gen/`, Android keystores, or any secret (GitHub App key, Turnstile secret,
Access tokens). `webapp/src-tauri/Cargo.lock` **is** committed.
## See also
- [`pc_spec.md`](pc_spec.md) — hardware and test devices.
- [`webapp/README.md`](../webapp/README.md) — web app, Worker and admin details.
- [`webapp/TAURI.md`](../webapp/TAURI.md) — Tauri desktop and Android builds.
- [`CONTRIBUTING.md`](../CONTRIBUTING.md) — contribution flows.
+88
View File
@@ -0,0 +1,88 @@
# Quy tắc ứng xử
Cập nhật lần cuối: 2026-09-29
Áp dụng từ: khi phát hành phiên bản 4.0.0.
> Bản dịch từ bản tiếng Anh cập nhật ngày 2026-09-18 (English source revision 2026-09-18). Nếu có khác biệt, bản tiếng Anh được ưu tiên. Bản gốc: [`CODE_OF_CONDUCT.md`](../../../CODE_OF_CONDUCT.md).
Đây là một repo sở thích nhỏ về game itch.io miễn phí, do một dev noob đang thất nghiệp vận hành: poli0981 (SkullMute), dưới đây gọi là "Người duy trì". Nói đơn giản: hãy cư xử đàng hoàng. Người duy trì là introvert max level với kỹ năng xã hội bằng không, nên mình cùng giữ mọi thứ tích cực nhé.
Các quy tắc dưới đây được phỏng theo [Contributor Covenant 2.1](https://www.contributor-covenant.org/version/2/1/code_of_conduct/) (xem [§7](#7-ghi-nguồn)).
## 1. Cam kết của chúng ta
Là thành viên, người đóng góp và Người duy trì, chúng ta cam kết biến việc tham gia cộng đồng này thành một trải nghiệm không bị quấy rối cho tất cả mọi người, bất kể tuổi tác, vóc dáng, khuyết tật hữu hình hay vô hình, dân tộc, đặc điểm giới tính sinh học, bản dạng và biểu hiện giới, mức độ kinh nghiệm, học vấn, hoàn cảnh kinh tế – xã hội, quốc tịch, ngoại hình, chủng tộc, đẳng cấp, màu da, tôn giáo, hay bản dạng và xu hướng tính dục — hoặc bạn đã sống sót qua bao nhiêu mùa Steam sale.
Chúng ta cam kết hành động và tương tác theo cách góp phần xây dựng một cộng đồng cởi mở, thân thiện, đa dạng, hòa nhập và lành mạnh.
## 2. Chuẩn mực của chúng ta
Ví dụ về hành vi góp phần tạo nên môi trường tích cực:
- Thể hiện sự đồng cảm và tử tế với người khác
- Tôn trọng những ý kiến, quan điểm và trải nghiệm khác biệt
- Góp ý mang tính xây dựng và đón nhận góp ý một cách hòa nhã
- Nhận trách nhiệm, xin lỗi những người bị ảnh hưởng bởi sai lầm của mình, và rút kinh nghiệm từ đó
- Tập trung vào điều tốt nhất không chỉ cho riêng mỗi người mà cho cả cộng đồng — và cho danh sách (thêm nhiều game miễn phí!)
Ví dụ về hành vi không thể chấp nhận:
- Ngôn ngữ hoặc hình ảnh mang tính tình dục, và mọi hình thức chú ý hay gạ gẫm tình dục. Bàn luận về việc một game có nên mang cờ `nsfw` hay không thì không sao; nội dung tình dục nhắm vào con người thì không được.
- Troll, bình luận xúc phạm hoặc miệt thị, và tấn công cá nhân hay chính trị
- Quấy rối công khai hoặc riêng tư
- Công bố thông tin riêng tư của người khác, như địa chỉ nhà hoặc email, khi chưa có sự cho phép rõ ràng của họ (doxxing)
- Spam, hoặc đăng liên kết tới mã độc, phishing hay nội dung gây hại khác
- Các hành vi khác có thể bị xem là không phù hợp trong môi trường chuyên nghiệp — hoặc khiến một người hướng nội đóng tab ngay lập tức
## 3. Trách nhiệm thực thi
Người duy trì chịu trách nhiệm làm rõ và thực thi các chuẩn mực này, và sẽ có biện pháp khắc phục thích đáng, công bằng đối với bất kỳ hành vi nào bị xem là không phù hợp, đe dọa, xúc phạm hoặc gây hại.
Người duy trì có quyền và trách nhiệm gỡ, sửa hoặc từ chối các bình luận, commit, code, issue, pull request, discussion, đề xuất game và các đóng góp khác không phù hợp với Quy tắc ứng xử này, và sẽ giải thích các quyết định kiểm duyệt khi thích hợp.
## 4. Phạm vi
Quy tắc ứng xử này áp dụng ở mọi không gian của dự án: repository GitHub (issue, pull request, discussion, bình luận, commit message và code), mọi nội dung gửi tới dự án (ví dụ ghi chú gửi kèm form Suggest), và cộng đồng Discord được liên kết từ [trang About](https://freeitchgames.win/about). Quy tắc cũng áp dụng khi một người chính thức đại diện cho dự án ở không gian công cộng.
## 5. Báo cáo
Nếu bạn gặp phải hoặc chứng kiến hành vi lạm dụng, quấy rối hay các hành vi không thể chấp nhận khác, hãy báo cáo **riêng tư** cho Người duy trì:
- email tới **legal@poli0981.dev**, hoặc
- nhắn tin riêng cho Người duy trì qua một kênh liên hệ có trên [trang About](https://freeitchgames.win/about).
Vui lòng đừng báo cáo vấn đề ứng xử qua issue công khai. Mọi báo cáo sẽ được xem xét và xử lý kịp thời, công bằng, và Người duy trì sẽ tôn trọng quyền riêng tư và sự an toàn của người báo cáo.
Vì dự án chỉ có một người duy trì, nếu báo cáo của bạn liên quan tới chính Người duy trì, bạn cũng có thể dùng tính năng "Report abuse" của GitHub hoặc công cụ báo cáo của Discord.
## 6. Hướng dẫn thực thi
Người duy trì dựa theo các hướng dẫn về mức độ ảnh hưởng tới cộng đồng dưới đây khi quyết định cách xử lý một vi phạm Quy tắc ứng xử:
1. **Nhắc nhở**
- *Ảnh hưởng tới cộng đồng*: dùng ngôn từ không phù hợp hoặc hành vi thiếu chuyên nghiệp hay gây khó chịu.
- *Hệ quả*: một lời cảnh báo riêng bằng văn bản, giải thích vấn đề là gì và vì sao hành vi đó không phù hợp. Có thể yêu cầu xin lỗi công khai.
2. **Cảnh cáo**
- *Ảnh hưởng tới cộng đồng*: vi phạm qua một sự việc đơn lẻ hoặc một chuỗi hành động.
- *Hệ quả*: một lời cảnh cáo kèm hệ quả nếu tiếp tục vi phạm. Không được tương tác với những người liên quan, kể cả tương tác không được mời với Người duy trì, trong một khoảng thời gian nhất định — cả trong không gian của dự án lẫn các kênh bên ngoài như mạng xã hội. Vi phạm các điều kiện này có thể dẫn tới cấm tạm thời hoặc vĩnh viễn.
3. **Cấm tạm thời**
- *Ảnh hưởng tới cộng đồng*: vi phạm nghiêm trọng, bao gồm hành vi không phù hợp kéo dài.
- *Hệ quả*: cấm tạm thời mọi hình thức tương tác hoặc giao tiếp công khai với cộng đồng trong một khoảng thời gian nhất định. Trong thời gian này không được tương tác công khai hay riêng tư với những người liên quan, kể cả tương tác không được mời với Người duy trì. Vi phạm các điều kiện này có thể dẫn tới cấm vĩnh viễn.
4. **Cấm vĩnh viễn**
- *Ảnh hưởng tới cộng đồng*: lặp đi lặp lại việc vi phạm chuẩn mực cộng đồng, bao gồm hành vi không phù hợp kéo dài, quấy rối một cá nhân, hoặc gây hấn hay miệt thị các nhóm người.
- *Hệ quả*: cấm vĩnh viễn mọi hình thức tương tác công khai trong cộng đồng.
Các bậc trên chỉ là hướng dẫn, không phải cam kết sẽ đi lần lượt từng bậc: với spam, liên kết mã độc hoặc quấy rối nghiêm trọng, Người duy trì có thể cấm (block) ngay.
## 7. Ghi nguồn
Quy tắc ứng xử này được phỏng theo [Contributor Covenant](https://www.contributor-covenant.org), phiên bản 2.1, tại https://www.contributor-covenant.org/version/2/1/code_of_conduct/. Các hướng dẫn về mức độ ảnh hưởng tới cộng đồng được lấy cảm hứng từ [thang thực thi quy tắc ứng xử của Mozilla](https://github.com/mozilla/diversity).
Những thay đổi so với bản gốc: điều chỉnh cho một dự án chỉ có một người duy trì, bổ sung ví dụ riêng của dự án, và nêu rõ phạm vi cùng các kênh báo cáo riêng tư của dự án này. Contributor Covenant được cấp phép theo [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); bản phỏng theo này cũng được cung cấp theo CC BY 4.0, giống như phần tài liệu còn lại của dự án.
## 8. Lời cuối
Đây chỉ là một repo sở thích nhỏ về game itch.io miễn phí. Hãy giữ nó vui vẻ, thoải mái và không drama. Nếu bạn ở đây để thêm game hoặc sửa đống code còn non tay — bạn đã là huyền thoại rồi.
Cảm ơn vì đã đọc (hoặc giả vờ đọc). 🚀
+153
View File
@@ -0,0 +1,153 @@
# Hướng dẫn đóng góp
> Bản dịch từ bản tiếng Anh cập nhật ngày 2026-10-13 (English source revision 2026-10-13). Nếu có khác biệt, bản tiếng Anh được ưu tiên.
>
> Bản tiếng Anh tại [`CONTRIBUTING.md`](../../../CONTRIBUTING.md) là bản chính thức.
Cảm ơn bạn vì đã có suy nghĩ đóng góp cho cái repo random này! Tôi chỉ là một dev người Việt thất nghiệp, hướng nội, kỹ năng tầm tầm, có hai trợ lý AI không phán xét: **Grok (xAI)** cho brainstorming đêm khuya và **Claude Code (Anthropic)** cho phần việc code/docs nặng hơn. Danh sách này sống nhờ sự giúp đỡ của cộng đồng, vì tôi quá lười để tự đi săn/sửa hết một mình :D Bất kỳ đóng góp nào (kể cả chỉ một game) cũng khiến bạn thành huyền thoại.
## Cách đóng góp (Đi đúng cửa, tôi lười ;D)
Game thì gửi qua website; mọi thứ khác thì qua các template issue/PR trên GitHub. Chúng làm cuộc đời tôi dễ hơn và giảm các khoảnh khắc "wtf".
### 1. Đề xuất game mới (Hoan nghênh nhất!)
- Vào **<https://freeitchgames.win/suggest>** và dán link một game itch.io. Mỗi lần gửi một link.
- Tùy chọn: một ghi chú ngắn (vì sao game hay, cảnh báo nội dung…), tối đa 500 ký tự. Ghi chú bị xóa sau 180 ngày. Vui lòng đừng ghi dữ liệu cá nhân vào đó.
- Một bước kiểm tra Cloudflare Turnstile và giới hạn tần suất giúp chặn bot; nếu bị chặn, đợi một lúc rồi thử lại.
- Chỉ game itch.io **miễn phí**. Game trả phí sẽ tự động bị loại khi trang game được cào.
- Không có gì lên site ngay lập tức: mọi đề xuất đều vào **hàng chờ duyệt**, nơi Maintainer duyệt hoặc từ chối, bằng tay hoặc qua quy tắc tự động (một đề xuất không có cờ cảnh báo mà không ai từ chối trong khoảng một ngày có thể được duyệt tự động). Link được duyệt sau đó được pipeline dữ liệu cào và xuất hiện trên site sau lần deploy kế tiếp.
Có cả một danh sách? Issue template **[Add Games (bulk list)]** nhận tối đa 15 link một lần, và một PR thêm URL itch.io vào `scripts/temp_link.json` cũng được (dùng PR template [Add Games]). Cả hai đều đi qua cùng quy trình duyệt: Maintainer kiểm tra từng link trước khi đưa vào hàng chờ, và việc merge một PR như vậy chính là sự phê duyệt. Vui lòng đừng sửa tay `data_game/`: các file đó do pipeline quản lý (xem [mục 7](#7-gửi-thay-đổi-code-pr)).
#### 1b. Những cách khác để game được thêm vào
- Website đọc các RSS feed công khai của itch.io về game miễn phí mới và phổ biến mỗi 4 giờ (mỗi lượt một feed) và đưa những gì tìm được vào hàng chờ.
- Website cũng đọc các collection công khai trên itch.io mà Maintainer theo dõi và đưa thẳng game miễn phí mới của chúng vào hàng chờ ingest (game từng bị gỡ, hoặc có cờ cảnh báo, thì vào hàng chờ duyệt).
RSS feed vào cùng hàng chờ duyệt với trang Suggest. (Extension trình duyệt của Maintainer và Telegram bot cũ đã ngừng hoạt động; repo của chúng, [itch-f2p-extension](https://github.com/poli0981/itch-f2p-extension) và [telegram-scraper-bot](https://github.com/poli0981/telegram-scraper-bot), đã được lưu trữ (archive).)
### 2. Gỡ game hoặc sửa dữ liệu game
Đặc biệt với người làm game: nếu bạn muốn game của mình bị gỡ khỏi danh sách, hoặc muốn sửa dữ liệu của nó, lúc nào cũng được.
- Gửi email tới **takedown@poli0981.dev**, hoặc mở issue template **["Remove a game"](https://github.com/poli0981/free-games-itchio-list/issues/new?template=remove_game.yml)** (có cả mục dành cho khiếu nại bản quyền).
- Ghi rõ URL game, bạn là ai (người tạo / chủ sở hữu quyền, hoặc người được họ ủy quyền) và lý do.
- Maintainer sẽ gỡ bản ghi khỏi danh mục (ghi kèm lý do trên [trang game đã gỡ](https://freeitchgames.win/removed) công khai) và xóa các bản ảnh bìa thu nhỏ mà site lưu trữ; các bản trong cache sẽ tự hết hạn. Mục tiêu: trong vòng 7 ngày, yêu cầu pháp lý khẩn cấp thì sớm hơn.
- Lưu ý: đây là một repo git công khai, nên các phiên bản cũ vẫn còn trong lịch sử. Việc viết lại lịch sử công khai chỉ được làm trong trường hợp ngoại lệ vì bắt buộc về pháp lý.
- `safe_virus` / `nsfw` / ghi chú bị sai, hoặc lỗi dữ liệu khác không phải yêu cầu gỡ? Mở issue **[Bug Report]** cũng được.
Chi tiết có trong [Điều khoản sử dụng](ToS.md) và [Tuyên bố miễn trừ](DISCLAIMER.md).
### 3. Báo lỗi
- Mở issue → template **[Bug Report]**.
- Checkbox cho các lỗi thường gặp (link chết, cờ sai, trang hỏng, v.v.).
- Chi tiết + ảnh chụp màn hình + mức độ khẩn cấp.
- **Vấn đề bảo mật không phải lỗi để đăng lên tracker công khai.** Hãy báo cáo riêng tư: xem [SECURITY](SECURITY.md).
- Nếu phức tạp, xem mục "Muốn thảo luận thêm?" bên dưới.
### 4. Đề xuất tính năng / cải tiến
- Mở issue → template **[Feature Request / Improvement]**.
- Chọn loại (tính năng mới hoặc sửa code), tên, lý do, độ ưu tiên (từ "nice to have" tới "repo sắp chết").
- Tùy chọn: pseudo-code/snippet (đừng có malware nhé, tôi sẽ check bằng kỹ năng tầm thường của mình :D).
### 5. Gửi góp ý
- Dùng template **[Feedback]**.
- Checkbox (EULA/ToS quá khắt khe? Concept repo dở? Anti-AI? Xóa repo? Khác).
- Chê hay khen đều được, sự tự ti của tôi chịu được.
### 6. Mọi thứ khác (câu hỏi, meme, lạc đề)
- Dùng template **[General / Off-Topic]**.
- Có gì trong đầu cứ đăng.
### 7. Gửi thay đổi code (PR)
- Fork → tạo branch → code → mở PR vào `main` với PR template phù hợp ([Bug Fix], [New Feature], [Documentation]…).
- Mô tả rõ ràng giúp nhé. Tôi sẽ review chậm (lịch thất nghiệp + hai AI buddy).
**Quy tắc PR** (phần không thương lượng):
- **CI phải pass.** Python CI (ruff check + format, vulture, pytest, `validate.py`) và Webapp CI (kiểm tra type sinh ra, lint, knip, test, build, `wrangler deploy --dry-run`) đều chạy trên PR. CI đỏ = không merge.
- **PR được merge bằng squash** (một PR thành một commit trên `main`) **hoặc merge commit, không bao giờ fast-forward**, nên hãy đặt tiêu đề PR như một commit message tốt (repo dùng kiểu `type(scope): tóm tắt`, ví dụ `fix(web): …`).
- **Giấy phép theo nguyên tắc inbound = outbound.** Khi mở PR, bạn đồng ý rằng đóng góp của mình được cấp phép theo cùng giấy phép với phần mà nó thay đổi: **MIT** cho mã nguồn, **CC BY 4.0** cho dữ liệu danh mục và tài liệu (xem [README → Giấy phép](../../../README.vi.md#giấy-phép)). Chỉ gửi những gì bạn có quyền gửi.
- **Không bao giờ commit secret**: không token, API key, file `.dev.vars` / `.env`, private key (chẳng hạn khóa của GitHub App) hay keystore dùng để ký. Nếu lỡ push một cái, hãy báo riêng (security@poli0981.dev) và thay mới (rotate) nó; chỉ xóa commit là không đủ.
- **Không sửa tay `data_game/`.** Thay đổi dữ liệu phải đi qua pipeline (một patch + `apply_patch.py`, có chạy `validate.py`), để các tiến trình ghi đồng thời không đè lên nhau.
- Không commit output build hay file sinh ra: `webapp/dist/`, `webapp/.wrangler/`, `webapp/src-tauri/target/`, `webapp/src-tauri/gen/`. (`webapp/src-tauri/Cargo.lock` **có** được commit; hãy cập nhật nó khi bạn sửa `Cargo.toml`.)
- Thêm dependency npm? Thêm luôn vào danh sách `THIRD_PARTY` trong `webapp/src/lib/about.ts` để trang About ghi công.
- Link ngoài mới trong app? Dùng `<ExtLink href="…">` từ `webapp/src/components/ext-link.tsx`, đừng dùng `<a href="…" target="_blank">` thuần: anchor thuần chạy được trên web nhưng im lặng hỏng trong các app Tauri.
### 8. Thiết lập môi trường dev (tóm tắt)
Hướng dẫn đầy đủ (Worker, D1 cục bộ, secret, Tauri, Android) nằm trong **[`docs/dev_env.md`](../../dev_env.md)** ([VI](dev_env.md)); ghi chú build Tauri/Android nằm trong [`webapp/TAURI.md`](../../../webapp/TAURI.md). Bản ngắn gọn:
**Pipeline Python** (Python 3.15, xem `.github/python-version`):
```sh
python -m venv .venv
# kích hoạt venv, rồi:
pip install -r requirements-dev.txt
pytest # không cần mạng
ruff check scripts tests webapp/scripts
ruff format scripts tests
python scripts/validate.py # kiểm tra mọi file dữ liệu
```
Muốn thử cào thật trên máy: thêm một URL vào `scripts/temp_link.json`, rồi chạy
`python scripts/update_info.py --out patch.json` và `python scripts/apply_patch.py patch.json`
(đừng commit kết quả; xem quy tắc PR ở trên).
**Webapp + Worker** (Node.js 26+, CI dùng phiên bản trong `webapp/.node-version`):
```sh
cd webapp
npm ci
npm run dev # Vite tại http://localhost:5173
npm run build # ghi vào webapp/dist/ (Worker phục vụ thư mục này làm assets)
npx wrangler dev # terminal thứ hai: Worker ở cổng :8787; Vite chuyển tiếp /api và /img tới đó
npm test # vitest
npm run lint
npm run knip
```
**App Tauri** (cần thêm Rust qua <https://rustup.rs> và các gói phụ thuộc của nền tảng):
```sh
cd webapp
npm run tauri:dev # cửa sổ native trỏ tới Vite dev server
npm run tauri:build # trình cài đặt trong src-tauri/target/release/bundle/
```
## Mẹo để đóng góp suôn sẻ
- **Test cục bộ**: chạy các bước kiểm tra ở mục 8 trước khi push; CI chạy đúng những bước đó.
- **Giữ sạch**: chỉ game itch.io miễn phí, không trả phí/demo/malware/trùng lặp.
- **Kiên nhẫn**: tôi hướng nội + lười, trả lời có thể chậm.
- **Đồng ý**: mọi issue template đều có một checkbox bắt buộc. Lạc đề/spam/vi phạm chính sách sẽ bị bỏ qua/đóng không drama :D
- **Cư xử đẹp**: mọi thứ ở đây đều theo [Quy tắc ứng xử](CODE_OF_CONDUCT.md).
## Muốn thảo luận thêm? (Nếu template không đủ)
Issue/PR là tốt nhất để theo dõi, nhưng nếu bạn muốn mô tả bug/tính năng kỹ hơn, tán gẫu, hoặc kể chuyện noob, giờ đã có server thật (introvert god-mode bị xuyên thủng):
**Chat / cộng đồng**
- Discord: Repo discussion (#general): https://discord.gg/2aNR3aVt
- Discord: Game chat (#general): https://discord.gg/kDM9GMu5vm
**Mạng xã hội (DM mở, trả lời chậm)**
- X (Twitter): [@SkullMute0011](https://x.com/SkullMute0011)
- YouTube: [@SkullMute](https://youtube.com/@SkullMute)
- Bluesky: [@skullmute0011](https://bsky.app/profile/skullmute0011.bsky.social)
- Mastodon: [@skullmute1122](https://mastodon.social/@skullmute1122)
**Ủng hộ dự án buồn chán này (hoàn toàn tùy chọn, tài khoản ngân hàng $50 cảm ơn bạn)**
- [Patreon](https://patreon.com/skullmute) · [Ko-fi](https://ko-fi.com/skullmute) · [Steam profile](https://steamcommunity.com/profiles/76561199544666292/)
Grok và Claude Code không vào Discord được, nhưng cứ ping tôi qua kênh nào cũng được, tôi sẽ cố không ghost.
Lời cảm ơn lớn được ghi trong [ACKNOWLEDGEMENTS.md](../../ACKNOWLEDGEMENTS.md) cho bất kỳ sự giúp đỡ nào!
Mã nguồn theo MIT, dữ liệu và tài liệu theo CC BY 4.0: cứ thoải mái, nhưng chill thôi. Có câu hỏi? Cứ mở issue **[General]** :D 🚀
+116
View File
@@ -0,0 +1,116 @@
# Tuyên bố miễn trừ trách nhiệm (Disclaimer)
Cập nhật lần cuối: 2026-10-16
Áp dụng từ: khi phát hành phiên bản 4.0.0.
> Bản dịch từ bản tiếng Anh cập nhật ngày 2026-10-13 (English source revision 2026-10-13). Nếu có khác biệt, bản tiếng Anh được ưu tiên. Bản gốc: [`docs/DISCLAIMER.md`](../../DISCLAIMER.md).
Dự án này — repository `free-games-itchio-list` và website **[freeitchgames.win](https://freeitchgames.win)** — là một dự án sở thích: một danh mục được tuyển chọn và tự động cập nhật gồm các game miễn phí trên [itch.io](https://itch.io). Dự án do một dev người Việt đang thất nghiệp, poli0981 (SkullMute), vận hành — dưới đây gọi là "Người duy trì" — với các trợ lý AI gánh phần lớn việc nặng. Làm ra vì vibes, để khám phá game indie và giải khuây. Không hứa hẹn gì lớn lao — nhưng các điều khoản mang tính pháp lý dưới đây là thật.
> **Tóm tắt**: Website, các ứng dụng và dữ liệu được cung cấp theo nguyên trạng. Dự án chỉ liên kết tới game; Dự án không làm, không lưu trữ và không quét game, và không liên kết với itch.io. Game người lớn bị ẩn trừ khi bạn tự bật. Hãy quét mọi thứ bạn tải về. Nếu bạn là người làm game và muốn gỡ game của mình, hãy email **takedown@poli0981.dev**.
## 1. Phạm vi áp dụng
Tuyên bố này áp dụng cho (gọi chung là "Dự án"):
- website **https://freeitchgames.win**, bao gồm trang Suggest công khai — chỉ đọc với tất cả mọi người, không có tài khoản;
- các ứng dụng desktop (Windows, macOS, Linux) và file APK Android được phát hành trên GitHub Releases;
- dữ liệu catalog: `data_game/`, `scripts/deleted_games.json` và các file được phục vụ tại https://freeitchgames.win/data;
- mã nguồn, pipeline dữ liệu và tài liệu trong repository này.
Tuyên bố này đi kèm [Điều khoản sử dụng](ToS.md), [Chính sách quyền riêng tư](PrivacyPolicy.md) và, đối với ứng dụng desktop và Android, [EULA](EULA.md).
## 2. Cơ sở "AS IS" (nguyên trạng)
Dự án — bao gồm dữ liệu catalog, pipeline Python (`scripts/`) cùng các workflow GitHub Actions, website và mã phía server (`webapp/`), ứng dụng desktop và Android (`webapp/src-tauri/`), và tài liệu — được cung cấp theo nguyên trạng (**"AS IS"** / **"AS AVAILABLE"**), không kèm bất kỳ bảo đảm nào, dù minh thị hay ngầm định, bao gồm nhưng không giới hạn ở các bảo đảm về tính thương mại, sự phù hợp cho một mục đích cụ thể, độ chính xác, tính đầy đủ, không xâm phạm quyền, hoặc hoạt động không gián đoạn hay không có lỗi.
## 3. Không liên kết với itch.io
Dự án hoạt động độc lập. Dự án **không liên kết với, không được chứng thực hay tài trợ bởi** itch.io, itch corp hay Leaf Corcoran, cũng như bởi bất kỳ nhà phát triển hay nhà phát hành nào có game trong catalog. Tên "itch.io" cùng mọi tên game, logo và nhãn hiệu thuộc về chủ sở hữu tương ứng; chúng chỉ được dùng để nhận diện game và nơi game được lưu trữ. Việc một game có mặt trong danh sách không có nghĩa là người làm game ủng hộ, hay thậm chí biết đến, Dự án.
## 4. Danh mục liên kết, không phải nơi lưu trữ game
Dự án **không làm, không lưu trữ, không phân phối, không bán và không chứng thực** các game được liệt kê. Mỗi game liên kết tới trang riêng của nó trên itch.io, và mọi lượt tải về đều diễn ra tại đó, theo điều khoản của itch.io và điều khoản hoặc giấy phép riêng của người làm game.
Game được đưa vào catalog qua trang Suggest công khai, các RSS feed công khai của itch.io, hoặc các collection công khai trên itch.io mà Người duy trì theo dõi. Mỗi game đều được Người duy trì duyệt, từng game một hoặc qua các quy tắc tự động do Người duy trì đặt ra. Việc duyệt đó **không phải** là kiểm tra bảo mật, đánh giá chất lượng hay sự chứng thực.
## 5. Không bảo đảm về các game
Người duy trì không bảo đảm bất cứ điều gì về một game được liệt kê, bao gồm:
- **Chất lượng, độ vui hoặc khả năng chơi được** — có game là viên ngọc quý, có game thì "jank", đa số ở giữa. Tùy gu bạn.
- **Tính an toàn, toàn vẹn hoặc không có mã độc** — Dự án **không** quét các bản tải về. Trường `safe_virus` (`?`, `Yes`, `No`, `Caution`) là ghi chú thủ công của Người duy trì, không phải lời bảo đảm, và game mới luôn bắt đầu với `?`. Hãy coi mọi bản tải về là không đáng tin cho đến khi bạn tự kiểm tra bằng phần mềm chống mã độc uy tín.
- **Nội dung** — xem [§6](#6-nội-dung-người-lớn-nsfw) về nội dung người lớn.
- **Độ chính xác của metadata** — tên, nhà phát triển, mô tả, thể loại, tag, đánh giá, nền tảng và các trường khác được sao chép từ trang itch.io công khai và phản ánh trang đó tại lần kiểm tra gần nhất. Lượt refresh hằng ngày kiểm tra lại khoảng một phần bảy catalog mỗi ngày, tức mỗi game khoảng một lần mỗi tuần; các thay đổi trên itch.io (đổi tên, gỡ game, đổi giá) có thể mất chừng ấy thời gian mới được cập nhật.
- **Trạng thái miễn phí** — được kiểm tra khi thêm game và ở mỗi lần kiểm tra lại, nhưng game có thể chuyển sang trả phí hoặc biến mất khỏi itch.io bất cứ lúc nào. Để tránh gỡ nhầm game vì trục trặc tạm thời, Dự án chỉ gỡ một game khi cùng một vấn đề (trang không còn — HTTP 404/410 — hoặc game đã chuyển sang trả phí) được thấy lại sau ít nhất 20 giờ. Vì vậy một game trong danh sách có thể bị lỗi thời trong một khoảng thời gian.
- **Thống kê và biểu đồ** — các con số, biểu đồ và số liệu khác được tính từ catalog và chỉ mang tính tham khảo.
## 6. Nội dung người lớn (NSFW)
- Các game có cờ `nsfw: Yes` **bị ẩn theo mặc định** (ảnh bìa cũng không hiển thị). Bạn chỉ có thể bật nội dung 18+ trong **Settings** sau khi xác nhận mình đủ 18 tuổi trở lên. Lựa chọn này chỉ được lưu trên thiết bị của bạn (local storage của trình duyệt) và không bao giờ được gửi tới Dự án.
- Cờ này chỉ mang tính cố gắng tối đa (best-effort). Ban đầu nó được đặt tự động dựa trên tag và mô tả của game trên itch.io khi game được thêm, và Người duy trì có thể sửa lại. Một game vẫn có thể bị gắn nhãn sai theo cả hai chiều, nên hãy kiểm tra trang itch.io (và các cảnh báo nội dung của chính trang đó) trước khi tải nếu điều này quan trọng với bạn. Để báo cờ bị sai, hãy dùng quy trình yêu cầu ở [§8](#8-yêu-cầu-gỡ-và-sửa-thông-tin).
- Dự án không hướng tới trẻ em dưới 16 tuổi, và nội dung người lớn chỉ dành cho người trưởng thành tự chọn xem.
## 7. Nội dung của bên thứ ba và quyền sở hữu
Với mỗi game, Dự án sao chép từ trang itch.io công khai của game: tên, nhà phát triển, phần mô tả, thể loại, tag và các metadata khác, cùng URL ảnh bìa. Website hiển thị các bản sao đã thu nhỏ của ảnh bìa, được lưu trên Cloudflare R2 và phục vụ từ freeitchgames.win; ứng dụng desktop và Android tải ảnh bìa trực tiếp từ CDN ảnh của itch.io (`img.itch.zone`).
Mô tả game và mọi văn bản khác do người làm game viết, ảnh bìa và các nội dung đa phương tiện khác, tên game, logo và nhãn hiệu **vẫn thuộc quyền sở hữu của người tạo ra và chủ sở hữu của chúng**. Dự án không cấp phép những nội dung này cho bất kỳ ai: giấy phép CC BY 4.0 cho dữ liệu catalog ([`data_game/LICENSE.md`](../../../data_game/LICENSE.md)) chỉ bao gồm phần đóng góp riêng của Người duy trì — việc tuyển chọn và sắp xếp bộ sưu tập, ba trường do Người duy trì viết (`safe_virus`, `notes`, `nsfw`), các bản ghi gỡ game, cấu trúc và số liệu thống kê phái sinh — và loại trừ rõ ràng các nội dung của bên thứ ba nói trên. Nếu bạn tái sử dụng dữ liệu, việc xin phép đối với phần nội dung bị loại trừ là trách nhiệm của bạn.
Nếu bạn là người làm game hoặc chủ sở hữu quyền và không muốn nội dung của mình xuất hiện ở đây, xem [§8](#8-yêu-cầu-gỡ-và-sửa-thông-tin).
## 8. Yêu cầu gỡ và sửa thông tin
Bất kỳ ai — đặc biệt là người làm game và chủ sở hữu quyền — đều có thể yêu cầu gỡ một game hoặc sửa dữ liệu của game đó:
- gửi email tới **takedown@poli0981.dev**, hoặc
- mở một [issue "Remove a game"](https://github.com/poli0981/free-games-itchio-list/issues/new?template=remove_game.yml) trên GitHub (biểu mẫu này cũng dùng cho khiếu nại bản quyền). Issue trên GitHub là công khai, nên hãy dùng email cho những gì bạn muốn giữ riêng tư.
Vui lòng ghi rõ URL itch.io của game, bạn là ai (người làm game hoặc chủ sở hữu quyền, hoặc người được họ ủy quyền), và lý do yêu cầu.
Những gì diễn ra tiếp theo:
- Người duy trì gỡ bản ghi khỏi catalog. Việc gỡ được ghi lại kèm lý do trong danh sách công khai các game đã gỡ (`scripts/deleted_games.json`, hiển thị tại https://freeitchgames.win/removed).
- Các bản sao ảnh bìa đã thu nhỏ lưu trên Cloudflare R2 bị xóa, và các bản sao lưu đệm sẽ hết hạn khỏi bộ nhớ đệm (cache) của Cloudflare.
- Các phiên bản cũ của dữ liệu vẫn còn trong lịch sử git công khai của repository. Người duy trì không thể viết lại lịch sử công khai, trừ trường hợp ngoại lệ khi pháp luật buộc phải làm vậy.
- Mục tiêu: trong vòng 7 ngày; các yêu cầu pháp lý khẩn cấp được xử lý sớm hơn.
Quy trình đầy đủ được mô tả trong [Điều khoản sử dụng](ToS.md). Gỡ một game khỏi catalog không có nghĩa là gỡ game đó khỏi itch.io.
## 9. Tính sẵn sàng và dịch vụ bên thứ ba
Website chạy trên Cloudflare; mã nguồn, dữ liệu và bản tải ứng dụng nằm trên GitHub; còn catalog phụ thuộc vào các trang và feed công khai của itch.io. Bất kỳ dịch vụ nào trong số này đều có thể chậm, ngừng hoạt động, thay đổi hoặc bị chặn bất cứ lúc nào. Người duy trì có thể thay đổi, tạm dừng hoặc chấm dứt bất kỳ phần nào của Dự án vào bất cứ lúc nào và không hứa rằng Dự án sẽ luôn trực tuyến.
## 10. Không chịu trách nhiệm pháp lý
Trong phạm vi tối đa mà pháp luật hiện hành cho phép, Người duy trì và những người đóng góp không chịu trách nhiệm đối với bất kỳ thiệt hại trực tiếp, gián tiếp, ngẫu nhiên, hệ quả, đặc biệt, mang tính răn đe hay trừng phạt nào phát sinh từ hoặc liên quan tới:
- việc sử dụng website, các ứng dụng, dữ liệu catalog, hoặc bất kỳ mã nguồn hay tài liệu nào trong Dự án;
- việc không thể sử dụng những thứ trên (ví dụ: website ngừng hoạt động, deploy lỗi, hoặc bộ cài hay file APK bị hỏng);
- bất kỳ game nào được truy cập qua liên kết trong catalog (crash, mất save, mất dữ liệu, hư hỏng phần cứng, mã độc, bị chiếm tài khoản trên nền tảng bên thứ ba, hoặc cảm giác hối tiếc);
- lỗi, thiếu sót hoặc sai lệch trong dữ liệu catalog.
Điều này áp dụng kể cả khi Người duy trì đã được báo trước về khả năng xảy ra các thiệt hại đó. Không điều gì trong Tuyên bố này loại trừ hoặc giới hạn trách nhiệm mà pháp luật không cho phép loại trừ hoặc giới hạn, hay bất kỳ quyền bảo vệ người tiêu dùng bắt buộc nào mà bạn có theo pháp luật của quốc gia nơi bạn cư trú.
## 11. Luật áp dụng và tính độc lập của các điều khoản
Tuyên bố này được điều chỉnh bởi pháp luật của **Cộng hòa Xã hội Chủ nghĩa Việt Nam**, không xét đến các nguyên tắc xung đột pháp luật, và tranh chấp được giải quyết như mô tả trong [Điều khoản sử dụng](ToS.md). Không điều gì trong mục này giới hạn các quyền bảo vệ người tiêu dùng bắt buộc của quốc gia nơi bạn cư trú. Nếu bất kỳ điều khoản nào bị coi là không thể thi hành tại một khu vực tài phán cụ thể, các điều khoản còn lại vẫn giữ nguyên hiệu lực.
## 12. Liên hệ
- Yêu cầu gỡ, sửa thông tin và khiếu nại bản quyền: **takedown@poli0981.dev**
- Câu hỏi và yêu cầu về quyền riêng tư: **privacy@poli0981.dev**
- Các vấn đề pháp lý khác: **legal@poli0981.dev**
Các địa chỉ này được chuyển tiếp tới Người duy trì.
## 13. Không phải tư vấn pháp lý
Không nội dung nào trong tài liệu này là tư vấn pháp lý. Đây là tuyên bố miễn trừ của một dự án sở thích, được soạn bởi một người không phải luật sư với sự hỗ trợ của AI, và hiệu lực thi hành của nó phụ thuộc vào pháp luật nơi bạn sinh sống. Nếu bạn thực sự cần sự chắc chắn về mặt pháp lý cho việc gì đó, hãy thuê một luật sư thật.
## 14. Lời cuối
Đây vẫn chỉ là một danh sách game miễn phí do một dev mệt mỏi và vài LLM làm ra. Chơi vui, giữ an toàn, quét file tải về, và nhớ rằng: đời quá ngắn để lôi một repo GitHub ngẫu nhiên ra tòa.
Built with boredom, AI buddies, và niềm mong mỏi sâu sắc là sẽ không bao giờ phải đối mặt với một vụ kiện thật. 🚀
+138
View File
@@ -0,0 +1,138 @@
# Thỏa thuận cấp phép cho người dùng cuối (EULA)
Cập nhật lần cuối: 2026-10-16
Áp dụng từ: khi phát hành phiên bản 4.2.0.
Bản dịch từ bản tiếng Anh cập nhật ngày 2026-10-03 (English source revision 2026-10-03). Nếu có khác biệt, bản tiếng Anh được ưu tiên.
> Bản tiếng Anh: [`docs/EULA.md`](../../EULA.md).
EULA này **chỉ áp dụng cho ứng dụng desktop và ứng dụng Android** của Itch.io Free Games DB: các bộ cài (`.msi`, `.exe`, `.dmg`, `.pkg`, `.app.tar.gz`, `.deb`, `.rpm`, `.AppImage`) và file `.apk` Android được phát hành trên GitHub Releases. EULA này **không** áp dụng cho:
- website <https://freeitchgames.win>, được điều chỉnh bởi [Điều khoản sử dụng](ToS.md);
- mã nguồn, theo [Giấy phép MIT](../../../LICENSE);
- dữ liệu catalog, theo CC BY 4.0 (xem [`data_game/LICENSE.md`](../../../data_game/LICENSE.md) và [toàn văn pháp lý của giấy phép](../../../LICENSES/CC-BY-4.0.txt));
- bản thân các game, vốn được nhà phát triển cấp phép riêng thông qua itch.io.
> **Tóm tắt**: Các ứng dụng là trình xem catalog miễn phí, chỉ đọc, theo giấy phép MIT. Không tài khoản, không quảng cáo, không telemetry. Chỉ tải chúng từ GitHub Releases, tự cập nhật bằng tay, và tự chịu rủi ro khi sử dụng. Game không phải của bạn chỉ vì chúng được liệt kê ở đây.
## 1. Định nghĩa
- **"Ứng dụng"**: các bản build Tauri 2 của Itch.io Free Games DB, gồm ứng dụng desktop cho Windows, macOS và Linux và ứng dụng Android (arm64-v8a, Android 11 trở lên), do Người duy trì phát hành trên [trang GitHub Releases](https://github.com/poli0981/free-games-itchio-list/releases).
- **"Website"**: <https://freeitchgames.win>.
- **"Catalog"**: metadata các game miễn phí trong `data_game/`, được Website công bố tại <https://freeitchgames.win/data> và được Ứng dụng hiển thị.
- **"Repository"**: `free-games-itchio-list` trên GitHub tại <https://github.com/poli0981/free-games-itchio-list>, nơi chứa mã nguồn của Ứng dụng.
- **"Người duy trì"**: GitHub user `poli0981` (alias: SkullMute), một cá nhân tại Việt Nam duy trì dự án như một sở thích.
- **"Bạn"**: cá nhân hoặc tổ chức cài đặt hoặc sử dụng Ứng dụng.
## 2. Cấp phép
Ứng dụng được build từ mã nguồn trong Repository, vốn được cấp phép theo **Giấy phép MIT** (xem [`LICENSE`](../../../LICENSE) cho văn bản gốc; `Copyright (c) 2025-2026 poli0981 (SkullMute)`). Theo giấy phép đó, Bạn được phép, hoàn toàn miễn phí:
- cài đặt và chạy Ứng dụng trên bao nhiêu thiết bị tùy ý, cho bất kỳ mục đích nào, cá nhân hay thương mại;
- sao chép và phân phối lại các bộ cài hoặc file APK, miễn là giữ nguyên thông báo bản quyền và giấy phép;
- tự build phiên bản riêng từ mã nguồn (mục 8 giải thích cách giữ cho bản đó tách biệt rõ ràng với các bản phát hành chính thức).
Các thành phần bên thứ ba đi kèm trong Ứng dụng (React, Tauri và các thành phần khác) vẫn theo giấy phép riêng của chúng. Xem [`THIRD_PARTY.md`](../../THIRD_PARTY.md) hoặc trang Giới thiệu (About) trong Ứng dụng.
Không điều gì trong EULA này lấy đi quyền mà Giấy phép MIT trao cho Bạn đối với mã nguồn. Nếu hai văn bản mâu thuẫn, Giấy phép MIT được ưu tiên đối với phần mã.
## 3. Ứng dụng là gì (và không phải là gì)
- Một **trình xem chỉ đọc**: Bạn có thể duyệt, tìm kiếm, lọc và xem biểu đồ của Catalog. Không có tài khoản, không đăng nhập, không chỉnh sửa, không bình luận, không quảng cáo và không thanh toán.
- Việc đề xuất game được thực hiện trên Website (<https://freeitchgames.win/suggest>). Ứng dụng chỉ dẫn link tới đó.
- Các game được gắn cờ nội dung người lớn (`nsfw: Yes`) bị ẩn theo mặc định, kể cả ảnh bìa. Bạn có thể bật chúng trong trang Cài đặt (Settings) sau khi xác nhận mình từ 18 tuổi trở lên.
- Trường `safe_virus` là ghi chú thủ công của Người duy trì, không phải lời bảo đảm. Dự án không quét bất kỳ game hay file tải về nào được liên kết từ Ứng dụng.
- Ở lần mở đầu tiên, Ứng dụng hiển thị cùng màn hình pháp lý như Website và yêu cầu Bạn chấp nhận các điều khoản của dự án. Màn hình này sẽ hỏi lại khi các điều khoản đó thay đổi.
## 4. Kết nối mạng và quyền riêng tư
Ứng dụng **không có telemetry**: không analytics, không báo cáo lỗi (crash reporting), không theo dõi. Ứng dụng chỉ kết nối tới hai nơi:
- **freeitchgames.win**, để tải dữ liệu Catalog từ <https://freeitchgames.win/data>. Website chạy trên Cloudflare; Cloudflare xử lý dữ liệu yêu cầu thông thường (như địa chỉ IP và user agent của Bạn) để phân phối nội dung, như mô tả trong [Chính sách quyền riêng tư (Privacy Policy)](PrivacyPolicy.md).
- **img.itch.zone**, máy chủ ảnh của itch.io, để tải trực tiếp ảnh bìa. itch.io nhận dữ liệu yêu cầu thông thường cho các ảnh đó, như với bất kỳ ảnh nào được tải từ web (xem [chính sách quyền riêng tư của itch.io](https://itch.io/docs/legal/privacy-policy)).
Khi Bạn bấm vào một game hoặc một link bên ngoài khác, link đó sẽ mở trong trình duyệt mặc định của Bạn (itch.io, GitHub hoặc Website). Từ lúc đó, điều khoản và chính sách quyền riêng tư của chính trang đó được áp dụng.
Ứng dụng lưu các tùy chọn của Bạn (ngôn ngữ, giao diện sáng/tối, mật độ bố cục, việc ẩn thanh cuộn, lựa chọn 18+, và phiên bản điều khoản pháp lý Bạn đã chấp nhận) cùng một bản sao lưu đệm (cache) đã nén của Catalog (giữ tối đa 7 ngày) chỉ trên thiết bị của Bạn. Không dữ liệu nào trong số đó được gửi cho Người duy trì.
## 5. Cài đặt ứng dụng, cập nhật và gỡ bỏ
- **Chỉ tải Ứng dụng từ [trang GitHub Releases](https://github.com/poli0981/free-games-itchio-list/releases).** Bản sao từ bất kỳ nơi nào khác có thể đã bị sửa đổi, và Người duy trì không chịu trách nhiệm về chúng.
- **Android:** file APK không có trên Google Play. Nó được cài thủ công (sideload), nên Android sẽ yêu cầu Bạn cho phép cài ứng dụng từ ứng dụng mà Bạn dùng để tải file về (ví dụ trình duyệt hoặc trình quản lý file). APK được ký bằng khóa của dự án. Ứng dụng cần Android 11 trở lên trên thiết bị arm64-v8a.
- **macOS:** Ứng dụng cần Safari/WebKit 16.4 trở lên.
- **Cập nhật thủ công.** Ứng dụng không tự cập nhật và không tự kiểm tra bản mới. Để cập nhật, hãy tải và cài một bản phát hành mới hơn. Chỉ bản phát hành mới nhất được hỗ trợ.
- **Gỡ bỏ:** gỡ cài đặt Ứng dụng như mọi ứng dụng khác. Việc gỡ cài đặt sẽ xóa Ứng dụng và dữ liệu cục bộ của nó. Nếu trình gỡ cài đặt trên desktop để lại thư mục dữ liệu của Ứng dụng (thư mục có tên `com.poli0981.freegamesitchio`), Bạn có thể tự xóa thư mục đó.
- Ứng dụng phụ thuộc vào Website để lấy dữ liệu. Nếu Website không truy cập được, Ứng dụng chỉ có thể hiển thị bản sao lưu đệm, nếu có.
## 6. Những gì EULA này KHÔNG bao phủ
EULA này không cấp quyền nào đối với:
- **Các game được liệt kê trong Catalog.** Mỗi game thuộc về nhà phát triển của nó và được họ cấp phép thông qua itch.io. Ứng dụng chỉ hiển thị link và metadata. Việc tải về, chơi, sửa đổi hoặc phân phối lại một game được điều chỉnh bởi điều khoản riêng của nhà phát triển và điều khoản của itch.io.
- **Nội dung do người khác tạo ra**: tên game, mô tả và các văn bản khác do nhà sáng tạo game viết, ảnh bìa và các nội dung đa phương tiện khác, logo và nhãn hiệu. Chúng được hiển thị để Bạn tìm và nhận diện game, và vẫn thuộc sở hữu của chủ sở hữu. Nhà sáng tạo game có thể yêu cầu gỡ bỏ (xem [Điều khoản sử dụng](ToS.md) hoặc gửi email tới takedown@poli0981.dev).
- **Nhãn hiệu, logo hoặc nhãn hiệu dịch vụ của itch.io.** Dự án không liên kết với itch.io, cũng không được itch.io chứng thực hay tài trợ. Tên itch.io chỉ được dùng để nhận diện.
- **Thư viện bên thứ ba** đi kèm trong Ứng dụng, vốn vẫn theo giấy phép riêng của chúng.
- **Website, dữ liệu Catalog và mã nguồn**, lần lượt được điều chỉnh bởi Điều khoản sử dụng, CC BY 4.0 và Giấy phép MIT.
## 7. Chấp nhận
Bạn chấp nhận EULA này khi cài đặt hoặc sử dụng Ứng dụng, ví dụ khi chấp nhận EULA trong bộ cài Windows hoặc khi cài file APK. Nếu Bạn không đồng ý, đừng cài Ứng dụng, hoặc hãy gỡ cài đặt nó.
## 8. Quy tắc sử dụng
Bạn đồng ý không:
- Trình bày một bản build đã sửa đổi như một bản phát hành chính thức, ví dụ phân phối nó dưới tên và biểu tượng của dự án, hoặc với app identifier chính thức `com.poli0981.freegamesitchio`, mà không ghi rõ đó là bản không chính thức. Fork luôn được chào đón theo Giấy phép MIT; chỉ cần làm rõ rằng đó là bản của Bạn.
- Sử dụng tên Người duy trì, GitHub handle `poli0981`, hoặc alias "SkullMute" để chứng thực hoặc quảng bá tác phẩm phái sinh mà không có sự cho phép trước bằng văn bản.
- Sử dụng Ứng dụng, hoặc một phiên bản đã sửa đổi của nó, theo cách vi phạm [Điều khoản sử dụng](ToS.md) của Website, ví dụ gửi yêu cầu tự động hàng loạt tới Website (dữ liệu có sẵn trong Repository), hoặc cố truy cập khu vực quản trị (admin) khi không được phép.
- Sử dụng Ứng dụng hoặc các bộ cài của nó để lưu trữ, phân phối hoặc tạo điều kiện phân phối malware, trang phishing, hoặc nội dung vi phạm pháp luật hiện hành.
Các quy tắc này là về cách Bạn sử dụng Ứng dụng cũng như tên và dịch vụ của dự án. Chúng tồn tại song song với Giấy phép MIT và không hạn chế các quyền mà giấy phép đó trao đối với mã nguồn.
## 9. Không bảo đảm và giới hạn trách nhiệm
Ứng dụng được cung cấp **"nguyên trạng"** ("as is") và **"tùy theo khả năng sẵn có"** ("as available"), không kèm bất kỳ bảo đảm nào, dù rõ ràng hay ngụ ý, bao gồm bảo đảm về khả năng thương mại, sự phù hợp cho một mục đích cụ thể, tính chính xác hoặc đầy đủ của Catalog, hoạt động không gián đoạn, và việc không vi phạm quyền.
Trong phạm vi pháp luật hiện hành cho phép, Người duy trì và những người đóng góp không chịu trách nhiệm về bất kỳ thiệt hại nào phát sinh từ việc cài đặt hoặc sử dụng Ứng dụng, từ việc không thể sử dụng nó, hoặc từ các game và trang mà Bạn truy cập thông qua nó. Xem [Tuyên bố miễn trừ trách nhiệm](DISCLAIMER.md) để biết chi tiết.
## 10. Thay đổi và chấm dứt
Người duy trì có thể thay đổi hoặc dừng Ứng dụng, các bản phát hành của nó hoặc Website bất kỳ lúc nào. Các bản phát hành đã công bố vẫn được giữ trên GitHub Releases trừ khi được rút lại một cách rõ ràng.
Các phiên bản mới của EULA này được công bố trong Repository và đi kèm các bản phát hành sau, và màn hình pháp lý của Ứng dụng sẽ hỏi lại Bạn khi các điều khoản của dự án thay đổi.
Quyền của Bạn theo EULA này tự động chấm dứt nếu Bạn vi phạm nghiêm trọng. Bạn có thể chấm dứt EULA bất kỳ lúc nào bằng cách gỡ cài đặt Ứng dụng. Quyền được cấp theo Giấy phép MIT đối với mã nguồn vẫn còn hiệu lực sau khi EULA này chấm dứt, trong phạm vi mà điều khoản MIT cho phép.
## 11. Luật áp dụng
EULA này được điều chỉnh bởi pháp luật của **Cộng hòa Xã hội Chủ nghĩa Việt Nam**, không xét đến các nguyên tắc xung đột pháp luật. Bất kỳ tranh chấp nào không thể giải quyết một cách không chính thức sẽ được đưa ra tòa án có thẩm quyền của Việt Nam.
Không điều gì trong EULA này hạn chế các quyền bắt buộc về bảo vệ người tiêu dùng mà pháp luật tại quốc gia Bạn cư trú trao cho Bạn.
Bản thân Giấy phép MIT có tính khả chuyển quốc tế và được giải thích như vậy.
## 12. Tính độc lập của điều khoản
Nếu bất kỳ điều khoản nào của EULA này bị coi là vô hiệu hoặc không thể thực thi tại một khu vực tài phán, các điều khoản còn lại vẫn giữ nguyên hiệu lực, và điều khoản vô hiệu sẽ được thay thế (chỉ tại khu vực tài phán đó) bằng điều khoản gần nhất với ý định ban đầu.
## 13. Liên hệ
- Câu hỏi về EULA này, hoặc bất kỳ vấn đề pháp lý nào khác: legal@poli0981.dev
- Yêu cầu về quyền riêng tư: privacy@poli0981.dev
- Gỡ bỏ nội dung và bản quyền: takedown@poli0981.dev
- Lỗ hổng bảo mật trong Ứng dụng: security@poli0981.dev hoặc tính năng báo cáo lỗ hổng riêng tư của GitHub (xem [SECURITY.md](SECURITY.md)). Vui lòng không mở issue công khai cho lỗ hổng bảo mật.
- Các vấn đề khác: contact@poli0981.dev, hoặc bất kỳ kênh nào được liệt kê tại https://poli0981.dev/links/
## 14. Không phải tư vấn pháp lý
EULA này là tài liệu cho một dự án sở thích, được soạn bởi một người không phải luật sư, có hỗ trợ của AI. Nó không thay thế tư vấn pháp lý chuyên nghiệp. Nếu Bạn cần sự chắc chắn về pháp lý cho một triển khai nghiêm túc, hãy tham khảo ý kiến luật sư có giấy phép hành nghề.
## 15. Lời cuối
Đây vẫn là một dự án sở thích sinh ra từ thất nghiệp, buồn chán và sự bướng bỉnh không chịu xóa repo. Cài app, fork nó, hay kệ nó. Xây thứ gì đó hay hơn. Vui vẻ săn game miễn phí, hoặc không. Không ai phán xét (có lẽ trừ Người duy trì, đang tự phán xét code của chính mình).
Built with zero budget, too much free time, and two AI buddies. 🚀
**P/S:** Không ai đọc EULA cả. Chắc bạn là người đầu tiên :D
+247
View File
@@ -0,0 +1,247 @@
# Chính sách quyền riêng tư (Privacy Policy)
Cập nhật lần cuối: 2026-10-16
Áp dụng từ: ngày 2026-10-13 đối với Website, và từ phiên bản 4.4.0 đối với các Ứng dụng.
> Bản dịch từ bản tiếng Anh cập nhật ngày 2026-10-13 (English source revision 2026-10-13). Nếu có khác biệt, bản tiếng Anh được ưu tiên. Bản gốc: [`docs/PrivacyPolicy.md`](../../PrivacyPolicy.md).
Chính sách quyền riêng tư này giải thích dự án `free-games-itchio-list` xử lý những dữ liệu cá nhân nào, vì sao, ai hỗ trợ xử lý, dữ liệu được lưu trong bao lâu và bạn có những quyền gì. Chính sách áp dụng cho website **https://freeitchgames.win**, các ứng dụng desktop và Android, dữ liệu danh mục công khai và repository. Nói ngắn gọn: không có tài khoản, không quảng cáo, không cookie theo dõi. Dự án giữ ít dữ liệu nhất có thể, và phần lớn những gì tồn tại chỉ nằm trong trình duyệt của chính bạn.
> **Tóm tắt (TL;DR)**
>
> - Không tài khoản, không đăng nhập, không quảng cáo, không bán dữ liệu, không lập hồ sơ (profiling). Các Ứng dụng không có telemetry.
> - Website chạy trên Cloudflare. Cloudflare xử lý dữ liệu request tiêu chuẩn (địa chỉ IP, trình duyệt, URL, thời gian) để phân phối và bảo vệ trang, và để đếm lượt truy cập ở dạng tổng hợp, không dùng cookie. Mã nguồn của chính Dự án không bao giờ lưu địa chỉ IP của bạn.
> - Để chặn bot, trình duyệt của bạn qua một bước kiểm tra nhanh của Cloudflare Turnstile trước khi Website tải, khoảng 48 giờ một lần; một cookie thật sự cần thiết ghi nhớ rằng bạn đã qua.
> - Cài đặt của bạn (giao diện sáng/tối, ngôn ngữ, lựa chọn 18+, phiên bản điều khoản đã chấp nhận) và bản cache của danh mục công khai nằm trong trình duyệt của bạn và không bao giờ được gửi về Dự án.
> - Nếu bạn dùng trang Suggest, Người duy trì nhận được link game, ghi chú tùy chọn của bạn (bị xóa sau 180 ngày) và thời điểm gửi. Vui lòng không đưa dữ liệu cá nhân vào ghi chú.
> - Câu hỏi hoặc yêu cầu: **privacy@poli0981.dev**.
## 1. Ai chịu trách nhiệm, và Chính sách này áp dụng cho những gì
### 1.1 Bên kiểm soát dữ liệu
Bên kiểm soát dữ liệu cá nhân được mô tả trong Chính sách này là **Người duy trì**: poli0981 (SkullMute), một cá nhân tại Việt Nam, tự vận hành Dự án như một sở thích. Liên hệ: **privacy@poli0981.dev** (xem mục 12).
### 1.2 Định nghĩa
- **"Website"**: https://freeitchgames.win, bao gồm các trang và endpoint của nó (như `/data`, `/img`, `/suggest`, `/admin` và `/api/…`). Địa chỉ cũ https://poli0981.github.io/free-games-itchio-list/ chỉ chuyển hướng về đây.
- **"Các Ứng dụng"**: các ứng dụng desktop (Windows, macOS, Linux) và file APK Android, được build từ cùng mã nguồn với Website và phân phối trên GitHub Releases. Đây là các trình xem Danh mục chỉ đọc.
- **"Danh mục"** (Catalog): danh sách game và dữ liệu của chúng, gồm `data_game/`, `scripts/deleted_games.json` và các file được tạo ra từ đó, phục vụ tại https://freeitchgames.win/data.
- **"Repository"**: https://github.com/poli0981/free-games-itchio-list, bao gồm pipeline dữ liệu chạy trên GitHub Actions của repository này.
- **"Dự án"**: Website, các Ứng dụng, Danh mục và Repository nói chung.
- **"Người duy trì"**: poli0981 (SkullMute), như mô tả ở mục 1.1.
- **"Dữ liệu cá nhân"**: mọi thông tin về một người đã được xác định hoặc có thể xác định được.
- **"Bạn"**: bất kỳ ai sử dụng Dự án, kể cả các nhà sáng tạo có game nằm trong Danh mục.
### 1.3 Những gì Chính sách này không áp dụng
Chính sách này không áp dụng cho các dịch vụ tự xử lý dữ liệu với tư cách của chính họ: itch.io (mọi link game và mọi lượt tải đều dẫn tới đó), GitHub đối với tài khoản GitHub và hoạt động của bạn trên github.com, việc Cloudflare dùng dữ liệu cho mục đích riêng của họ như mô tả trong chính sách quyền riêng tư của Cloudflare, và bản thân các game. Chính sách của từng bên sẽ được áp dụng (link ở mục 4).
## 2. Dữ liệu nào được xử lý và vì sao
### 2.1 Khi truy cập Website
- **Dữ liệu request.** Website được host trên Cloudflare. Khi trình duyệt của bạn tải một trang, một file hay một hình ảnh, Cloudflare xử lý dữ liệu request tiêu chuẩn: địa chỉ IP, user agent (loại trình duyệt và thiết bị), URL được yêu cầu, referrer và thời gian. Việc này cần thiết để phân phối trang, bảo vệ trang (TLS, tường lửa, chống bot và chống tấn công từ chối dịch vụ) và hạn chế lạm dụng.
- **Bước xác minh.** Trước khi các trang và ảnh bìa của Website được tải, trình duyệt của bạn qua một bước kiểm tra của Cloudflare Turnstile. Turnstile xử lý các tín hiệu về thiết bị và trình duyệt để phân biệt người thật với bot; thường bước này tự hoàn tất mà bạn không phải làm gì. Để kiểm tra kết quả, Website gửi token Turnstile và địa chỉ IP của bạn tới dịch vụ xác minh của Cloudflare, rồi đặt cookie `__Host-fig_gate` (mục 3.2) để không phải kiểm tra lại trong 48 giờ. Bot của công cụ tìm kiếm và bot tạo bản xem trước link đã được Cloudflare xác minh thì bỏ qua bước này. Dữ liệu danh mục trong `/data` vẫn truy cập được mà không cần bước này.
- **Thống kê tổng hợp.** Website dùng Cloudflare Web Analytics: một script nhỏ được tải từ Cloudflare để đếm lượt truy cập ở dạng tổng hợp, không dùng cookie và, theo Cloudflare, không dùng fingerprinting. Người duy trì chỉ thấy số liệu tổng (như số lượt xem trang), không thấy từng người truy cập. Dự án không chạy công cụ analytics nào khác.
- **Log máy chủ.** Các request do mã máy chủ của Website (Cloudflare Workers) xử lý được Cloudflare Workers Logs ghi lại theo mẫu 10% và lưu khoảng 7 ngày, để tìm lỗi và điều tra hành vi lạm dụng.
- **Báo cáo lỗi mạng.** Cloudflare có thể thêm header Network Error Logging (NEL), yêu cầu trình duyệt của bạn báo các lỗi kết nối về Cloudflare.
- **Dự án không lưu địa chỉ IP.** Mã nguồn của chính Dự án không bao giờ ghi địa chỉ IP của bạn vào cơ sở dữ liệu, file hay Repository của Dự án.
- **Ảnh bìa** do chính Website phục vụ (bản sao đã thu nhỏ, lưu trên Cloudflare R2), nên trình duyệt của bạn không liên lạc với itch.io trong lúc bạn duyệt web. itch.io chỉ nhận được thông tin từ bạn khi bạn bấm vào link game và chuyển sang đó; khi ấy Website chỉ gửi tối đa địa chỉ của chính nó (không phải trang bạn đang xem) làm referrer.
### 2.2 Khi dùng các Ứng dụng
- Các Ứng dụng là trình xem chỉ đọc, **không telemetry, không analytics và không tài khoản**.
- Chúng tải dữ liệu Danh mục từ https://freeitchgames.win/data (Cloudflare xử lý dữ liệu request như mô tả ở mục 2.1; các phiên bản 4.0–4.1.1 vẫn nhận các file JSON cũ, được nhận biết qua header `Origin` mà cửa sổ ứng dụng gửi kèm) và tải ảnh bìa **trực tiếp từ máy chủ ảnh của itch.io (img.itch.zone)**, vì vậy itch.io nhận được địa chỉ IP và user agent của bạn khi ảnh bìa được tải.
- Bấm vào một game sẽ mở trang itch.io của game đó trong trình duyệt của bạn.
- Việc cập nhật là thủ công: các Ứng dụng không tự kiểm tra bản cập nhật. Khi bạn tải bộ cài hoặc file APK từ GitHub Releases, GitHub xử lý request đó.
- Các Ứng dụng dùng cùng kiểu lưu trữ cục bộ như Website (mục 3.1), chỉ trên thiết bị của bạn. Gỡ cài đặt Ứng dụng sẽ xóa dữ liệu này.
### 2.3 Khi đề xuất game
Khi bạn dùng trang Suggest (https://freeitchgames.win/suggest):
- **Những gì được lưu**: URL game, ghi chú tùy chọn của bạn (tối đa 500 ký tự) và thời điểm gửi, trong hàng chờ duyệt (mục 2.4). Trang không yêu cầu và không lưu tên, địa chỉ email hay tài khoản nào.
- **Chống spam**: Cloudflare Turnstile xử lý các tín hiệu về thiết bị và trình duyệt của bạn để phân biệt người thật với bot. Để kiểm tra kết quả, Website gửi token Turnstile và địa chỉ IP của bạn tới dịch vụ xác minh của Cloudflare.
- **Giới hạn tần suất**: địa chỉ IP của bạn chỉ được dùng tạm thời để đếm số request. Dự án không lưu nó.
- **Mục đích**: để xem xét đề xuất của bạn, do Người duy trì hoặc các quy tắc tự động do Người duy trì đặt ra (mục 2.4). Nếu được duyệt, URL game trở thành một phần của Danh mục công khai. Ghi chú của bạn không bao giờ được công bố và **tự động bị xóa sau 180 ngày**.
- **Vui lòng không đưa dữ liệu cá nhân vào ghi chú**, dù là của bạn hay của người khác. Biểu mẫu này chỉ dành cho link game.
### 2.4 Hàng chờ duyệt và khu vực quản trị
- **Game đến từ đâu**: đề xuất từ trang Suggest; tự động phát hiện từ các RSS feed công khai của itch.io; và game miễn phí mới trong các collection công khai trên itch.io mà Người duy trì theo dõi (Website đọc các trang công khai đó; không liên quan gì tới dữ liệu của bạn).
- **Hàng chờ duyệt** (Cloudflare D1) chứa các URL game ứng viên cùng nguồn gửi, tiêu đề, URL ảnh bìa và gợi ý thể loại lấy từ itch.io, các cờ tự động, ghi chú, mốc thời gian và quyết định của Người duy trì. Game được đưa vào Danh mục khi Người duy trì duyệt: từng game một, hoặc qua các quy tắc tự động do Người duy trì đặt ra và có thể thay đổi bất cứ lúc nào (mục không có cờ cảnh báo mà không ai từ chối trong thời gian chờ; game miễn phí mới trong các collection Người duy trì theo dõi). Các lượt duyệt tự động được ghi vào nhật ký kiểm tra như thao tác của chính Người duy trì. Các URL bị từ chối được giữ vô thời hạn làm danh sách chặn; chỉ cần URL là đủ để không phải xét lại cùng một game.
- **Khu vực quản trị** (https://freeitchgames.win/admin) chỉ dành cho Người duy trì. Khu vực này được bảo vệ bằng Cloudflare Access (đăng nhập bằng GitHub hoặc mã PIN dùng một lần gửi qua email); Cloudflare Access đặt cookie phiên `CF_Authorization` trong trình duyệt của Người duy trì. Các thao tác quản trị, kể cả thay đổi quy tắc tự động, được ghi vào nhật ký kiểm tra (audit log) kèm địa chỉ email của Người duy trì. Nhật ký này không bao giờ được công bố.
### 2.5 Dữ liệu game công khai trong Danh mục
- Danh mục được xây dựng từ các trang game công khai trên itch.io: tên game, tên nhà phát triển và nhà phát hành, mô tả, thể loại, tag, nền tảng, đánh giá và các metadata tương tự, cùng URL ảnh bìa. Pipeline tự nhận diện là `FreeItchGamesBot/4.0 (+https://freeitchgames.win/about)` và giãn nhịp các request.
- Tên nhà phát triển hoặc nhà phát hành, hay địa chỉ itch.io của nhà sáng tạo nằm trong URL game, có thể là tên hoặc biệt danh của một người, nên có thể là dữ liệu cá nhân. Thông tin này chỉ được dùng để nhận diện và ghi công cho game, và để giúp mọi người khám phá game.
- Dữ liệu này được công bố trên Website, trong Repository và tại https://freeitchgames.win/data. Khi một game bị gỡ, URL, tên, lý do và ngày gỡ được ghi vào [`scripts/deleted_games.json`](../../../scripts/deleted_games.json); Website hiển thị danh sách này ở trang Removed (https://freeitchgames.win/removed).
- Nhà sáng tạo có thể yêu cầu sửa hoặc gỡ bất kỳ lúc nào (mục 7).
### 2.6 Khi liên hệ Người duy trì
- Email gửi tới các địa chỉ của Dự án (mục 12) được gửi tới hộp thư của Người duy trì, do Google Workspace lưu trữ trên tên miền riêng của Người duy trì, poli0981.dev. Người duy trì nhận địa chỉ email của bạn, tên bạn dùng (nếu có) và nội dung thư, và chỉ dùng chúng để xử lý yêu cầu của bạn.
- Thư từ về yêu cầu gỡ game và yêu cầu liên quan đến bản quyền được giữ trong thời gian cần thiết để xử lý yêu cầu.
### 2.7 Đóng góp trên GitHub
Issue, pull request, discussion và bình luận đều công khai trên GitHub dưới tài khoản GitHub của bạn, và tuyên bố quyền riêng tư của GitHub áp dụng cho chúng. Người duy trì chỉ thấy những gì GitHub hiển thị. Biểu mẫu issue "Remove a game" cũng công khai, nên hãy dùng email cho những gì bạn không muốn công bố.
### 2.8 Những điều Dự án không làm
- Không có tài khoản hay đăng nhập cho công chúng, không bình luận, không quảng cáo và không thanh toán.
- Mã nguồn của chính Dự án không đặt cookie nào trên Website công khai, ngoại trừ cookie xác minh, vốn không nhận diện bất kỳ ai (mục 3.2).
- Không bán hay chia sẻ dữ liệu cá nhân, dù cho quảng cáo hay bất kỳ mục đích nào khác.
- Không lập hồ sơ (profiling) và không ra quyết định tự động gây hệ quả pháp lý hoặc ảnh hưởng đáng kể tương tự đối với bạn.
- Không có telemetry trong các Ứng dụng, và không có analytics nào ngoài Cloudflare Web Analytics trên Website.
## 3. Lưu trữ trên trình duyệt và cookie
### 3.1 Website và các Ứng dụng lưu gì trên thiết bị của bạn
Website và các Ứng dụng chỉ lưu các mục sau trên thiết bị của bạn. Không mục nào được gửi về Dự án.
| Lưu trữ | Khóa | Nội dung | Giữ đến khi |
|---|---|---|---|
| `localStorage` | `webapp.prefs` | Tùy chọn giao diện như ngôn ngữ, mật độ hiển thị và việc ẩn thanh cuộn, lựa chọn nội dung 18+ (NSFW) của bạn, và phiên bản các văn bản pháp lý bạn đã chấp nhận | Bạn xóa nó |
| `localStorage` | `webapp.theme` | Giao diện: `light`, `dark` hoặc `system` | Bạn xóa nó |
| `localStorage` | `webapp.gate` | Thời điểm lượt xác minh hiện tại (mục 3.2) hết hạn, để tab đang mở kịp kiểm tra lại | Bị thay bởi lần kiểm tra sau; bạn có thể xóa nó |
| IndexedDB (qua `idb-keyval`) | `webapp.query-cache` | Bản sao đã nén của dữ liệu Danh mục công khai (danh sách game, nhật ký game bị gỡ, chuỗi số lượng game theo thời gian và mô tả của những game bạn đã mở hoặc tìm), để tải nhanh và dùng offline ở mức hạn chế | Tối đa 7 ngày, sau đó được làm mới hoặc bị bỏ đi |
| `sessionStorage` | `reloaded-after-deploy` | Một mốc thời gian, để trang chỉ tự tải lại tối đa một lần sau khi site được cập nhật | Tab được đóng |
Ở lần tải đầu tiên, Website và các Ứng dụng cũng xóa các mục mà ứng dụng v3 cũ để lại trong bộ nhớ trình duyệt (một GitHub access token đã mã hóa và dữ liệu khóa ký commit). v4 không dùng tới các mục này.
Các mục trên là thật sự cần thiết cho những tính năng bạn dùng (giữ cài đặt, tải trang nhanh, phục hồi sau khi site cập nhật, không phải xác minh lặp lại), nên không cần sự đồng ý theo các quy định ePrivacy của EU hay PECR của Vương quốc Anh. Bạn có thể xóa chúng bất kỳ lúc nào bằng tùy chọn "Clear site data" (xóa dữ liệu trang web) của trình duyệt cho `freeitchgames.win`, hoặc xem chúng trong công cụ dành cho nhà phát triển (developer tools) của trình duyệt. Với các Ứng dụng, gỡ cài đặt sẽ xóa chúng; nếu trình gỡ cài đặt trên desktop để sót lại thư mục dữ liệu của Ứng dụng (`com.poli0981.freegamesitchio`), bạn có thể tự xóa thư mục đó. Trên Android, bạn cũng có thể xóa bộ nhớ của ứng dụng trong phần cài đặt hệ thống.
### 3.2 Cookie
- Mã nguồn của chính Dự án đặt **một cookie** trên Website công khai: `__Host-fig_gate`, sau khi bạn qua bước xác minh (mục 2.1). Cookie này chỉ chứa thời điểm cấp và một chữ ký, không nhận diện ai, tồn tại **48 giờ** và chỉ được gửi tới freeitchgames.win (`HttpOnly`, `Secure`, `SameSite=Lax`). Cookie này thật sự cần thiết để chặn truy cập tự động, nên không cần sự đồng ý theo các quy định ePrivacy của EU hay PECR của Vương quốc Anh. Nếu bạn chặn nó, bước kiểm tra sẽ chạy lại ở mỗi lần truy cập.
- Cloudflare có thể đặt các cookie bảo mật thật sự cần thiết, như `__cf_bm` hoặc `cf_clearance`, khi cơ chế chống bot hoặc thử thách (challenge) của họ hoạt động. Các cookie này chỉ phục vụ mục đích bảo mật.
- Bước xác minh và trang Suggest dùng Cloudflare Turnstile (mục 2.1 và 2.3); xem phụ lục quyền riêng tư Turnstile của Cloudflare (mục 4).
- Khu vực quản trị dùng cookie phiên `CF_Authorization` của Cloudflare Access, cookie này chỉ tồn tại trong trình duyệt của Người duy trì.
## 4. Nhà cung cấp dịch vụ và các bên khác
| Bên | Vai trò và công việc | Dữ liệu liên quan | Chính sách quyền riêng tư |
|---|---|---|---|
| **Cloudflare** | Bên xử lý dữ liệu cho Website: DNS, CDN, tường lửa và TLS; Workers (mã máy chủ của site) và static assets; R2 (ảnh bìa đã thu nhỏ); D1 (hàng chờ duyệt); Images (thu nhỏ ảnh); Turnstile (bước xác minh và trang Suggest); Web Analytics; Workers Logs; Access (chỉ cho đăng nhập quản trị); Rate Limiting | Dữ liệu request, đề xuất từ trang Suggest, hàng chờ duyệt | <https://www.cloudflare.com/privacypolicy/> · Turnstile: <https://www.cloudflare.com/turnstile-privacy-policy/> |
| **GitHub** | Host mã nguồn, dữ liệu Danh mục, issue và discussion, pipeline dữ liệu (GitHub Actions) và các bản phát hành để tải về. Là bên kiểm soát độc lập đối với tài khoản và hoạt động GitHub của bạn | Các đóng góp công khai của bạn; dữ liệu request khi bạn truy cập GitHub hoặc tải bản phát hành | <https://docs.github.com/en/site-policy/privacy-policies/github-privacy-statement> |
| **Google** | Bên xử lý dữ liệu cho email: Google Workspace lưu trữ hộp thư của Người duy trì, nơi nhận thư gửi tới các địa chỉ liên hệ của Dự án (mục 12) | Email bạn gửi tới các địa chỉ đó (địa chỉ, tên và nội dung thư của bạn) | <https://policies.google.com/privacy> |
| **itch.io** | Nền tảng độc lập, không liên kết với Dự án. Là nguồn dữ liệu game; mọi link game và lượt tải đều dẫn tới đó; các Ứng dụng tải ảnh bìa từ img.itch.zone | Những gì trình duyệt của bạn hoặc các Ứng dụng gửi đi khi bạn truy cập itch.io hoặc tải ảnh bìa từ đó. Pipeline không gửi thông tin nào về bạn | <https://itch.io/docs/legal/privacy-policy> |
| **Discord** | Nhận thông báo build và phát hành tự động từ GitHub Actions | Không có dữ liệu người truy cập | — |
Cloudflare và Google có thể xử lý dữ liệu ở bất kỳ đâu trên mạng lưới toàn cầu của họ (xem mục 9). Người duy trì không cung cấp dữ liệu cá nhân cho bất kỳ ai khác, trừ khi pháp luật yêu cầu.
## 5. Dữ liệu được lưu trong bao lâu
| Dữ liệu | Thời gian lưu |
|---|---|
| Dữ liệu request do Cloudflare xử lý để phân phối và bảo mật | Do Cloudflare lưu theo chính sách quyền riêng tư của họ; Dự án không lưu |
| Workers Logs (mẫu 10% các request do mã máy chủ của Website xử lý) | Khoảng 7 ngày |
| Web Analytics | Chỉ có thống kê tổng hợp; Người duy trì không thể thấy từng người truy cập |
| Địa chỉ IP dùng cho giới hạn tần suất và Turnstile | Chỉ dùng tạm thời; Dự án không bao giờ lưu |
| Ghi chú trên trang Suggest | Tự động xóa sau **180 ngày** |
| URL game được đề xuất hoặc được phát hiện, kèm nguồn và mốc thời gian | Nằm trong hàng chờ duyệt chừng nào còn cần để không phải xét cùng một game hai lần. URL được duyệt trở thành một phần của Danh mục công khai; URL bị từ chối được giữ vô thời hạn làm danh sách chặn |
| Nhật ký kiểm tra quản trị (kèm địa chỉ email của Người duy trì) | Được giữ làm hồ sơ các thay đổi quản trị; không bao giờ công bố |
| Mục trong Danh mục (bao gồm tên nhà phát triển và nhà phát hành) | Khi game còn được liệt kê. Bản ghi gỡ bỏ vẫn nằm trong danh sách game đã gỡ công khai, và lịch sử Git của Repository giữ các phiên bản trước (xem mục 7.3) |
| Email, bao gồm yêu cầu gỡ game và yêu cầu liên quan đến bản quyền | Trong thời gian cần thiết để xử lý yêu cầu |
| Đóng góp trên GitHub | Trên GitHub, cho tới khi bạn hoặc GitHub xóa |
| Lưu trữ trên trình duyệt | Xem mục 3.1 |
| Cookie xác minh `__Host-fig_gate` | **48 giờ** (mục 3.2) |
| Cookie `CF_Authorization` (chỉ Người duy trì) | Trong thời gian của phiên Cloudflare Access |
## 6. Cơ sở pháp lý
### 6.1 Việt Nam
Người duy trì xử lý dữ liệu cá nhân theo **Luật Bảo vệ dữ liệu cá nhân số 91/2025/QH15** của Việt Nam (được thông qua ngày 26/6/2025, có hiệu lực từ ngày 01/01/2026) và các văn bản hướng dẫn thi hành. Dự án xử lý ít dữ liệu cá nhân nhất có thể, và chỉ cho các mục đích nêu ở mục 2.
Khi Luật này yêu cầu sự đồng ý của bạn, bạn thể hiện sự đồng ý bằng một hành động rõ ràng: chấp nhận Chính sách này tại màn hình xác nhận pháp lý (legal gate) ở lần truy cập đầu tiên, và, đối với những gì bạn tự nhập, gửi biểu mẫu Suggest hoặc gửi email. Bạn có thể rút lại sự đồng ý bất kỳ lúc nào (mục 7). Việc rút lại không ảnh hưởng tới việc xử lý đã được thực hiện trước đó.
### 6.2 EU/EEA và Vương quốc Anh
Nếu bạn ở EU/EEA hoặc Vương quốc Anh, GDPR hoặc UK GDPR áp dụng cho việc xử lý dữ liệu cá nhân của bạn, trên các cơ sở pháp lý sau:
| Hoạt động xử lý | Cơ sở pháp lý |
|---|---|
| Phân phối và bảo mật Website cùng dữ liệu mà các Ứng dụng tải về (dữ liệu request, log máy chủ, giới hạn tần suất, Turnstile, cookie bảo mật) | Lợi ích hợp pháp (Điều 6(1)(f)): vận hành một dịch vụ hoạt động tốt, an toàn và ngăn chặn lạm dụng |
| Thống kê truy cập tổng hợp | Lợi ích hợp pháp: hiểu cách trang được sử dụng nói chung, không theo dõi từng cá nhân |
| Đề xuất và hàng chờ duyệt | Lợi ích hợp pháp: xử lý đề xuất mà bạn chọn gửi và chọn lọc Danh mục |
| Dữ liệu game công khai về nhà sáng tạo | Lợi ích hợp pháp: giúp mọi người khám phá game miễn phí bằng thông tin mà nhà sáng tạo đã công bố trên itch.io. Bạn có thể phản đối bất kỳ lúc nào (mục 7) |
| Email và yêu cầu gỡ game | Lợi ích hợp pháp: trả lời bạn và xử lý yêu cầu của bạn |
| Lưu trữ trên trình duyệt (mục 3.1) | Thật sự cần thiết cho các tính năng bạn dùng; không cần sự đồng ý theo quy định ePrivacy hoặc PECR |
## 7. Quyền của bạn và cách thực hiện
### 7.1 Quyền của bạn
Tùy theo luật áp dụng cho bạn, bao gồm Luật số 91/2025/QH15 và, tại EU/EEA và Vương quốc Anh, GDPR hoặc UK GDPR, bạn có quyền:
- được biết dữ liệu cá nhân của bạn được xử lý như thế nào (chính là Chính sách này);
- truy cập dữ liệu cá nhân mà Dự án đang giữ về bạn;
- chỉnh sửa dữ liệu nếu dữ liệu không chính xác;
- yêu cầu xóa dữ liệu;
- phản đối việc xử lý, bao gồm việc xử lý dựa trên lợi ích hợp pháp;
- rút lại sự đồng ý khi việc xử lý dựa trên sự đồng ý;
- khiếu nại tới cơ quan giám sát: cơ quan có thẩm quyền về bảo vệ dữ liệu cá nhân tại Việt Nam, hoặc cơ quan bảo vệ dữ liệu của quốc gia EU/EEA nơi bạn ở hoặc của Vương quốc Anh.
Theo GDPR và UK GDPR, bạn cũng có thể yêu cầu hạn chế việc xử lý, hoặc nhận bản sao dữ liệu ở định dạng có thể chuyển giao (portable), khi các quyền đó được áp dụng.
### 7.2 Cách gửi yêu cầu
- Gửi email tới **privacy@poli0981.dev**. Hãy nói rõ bạn muốn gì và cung cấp đủ chi tiết để tìm được dữ liệu: ví dụ URL game bạn đã đề xuất và khoảng thời gian gửi, hoặc địa chỉ email bạn đã dùng để viết thư. Người duy trì có thể hỏi thêm để xác nhận yêu cầu đúng là của bạn.
- Mục tiêu là trả lời trong vòng **30 ngày**; nhiều yêu cầu được xử lý sớm hơn nhiều. Việc gửi yêu cầu là miễn phí.
- Nhà sáng tạo muốn gỡ game hoặc sửa dữ liệu game cũng có thể gửi email tới **takedown@poli0981.dev** hoặc mở issue ["Remove a game"](https://github.com/poli0981/free-games-itchio-list/issues/new?template=remove_game.yml) (công khai). Mục tiêu cho việc gỡ là trong vòng 7 ngày. Quy trình gỡ được mô tả trong [Điều khoản sử dụng](ToS.md).
### 7.3 Những giới hạn nên biết
- Dự án không lưu địa chỉ IP và không có tài khoản, nên không thể liên kết các lượt truy cập Website với bạn. Dữ liệu bảo mật và log của Cloudflare chỉ được giữ trong thời gian ngắn (mục 5).
- Lưu trữ trên trình duyệt nằm trong tầm kiểm soát của bạn: bạn có thể tự xem và xóa (mục 3.1).
- Lịch sử Git của Repository công khai giữ các phiên bản trước của Danh mục. Người duy trì không thể viết lại lịch sử công khai, trừ trường hợp đặc biệt có yêu cầu pháp lý bắt buộc. Các bản sao mà người khác đã tạo (fork, dữ liệu đã tải về) nằm ngoài tầm kiểm soát của Người duy trì.
- Nội dung trên GitHub (issue, bình luận) được quản lý qua GitHub; bạn có thể sửa hoặc xóa bình luận của mình tại đó.
## 8. Trẻ em
- Dự án không hướng tới trẻ em dưới 16 tuổi. Màn hình xác nhận pháp lý yêu cầu mọi người truy cập xác nhận mình đủ 16 tuổi trở lên.
- Nội dung người lớn (18+) bị ẩn theo mặc định, kể cả ảnh bìa. Nội dung này chỉ hiện ra nếu người truy cập tự bật trong Settings sau khi xác nhận mình đủ 18 tuổi trở lên. Lựa chọn đó chỉ được lưu trong trình duyệt của họ (`webapp.prefs`). Cờ `nsfw` chỉ là nhãn được gắn ở mức cố gắng tốt nhất (xem [Tuyên bố miễn trừ trách nhiệm](DISCLAIMER.md)).
- Người duy trì không cố ý thu thập dữ liệu cá nhân của trẻ em dưới 16 tuổi. Nếu bạn cho rằng một trẻ em đã gửi dữ liệu cá nhân (ví dụ trong ghi chú Suggest hoặc qua email), cha mẹ hoặc người giám hộ có thể viết tới **privacy@poli0981.dev** và dữ liệu đó sẽ được xóa.
## 9. Chuyển dữ liệu ra nước ngoài
- Người duy trì ở Việt Nam. Email bạn gửi và dữ liệu trong hàng chờ duyệt được Người duy trì xử lý từ Việt Nam.
- Cloudflare xử lý dữ liệu trên mạng lưới toàn cầu của họ, Google lưu email của Người duy trì trong các trung tâm dữ liệu của họ, và GitHub hoạt động ở phạm vi quốc tế, nên dữ liệu của bạn có thể được xử lý bên ngoài quốc gia của bạn, kể cả ở những nước có luật bảo vệ dữ liệu khác với nơi bạn sống. Các nhà cung cấp này mô tả các biện pháp bảo vệ họ áp dụng cho việc chuyển dữ liệu quốc tế trong chính sách quyền riêng tư và điều khoản xử lý dữ liệu của họ (link ở mục 4).
## 10. Bảo mật
- Website chỉ được phục vụ qua HTTPS.
- Truy cập tự động phải qua bước kiểm tra Cloudflare Turnstile trước khi các trang và ảnh bìa của Website được tải (mục 2.1).
- Tối thiểu hóa dữ liệu: không tài khoản, mã nguồn của Dự án không lưu địa chỉ IP, ghi chú Suggest bị xóa sau 180 ngày.
- Khu vực quản trị được bảo vệ bằng Cloudflare Access, và mã máy chủ của Website tự xác minh token Access ở mọi request được bảo vệ.
- Các thông tin bí mật (như private key của GitHub App) được giữ trong kho lưu trữ bí mật của Cloudflare, không bao giờ nằm trong Repository. Khu vực quản trị ghi vào Repository dưới danh nghĩa một GitHub App, với các commit đã được xác minh (verified).
- Content Security Policy chặt chẽ chỉ cho phép script từ chính Website, cộng với Cloudflare Web Analytics và Turnstile.
- Các GitHub Actions được ghim theo commit SHA cụ thể với quyền tối thiểu cần thiết, và Dependabot giữ cho các dependency luôn được cập nhật.
- Không hệ thống nào an toàn tuyệt đối. Nếu bạn phát hiện lỗ hổng, vui lòng báo cáo riêng tư theo hướng dẫn trong [Chính sách bảo mật (Security Policy)](SECURITY.md) hoặc qua **security@poli0981.dev**. Nếu xảy ra sự cố vi phạm dữ liệu cá nhân, Người duy trì sẽ thông báo cho những người bị ảnh hưởng và cơ quan chức năng theo yêu cầu của pháp luật.
## 11. Thay đổi Chính sách này
- Người duy trì có thể cập nhật Chính sách này. Các phiên bản mới được công bố trong Repository kèm ngày `Cập nhật lần cuối` ở đầu văn bản, và các thay đổi quan trọng được ghi trong [CHANGELOG.md](../../../CHANGELOG.md). Các phiên bản trước vẫn còn trong lịch sử của Repository.
- Khi một thay đổi cần bạn chấp nhận lại, màn hình xác nhận pháp lý trên Website và trong các Ứng dụng sẽ yêu cầu bạn xem và chấp nhận các văn bản đã cập nhật trước khi tiếp tục.
## 12. Liên hệ
Cả năm địa chỉ dưới đây đều tới hộp thư riêng của Người duy trì (Google Workspace, tên miền poli0981.dev).
- **privacy@poli0981.dev**: câu hỏi về quyền riêng tư và yêu cầu liên quan đến dữ liệu của bạn (mục tiêu trả lời: trong vòng 30 ngày).
- **takedown@poli0981.dev**: gỡ game hoặc sửa dữ liệu game, bao gồm khiếu nại bản quyền.
- **security@poli0981.dev**: lỗ hổng bảo mật (hoặc tính năng báo cáo lỗ hổng riêng tư của GitHub; xem [Chính sách bảo mật (Security Policy)](SECURITY.md)).
- **legal@poli0981.dev**: mọi vấn đề pháp lý khác.
- **contact@poli0981.dev**: câu hỏi chung không thuộc các mục trên.
Với những câu hỏi không cần riêng tư, bạn cũng có thể mở issue trong Repository; issue là công khai. Các kênh liên lạc khác của Người duy trì có tại <https://poli0981.dev/links/>.
## 13. Lời cuối
Một danh sách game miễn phí thì chẳng cần tới dữ liệu của bạn, nên Dự án gần như không đụng tới nó: không tài khoản, không quảng cáo, không cookie theo dõi, không bán gì cả. Chút dữ liệu ít ỏi còn lại được giữ ngắn nhất có thể và bị xóa khi không còn cần. Cứ thoải mái mà duyệt game.
+92
View File
@@ -0,0 +1,92 @@
# Chính sách bảo mật (Security Policy)
Cập nhật lần cuối: 2026-10-16
Áp dụng từ: khi phát hành phiên bản 4.0.0.
> Bản dịch từ bản tiếng Anh cập nhật ngày 2026-09-18 (English source revision 2026-09-18). Nếu có khác biệt, bản tiếng Anh được ưu tiên. Bản gốc: [`SECURITY.md`](../../../SECURITY.md).
Chào bạn — đây là một dự án sở thích do một người vận hành, poli0981 (SkullMute), dưới đây gọi là "Người duy trì": một danh mục được tuyển chọn gồm các game itch.io miễn phí. Từ v4, dự án gồm một **website chỉ đọc** tại https://freeitchgames.win (chạy trên một Cloudflare Worker), một **pipeline dữ liệu Python** trên GitHub Actions, và các **ứng dụng desktop và Android chỉ đọc**. Không có tài khoản công khai, không đăng nhập và không thanh toán; lần đăng nhập duy nhất là trang quản trị riêng của Người duy trì, được bảo vệ bởi Cloudflare Access. Bề mặt tấn công nhỏ — nhưng nếu bạn tìm thấy lỗ hổng, Người duy trì thực sự muốn được biết.
## 1. Báo cáo lỗ hổng
Vui lòng **đừng** báo cáo lỗ hổng qua issue, discussion, pull request công khai hay trên Discord. Thay vào đó, hãy báo cáo riêng tư:
- **Báo cáo lỗ hổng riêng tư trên GitHub** (private vulnerability reporting): tab **Security** của repository → **Report a vulnerability** ([liên kết trực tiếp](https://github.com/poli0981/free-games-itchio-list/security/advisories/new)), hoặc
- email tới **security@poli0981.dev**.
Một báo cáo tốt nên có:
- thành phần bị ảnh hưởng (URL hoặc endpoint, workflow, hoặc phiên bản ứng dụng và nền tảng);
- các bước tái hiện, hoặc một proof of concept chạy được;
- tác động mà bạn cho là lỗ hổng có thể gây ra;
- bạn có muốn được ghi công không, và ghi công theo cách nào.
## 2. Phạm vi
**Trong phạm vi**
- Website https://freeitchgames.win và Cloudflare Worker của nó, bao gồm proxy ảnh (`/img`), API Suggest (`/api/suggest`), cùng ứng dụng và API quản trị (`/admin`, `/api/admin`).
- Pipeline dữ liệu (`scripts/`) và các workflow GitHub Actions (`.github/workflows/`).
- Các ứng dụng desktop và file APK Android được phát hành trên [GitHub Releases](https://github.com/poli0981/free-games-itchio-list/releases).
- Dữ liệu được công bố (`data_game/`, `scripts/deleted_games.json` và https://freeitchgames.win/data) — ví dụ: một cách đưa nội dung vào catalog mà không cần Người duy trì phê duyệt.
**Ngoài phạm vi**
- Bản thân itch.io — hãy báo cho itch.io.
- Lỗi nền tảng của Cloudflare hoặc GitHub — hãy báo cho họ qua chương trình riêng của họ.
- Các game được liên kết trong catalog. Một game chứa mã độc không phải là lỗ hổng của dự án này, nhưng vẫn xin hãy báo cho Người duy trì qua **takedown@poli0981.dev** để game đó được gắn cờ hoặc gỡ bỏ.
- Tấn công từ chối dịch vụ theo lưu lượng (DoS/DDoS) và kiểm thử tải.
- Báo cáo từ công cụ quét tự động mà không có proof of concept chạy được.
Tiện ích trình duyệt (poli0981/itch-f2p-extension) và Telegram bot (poli0981/telegram-scraper-bot) đã được lưu trữ (archive) và không còn được hỗ trợ, nên nằm ngoài phạm vi.
## 3. Phiên bản được hỗ trợ
| Thành phần | Được hỗ trợ |
|---|---|
| Website đang hoạt động (https://freeitchgames.win) | Có |
| Bản phát hành mới nhất (4.x) của ứng dụng desktop và Android | Có |
| Các bản phát hành cũ hơn (gồm toàn bộ 3.x trở về trước) | Không — vui lòng cập nhật |
Bản sửa cho website có hiệu lực ngay khi được deploy. Các ứng dụng không tự cập nhật: bản sửa được phát hành trong một bản release mới, bạn tải về từ GitHub Releases.
## 4. Những gì bạn có thể mong đợi
- **Xác nhận đã nhận báo cáo**: mục tiêu trong vòng **7 ngày**. Đây là dự án sở thích do một người làm, nên đó là mục tiêu chứ không phải cam kết, và thường sẽ sớm hơn nhiều.
- Người duy trì sẽ kiểm tra xem vấn đề có hợp lệ không, xử lý bản sửa, và cập nhật tình hình cho bạn.
- Vui lòng giữ kín chi tiết cho đến khi bản sửa được phát hành, hoặc đến ngày công bố mà bạn và Người duy trì đã thống nhất.
- **Ghi công**: nếu bạn muốn, bạn sẽ được ghi công trong ghi chú phát hành (release notes).
- Không có bug bounty (tài khoản ngân hàng < $50), chỉ có ghi công và lời cảm ơn mãi mãi.
## 5. Bảo vệ cho nghiên cứu thiện chí (safe harbor)
Nếu bạn nghiên cứu bảo mật một cách thiện chí và tuân thủ chính sách này, Người duy trì sẽ coi hoạt động nghiên cứu đó là được phép, sẽ không khởi kiện hay hỗ trợ hành động pháp lý nào chống lại bạn vì nó, và sẽ không coi đó là vi phạm các quy định về truy cập trái phép hoặc sử dụng tự động trong [Điều khoản sử dụng](ToS.md). Để được bảo vệ theo mục này:
- **Tránh xâm phạm quyền riêng tư.** Không truy cập, thay đổi, lưu giữ hay chia sẻ dữ liệu không thuộc về bạn vượt quá mức tối thiểu cần để chứng minh lỗ hổng (ví dụ: ghi chú gửi qua trang Suggest, hàng đợi duyệt, hoặc nhật ký kiểm toán của trang quản trị). Nếu bạn gặp dữ liệu cá nhân, hãy dừng lại và báo cáo.
- **Tránh làm gián đoạn dịch vụ.** Không tấn công từ chối dịch vụ, không quét hay scrape tự động với khối lượng lớn, không spam form Suggest, và không cố làm cạn giới hạn tốc độ (rate limit).
- **Không thay đổi gì cả.** Không sửa hay xóa dữ liệu catalog, hàng đợi duyệt hoặc repository, và không duyệt hay từ chối mục nào, không push commit hay kích hoạt bản phát hành, kể cả khi bạn tìm được cách làm vậy.
- **Không dùng social engineering, phishing hay tấn công vật lý** nhắm vào Người duy trì hoặc bất kỳ ai khác, và không tấn công tài khoản Cloudflare, GitHub hay itch.io của bất kỳ ai.
- **Cho Người duy trì thời gian hợp lý** để sửa lỗi trước khi bạn công bố công khai.
Sự bảo vệ này chỉ bao gồm các khiếu nại của chính Người duy trì. Nó không thể cho phép bạn kiểm thử Cloudflare, GitHub hay itch.io; chính sách riêng của các bên đó sẽ được áp dụng. Nếu không chắc một việc có được phép không, hãy hỏi trước qua **security@poli0981.dev**.
## 6. Bảo mật dependency và chuỗi cung ứng
Những gì repository thực sự làm:
- **Dependabot** ([`.github/dependabot.yml`](../../../.github/dependabot.yml)) được cấu hình để giữ các dependency npm, pip, GitHub Actions và cargo luôn được cập nhật.
- Mọi **GitHub Action của bên thứ ba đều được ghim theo commit SHA đầy đủ**, và mỗi workflow khai báo `permissions` ở mức tối thiểu cần thiết.
- Các thao tác ghi vào repository từ trang quản trị của website đều đi qua một **GitHub App** (commit được xác minh), và trang quản trị nằm sau Cloudflare Access (đăng nhập GitHub hoặc mã PIN dùng một lần qua email) và chỉ dành cho Người duy trì.
- Form Suggest được bảo vệ bằng Cloudflare Turnstile và giới hạn tốc độ.
- File APK Android được ký bằng khóa của dự án. Chỉ cài APK, cũng như các ứng dụng desktop, từ trang [GitHub Releases](https://github.com/poli0981/free-games-itchio-list/releases) của dự án.
Nếu một lỗ hổng đã biết trong dependency thực sự ảnh hưởng tới một thành phần đang chạy (website, Worker, pipeline hoặc các ứng dụng), hãy báo cáo riêng tư như ở [§1](#1-báo-cáo-lỗ-hổng). Nếu đó chỉ là một dependency lỗi thời, không có tác động thực tế, thì mở issue hoặc pull request thông thường là được.
## 7. Lừa đảo và mạo danh
Dự án không có tài khoản và không nhận thanh toán, nên sẽ không ai từ dự án yêu cầu mật khẩu, token hay thông tin thanh toán của bạn. Website chính thức duy nhất là https://freeitchgames.win (địa chỉ github.io cũ chỉ chuyển hướng về đó), và nơi tải chính thức duy nhất là GitHub Releases. Nếu bạn thấy thứ gì đó mạo danh dự án này, vui lòng báo cho Người duy trì qua **security@poli0981.dev**.
## 8. Lời cuối
Hãy giữ an toàn — đặc biệt khi tải các game miễn phí ngẫu nhiên. Cảm ơn bạn đã báo cáo có trách nhiệm. Bạn đã giỏi bảo mật hơn cả Người duy trì rồi đấy. 🚀
+182
View File
@@ -0,0 +1,182 @@
# Điều khoản sử dụng (Terms of Use)
Cập nhật lần cuối: 2026-10-16
Áp dụng từ: ngày 2026-10-13 đối với Website, và từ phiên bản 4.4.0 đối với các Ứng dụng.
Bản dịch từ bản tiếng Anh cập nhật ngày 2026-10-13 (English source revision 2026-10-13). Nếu có khác biệt, bản tiếng Anh được ưu tiên.
Bản tiếng Anh: [`docs/ToS.md`](../../ToS.md).
Các Điều khoản sử dụng này ("Điều khoản") điều chỉnh việc bạn sử dụng website **https://freeitchgames.win**, các ứng dụng desktop và Android, và dữ liệu catalog công khai của `free-games-itchio-list`. Văn bản được viết bằng ngôn ngữ dễ hiểu, nhưng đây là một thỏa thuận thực sự. Điều khoản này thay thế bản Điều khoản cũ và bao gồm cả những gì trước đây nằm trong "EULA" của web app cũ; [EULA](EULA.md) giờ chỉ áp dụng cho các bộ cài ứng dụng và file APK Android.
> **Tóm tắt**: Cứ thoải mái duyệt, chia sẻ, fork code (MIT) và dùng lại dữ liệu kèm ghi nguồn (CC BY 4.0). Đừng scrape hàng loạt website (dữ liệu có sẵn trong repo GitHub), đừng hotlink `/img`, đừng spam form Suggest, đừng mò vào `/admin`, và đừng giả danh itch.io hay Người duy trì. Người làm game có thể yêu cầu gỡ hoặc sửa thông tin game của mình. Nội dung người lớn luôn bị ẩn trừ khi bạn chủ động bật.
## 1. Định nghĩa
- **"Website"**: https://freeitchgames.win, bao gồm các trang và endpoint của nó (như `/data`, `/img`, `/suggest` và `/api/…`). Địa chỉ cũ https://poli0981.github.io/free-games-itchio-list/ chỉ chuyển hướng về đây.
- **"Ứng dụng"**: các ứng dụng desktop (Windows, macOS, Linux) và file APK Android, được build từ cùng một mã nguồn và phân phối trên GitHub Releases. Đây là các ứng dụng chỉ đọc, dùng để xem Danh mục.
- **"Danh mục"** (Catalog): danh sách game và dữ liệu của chúng, gồm `data_game/`, `scripts/deleted_games.json`, và các file được tạo ra từ đó, phục vụ tại https://freeitchgames.win/data.
- **"Repository"**: https://github.com/poli0981/free-games-itchio-list, bao gồm code, dữ liệu, tài liệu, issue và discussion.
- **"Dự án"**: Website, Ứng dụng, Danh mục và Repository nói chung.
- **"Game"**: các game trên itch.io mà Danh mục liệt kê và liên kết tới.
- **"Người duy trì"** (Maintainer): poli0981 (SkullMute), một cá nhân tại Việt Nam vận hành Dự án như một sở thích.
- **"Bạn"**: bất kỳ người nào, hoặc bất kỳ tác nhân tự động nào, sử dụng Dự án.
## 2. Chấp nhận và độ tuổi
- Khi sử dụng Website hoặc Ứng dụng, bạn đồng ý với các Điều khoản này và với các chính sách được dẫn chiếu: [Chính sách quyền riêng tư (Privacy Policy)](PrivacyPolicy.md), [Tuyên bố miễn trừ trách nhiệm (Disclaimer)](DISCLAIMER.md) và, đối với Ứng dụng, [EULA](EULA.md).
- Trong lần truy cập đầu tiên, Website và Ứng dụng hiển thị một màn hình pháp lý (legal gate) liệt kê các văn bản này. Bạn chấp nhận bằng cách đánh dấu vào ô xác nhận và chọn "Chấp nhận & tiếp tục". Nếu bạn từ chối, Website và Ứng dụng sẽ bị khóa; khi đó, vui lòng đừng sử dụng chúng.
- Bạn phải **đủ 16 tuổi trở lên** để sử dụng Website hoặc Ứng dụng; màn hình pháp lý sẽ yêu cầu bạn xác nhận điều này. Để xem nội dung người lớn, bạn phải **đủ 18 tuổi trở lên** (xem mục 8).
- Khi bạn đóng góp qua GitHub (issue, pull request, comment, discussion), các Điều khoản này áp dụng cho đóng góp của bạn, cùng với điều khoản riêng của GitHub và [Quy tắc ứng xử (Code of Conduct)](CODE_OF_CONDUCT.md).
## 3. Dự án là gì (và không phải là gì)
- Một danh mục game miễn phí trên itch.io, được tuyển chọn và cập nhật tự động. Phần lớn dữ liệu của mỗi game được sao chép từ trang itch.io công khai của game đó và được kiểm tra lại theo lịch; chỉ có ba trường (`safe_virus`, `notes`, `nsfw`) do Người duy trì viết.
- Website là **chỉ đọc với tất cả mọi người**: không có tài khoản, không đăng nhập, không bình luận, không quảng cáo và không thanh toán. Khu vực quản trị chỉ dành cho Người duy trì.
- Dự án **không** lưu trữ, bán hay phân phối bất kỳ game nào. Mọi liên kết game đều dẫn tới itch.io, nơi việc tải và chơi game chịu sự điều chỉnh của điều khoản itch.io và điều khoản riêng của từng người làm game.
- Dự án được cung cấp miễn phí, như một sở thích. Không có cam kết mức độ dịch vụ (SLA).
## 4. Những gì bạn được làm
- Duyệt Website và Ứng dụng, và mở các liên kết tới itch.io.
- Chia sẻ liên kết tới Website và tới trang game.
- Tải về và dùng lại dữ liệu Danh mục theo **CC BY 4.0**, kèm ghi nguồn (xem mục 11). Hãy lấy dữ liệu từ Repository (`data_game/` và `scripts/deleted_games.json`, kể cả dạng file raw), và vui lòng cache lại thay vì tải lại mỗi lần có request. Các file tại https://freeitchgames.win/data là định dạng thu gọn riêng của Website và các Ứng dụng, không phải một giao diện công khai; bản JSON đọc được ở đó chỉ được trả cho các phiên bản Ứng dụng cũ.
- Sử dụng, fork, sửa đổi và phân phối lại code theo **Giấy phép MIT**.
- Đề xuất một game itch.io miễn phí trên trang Suggest (xem mục 5).
- Báo bug, gửi góp ý và mở pull request qua các template của Repository.
- Yêu cầu gỡ một game hoặc sửa dữ liệu của game đó (xem mục 7).
## 5. Đề xuất và đóng góp
- **Trang Suggest** (https://freeitchgames.win/suggest): bạn có thể gửi một liên kết game itch.io và một ghi chú tùy chọn dài tối đa 500 ký tự. Trang này dùng Cloudflare Turnstile để chống spam và có giới hạn tần suất (rate limit).
- Ghi chú chỉ Người duy trì xem được và sẽ bị xóa sau 180 ngày. **Đừng đưa dữ liệu cá nhân vào ghi chú.** Xem [Chính sách quyền riêng tư](PrivacyPolicy.md).
- Mọi đề xuất đều vào một **hàng đợi duyệt**. Người duy trì duyệt hoặc từ chối đề xuất tại đó, từng cái một hoặc qua các quy tắc tự động do Người duy trì đặt ra: một đề xuất không có cờ cảnh báo và không bị ai từ chối trong thời gian chờ mà Người duy trì chọn (hiện khoảng một ngày) có thể được duyệt tự động. Người duy trì không có nghĩa vụ phải chấp nhận hay phản hồi một đề xuất. Sau khi được duyệt, liên kết sẽ được pipeline scrape, và game nào hóa ra là game trả phí sẽ bị loại.
- Chỉ những game **thực sự miễn phí** trên itch.io mới đủ điều kiện. Bản demo của game trả phí, game "name your own price" có mức giá tối thiểu lớn hơn 0, và game chỉ miễn phí trong thời gian khuyến mãi thì không.
- Khi gửi bất cứ thứ gì cho Dự án (đề xuất, issue, pull request hay comment), bạn xác nhận rằng:
- đó là sản phẩm của chính bạn, hoặc bạn có quyền chia sẻ nó;
- nó không chứa và không liên kết tới malware, phishing, lừa đảo, doxxing, nội dung vi phạm bản quyền hay nội dung bất hợp pháp;
- bạn không dùng nó để gửi dữ liệu cá nhân của người khác.
- **Vào sao, ra vậy (inbound = outbound)**: đóng góp cho code được cấp phép theo Giấy phép MIT, còn đóng góp cho dữ liệu và tài liệu được cấp phép theo CC BY 4.0, đúng như các giấy phép mà Dự án đang dùng.
- Issue, pull request và comment được công khai trên GitHub dưới tài khoản của bạn.
## 6. Những gì bạn không được làm
Bạn đồng ý **không**:
1. **Scrape hàng loạt** Website hoặc API của nó, kể cả các file trong `/data`. Hãy lấy dữ liệu từ Repository; cách đó tốn ít tài nguyên hơn cho tất cả mọi người.
2. **Lạm dụng image proxy** (`/img`): proxy này chỉ để hiển thị ảnh bìa trên Website. Đừng hotlink các URL `/img` từ website hay ứng dụng khác, và đừng dùng nó để tải ảnh hàng loạt.
3. **Truy cập trái phép các khu vực bị hạn chế**: `/admin` và API quản trị (`/api/admin/…`) chỉ dành cho Người duy trì. Nghiên cứu bảo mật thiện chí luôn được hoan nghênh, theo các quy tắc trong [Security Policy](SECURITY.md).
4. **Spam form Suggest**, hoặc tìm cách vượt qua bước xác minh của Website, Turnstile hay giới hạn tần suất (ví dụ bằng script, dùng chung cookie xác minh hoặc xoay vòng địa chỉ IP).
5. **Gửi liên kết tới malware**, lừa đảo, phishing hoặc nội dung bất hợp pháp, ở bất kỳ đâu trong Dự án.
6. **Mạo nhận liên kết**: đừng tự nhận là Người duy trì hay là Dự án, đừng giới thiệu một bản fork hay bản sao như thể đó là Dự án chính thức, đừng nói rằng Dự án do itch.io vận hành hoặc bảo trợ, và đừng dùng tên "poli0981" hay "SkullMute" để quảng bá sản phẩm của bạn khi chưa có sự cho phép trước bằng văn bản.
7. **Gây gián đoạn Dự án**: đừng tìm cách làm quá tải, phá hỏng hoặc làm suy giảm hoạt động của Website (ví dụ bằng tấn công từ chối dịch vụ), và đừng dùng Dự án để tạo tải bất hợp lý lên itch.io. Nếu bạn tự chạy code pipeline, bạn tự chịu trách nhiệm tuân thủ điều khoản của itch.io và giữ nguyên nhịp giãn cách request của nó.
8. **Gửi yêu cầu gỡ hoặc khiếu nại bản quyền sai sự thật**, hoặc tự nhận là người làm game hay chủ sở hữu quyền khi bạn không phải.
9. **Quấy rối, đe dọa, doxx hoặc giả danh** bất kỳ ai qua bất kỳ kênh nào liên quan tới Dự án (issue, pull request, discussion, Discord, mạng xã hội).
10. Sử dụng Dự án cho bất kỳ mục đích nào trái pháp luật tại nơi bạn ở hoặc tại Việt Nam.
## 7. Gỡ nội dung và bản quyền
Bất kỳ ai cũng có thể yêu cầu gỡ một game khỏi Danh mục hoặc sửa dữ liệu của game đó. Người làm game và chủ sở hữu quyền đặc biệt được hoan nghênh làm điều này.
**Cách yêu cầu**
- Gửi email tới **takedown@poli0981.dev**, hoặc
- mở một [issue "Remove a game"](https://github.com/poli0981/free-games-itchio-list/issues/new?template=remove_game.yml) trong Repository (có sẵn phần khiếu nại bản quyền). Issue trên GitHub là công khai, nên hãy dùng email cho những gì bạn không muốn bị công bố.
**Cần cung cấp**
- URL itch.io của game (hoặc trang của game trên Website);
- bạn là ai: người làm game, chủ sở hữu quyền, hoặc người được ủy quyền thay mặt họ;
- lý do (ví dụ: khiếu nại bản quyền, bạn không muốn game được liệt kê, dữ liệu sai, hoặc game không còn miễn phí). Với khiếu nại bản quyền, hãy nêu rõ nội dung nào (ví dụ phần mô tả hay ảnh bìa) mà khiếu nại nhắm tới.
**Điều gì sẽ xảy ra**
- Người duy trì gỡ bản ghi khỏi Danh mục và ghi lại việc gỡ, kèm lý do, trong danh sách công khai các game đã gỡ (https://freeitchgames.win/removed).
- Các bản sao ảnh bìa đã thu nhỏ lưu trên Cloudflare R2 sẽ bị xóa, và các bản đã cache sẽ hết hạn khỏi cache của Cloudflare.
- Lịch sử Git của Repository công khai vẫn giữ các phiên bản dữ liệu trước đây. Người duy trì không thể viết lại lịch sử công khai, trừ trường hợp đặc biệt có yêu cầu bắt buộc về mặt pháp lý. Những bản sao mà người khác đã tạo (fork, dữ liệu đã tải về) nằm ngoài tầm kiểm soát của Người duy trì.
- Mục tiêu: trong vòng **7 ngày**; các yêu cầu pháp lý khẩn cấp được xử lý sớm hơn. Nếu yêu cầu chưa rõ, Người duy trì có thể hỏi thêm.
## 8. Nội dung người lớn (NSFW)
- Các game được gắn cờ `nsfw: Yes` **bị ẩn theo mặc định**, kể cả ảnh bìa.
- Bạn có thể bật nội dung 18+ trong Cài đặt (https://freeitchgames.win/settings) sau khi xác nhận mình **đủ 18 tuổi trở lên**. Khi bật, bạn cũng xác nhận rằng việc xem nội dung đó là hợp pháp tại nơi bạn ở. Lựa chọn này chỉ được lưu trong trình duyệt của bạn (`webapp.prefs`), và bạn có thể tắt nó bất cứ lúc nào.
- Cờ `nsfw` là nhãn được gắn theo khả năng tốt nhất và có thể sai. Hãy tự kiểm tra trang itch.io trước khi tải nếu điều này quan trọng với bạn.
## 9. Game, an toàn và dịch vụ bên thứ ba
- Các Game thuộc về người làm game và được họ cung cấp thông qua itch.io. Dự án không kiểm soát các Game.
- Dự án **không** quét các file tải về. Trường `safe_virus` là ghi chú thủ công, không phải lời bảo đảm. Hãy coi mọi file tải về là không đáng tin cho tới khi bạn tự kiểm tra. Xem [Tuyên bố miễn trừ trách nhiệm](DISCLAIMER.md).
- Dự án dựa vào các dịch vụ bên thứ ba như itch.io, GitHub và Cloudflare; mỗi dịch vụ có điều khoản và chính sách riêng. [Chính sách quyền riêng tư](PrivacyPolicy.md) giải thích mỗi dịch vụ xử lý những gì.
## 10. Không liên kết với itch.io
Dự án **không liên kết với, không được bảo trợ hay tài trợ bởi itch.io** hoặc Leaf Corcoran / itch corp. "itch.io", tên game, logo và các nhãn hiệu khác thuộc về chủ sở hữu tương ứng và chỉ được dùng để nhận diện game và nền tảng. Xem [NOTICE.md](../../../NOTICE.md).
## 11. Sở hữu trí tuệ và giấy phép
- **Code** (mọi thứ trong Repository không được liệt kê bên dưới, như `scripts/`, `webapp/`, `bash/`, workflow và test): **Giấy phép MIT**, Copyright (c) 2025-2026 poli0981 (SkullMute). Xem [`LICENSE`](../../../LICENSE).
- **Dữ liệu Danh mục** (`data_game/`, `scripts/deleted_games.json`, và các file được tạo ra từ đó tại https://freeitchgames.win/data): **CC BY 4.0** cho phần đóng góp của Người duy trì, cụ thể là việc tuyển chọn và sắp xếp bộ sưu tập, ba trường do Người duy trì viết (`safe_virus`, `notes`, `nsfw`), các bản ghi gỡ game, cùng cấu trúc và số liệu thống kê được tạo ra từ dữ liệu. Xem [`data_game/LICENSE.md`](../../../data_game/LICENSE.md) và toàn văn pháp lý trong [`LICENSES/CC-BY-4.0.txt`](../../../LICENSES/CC-BY-4.0.txt).
- Cách ghi nguồn gợi ý: `Free itch.io games catalog by poli0981 (SkullMute) — https://freeitchgames.win — CC BY 4.0`
- **Không được Dự án cấp phép** (thuộc sở hữu của người khác): mô tả game và mọi văn bản khác do người làm game viết; ảnh bìa, thumbnail và các nội dung đa phương tiện khác; tên game, logo và nhãn hiệu; và các nhãn hiệu của itch.io. Để dùng lại những nội dung này, bạn cần sự cho phép của chủ sở hữu hoặc một ngoại lệ pháp lý áp dụng cho bạn. Các dữ kiện như URL, giá và điểm đánh giá vốn không được bảo hộ quyền tác giả.
- Ảnh bìa hiển thị trên Website là bản sao đã thu nhỏ, chỉ dùng để hiển thị; chúng vẫn thuộc quyền sở hữu của người làm game.
- **Tài liệu** (các file `*.md` ở thư mục gốc của repository và trong `docs/`, bao gồm README và các chính sách này): **CC BY 4.0**.
- **Thành phần bên thứ ba** giữ nguyên giấy phép riêng của chúng. Xem trang About (https://freeitchgames.win/about) và [`docs/THIRD_PARTY.md`](../../THIRD_PARTY.md).
## 12. Không bảo đảm và giới hạn trách nhiệm
- Dự án được cung cấp **"nguyên trạng" ("as is") và "tùy theo khả năng sẵn có" ("as available")**, không kèm bất kỳ bảo đảm nào, kể cả về độ chính xác, tính đầy đủ, tính sẵn sàng, tình trạng miễn phí của game hay độ an toàn. Chi tiết trong [Tuyên bố miễn trừ trách nhiệm](DISCLAIMER.md).
- Trong phạm vi pháp luật cho phép, Người duy trì và những người đóng góp không chịu trách nhiệm cho bất kỳ thiệt hại nào phát sinh từ việc sử dụng Dự án, từ bất kỳ Game hay website bên thứ ba nào truy cập qua Dự án, từ việc ngừng hoạt động, hoặc từ lỗi trong dữ liệu.
- Không điều nào trong các Điều khoản này loại trừ hay giới hạn trách nhiệm mà pháp luật hiện hành không cho phép loại trừ hay giới hạn.
## 13. Thay đổi dịch vụ, kiểm duyệt và chấm dứt
Người duy trì có thể, bất cứ lúc nào và không cần báo trước:
- thay đổi, tạm dừng hoặc ngừng hẳn Website, Ứng dụng hoặc dữ liệu được công bố;
- gỡ hoặc thay đổi bất kỳ nội dung nào (mục game, tài liệu, code);
- từ chối đề xuất, và đóng, khóa hoặc ẩn các issue, pull request hay comment vi phạm các Điều khoản này;
- chặn những người vi phạm các Điều khoản này nhiều lần, và giới hạn hoặc chặn lưu lượng truy cập lạm dụng Website.
Nếu bạn vi phạm các Điều khoản này, quyền sử dụng Website và Ứng dụng của bạn chấm dứt. Mọi quyền bạn đã nhận theo Giấy phép MIT hoặc CC BY 4.0 được điều chỉnh bởi chính các giấy phép đó. Các bản phát hành có tag (`vX.Y.Z`) dự kiến vẫn được giữ trên GitHub Releases, nhưng điều này không được bảo đảm.
## 14. Thay đổi các Điều khoản
- Người duy trì có thể cập nhật các Điều khoản này. Phiên bản mới được công bố trong Repository, kèm ngày `Cập nhật lần cuối` ở đầu văn bản, và các thay đổi quan trọng được ghi trong [CHANGELOG.md](../../../CHANGELOG.md).
- Khi một thay đổi cần bạn chấp nhận lại, giá trị `LEGAL_VERSION` trong Website và Ứng dụng sẽ thay đổi, và màn hình pháp lý sẽ yêu cầu bạn chấp nhận các văn bản đã cập nhật trước khi tiếp tục. Nếu bạn không chấp nhận, vui lòng ngừng sử dụng Website và Ứng dụng.
## 15. Luật áp dụng và giải quyết tranh chấp
- Các Điều khoản này được điều chỉnh bởi pháp luật của **Cộng hòa Xã hội Chủ nghĩa Việt Nam**, không xét đến các nguyên tắc xung đột pháp luật.
- Tranh chấp được giải quyết theo thứ tự sau:
1. **Trao đổi không chính thức trước**: gửi email tới **legal@poli0981.dev**, mở một issue, hoặc dùng một kênh liên hệ được liệt kê trên trang About (https://freeitchgames.win/about) hoặc tại https://poli0981.dev/links/. Hầu hết bất đồng đều dừng ở đây.
2. **Hòa giải**: nếu trao đổi không chính thức không thành, các bên có thể thử hòa giải theo thỏa thuận chung.
3. **Tòa án**: nếu vẫn không được, tòa án có thẩm quyền của Việt Nam sẽ giải quyết.
- **Quyền của người tiêu dùng**: không điều nào trong các Điều khoản này giới hạn các quyền bảo vệ người tiêu dùng mang tính bắt buộc mà bạn có theo pháp luật của quốc gia nơi bạn cư trú, bao gồm mọi quyền mà pháp luật đó cho phép bạn khởi kiện tại tòa án địa phương.
## 16. Tính độc lập của các điều khoản và bản dịch
- Nếu bất kỳ quy định nào trong các Điều khoản này bị coi là vô hiệu hoặc không thể thi hành, các quy định còn lại vẫn giữ nguyên hiệu lực.
- Các bản dịch (như bản tiếng Việt này trong `docs/i18n/vi/`) được cung cấp để thuận tiện cho người đọc. Nếu bản dịch khác với bản tiếng Anh, [bản tiếng Anh](../../ToS.md) được ưu tiên.
## 17. Liên hệ
Các địa chỉ này tới hộp thư riêng của Người duy trì (Google Workspace, tên miền poli0981.dev).
- **legal@poli0981.dev**: các Điều khoản này và mọi vấn đề pháp lý khác.
- **takedown@poli0981.dev**: gỡ nội dung và bản quyền.
- **privacy@poli0981.dev**: câu hỏi và yêu cầu về quyền riêng tư.
- **security@poli0981.dev**: lỗ hổng bảo mật (hoặc dùng tính năng báo cáo lỗ hổng riêng tư của GitHub; xem [Security Policy](SECURITY.md)).
- **contact@poli0981.dev**: câu hỏi chung không thuộc các mục trên.
Các kênh liên lạc khác của Người duy trì có tại <https://poli0981.dev/links/>.
## 18. Lời cuối
Đây vẫn chỉ là một danh sách game miễn phí, cộng thêm một website và vài ứng dụng, được làm bởi một dev mệt mỏi với ngân sách bằng 0 và hai người bạn AI. Cứ "be cool", đừng phá đồ, nhớ ghi nguồn dữ liệu, và vui vẻ săn game miễn phí nhé.
Có câu hỏi? Gửi email tới legal@poli0981.dev, mở một issue, hoặc dùng bất kỳ kênh nào trên trang About. Người duy trì sẽ cố gắng không "ghost".
## 19. Không phải tư vấn pháp lý
Các Điều khoản này là tài liệu của một dự án sở thích, được soạn bởi một người không phải luật sư với sự hỗ trợ của AI. Văn bản này không thay thế cho tư vấn pháp lý chuyên nghiệp.
+224
View File
@@ -0,0 +1,224 @@
# Môi trường phát triển
> Bản dịch từ bản tiếng Anh cập nhật ngày 2026-09-24 (English source revision 2026-09-24). Nếu có khác biệt, bản tiếng Anh được ưu tiên.
> Bản gốc: [`dev_env.md`](../../dev_env.md).
Bộ công cụ Maintainer dùng để viết và kiểm thử code trong repo này, và cách chạy từng phần trên máy.
Bạn không cần cài đặt giống hệt mới đóng góp được — công cụ nào tương thích với các toolchain yêu cầu
đều dùng được. Tài liệu này nhằm giúp tái lập môi trường.
## IDE
JetBrains 2026.x (dòng trả phí):
- **PyCharm** — pipeline Python (`scripts/`, các wrapper trong `bash/`).
- **WebStorm** — `webapp/` (React + TypeScript + Vite, Cloudflare Worker).
- **RustRover** — `webapp/src-tauri/` (shell native Tauri 2).
VS Code, Sublime, vim, v.v. đều dùng tốt; repo không chứa gì đặc thù của JetBrains.
TypeScript 7 (bản `tsc` mà `npm run build` chạy) là binary native, không có `tsserver`. Trong VS Code,
cài extension TypeScript Native Preview (`TypeScriptTeam.native-preview`) để dùng language server của
TS 7. Trong WebStorm, dùng chế độ hỗ trợ TypeScript 7 hoặc trỏ *Languages & Frameworks → TypeScript*
tới `webapp/node_modules/@typescript/old` (TypeScript 6.0, báo cùng các lỗi).
## Toolchain ngôn ngữ
| Stack | Yêu cầu | Dùng cho |
|-------|---------|----------|
| Python | 3.15 (`.github/python-version`) | Pipeline dữ liệu (`scripts/`) và test của nó |
| Node.js | 26+ (CI dùng `webapp/.node-version`) | Web app, admin app, Worker, phần front end của Tauri |
| npm | đi kèm Node.js | Dependency (`npm ci` theo `package-lock.json`) |
| Wrangler | dependency của dự án (`npx wrangler`) | Worker chạy local, D1 local, deploy |
| Rust | stable (qua `rustup`) | Chỉ để build Tauri desktop / Android |
| Git | bản gần đây | Lịch sử repo, commit và tag có chữ ký |
Build Android còn cần Android Studio, SDK / NDK và JDK 17 hoặc 21 — xem
[`webapp/TAURI.md`](../../../webapp/TAURI.md#android-apk).
## Pipeline Python
### Cài đặt
```sh
python -m venv .venv
# kích hoạt: .venv\Scripts\activate (Windows) · source .venv/bin/activate (macOS / Linux)
pip install -r requirements-dev.txt
```
Python 3.15 mặc định đọc và ghi file dưới dạng UTF-8 (UTF-8 mode, PEP 686), nên trên Windows không
cần đặt `PYTHONUTF8=1` nữa.
### Kiểm tra (giống `python-ci.yml`)
```sh
pytest # tests/ — truy cập mạng bị chặn (tests/conftest.py)
ruff check scripts tests webapp/scripts # lint (cấu hình ở pyproject.toml gốc)
ruff format --check scripts tests # định dạng (bỏ --check để áp dụng)
vulture # code chết
python scripts/validate.py # kiểm tra mọi file dữ liệu catalog
```
### Thử scrape thật
Các lệnh này gửi request thật tới itch.io:
```sh
# thêm URL một game vào scripts/temp_link.json, rồi:
python scripts/update_info.py --out patch.json
python scripts/apply_patch.py patch.json
# hoặc kiểm tra lại vài game đã có trong catalog:
python scripts/refresh.py --out patch.json --budget 5
python scripts/apply_patch.py patch.json
```
Các scanner không bao giờ ghi thẳng vào catalog: chúng xuất ra một patch theo URL, và
`apply_patch.py` áp dụng patch đó rồi chạy `validate.py`. Chạy local sẽ thay đổi `data_game/`,
`scripts/*.json` và `scripts/state/` trong working tree của bạn — đừng đưa những thay đổi đó vào PR
code; trên `main`, các workflow pipeline cập nhật catalog. Xem [`CLAUDE.md`](../../../CLAUDE.md) để
nắm tổng quan tầng dữ liệu.
## Web app
```sh
cd webapp
npm ci
npm run dev # app công khai ở http://localhost:5173 có HMR; /data (gói + JSON) dựng từ ../data_game
npm run build # tsc -b + vite build → webapp/dist/ (app, /admin/, /data/pack + JSON cũ, sitemap.xml)
npm run preview # chạy bản build production (không có Worker)
```
Ảnh bìa (`/img`), form Suggest (`/api/suggest`) và API admin là route của Worker. Vite proxy `/api`
và `/img` sang Worker ở cổng 8787, nên hãy chạy cả Worker (mục tiếp theo); không có Worker thì phần
còn lại của app vẫn chạy nhưng ảnh bìa không tải được.
## Worker (local)
Trong terminal thứ hai:
```sh
cd webapp
npm run build # Worker phục vụ dist/ làm static assets
npx wrangler d1 migrations apply freeitchgames --local # tạo database review queue local
npx wrangler dev # http://localhost:8787 (giống npm run cf:dev)
```
Vẫn dùng http://localhost:5173 cho app; http://localhost:8787 phục vụ bản build gần nhất, nên hãy
build lại khi muốn nó hiện thay đổi của bạn. Mọi thứ chạy local (workerd); dữ liệu D1, R2 và cache
local nằm trong `webapp/.wrangler/` (đã gitignore — xóa thư mục này để làm lại từ đầu). Chạy lại lệnh
migrations sau khi thêm file vào `worker/migrations/` (không bao giờ sửa một migration đã được áp
dụng).
### `.dev.vars`
Cấu hình local đặt trong `webapp/.dev.vars` (định dạng dotenv, đã gitignore). Giá trị ở đây cũng ghi
đè các `vars` trong `wrangler.jsonc` khi chạy local. Một file điển hình:
```ini
DEV_ADMIN_EMAIL=you@example.com
SITE_ORIGIN=http://localhost:5173
TURNSTILE_SITEKEY=1x00000000000000000000AA
TURNSTILE_SECRET=1x0000000000000000000000000000000AA
# Chỉ khi muốn thử cổng xác minh qua `npx wrangler dev` (http://localhost:8787):
# GATE_SECRET=<32+ ký tự ngẫu nhiên, ví dụ `openssl rand -hex 32`>
```
| Key | Loại | Tác dụng |
|---|---|---|
| `DEV_ADMIN_EMAIL` | chỉ local, tùy chọn | Vào admin mà không cần Cloudflare Access. Chỉ có hiệu lực khi host là `localhost`, `127.0.0.1` hoặc `[::1]`; bị bỏ qua ở mọi nơi khác |
| `ADMIN_EMAILS` | secret | Danh sách email admin (phân cách bằng dấu phẩy), được kiểm tra sau Access. Không cần khi chạy local với `DEV_ADMIN_EMAIL` |
| `TURNSTILE_SECRET` | secret | Form Suggest và cổng xác minh, đi cùng var `TURNSTILE_SITEKEY` |
| `GATE_SECRET` | secret | Ký cookie của cổng xác minh (32+ ký tự). Thiếu nó thì cổng tắt. Khi chạy local, đặt `SITE_ORIGIN=http://localhost:8787` và mở site qua `wrangler dev`; ở đó cookie tên `fig_gate` (không có `Secure`) |
| `GATE_BOT_TOKEN` | secret | Giá trị mà Transform Rule của zone gửi kèm cho bot đã xác minh (32+ ký tự). Bắt buộc trên production, không cần trên localhost |
| `GH_APP_PRIVATE_KEY` | secret | Private key của GitHub App cho các thao tác ghi của admin — file PEM đúng như GitHub tải về (PKCS#1) hoặc PKCS#8, đi cùng var `GH_APP_ID` và `GH_APP_INSTALLATION_ID` |
| `SITE_ORIGIN` | ghi đè var | Form Suggest và cổng xác minh chỉ nhận POST có `Origin` trùng với giá trị này |
Tính năng nào thiếu cấu hình sẽ trả về `503`; trang công khai không cần cấu hình nào trong số này.
Hai giá trị Turnstile ở trên là test key luôn-thành-công của Cloudflare
([Turnstile testing](https://developers.cloudflare.com/turnstile/troubleshooting/testing/)); không bao
giờ dùng chúng trên production. `npm run cf:types` bỏ qua `.dev.vars` (nó đọc file rỗng `types.env`),
nên secret local không bao giờ lọt vào `worker-configuration.d.ts` được commit.
### Form Suggest
Với file ở trên, D1 local đã migrate và cả hai server đang chạy, http://localhost:5173/suggest sẽ gửi
đề xuất vào review queue local.
### Admin
Khi đã đặt `DEV_ADMIN_EMAIL`, mở http://localhost:5173/admin/ (Vite, hot reload) hoặc
http://localhost:8787/admin/ (bản đã build, giống production). Không có cấu hình GitHub App thì admin
chỉ đọc: các thao tác ghi vào repo trả về `503`. Khi đặt `GH_APP_ID`, `GH_APP_INSTALLATION_ID` và
`GH_APP_PRIVATE_KEY`, việc duyệt và chỉnh sửa sẽ thành **commit thật** vào repo `GITHUB_REPO` (mặc
định là repo công khai) — hãy trỏ `GITHUB_REPO` sang một bản fork đã cài App của bạn.
### Cron (khám phá qua RSS)
```sh
npx wrangler dev --test-scheduled
# rồi mở http://localhost:8787/__scheduled
```
Lệnh này chạy `scheduled()` một lần: nó đọc **một feed RSS thật của itch.io** vào queue local, rồi làm
các việc bảo trì queue. Hãy dùng hạn chế.
## Kiểm tra web app (giống `webapp-ci.yml`)
```sh
cd webapp
npm run cf:types -- --check # worker-configuration.d.ts khớp với wrangler.jsonc
npm run lint # ESLint
npm run knip # file / export / dependency không dùng
npm test # Vitest: app + Worker; test D1 khởi động một workerd local
npx tsc -b # chỉ kiểm tra kiểu (npm run build cũng chạy bước này)
npm run build
npx wrangler deploy --dry-run --env="" # kiểm tra cấu hình Worker, không deploy gì
```
Sau khi sửa `wrangler.jsonc`, chạy `npm run cf:types` và commit file `worker-configuration.d.ts` vừa
được tạo lại.
## App desktop và Android (Tauri)
```sh
cd webapp
npm run tauri:dev # cửa sổ native + HMR
npm run tauri:build # bộ cài native
```
Các app đọc các gói catalog trực tiếp từ https://freeitchgames.win/data/pack và tải ảnh bìa từ
`img.itch.zone`, nên cần internet nhưng không cần Worker local (code đổi định dạng gói chỉ chạy được trong
`tauri:dev` khi website có định dạng đó đã được deploy). Yêu cầu theo nền tảng (WebView2 trên Windows 10, Xcode
CLT trên macOS, `libwebkit2gtk-4.1-dev` trên Debian/Ubuntu) và cách build Android có trong
[`webapp/TAURI.md`](../../../webapp/TAURI.md).
## Test trên mobile
Thay đổi UI web đụng tới layout responsive, điều hướng hoặc bảng dữ liệu phải được smoke-test trên
thiết bị iOS thật trước khi tag release; APK Android được duyệt trên các thiết bị Android. Xem
[`pc_spec.md`](pc_spec.md) để biết các thiết bị test.
## Deploy (Maintainer)
Cloudflare Workers Builds deploy mỗi lần push lên `main` (thư mục gốc `webapp`, build
`npm run build`, deploy `npx wrangler deploy`). Migration D1 được áp dụng thủ công
(`npx wrangler d1 migrations apply freeitchgames --remote`), secret được đặt bằng
`npx wrangler secret put <NAME>`, và `npx wrangler deploy --env staging` deploy Worker staging.
Chi tiết: [`webapp/README.md`](../../../webapp/README.md#deploy-web).
## Git hygiene
- Chỉ tag release từ `origin/main` (xem
[quy trình release](../../../CLAUDE.md#release--tag-process)).
- Commit và tag release của Maintainer được ký trên máy local (`commit.gpgsign=true`, `git tag -s`).
- Không bao giờ commit `webapp/dist/`, `webapp/.wrangler/`, `webapp/.dev.vars`,
`webapp/src-tauri/target/`, `webapp/src-tauri/gen/`, keystore Android, hay bất kỳ secret nào (key
của GitHub App, secret Turnstile, token Access). `webapp/src-tauri/Cargo.lock` **có** được commit.
## Xem thêm
- [`pc_spec.md`](pc_spec.md) — phần cứng và thiết bị test.
- [`webapp/README.md`](../../../webapp/README.md) — chi tiết web app, Worker và admin.
- [`webapp/TAURI.md`](../../../webapp/TAURI.md) — build Tauri desktop và Android.
- [`CONTRIBUTING.md`](CONTRIBUTING.md) — các cách đóng góp.
+53
View File
@@ -0,0 +1,53 @@
# Cấu hình máy maintainer
Máy duy nhất build, scrape, và test cho repo này. Liệt kê để
reproducibility — nếu output workflow trông lạ, đây là chỗ tạo ra nó.
> Bản tiếng Anh là bản chính thức cho mọi diễn giải kỹ thuật.
> Xem: [`pc_spec.md`](../../pc_spec.md).
## Máy dev (primary)
| Thành phần | Chi tiết |
|------------|---------|
| **OS** | Windows 11 Pro 25H2 Insider Preview (Dev Channel) |
| **Build** | 26300.8376 |
| **CPU** | Intel Core i7-14700KF |
| **GPU** | NVIDIA GeForce RTX 5080 (16 GB VRAM) |
| **RAM** | 32 GB DDR5 |
| **Storage** | 1 TB SSD |
GPU thừa thãi cho repo này — webapp build CPU-bound, scraper I/O-bound.
Liệt kê cho đủ.
## Thiết bị mobile dùng để test webapp
Webapp test thật trên các thiết bị này trước mỗi release tag (DevTools
mobile emulation không thay thế được sign-off):
| Thiết bị | iOS | Trình duyệt |
|---------|-----|------------|
| iPhone 14 Pro | 26.x | Chrome, Brave |
| iPhone 13 Pro Max | 26.x | Chrome, Brave |
Nếu có bug layout xuất hiện trên các máy này, vui lòng kèm tên thiết bị
+ iOS version + browser khi báo issue.
### Android APK (Tauri)
File `.apk` cài tay (`minSdkVersion` 30 / Android 11) được test trên:
| Thiết bị | Android | Ghi chú |
|---------|---------|--------|
| Máy ảo (AVD) | 11 → mới nhất | system image arm64-v8a |
| vivo 1907 | 12 | sign-off máy thật |
`minSdkVersion` 30 nghĩa là chính hệ điều hành từ chối cài trên Android < 11, nên
sàn đã test cũng là phiên bản thấp nhất được ship. Lý do (bảo mật + phạm vi test,
không phải sàn tính năng JS) nằm trong
[`webapp/TAURI.md`](../../../webapp/TAURI.md#why-android-11-api-30).
## Xem thêm
- [`dev_env.md`](dev_env.md) — IDE, toolchain ngôn ngữ, dev workflow.
- [`webapp/TAURI.md`](../../../webapp/TAURI.md) — Tauri 2 desktop build prereqs.
+215
View File
@@ -0,0 +1,215 @@
# Operations runbook (maintainer)
How freeitchgames.win is wired together and how to set it up from scratch. Nothing in this file is
secret: secrets are only ever typed into Cloudflare (`wrangler secret put`) or a local, gitignored
`webapp/.dev.vars`.
## Architecture in one screen
| Piece | Where | What it does |
|---|---|---|
| Worker `free-games-itchio-list` | Cloudflare Workers, custom domain `freeitchgames.win` | Serves the built app + the catalog packs `/data/pack/*` (static assets), the readable `/data/*.json` to apps 4.0–4.1.1 only ([`legacy-data.ts`](../webapp/worker/legacy-data.ts)), `/img` (resized covers), the verification gate (`/api/verify`), `/api/suggest`, `/api/admin/*`, `/admin`, and runs the RSS cron. Config: [`webapp/wrangler.jsonc`](../webapp/wrangler.jsonc). |
| Workers Builds | Cloudflare dashboard → the Worker → Settings → Build | Builds and deploys `main` on every push (data commits included). |
| R2 `freeitchgames-thumbs` | Cloudflare R2 | Resized WebP covers (`w160/…`, `w640/…`). |
| D1 `freeitchgames` | Cloudflare D1 | Review queue, feed state, audit log, automation settings, followed collections ([`webapp/worker/migrations/`](../webapp/worker/migrations); the `idempotency` table of the retired ingest API stays, empty). |
| Access app "Admin" | Cloudflare Zero Trust | Login for `/admin` + `/api/admin/*`. |
| Turnstile widget | Cloudflare Turnstile | The verification gate in front of the web app (action `gate`) and anti-spam on `/suggest` (action `suggest`). |
| Transform Rule "Verified bots skip the gate" | Cloudflare → Rules → Transform Rules | Adds `x-fig-known-bot: <GATE_BOT_TOKEN>` to requests from Cloudflare-verified bots, so search engines and link previews skip the gate (section 1, step 14). |
| GitHub App | GitHub → Settings → Developer settings | The Worker's identity for commits (queue approvals, edits, removals). |
| GitHub Actions | [`.github/workflows/`](../.github/workflows) | Data pipeline (`refresh.yml`, `update.yml`, `force_update.yml`), CI, releases, build monitor. |
| Staging Worker `free-games-itchio-list-staging` | `staging.freeitchgames.win` (whole host behind Access) | Optional pre-release checks, deployed by hand from any branch with `npx wrangler deploy --env staging` (`wrangler.jsonc` → `env.staging`). |
## 1. Cloudflare
Do these once (and again with the `-staging` names for the staging Worker).
1. **Build settings** (Worker → Settings → Build): root directory `webapp`; build command
`npm run build`; deploy command `npx wrangler deploy`; build variable `NODE_VERSION=26` (no
`VITE_CF_BEACON_TOKEN`: the zone injects Web Analytics, step 10). The staging Worker, if you use
it, is deployed by hand (`npx wrangler deploy --env staging`); turn its builds for non-production
branches **off** (otherwise every push to `main` also gets a preview build there).
2. **Domains & routes** (Worker → Settings → Domains & Routes): keep the custom domains
`freeitchgames.win` and `www.freeitchgames.win`; delete any `*freeitchgames.win/*` route; a Redirect
Rule sends `www` to the apex. `workers.dev` and preview URLs stay off (`wrangler.jsonc` sets them;
those hostnames would bypass Access).
3. **R2**: enable R2 for the account in the dashboard first (R2 Object Storage; the free tier still
asks for a payment method), then `cd webapp && npx wrangler r2 bucket create freeitchgames-thumbs`
(and `freeitchgames-thumbs-staging`). A deploy fails while its bucket is missing.
4. **Images → Transformations**: enable for the zone; allowed source origins: `img.itch.zone` only.
5. **D1**: production `freeitchgames` exists (created 2026-09-18 in APAC with
`npx wrangler d1 create freeitchgames`; its id is in `wrangler.jsonc`; `0001_init.sql` applied,
`0002_automation.sql` (4.4: ingest outcomes, settings, followed collections) applied before the 4.4.0 merge).
Staging: `cd webapp && npx wrangler d1 create freeitchgames-staging`, put the printed id in
`env.staging.d1_databases`, then `npx wrangler d1 migrations apply freeitchgames-staging --remote --env staging`.
Apply every new migration by hand (`npx wrangler d1 migrations apply freeitchgames --remote`)
**before** deploying code that needs it.
6. **Zero Trust** (free plan is enough):
- Settings → Authentication: add **GitHub** (OAuth App callback
`https://<team>.cloudflareaccess.com/cdn-cgi/access/callback`) and **One-time PIN**.
- Access → Applications → Self-hosted **"Admin"**: `freeitchgames.win/admin`,
`freeitchgames.win/admin/*`, `freeitchgames.win/api/admin/*`; policy *Allow* → your email(s);
session 24 h. Copy its **AUD** tag.
- 4.4.1 removed the browser extension's ingest API: delete the old self-hosted **"Ingest"** app
(`freeitchgames.win/api/ingest`) and its service token (Access → Service credentials) if they still exist.
- Staging: one self-hosted app covering all of `staging.freeitchgames.win`.
7. **Turnstile**: add a widget (Managed) for `freeitchgames.win` and `staging.freeitchgames.win`. The
same widget serves the verification gate (action `gate`) and the Suggest form (action `suggest`);
the Worker checks the token, the hostname and the action, so a token from one can't be used for
the other.
8. **Fill in `wrangler.jsonc` vars** (not secret) and commit: `ACCESS_TEAM_DOMAIN`
(`https://<team>.cloudflareaccess.com`, no trailing slash), `ACCESS_AUD_ADMIN`, `GH_APP_ID`, `GH_APP_INSTALLATION_ID`, `TURNSTILE_SITEKEY` — in both the top level and
`env.staging`. Then `npm run cf:types`. The production values are filled in (2026-09-18). Change
them in the file, not only in the dashboard: every deploy — so every data commit — replaces the
Worker's plain-text variables with the file's values. Secrets are not affected.
9. **Secrets** (`cd webapp`; add `--env staging` for staging):
```sh
# The Worker converts GitHub's PKCS#1 key itself, so the downloaded .pem works as is:
npx wrangler secret put GH_APP_PRIVATE_KEY < app.private-key.pem
npx wrangler secret put ADMIN_EMAILS # comma-separated
npx wrangler secret put TURNSTILE_SECRET
npx wrangler secret put GATE_BOT_TOKEN # the verification gate, step 14
openssl rand -base64 48 | npx wrangler secret put GATE_SECRET # last: this switches the gate on
```
Until a feature's settings exist it answers 503 (the gate simply stays off); the public site works
without any of them.
10. **Web Analytics**: the site uses the **automatic** setup — the zone injects the beacon into every
HTML response (checked on 2026-09-24), so the build needs no token. Don't also set
`VITE_CF_BEACON_TOKEN`: every page view would count twice. The CSPs of the app, the admin page and
the verification page allow the beacon.
11. **Contact email**: the policies publish `contact@`, `legal@`, `privacy@`, `security@` and
`takedown@poli0981.dev` — aliases of the maintainer's Google Workspace mailbox (MX / SPF / DKIM /
DMARC for poli0981.dev live in that zone's Cloudflare DNS). freeitchgames.win needs no mail setup.
12. **Zone settings**: SSL/TLS Full (strict), Always Use HTTPS, minimum TLS 1.2, TLS 1.3 on; Smart
Tiered Cache; Browser Cache TTL "Respect existing headers"; Rocket Loader and Email Obfuscation
**off** (they rewrite HTML and break the CSP); WAF managed rules on; one rate-limiting rule for
`/api/*`; Bot Fight Mode **off** (it can't be skipped for the apps; the
verification gate covers the web app instead). Keep HSTS
`preload` only if every subdomain (including `staging`) will always be HTTPS.
- Measured 2026-10-03: TLS 1.0/1.1 are refused, TLS 1.3 and HTTP/3 answer, `http://` redirects
(301), and the zone sends `Strict-Transport-Security: max-age=31536000; includeSubDomains;
preload`. The domain is **not** on the browsers' HSTS preload list (hstspreload.org); submitting
it is optional and slow to undo.
- **Smart Tiered Cache** is free, so leave it on, but it barely matters here: static assets (the
app and `/data/pack/*`) have Cloudflare's own tiered asset cache, and `/img` uses the Worker's
Cache API (per data centre, never tiered) plus R2. Only cacheable Worker `fetch()` subrequests
use it — in practice the img.itch.zone fallback fetch. No Region Hint is needed for
`api.github.com` (it shows up as an "origin" because the Worker calls it; those calls aren't
cacheable).
- Don't turn on **Workers Cache** (`cache.enabled` in `wrangler.jsonc`): it bills every
static-asset request as a Worker request and would serve cached `/img` responses without running
the verification gate.
- Compression is automatic (zstd / Brotli / gzip, picked per browser) for JSON and the app files.
The `.bin` packs are deflated at build time and served as `application/octet-stream`, which
Cloudflare does not compress again.
13. **Notifications**: enable the Workers Builds failure notification (independent of
`deploy-status.yml`).
14. **Verification gate** ([`webapp/worker/gate.ts`](../webapp/worker/gate.ts)). A visitor must pass a
Turnstile check before the app shell and `/img` are served; the pass is an HttpOnly cookie good for
`BOT_GATE_TTL_HOURS` (1–168, default 48; lowering it also shortens passes already given out).
`/data`, `/assets`, robots, sitemap, the social image, `/api/*` and `/admin*` stay open, and the
desktop/Android apps are not affected. `BOT_GATE` is `"on"` in `wrangler.jsonc`, but the gate
stays off (fails open) until both secrets below exist. In this order:
1. Check the Workers plan: `/` now runs the Worker too (on the Free plan, Worker-first paths answer
429 once the day's 100,000 requests are used up; `/img` already uses most of them).
2. Generate the bot token (`openssl rand -hex 32`), keep it in your password manager, and
`npx wrangler secret put GATE_BOT_TOKEN` it.
3. Rules → Transform Rules → **Modify Request Header** → create "Verified bots skip the gate":
custom filter `(cf.client.bot)` — or `(cf.client.bot and not cf.verified_bot_category in
{"AI Crawler"})` to keep AI crawlers out — then *Set static* header `x-fig-known-bot` to the token.
4. Check that the header reaches the Worker: add a temporary rule `(ip.src eq <your IP>)` that sets
the same header, then `curl -s https://freeitchgames.win/api/verify` must say `"via":"bot"`.
Delete the temporary rule. If it doesn't say so, stop here and don't set `GATE_SECRET`.
5. `openssl rand -base64 48 | npx wrangler secret put GATE_SECRET` — the gate is on.
6. Smoke test: `curl -sI https://freeitchgames.win/` shows `x-robots-tag: noindex, nofollow` and
`cache-control: no-store` (the verification page); `/img/160/x` answers 403;
`/data/pack/manifest-v1.json` answers 200 with `access-control-allow-origin: *` (the catalog
checks in section 4 cover the rest);
`curl -sI -A 'Googlebot/2.1' https://freeitchgames.win/` answers 503 (only verified bots, via
the rule, get through); a real browser passes and lands on the page it opened; Search Console →
URL Inspection → *Test live URL* renders the real app. Watch Security → Events and Search
Console for a week.
**Off switch:** `npx wrangler secret delete GATE_SECRET` turns the gate off at once, and
data-commit deploys don't bring it back; to keep it off, set `BOT_GATE` to `"off"` in
`wrangler.jsonc`. Staging: set `TURNSTILE_SITEKEY` and `BOT_GATE: "on"` under `env.staging` and add
both secrets with `--env staging`. Locally: put the Turnstile test keys,
`SITE_ORIGIN=http://localhost:8787` and a 32+ character `GATE_SECRET` in `webapp/.dev.vars`, then
`npm run build && npx wrangler dev` (on localhost the cookie is `fig_gate`, without `Secure`, and
no bot token is needed).
## 2. GitHub
1. **GitHub App** (Settings → Developer settings → GitHub Apps → New): name e.g.
`freeitchgames-admin`; webhook **off**; repository permissions **Contents: Read and write**,
**Metadata: Read**; install it on this repository only. Note the App ID and the installation id (the
number in the installation's URL); generate a private key (see step 9 above).
2. **Repository settings**: homepage `https://freeitchgames.win`; private vulnerability reporting on;
Dependabot security updates on; CodeQL default setup and secret scanning if you want them (the
policies don't claim them). Rulesets: target the default branch (block deletion and force
pushes); protect tags `v*`. Merge PRs with squash or a merge commit — never fast-forward.
3. **Secrets**: keep `DISCORD_CI_WEBHOOK`, the release webhooks and the Android keystore secrets.
`GH_TOKEN`, `TELEGRAM_BOT_TOKEN` and the three `DISCUSSION_*` secrets, which no workflow used any
more, were deleted on 2026-10-16.
4. **Signing key**: the old key `03F965C2E2DB5C6B` was exposed; sign with the replacement key.
## 3. Releasing a version
1. Bump the version everywhere it lives: `webapp/src/lib/about.ts` (`APP.version`),
`webapp/package.json` + `package-lock.json` (`npm version X.Y.Z --no-git-tag-version`),
`webapp/src-tauri/tauri.conf.json`, `webapp/src-tauri/Cargo.toml` + `Cargo.lock`, and the version
badges of `README.md` / `README.vi.md`. Write the notes in
`changelog/<major>.x/ver<major>.<minor>.x.md` and add the row to [`CHANGELOG.md`](../CHANGELOG.md).
2. Open a PR; when CI is green, merge it with squash or a merge commit — never fast-forward. A push
that touches the changelog posts to Discussions → General unless the head commit says
`[skip-discuss]` (the release announcement usually covers it).
3. Apply any new D1 migration and set any new secret **before** the merge deploys code that needs them.
4. Tag from `main`: `git fetch origin && git tag -s vX.Y.Z origin/main -m "…"`, then
`git push origin vX.Y.Z`. `release_desktop.yml` opens one draft release and the desktop and Android
jobs upload into it (12 assets for 4.x). Never create the release by hand first.
5. When every asset is there, edit the title and notes (from the changelog), then
`gh release edit vX.Y.Z --draft=false` — that fires the Discord and Discussions announcements.
## 4. Routine
- **Mass-change alert** (Discord, "mass_change=true"): itch.io probably changed its page markup. Look at
a few flagged games on itch.io. If the parser is wrong, fix `scripts/scraper.py`; if the removals
are real, dispatch **Refresh catalog** with `allow_mass_removal`.
- **Removal / takedown request**: `/admin` → Catalog → the game → Remove… (the reason is public; the
presets get a translated label on the Removed page). Several games: tick up to 100 search results, or
paste their URLs under **Remove by list** — one commit either way. A wrongly removed game: Catalog →
Removed → Restore.
- **Review queue**: `/admin` → Review queue. "Approve with override" is needed for games that were
removed before. Selections of any size go out in batches of 200 (one commit each).
- **Adding a list of games**: `/admin` → Add games. Paste any text (or load a file, or read an itch.io
collection), press **Check** to see what Add would do, then **Add**. **Recent batches** follows each
game through the ingest (added / waiting / dropped with the reason); the ingest runs right after each
commit and handles about 650 games per 45-minute run, the rest waits in the queue.
- **Automatic rules**: `/admin` → Settings. Auto-approve (on by default for RSS and Suggest, after 24 h)
queues pending items without a flag that nobody rejected; it only considers items found after the
moment it was switched on ("Include older pending items" lifts that), at most 100 per cron run.
**Followed collections** are read in turn (≤ 30 pages per run, one a second); their new free games
are queued directly, removed or flagged ones go to the review queue. Settings also shows what the
last cron run did (Workers logs are sampled), and a collection whose page could not be read (status
422: itch.io changed its markup) adds nothing until `worker/collections.ts` is fixed.
- **Reviewing new games**: `/admin` → New games (added in the last 7 / 30 days): set 18+ and the virus
check for up to 100 games at once. **Activity** lists every admin action and automatic run with its
commit.
- **Build failed** (Discord from `deploy-status.yml`): open the build log linked in the message; the
site keeps serving the previous deployment meanwhile.
- **New D1 migration**: add `webapp/worker/migrations/000N_*.sql` (never edit applied ones), apply it
to staging and production by hand, then deploy.
- **Catalog delivery** (after a release that touches it, or when the site shows no games):
```sh
B=https://freeitchgames.win/data
curl -sI $B/pack/manifest-v1.json # 200, application/json, max-age=60, ACAO *
H=$(curl -s $B/pack/manifest-v1.json | node -p "JSON.parse(require('fs').readFileSync(0)).chunks[0].main")
curl -sI -H 'Accept-Encoding: br, gzip' $B/pack/$H # 200, octet-stream, no content-encoding, immutable
curl -sI $B/pack/0000000000000000.bin # 404, no-store (answered by the Worker)
curl -sI $B/index.json # 410, vary: Origin (browsers and scripts)
curl -sI -H 'Origin: tauri://localhost' $B/index.json # 200 (apps 4.0–4.1.1)
```
`npx wrangler tail` shows the `legacy-data: 410` lines with the requesting `Origin`: an installed
app that sends an unexpected one would show up there.
- **Verification gate misbehaving** (visitors stuck on the check, crawl errors in Search Console):
`npx wrangler secret delete GATE_SECRET` turns it off at once; then look at `npx wrangler tail` and
`curl -s https://freeitchgames.win/api/verify`.
+50
View File
@@ -0,0 +1,50 @@
# Maintainer hardware spec
The single machine that builds, scrapes, and tests this project. Listed for
reproducibility — if a workflow output looks weird, this is what produced it.
## Developer machine (primary)
| Component | Details |
|-----------|---------|
| **OS** | Windows 11 Pro 25H2 Insider Preview (Dev Channel) |
| **Build** | 26300.8376 |
| **CPU** | Intel Core i7-14700KF |
| **GPU** | NVIDIA GeForce RTX 5080 (16 GB VRAM) |
| **RAM** | 32 GB DDR5 |
| **Storage** | 1 TB SSD |
GPU is overkill for this repo — the webapp build is CPU-bound and the scraper
is I/O-bound. Listed for completeness.
## Mobile devices used for webapp testing
The webapp is tested on these real devices before each release tag (DevTools
mobile emulation is not a sign-off substitute):
| Device | iOS | Browsers |
|--------|-----|----------|
| iPhone 14 Pro | 26.x | Chrome, Brave |
| iPhone 13 Pro Max | 26.x | Chrome, Brave |
If a layout bug ships, it likely also reproduces on these devices — please
include the device + iOS version + browser when filing a mobile-only issue.
### Android APK (Tauri)
The sideloadable `.apk` (`minSdkVersion` 30 / Android 11) is signed off on:
| Device | Android | Notes |
|--------|---------|-------|
| Emulator (AVD) | 11 → latest | arm64-v8a system images |
| vivo 1907 | 12 | real-phone sign-off |
`minSdkVersion` 30 means the OS itself refuses to install on Android < 11, so the
tested floor is also the lowest version we ship to. Rationale (security + tested
range, not a JS-feature floor) is in
[`webapp/TAURI.md`](../webapp/TAURI.md#why-android-11-api-30).
## See also
- [`dev_env.md`](dev_env.md) — IDE, language toolchains, and dev workflow.
- [`webapp/TAURI.md`](../webapp/TAURI.md) — Tauri 2 desktop build prerequisites.
-81
View File
@@ -1,81 +0,0 @@
url,name,dev,description,genre,nsfw,safe_virus,notes,thumbnail,tags
https://torigamedev.itch.io/the-plant-shop,The Plant Shop,Tori,"The Plant Shop is a cozy horror game where you manage a small plant shop. Craft plants, serve late-night customers and grow your plant collection to attract more people. You play as Silvia, a 26 years old girl who decides to open her own small plant shop on a late-night shift because she has a corporate job during the day. Your job is to serv...",Simulation,No,?,,https://img.itch.zone/aW1nLzIzOTAwOTk3LnBuZw==/original/mLtbH1.png,"3D, Cozy, First-Person, Horror, Indie, PSX (PlayStation), Psychological Horror, Retro, shop"
https://king-turtle.itch.io/cursed-overlord,Cursed Overlord [NSFW],King's Turtle,PLOT In this game you play as an ordinary office clerk who is accidentally killed by lightning...,Role Playing,Yes,?,,https://img.itch.zone/aW1nLzEwMTYyMjM2LnBuZw==/original/F%2FB0Du.png,"Adult, Anime, Eroge, Erotic, harem, Hentai, Monster Girls, NSFW, Porn"
https://coveirodev.itch.io/psx-granny,PSX Granny,CoveiroDev,"This is a PS1 Demake of Granny. This fan project was created in just one week, recreating the original Granny game with simple mechanics...",Survival,No,?,,https://img.itch.zone/aW1nLzI0NzMxNDk5LnBuZw==/original/IvN7fy.png,"Demake, First-Person, granny, Horror, PSX (PlayStation), Retro, Scary, Short, Unity"
https://capybaraforce.itch.io/meet-santa,Meet Santa,Capybaraforce,"Did you ever want to meet Santa? Well, now you can! At least if you can win a match of Nutcracker Run! Sir Creakwood is ready to take on any opponent—do you have the skill (or luck) to beat him? Roll your way to victory and burn this old wooden creature. (see more on itch.io)","Adventure, Puzzle",No,?,,https://img.itch.zone/aW1nLzE4OTg2NzA3LmdpZg==/originalm/CykPjB.gif,"3D, Christmas, Comedy, Creepy, Dark, Dark Humor, Horror, Pixel Art, PSX (PlayStation)"
https://wesnoth.itch.io/battle-for-wesnoth,Battle for Wesnoth,Wesnoth,"The Battle for Wesnoth is an open source, turn-based strategy game with a high fantasy theme. (see more on itch.io)",Strategy,No,?,,https://img.itch.zone/aW1nLzY3MTA1OTIucG5n/original/Bj%2B%2BQD.png,"2D, DRM Free, Fantasy, Open Source, Pixel Art, Turn-based Strategy"
https://night-asobu.itch.io/parasite-in-love,Parasite in Love,Night Asobu,"Parasite in Love A biological romance horror visual novel Infected with the parasite commonly known as the “brain eating amoeba”, you have 10 days left before your death. (see more on itch.io)","Visual Novel, Interactive Fiction",No,?,,https://img.itch.zone/aW1nLzEwMDI0MDYxLmdpZg==/originalm/0RuFNu.gif,"2D, Creepy, Female Protagonist, Horror, parasite, Psychological Horror, Romance, Story Rich, Yandere"
https://studio77dev.itch.io/speedkidd,SPEED KIDD,Studio77Dev,"Speed Kidd is a retro racing game for the Game Boy where you participate in the World Tour, a championship that will take you across 12 different tracks (both real and fictional) around the world i... (see more on itch.io)","Racing, Action",No,?,,https://img.itch.zone/aW1nLzI0NjczNzQ1LnBuZw==/original/zIi5TJ.png,"8-Bit, chiptune, Game Boy, Game Boy ROM, Pixel Art, Retro, Speedrun"
https://azurextwilight.itch.io/low-effort-romance,Low Effort Romance,Unknown,IMPORTANT: The above is a WEB DEMO. (see more on itch.io),Visual Novel,No,?,,https://img.itch.zone/aW1nLzI0NzQwNTUzLnBuZw==/original/ExdzFr.png,"Amare, Christmas, Comedy, Cozy, Female Protagonist, josei, Otome, Romance, Story Rich"
https://fireblaze236.itch.io/autopede,Autopede,FireBlaze236,Race through the streets using your quadruped/biped car. (see more on itch.io),"Racing, Action",No,?,,https://img.itch.zone/aW1nLzI0NzQxMDQzLnBuZw==/original/b%2F9oyz.png,"Arcade, cars, Fast-Paced, Indie, Pixel Art, Singleplayer, Sprites"
https://jellyworldgames.itch.io/cozy-christmas,Cozy Christmas,Jellyworld Games,Santa’s gifts are lost! Join a little elf in this fun holiday adventure to find and open all the hidden presents. (see more on itch.io),Adventure,No,?,,https://img.itch.zone/aW1nLzI0NzkyMTU2LnBuZw==/original/ulVEyb.png,"2D, Casual, Christmas, Cozy, Pixel Art, santa-claus, Top-Down, Top Down Adventure"
https://newc-42.itch.io/squared-adventure,Squared Adventure,Newc42,"Squared Adventure Hi! I created this game a few years ago, and although it looks like a  poor asset flip made by a high school student, it turned out to be pretty good in the end. (see more on itch.io)","Platformer, Adventure",No,?,,https://img.itch.zone/aW1nLzI0ODEyODc4LnBuZw==/original/gTOR2k.png,"2D, 8-Bit, Indie, No AI, Pixel Art, Retro, Short, Singleplayer"
https://bastienbegue.itch.io/grand-manoir,Grand Manoir,BastienBegue,"[Horror game] In a world ravaged by the arrivals of mysterious creatures during the great war, you are living in a dystopia in Europe during the 1940's where you need to live constantly in a light ... (see more on itch.io)",Adventure,No,?,,https://img.itch.zone/aW1nLzI0NjMxMTYxLnBuZw==/original/n6ZzcC.png,"3D, Dark, Dystopian, Horror, Indie, Sci-fi, Singleplayer"
https://ryan-goodyear.itch.io/rainwaze,Railwaze,Ryan Goodyear,Defeat the boss and its minions to win. (see more on itch.io),"Action, Shooter, Survival",No,?,,https://img.itch.zone/aW1nLzI0ODEzMTYyLnBuZw==/original/VyBKMj.png,"3D, Boss battle"
https://junior17.itch.io/demidreamer,Demidreamer,Jannick Jade Elfers,"Träume, forsche und. (see more on itch.io)",Visual Novel,No,?,,https://img.itch.zone/aW1nLzEyOTk0NTM2LnBuZw==/original/6A8DAF.png,"2D, LGBT, Multiple Endings, Narrative, Queer, Ren'Py, Singleplayer, Text based, Transgender"
https://foxhoundproductions.itch.io/custodian,Custodian,FoxhoundProductions,A short fps horror experience I made with Unity in 2 months. (see more on itch.io),Unknown,No,?,,https://img.itch.zone/aW1nLzI0ODEyNjk5LnBuZw==/original/zQgeps.png,"3D, Creepy, First-Person, Horror, Singleplayer, Spooky"
https://lemone2d.itch.io/around-the-world,Around the World alpha,lemone2d,"Content warning: Swearing (lol) After a disappointing experience at your first college, you enroll at Imago Mundi University. (see more on itch.io)",Visual Novel,No,?,,https://img.itch.zone/aW1nLzI0Nzg2MzY3LnBuZw==/original/WxgpQ1.png,"2D, Cute, Dating Sim, Indie, LGBT, No AI, Ren'Py, Romance, Singleplayer"
https://nattougames594.itch.io/orisumass1,オリスマ外伝~ブルーザウルスの冒険~,納豆,これは非公式のファン作品です ブルーザウルスたちが冒険する短編RPGです! 妹であるレッドザウルスの告白を手助けしましょう! (see more on itch.io),Role Playing,No,?,,https://img.itch.zone/aW1nLzI0ODAyOTc3LmpwZw==/original/3lvnFb.jpg,"2D, Fangame"
https://causeitsontapgames.itch.io/crisis-at-the-skydome,Crisis at the Skydome,Cause It's On Tap Games,Pop Pop Pop Welcome to the ultimate arcade balloon-popping challenge. (see more on itch.io),Unknown,No,?,,https://img.itch.zone/aW1nLzI0ODA0MDIwLnBuZw==/original/v4DUIB.png,"Arcade, Casual, High Score"
https://nattougames594.itch.io/irosumarpg,イロスマRPG,納豆,これは非公式のファン作品です RPGツクールVXで初めて作ったゲームをウディタでリメイクしました! 無料高RPGシスMrHの機能のおかげでツクールVXã... (see more on itch.io),Role Playing,No,?,,https://img.itch.zone/aW1nLzI0ODA3NjMxLmpwZw==/original/08qElw.jpg,"2D, Fangame, Remake"
https://hunterelise.itch.io/console-games,C++ Console Games,Elise Hunter,This project contains two C++ console games developed for my Games Programming 1 coursework. (see more on itch.io),Unknown,No,?,,https://img.itch.zone/aW1nLzI0ODAxODY0LmpwZw==/original/Fx7fwK.jpg,"Arcade, No AI"
https://szalkin.itch.io/bomb-game,Bomb Game,Sam Zalkin,Bomb Game is a multiplayer card and party game that tests players ability to strategize quickly. (see more on itch.io),"Card Game, Strategy",No,?,,https://img.itch.zone/aW1nLzI0Njk2NjE2LnBuZw==/original/Vgoo1L.png,"Aseprite, Indie, No AI, party-game"
https://danka-dobric.itch.io/detektiv,Detektiv,Vuk Dobric,"ABOUT: A short horror experience centered on a strange murder, in which you play Detective Fyodor Mikhailovich, investigating the crime and looking for clues to unravel the mystery. (see more on itch.io)",Adventure,No,?,,https://img.itch.zone/aW1nLzI0NTE0Mjg1LnBuZw==/original/KbJa4K.png,"3D, Atmospheric, Creepy, Detective, Fast-Paced, Horror, Indie, Mystery, Short, Singleplayer"
https://meant-to-bee-studios.itch.io/criminally-yours,Criminally Yours,Unknown,"You're the next generation of heroes—""Oracle,"" given to your mother and you for your ability to see glimpses into the future. (see more on itch.io)",Visual Novel,No,?,,https://img.itch.zone/aW1nLzIyNzkwNDY3LnBuZw==/original/Io32%2Fa.png,"Amare, Dating Sim, Indie, No AI, Otome, Romance, Superhero, Yandere, Yaoi"
https://master2015hp.itch.io/heroines-paradox-n-anh-hng,Heroines Paradox - 英雌悖论 - Nữ Anh Hùng,Baby3,"About This Game “Heroines Paradox” is a hybrid Dungeon Crawler and Visual Novel, told through an urban horror narrative reminiscent of Junji Ito’s storytelling style. (see more on itch.io)",Visual Novel,No,?,,https://img.itch.zone/aW1nLzI0ODExODM1LnBuZw==/original/MdANFs.png,"2D, Horror, Psychological Horror, Turn-Based Combat"
https://goranz.itch.io/you-must,You Must,GoranZ,"A short survival-horror zombie game inspired by Resident Evil , combining puzzles, cinematic storytelling, and intense combat against terrifying undead. (see more on itch.io)","Shooter, Puzzle",No,?,,https://img.itch.zone/aW1nLzI0ODEzOTE5LmpwZw==/original/1zUG7m.jpg,"3D, evil, Horror, resident, Zombies"
https://komarusg.itch.io/pofuduk-kacis,Pofuduk Kacis,komarusg,Endless runner game made with free assets and some of my own pixel art. (see more on itch.io),Platformer,No,?,,https://img.itch.zone/aW1nLzI0ODEzODE0LnBuZw==/original/xhxXjs.png,
https://ehn-sabedra.itch.io/turtle-care-simulator,Turtle Care Simulator,Ehn Sabedra,"It's simple, arcade simulator of turtle. (see more on itch.io)",Adventure,No,?,,https://img.itch.zone/aW1nLzI0ODEzNzYzLmpwZw==/original/tTi4sx.jpg,Atmospheric
https://azmel-3d.itch.io/the-pizza-cannon,The Pizza Cannon,Azmel Enriquez,A small 1 level of a basic bullet hell game. (see more on itch.io),"Shooter, Action",No,?,,https://img.itch.zone/aW1nLzI0ODI2NjAwLnBuZw==/original/UEY51c.png,"Bullet Hell, Indie, Top down shooter"
https://droptineart.itch.io/lavender-county,Lavender County,DroptineArt,"Deep down in the dirty south, the down-and-out residents of Lavender County smell somethin' in the spring air. (see more on itch.io)",Visual Novel,Yes,?,,https://img.itch.zone/aW1nLzE5NjQ5NzM2LnBuZw==/original/CeGObX.png,"Adult, country, Dating Sim, Furry, lavender-county, redneck, southern"
https://quiesphere.itch.io/miltf,"Man, I Love Terraria Fishing",quiesphere,"Man, I Love Terraria Fishing is a short Terraria-themed fishing game. (see more on itch.io)",Simulation,No,?,,https://img.itch.zone/aW1nLzI0NzkzOTkyLnBuZw==/original/v6Qzn%2F.png,"2D, Fangame, Fishing, No AI, Pixel Art, RPG Maker, RPG Maker MV, Short, Singleplayer"
https://nano16.itch.io/fight-goblin-fight-2026,戰鬥吧哥布林,Nano16,戰鬥吧哥布林! 遊戲說明 在跨年夜裡,小心不要變成帥潮們的經驗值,擊敗他們並活到2026年吧! 遊戲操作 移動:W S A D、上 下 å·¦ 右 跳躍:Space 攻æ... (see more on itch.io),"Action, Adventure",No,?,,https://img.itch.zone/aW1nLzI0ODU3ODA1LnBuZw==/original/DCnwOR.png,"3D, Singleplayer, Unity"
https://fter.itch.io/before-the-dawn,Before the dawn/在黎明之前,Fter,This is a side-scrolling platformer with action-adventure elements. (see more on itch.io),Adventure,No,?,,https://img.itch.zone/aW1nLzI0ODQwNzMxLnBuZw==/original/mpvaVJ.png,"2D, Pixel Art"
https://huvjnk.itch.io/happy-happy-c8c8,開心星人反抗畢制破財命運,huvjnk,開心星人反抗畢制破財命運 遊戲說明 打倒負債!籌款2026製作畢製的經費! 2026開心星球上的大學生們即將製作畢制並且面臨了要繳畢委會費16000的高額é‡... (see more on itch.io),"Action, Adventure, Role Playing",No,?,,https://img.itch.zone/aW1nLzI0ODU3NTY5LnBuZw==/original/U1BaQu.png,"3D, arpg, money, Singleplayer, Third Person, Unity"
https://jjjjjc.itch.io/i-remember-the-first-time-that-you-held-my-hand,I remember the first time that you held my hand,jjjjjc,"So, when I saw the jam theme (two hands almost touching), it instantly hit me. (see more on itch.io)",Visual Novel,No,?,,https://img.itch.zone/aW1nLzI0ODU2Njk5LnBuZw==/original/68umdw.png,"2D, No AI, poem, retrospective, Sound effects, Story Rich"
https://llama2474.itch.io/overcooked,Overcooked?,llama2474,An overcooked clone made in the open source godot engine as a university project by a couple of guys. (see more on itch.io),"Strategy, Action, Simulation",No,?,,https://img.itch.zone/aW1nLzI0ODU3MTIzLnBuZw==/original/knQa3H.png,"Casual, Cooking, Co-op, Singleplayer"
https://infercode-studio.itch.io/afterjoy,AfterJoy,Infercode studio,No description,Survival,No,?,,https://img.itch.zone/aW1nLzI0ODQyNDgzLnBuZw==/original/psJWiv.png,"FPS, Horror"
https://akane13.itch.io/let-connect,相连 Let Connect,Unknown,相连 Let Connect Let Connect is a short narrative-driven game about human connections across a lifetime. (see more on itch.io),Unknown,No,?,,https://img.itch.zone/aW1nLzI0ODQ1MzE1LnBuZw==/original/akBw1M.png,"2D, Casual, emotional, Narrative, relationship, Relaxing, Short, Singleplayer"
https://for-little-brother.itch.io/lets-roll,Let's Roll,For Little Brother,"Let's Roll ist ein lustiges und kinderfreundliches ""Endless Runner""-Spiel. (see more on itch.io)",Action,No,?,,https://img.itch.zone/aW1nLzI0ODU2MjU3LnBuZw==/original/KaUWE%2B.png,"2D, Cute, Family Friendly, Singleplayer"
https://hx-kani.itch.io/angelshit,Angelshit:天屎降临,HX_kani,不要被寝室阿姨抓住哦!(=^・ェ・^=) 操作方法:关卡①:WASD键控制移动。关卡②:空格跳跃,S键下蹲 (see more on itch.io),Action,No,?,,https://img.itch.zone/aW1nLzI0ODU2ODU2LnBuZw==/original/VMMWHu.png,
https://nazirovsgames.itch.io/the-watching-walls,The watching walls,Nazirovsgames,The watching walls Short indie game horror game about hotel and you. (see more on itch.io),Action,No,?,,https://img.itch.zone/aW1nLzI0ODU2NjE4LnBuZw==/original/z0hdDv.png,Horror
https://reginald14320.itch.io/ciphers-chamber,Cipher's Chamber,Unknown,Agent Spay must puzzle their way through a routine training simulation. (see more on itch.io),Puzzle,No,?,,https://img.itch.zone/aW1nLzI0NDIyMDY2LnBuZw==/original/zhlQMc.png,"3D, Comedy, First-Person, Indie, No AI"
https://kfg-68.itch.io/akaten-kaihi,赤点を回避しろ!,KFG_68,とても短いシンプルなノベルゲームです。 友人と一緒に勉強をして、テストで結果を残せるようにしましょう! It's a very short visual-novel game that I made. (see more on itch.io),Visual Novel,No,?,,https://img.itch.zone/aW1nLzI0ODU2NDk0LnBuZw==/original/syEka1.png,"Ren'Py, Short, Singleplayer"
https://lupro1.itch.io/frost-burn,Frost Burn,Unknown,"CHECK-IN HERE Please download the game at the bottom of the page for the best quality/experience! Play as Arnie , the fiery main character whose last mission is to destroy the final resort atop the... (see more on itch.io)","Action, Platformer",No,?,,https://img.itch.zone/aW1nLzI0ODU0MTU1LmpwZw==/original/ZxjL6B.jpg,"3D, Singleplayer"
https://flaminiop.itch.io/courrier,T'as du courrier !,Flaminiop,Ce jeu est en français / This game is in French ! T'as du courrier ! Mais qui a bien pu t'écrire ? Découvre toutes les possibilités en combinant les mots clefs. (see more on itch.io),"Interactive Fiction, Visual Novel",No,?,,https://img.itch.zone/aW1nLzI0ODQ0NDU2LnBuZw==/original/GXFG04.png,"Casual, french, Godot, No AI, Non violent, Relaxing, Singleplayer, Story Rich, Text based"
https://garula.itch.io/the-freak-circus,The Freak Circus,Garula,《 The Freak Circus ã€‹ Of horrors The Circus of Horrors has arrived in town. (see more on itch.io),Visual Novel,No,?,,https://img.itch.zone/aW1nLzIxNjQxODI1LnBuZw==/original/sIu4WS.png,"circus, Creepy, Dark, Dating Sim, Horror, Monsters, Ren'Py, Yandere"
https://khydra98.itch.io/pokepath,PokéPath TD,Khydra,PokéPath TD is a Pokémon Tower Defense game! Manage your team and defend against waves of enemies across 9 different routes . (see more on itch.io),Strategy,No,?,,https://img.itch.zone/aW1nLzI0MzE2MTUwLnBuZw==/original/L854aH.png,"afk, Anime, Farming, Idle, Pixel Art, pokemon, Singleplayer, Tactical, Tower Defense"
https://blakemckinnonproductions.itch.io/slaybells,Slay Bells,Blake McKinnon Productions,Slay Bells is a Christmas-themed survival horror game inspired by 80's slasher movies and PS1 horror games. (see more on itch.io),Survival,No,?,,https://img.itch.zone/aW1nLzI4MDgyNDEucG5n/original/ovlywA.png,"3D, Atmospheric, Christmas, First-Person, Horror, ps1, Slasher, Survival Horror, Unity, vhs"
https://meownsk.itch.io/danglin-froggo,Danglin’ Froggo,meownsk,"In the mysterious depths of the cave, where light exists only in the reflections of crystals, something dwells. (see more on itch.io)",Platformer,No,?,,https://img.itch.zone/aW1nLzI0ODQ0NTA4LnBuZw==/original/xHOa%2BE.png,"2D, Difficult, Hand-drawn, jumping, Physics, rope-swinging, Tilemap"
https://chelsammi.itch.io/olen-mysterious-forest,Olen': Mysterious Forest,ChelSammi,Olen': Mysterious Forest — an atmospheric adventure where you play as a young deer who has lost its herd in a mysterious forest. (see more on itch.io),"Adventure, Action",No,?,,https://img.itch.zone/aW1nLzI0OTQ5MTQ3LnBuZw==/original/NxwWOq.png,"2D, Animals, Atmospheric, Christmas, Fantasy, Indie, jrpg-maker, Pixel Art, RPG Maker"
https://snowish.itch.io/just-another-morning,Just Another Morning,Casper Ampersand,It's the start of another morning in the life of Gregory Izaak. (see more on itch.io),Visual Novel,No,?,,https://img.itch.zone/aW1nLzI0OTQ4MTc5LnBuZw==/original/wqMZdC.png,"Fantasy, Horror, Point & Click, Psychological Horror"
https://sniper-mks.itch.io/ggx2025-escape-from-seichi,GGX2025_聖地からの解放,shin.mks,このゲームは聖地に囚われた幽霊たちを解放すべく主人公の巫女様が聖地に訪れて幽霊達と対話する新感覚の弾幕アクションゲームです。 幽霊達かã... (see more on itch.io),"Action, Adventure",No,?,,https://img.itch.zone/aW1nLzI0OTQ4MDU0LnBuZw==/original/JNC%2BUV.png,"2D, Creepy, Dark, Female Protagonist, Horror, Meaningful Choices, Unity"
https://patretro.itch.io/4x4-tic-tac-toe,4x4 Tic Tac Toe,patretro,Tic Tac Toe on a 4x4 grid. (see more on itch.io),Unknown,No,?,,https://img.itch.zone/aW1nLzI0OTQ4NDEwLnBuZw==/original/fiFfnV.png,"2D, Cult Classic, Retro, tic-tac-toe"
https://infinvarg.itch.io/make-a-dream-museum,Make a Dream Museum,InfiNVarg,"AVISO Para jugar la versión de navegador, se recomienda activar la aceleración por hardware de tu navegador si no la tienes activada. (see more on itch.io)",Simulation,No,?,,https://img.itch.zone/aW1nLzI0OTQ4OTQ5LnBuZw==/original/uMjmRL.png,"Unity, yo-kai-watch"
https://srcheese44.itch.io/grabbity,Grabbity,Unknown,"Grabbity is a short gravity-shifting platforming adventure game where you control a rabbit collecting carrots in space! On the eve of the annual rabbit festival, a terrible truth is revealed for th... (see more on itch.io)",Platformer,No,?,,https://img.itch.zone/aW1nLzI0OTI0MTE3LmdpZg==/originalm/mJNpnQ.gif,"2D, Cozy, Cute, Gravity, Pixel Art, Puzzle-Platformer, rabbits, Short, Singleplayer, Space"
https://rudolfgalley.itch.io/cyber-rebellion,Cyber Rebellion,rudolf.galley,"In a futuristic dystopian city controlled by ruthless mega-corporations, you play as a rebellious hacker turned mercenary. (see more on itch.io)",Adventure,No,?,,https://img.itch.zone/aW1nLzI0OTQ5NDkxLnBuZw==/original/Pg%2FZAa.png,"2D, No AI, Retro, Short"
https://erwinpelz.itch.io/rogue-horizon,Rogue Horizon,erwin.pelz,"In this high-stakes sci-fi FPS, players find themselves aboard a massive intergalactic spaceship that has been taken over by hostile alien forces. (see more on itch.io)","Action, Role Playing",No,?,,https://img.itch.zone/aW1nLzI0OTQ5NDc2LmpwZw==/original/fA%2Blkj.jpg,"No AI, Retro"
https://connorbb2.itch.io/ddlc-free-edition,DDLC FREE EDITION,Connorbb2,"The hit visuial noveles on free for windeos linexes or mac!!! Hia, me munk welcum to free vertialn of my game. (see more on itch.io)",Visual Novel,No,?,,https://img.itch.zone/aW1nLzI0OTQ3OTQzLnBuZw==/original/3wlrR0.png,Horror
https://redtine.itch.io/superball,Superball!,redtine,"Every two months I try to create a new project, this time it is a short and simple monkeyball clone. (see more on itch.io)",Platformer,No,?,,https://img.itch.zone/aW1nLzI0OTQ3ODA0LnBuZw==/original/fkQA6t.png,"Controller, dexterity, monkeyball, tilting"
https://douzi0026.itch.io/2,Rule of Tactics,Douzi0026,East (Shogi) vs West (Chess) — Discard conventional wisdom on the board and win through tactics. (see more on itch.io),Simulation,No,?,,https://img.itch.zone/aW1nLzI0OTQ3MTcxLmpwZWc=/original/2ZS2hr.jpeg,"2D, Tabletop role-playing game"
https://sawienoowie.itch.io/this-part-of-mine,This Part of Mine : Black Raincoat (ไทย),SawieNoowie,"This Part of Mine : Black Raincoat นี่คือจุดเริ่มต้นเรื่องราวของ ""ริน"" นักสืบหนุ่มวัย 21 ปี เขาม... (see more on itch.io)",Unknown,No,?,,https://img.itch.zone/aW1nLzI0OTQ3MTg2LnBuZw==/original/9suJNz.png,"3D, Detective, Godot, Mystery, Sci-fi, thai"
https://syytakii.itch.io/pink-streetlight,PINK STREETLIGHT,syytäkii,You see a magical PINK streetlight and decide to investigate. (see more on itch.io),Survival,No,?,,https://img.itch.zone/aW1nLzI0MDM4MTQ4LnBuZw==/original/kIlX4K.png,"Atmospheric, Creepy, finland, First-Person, Ghosts, Horror, Parody, Retro, Short, Spooky"
https://kiraisin.itch.io/mary,Mary,kiraisin,No description,Unknown,No,?,,https://img.itch.zone/aW1nLzI0OTQ2OTExLnBuZw==/original/UBcEi4.png,
https://cotangent-games.itch.io/agency-of-fear-de,Agency of Fear: Definitive Edition,Cotangent Games,"Made by Cotangent Games , formerly known as Futuresoft. (see more on itch.io)","Survival, Puzzle",No,?,,https://img.itch.zone/aW1nLzI0OTA4NTQ1LnBuZw==/original/fKGuco.png,"3D, Atmospheric, First-Person, Horror, Indie, Singleplayer"
https://nolanalighieri.itch.io/the-i-love-you-2026-banner-limited-time-available-until,"The 2026 ""I Love You"" Banner, Limited Time! Available until",NolanAlighieri,"Hey there, big-time gamer. (see more on itch.io)",Strategy,No,?,,https://img.itch.zone/aW1nLzI0OTQ1Nzc1LmpwZw==/original/D1dJPM.jpg,
https://evaboeck.itch.io/viral-outbreak,Viral Outbreak,eva.boeck,"A deadly virus has ravaged the globe, turning humans into mindless, aggressive zombies. (see more on itch.io)",Adventure,No,?,,https://img.itch.zone/aW1nLzI0OTQ5MzcxLmpwZw==/original/Xerzph.jpg,"2D, No AI, Pixel Art"
https://whitescarstudio.itch.io/to,Twilight Observer,WhiteScar Studios,"Game description "" Twilight Observer "" is a remaster of a beloved classic. (see more on itch.io)","Adventure, Survival, Visual Novel",No,?,,https://img.itch.zone/aW1nLzIzNTE4NjY4LmpwZw==/original/ikwK58.jpg,"Anime, Atmospheric, Horror, Psychological Horror, Romance"
https://grantrimi.itch.io/follower,Follower,GrantRimi,"Welcome to Davenburg On a snowy night downtown, Mitch makes a simple stop on his way to his girlfriend Claire's house. (see more on itch.io)",Adventure,No,?,,https://img.itch.zone/aW1nLzI0NzYzMTgxLnBuZw==/original/%2FenMyw.png,"3D, Horror, PSX (PlayStation), Psychological Horror"
https://zagongames.itch.io/the-radio-tower,The Radio Tower,ZagonGames,Climb a radio tower at the edge of an evacuation zone and fix it to restore the communications for a nearby city A short but immersive horror experience set in a remote radio tower inside a forest. (see more on itch.io),Adventure,No,?,,https://img.itch.zone/aW1nLzIzNzQ4NjQ5LnBuZw==/original/iR0hh5.png,"3D, Atmospheric, Creepy, First-Person, Halloween, Horror, Low-poly, No AI, Short, Spooky"
https://capybaraforce.itch.io/santas-pills,Steal Santa's Pills,Capybaraforce,"Do you hate Christmas? Of course you do, everybody does. (see more on itch.io)",Puzzle,No,?,,https://img.itch.zone/aW1nLzI0NjQ4ODgyLnBuZw==/original/zwh87f.png,"3D, Christmas, Creepy, Escape Game, Gore, Horror, PSX (PlayStation), Scary, Surreal, Survival Horror"
https://gabrielnjlc.itch.io/unwanted-visit,Unwanted Visit,Gabrielndjldc,"NORTH POLE NEWS: ""Residents of small cities near the North Pole reported strange sightings of a figure resembling Santa Claus wandering through nearby forests at night. (see more on itch.io)",Adventure,No,?,,https://img.itch.zone/aW1nLzI0NzA0MjcyLnBuZw==/original/6qcGv3.png,"Atmospheric, Christmas, Creepy, First-Person, Horror, PSX (PlayStation), Psychological Horror, Retro, Short"
https://jontopielski.itch.io/1000000-shrimp,"1,000,000 shrimp",Jon Topielski,"catch 1,000,000 shrimp. (see more on itch.io)",Simulation,No,?,,https://img.itch.zone/aW1nLzI0ODgyOTc0LnBuZw==/original/YKohm9.png,"1-bit, Clicker, Fishing, Idle, Incremental, Mouse only, shrimp"
https://zealli.itch.io/take-care-of-it,take care of it.,zealli,[Story] Austin and Riley are childhood friends. (see more on itch.io),"Visual Novel, Role Playing",No,?,,https://img.itch.zone/aW1nLzI0NTkxNzk3LnBuZw==/original/%2BIWHcz.png,"2D, Horror, Multiple Endings, RPG Maker, Thriller"
https://dreadloom-studios.itch.io/alone-in-christmas,Alone in Christmas,Dreadloom,"Story: Upon returning home after a party, you realize that your family is not there, and you find yourself alone. (see more on itch.io)",Adventure,No,?,,https://img.itch.zone/aW1nLzE0NTE2ODYyLnBuZw==/original/Hzgh5s.png,"3D, Christmas, Creepy, First-Person, Horror, Multiple Endings, Short, Singleplayer, Unity"
https://teamsalvato.itch.io/ddlc,Doki Doki Literature Club!,Team Salvato,"Hi, Monika here! Welcome to the Literature Club! It's always been a dream of mine to make something special out of the things I love. (see more on itch.io)",Visual Novel,No,?,,https://img.itch.zone/aW1hZ2UvMTA2NTk5LzU4NjAxMi5naWY=/originalm/YG%2B0TZ.gif,"Anime, Cute, Horror, Romance"
https://v0id2.itch.io/burrow,Burrow,V0id2,A simple adventure game thats about beating a worm. (see more on itch.io),"Adventure, Platformer",No,?,,https://img.itch.zone/aW1nLzI0OTQ5MjY5LnBuZw==/original/fdsiTS.png,"2D, 8-Bit, Metroidvania, Pixel Art"
https://yassine-game.itch.io/snak-todoraki,لعبة الدودة,Yassine Game,ستجدون منصة ثنائية الابعاد انت هو الدودة النقطة الصفراء هي الطع٠(see more on itch.io),"Adventure, Survival",No,?,,https://img.itch.zone/aW1nLzI0OTQ5MTM4LmpwZw==/original/4Uxmp8.jpg,"GameMaker, html, My First Game Jam"
https://slipshod.itch.io/neo-chase,Neo Chase - Endless runner,Jeffrey Desenfans,No description,Unknown,No,?,,https://img.itch.zone/aW1nLzI0OTQ4OTc3LnBuZw==/original/jkK6YZ.png,
https://mun09.itch.io/twohops,twohops,mun09,Try this game when drinking with your friends (see more on itch.io),Rhythm,No,?,,https://img.itch.zone/aW1nLzI0OTQ4ODkyLnBuZw==/original/nvGw45.png,"2D, Multiplayer"
https://mrcreed24.itch.io/testimonium,Testimonium,Unknown,TESTIMONIUM est un visual novel dark-fantasy à choix multiples où le joueur incarne un simple bûcheron plongé malgré lui dans l’effondrement du monde. (see more on itch.io),"Visual Novel, Interactive Fiction, Role Playing",No,?,,https://img.itch.zone/aW1nLzI0OTQ4MTg4LnBuZw==/original/DAw81G.png,"2D, Dark, Dark Fantasy, Fantasy"
https://redtropicaldev.itch.io/show-5-letters,Show 5 letters,RedTropicalDevTeam,"The letter you changed in the game will be saved to the server and released to everyone else, show us the letters you want to show! -how to play- Replace the alphabet by pressing the ▲ button or ... (see more on itch.io)",Simulation,No,?,,https://img.itch.zone/aW1nLzI0OTQ4MzczLnBuZw==/original/I8JRe7.png,"Clicker, Minimalist, Multiplayer, Word game"
1 url name dev description genre nsfw safe_virus notes thumbnail tags
2 https://torigamedev.itch.io/the-plant-shop The Plant Shop Tori The Plant Shop is a cozy horror game where you manage a small plant shop. Craft plants, serve late-night customers and grow your plant collection to attract more people. You play as Silvia, a 26 years old girl who decides to open her own small plant shop on a late-night shift because she has a corporate job during the day. Your job is to serv... Simulation No ? https://img.itch.zone/aW1nLzIzOTAwOTk3LnBuZw==/original/mLtbH1.png 3D, Cozy, First-Person, Horror, Indie, PSX (PlayStation), Psychological Horror, Retro, shop
3 https://king-turtle.itch.io/cursed-overlord Cursed Overlord [NSFW] King's Turtle PLOT In this game you play as an ordinary office clerk who is accidentally killed by lightning... Role Playing Yes ? https://img.itch.zone/aW1nLzEwMTYyMjM2LnBuZw==/original/F%2FB0Du.png Adult, Anime, Eroge, Erotic, harem, Hentai, Monster Girls, NSFW, Porn
4 https://coveirodev.itch.io/psx-granny PSX Granny CoveiroDev This is a PS1 Demake of Granny. This fan project was created in just one week, recreating the original Granny game with simple mechanics... Survival No ? https://img.itch.zone/aW1nLzI0NzMxNDk5LnBuZw==/original/IvN7fy.png Demake, First-Person, granny, Horror, PSX (PlayStation), Retro, Scary, Short, Unity
5 https://capybaraforce.itch.io/meet-santa Meet Santa Capybaraforce Did you ever want to meet Santa? Well, now you can! At least if you can win a match of Nutcracker Run! Sir Creakwood is ready to take on any opponent—do you have the skill (or luck) to beat him? Roll your way to victory and burn this old wooden creature. (see more on itch.io) Adventure, Puzzle No ? https://img.itch.zone/aW1nLzE4OTg2NzA3LmdpZg==/originalm/CykPjB.gif 3D, Christmas, Comedy, Creepy, Dark, Dark Humor, Horror, Pixel Art, PSX (PlayStation)
6 https://wesnoth.itch.io/battle-for-wesnoth Battle for Wesnoth Wesnoth The Battle for Wesnoth is an open source, turn-based strategy game with a high fantasy theme. (see more on itch.io) Strategy No ? https://img.itch.zone/aW1nLzY3MTA1OTIucG5n/original/Bj%2B%2BQD.png 2D, DRM Free, Fantasy, Open Source, Pixel Art, Turn-based Strategy
7 https://night-asobu.itch.io/parasite-in-love Parasite in Love Night Asobu Parasite in Love A biological romance horror visual novel Infected with the parasite commonly known as the “brain eating amoeba”, you have 10 days left before your death. (see more on itch.io) Visual Novel, Interactive Fiction No ? https://img.itch.zone/aW1nLzEwMDI0MDYxLmdpZg==/originalm/0RuFNu.gif 2D, Creepy, Female Protagonist, Horror, parasite, Psychological Horror, Romance, Story Rich, Yandere
8 https://studio77dev.itch.io/speedkidd SPEED KIDD Studio77Dev Speed Kidd is a retro racing game for the Game Boy where you participate in the World Tour, a championship that will take you across 12 different tracks (both real and fictional) around the world i... (see more on itch.io) Racing, Action No ? https://img.itch.zone/aW1nLzI0NjczNzQ1LnBuZw==/original/zIi5TJ.png 8-Bit, chiptune, Game Boy, Game Boy ROM, Pixel Art, Retro, Speedrun
9 https://azurextwilight.itch.io/low-effort-romance Low Effort Romance Unknown IMPORTANT: The above is a WEB DEMO. (see more on itch.io) Visual Novel No ? https://img.itch.zone/aW1nLzI0NzQwNTUzLnBuZw==/original/ExdzFr.png Amare, Christmas, Comedy, Cozy, Female Protagonist, josei, Otome, Romance, Story Rich
10 https://fireblaze236.itch.io/autopede Autopede FireBlaze236 Race through the streets using your quadruped/biped car. (see more on itch.io) Racing, Action No ? https://img.itch.zone/aW1nLzI0NzQxMDQzLnBuZw==/original/b%2F9oyz.png Arcade, cars, Fast-Paced, Indie, Pixel Art, Singleplayer, Sprites
11 https://jellyworldgames.itch.io/cozy-christmas Cozy Christmas Jellyworld Games Santa’s gifts are lost! Join a little elf in this fun holiday adventure to find and open all the hidden presents. (see more on itch.io) Adventure No ? https://img.itch.zone/aW1nLzI0NzkyMTU2LnBuZw==/original/ulVEyb.png 2D, Casual, Christmas, Cozy, Pixel Art, santa-claus, Top-Down, Top Down Adventure
12 https://newc-42.itch.io/squared-adventure Squared Adventure Newc42 Squared Adventure Hi! I created this game a few years ago, and although it looks like a  poor asset flip made by a high school student, it turned out to be pretty good in the end. (see more on itch.io) Platformer, Adventure No ? https://img.itch.zone/aW1nLzI0ODEyODc4LnBuZw==/original/gTOR2k.png 2D, 8-Bit, Indie, No AI, Pixel Art, Retro, Short, Singleplayer
13 https://bastienbegue.itch.io/grand-manoir Grand Manoir BastienBegue [Horror game] In a world ravaged by the arrivals of mysterious creatures during the great war, you are living in a dystopia in Europe during the 1940's where you need to live constantly in a light ... (see more on itch.io) Adventure No ? https://img.itch.zone/aW1nLzI0NjMxMTYxLnBuZw==/original/n6ZzcC.png 3D, Dark, Dystopian, Horror, Indie, Sci-fi, Singleplayer
14 https://ryan-goodyear.itch.io/rainwaze Railwaze Ryan Goodyear Defeat the boss and its minions to win. (see more on itch.io) Action, Shooter, Survival No ? https://img.itch.zone/aW1nLzI0ODEzMTYyLnBuZw==/original/VyBKMj.png 3D, Boss battle
15 https://junior17.itch.io/demidreamer Demidreamer Jannick Jade Elfers Träume, forsche und. (see more on itch.io) Visual Novel No ? https://img.itch.zone/aW1nLzEyOTk0NTM2LnBuZw==/original/6A8DAF.png 2D, LGBT, Multiple Endings, Narrative, Queer, Ren'Py, Singleplayer, Text based, Transgender
16 https://foxhoundproductions.itch.io/custodian Custodian FoxhoundProductions A short fps horror experience I made with Unity in 2 months. (see more on itch.io) Unknown No ? https://img.itch.zone/aW1nLzI0ODEyNjk5LnBuZw==/original/zQgeps.png 3D, Creepy, First-Person, Horror, Singleplayer, Spooky
17 https://lemone2d.itch.io/around-the-world Around the World alpha lemone2d Content warning: Swearing (lol) After a disappointing experience at your first college, you enroll at Imago Mundi University. (see more on itch.io) Visual Novel No ? https://img.itch.zone/aW1nLzI0Nzg2MzY3LnBuZw==/original/WxgpQ1.png 2D, Cute, Dating Sim, Indie, LGBT, No AI, Ren'Py, Romance, Singleplayer
18 https://nattougames594.itch.io/orisumass1 オリスマ外伝~ブルーザウルスの冒険~ 納豆 これは非公式のファン作品です ブルーザウルスたちが冒険する短編RPGです! 妹であるレッドザウルスの告白を手助けしましょう! (see more on itch.io) Role Playing No ? https://img.itch.zone/aW1nLzI0ODAyOTc3LmpwZw==/original/3lvnFb.jpg 2D, Fangame
19 https://causeitsontapgames.itch.io/crisis-at-the-skydome Crisis at the Skydome Cause It's On Tap Games Pop Pop Pop Welcome to the ultimate arcade balloon-popping challenge. (see more on itch.io) Unknown No ? https://img.itch.zone/aW1nLzI0ODA0MDIwLnBuZw==/original/v4DUIB.png Arcade, Casual, High Score
20 https://nattougames594.itch.io/irosumarpg イロスマRPG 納豆 これは非公式のファン作品です RPGツクールVXで初めて作ったゲームをウディタでリメイクしました! 無料高RPGシスMrHの機能のおかげでツクールVXã... (see more on itch.io) Role Playing No ? https://img.itch.zone/aW1nLzI0ODA3NjMxLmpwZw==/original/08qElw.jpg 2D, Fangame, Remake
21 https://hunterelise.itch.io/console-games C++ Console Games Elise Hunter This project contains two C++ console games developed for my Games Programming 1 coursework. (see more on itch.io) Unknown No ? https://img.itch.zone/aW1nLzI0ODAxODY0LmpwZw==/original/Fx7fwK.jpg Arcade, No AI
22 https://szalkin.itch.io/bomb-game Bomb Game Sam Zalkin Bomb Game is a multiplayer card and party game that tests players ability to strategize quickly. (see more on itch.io) Card Game, Strategy No ? https://img.itch.zone/aW1nLzI0Njk2NjE2LnBuZw==/original/Vgoo1L.png Aseprite, Indie, No AI, party-game
23 https://danka-dobric.itch.io/detektiv Detektiv Vuk Dobric ABOUT: A short horror experience centered on a strange murder, in which you play Detective Fyodor Mikhailovich, investigating the crime and looking for clues to unravel the mystery. (see more on itch.io) Adventure No ? https://img.itch.zone/aW1nLzI0NTE0Mjg1LnBuZw==/original/KbJa4K.png 3D, Atmospheric, Creepy, Detective, Fast-Paced, Horror, Indie, Mystery, Short, Singleplayer
24 https://meant-to-bee-studios.itch.io/criminally-yours Criminally Yours Unknown You're the next generation of heroes—"Oracle," given to your mother and you for your ability to see glimpses into the future. (see more on itch.io) Visual Novel No ? https://img.itch.zone/aW1nLzIyNzkwNDY3LnBuZw==/original/Io32%2Fa.png Amare, Dating Sim, Indie, No AI, Otome, Romance, Superhero, Yandere, Yaoi
25 https://master2015hp.itch.io/heroines-paradox-n-anh-hng Heroines Paradox - 英雌悖论 - Nữ Anh Hùng Baby3 About This Game “Heroines Paradox” is a hybrid Dungeon Crawler and Visual Novel, told through an urban horror narrative reminiscent of Junji Ito’s storytelling style. (see more on itch.io) Visual Novel No ? https://img.itch.zone/aW1nLzI0ODExODM1LnBuZw==/original/MdANFs.png 2D, Horror, Psychological Horror, Turn-Based Combat
26 https://goranz.itch.io/you-must You Must GoranZ A short survival-horror zombie game inspired by Resident Evil , combining puzzles, cinematic storytelling, and intense combat against terrifying undead. (see more on itch.io) Shooter, Puzzle No ? https://img.itch.zone/aW1nLzI0ODEzOTE5LmpwZw==/original/1zUG7m.jpg 3D, evil, Horror, resident, Zombies
27 https://komarusg.itch.io/pofuduk-kacis Pofuduk Kacis komarusg Endless runner game made with free assets and some of my own pixel art. (see more on itch.io) Platformer No ? https://img.itch.zone/aW1nLzI0ODEzODE0LnBuZw==/original/xhxXjs.png
28 https://ehn-sabedra.itch.io/turtle-care-simulator Turtle Care Simulator Ehn Sabedra It's simple, arcade simulator of turtle. (see more on itch.io) Adventure No ? https://img.itch.zone/aW1nLzI0ODEzNzYzLmpwZw==/original/tTi4sx.jpg Atmospheric
29 https://azmel-3d.itch.io/the-pizza-cannon The Pizza Cannon Azmel Enriquez A small 1 level of a basic bullet hell game. (see more on itch.io) Shooter, Action No ? https://img.itch.zone/aW1nLzI0ODI2NjAwLnBuZw==/original/UEY51c.png Bullet Hell, Indie, Top down shooter
30 https://droptineart.itch.io/lavender-county Lavender County DroptineArt Deep down in the dirty south, the down-and-out residents of Lavender County smell somethin' in the spring air. (see more on itch.io) Visual Novel Yes ? https://img.itch.zone/aW1nLzE5NjQ5NzM2LnBuZw==/original/CeGObX.png Adult, country, Dating Sim, Furry, lavender-county, redneck, southern
31 https://quiesphere.itch.io/miltf Man, I Love Terraria Fishing quiesphere Man, I Love Terraria Fishing is a short Terraria-themed fishing game. (see more on itch.io) Simulation No ? https://img.itch.zone/aW1nLzI0NzkzOTkyLnBuZw==/original/v6Qzn%2F.png 2D, Fangame, Fishing, No AI, Pixel Art, RPG Maker, RPG Maker MV, Short, Singleplayer
32 https://nano16.itch.io/fight-goblin-fight-2026 戰鬥吧哥布林 Nano16 戰鬥吧哥布林! 遊戲說明 在跨年夜裡,小心不要變成帥潮們的經驗值,擊敗他們並活到2026年吧! 遊戲操作 移動:W S A D、上 下 å·¦ 右 跳躍:Space 攻æ... (see more on itch.io) Action, Adventure No ? https://img.itch.zone/aW1nLzI0ODU3ODA1LnBuZw==/original/DCnwOR.png 3D, Singleplayer, Unity
33 https://fter.itch.io/before-the-dawn Before the dawn/在黎明之前 Fter This is a side-scrolling platformer with action-adventure elements. (see more on itch.io) Adventure No ? https://img.itch.zone/aW1nLzI0ODQwNzMxLnBuZw==/original/mpvaVJ.png 2D, Pixel Art
34 https://huvjnk.itch.io/happy-happy-c8c8 開心星人反抗畢制破財命運 huvjnk 開心星人反抗畢制破財命運 遊戲說明 打倒負債!籌款2026製作畢製的經費! 2026開心星球上的大學生們即將製作畢制並且面臨了要繳畢委會費16000的高額é‡... (see more on itch.io) Action, Adventure, Role Playing No ? https://img.itch.zone/aW1nLzI0ODU3NTY5LnBuZw==/original/U1BaQu.png 3D, arpg, money, Singleplayer, Third Person, Unity
35 https://jjjjjc.itch.io/i-remember-the-first-time-that-you-held-my-hand I remember the first time that you held my hand jjjjjc So, when I saw the jam theme (two hands almost touching), it instantly hit me. (see more on itch.io) Visual Novel No ? https://img.itch.zone/aW1nLzI0ODU2Njk5LnBuZw==/original/68umdw.png 2D, No AI, poem, retrospective, Sound effects, Story Rich
36 https://llama2474.itch.io/overcooked Overcooked? llama2474 An overcooked clone made in the open source godot engine as a university project by a couple of guys. (see more on itch.io) Strategy, Action, Simulation No ? https://img.itch.zone/aW1nLzI0ODU3MTIzLnBuZw==/original/knQa3H.png Casual, Cooking, Co-op, Singleplayer
37 https://infercode-studio.itch.io/afterjoy AfterJoy Infercode studio No description Survival No ? https://img.itch.zone/aW1nLzI0ODQyNDgzLnBuZw==/original/psJWiv.png FPS, Horror
38 https://akane13.itch.io/let-connect 相连 Let Connect Unknown 相连 Let Connect Let Connect is a short narrative-driven game about human connections across a lifetime. (see more on itch.io) Unknown No ? https://img.itch.zone/aW1nLzI0ODQ1MzE1LnBuZw==/original/akBw1M.png 2D, Casual, emotional, Narrative, relationship, Relaxing, Short, Singleplayer
39 https://for-little-brother.itch.io/lets-roll Let's Roll For Little Brother Let's Roll ist ein lustiges und kinderfreundliches "Endless Runner"-Spiel. (see more on itch.io) Action No ? https://img.itch.zone/aW1nLzI0ODU2MjU3LnBuZw==/original/KaUWE%2B.png 2D, Cute, Family Friendly, Singleplayer
40 https://hx-kani.itch.io/angelshit Angelshit:天屎降临 HX_kani 不要被寝室阿姨抓住哦!(=^・ェ・^=) 操作方法:关卡①:WASD键控制移动。关卡②:空格跳跃,S键下蹲 (see more on itch.io) Action No ? https://img.itch.zone/aW1nLzI0ODU2ODU2LnBuZw==/original/VMMWHu.png
41 https://nazirovsgames.itch.io/the-watching-walls The watching walls Nazirovsgames The watching walls Short indie game horror game about hotel and you. (see more on itch.io) Action No ? https://img.itch.zone/aW1nLzI0ODU2NjE4LnBuZw==/original/z0hdDv.png Horror
42 https://reginald14320.itch.io/ciphers-chamber Cipher's Chamber Unknown Agent Spay must puzzle their way through a routine training simulation. (see more on itch.io) Puzzle No ? https://img.itch.zone/aW1nLzI0NDIyMDY2LnBuZw==/original/zhlQMc.png 3D, Comedy, First-Person, Indie, No AI
43 https://kfg-68.itch.io/akaten-kaihi 赤点を回避しろ! KFG_68 とても短いシンプルなノベルゲームです。 友人と一緒に勉強をして、テストで結果を残せるようにしましょう! It's a very short visual-novel game that I made. (see more on itch.io) Visual Novel No ? https://img.itch.zone/aW1nLzI0ODU2NDk0LnBuZw==/original/syEka1.png Ren'Py, Short, Singleplayer
44 https://lupro1.itch.io/frost-burn Frost Burn Unknown CHECK-IN HERE Please download the game at the bottom of the page for the best quality/experience! Play as Arnie , the fiery main character whose last mission is to destroy the final resort atop the... (see more on itch.io) Action, Platformer No ? https://img.itch.zone/aW1nLzI0ODU0MTU1LmpwZw==/original/ZxjL6B.jpg 3D, Singleplayer
45 https://flaminiop.itch.io/courrier T'as du courrier ! Flaminiop Ce jeu est en français / This game is in French ! T'as du courrier ! Mais qui a bien pu t'écrire ? Découvre toutes les possibilités en combinant les mots clefs. (see more on itch.io) Interactive Fiction, Visual Novel No ? https://img.itch.zone/aW1nLzI0ODQ0NDU2LnBuZw==/original/GXFG04.png Casual, french, Godot, No AI, Non violent, Relaxing, Singleplayer, Story Rich, Text based
46 https://garula.itch.io/the-freak-circus The Freak Circus Garula 《 The Freak Circus ã€‹ Of horrors The Circus of Horrors has arrived in town. (see more on itch.io) Visual Novel No ? https://img.itch.zone/aW1nLzIxNjQxODI1LnBuZw==/original/sIu4WS.png circus, Creepy, Dark, Dating Sim, Horror, Monsters, Ren'Py, Yandere
47 https://khydra98.itch.io/pokepath PokéPath TD Khydra PokéPath TD is a Pokémon Tower Defense game! Manage your team and defend against waves of enemies across 9 different routes . (see more on itch.io) Strategy No ? https://img.itch.zone/aW1nLzI0MzE2MTUwLnBuZw==/original/L854aH.png afk, Anime, Farming, Idle, Pixel Art, pokemon, Singleplayer, Tactical, Tower Defense
48 https://blakemckinnonproductions.itch.io/slaybells Slay Bells Blake McKinnon Productions Slay Bells is a Christmas-themed survival horror game inspired by 80's slasher movies and PS1 horror games. (see more on itch.io) Survival No ? https://img.itch.zone/aW1nLzI4MDgyNDEucG5n/original/ovlywA.png 3D, Atmospheric, Christmas, First-Person, Horror, ps1, Slasher, Survival Horror, Unity, vhs
49 https://meownsk.itch.io/danglin-froggo Danglin’ Froggo meownsk In the mysterious depths of the cave, where light exists only in the reflections of crystals, something dwells. (see more on itch.io) Platformer No ? https://img.itch.zone/aW1nLzI0ODQ0NTA4LnBuZw==/original/xHOa%2BE.png 2D, Difficult, Hand-drawn, jumping, Physics, rope-swinging, Tilemap
50 https://chelsammi.itch.io/olen-mysterious-forest Olen': Mysterious Forest ChelSammi Olen': Mysterious Forest — an atmospheric adventure where you play as a young deer who has lost its herd in a mysterious forest. (see more on itch.io) Adventure, Action No ? https://img.itch.zone/aW1nLzI0OTQ5MTQ3LnBuZw==/original/NxwWOq.png 2D, Animals, Atmospheric, Christmas, Fantasy, Indie, jrpg-maker, Pixel Art, RPG Maker
51 https://snowish.itch.io/just-another-morning Just Another Morning Casper Ampersand It's the start of another morning in the life of Gregory Izaak. (see more on itch.io) Visual Novel No ? https://img.itch.zone/aW1nLzI0OTQ4MTc5LnBuZw==/original/wqMZdC.png Fantasy, Horror, Point & Click, Psychological Horror
52 https://sniper-mks.itch.io/ggx2025-escape-from-seichi GGX2025_聖地からの解放 shin.mks このゲームは聖地に囚われた幽霊たちを解放すべく主人公の巫女様が聖地に訪れて幽霊達と対話する新感覚の弾幕アクションゲームです。 幽霊達かã... (see more on itch.io) Action, Adventure No ? https://img.itch.zone/aW1nLzI0OTQ4MDU0LnBuZw==/original/JNC%2BUV.png 2D, Creepy, Dark, Female Protagonist, Horror, Meaningful Choices, Unity
53 https://patretro.itch.io/4x4-tic-tac-toe 4x4 Tic Tac Toe patretro Tic Tac Toe on a 4x4 grid. (see more on itch.io) Unknown No ? https://img.itch.zone/aW1nLzI0OTQ4NDEwLnBuZw==/original/fiFfnV.png 2D, Cult Classic, Retro, tic-tac-toe
54 https://infinvarg.itch.io/make-a-dream-museum Make a Dream Museum InfiNVarg AVISO Para jugar la versión de navegador, se recomienda activar la aceleración por hardware de tu navegador si no la tienes activada. (see more on itch.io) Simulation No ? https://img.itch.zone/aW1nLzI0OTQ4OTQ5LnBuZw==/original/uMjmRL.png Unity, yo-kai-watch
55 https://srcheese44.itch.io/grabbity Grabbity Unknown Grabbity is a short gravity-shifting platforming adventure game where you control a rabbit collecting carrots in space! On the eve of the annual rabbit festival, a terrible truth is revealed for th... (see more on itch.io) Platformer No ? https://img.itch.zone/aW1nLzI0OTI0MTE3LmdpZg==/originalm/mJNpnQ.gif 2D, Cozy, Cute, Gravity, Pixel Art, Puzzle-Platformer, rabbits, Short, Singleplayer, Space
56 https://rudolfgalley.itch.io/cyber-rebellion Cyber Rebellion rudolf.galley In a futuristic dystopian city controlled by ruthless mega-corporations, you play as a rebellious hacker turned mercenary. (see more on itch.io) Adventure No ? https://img.itch.zone/aW1nLzI0OTQ5NDkxLnBuZw==/original/Pg%2FZAa.png 2D, No AI, Retro, Short
57 https://erwinpelz.itch.io/rogue-horizon Rogue Horizon erwin.pelz In this high-stakes sci-fi FPS, players find themselves aboard a massive intergalactic spaceship that has been taken over by hostile alien forces. (see more on itch.io) Action, Role Playing No ? https://img.itch.zone/aW1nLzI0OTQ5NDc2LmpwZw==/original/fA%2Blkj.jpg No AI, Retro
58 https://connorbb2.itch.io/ddlc-free-edition DDLC FREE EDITION Connorbb2 The hit visuial noveles on free for windeos linexes or mac!!! Hia, me munk welcum to free vertialn of my game. (see more on itch.io) Visual Novel No ? https://img.itch.zone/aW1nLzI0OTQ3OTQzLnBuZw==/original/3wlrR0.png Horror
59 https://redtine.itch.io/superball Superball! redtine Every two months I try to create a new project, this time it is a short and simple monkeyball clone. (see more on itch.io) Platformer No ? https://img.itch.zone/aW1nLzI0OTQ3ODA0LnBuZw==/original/fkQA6t.png Controller, dexterity, monkeyball, tilting
60 https://douzi0026.itch.io/2 Rule of Tactics Douzi0026 East (Shogi) vs West (Chess) — Discard conventional wisdom on the board and win through tactics. (see more on itch.io) Simulation No ? https://img.itch.zone/aW1nLzI0OTQ3MTcxLmpwZWc=/original/2ZS2hr.jpeg 2D, Tabletop role-playing game
61 https://sawienoowie.itch.io/this-part-of-mine This Part of Mine : Black Raincoat (ไทย) SawieNoowie This Part of Mine : Black Raincoat นี่คือจุดเริ่มต้นเรื่องราวของ "ริน" นักสืบหนุ่มวัย 21 ปี เขาม... (see more on itch.io) Unknown No ? https://img.itch.zone/aW1nLzI0OTQ3MTg2LnBuZw==/original/9suJNz.png 3D, Detective, Godot, Mystery, Sci-fi, thai
62 https://syytakii.itch.io/pink-streetlight PINK STREETLIGHT syytäkii You see a magical PINK streetlight and decide to investigate. (see more on itch.io) Survival No ? https://img.itch.zone/aW1nLzI0MDM4MTQ4LnBuZw==/original/kIlX4K.png Atmospheric, Creepy, finland, First-Person, Ghosts, Horror, Parody, Retro, Short, Spooky
63 https://kiraisin.itch.io/mary Mary kiraisin No description Unknown No ? https://img.itch.zone/aW1nLzI0OTQ2OTExLnBuZw==/original/UBcEi4.png
64 https://cotangent-games.itch.io/agency-of-fear-de Agency of Fear: Definitive Edition Cotangent Games Made by Cotangent Games , formerly known as Futuresoft. (see more on itch.io) Survival, Puzzle No ? https://img.itch.zone/aW1nLzI0OTA4NTQ1LnBuZw==/original/fKGuco.png 3D, Atmospheric, First-Person, Horror, Indie, Singleplayer
65 https://nolanalighieri.itch.io/the-i-love-you-2026-banner-limited-time-available-until The 2026 "I Love You" Banner, Limited Time! Available until NolanAlighieri Hey there, big-time gamer. (see more on itch.io) Strategy No ? https://img.itch.zone/aW1nLzI0OTQ1Nzc1LmpwZw==/original/D1dJPM.jpg
66 https://evaboeck.itch.io/viral-outbreak Viral Outbreak eva.boeck A deadly virus has ravaged the globe, turning humans into mindless, aggressive zombies. (see more on itch.io) Adventure No ? https://img.itch.zone/aW1nLzI0OTQ5MzcxLmpwZw==/original/Xerzph.jpg 2D, No AI, Pixel Art
67 https://whitescarstudio.itch.io/to Twilight Observer WhiteScar Studios Game description " Twilight Observer " is a remaster of a beloved classic. (see more on itch.io) Adventure, Survival, Visual Novel No ? https://img.itch.zone/aW1nLzIzNTE4NjY4LmpwZw==/original/ikwK58.jpg Anime, Atmospheric, Horror, Psychological Horror, Romance
68 https://grantrimi.itch.io/follower Follower GrantRimi Welcome to Davenburg On a snowy night downtown, Mitch makes a simple stop on his way to his girlfriend Claire's house. (see more on itch.io) Adventure No ? https://img.itch.zone/aW1nLzI0NzYzMTgxLnBuZw==/original/%2FenMyw.png 3D, Horror, PSX (PlayStation), Psychological Horror
69 https://zagongames.itch.io/the-radio-tower The Radio Tower ZagonGames Climb a radio tower at the edge of an evacuation zone and fix it to restore the communications for a nearby city A short but immersive horror experience set in a remote radio tower inside a forest. (see more on itch.io) Adventure No ? https://img.itch.zone/aW1nLzIzNzQ4NjQ5LnBuZw==/original/iR0hh5.png 3D, Atmospheric, Creepy, First-Person, Halloween, Horror, Low-poly, No AI, Short, Spooky
70 https://capybaraforce.itch.io/santas-pills Steal Santa's Pills Capybaraforce Do you hate Christmas? Of course you do, everybody does. (see more on itch.io) Puzzle No ? https://img.itch.zone/aW1nLzI0NjQ4ODgyLnBuZw==/original/zwh87f.png 3D, Christmas, Creepy, Escape Game, Gore, Horror, PSX (PlayStation), Scary, Surreal, Survival Horror
71 https://gabrielnjlc.itch.io/unwanted-visit Unwanted Visit Gabrielndjldc NORTH POLE NEWS: "Residents of small cities near the North Pole reported strange sightings of a figure resembling Santa Claus wandering through nearby forests at night. (see more on itch.io) Adventure No ? https://img.itch.zone/aW1nLzI0NzA0MjcyLnBuZw==/original/6qcGv3.png Atmospheric, Christmas, Creepy, First-Person, Horror, PSX (PlayStation), Psychological Horror, Retro, Short
72 https://jontopielski.itch.io/1000000-shrimp 1,000,000 shrimp Jon Topielski catch 1,000,000 shrimp. (see more on itch.io) Simulation No ? https://img.itch.zone/aW1nLzI0ODgyOTc0LnBuZw==/original/YKohm9.png 1-bit, Clicker, Fishing, Idle, Incremental, Mouse only, shrimp
73 https://zealli.itch.io/take-care-of-it take care of it. zealli [Story] Austin and Riley are childhood friends. (see more on itch.io) Visual Novel, Role Playing No ? https://img.itch.zone/aW1nLzI0NTkxNzk3LnBuZw==/original/%2BIWHcz.png 2D, Horror, Multiple Endings, RPG Maker, Thriller
74 https://dreadloom-studios.itch.io/alone-in-christmas Alone in Christmas Dreadloom Story: Upon returning home after a party, you realize that your family is not there, and you find yourself alone. (see more on itch.io) Adventure No ? https://img.itch.zone/aW1nLzE0NTE2ODYyLnBuZw==/original/Hzgh5s.png 3D, Christmas, Creepy, First-Person, Horror, Multiple Endings, Short, Singleplayer, Unity
75 https://teamsalvato.itch.io/ddlc Doki Doki Literature Club! Team Salvato Hi, Monika here! Welcome to the Literature Club! It's always been a dream of mine to make something special out of the things I love. (see more on itch.io) Visual Novel No ? https://img.itch.zone/aW1hZ2UvMTA2NTk5LzU4NjAxMi5naWY=/originalm/YG%2B0TZ.gif Anime, Cute, Horror, Romance
76 https://v0id2.itch.io/burrow Burrow V0id2 A simple adventure game thats about beating a worm. (see more on itch.io) Adventure, Platformer No ? https://img.itch.zone/aW1nLzI0OTQ5MjY5LnBuZw==/original/fdsiTS.png 2D, 8-Bit, Metroidvania, Pixel Art
77 https://yassine-game.itch.io/snak-todoraki لعبة الدودة Yassine Game ستجدون منصة ثنائية الابعاد انت هو الدودة النقطة الصفراء هي الطع٠(see more on itch.io) Adventure, Survival No ? https://img.itch.zone/aW1nLzI0OTQ5MTM4LmpwZw==/original/4Uxmp8.jpg GameMaker, html, My First Game Jam
78 https://slipshod.itch.io/neo-chase Neo Chase - Endless runner Jeffrey Desenfans No description Unknown No ? https://img.itch.zone/aW1nLzI0OTQ4OTc3LnBuZw==/original/jkK6YZ.png
79 https://mun09.itch.io/twohops twohops mun09 Try this game when drinking with your friends (see more on itch.io) Rhythm No ? https://img.itch.zone/aW1nLzI0OTQ4ODkyLnBuZw==/original/nvGw45.png 2D, Multiplayer
80 https://mrcreed24.itch.io/testimonium Testimonium Unknown TESTIMONIUM est un visual novel dark-fantasy à choix multiples où le joueur incarne un simple bûcheron plongé malgré lui dans l’effondrement du monde. (see more on itch.io) Visual Novel, Interactive Fiction, Role Playing No ? https://img.itch.zone/aW1nLzI0OTQ4MTg4LnBuZw==/original/DAw81G.png 2D, Dark, Dark Fantasy, Fantasy
81 https://redtropicaldev.itch.io/show-5-letters Show 5 letters RedTropicalDevTeam The letter you changed in the game will be saved to the server and released to everyone else, show us the letters you want to show! -how to play- Replace the alphabet by pressing the ▲ button or ... (see more on itch.io) Simulation No ? https://img.itch.zone/aW1nLzI0OTQ4MzczLnBuZw==/original/I8JRe7.png Clicker, Minimalist, Multiplayer, Word game
View File
Whitespace-only changes.
-14
View File
@@ -1,14 +0,0 @@
# Action Games (9 games)
| No | Thumb | Name | Dev | Short Desc | Link | Safe | Notes | NSFW |
|----|-------|------|-----|------------|------|------|-------|------|
| 1 | ![thumb](https://img.itch.zone/aW1nLzI0ODU2ODU2LnBuZw==/original/VMMWHu.png) | Angelshit:天屎降临 | HX_kani | 不要被寝室阿姨抓住哦!(=^・ェ・^=) 操作方法:关卡①:WASD键控制移动。关卡②:空格跳跃,S键下蹲 (see more on itch.io) | [Link](https://hx-kani.itch.io/angelshit) | ? | | No |
| 2 | ![thumb](https://img.itch.zone/aW1nLzI0ODU0MTU1LmpwZw==/original/ZxjL6B.jpg) | Frost Burn | Unknown | CHECK-IN HERE Please download the game at the bottom of the page for the best quality/experience! Play as Arnie , the fiery main character whose last mission is to destroy the final resort atop the... (see more on itch.io) | [Link](https://lupro1.itch.io/frost-burn) | ? | | No |
| 3 | ![thumb](https://img.itch.zone/aW1nLzI0OTQ4MDU0LnBuZw==/original/JNC%2BUV.png) | GGX2025_聖地からの解放 | shin.mks | このゲームは聖地に囚われた幽霊たちを解放すべく主人公の巫女様が聖地に訪れて幽霊達と対話する新感覚の弾幕アクションゲームです。 幽霊達かã... (see more on itch.io) | [Link](https://sniper-mks.itch.io/ggx2025-escape-from-seichi) | ? | | No |
| 4 | ![thumb](https://img.itch.zone/aW1nLzI0ODU2MjU3LnBuZw==/original/KaUWE%2B.png) | Let's Roll | For Little Brother | Let's Roll ist ein lustiges und kinderfreundliches "Endless Runner"-Spiel. (see more on itch.io) | [Link](https://for-little-brother.itch.io/lets-roll) | ? | | No |
| 5 | ![thumb](https://img.itch.zone/aW1nLzI0ODEzMTYyLnBuZw==/original/VyBKMj.png) | Railwaze | Ryan Goodyear | Defeat the boss and its minions to win. (see more on itch.io) | [Link](https://ryan-goodyear.itch.io/rainwaze) | ? | | No |
| 6 | ![thumb](https://img.itch.zone/aW1nLzI0OTQ5NDc2LmpwZw==/original/fA%2Blkj.jpg) | Rogue Horizon | erwin.pelz | In this high-stakes sci-fi FPS, players find themselves aboard a massive intergalactic spaceship that has been taken over by hostile alien forces. (see more on itch.io) | [Link](https://erwinpelz.itch.io/rogue-horizon) | ? | | No |
| 7 | ![thumb](https://img.itch.zone/aW1nLzI0ODU2NjE4LnBuZw==/original/z0hdDv.png) | The watching walls | Nazirovsgames | The watching walls Short indie game horror game about hotel and you. (see more on itch.io) | [Link](https://nazirovsgames.itch.io/the-watching-walls) | ? | | No |
| 8 | ![thumb](https://img.itch.zone/aW1nLzI0ODU3ODA1LnBuZw==/original/DCnwOR.png) | 戰鬥吧哥布林 | Nano16 | 戰鬥吧哥布林! 遊戲說明 在跨年夜裡,小心不要變成帥潮們的經驗值,擊敗他們並活到2026年吧! 遊戲操作 移動:W S A D、上 下 å·¦ 右 跳躍:Space 攻æ... (see more on itch.io) | [Link](https://nano16.itch.io/fight-goblin-fight-2026) | ? | | No |
| 9 | ![thumb](https://img.itch.zone/aW1nLzI0ODU3NTY5LnBuZw==/original/U1BaQu.png) | 開心星人反抗畢制破財命運 | huvjnk | 開心星人反抗畢制破財命運 遊戲說明 打倒負債!籌款2026製作畢製的經費! 2026開心星球上的大學生們即將製作畢制並且面臨了要繳畢委會費16000的高額é‡... (see more on itch.io) | [Link](https://huvjnk.itch.io/happy-happy-c8c8) | ? | | No |
-21
View File
@@ -1,21 +0,0 @@
# Adventure Games (16 games)
| No | Thumb | Name | Dev | Short Desc | Link | Safe | Notes | NSFW |
|----|-------|------|-----|------------|------|------|-------|------|
| 1 | ![thumb](https://img.itch.zone/aW1nLzE0NTE2ODYyLnBuZw==/original/Hzgh5s.png) | Alone in Christmas | Dreadloom | Story: Upon returning home after a party, you realize that your family is not there, and you find yourself alone. (see more on itch.io) | [Link](https://dreadloom-studios.itch.io/alone-in-christmas) | ? | | No |
| 2 | ![thumb](https://img.itch.zone/aW1nLzI0ODQwNzMxLnBuZw==/original/mpvaVJ.png) | Before the dawn/在黎明之前 | Fter | This is a side-scrolling platformer with action-adventure elements. (see more on itch.io) | [Link](https://fter.itch.io/before-the-dawn) | ? | | No |
| 3 | ![thumb](https://img.itch.zone/aW1nLzI0OTQ5MjY5LnBuZw==/original/fdsiTS.png) | Burrow | V0id2 | A simple adventure game thats about beating a worm. (see more on itch.io) | [Link](https://v0id2.itch.io/burrow) | ? | | No |
| 4 | ![thumb](https://img.itch.zone/aW1nLzI0NzkyMTU2LnBuZw==/original/ulVEyb.png) | Cozy Christmas | Jellyworld Games | Santa’s gifts are lost! Join a little elf in this fun holiday adventure to find and open all the hidden presents. (see more on itch.io) | [Link](https://jellyworldgames.itch.io/cozy-christmas) | ? | | No |
| 5 | ![thumb](https://img.itch.zone/aW1nLzI0OTQ5NDkxLnBuZw==/original/Pg%2FZAa.png) | Cyber Rebellion | rudolf.galley | In a futuristic dystopian city controlled by ruthless mega-corporations, you play as a rebellious hacker turned mercenary. (see more on itch.io) | [Link](https://rudolfgalley.itch.io/cyber-rebellion) | ? | | No |
| 6 | ![thumb](https://img.itch.zone/aW1nLzI0NTE0Mjg1LnBuZw==/original/KbJa4K.png) | Detektiv | Vuk Dobric | ABOUT: A short horror experience centered on a strange murder, in which you play Detective Fyodor Mikhailovich, investigating the crime and looking for clues to unravel the mystery. (see more on itch.io) | [Link](https://danka-dobric.itch.io/detektiv) | ? | | No |
| 7 | ![thumb](https://img.itch.zone/aW1nLzI0NzYzMTgxLnBuZw==/original/%2FenMyw.png) | Follower | GrantRimi | Welcome to Davenburg On a snowy night downtown, Mitch makes a simple stop on his way to his girlfriend Claire's house. (see more on itch.io) | [Link](https://grantrimi.itch.io/follower) | ? | | No |
| 8 | ![thumb](https://img.itch.zone/aW1nLzI0NjMxMTYxLnBuZw==/original/n6ZzcC.png) | Grand Manoir | BastienBegue | [Horror game] In a world ravaged by the arrivals of mysterious creatures during the great war, you are living in a dystopia in Europe during the 1940's where you need to live constantly in a light ... (see more on itch.io) | [Link](https://bastienbegue.itch.io/grand-manoir) | ? | | No |
| 9 | ![thumb](https://img.itch.zone/aW1nLzE4OTg2NzA3LmdpZg==/originalm/CykPjB.gif) | Meet Santa | Capybaraforce | Did you ever want to meet Santa? Well, now you can! At least if you can win a match of Nutcracker Run! Sir Creakwood is ready to take on any opponent—do you have the skill (or luck) to beat him? Roll your way to victory and burn this old wooden creature. (see more on itch.io) | [Link](https://capybaraforce.itch.io/meet-santa) | ? | | No |
| 10 | ![thumb](https://img.itch.zone/aW1nLzI0OTQ5MTQ3LnBuZw==/original/NxwWOq.png) | Olen': Mysterious Forest | ChelSammi | Olen': Mysterious Forest — an atmospheric adventure where you play as a young deer who has lost its herd in a mysterious forest. (see more on itch.io) | [Link](https://chelsammi.itch.io/olen-mysterious-forest) | ? | | No |
| 11 | ![thumb](https://img.itch.zone/aW1nLzIzNzQ4NjQ5LnBuZw==/original/iR0hh5.png) | The Radio Tower | ZagonGames | Climb a radio tower at the edge of an evacuation zone and fix it to restore the communications for a nearby city A short but immersive horror experience set in a remote radio tower inside a forest. (see more on itch.io) | [Link](https://zagongames.itch.io/the-radio-tower) | ? | | No |
| 12 | ![thumb](https://img.itch.zone/aW1nLzI0ODEzNzYzLmpwZw==/original/tTi4sx.jpg) | Turtle Care Simulator | Ehn Sabedra | It's simple, arcade simulator of turtle. (see more on itch.io) | [Link](https://ehn-sabedra.itch.io/turtle-care-simulator) | ? | | No |
| 13 | ![thumb](https://img.itch.zone/aW1nLzIzNTE4NjY4LmpwZw==/original/ikwK58.jpg) | Twilight Observer | WhiteScar Studios | Game description " Twilight Observer " is a remaster of a beloved classic. (see more on itch.io) | [Link](https://whitescarstudio.itch.io/to) | ? | | No |
| 14 | ![thumb](https://img.itch.zone/aW1nLzI0NzA0MjcyLnBuZw==/original/6qcGv3.png) | Unwanted Visit | Gabrielndjldc | NORTH POLE NEWS: "Residents of small cities near the North Pole reported strange sightings of a figure resembling Santa Claus wandering through nearby forests at night. (see more on itch.io) | [Link](https://gabrielnjlc.itch.io/unwanted-visit) | ? | | No |
| 15 | ![thumb](https://img.itch.zone/aW1nLzI0OTQ5MzcxLmpwZw==/original/Xerzph.jpg) | Viral Outbreak | eva.boeck | A deadly virus has ravaged the globe, turning humans into mindless, aggressive zombies. (see more on itch.io) | [Link](https://evaboeck.itch.io/viral-outbreak) | ? | | No |
| 16 | ![thumb](https://img.itch.zone/aW1nLzI0OTQ5MTM4LmpwZw==/original/4Uxmp8.jpg) | لعبة الدودة | Yassine Game | ستجدون منصة ثنائية الابعاد انت هو الدودة النقطة الصفراء هي الطع٠(see more on itch.io) | [Link](https://yassine-game.itch.io/snak-todoraki) | ? | | No |
-6
View File
@@ -1,6 +0,0 @@
# Card Game Games (1 games)
| No | Thumb | Name | Dev | Short Desc | Link | Safe | Notes | NSFW |
|----|-------|------|-----|------------|------|------|-------|------|
| 1 | ![thumb](https://img.itch.zone/aW1nLzI0Njk2NjE2LnBuZw==/original/Vgoo1L.png) | Bomb Game | Sam Zalkin | Bomb Game is a multiplayer card and party game that tests players ability to strategize quickly. (see more on itch.io) | [Link](https://szalkin.itch.io/bomb-game) | ? | | No |
-6
View File
@@ -1,6 +0,0 @@
# Interactive Fiction Games (1 games)
| No | Thumb | Name | Dev | Short Desc | Link | Safe | Notes | NSFW |
|----|-------|------|-----|------------|------|------|-------|------|
| 1 | ![thumb](https://img.itch.zone/aW1nLzI0ODQ0NDU2LnBuZw==/original/GXFG04.png) | T'as du courrier ! | Flaminiop | Ce jeu est en français / This game is in French ! T'as du courrier ! Mais qui a bien pu t'écrire ? Découvre toutes les possibilités en combinant les mots clefs. (see more on itch.io) | [Link](https://flaminiop.itch.io/courrier) | ? | | No |
-13
View File
@@ -1,13 +0,0 @@
# Other Games (8 games)
| No | Thumb | Name | Dev | Short Desc | Link | Safe | Notes | NSFW |
|----|-------|------|-----|------------|------|------|-------|------|
| 1 | ![thumb](https://img.itch.zone/aW1nLzI0OTQ4NDEwLnBuZw==/original/fiFfnV.png) | 4x4 Tic Tac Toe | patretro | Tic Tac Toe on a 4x4 grid. (see more on itch.io) | [Link](https://patretro.itch.io/4x4-tic-tac-toe) | ? | | No |
| 2 | ![thumb](https://img.itch.zone/aW1nLzI0ODAxODY0LmpwZw==/original/Fx7fwK.jpg) | C++ Console Games | Elise Hunter | This project contains two C++ console games developed for my Games Programming 1 coursework. (see more on itch.io) | [Link](https://hunterelise.itch.io/console-games) | ? | | No |
| 3 | ![thumb](https://img.itch.zone/aW1nLzI0ODA0MDIwLnBuZw==/original/v4DUIB.png) | Crisis at the Skydome | Cause It's On Tap Games | Pop Pop Pop Welcome to the ultimate arcade balloon-popping challenge. (see more on itch.io) | [Link](https://causeitsontapgames.itch.io/crisis-at-the-skydome) | ? | | No |
| 4 | ![thumb](https://img.itch.zone/aW1nLzI0ODEyNjk5LnBuZw==/original/zQgeps.png) | Custodian | FoxhoundProductions | A short fps horror experience I made with Unity in 2 months. (see more on itch.io) | [Link](https://foxhoundproductions.itch.io/custodian) | ? | | No |
| 5 | ![thumb](https://img.itch.zone/aW1nLzI0OTQ2OTExLnBuZw==/original/UBcEi4.png) | Mary | kiraisin | No description | [Link](https://kiraisin.itch.io/mary) | ? | | No |
| 6 | ![thumb](https://img.itch.zone/aW1nLzI0OTQ4OTc3LnBuZw==/original/jkK6YZ.png) | Neo Chase - Endless runner | Jeffrey Desenfans | No description | [Link](https://slipshod.itch.io/neo-chase) | ? | | No |
| 7 | ![thumb](https://img.itch.zone/aW1nLzI0OTQ3MTg2LnBuZw==/original/9suJNz.png) | This Part of Mine : Black Raincoat (ไทย) | SawieNoowie | This Part of Mine : Black Raincoat นี่คือจุดเริ่มต้นเรื่องราวของ "ริน" นักสืบหนุ่มวัย 21 ปี เขาม... (see more on itch.io) | [Link](https://sawienoowie.itch.io/this-part-of-mine) | ? | | No |
| 8 | ![thumb](https://img.itch.zone/aW1nLzI0ODQ1MzE1LnBuZw==/original/akBw1M.png) | 相连 Let Connect | Unknown | 相连 Let Connect Let Connect is a short narrative-driven game about human connections across a lifetime. (see more on itch.io) | [Link](https://akane13.itch.io/let-connect) | ? | | No |
-10
View File
@@ -1,10 +0,0 @@
# Platformer Games (5 games)
| No | Thumb | Name | Dev | Short Desc | Link | Safe | Notes | NSFW |
|----|-------|------|-----|------------|------|------|-------|------|
| 1 | ![thumb](https://img.itch.zone/aW1nLzI0ODQ0NTA4LnBuZw==/original/xHOa%2BE.png) | Danglin’ Froggo | meownsk | In the mysterious depths of the cave, where light exists only in the reflections of crystals, something dwells. (see more on itch.io) | [Link](https://meownsk.itch.io/danglin-froggo) | ? | | No |
| 2 | ![thumb](https://img.itch.zone/aW1nLzI0OTI0MTE3LmdpZg==/originalm/mJNpnQ.gif) | Grabbity | Unknown | Grabbity is a short gravity-shifting platforming adventure game where you control a rabbit collecting carrots in space! On the eve of the annual rabbit festival, a terrible truth is revealed for th... (see more on itch.io) | [Link](https://srcheese44.itch.io/grabbity) | ? | | No |
| 3 | ![thumb](https://img.itch.zone/aW1nLzI0ODEzODE0LnBuZw==/original/xhxXjs.png) | Pofuduk Kacis | komarusg | Endless runner game made with free assets and some of my own pixel art. (see more on itch.io) | [Link](https://komarusg.itch.io/pofuduk-kacis) | ? | | No |
| 4 | ![thumb](https://img.itch.zone/aW1nLzI0ODEyODc4LnBuZw==/original/gTOR2k.png) | Squared Adventure | Newc42 | Squared Adventure Hi! I created this game a few years ago, and although it looks like a  poor asset flip made by a high school student, it turned out to be pretty good in the end. (see more on itch.io) | [Link](https://newc-42.itch.io/squared-adventure) | ? | | No |
| 5 | ![thumb](https://img.itch.zone/aW1nLzI0OTQ3ODA0LnBuZw==/original/fkQA6t.png) | Superball! | redtine | Every two months I try to create a new project, this time it is a short and simple monkeyball clone. (see more on itch.io) | [Link](https://redtine.itch.io/superball) | ? | | No |
-7
View File
@@ -1,7 +0,0 @@
# Puzzle Games (2 games)
| No | Thumb | Name | Dev | Short Desc | Link | Safe | Notes | NSFW |
|----|-------|------|-----|------------|------|------|-------|------|
| 1 | ![thumb](https://img.itch.zone/aW1nLzI0NDIyMDY2LnBuZw==/original/zhlQMc.png) | Cipher's Chamber | Unknown | Agent Spay must puzzle their way through a routine training simulation. (see more on itch.io) | [Link](https://reginald14320.itch.io/ciphers-chamber) | ? | | No |
| 2 | ![thumb](https://img.itch.zone/aW1nLzI0NjQ4ODgyLnBuZw==/original/zwh87f.png) | Steal Santa's Pills | Capybaraforce | Do you hate Christmas? Of course you do, everybody does. (see more on itch.io) | [Link](https://capybaraforce.itch.io/santas-pills) | ? | | No |
-7
View File
@@ -1,7 +0,0 @@
# Racing Games (2 games)
| No | Thumb | Name | Dev | Short Desc | Link | Safe | Notes | NSFW |
|----|-------|------|-----|------------|------|------|-------|------|
| 1 | ![thumb](https://img.itch.zone/aW1nLzI0NzQxMDQzLnBuZw==/original/b%2F9oyz.png) | Autopede | FireBlaze236 | Race through the streets using your quadruped/biped car. (see more on itch.io) | [Link](https://fireblaze236.itch.io/autopede) | ? | | No |
| 2 | ![thumb](https://img.itch.zone/aW1nLzI0NjczNzQ1LnBuZw==/original/zIi5TJ.png) | SPEED KIDD | Studio77Dev | Speed Kidd is a retro racing game for the Game Boy where you participate in the World Tour, a championship that will take you across 12 different tracks (both real and fictional) around the world i... (see more on itch.io) | [Link](https://studio77dev.itch.io/speedkidd) | ? | | No |
-6
View File
@@ -1,6 +0,0 @@
# Rhythm Games (1 games)
| No | Thumb | Name | Dev | Short Desc | Link | Safe | Notes | NSFW |
|----|-------|------|-----|------------|------|------|-------|------|
| 1 | ![thumb](https://img.itch.zone/aW1nLzI0OTQ4ODkyLnBuZw==/original/nvGw45.png) | twohops | mun09 | Try this game when drinking with your friends (see more on itch.io) | [Link](https://mun09.itch.io/twohops) | ? | | No |
Loaded 100 of 441 files, more files were not shown because too many files have changed in this diff. Show more