Compare commits

...
586 Commits
Author SHA1 Message Date
poli0981andClaude Opus 5.5 1323886ccc chore(deps): weekly sweep 2026-11-16, release 4.6.2 (#195)
Dependabot #190-#194 combined with Zustand 5.1.0, soupsieve 4.1, coverage 7.17.3, Ruff 0.17.5 and a cargo update (wry 0.57.2, tauri-plugin-opener 2.7.3), each past a 3-day cooldown; Wrangler 4.161.0 with regenerated Worker types; tapable held at 2.3.3. Version 4.6.2 with a short changelog entry.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-16 07:20:14 +07:00
github-actions[bot] 9248bad763 Ingest queued games [2026-11-15] 2026-11-15 20:24:18 +00:00
freeitchgames-admin[bot] bd0272efd9 Queue 4 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://brainbox.itch.io/seven-spells-of-destruction
https://landfishgames.itch.io/pufferfish-on-land
https://neon-ark.itch.io/harvest-keep
https://untitled-draft-studio.itch.io/accidental-hotpot
2026-11-15 20:23:55 +00:00
github-actions[bot] 60d85fc2ed Ingest queued games [2026-11-15] 2026-11-15 16:24:29 +00:00
freeitchgames-admin[bot] 5f6cf32a09 Queue 6 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://keltime.itch.io/fanta-stic
https://le3sa.itch.io/stay-on-the-line-narrative-horror
https://legocraft1000.itch.io/hatsune-mikus-bouncing-odyssey
https://m1rrarr.itch.io/gakuen-high-school-basketball-club
https://songim.itch.io/bounce-back-soon
https://kikamack.itch.io/bard-builder
2026-11-15 16:23:59 +00:00
github-actions[bot] 8dbb016a24 Ingest queued games [2026-11-15] 2026-11-15 12:25:03 +00:00
freeitchgames-admin[bot] 0471cad05b Queue 17 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://adamdjames.itch.io/bin-wizards-lost-tape
https://asabirdnest.itch.io/peregrination
https://bluerose404.itch.io/milk-from-his-body
https://bubuzukegames.itch.io/16heroes
https://frythox.itch.io/ashers-last-confession
https://grossgirlgames.itch.io/the-human-the-omega
https://ltorrao.itch.io/angueira
https://rxnna.itch.io/inspottery
https://savidovey.itch.io/rue-the-day
https://shamina101.itch.io/morose-placidity
https://thetallyman.itch.io/tallyman
https://valkyriejuni.itch.io/torture-shu-itsuki
https://jbhatab.itch.io/ashen-crown-staging
https://lackedragon.itch.io/alchemy-of-beast-demo
https://mattte.itch.io/hyper-clashers
https://patricias.itch.io/adulttale-chara-costume
https://tarjan.itch.io/gates-of-integrity
2026-11-15 12:23:55 +00:00
github-actions[bot] 28b99a5379 Ingest queued games [2026-11-15] 2026-11-15 04:24:02 +00:00
freeitchgames-admin[bot] 96e1974485 Queue 7 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://ariesne.itch.io/quack-quack
https://flygogo.itch.io/drain-it-all
https://gemesplayyt.itch.io/literally-numberslop-ever-android-port
https://syfty0.itch.io/vibe-card
https://thebaldporter.itch.io/osseocayniosseocarnipneumonoulpseudopseuthyroparat-android-port
https://thebaldporter.itch.io/qwertyuiopasdfghjklzxcvbnm-android-port
https://thebaldporter.itch.io/the-king-of-numberslop-android-port
2026-11-15 04:23:24 +00:00
github-actions[bot] 0a24ea24b3 Refresh catalog [2026-11-15] 2026-11-15 03:35:18 +00:00
github-actions[bot] a63149fd87 Ingest queued games [2026-11-15] 2026-11-15 00:24:51 +00:00
freeitchgames-admin[bot] cd035fe847 Queue 7 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://alderdevstudio.itch.io/only-when-no-ones-watching
https://cumic06.itch.io/serendipity
https://lampbearergames.itch.io/otherworld-sovereign
https://orchida.itch.io/carnation-girls-chapter-1
https://prismaticspurt.itch.io/echo-pool
https://reahanamd.itch.io/nine-lives-one-bad-day
https://spaseengineer.itch.io/madoka-magica-portable-rus
2026-11-15 00:24:12 +00:00
github-actions[bot] ffed55b4ad Ingest queued games [2026-11-14] 2026-11-14 20:24:04 +00:00
freeitchgames-admin[bot] 1ce3dd6027 Queue 3 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://aealosoftware.itch.io/limbo
https://kyo-hei.itch.io/hellversus
https://subair77.itch.io/literasi-mb
2026-11-14 20:23:39 +00:00
github-actions[bot] 33c838ff4d Ingest queued games [2026-11-14] 2026-11-14 16:24:57 +00:00
freeitchgames-admin[bot] 039c331255 Queue 12 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://asn7.itch.io/jjkfight
https://hachuw.itch.io/sebelum-tengah-malam
https://jugofmilk.itch.io/operation-117
https://lobsterlinguine.itch.io/a-case-of-observed-fantasy
https://miand.itch.io/una-tarde-con-william
https://qoawallpa.itch.io/valley
https://redacted-pickle.itch.io/karl-and-max
https://sebastiansalas94.itch.io/lucky-bingo
https://shin8byte.itch.io/yokuyubyo
https://stubby-artist.itch.io/slime-rave
https://the-hidden-king.itch.io/deadlock-the-hidden-story
https://threefoundseven.itch.io/the-last-summer-of-shizume
2026-11-14 16:24:03 +00:00
github-actions[bot] 9ccea08949 Ingest queued games [2026-11-14] 2026-11-14 12:25:04 +00:00
freeitchgames-admin[bot] 85efb46b18 Queue 17 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://al-pastorcito2.itch.io/little-treasure
https://alex-created.itch.io/killer-cory-christmas
https://blackwellstudio.itch.io/silentlaughter
https://forged-interactive.itch.io/the-ascension-experience-2
https://inzuri.itch.io/conga-hell
https://jessica-joyce-fisher.itch.io/time-for-a-cuppa
https://kenzakustudiogame.itch.io/21-hearts
https://kkairos.itch.io/what-happens-to-nelly-bryce
https://marigoldpetals.itch.io/the-other-end
https://rurumachin.itch.io/white-knight-syndrome
https://starwanderer7.itch.io/future-memory-origin
https://zqxv666.itch.io/everyday-life
https://boiler700.itch.io/slay-the-goblinz
https://gemesplayyt.itch.io/lolpeephone
https://gemesplayyt.itch.io/shmurgendurgenburgendurgen
https://gemesplayyt.itch.io/welcome-to-indonesian-techtok-bradar
https://lidoli.itch.io/shadow-kanji-simulator
2026-11-14 12:23:57 +00:00
github-actions[bot] 5e73cb6307 Ingest queued games [2026-11-14] 2026-11-14 04:24:03 +00:00
freeitchgames-admin[bot] 86e32afeae Queue 5 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://abhimonk.itch.io/spectral-slash
https://fitnessvr.itch.io/city-run-vr
https://nicthethicc.itch.io/dungeon-janitor
https://objetdiscret.itch.io/tai-fab-kitchen
https://yiskr.itch.io/moon-jar-dokkaebi
2026-11-14 04:23:27 +00:00
github-actions[bot] f0926ea91e Refresh catalog [2026-11-14] 2026-11-14 03:34:45 +00:00
github-actions[bot] ad61b6f736 Ingest queued games [2026-11-14] 2026-11-14 00:24:35 +00:00
freeitchgames-admin[bot] bf99b22cb8 Queue 4 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://allotropygames.itch.io/taso-idle
https://amirulrsly.itch.io/mazequiz-prototype1
https://sam-yam.itch.io/braindead
https://shootingstarrfish.itch.io/devil-gacha-nightmare
2026-11-14 00:24:11 +00:00
github-actions[bot] a21ba34f73 Ingest queued games [2026-11-13] 2026-11-13 20:24:19 +00:00
freeitchgames-admin[bot] af30660cb5 Queue 2 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://wondereater.itch.io/angelegg
https://donbardon.itch.io/the-gullets
2026-11-13 20:23:56 +00:00
github-actions[bot] 9def50fb29 Ingest queued games [2026-11-13] 2026-11-13 16:24:38 +00:00
freeitchgames-admin[bot] 99ad93a773 Queue 8 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://chengjamie8.itch.io/ocean-archive-what-did-you-eat
https://comictm.itch.io/oubliette-duels
https://fablecrush.itch.io/the-moon-court
https://giulianag.itch.io/la-sombra-del-pasillo
https://goodmorningdev.itch.io/god-hates-dinosaurs
https://kobatax-office.itch.io/boki3-club
https://nanaimibuenamor.itch.io/nanai-mi-buen-amor
https://yukai-games.itch.io/its-just-a-game
2026-11-13 16:24:01 +00:00
github-actions[bot] 01b66d7e3b Ingest queued games [2026-11-13] 2026-11-13 12:25:17 +00:00
freeitchgames-admin[bot] ec5c10e2c2 Queue 17 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://aira2.itch.io/snowsync
https://anychii.itch.io/vucic-dating-sim
https://dialobic2.itch.io/codexmetamorphosis
https://eggplant-eater.itch.io/finding-obama
https://fractalgames.itch.io/time-oclock-mask-of-crime
https://lazzurit.itch.io/zero-round
https://lungchen.itch.io/the-backstage-memories-with-echo-yue
https://namariaa.itch.io/between-corpses-and-secrets
https://oddroam.itch.io/invectra
https://shikosama.itch.io/together-we-thrive
https://studiominaz.itch.io/una-sangre
https://theslopfactory.itch.io/mario
https://charger0277.itch.io/blue-max-md
https://kenamick.itch.io/psiral
https://norisekiya.itch.io/parking-tycoon
https://nubick.itch.io/vumka
https://thearcabe.itch.io/space-funeral-halloween-hack
2026-11-13 12:24:02 +00:00
github-actions[bot] b20b595eab Ingest queued games [2026-11-13] 2026-11-13 04:24:23 +00:00
freeitchgames-admin[bot] 3ddca7b568 Queue 3 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://blake-gocey.itch.io/birds-are-not-real
https://lidoli.itch.io/goat-climb
https://noanoa.itch.io/echo-noein-battlefront
2026-11-13 04:23:54 +00:00
github-actions[bot] 7796ca803e Refresh catalog [2026-11-13] 2026-11-13 03:35:25 +00:00
github-actions[bot] 4bff5046dc Ingest queued games [2026-11-13] 2026-11-13 00:24:03 +00:00
freeitchgames-admin[bot] d970a9a07d Queue 3 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://desertsoftime.itch.io/angel-of-hot-topic
https://oddjuanaout.itch.io/norma
https://techtips34.itch.io/a-day-at-work
2026-11-13 00:23:44 +00:00
github-actions[bot] e6988a98f1 Ingest queued games [2026-11-12] 2026-11-12 20:24:30 +00:00
freeitchgames-admin[bot] 6d686ec7c5 Queue 3 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://littlelanterngamestudio.itch.io/oh-my-gold
https://shinobiz72.itch.io/moonpatrol
https://mezrazhang.itch.io/bifurcation
2026-11-12 20:24:04 +00:00
github-actions[bot] a2a4af2cfa Ingest queued games [2026-11-12] 2026-11-12 16:24:56 +00:00
freeitchgames-admin[bot] bdeeba4300 Queue 7 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://bakubs.itch.io/noise
https://jesmer7.itch.io/red-rum
https://prettylittlesai-ko.itch.io/king-duck
https://sellessnee.itch.io/bleeding-love-new
https://sellessnee.itch.io/scent-of-roses
https://sunflowerdenpa.itch.io/rotten-love
https://thinkaboutitgames.itch.io/the-love-of-my-life
2026-11-12 16:24:18 +00:00
github-actions[bot] 9e04cde12b Ingest queued games [2026-11-12] 2026-11-12 12:24:54 +00:00
freeitchgames-admin[bot] fce440d361 Queue 9 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://ghostible.itch.io/day-of-a-doll
https://hypnoto.itch.io/dont-leak-the-chip
https://skoczek.itch.io/third-wind
https://airapport.itch.io/idle-tower-builder
https://appsir.itch.io/climb-knight
https://mahmoudhan.itch.io/horror-maze
https://opanyu.itch.io/hellcaster
https://tri-state-crew.itch.io/fs25-diamond-c-trailers
https://wakedk.itch.io/increstellar
2026-11-12 12:24:14 +00:00
github-actions[bot] 580819c8e1 Ingest queued games [2026-11-12] 2026-11-12 08:24:19 +00:00
freeitchgames-admin[bot] 45d8febc16 Queue 4 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://riley-clark.itch.io/pale-white-crown
https://dungeontable.itch.io/opulence-of-exquisite-caliber
https://deafwild42.itch.io/last-coal-of-the-holler
https://dungeontable.itch.io/balthazars-legacy-cairn-2e
2026-11-12 08:23:53 +00:00
github-actions[bot] 28cd32d31e Ingest queued games [2026-11-12] 2026-11-12 04:24:06 +00:00
freeitchgames-admin[bot] 65f2130cb8 Queue 7 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://alexisgelin.itch.io/find-the-clover
https://dadddydarko.itch.io/scrapyard-robot-mobile
https://evil-nidal.itch.io/rewindscape-out-of-tracking
https://ophanimkei.itch.io/omma
https://pizza-tower-19-plus.itch.io/noises-halloween-bash
https://playfactorynz.itch.io/yes
https://programancer.itch.io/mangore-the-magnificent
2026-11-12 04:23:30 +00:00
github-actions[bot] ed75e49f1b Refresh catalog [2026-11-12] 2026-11-12 03:34:56 +00:00
github-actions[bot] 7a1daa1704 Ingest queued games [2026-11-12] 2026-11-12 00:24:25 +00:00
freeitchgames-admin[bot] 1a2f1ce855 Queue 4 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://chapherestudios.itch.io/all-i-needed-was-an-aurora
https://leoght-studio.itch.io/tianxia
https://narrappp.itch.io/love-my-way
https://ubetuk.itch.io/novellafancool
2026-11-12 00:23:19 +00:00
freeitchgames-admin[bot] 051748efc6 Queue 12 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://bannerfall.itch.io/siege-wing
https://ccchesh.itch.io/dodoroma
https://demonmode.itch.io/living-mine
https://frostleafgames.itch.io/infinigon
https://gemesplayyt.itch.io/slysh-ty-hater-sashi-i-tani-remastered-android-port
https://giacodev.itch.io/helbreath-idle
https://heartclicker.itch.io/heartclicker
https://independentfish.itch.io/shrink-ray-roulette
https://jannituts.itch.io/minecrillion
https://macgdc.itch.io/microgame-jam-2026
https://razib-jahan-ferdous.itch.io/300-feet-grand-prix
https://shkerebertgames.itch.io/spinsmash
2026-11-11 20:23:19 +00:00
github-actions[bot] 750207531b Ingest queued games [2026-11-11] 2026-11-11 16:24:57 +00:00
freeitchgames-admin[bot] 3da8bd7c31 Queue 15 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://cleyw07.itch.io/contalmaster
https://computerfish.itch.io/cyranoid
https://forgottenrainynights.itch.io/wheretherearenoangels
https://ghostfuneral.itch.io/angel-city
https://hyperthinks.itch.io/superposition
https://istoleyurvamps.itch.io/a-date-with-the-silver-fuller-a-fangame
https://jessmck.itch.io/turn-a-new-leaf
https://kaninbun.itch.io/godotproject
https://mattemade.itch.io/yamada-days
https://nxt-maru.itch.io/reika-wants-you
https://okyeswe.itch.io/lunacy
https://repuestopersonal.itch.io/the-circus-of-love
https://snugboat11.itch.io/yonder
https://spectraldoe.itch.io/the-developer
https://veriyerisgames.itch.io/yuri-lilith
2026-11-11 16:23:57 +00:00
poli0981andClaude Fable 5.2 0e0e442de5 chore: maintenance mode, Qodana analysis; 4.6.1 (#188) [skip-discuss]
The project moves to maintenance mode (stable, feature-complete): docs, templates and badges (EN + VI). Qodana analysis in CI for the TypeScript / JavaScript, Python and Rust projects, with the findings of its first reports fixed. Version 4.6.1.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
2026-11-11 21:44:32 +07:00
github-actions[bot] dddb6e41c2 Ingest queued games [2026-11-11] 2026-11-11 08:25:42 +00:00
freeitchgames-admin[bot] 15360c73b9 Queue 20 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://ballmuncha6.itch.io/monoautonomy
https://bax888.itch.io/digimahou
https://chiwirin.itch.io/survive-the-alien
https://dew-xx.itch.io/vermis-mentis-mental-virus
https://dreamfishing.itch.io/ego-paradox
https://frillysquiid.itch.io/paradiseinaroom
https://giopara.itch.io/have-mercy-on-me
https://hallow-cat.itch.io/my-neighbor-maria
https://hazel-traveler.itch.io/appelle
https://lkx1121-gif.itch.io/the-limits-of-love
https://mcq-heartmark.itch.io/sea-swallow-me-whole
https://pathos-soft.itch.io/eclipsing-binary-star
https://pinkfiremage.itch.io/my-eyes-are-a-lens
https://shin8byte.itch.io/dear-night
https://sinnia.itch.io/human-food-concept
https://spoogyoogie.itch.io/earths-last-live
https://tc-arcade.itch.io/case-zero-episode-1
https://thedragonslair.itch.io/morph
https://vilajur.itch.io/whatwillremainch1
https://wiosnavn.itch.io/spring-after-piracy
2026-11-11 08:24:23 +00:00
github-actions[bot] 88827b4cc7 Refresh catalog [2026-11-11] 2026-11-11 03:35:20 +00:00
github-actions[bot] 0331b4dd4f Ingest queued games [2026-11-11] 2026-11-11 00:24:22 +00:00
freeitchgames-admin[bot] 0e0e335624 Queue 14 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://amotohajime.itch.io/kingdom-estate-clicker
https://ashikaze.itch.io/spiro-idle
https://brainfog-games.itch.io/logo-idle
https://collegeready.itch.io/stratus-university
https://gernata.itch.io/paws-menu
https://jeevejayla.itch.io/tails-from-alteria
https://kirby2000.itch.io/great-giana-sisters-zx
https://lowcarb.itch.io/eyedball-c64
https://mrylxy.itch.io/the-midnight-troupe
https://mymadnessworks.itch.io/guesthour
https://osisama-2525.itch.io/dice-no-shun-tatupu
https://pacdude.itch.io/supermarket-spree-dx
https://ptik-devs.itch.io/ar-3d-bencana-alam
https://basicbean.itch.io/i-accidentally-time-traveled-to-the-year-2088-and-all-i-want-to-do-is-wash-my-ro
2026-11-11 00:23:26 +00:00
poli0981andClaude Fable 5.2 b73661b438 docs: games must be playable or downloadable on the itch.io page itself (#187)
Issue #186 suggested a game whose itch.io page has no upload and no
browser build: the game comes from a launcher on the developer's own
site, behind an account. The scraper sees no buy row and calls such a
page free, and nothing in the contributing guide or the Add Games
templates said it doesn't qualify, although the Disclaimer (§4) tells
visitors that any download happens on itch.io.

State the rule in CONTRIBUTING (EN + VI) and add a matching check to
the Add Games issue form and PR template. No policy text changes.

Co-authored-by: Claude Fable 5.2 <noreply@anthropic.com>
2026-11-10 22:47:04 +07:00
github-actions[bot] 2463f52377 Ingest queued games [2026-11-10] 2026-11-10 08:23:50 +00:00
freeitchgames-admin[bot] 473fa2e8c1 Queue 5 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://fluffyblessing.itch.io/aeris-alis
https://jiaqizhang11.itch.io/when-the-phone-lights-up
https://maxdemage.itch.io/k-pop-manager
https://mintteag.itch.io/daily-assembly
https://real-school.itch.io/the-same-evening
2026-11-10 08:23:21 +00:00
github-actions[bot] 206a86cf4e Ingest queued games [2026-11-10] 2026-11-10 04:24:17 +00:00
freeitchgames-admin[bot] fd213694b2 Queue 12 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://aesprion.itch.io/nib
https://basket-cat.itch.io/the-lindwyrms-test
https://br0kenleg.itch.io/recall-vn
https://coordinatedmoths.itch.io/performance-review
https://doksa.itch.io/ursa-major
https://gnomesanddreams.itch.io/anotherswill
https://missm1.itch.io/cmo-romperme-por-dentro
https://mookichuu.itch.io/guilty-pleasure
https://oxymorondev.itch.io/girl
https://quilm.itch.io/pridegoeth
https://snadwichwich.itch.io/sailing-sentiments
https://thecrimsondm-vanillia.itch.io/solar-reborn-reincarnated-as-myself
2026-11-10 04:23:25 +00:00
github-actions[bot] c89071d8cf Refresh catalog [2026-11-10] 2026-11-10 03:35:12 +00:00
github-actions[bot] 891d9dd39e Ingest queued games [2026-11-09] 2026-11-09 20:24:02 +00:00
freeitchgames-admin[bot] 4684be0259 Queue 5 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://emlise.itch.io/seasonshift
https://gimugimu-games.itch.io/slot-factory
https://gwilym.itch.io/the-deconsecration-initiative
https://krokozavrgame.itch.io/horror2026
https://lee-courgette.itch.io/pluvia
2026-11-09 20:23:26 +00:00
github-actions[bot] 3ba92005db Ingest queued games [2026-11-09] 2026-11-09 16:26:24 +00:00
freeitchgames-admin[bot] 459ccd9640 Queue 14 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://aquaapple.itch.io/the-remains
https://azagamestudio.itch.io/dead-faces
https://cybermeatgames.itch.io/cash-sins
https://elysium64.itch.io/amaurote
https://hocjourney.itch.io/hocduky
https://krakovia-evm.itch.io/project-zero
https://loldevteam.itch.io/fs25-grove-crane-edit
https://loldevteam.itch.io/fs25-toc-ford-util-box-truck-edit
https://n3at18.itch.io/this-desert-wont-vacuum-itself
https://overheadgames.itch.io/boosterware
https://pataplouf75.itch.io/ancient-fronts
https://retrodnagames.itch.io/amiga-1942
https://retrodnagames.itch.io/amiga-outrun-aga
https://shinobiz72.itch.io/wonder-boy-in-monster-land-mega-drive-genesis-v10
2026-11-09 16:23:38 +00:00
poli0981andClaude Opus 5.5 1f21576162 docs(a11y): record the VoiceOver test on a real iPhone (#185)
The 4.6.0 website passed the owner's VoiceOver test on an iPhone 14 Pro in Safari, Chrome and Brave; ACCESSIBILITY.md (+ VI) and CLAUDE.md record it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-09 16:24:26 +07:00
github-actions[bot] b467aa9dc9 Ingest queued games [2026-11-09] 2026-11-09 08:24:09 +00:00
freeitchgames-admin[bot] 927109d9d2 Queue 12 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://dadoudouoo.itch.io/the-last-ingredient
https://gallows-t.itch.io/i-dont-act-anymore
https://goofanader.itch.io/detective-maika-and-the-halloween-surprise
https://hollisgray.itch.io/digital-footprint
https://loucode.itch.io/mansion-escape
https://mookichuu.itch.io/killing-time
https://nyxx5792.itch.io/mycelium-of-stars
https://pabo-okkii.itch.io/okkii-ai
https://scalesofstars.itch.io/one-night-only
https://someghost0.itch.io/the-ghostly-hour-diner
https://the-monochrome-phoenix.itch.io/my-personal-demons-scheme-with-a-professional-flare
https://wandeer.itch.io/hero-gone-mad
2026-11-09 08:23:21 +00:00
poli0981andClaude Opus 5.5 047d918d43 feat: accessibility statement, keyboard/screen-reader/chart/contrast fixes; 4.6.0 (#183) [skip-discuss]
Accessibility pass for the website and the apps (WCAG 2.2 AA target) and the accessibility statement: root ACCESSIBILITY.md + docs/i18n/vi/ACCESSIBILITY.md, the accessibility issue form, a default PR template; focus management, the '/' shortcut switch, chart names and data tables, contrast tokens with a CI check, Windows contrast themes; a docs sync of verified mismatches; version 4.6.0 with the two deps sweeps since 4.5.0 (#176, #182).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-09 14:16:50 +07:00
github-actions[bot] 4046408157 Refresh catalog [2026-11-09] 2026-11-09 03:35:09 +00:00
github-actions[bot] f0826ee9e9 Ingest queued games [2026-11-09] 2026-11-09 00:25:34 +00:00
freeitchgames-admin[bot] 4d43638d51 Queue 10 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://halconix.itch.io/mixed-signals
https://madebycyber.itch.io/lastale-a-glass-of-memory
https://mrsleeps.itch.io/the-mushroom-legend
https://rurudayo.itch.io/of-flowers-and-space
https://studio-maocha.itch.io/dress-the-colorblind-lady
https://totallyaccuratecoding.itch.io/charon
https://whatthehek.itch.io/chromameowncy
https://yanrx.itch.io/if-this-reaches-you
https://zachyee.itch.io/far-from-home-browser-build
https://zhuluot.itch.io/please-accept-my-resume
2026-11-09 00:23:18 +00:00
poli0981andClaude Opus 5.5 42d69da957 chore(deps): weekly sweep 2026-11-09 (#182)
* chore(deps): weekly sweep 2026-11-09

Dependabot #177-#181 combined, plus what Dependabot had not opened,
all past the 3-day cooldown:

- npm: TanStack Query 5.106.1, vitest + @vitest/coverage-v8 5.1.0,
  vite 8.3.6, @vitejs/plugin-react 6.2.1, Tailwind 4.3.4, eslint 10.14.0,
  knip 6.44.1, wrangler 4.158.0 (worker-configuration.d.ts regenerated),
  jose 6.2.15, globals 17.14.0, lucide-react 1.69.0
- Python (pip-tools on 3.14): soupsieve 4.0.1, coverage 7.17.2, ruff 0.17.4
- Actions: actions/setup-java v6.2.0, sonarqube-scan-action v8.4.1
- cargo: wasm-bindgen 0.2.130 family, log, mime, toml, jiff, cc and others

Held back by the cooldown: zustand 5.1.0, TanStack 5.107, jose 6.2.16,
knip 6.44.2, Tailwind 4.3.5, flate2 / uuid / smallvec / serde_spanned.

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

* docs(claude): note the 2026-11-09 deps sweep

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

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-09 07:16:30 +07:00
github-actions[bot] ed3b89fcca Ingest queued games [2026-11-08] 2026-11-08 20:24:08 +00:00
freeitchgames-admin[bot] 8afc98641c Queue 13 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://goatyflower.itch.io/please-i-dont-want-endless-love-anymore
https://gutsydemise.itch.io/soul-bound
https://jflecole.itch.io/neon-debt
https://kira-ith.itch.io/etoile-rouge
https://manyface.itch.io/the-great-gate-of-black-stone
https://niaauoo.itch.io/datelinetdb
https://radoin.itch.io/8-minutes
https://wolfberry-f.itch.io/lighter
https://cozy-games-from-the-hell.itch.io/captwist
https://elite-nameless.itch.io/datatheft
https://gatotin024.itch.io/shovikmiheart
https://level102.itch.io/echoloc
https://paledoptera.itch.io/no-cats
2026-11-08 20:23:17 +00:00
github-actions[bot] fb5175b699 Ingest queued games [2026-11-08] 2026-11-08 08:24:11 +00:00
freeitchgames-admin[bot] 84942ac369 Queue 11 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://ashthedreamchaser.itch.io/immortal-huntress
https://edenringgo.itch.io/recloverschool-chapter1
https://gremlintheodd.itch.io/maggies-bad-day
https://hopthemoon.itch.io/odichat
https://karme2.itch.io/nosferat
https://mindyorzi.itch.io/lian-gogogo
https://selamoonix.itch.io/irvines-school-of-romance-simulator
https://shina1320.itch.io/cihuacatl
https://thegrandstudio.itch.io/a-cold-day-in-port-calloway
https://totemmore.itch.io/enigmore
https://wiwa-4444.itch.io/pistachio-3d
2026-11-08 08:23:20 +00:00
github-actions[bot] 1dc1cdb08d Refresh catalog [2026-11-08] 2026-11-08 03:35:04 +00:00
github-actions[bot] 89ef8602ec Ingest queued games [2026-11-07] 2026-11-07 20:24:50 +00:00
freeitchgames-admin[bot] a7f53f44bc Queue 2 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://prime-mt.itch.io/hz-modugg
https://tianfengmiao.itch.io/cup-android
2026-11-07 20:23:21 +00:00
github-actions[bot] 11654b0f26 Ingest queued games [2026-11-07] 2026-11-07 16:25:00 +00:00
freeitchgames-admin[bot] 0dd1cfb147 Queue 4 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://game-center-mayonaka.itch.io/happy-together
https://liliana666.itch.io/the-stars-are-too-far-away
https://robinloverproduction.itch.io/my-femboy-roommate-epilogue
https://t1zm.itch.io/kochou-no-ami
2026-11-07 16:23:17 +00:00
github-actions[bot] ea69cdec20 Ingest queued games [2026-11-07] 2026-11-07 12:24:01 +00:00
freeitchgames-admin[bot] 703523ce37 Queue 7 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://ahiddendev.itch.io/hidden
https://depra.itch.io/bleeding
https://leerier.itch.io/symptoms-of-devotion
https://lewarts.itch.io/the-adventures-of-lewart
https://r-f.itch.io/tower-defense
https://red-river-modding.itch.io/sorensen-welding-24r22-precision-planter
https://trey2k23.itch.io/martin-no-filter-fighters-unofficial-fan-game
2026-11-07 12:23:26 +00:00
github-actions[bot] c8df1771b0 Ingest queued games [2026-11-07] 2026-11-07 08:24:13 +00:00
freeitchgames-admin[bot] d14302281c Queue 13 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://baronxu-dev.itch.io/dont-reply-for-her-chapter-one-free
https://chanvince.itch.io/coastcafe
https://chenle444.itch.io/nightmareexchange
https://danchicu.itch.io/carl-clovers-big-mac-adventure-at-3am
https://estudioravena.itch.io/neon-love
https://flooflezmt.itch.io/regicide-at-the-regale
https://hathulinh.itch.io/lilys-wondergarden-2
https://hiviga.itch.io/goodbye-aurora
https://lil-sweet-pea.itch.io/echo
https://lucaschann.itch.io/a-story-about-corn-cob
https://malicianatashtroft.itch.io/notre-aventure
https://senroda.itch.io/nonhumans
https://wztbssb.itch.io/lantern-isle
2026-11-07 08:23:21 +00:00
github-actions[bot] 48843683c6 Ingest queued games [2026-11-07] 2026-11-07 04:23:45 +00:00
freeitchgames-admin[bot] 90a302b0c4 Queue 3 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://bitemegames.itch.io/decube
https://shinobiz72.itch.io/archived
https://thebaldporter.itch.io/i-am-undefeated
2026-11-07 04:23:22 +00:00
github-actions[bot] 740690f6ef Refresh catalog [2026-11-07] 2026-11-07 03:34:47 +00:00
github-actions[bot] 5cc16db7f7 Ingest queued games [2026-11-06] 2026-11-06 20:23:42 +00:00
freeitchgames-admin[bot] d5846a5045 Queue 2 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://debuz.itch.io/kritsana
https://nerderror.itch.io/stone-idle
2026-11-06 20:23:21 +00:00
github-actions[bot] 5b0e21018f Ingest queued games [2026-11-06] 2026-11-06 16:24:15 +00:00
freeitchgames-admin[bot] 2ccf5801eb Queue 12 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://c00lme.itch.io/red-banner-1993
https://doubledranch.itch.io/2026-peterbilt-589
https://haukazou.itch.io/sortsys
https://jessicochan.itch.io/rgm-next
https://daycutter.itch.io/caeneus
https://daylitkw.itch.io/b-side
https://ism1-ism1.itch.io/corner-cafe
https://lostworldofshe.itch.io/camp-belladona
https://mrburninghotcoals.itch.io/deep-delving-for-burning-hot-coals
https://seykafu.itch.io/ravage
https://slarvath.itch.io/deltarune-into-the-light
https://soynoveldevs.itch.io/soynovel-prototype
2026-11-06 16:23:20 +00:00
github-actions[bot] 570013d279 Ingest queued games [2026-11-06] 2026-11-06 08:24:18 +00:00
freeitchgames-admin[bot] 9372a68f35 Queue 15 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://choic-e.itch.io/whyher
https://faewails.itch.io/pentacles
https://ghostflea.itch.io/you-are-a-work-of-art
https://kaziapc.itch.io/c-akta
https://la-jam-piojenta.itch.io/2023
https://maliketh69.itch.io/the-last-bus
https://nanach1i.itch.io/danganokronpa-game-version-cap-5
https://nightdesk.itch.io/my-game-got-2-stars
https://odanizero.itch.io/the-beings-beyond-outer-space
https://otter040.itch.io/waste
https://physixio.itch.io/physix-quest
https://raraurora-png.itch.io/camp-obsession
https://xxsabrinaxx.itch.io/vila-lypia
https://zacheryellis252.itch.io/hoshizora-after-school
https://zackanuar.itch.io/heir-of-the-dog
2026-11-06 08:23:19 +00:00
github-actions[bot] bcb3895be4 Ingest queued games [2026-11-06] 2026-11-06 04:24:10 +00:00
freeitchgames-admin[bot] baf6d02eee Queue 4 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://deeddomanion.itch.io/deed-dominion
https://nerderror.itch.io/fruit-clicker
https://notsospecialgames.itch.io/testimonium
https://soodarong.itch.io/twisty-infinity
2026-11-06 04:23:43 +00:00
github-actions[bot] c53953c7dc Refresh catalog [2026-11-06] 2026-11-06 03:34:58 +00:00
github-actions[bot] 930498c62a Ingest queued games [2026-11-06] 2026-11-06 00:23:49 +00:00
freeitchgames-admin[bot] dd4405212e Queue 2 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://godaughtr.itch.io/brainsharing
https://dominoclub.itch.io/erostasis
2026-11-06 00:23:27 +00:00
github-actions[bot] fe9a83d57d Ingest queued games [2026-11-05] 2026-11-05 20:24:19 +00:00
freeitchgames-admin[bot] 366397b508 Queue 3 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://dlgkrwn02.itch.io/deulsup-dogam
https://theslantedroom.itch.io/hold-the-tide
https://garsall0p.itch.io/travelsketchbook2026
2026-11-05 20:23:52 +00:00
github-actions[bot] 9b11362b9b Ingest queued games [2026-11-05] 2026-11-05 12:23:50 +00:00
freeitchgames-admin[bot] 11fe63c6af Queue 6 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://brokenbytes.itch.io/fix-it-felix-jr-amiga
https://fayer.itch.io/muertitos
https://fayer.itch.io/palabraz
https://numberoneskull.itch.io/shmurgendurgenburgerdungen-reuploaded-all-phases
https://tarpingames.itch.io/multi-purpose-wheel-incremental
https://thelands.itch.io/ninja
2026-11-05 12:23:19 +00:00
github-actions[bot] 42934ba839 Ingest queued games [2026-11-05] 2026-11-05 08:23:57 +00:00
freeitchgames-admin[bot] a14425798d Queue 6 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://dizzyrpy.itch.io/the-plot-twist
https://fitafeet.itch.io/dissonant-friendship
https://h4ru3614.itch.io/project-a
https://muuuzita.itch.io/de-mame-para-chika
https://saifrel.itch.io/underhand
https://sommuuk.itch.io/batyr
2026-11-05 08:23:20 +00:00
github-actions[bot] bf5395aee2 Ingest queued games [2026-11-05] 2026-11-05 04:23:42 +00:00
freeitchgames-admin[bot] a028802874 Queue 2 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://gemesplayyt.itch.io/bunun-tadina-bak-android-port
https://hawke-nz.itch.io/petri
2026-11-05 04:23:22 +00:00
github-actions[bot] b9cef75d3e Refresh catalog [2026-11-05] 2026-11-05 03:35:43 +00:00
github-actions[bot] 32d06761e0 Ingest queued games [2026-11-05] 2026-11-05 00:24:41 +00:00
freeitchgames-admin[bot] 775e6f23b5 Queue 2 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://romeo-de-brito.itch.io/chre-terre
https://vampanella.itch.io/bpm
2026-11-05 00:24:21 +00:00
github-actions[bot] 3f9ceba4da Ingest queued games [2026-11-04] 2026-11-04 20:25:29 +00:00
freeitchgames-admin[bot] 0b3bfe4650 Queue 1 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://paintedhouses.itch.io/fleshtube
2026-11-04 20:24:06 +00:00
github-actions[bot] f55973daed Ingest queued games [2026-11-04] 2026-11-04 16:24:00 +00:00
freeitchgames-admin[bot] 156388d74f Queue 5 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://digifluxstudios.itch.io/exald
https://epic-works.itch.io/an-immortals-journey
https://hpotch.itch.io/unforgettable
https://larryzhao.itch.io/alchemy-merge
https://nanach1i.itch.io/danganokronpa
2026-11-04 16:23:19 +00:00
github-actions[bot] cc90fb7a2f Ingest queued games [2026-11-04] 2026-11-04 12:24:21 +00:00
freeitchgames-admin[bot] 59b4ffff69 Queue 4 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://attiach-madge.itch.io/la-o-meurs-les-toiles
https://nanaroba.itch.io/he-is-the-house
https://superail02.itch.io/which-one-do-you-desire
https://zegley.itch.io/box-out
2026-11-04 12:23:56 +00:00
github-actions[bot] 83715652fb Ingest queued games [2026-11-04] 2026-11-04 04:24:50 +00:00
freeitchgames-admin[bot] 73d1f0f578 Queue 7 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://combobombgames.itch.io/quiet-care
https://crevasse.itch.io/eco-power-towns
https://edward-la-barbera.itch.io/laszlovania
https://grave-hour-studios.itch.io/never-made-it-home
https://seenthai.itch.io/this-role-you
https://tairer.itch.io/with-bruised-blood
https://yotogi-chan.itch.io/yua-faphero
2026-11-04 04:24:05 +00:00
github-actions[bot] a0519b1850 Refresh catalog [2026-11-04] 2026-11-04 03:35:23 +00:00
github-actions[bot] 4307a4ed98 Ingest queued games [2026-11-04] 2026-11-04 00:24:55 +00:00
freeitchgames-admin[bot] 2ef7c7ef30 Queue 8 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://1296740.itch.io/tetr1zz-eternal-laugh
https://9ryuq.itch.io/morihime
https://art8black.itch.io/cs-gazpaint
https://diane1f0cd.itch.io/the-academy-love-potions-fr
https://j3ncat.itch.io/spider-ara
https://lyyycaena.itch.io/fangirl-simulator
https://spicypineneedles.itch.io/fairycorner
https://woog91.itch.io/danganronpa-r
2026-11-04 00:24:12 +00:00
github-actions[bot] 4fdb170d8b Ingest queued games [2026-11-03] 2026-11-03 20:24:37 +00:00
freeitchgames-admin[bot] 85630572af Queue 3 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://gemesplayyt.itch.io/grrmondays
https://red-anarhy173.itch.io/sprunki-peppers-take
https://rikahelleaven.itch.io/rikas-kaiju-stomp-down
2026-11-03 20:23:43 +00:00
github-actions[bot] 6a364085fa Ingest queued games [2026-11-03] 2026-11-03 16:24:49 +00:00
freeitchgames-admin[bot] 8e742b9ae7 Queue 3 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://arleco-fon.itch.io/ultima-luz-do-circo
https://nicolepires.itch.io/quem-ama-cuida-proteja-adriana
https://triss2203.itch.io/deltarune-a-new-pov
2026-11-03 16:24:22 +00:00
github-actions[bot] d017a57d84 Ingest queued games [2026-11-03] 2026-11-03 12:24:42 +00:00
freeitchgames-admin[bot] 55a2c3e2b6 Queue 7 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://alexisgelin.itch.io/idle-marble
https://chrisroger.itch.io/crimes-of-crow
https://goktug-sugar.itch.io/dusty-bones
https://jpenjoyplay.itch.io/tower-of-the-dragons-girth
https://portgatestudios.itch.io/hexlands
https://shinobiz72.itch.io/sf1987
https://leaf-tilde.itch.io/man-made-woman
2026-11-03 12:24:07 +00:00
github-actions[bot] e28ff6fc46 Ingest queued games [2026-11-03] 2026-11-03 08:24:40 +00:00
freeitchgames-admin[bot] 00b902ad48 Queue 7 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://elomarcelelo.itch.io/spolszczenie-yosuga-no-sora
https://husbandeater.itch.io/unknown-diary-owner
https://midnightwine.itch.io/stuck-hal
https://patreko.itch.io/balco-13
https://solacoder005.itch.io/zenning
https://team-auxy.itch.io/auxy-and-i
https://thebeatlesglazer6.itch.io/the-beatles-save-christmas
2026-11-03 08:24:04 +00:00
github-actions[bot] b53216e965 Ingest queued games [2026-11-03] 2026-11-03 04:24:22 +00:00
freeitchgames-admin[bot] f7eb2817b9 Queue 3 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://featurekreep.itch.io/sleigh-the-spire
https://mxretrodev.itch.io/prehistoric-isle-md
https://swagtopus.itch.io/outpost-alpha
2026-11-03 04:23:59 +00:00
github-actions[bot] 75e5a6daed Refresh catalog [2026-11-03] 2026-11-03 03:35:36 +00:00
github-actions[bot] f4f4f0fd1f Ingest queued games [2026-11-03] 2026-11-03 00:24:48 +00:00
freeitchgames-admin[bot] 73440c2563 Queue 9 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://fomit667.itch.io/mercantileghostgirl
https://joyever.itch.io/adoptmeplease
https://newcanvas.itch.io/lustration-a-detective-story
https://sakawayuna.itch.io/2640the-seventh-knock
https://sashucity.itch.io/ds
https://sleepydragonatelier.itch.io/lock-in-geek-out
https://texdev-studio.itch.io/lucys-wardrobe
https://thm-n.itch.io/borrowed-skin
https://blorengerhymes.itch.io/mosey-land
2026-11-03 00:24:04 +00:00
github-actions[bot] 18e1c6151c Ingest queued games [2026-11-02] 2026-11-02 20:24:32 +00:00
freeitchgames-admin[bot] 73623d8e89 Queue 5 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://akka11.itch.io/lucky-ticket-tycoon
https://bonnie-studios.itch.io/voxide
https://gatolinie.itch.io/undertale-vs-gojo
https://orange-boy-0.itch.io/a-game-about-building-swarms-playtest-a
https://stevenhart.itch.io/idle-brick-breaker
2026-11-02 20:23:58 +00:00
github-actions[bot] ab9c561278 Ingest queued games [2026-11-02] 2026-11-02 16:25:04 +00:00
freeitchgames-admin[bot] 658a13b883 Queue 12 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://neoprium.itch.io/snesprium
https://peanuts2.itch.io/cwr-rankhub
https://remar-games.itch.io/tower-of-gold
https://teo-tormo.itch.io/cadillacsneo
https://xeif.itch.io/kizuna-zx-spectrum
https://asterialumi.itch.io/unbecoming
https://cedula4team.itch.io/auxy-and-i
https://keilynmorera.itch.io/brulkas
https://limerenceofc.itch.io/limerence
https://penwof.itch.io/cinder-gulch
https://team-midnight.itch.io/payout
https://x0mirai0x.itch.io/face-noobs-party
2026-11-02 16:24:04 +00:00
github-actions[bot] fa62230d7e Ingest queued games [2026-11-02] 2026-11-02 08:24:36 +00:00
freeitchgames-admin[bot] 0f20bbafbe Queue 6 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://cavemanon.itch.io/volcaldera-ashfall
https://kirishisha.itch.io/neforformilfa2
https://leafyrowlet.itch.io/split-wing
https://nytraam.itch.io/spooky-escape
https://songgming.itch.io/conversation-survivor
https://the-clear-air-collective.itch.io/resident-arcwevil
2026-11-02 08:24:04 +00:00
github-actions[bot] c771302bbf Ingest queued games [2026-11-02] 2026-11-02 04:24:51 +00:00
freeitchgames-admin[bot] 99bfffc118 Queue 11 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://arclyn.itch.io/bea-is-scaring-me
https://champochuu.itch.io/tahan
https://garlicsos.itch.io/salamat-doc
https://graysodacan.itch.io/across-the-table
https://khangmera.itch.io/aethercraft
https://kzai-producer.itch.io/history
https://nqztan.itch.io/heatwave-elegy
https://alfri00.itch.io/ballrollterror
https://meal-ticket-games.itch.io/fine-whatever
https://posmnaut.itch.io/gas-station-weed-simulator-2024
https://tzschk.itch.io/oakpointe
2026-11-02 04:24:02 +00:00
github-actions[bot] c25a95a5d9 Refresh catalog [2026-11-02] 2026-11-02 03:35:21 +00:00
poli0981andClaude Opus 5.5 4bbd8a967f chore(deps): weekly dependency sweep 2026-11-02 (#176)
* chore(deps): weekly dependency sweep 2026-11-02

npm (3-day cooldown applied by hand, as Dependabot does):
- react-router 8.5.1, @tanstack/react-query* 5.105.0, lucide-react 1.64.0,
  jose 6.2.14 (Dependabot #171, #172, #175)
- @types/node 26.6.6, knip 6.44.0, typescript-eslint 8.72.1 (#173, #174)
- wrangler 4.156.0 + regenerated worker-configuration.d.ts (why #173 failed)
- drop overrides.undici: wrangler 4.156's miniflare pins undici 7.30.1 itself

Also: pytest 9.2.0 + ruff 0.17.3 (pip-tools on Python 3.14),
sonarqube-scan-action v8.4.0, cargo update of crates past the cooldown
(brotli, rustix, tauri-plugin-single-instance, utf8_iter, zcheapstr).
CLAUDE.md gotcha 42 rewritten for the removed override.

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

* docs: note the 2026-11-02 deps sweep in CLAUDE.md

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

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-02 08:07:33 +07:00
github-actions[bot] d5ca716b54 Ingest queued games [2026-11-01] 2026-11-01 20:24:36 +00:00
freeitchgames-admin[bot] 01434726a2 Queue 6 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://3dcubegames.itch.io/twist-and-untangle
https://corgi-noir.itch.io/minifarm
https://isobeye.itch.io/kahretsin
https://jalan-journey.itch.io/budget-blitz
https://star2dfd.itch.io/starbetablock
https://tulkaas.itch.io/sludge-orcs
2026-11-01 20:24:02 +00:00
github-actions[bot] a137e03241 Ingest queued games [2026-11-01] 2026-11-01 16:24:37 +00:00
freeitchgames-admin[bot] 78265932de Queue 8 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://casatin1.itch.io/kitty
https://elnite-interactive.itch.io/either-human-or-monster
https://exoskeletaljunction.itch.io/bachelorsdegree
https://medowlarken.itch.io/first-night
https://omeg12.itch.io/the-kraken-sleepeth
https://popularfront.itch.io/abm
https://sumebl.itch.io/my-hbbd
https://temers-studio.itch.io/dragons-heart-the-crimson-rebirth
2026-11-01 16:23:56 +00:00
github-actions[bot] 40d9e3938d Ingest queued games [2026-11-01] 2026-11-01 12:24:31 +00:00
freeitchgames-admin[bot] cab055273a Queue 7 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://devhourgames.itch.io/loveland
https://fatihnecdet.itch.io/solo-tale
https://lucille-karma.itch.io/deltarune-northernlight
https://pebble-games.itch.io/islands
https://st265-samet.itch.io/rem-hoca-le-haloween-partisi
https://valenzuelagustavo.itch.io/tmnt-arcade-game-megadrive-port
https://yosoyaika.itch.io/starbot-zone
2026-11-01 12:23:56 +00:00
github-actions[bot] e744e46b48 Ingest queued games [2026-11-01] 2026-11-01 08:24:01 +00:00
freeitchgames-admin[bot] adac8ad4ec Queue 6 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://greenglas.itch.io/loserween
https://ikarusangel.itch.io/ilovemymom
https://kerps.itch.io/luminous
https://ruizukun-dev.itch.io/super-natural-dating-sim
https://sunlun.itch.io/111am
https://yaboibrainz.itch.io/stego-in-my-spotlight
2026-11-01 08:23:23 +00:00
github-actions[bot] 2cdadad191 Ingest queued games [2026-11-01] 2026-11-01 04:24:45 +00:00
freeitchgames-admin[bot] 4a5b1e8c28 Queue 5 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://forkedpush.itch.io/starfall-hearts
https://he-k.itch.io/dating-a-table
https://moonshinersgames.itch.io/heartbite
https://ss-ltd.itch.io/collision-demo
https://thebaldporter.itch.io/the-b-game-android-port
2026-11-01 04:24:12 +00:00
github-actions[bot] 8bd351c447 Refresh catalog [2026-11-01] 2026-11-01 03:35:05 +00:00
github-actions[bot] 2cce0701c3 Ingest queued games [2026-10-31] 2026-10-31 23:39:45 +00:00
freeitchgames-admin[bot] 2fc886a52c Queue 2 game(s) for ingest [admin]
Via the admin page.

https://alan1st.itch.io/tui-ba-gang
https://sopdev.itch.io/gorilla-forest
2026-10-31 23:39:26 +00:00
github-actions[bot] e520a69616 Ingest queued games [2026-10-31] 2026-10-31 20:24:24 +00:00
freeitchgames-admin[bot] 8a64a57187 Queue 3 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://brokenbytes.itch.io/roc-n-rope
https://loldevteam.itch.io/fs25-pipe-pack-extended
https://epigramps.itch.io/what-trouble-brews-below
2026-10-31 20:24:01 +00:00
github-actions[bot] 3aad2558eb Ingest queued games [2026-10-31] 2026-10-31 16:25:05 +00:00
freeitchgames-admin[bot] 6fe0c7bc9c Queue 15 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://adairtrashart.itch.io/ghost-node
https://ahmwma.itch.io/bonespoke
https://anonuser2026.itch.io/a-viagem-de-flvio
https://blamerobots.itch.io/the-tell-tale-hearts
https://blvck-sheep.itch.io/clr-hws2026
https://bnuibuni.itch.io/the-low-path
https://bunny-bureau.itch.io/angels-mania
https://darkwolfcat.itch.io/the-knocker-horror
https://earlyspringflora.itch.io/the-early-spring-floras-story
https://itsnotpeksi.itch.io/bewitched-on-halloween
https://matchabiru.itch.io/potion-pals
https://star1here.itch.io/wherefireflieslead
https://syring4.itch.io/offscript
https://v-sathvik-reddy.itch.io/paintscapes
https://vinca-roseus.itch.io/anima-automation
2026-10-31 16:24:02 +00:00
github-actions[bot] b73052e679 Ingest queued games [2026-10-31] 2026-10-31 12:24:33 +00:00
freeitchgames-admin[bot] dffe62bac7 Queue 6 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://funbanan.itch.io/nasubi
https://gabbydarienzo.itch.io/obsession
https://iinksk.itch.io/danganronpa-another-remaster
https://jakecook2400.itch.io/mobilesuitgundam-firered
https://memorious.itch.io/dark-parts
https://vikintor.itch.io/pulcra-remastered
2026-10-31 12:23:58 +00:00
github-actions[bot] 9894faeb04 Ingest queued games [2026-10-31] 2026-10-31 04:24:28 +00:00
freeitchgames-admin[bot] 5031d44bac Queue 5 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://madoguchimoto.itch.io/wairo-de-bingo
https://redwolf-fenrir.itch.io/the-demon-king-and-the-hero
https://rockingprojects.itch.io/kill-the-hero
https://thebaldporter.itch.io/3-android-port
https://thinking-cat-games.itch.io/incredig
2026-10-31 04:23:58 +00:00
github-actions[bot] c804d1d61f Refresh catalog [2026-10-31] 2026-10-31 03:35:14 +00:00
github-actions[bot] 4bc41c121d Ingest queued games [2026-10-31] 2026-10-31 00:25:07 +00:00
freeitchgames-admin[bot] 348cb23f62 Queue 11 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://3timessleepy.itch.io/decomposed
https://chaithaimai.itch.io/nightmare-in-veggieland
https://daedae-7371.itch.io/feliz-cum
https://hi-hamguin.itch.io/may-we-be-together-forever
https://ijwhfunn.itch.io/bens-playground
https://isadora-calicunha.itch.io/salo-de-maquiagem
https://koirasu.itch.io/rewinded
https://pieroshi.itch.io/dreamless-drama
https://samasarax.itch.io/intruder
https://samiksha-saxena.itch.io/where-love-stays
https://tysore.itch.io/spririts-on-demand
2026-10-31 00:24:09 +00:00
github-actions[bot] 10d487e6d2 Ingest queued games [2026-10-30] 2026-10-30 20:24:43 +00:00
freeitchgames-admin[bot] 020c5049ca Queue 7 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://deby-studio.itch.io/who-is-the-yandere
https://dewakuneiei.itch.io/2-sides
https://pajorn.itch.io/evermore
https://pusana77.itch.io/ghostgirlrocket
https://tonypai.itch.io/a-chance-that-isnt-yours
https://ia97lies.itch.io/situation-normal
https://maiu-online.itch.io/maiu-online
2026-10-30 20:24:07 +00:00
github-actions[bot] 98967815a2 Ingest queued games [2026-10-30] 2026-10-30 16:24:21 +00:00
freeitchgames-admin[bot] 9cfa5e56f3 Queue 3 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://arelvox.itch.io/sparkmind
https://lensan.itch.io/aria-sandbox
https://wolflifetime.itch.io/to-the-moon
2026-10-30 16:23:59 +00:00
github-actions[bot] 1f41c3ecd5 Ingest queued games [2026-10-30] 2026-10-30 08:25:09 +00:00
freeitchgames-admin[bot] 9dffd3a612 Queue 18 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://bokendev-studio.itch.io/turbovektor
https://fanplaylab.itch.io/wuguan
https://golden-log-games.itch.io/idle-countdown
https://icshark.itch.io/nine-heavens
https://lyones.itch.io/splashland-is-closed
https://codename-b.itch.io/closing-time
https://csuh4.itch.io/the-boiled-one-veggie
https://jdcorley.itch.io/case-missing-trooper
https://kaw7n.itch.io/celeste-duvidas-por-favor
https://lintilion.itch.io/the-phantom-thief-returns
https://mayilzadeyunus.itch.io/1961
https://pilargarcia.itch.io/los-casos-de-dominguez-final1
https://reyyyeah.itch.io/beautiful-prosodies
https://rottenpeas.itch.io/ghost-ranch
https://sakurarose3.itch.io/femboy-dating
https://savageemoji.itch.io/lucky-grin
https://exoskeletaljunction.itch.io/photocopycat
https://thankyouthankyou.itch.io/dead-air
2026-10-30 08:23:56 +00:00
github-actions[bot] ba349b04ca Refresh catalog [2026-10-30] 2026-10-30 03:35:41 +00:00
github-actions[bot] e244821a6d Ingest queued games [2026-10-30] 2026-10-30 00:24:47 +00:00
freeitchgames-admin[bot] 43281a805a Queue 9 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://bientsie.itch.io/the-sundial
https://enna-art.itch.io/halloween-night-a-naruhina-novel-game
https://miowrites.itch.io/lucas-night
https://sayukix.itch.io/magica-girls-era
https://schoubye.itch.io/samhain-trail
https://tomnie12344.itch.io/the-eye-below
https://threetare.itch.io/eighth-heaven
https://caimluna.itch.io/invisible-opus
https://datasparrow.itch.io/shardana-hydro-trail-gp
2026-10-30 00:23:59 +00:00
github-actions[bot] 3708d2c311 Ingest queued games [2026-10-29] 2026-10-29 20:24:27 +00:00
freeitchgames-admin[bot] 18aa0788b0 Queue 3 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://buituandai133.itch.io/debug-the-monolith
https://lastflagstanding.itch.io/last-flag-standing
https://thelands.itch.io/the-lands
2026-10-29 20:24:03 +00:00
github-actions[bot] 0b6bcba3e6 Ingest queued games [2026-10-29] 2026-10-29 16:24:01 +00:00
freeitchgames-admin[bot] f3af644737 Queue 7 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://igoraidiary.itch.io/on-three
https://kittium.itch.io/care-4-me
https://npcstudio.itch.io/starlight-diary
https://sakurarose3.itch.io/offline-mode
https://slapstickgames1524.itch.io/what-comes-aroundgoes-around
https://starlight-productions.itch.io/rotten-hearts
https://tuxum.itch.io/fnaf-reforged
2026-10-29 16:23:21 +00:00
github-actions[bot] f687cfc986 Ingest queued games [2026-10-29] 2026-10-29 12:24:33 +00:00
freeitchgames-admin[bot] 9338608495 Queue 4 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://alexferb24.itch.io/one-button-to-infinity
https://bblir.itch.io/mega-met
https://mblw.itch.io/i-was-reborn-as-a-warlord-of-patinko-orcs-and-i-need-to-crush-my-enemy
https://tri-state-crew.itch.io/fs25-international-durastar-dump
2026-10-29 12:24:04 +00:00
github-actions[bot] 192d843e9d Ingest queued games [2026-10-29] 2026-10-29 08:30:41 +00:00
freeitchgames-admin[bot] 76e7a44468 Queue 94 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://barbarian-studio.itch.io/party-time
https://bidoofer.itch.io/to-love-oneself
https://hornrydanger.itch.io/bear-with-me
https://luca-walker.itch.io/youre-dead
https://mushroom32x.itch.io/toolpoy
https://orb-star.itch.io/evergreen
https://rcrudy.itch.io/friendly-situation
https://relieced.itch.io/sakura-vow
https://rensama2777.itch.io/kiss-me-im-cursed
https://res1dentcrypt1d.itch.io/it-will-consume
https://slapstickgames1524.itch.io/duel-fates
https://slapstickgames1524.itch.io/karens-quest
https://tenshihanka.itch.io/broken-eve-creepysaga
https://theomestre.itch.io/purgatory-show
https://muckypaws.itch.io/awe-advance-willy-editor
https://nyktv.itch.io/tv-chans-great-escape-gb
https://zanipixels.itch.io/lightseeker
https://r-goulart.itch.io/mechamagika
https://riley9.itch.io/if-i-can-eat-god-god-has-to-exist
https://lintilion.itch.io/the-masters-reliquary
https://yellow-crow.itch.io/for-hexposure
https://ludipe.itch.io/everything-dies
https://chi.itch.io/moving
https://blebgo.itch.io/ant-genius
https://retream.itch.io/ring-around-the-world
https://teapak.itch.io/kill-devil-1997
https://garsall0p.itch.io/my-eye-is-ham-ham-jammed-forever
https://cathroon.itch.io/groundskeeper
https://minihamsterproductions.itch.io/oiopolis-es
https://noah-art3mis.itch.io/learning-to-love-the-labyrinth
https://waseverfriday.itch.io/proverbs-of-hell
https://teamakesgames.itch.io/the-elision-effect
https://modus-interactive.itch.io/iketsuki
https://rowantobias.itch.io/somnography
https://blood-machine.itch.io/girl-purgatoriem
https://housekeepinggames.itch.io/hymn-to-the-earless-god
https://chiffon.itch.io/another-happiness
https://spicyfuse.itch.io/runiestory
https://scary-lemon.itch.io/brad-has-a-pain
https://strawberryoctii.itch.io/memoirs-of-magic
https://brutalvap.itch.io/brutal-complex-ver-japanese
https://mojiken.itch.io/test-test-test
https://kale-chips.itch.io/sorekara-end-of-a-journey
https://taelsdafoox.itch.io/tanuki-defusal-co
https://killbots-stuff.itch.io/tokiri
https://nerdy-teachers.itch.io/homunculus
https://jimjum.itch.io/communite
https://mikeklubnika.itch.io/unsorted-horror
https://rolo3.itch.io/uchuu-plant
https://priztats.itch.io/aurora-memoria-2093
https://digitalgodtower.itch.io/abcess
https://emmytwo.itch.io/cerasus
https://wandeer.itch.io/watch-repair-shop
https://gwenckatz.itch.io/mandala
https://m-9.itch.io/daydream
https://mad290.itch.io/terminator-2030
https://bryce-bucher.itch.io/disparity-of-the-dead
https://riley9.itch.io/tomorrow-is-my-birthday
https://lintilion.itch.io/place-visit
https://kai20.itch.io/neo-sea
https://vila6.itch.io/silent-space
https://nezita.itch.io/dll
https://yodak.itch.io/virtual-summit-3d-suite
https://scythex.itch.io/tales-of-phantasy
https://communistsister.itch.io/super-videotome
https://lilithzone.itch.io/crypt-underworld
https://yukimisoft.itch.io/if-you-stay-2023
https://pissshark.itch.io/i-went-to-comiket-and-everyone-called-me-slurs
https://pissshark.itch.io/famous-crash
https://eufrasi0.itch.io/paraiso
https://hyasssy.itch.io/fragile
https://proximete.itch.io/gynogenesis
https://aimkid.itch.io/destinationplanet
https://fotocopiadora.itch.io/game-blast-collection
https://yukimisoft.itch.io/the-trials-of-goodbye
https://fotocopiadora.itch.io/greasemnk
https://pixelrye.itch.io/oddys-lost-and-found
https://nanukara.itch.io/kamikamera
https://quicksand.itch.io/freedom-diegesis
https://ebihime.itch.io/girlfriend-simulator
https://slitherbop.itch.io/etcetera
https://saibibi.itch.io/for-elise
https://lintilion.itch.io/hungry-healthy-human
https://decenttreatment.itch.io/katanirvana
https://j-and-r.itch.io/chambers
https://ivynivek.itch.io/kanalmanac
https://visualmemoryunit.itch.io/enupishi
https://annswwr.itch.io/night-island
https://michi-fossard.itch.io/meziel-chapter-1
https://vila6.itch.io/after-a-while
https://unseconds.itch.io/doe-eyes
https://majd-rouhana.itch.io/excaliburian
https://goldlocke.itch.io/dottie-dreads-nought
https://porpentine.itch.io/runescape
2026-10-29 08:23:59 +00:00
github-actions[bot] 1bf3c19c8f Ingest queued games [2026-10-29] 2026-10-29 04:24:16 +00:00
freeitchgames-admin[bot] d0df47bef9 Queue 2 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://kutedo19.itch.io/movecorp
https://nanstudiotw.itch.io/naruto-kizuna-mobile
2026-10-29 04:23:55 +00:00
github-actions[bot] ce3e84ce23 Refresh catalog [2026-10-29] 2026-10-29 03:35:34 +00:00
github-actions[bot] d90c4cc073 Ingest queued games [2026-10-28] 2026-10-28 20:35:25 +00:00
freeitchgames-admin[bot] 7b38b2737c Queue 164 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://aevelie.itch.io/aeroforge
https://caramelgames.itch.io/another-christmas-game
https://thappatan.itch.io/roiwan
https://hundredrabbits.itch.io/catpot
https://bo-gi.itch.io/bad-week
https://flowerstudio.itch.io/the-melting-apartment
https://fileto.itch.io/coffeequest
https://had2apps.itch.io/red-moss
https://hamumu.itch.io/loonyland-halloween-hill
https://fartfish.itch.io/ready-your-rudder
https://yoka-red.itch.io/absinthe
https://dmullinsgames.itch.io/boba
https://sparsegamedev.itch.io/post-scarcity
https://apish-box-games.itch.io/gimmick
https://hospitalengine.itch.io/chi
https://thesandymancan.itch.io/the-longest-walk
https://jsmonzani.itch.io/nature
https://chambersoft.itch.io/absolutely-perfect-specimen
https://cowsine.itch.io/super-piracy-quest
https://vibingleaf.itch.io/bootleg-pokmon-game
https://pumpkinclowning.itch.io/humans-room
https://windmills123.itch.io/yume-nikki-dressup
https://oligarchomp.itch.io/flowerngunnguns
https://tapesoft.itch.io/naruto
https://freakflaggames.itch.io/leechcraft-cave-monster
https://dominoclub.itch.io/deathlete-zeug
https://jonah-srg.itch.io/nebubal
https://josh04.itch.io/can-i-make-games-alone-if-i-dont-like-players
https://gaiushalley.itch.io/maddy-dreamscapes
https://cam999.itch.io/plant-mall
https://frogmen.itch.io/subway
https://hellofangaming.itch.io/the-shroom-project
https://maimiestoybox.itch.io/qmsr
https://donitz.itch.io/just-why
https://alimakesrpgs.itch.io/pmdta
https://davidamado.itch.io/illusion-of-gaia
https://sleepless-seven.itch.io/genesis-seed
https://0newaylane.itch.io/one-way-lane
https://propagant.itch.io/fractal-sailor
https://vikintor.itch.io/mixuruca
https://schmidt-workshops.itch.io/cyclopean
https://studio-cafe.itch.io/rabbit-hole
https://specium.itch.io/jojos-bizarre-hyperdodge-hell
https://surt-r.itch.io/dragon-ruins
https://poor-track-design.itch.io/screensaver-subterfuge
https://ismaelrodriguez.itch.io/toy-cavers
https://thestoff.itch.io/6-feet-under
https://4331pro.itch.io/malice
https://han-tani.itch.io/aoa
https://niandra.itch.io/museum
https://paxanga.itch.io/shouganai
https://donitz.itch.io/sweet-hell
https://serotines.itch.io/talk-to-impsun-in-a-basement
https://chanimk.itch.io/uncutetifying-danny
https://tirkarokujo.itch.io/onigashima-gyakusatsu
https://kobito-games.itch.io/rainbow-cave-raid
https://spicyfuse.itch.io/basketbrawl
https://oleandergarden.itch.io/ata
https://d-mag.itch.io/three-verses
https://agrimmora.itch.io/super-assfuck-rpg
https://mattstov.itch.io/ichorous
https://stanwixbuster.itch.io/apolitical-magical-girl-game
https://poppyworks.itch.io/episode-enyo
https://droqen.itch.io/2024-02-12-flight-through-the-palace
https://mraaa.itch.io/nobihaza
https://menthalovely.itch.io/experiment-log-623
https://denzquix.itch.io/4-lung-boy
https://riley9.itch.io/infinity-is-what-we-will-be
https://tonywang.itch.io/gbbasic-alpha
https://xra.itch.io/memory-of-a-broken-dimension
https://ed1c24.itch.io/melrose
https://unseeing-eyes.itch.io/ritual-dreams
https://cymerc64.itch.io/cymerc64
https://effieartoria.itch.io/delving
https://kanderwund.itch.io/evisceratethisgirl
https://ponporio.itch.io/homeless-dog
https://studio-notes.itch.io/kowloonscurselostreport
https://osurpzz.itch.io/tower-of-kalemonvo
https://teapak.itch.io/sable-house-chapter-1
https://michaelovertonbrown.itch.io/perfect-world
https://betweenthescanlines.itch.io/issueone
https://dobrastudios.itch.io/pan
https://destroyed4com4t.itch.io/hoshi-wo-miru-hito
https://june-flower.itch.io/mysteryfriends99
https://incandescent-lamp.itch.io/android-amicicide
https://effieartoria.itch.io/wizards-congress
https://alex-declino.itch.io/hikikomori-wisdom
https://azeluth.itch.io/magic-unfolding
https://deblue.itch.io/my-sister-is-wanted
https://sbnewsom.itch.io/notahome
https://shoebby.itch.io/the-anders-cyclopaedia
https://snekofspice.itch.io/when-the-sea-received-the-sky
https://heinn.itch.io/chitin
https://gamingw.itch.io/gw-chaingame-2023-the-makers-mark-legacy
https://uprc.itch.io/tetrisattack
https://goldlocke.itch.io/dottie-flowers
https://zeloz-mkii.itch.io/daisy-slime-castle
https://lotusrootrecords.itch.io/slime-game
https://prophetgoddess.itch.io/london-jerry
https://larkwrighter.itch.io/so-this-is-innovation
https://773tk.itch.io/pareidolia-in
https://chi.itch.io/enginelol
https://wamby.itch.io/oversomnia
https://m-9.itch.io/drmwrldgrl
https://bighandinsky.itch.io/waiting
https://viktorthegreat.itch.io/sweet
https://fiorefire.itch.io/patchys-magical-maze
https://dominoclub.itch.io/tear-ripple
https://nizakashii.itch.io/puttium
https://connor-sherlock.itch.io/ossian
https://rezydent.itch.io/age-of-brass
https://jon-keevy.itch.io/google-sheet-template-for-ren-py-vns
https://modus-interactive.itch.io/laputa
https://ulvin.itch.io/carcass
https://lilithzone.itch.io/1-betsys-hospital
https://cryptomnesic-softworks.itch.io/unearth
https://nivarian.itch.io/crystal-valley
https://verysoftwares.itch.io/avarice
https://hedgewizards.itch.io/pogo3d
https://lavendersiren.itch.io/a-snowballs-chance-level3
https://dithered-output.itch.io/siren-doom-ii-mod
https://gcpcoelho.itch.io/magic-crawl
https://feuillemorteentertainment.itch.io/cats-are-long-liquid
https://toonpimp.itch.io/cv2-roe
https://p0lter.itch.io/expiate
https://tzalmavet.itch.io/00-lr
https://xintetsu.itch.io/confinium
https://melcoteam.itch.io/aconite-beta
https://choko-flan.itch.io/friend-hunt
https://livis.itch.io/birthdaykid
https://froglake.itch.io/brelloatdc
https://incredulous.itch.io/long-time-no-see
https://hydezeke.itch.io/choochoo
https://shamangarage.itch.io/lcd-odyssey
https://bennizone.itch.io/thatonetime
https://spiderzone.itch.io/out-of-bounds
https://elliwoods.itch.io/seaquest1992
https://spacepantsgames.itch.io/dragons-lair
https://anadvora.itch.io/antigone
https://flan.itch.io/titanic
https://genesiskeys.itch.io/2dfmproj
https://yukimisoft.itch.io/extremely-organized-ghost
https://mikeklubnika.itch.io/concrete-tremor
https://warrrkus.itch.io/legend-of-the-blue-sword
https://snattacat.itch.io/escape-velocity
https://nevthebear.itch.io/circuit-hearts
https://wandeer.itch.io/undead-air
https://edgar-0119.itch.io/narrenschiff
https://2d-knights.itch.io/rune-warriors
https://theogramme.itch.io/feydome-fairy-dressup
https://kalpasoft.itch.io/they-speak-from-the-abyss-zenith
https://bighandinsky.itch.io/dating
https://hexosphere.itch.io/prison-of-husks
https://june-flower.itch.io/gunkprotocol
https://visualmemoryunit.itch.io/chibi-charger
https://cojam.itch.io/pinkshake
https://octopus8studios.itch.io/cerebral-surge
https://essarrgee.itch.io/full-bloom
https://swofl.itch.io/coward-town
https://chiffon.itch.io/incomplete
https://nicole-evans.itch.io/untitled-cat-game
https://hidden-orchestra.itch.io/little-buddy-move
https://incandescent-lamp.itch.io/gluetechold
https://sweetheartsquad.itch.io/toc-toc
2026-10-28 20:23:36 +00:00
github-actions[bot] d8a0589972 Ingest queued games [2026-10-28] 2026-10-28 16:24:43 +00:00
freeitchgames-admin[bot] c4c38a8aa1 Queue 8 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://3218961440qqcom.itch.io/ludio
https://drawnouttravels.itch.io/down-the-forest-path
https://hammmershark.itch.io/dating-sim-not-set-in-hell-prototype
https://jindalu.itch.io/do-this-properly
https://nezowo.itch.io/gacha-gotcha
https://schooldaze.itch.io/high-school-lunch-simulator
https://wyza.itch.io/7-nonexistent
https://the-l0bster.itch.io/pocket-platformer
2026-10-28 16:23:54 +00:00
github-actions[bot] 67377b8103 Ingest queued games [2026-10-28] 2026-10-28 12:25:55 +00:00
freeitchgames-admin[bot] ba2bb3c0ca Queue 22 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://atenebris.itch.io/oregrid
https://mismatched-wings.itch.io/affectionadorationabsolution
https://bibixp.itch.io/you-know-we-kinda-suck-right
https://freecodecamp.itch.io/learn-to-code-rpg
https://snekofspice.itch.io/for-the-betterment-of-society
https://sadvnsfromtom.itch.io/triceratops-necromancer
https://shroomychrist-studios.itch.io/human-expenditure-program
https://brushie.itch.io/fooddiary
https://saturngames.itch.io/kissy-kissy-purr-purr
https://saturngames.itch.io/18782
https://zenoslots.itch.io/narcotizedr
https://zenoslots.itch.io/madlabparty
https://saibibi.itch.io/votum
https://jingshing.itch.io/dragoncastle
https://riekay.itch.io/zwei-club-mate-bitte
https://cicadaqueen.itch.io/cold-call
https://snekofspice.itch.io/she-was-swallowed-by-the-sun
https://melodicsoft.itch.io/witness-link
https://phantastiq.itch.io/tea-haus
https://pride-col.itch.io/nothing-like-you
https://2-gorblins-in-a-studio.itch.io/on-the-dimming-and-the-customs-thereof
https://joereilly.itch.io/expeditions
2026-10-28 12:24:01 +00:00
github-actions[bot] 3c443dd3a4 Ingest queued games [2026-10-28] 2026-10-28 08:35:50 +00:00
freeitchgames-admin[bot] fd2f597588 Queue 163 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://cryptlark.itch.io/canary
https://endpaper.itch.io/fairs-fair-prologue
https://felix-arai.itch.io/your-boyfriend-yukata-tanaka
https://harper-crane.itch.io/said-the-swan-to-the-rook
https://icedlemons.itch.io/clowntastic-romance
https://komitsu.itch.io/on-the-way-home
https://qixya.itch.io/3-seconds-chapter-3-episode-2
https://qwesasuke.itch.io/are-you-happy
https://sutorijam.itch.io/hu-lao-gate
https://wiekey.itch.io/deep-sea-dudes
https://dumplingsquid.itch.io/a-ghosts-guide-to-office-romance
https://dumplingsquid.itch.io/goose-the-goosie-girlie-in-breakfast-quest
https://dario-zubovic.itch.io/opsnd
https://modus-interactive.itch.io/frontier-diver
https://dascumaru.itch.io/lotan
https://studio-oleomingus.itch.io/the-indifferent-wonder-of-an-edible-place
https://waynetron.itch.io/barkour
https://bearish.itch.io/tiny-towns
https://tinyfacegames.itch.io/portraitheus-divina-natura-artificialis
https://coal-supper.itch.io/the-good-time-garden
https://garsall0p.itch.io/sketchbook-i-flower-ramblings
https://visitorsfromdreams.itch.io/shootycatfish-episode1
https://fricochet.itch.io/chiphop
https://monkeyotoshi.itch.io/bestiary
https://bebadboi.itch.io/mimo
https://dazel.itch.io/omamori
https://kcamberart.itch.io/house-call
https://samson-auroux.itch.io/au-fil-de-leau
https://pintroverts.itch.io/from-head-to-toe
https://girldebord.itch.io/arcadia
https://lovegames.itch.io/love
https://ngplus.itch.io/jice
https://alienmelon.itch.io/electric-zine-maker
https://probhe.itch.io/the-7-cents-deal
https://poppyworks.itch.io/melon-journey-2
https://ladispute.itch.io/pilgrimage
https://davidczar.itch.io/chasing-birds
https://davidczar.itch.io/nightmare-drive
https://spacebackyard.itch.io/bird-of-passage
https://thebosscat.itch.io/catalist-the-sages-song
https://vamuseum.itch.io/in-the-pause-between-the-ringing
https://krajzeg.itch.io/low-knight
https://reboosteddev.itch.io/sonic-reboosted-project
https://clawmark.itch.io/fruitwolf-webgl
https://yookond.itch.io/my-only-friends
https://sevencrane.itch.io/vapor-trails
https://momocromics.itch.io/vaporwave-clicker
https://cowthing.itch.io/frog-smith
https://sandgardeners.itch.io/brownie-cove-cancelled
https://colinarmistead.itch.io/music-jam
https://godotengine.itch.io/godot
https://thermitegames.itch.io/tales-of-the-neon-sea
https://crawlspacestudio.itch.io/this-is-hard-for-me
https://benjamin-soul.itch.io/heroes-of-camlann
https://zerbamine.itch.io/noodles
https://darkbitsgames.itch.io/death-strike
https://owch.itch.io/btab
https://crawlspacestudio.itch.io/juice
https://salamichild.itch.io/avarisk
https://zyodlfca12gmvzxjjcun.itch.io/dust-bunnies
https://nonomiyo.itch.io/monstruous
https://plaw.itch.io/computer-open-that-door
https://unnamedcollective.itch.io/isbl
https://tak.itch.io/league
https://enchae.itch.io/super-converger
https://spacebackyard.itch.io/like-roots-in-the-soil
https://thewaether.itch.io/flamingo-quest
https://npckc.itch.io/penguin-cafe
https://gutter-arcade.itch.io/knight-club
https://baku.itch.io/legend-of-xenia-3d
https://playfulbacon.itch.io/rocks-and-ravens
https://danieldavis.itch.io/grym
https://jeremycouillard.itch.io/the-founders-of-daytona-beach-also-founded-dayton-ohio
https://princess-hype.itch.io/sonic-wood
https://watabou.itch.io/procgen-tarot
https://unnamedcollective.itch.io/slime-garden
https://ronyaib.itch.io/the-gift
https://ronyaib.itch.io/the-herbalist
https://armelgibson.itch.io/oases
https://pictopals.itch.io/bombert
https://milanimal.itch.io/alien-garden-20
https://noxlof.itch.io/the-royal
https://adamgryu.itch.io/now-thats-sport
https://seansleblanc.itch.io/one-button-duel
https://rudeboy.itch.io/deadliest-catch
https://schrolab.itch.io/birkanoid
https://jaimuepe.itch.io/dogcare-center
https://veryhandsome.itch.io/dragoon-drop
https://fisho.itch.io/market
https://molleindustria.itch.io/dogness
https://yasamanfar.itch.io/woodfarer
https://andyman404.itch.io/concourse-x-ray
https://carsonk.itch.io/msmaker
https://joonturbo.itch.io/nuts
https://ateliersento.itch.io/sango
https://boogieknights.itch.io/healthybreakfast
https://dorblin7z7.itch.io/rock-paper-speedup
https://glkitty.itch.io/random-acess-character
https://jay-tholen.itch.io/celestial-archive
https://borbware.itch.io/syzygy
https://secondstepstudios.itch.io/the-devils-eight
https://lowpolis.itch.io/greetings
https://sweetheartsquad.itch.io/roshigumi
https://samukun.itch.io/mothlight
https://megadrivesonic.itch.io/fish-kiss
https://harold-krell.itch.io/the-smash-boys-vs-the-nerdy-boys
https://martincohen.itch.io/disposable
https://raisedbywoes.itch.io/scoot-scoot
https://lorenschmidt.itch.io/luminous-corridor-0
https://dustinlbragg.itch.io/yo-noid-was-ahead-of-its-time
https://noxlof.itch.io/grabageboy
https://bauxite.itch.io/black-diode
https://spazzylemons.itch.io/ticochet
https://ponywolf.itch.io/match-three-space-rpg
https://happysnakegames.itch.io/morning-post
https://rxi.itch.io/scanline
https://onefifth.itch.io/cooldog-teaches-typeing
https://vextro.itch.io/welcome-to-heaven
https://tak.itch.io/slam
https://sinclairstrange.itch.io/running-voltgun
https://radmars.itch.io/radrover-snap
https://radmars.itch.io/super-kaiju-dunk-city
https://adamstrange.itch.io/bleakharbor
https://patchy-illusion-team.itch.io/light-magic-2
https://nightframes.itch.io/of-all-the-creatures-ive-met
https://liquidtc.itch.io/wishful-thinking
https://the-icehouse.itch.io/the-world-is-strange
https://the-icehouse.itch.io/francium
https://raphss.itch.io/aetherdiving
https://pavro-o.itch.io/child-icarus
https://noeticnightjar.itch.io/th-motorcycle-and-book
https://hamsterrivals.itch.io/ritasadventure
https://lilybelmira.itch.io/fairies
https://korkskrew2000.itch.io/nightmare-superhighway
https://theogramme.itch.io/dta-deiridh
https://deathorgone.itch.io/acephalic
https://reasonably-chill.itch.io/corn-sausage-rpg
https://zapathie.itch.io/current-ost
https://empalu.itch.io/fallout-equestria-remains
https://cymothoid.itch.io/international-laws-of-aviation
https://the-icehouse.itch.io/myha
https://luminystudios.itch.io/iborea-the-acherons-journey-alpha
https://tijn.itch.io/lyft
https://idkllr.itch.io/shorlspace22
https://gurnburial.itch.io/pl-1
https://fortheloveofhearts16.itch.io/cora-magazine
https://pixelsxpaper.itch.io/zine
https://dreamsatellite.itch.io/dream-satellite-2
https://warrrkus.itch.io/chalicebound
https://eggnog.itch.io/stickyfoot
https://nizakashii.itch.io/nehonobasa
https://bagster.itch.io/yacy
https://bob-the-hamster.itch.io/ohrrpgce
https://devilspider.itch.io/image-bounds-displayable
https://videodante.itch.io/solitaryspacecraft
https://wlfby.itch.io/you-do-not-have-a-name
https://lolscrubs.itch.io/emono
https://iced-lemon.itch.io/ballet-of-steel
https://gurnburial.itch.io/april-19-2024
https://lavendersiren.itch.io/left-beef-chapter-2
https://edgar-0119.itch.io/tianjinyaoi
https://nax-89.itch.io/gaucho-angel
https://mode-gone.itch.io/infinite-red
2026-10-28 08:23:49 +00:00
github-actions[bot] 714d296995 Ingest queued games [2026-10-28] 2026-10-28 04:28:48 +00:00
freeitchgames-admin[bot] 2c430eafc2 Queue 63 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://enmanuel-gutierrez.itch.io/hoard-sweeper
https://jaco-van-hemert.itch.io/eldritch-apocalypse
https://woofwoofstudio.itch.io/cosl
https://javierloustaunau.itch.io/into-the-trees
https://mazemaker.itch.io/beneath-the-bloodwillows
https://xmasscthulhu.itch.io/blood-of-windcliff
https://aeventyrspil.itch.io/hjertenskaere
https://osraige-press.itch.io/hounds-of-hendenburgh
https://manadawnttg.itch.io/the-elder-evils-the-song-stones
https://summertimealice.itch.io/fallen-star
https://davidblandy.itch.io/palace-of-the-silver-princess-cairn-edition
https://coolwayink.itch.io/forestofthestorms
https://croakerrpgs.itch.io/once-upon-a-giant
https://sonata44.itch.io/heart-of-the-mine
https://rootdevil.itch.io/the-devils-millhopper
https://giantrobottackler.itch.io/ingrown-hairs
https://rileyadammmson.itch.io/tears-of-the-salamancer
https://raznag.itch.io/elixir
https://xapur.itch.io/kraal
https://catshavenolord.itch.io/a-tomb-of-twins-final
https://ashley-at-cat-in-a-box.itch.io/night-of-the-maddening-star
https://nylawoethief.itch.io/blessed-tree-missing-wife
https://shamaeimagines.itch.io/a-troll-in-the-woods
https://junkyardtornado.itch.io/born-into-black-nights
https://caelinaraven.itch.io/lost-temptations
https://catshavenolord.itch.io/midnight-in-bonetown
https://kingtycoon.itch.io/the-drunken-unicorns-prize
https://tigerspook.itch.io/isaac-the-alchemist
https://caelinaraven.itch.io/turn-of-the-leaves
https://dunwichhunter.itch.io/greyhaven-curse
https://crypticmanuscripts.itch.io/malevolence-in-bloom
https://crypticmanuscripts.itch.io/warlocks-gambit
https://weirdwonder.itch.io/burningteeth
https://crypticmanuscripts.itch.io/the-phantom-psalms-of-wight-woods
https://pellep.itch.io/vacant-snow-castle
https://caelinaraven.itch.io/archipelago
https://pointlessmonument.itch.io/seven-silver-spheres
https://junkyardtornado.itch.io/cup-of-little-maws
https://shamaeimagines.itch.io/tomb-of-the-lizard-knight
https://pastelzito.itch.io/the-wages-of-sin
https://the-fun-cube.itch.io/palace-on-the-pink-waves
https://tonytranrpg.itch.io/mct-journal-field-of-visions
https://scribbledmaze.itch.io/strange-trees
https://swampgames.itch.io/heartforest
https://pointlessmonument.itch.io/a-fistful-of-feathers
https://scablandspress.itch.io/birkreach-underforest
https://docastaroth.itch.io/the-castle-of-the-spiderhobs
https://shamaeimagines.itch.io/fungal-forest
https://pellep.itch.io/merry-march-in-the-winter-wood
https://ktrey.itch.io/forest-farragoes
https://lionheart-clan.itch.io/piedmont-critters-of-wood-and-mountain
https://manadawnttg.itch.io/caers-crannogs-dolmenring
https://ghost-crew-press.itch.io/oakenheart
https://pointlessmonument.itch.io/the-terror-crow-of-pipwick-church
https://ialath.itch.io/forkuns-forest-of-shadows
https://cairnde.itch.io/troll-grotte
https://aeventyrspil.itch.io/elverkongen
https://dangerisreal.itch.io/the-sanctuary-of-the-cursed-druids
https://glassbirdgames.itch.io/the-cyclopean-organ
https://oskarswida.itch.io/cairn-utils
https://glassbirdgames.itch.io/the-barrows-hunger
https://mattumland.itch.io/is-mightier
https://nakade.itch.io/lair-of-the-serpent-prince-cairn
2026-10-28 04:23:59 +00:00
github-actions[bot] bec5e9159b Refresh catalog [2026-10-28] 2026-10-28 03:35:42 +00:00
freeitchgames-admin[bot] b437241994 Catalog: remove 1 [admin]
Via the admin page.

remove https://stelladevt.itch.io/mascot-testimonial-css-for-itchio (Not a game)
2026-10-28 02:41:28 +00:00
github-actions[bot] f717d53132 Ingest queued games [2026-10-28] 2026-10-28 00:36:37 +00:00
freeitchgames-admin[bot] b38512ad50 Queue 158 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://gregs-games.itch.io/nosferatooth
https://jvkz.itch.io/dreamium
https://psytronik.itch.io/basilisk
https://resinhead.itch.io/blight
https://thegoetiasquirrel.itch.io/normenhill
https://tow2002.itch.io/battle-of-talingchan
https://gravity-house.itch.io/the-angel-factory
https://snekofspice.itch.io/sunless-horizon
https://suo-jin.itch.io/velvet-heartbeats
https://treegravy.itch.io/the-partridge-longs-for-the-moon
https://treegravy.itch.io/the-dorm-room-shelf
https://marlowedobbe.itch.io/tini-linguini
https://malorym.itch.io/the-last-crossing
https://persimmon-bun.itch.io/pipis-meowstery
https://kawaiila.itch.io/subtle-bodies
https://bizzarefriend.itch.io/catbunalwaysandforever
https://geckonoko.itch.io/0609
https://dominoclub.itch.io/an-inquisition
https://hongchun8.itch.io/95
https://cruxius.itch.io/what-youre-made-for
https://caseythebird.itch.io/major-cave
https://nulledwine.itch.io/hickory
https://alienmelon.itch.io/runonce
https://red-mccloud.itch.io/something-secret-steers-us
https://lovekrafts.itch.io/lotus-eater
https://jammyjams.itch.io/girldreams
https://mkirin.itch.io/one-page-left
https://sapphicore.itch.io/possessed-by-fate
https://msksoft.itch.io/meat-grinder
https://sapphiredev.itch.io/sun-moon-and-you
https://robinisntstoppin.itch.io/anathemata
https://bird-king.itch.io/yukon-gold
https://cammypuppy.itch.io/girl-meat-vol-one
https://cammypuppy.itch.io/girl-meat-volume-2
https://miseri-accordion.itch.io/cupids-bargain
https://piinkpuddiin.itch.io/priscyllias-last-night
https://doggiewoggiez.itch.io/sweet-oil-of-vitriol
https://applegirlington.itch.io/the-phantom-of-the-opera
https://veracity.itch.io/lesbian-loneliness-epidemic
https://ebicon.itch.io/matths-26
https://gutmech.itch.io/vessel-as-witness
https://otary.itch.io/porkstew
https://otary.itch.io/hdah
https://otary.itch.io/doublevision
https://snekofspice.itch.io/all-the-colors-that-you-paint
https://petday.itch.io/drinkcity
https://portrait-prophecies.itch.io/the-lock-inside-her
https://portrait-prophecies.itch.io/just-above-the-bottom
https://cheeso-online.itch.io/how-well-do-you-know-me
https://johannofart.itch.io/lost-signal
https://darkchibishadow.itch.io/a-to-z-comic
https://gutmech.itch.io/girlchrist777
https://bloopus.itch.io/edifice-angels
https://mer-mer.itch.io/inside-is-outside
https://slewingtons.itch.io/da-capo
https://bagenzo.itch.io/kaschei
https://livienvi.itch.io/let-dreaming-androids-lie
https://nonphotored.itch.io/teleoplasty
https://welcome2heaven.itch.io/succubus-simulator
https://sunnyarmageddon.itch.io/lonelycorpseluallabye
https://hallowduskcoven.itch.io/bird-in-the-sun
https://xfleshpotx.itch.io/home3-sw33t-hom3
https://pickyerpoison.itch.io/immortals-pet
https://nookzzz.itch.io/i-have-no-mouth-and-i-am-feet
https://sarlianna.itch.io/stained-lace
https://bruisedmarble.itch.io/century-gaol
https://annesiac.itch.io/showmethebody
https://umriss.itch.io/land-der-begrenzten-mglichkeiten
https://sleepyjump.itch.io/pill-in-the-pudding
https://summertriangle.itch.io/contact-wound
https://voxic-envi.itch.io/twisted-filth-or-how-to-wash-out-blood
https://figurashape.itch.io/coils
https://chuunikusoge.itch.io/gamblers-policy
https://roseofrevolt.itch.io/the-heaven-game-empty-skull-gaiden
https://yonakoi.itch.io/poker-face
https://midnight-hour.itch.io/catching-fish-from-the-bottom-of-a-river
https://cat-hippo.itch.io/slut-machine
https://shafoo.itch.io/keep-breathing
https://lady-of-sunflowers.itch.io/sanguinello
https://gaydarade.itch.io/be-normal
https://slitherpunk.itch.io/artfight-2023-attacks
https://slitherpunk.itch.io/brew
https://air-gong.itch.io/an-angel-without-her-wings
https://colatime.itch.io/discohound
https://lunarcorvus.itch.io/sanguine-sunrise
https://verityshirt.itch.io/outsider-art
https://monicacallaghan.itch.io/half-step-hime
https://pltn.itch.io/today
https://venux-crucifix.itch.io/m2
https://wompagames.itch.io/vampire-tower
https://sopy.itch.io/displacement-of-water
https://nxcromantik.itch.io/toxic-shock-syndrome
https://applegirlington.itch.io/double-yolk
https://stlheart.itch.io/el-cerrito-place
https://speckle-vision.itch.io/no-matter-how-strange
https://dt75art.itch.io/sanguis-amantis
https://maxz92.itch.io/nullfunction-thecallofthevoid
https://lacunova.itch.io/tkop
https://catreturn.itch.io/present
https://crambleberry.itch.io/negativeedge
https://oleandergarden.itch.io/phageplay-basic
https://ldclll.itch.io/iccuigtl
https://mustachemonsters.itch.io/where-the-dandelions-fly
https://uraalice.itch.io/ladys-pyre
https://kazehai.itch.io/2-4-94
https://23noko.itch.io/ff500
https://tabbiedearest.itch.io/helleborine
https://ashirah.itch.io/apple-seed
https://pepperbloom.itch.io/my-friend-snowy
https://studio-leonid.itch.io/preay-animal
https://devsonder.itch.io/parasitoid-girls
https://imcoffeecats.itch.io/magical-girl-suicide-pact
https://tippler.itch.io/unlovable
https://kastelpls.itch.io/leslie-2025
https://deaddeaddeath.itch.io/canolahoney
https://cottage-club.itch.io/8th-heaven
https://roseofrevolt.itch.io/dismal-desire-damnation-severance
https://madocactus.itch.io/malviolence
https://puapka.itch.io/half-lucy-d
https://ebicon.itch.io/m26-tooth-and-nail
https://ebicon.itch.io/as-if-through-glass
https://ebicon.itch.io/butterfly-aeffect
https://sopy.itch.io/spare-parts-episode-1
https://stelladevt.itch.io/mascot-testimonial-css-for-itchio
https://valkzwise.itch.io/delicatesse
https://figurashape.itch.io/do-no-harm
https://denhop.itch.io/setyourselfonfire
https://starcvtcher.itch.io/well-hit-it-again
https://froey.itch.io/a-taste-of-her-blood
https://adairtrashart.itch.io/my-fairy-drunkmother
https://dianerds.itch.io/corporate-archdemoness
https://porksbun.itch.io/love-at-first-latte
https://eliseschuenke.itch.io/jinkies
https://heartpunchstudio.itch.io/longest-night
https://violetbooks.itch.io/plectra-spectre
https://cryingrulesactually.itch.io/mothxflame
https://nightlightwrks.itch.io/bloom
https://aokoro.itch.io/yumebani
https://tippler.itch.io/banality-4
https://tippler.itch.io/banality-3
https://tippler.itch.io/banality-2
https://ppilotco.itch.io/slf
https://dianerds.itch.io/lilac-on-the-bloody-thorn-path
https://eerieemi.itch.io/flagburner
https://puapka.itch.io/slowpoke
https://yukimisoft.itch.io/isitokayformetolive
https://priro.itch.io/digital-games-physical-spaces
https://uniow.itch.io/3ternally
https://bunibonbun.itch.io/yurizine2
https://yagi-sakaguchi.itch.io/yoka
https://rosemarbles.itch.io/snailshell
https://theoying.itch.io/errant-knight
https://liberato.itch.io/girly-jam
https://foeaudiobook.itch.io/littlepip
https://ppilotco.itch.io/kigurumi-and-identity
https://bunibonbun.itch.io/scythebat
https://creative-liberties.itch.io/posology
https://maolong.itch.io/fetid-fecundity
2026-10-28 00:23:38 +00:00
github-actions[bot] 5be4da2ee6 Ingest queued games [2026-10-27] 2026-10-27 20:34:08 +00:00
freeitchgames-admin[bot] 57ba8f0a95 Queue 146 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://balsaminaxxx.itch.io/childhoods-end
https://planeta-polilla.itch.io/trespasser-rpg
https://n00bcode.itch.io/rcbasic-basic-programming-language-for-games
https://farawaytimes.itch.io/facets
https://galactical.itch.io/aglet
https://reindeerabbit.itch.io/dustofdays
https://wriks.itch.io/5-red-mickeys
https://menutowngames.itch.io/ari-2
https://hikokyoujurou.itch.io/hanabi-si
https://rotmaiden.itch.io/victim-soul
https://glimmerteam.itch.io/girl-of-the-bakehouse-renpy
https://aiden-e-messer.itch.io/snuffpuppy
https://hotpink.itch.io/cryptid-park
https://yasy-jpng.itch.io/idasa
https://strawberrycongee.itch.io/systemelegy
https://goblincat.itch.io/along-an-extremity
https://kazehai.itch.io/ten-metre-tide
https://gaybreast.itch.io/fairy-unfortunate
https://u-b-u.itch.io/connect-the-dots
https://chambersoft.itch.io/sunshinebackwards
https://sarlianna.itch.io/lay-down-misere
https://doctorbonedeath.itch.io/trip-to-the-milky-way
https://abstractlion.itch.io/ascii-lion
https://permaonline.itch.io/future-basketball-city
https://basicbean.itch.io/they-once-had-names
https://porksbun.itch.io/lonely-dog
https://menutowngames.itch.io/whimsicalrealm
https://fivestarcrest.itch.io/thriftgirl
https://fivestarcrest.itch.io/old-altars-new-goats
https://darionmccoy.itch.io/re-body
https://christinacreatesgames.itch.io/witches-of-the-flow
https://homieshouse.itch.io/clinical-trial
https://ednaarel.itch.io/in-sky-above-in-earth-below
https://flowerstudio.itch.io/dead-names
https://kemze.itch.io/tko
https://newtype.itch.io/a-normal-catboy-story-or-the-cat-and-superstition
https://menutowngames.itch.io/menutown
https://lastzimonearth.itch.io/the-crystals-of-regret
https://rawrku.itch.io/whatthefish
https://hamumu.itch.io/kid-mystic
https://catbirdsoft.itch.io/steel-carnelian
https://porpentine.itch.io/maggot-therapy
https://mezzaninesoftware.itch.io/landsword
https://mental-burn-out.itch.io/anima-reprise
https://poeticandroid.itch.io/homegirl
https://apehardware.itch.io/t-m-e-a
https://nizakashii.itch.io/sabawalk
https://heinn.itch.io/shrinekeeper
https://prairieland.itch.io/akasha-dreams
https://cattoshark.itch.io/evelyn
https://teamfreshnewlove2022.itch.io/doubleblush
https://goburinbro.itch.io/sekaiju-font-collection
https://annswwr.itch.io/breadbasket
https://lichendust.itch.io/lena
https://shindoh.itch.io/perspective-sketch
https://madgarden.itch.io/eggnogg
https://tsunscreen.itch.io/somnicoda
https://aureanoire.itch.io/btw
https://aureanoire.itch.io/abundance
https://maduzu.itch.io/itigokuruiza-ptbr
https://yaru.itch.io/super-radio-blast-3d
https://saturnvxiii.itch.io/loveyourtime
https://wolfieworld.itch.io/homebrew-formaldehyde
https://yamikurae.itch.io/how-a-body-sounds
https://dominoclub.itch.io/meet-fred
https://oceansdream.itch.io/paradise-blue
https://pigeonhag.itch.io/stage-management-simulator
https://richterwilker.itch.io/weird-house
https://d-mag.itch.io/keyrin-loves-you
https://elsenyh.itch.io/cucurucu
https://skeeeth.itch.io/growing-dread
https://datasparrow.itch.io/orientation-an-introductory-zinelet-to-psycho-patrol-r
https://welcome-to-elderfield.itch.io/welcome-to-elderfield
https://mogdogblog-productions.itch.io/dysphoric-soymilk-lidocaine
https://bryce-bucher.itch.io/sad-rabbits-alien-night-out
https://snekofspice.itch.io/being-cis-is-easy
https://farfin.itch.io/aliens-on-a-school-day
https://usdivad.itch.io/garden-song
https://panelix.itch.io/panelix
https://pixelvision8.itch.io/pv8
https://guselect.itch.io/moonleap
https://guselect.itch.io/echosqueak
https://yabeeboy.itch.io/dddk
https://peittov.itch.io/nyr09
https://schmidt-workshops.itch.io/airtreker
https://zedo.itch.io/in-eccentric-orbits
https://zedo.itch.io/depth-complaint
https://transmutrix.itch.io/disuku-js
https://3denemy.itch.io/aggies-digital-art-gallery
https://dosogy.itch.io/mroi
https://crit-chance-studios.itch.io/dreambox
https://killjill.itch.io/memento-in-marrow
https://flowerstrangle.itch.io/szmiewskis-order-of-the-foot
https://mausimus.itch.io/shaderglass
https://annaliviaxyz.itch.io/fake-game-jam-game
https://sinclairstrange.itch.io/depth-survivor
https://nnoizz.itch.io/streetsad
https://crvptozoology.itch.io/signals
https://shinlalala.itch.io/axyn
https://lapinlunaire-games.itch.io/ianthine
https://lawraclark.itch.io/286-miles
https://acceleratingwind.itch.io/black-rain
https://kirinoyastudios.itch.io/dawn-of-seltiria-rpg
https://serotines.itch.io/v7v7v7
https://salmonrowe.itch.io/the-prince-of-salamanders
https://ottiliere.itch.io/the-grief-complex-phase-2
https://keithballard.itch.io/since-november
https://june-flower.itch.io/amphora-hell
https://apehardware.itch.io/get-in-the-fucking-tower
https://peittov.itch.io/libertygolf
https://narfnra.itch.io/worms-will-eat
https://communistsister.itch.io/superlunary-dev-version
https://tunditur-unda.itch.io/prophecy-sectors
https://yegboi.itch.io/unbothered
https://3denemy.itch.io/root-velocity
https://kolulu.itch.io/operation-eventide
https://twinbeard.itch.io/basil-returns
https://ehcb.itch.io/beach-belly-bloodbath
https://dericbindel.itch.io/your-toy-sucks
https://snekofspice.itch.io/growing-up
https://hatimb00.itch.io/games-for-your-computer
https://outootome.itch.io/dolls-play
https://fwtrm2k3.itch.io/onsen-rpg-a-tale-of-yu
https://whitman-la-torra.itch.io/the-great-i-am
https://smudgebap.itch.io/pushover
https://nenkaii.itch.io/thats-your-gender
https://minusonepublishing.itch.io/frontiers-of-the-mind
https://tentaclesgames.itch.io/anomaly-evolution
https://yogurtthehorse.itch.io/headquarters
https://unseconds.itch.io/street-lamp-lover
https://l-a-u-g-h.itch.io/the-endless-empty
https://bagelcollie.itch.io/dogruru
https://isahime.itch.io/pp
https://deaddeaddeath.itch.io/heatwave
https://doonutsaur.itch.io/tiny-hamsters
https://stellarnull.itch.io/woncon
https://mryes.itch.io/3dwiscr
https://500poundsofnothing.itch.io/datanomicon
https://iristoid.itch.io/i2igitm
https://fomonomo.itch.io/bk2
https://chavafei.itch.io/sinker-sound
https://virtuavirtues-backlog.itch.io/super-world-of-goo-demo
https://yancharkin.itch.io/hp-bar
https://skooka.itch.io/fun-swing
https://ledoux.itch.io/bitsybox
https://phallicmother.itch.io/winterbunny444
2026-10-27 20:23:27 +00:00
github-actions[bot] e00252af1e Ingest queued games [2026-10-27] 2026-10-27 16:24:01 +00:00
freeitchgames-admin[bot] 79937d88e2 Queue 5 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://amethyscent.itch.io/mahla
https://cuahoangde.itch.io/juhoon-dep-trai-qua-troi
https://farismorgan.itch.io/3-days-to-confess
https://krowlin.itch.io/the-date-perfect
https://rian-threeden.itch.io/ant-crisis-loving-story-in-a-small-world
2026-10-27 16:23:21 +00:00
github-actions[bot] c53de2470a Ingest queued games [2026-10-27] 2026-10-27 12:42:53 +00:00
freeitchgames-admin[bot] 194d684081 Queue 150 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://acpkid.itch.io/over-my-shoujo-body
https://ekinn.itch.io/greed
https://falkenstein-archives.itch.io/lhritage-sanglant
https://geneartifacts.itch.io/parallel-frequences
https://mackarknest.itch.io/no-lo-toques
https://popelephant.itch.io/my-dad-is-a-femboy
https://steinlex.itch.io/ngy-bnh-thng-ca
https://t0rih.itch.io/dolly-rest
https://yukidaruman.itch.io/kabedon
https://zxbasicgames.itch.io/illustrated-crimes-english-version
https://ebon-forge-games.itch.io/sun-smith
https://noblemaster.itch.io/retro-commander
https://sillywunkus.itch.io/farm-island
https://star2dfd.itch.io/starlock
https://sukinapan.itch.io/hlina
https://lokeloski.itch.io/pet-the-cat
https://ednaarel.itch.io/yet-another-planning-doc
https://chattercap.itch.io/the-perfect-woman
https://meant-to-bee-studios.itch.io/rectifier-in-bloom
https://ichorofruin.itch.io/in-wake-of-betrayal
https://ednaarel.itch.io/i-wont-finish-this-game
https://sunlabyrinth.itch.io/never-leave
https://ednaarel.itch.io/awakening
https://summerorigins.itch.io/step-by-little-step
https://005lumens.itch.io/a-god-who-lives-in-your-head
https://ednaarel.itch.io/just-go-for-it
https://yam-harvest.itch.io/through-the-panels
https://prikarin.itch.io/petrichor-vn
https://skyshard.itch.io/the-crimson-line
https://rebelcgames.itch.io/a-place-where-nothing-happens
https://knightanni.itch.io/today-is-the-end-of-the-world
https://kigyo.itch.io/artificial-fashionista
https://konayachi.itch.io/to-you
https://ednaarel.itch.io/lovetellers
https://chattercap.itch.io/mindmindmind
https://coda-blue.itch.io/this-life-escapes-me
https://chimeriquement.itch.io/the-thread-and-the-sword
https://chattercap.itch.io/kanau
https://ednaarel.itch.io/with-a-shadow-of-a-doubt
https://chimeriquement.itch.io/the-day-being-ace-made-him-stronger
https://pep.itch.io/tomb-of-friends
https://madame-photon.itch.io/snow-angel-and-silver-devil
https://chimeriquement.itch.io/son-of-the-woods
https://gummyghosting.itch.io/of-fangs-and-fleece
https://chimeriquement.itch.io/the-life-i-lost
https://taumilicorice.itch.io/melancholic-star-to-sleep
https://zetareishi.itch.io/penultima
https://smokemirror.itch.io/little-griefs
https://ebbasuke.itch.io/captains-farewell
https://konayachi.itch.io/tuna-rice
https://ednaarel.itch.io/shibboleth
https://rottentief.itch.io/going-out-out
https://butterblanc.itch.io/threads-of-snow
https://chimeriquement.itch.io/kissing-snow-white
https://maho-anpu.itch.io/princess-from-anowo
https://okenki.itch.io/b4e
https://mintglow.itch.io/all-that-probably-glitters
https://fishwarning.itch.io/world-end-heart-girl
https://reimenayee.itch.io/the-god-of-arepo
https://tymedust.itch.io/the-skirmish-at-bender
https://lysrie.itch.io/extracurriculars
https://cheerfulgoth.itch.io/granny-goes-outside
https://hollowmend.itch.io/fetch-quest
https://kale-chips.itch.io/melting-of-the-winter-gears
https://kale-chips.itch.io/midnight-on-the-milky-way
https://himawariness.itch.io/dolchio
https://viridianns.itch.io/sweet-blend
https://chasecubed.itch.io/kissed-by-the-stars
https://starlit-carnival-studios.itch.io/death-and-romance
https://fablenovel.itch.io/gidget-frog-detective
https://littlerat.itch.io/night-shift
https://radiovoice.itch.io/i-am-promise
https://rick-lombric.itch.io/marcel
https://heiden.itch.io/elvine
https://tymedust.itch.io/a-day-in-the-life
https://hearty-soup-studio.itch.io/under-maintenance
https://ilyilaice.itch.io/jester-under-pressure
https://heiden.itch.io/dr-franks-build-a-boyfriend
https://theartgremblin.itch.io/where-ages-go
https://knickknackpj.itch.io/negativespace
https://moawling.itch.io/is-it-that-deep-bro
https://heiden.itch.io/a-new-don
https://heiden.itch.io/the-far-rings
https://bekiwoo.itch.io/nell-the-festival-of-spooks
https://witpop.itch.io/imasidecharacter
https://husbandogoddess.itch.io/panicked-and-surrounded-by-hot-vampires
https://milkkylemon.itch.io/yukis-4p
https://katy133.itch.io/ghost-switch
https://shibalist.itch.io/yrsa-major
https://dicesuki.itch.io/cinderella-phenomenon
https://heiden.itch.io/kill-the-prince
https://robobarbie.itch.io/blooming-panic
https://apple-cider.itch.io/autumns-journey
https://katy133.itch.io/the-heart-of-tales
https://sitraxis.itch.io/locked-heart
https://happybackwards.itch.io/rockrobin
https://kikamack.itch.io/night-circus
https://modus-interactive.itch.io/armored-shell-nightjar
https://ephemerazine.itch.io/ephemera-krz-zine
https://ghomanimation.itch.io/shellbreaker
https://saturnyoshi.itch.io/lxd-red-honey
https://radcodex.itch.io/cragrook
https://renato-meyer.itch.io/los-hazmerreir
https://thewaether.itch.io/witchs-bananas
https://snugboat11.itch.io/kitty-kart-64
https://mrmotarius.itch.io/mrmotrondmg
https://blast-harbour.itch.io/metallic-men
https://acornbringer.itch.io/of-love-and-eternity
https://branegames.itch.io/we-suspect-foul-play
https://ronyaib.itch.io/the-wizard-assistant
https://the-water-museum.itch.io/arctic-eggs-jam
https://mkapolka.itch.io/stomp-plonk
https://selkieharbour.itch.io/the-anglerfish-project
https://a327ex.itch.io/emoji-merge
https://vidhvat.itch.io/run-gun
https://gbadev.itch.io/gba-microjam-23
https://ofek-neumann.itch.io/the-cats-garden
https://ivysly.itch.io/blood-golf
https://lumpytouch.itch.io/fetch-quest
https://modus-interactive.itch.io/bryce-render-pack-v2
https://soulpotion-games.itch.io/asgards-fall
https://gabriel-helfenstein.itch.io/a-time-travellers-guide-to-past-delicacies
https://selkieharbour.itch.io/isa-calendar-photoshoot-2023
https://warrrkus.itch.io/hamelins-journey
https://brandonhare.itch.io/airt
https://managore.itch.io/stereogram
https://freds72.itch.io/poom
https://mooncandyco.itch.io/a-garden-for-zone-47
https://rittzler.itch.io/blazingdynamo
https://rittzler.itch.io/stratospear
https://cynomanic.itch.io/frog-recipe-cards
https://haofan.itch.io/sword
https://hempuli.itch.io/babataire-ex
https://doiion.itch.io/pet-sematary
https://eyes8.itch.io/moonworld
https://june-flower.itch.io/washout-spire
https://oldmediaart.itch.io/night-running
https://managore.itch.io/holey-hell
https://jasoonmargoon.itch.io/super-raft-boat-classic
https://love-from-tom.itch.io/yazz
https://ianmaclarty.itch.io/if-we-were-allowed-to-visit
https://chicogames.itch.io/redtape
https://kittyhorrorshow.itch.io/haunted-cities-v4
https://isart-digital.itch.io/symphonia
https://malec2b.itch.io/the-waystones-toll-a-diorama-mini-dungeon
https://vfqd.itch.io/terra-nil
https://june-flower.itch.io/labyrinth-derelict-abyss
https://samson-auroux.itch.io/a-skiers-journey
https://tasogare66.itch.io/nibiruman2080
https://braininabowl.itch.io/a-story-in-the-desert
2026-10-27 12:24:04 +00:00
github-actions[bot] d757885a58 Ingest queued games [2026-10-27] 2026-10-27 08:34:39 +00:00
freeitchgames-admin[bot] 7477d9a582 Queue 163 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://chaosdrakepress.itch.io/5-min-zombie-e
https://nycavri.itch.io/5-min-masquerade
https://yenofven.itch.io/5-min-e
https://nycavri.itch.io/5-min-quickstop
https://brite-palette.itch.io/crisis
https://dominoclub.itch.io/5-min-machine
https://damdan.itch.io/1-min-dread-urbex
https://esprit-vorpal.itch.io/10-min-to-be-a-dream-thief
https://comemartin.itch.io/5-min-mall
https://enui.itch.io/5-min-knight
https://parts-per-million.itch.io/5-min-haunting
https://mrbth.itch.io/5-min-mysterious-farm
https://muzett.itch.io/5-min-in-the-shire
https://darkjaguar8.itch.io/5-min-monsterhunt
https://azukailgames.itch.io/5-min-secret-agent
https://mstrocks.itch.io/5-min-heroes
https://azukailgames.itch.io/5-min-superhero
https://enui.itch.io/5-min-fanfic
https://enui.itch.io/5-min-witch
https://enui.itch.io/5-m-in-translovakia
https://enui.itch.io/5-min-maven
https://enui.itch.io/5-min-clue
https://featherboy.itch.io/dead-air
https://deepfriedghost.itch.io/date-fright
https://izzyyyx.itch.io/purgatorio
https://elion-time001.itch.io/are-you-there
https://wohmallow.itch.io/artemis-eccho-and-the-subliminal-labyrinth
https://cheddarteeth.itch.io/west-of-the-highway
https://fellowfroggy.itch.io/till-death-brings-us-together
https://tine5.itch.io/the-monster-of-the-bayou
https://xenogio.itch.io/the-ghost-of-kutha
https://aaawushan.itch.io/expiation
https://phantomaxisstudios.itch.io/submission1
https://inactiveaccount88.itch.io/yormesyx64
https://psytronik.itch.io/sub-hunter-c64
https://retrosouls.itch.io/old-tower-commodore-64
https://richard-tnd.itch.io/guillotine
https://richard-tnd.itch.io/starfysh
https://psytronik.itch.io/woolly-sheepoid
https://iceteam.itch.io/little-sara-sister-trilogy-c64-tape
https://psytronik.itch.io/x-force-c64-free
https://2-gorblins-in-a-studio.itch.io/calibans-cruelty
https://weepingstagpress.itch.io/into-the-viridian-pit
https://goose-grimoire.itch.io/the-salt-queens-curse
https://dontkickfood.itch.io/the-woad-wood-weeps
https://playerdeer.itch.io/the-aura-surge
https://gravy-press.itch.io/spell-of-the-world-weavers
https://kak4p0.itch.io/o-zigurate-lunar
https://groakette.itch.io/the-throne-of-the-feathered-tsar
https://henriquel.itch.io/quest-unwanted-person
https://malachijs.itch.io/sundial-siphon
https://ellie-valkyrie.itch.io/underbranching
https://thezaru.itch.io/el-castillo-del-vampiro
https://marquesarthur.itch.io/cairn-2e-fogo-fatuo-fluorita
https://sotreknomad.itch.io/temple-of-the-mermaid-for-cairn-2e
https://girlsatcomputers.itch.io/book-of-the-isles-i
https://cultofthecommodity.itch.io/the-hypergeometric-incursion-of-heu
https://sddnd.itch.io/dungeon-cookbook-delves-1
https://sddnd.itch.io/dungeon-cookbook-delves-2
https://mgustafsson.itch.io/toxic-tangle
https://refjon.itch.io/kobold-tunnels
https://yttikon.itch.io/lady-grey-of-the-beautiful-end
https://ekkamai.itch.io/halls-of-the-witch-queen
https://gingereno42.itch.io/little-ghost-town-a-forest-pointcrawl
https://madcleric.itch.io/the-cult-of-tegny-wood
https://andrew-cavanagh.itch.io/cairn-lair-of-the-frost-witch
https://ratchattowns.itch.io/whispers-through-the-grass
https://karlyanders.itch.io/a-sliver-of-evidence-preview
https://weepingstagpress.itch.io/heron-watch
https://refjon.itch.io/goblin-market
https://minorarcana.itch.io/dungeon-forest-hex
https://seedling.itch.io/onegeon-a-crack-in-the-ground
https://soundsofbones.itch.io/titansflute
https://andrewwritegood.itch.io/frozen-fane-of-the-far-traveller
https://watcherdm.itch.io/dont-wake-the-worm
https://dungeonofdelirium.itch.io/the-hermitage-of-alazaram-the-alchemist
https://pointlessmonument.itch.io/ruin-of-reputation
https://c-f-enriquez.itch.io/a-needle-in-a-sword-pile-cairn-edition
https://dicegoblingames.itch.io/howling-halls-of-whisperstone
https://noseatbelts.itch.io/knotwood
https://noseatbelts.itch.io/the-tomb-of-eight-gates
https://fleetingxe.itch.io/martas-vineyard-of-despair
https://cairnpress.itch.io/the-feast-of-tegny-wood
https://jay-zer0.itch.io/the-accursed-rock
https://jay-zer0.itch.io/the-dreaming-well
https://1pagedungeons.itch.io/urban-crawl
https://rafaelortega.itch.io/primates-with-wands
https://sanchezeli.itch.io/suba-a-starter-seed
https://pippomaster92.itch.io/the-wailing-on-blind-bluff
https://theinscrutabledr3.itch.io/prophet-of-the-wyverns-word
https://carthoz.itch.io/visions-of-lost-lemoria
https://johnny-faina.itch.io/in-grendels-grasp
https://malachijs.itch.io/war-below-the-waves
https://jamie-douglas.itch.io/twisting-old-wounds
https://fishdavidson.itch.io/the-lost-book-of-galimatias
https://patrick-buczek.itch.io/the-leshys-grove
https://creative-wronging.itch.io/in-the-house-of-pluto
https://maximlowe.itch.io/gjoll
https://linuz.itch.io/beyond-the-seers-grotto
https://haughty-homunculus.itch.io/coniraya-descends
https://cultofthecommodity.itch.io/the-chalk-marked-grave
https://gravy-press.itch.io/the-fiend-sworn
https://odinsongamesgmailcom.itch.io/damned-by-the-witch-well
https://robert-raulus.itch.io/gully-of-the-golden-gorgon
https://lusunati.itch.io/treasure-of-the-unquiet-dead
https://rileyadammmson.itch.io/beneath-the-summer-snow
https://undead-mole.itch.io/raiders-of-the-crystal-keep
https://eucatastrophic.itch.io/the-five-fates-of-estra-zo
https://orthopraxy.itch.io/the-yakshas-sigil
https://explorers.itch.io/invaders-of-atlantis
https://yesterweird.itch.io/songs-for-the-bone-harp
https://girlsatcomputers.itch.io/floodplains-of-illamoor
https://noseatbelts.itch.io/the-witch-tree
https://noseatbelts.itch.io/the-deathless-prince-of-mirefen
https://andrewwritegood.itch.io/armour-of-the-phlox-haze
https://jbyrne97.itch.io/the-crypt-of-lowell
https://2-gorblins-in-a-studio.itch.io/emeralds-from-the-braying-beast
https://bonsaipropaganda.itch.io/jonahs-monster
https://catshavenolord.itch.io/shapeshifters-of-biringan
https://odinsongamesgmailcom.itch.io/knight-of-the-corpse-trials
https://toadmilkstudio.itch.io/crypt-of-saint-wendelgard
https://junkyardtornado.itch.io/whisper-dragon-and-the-blood-worm-moon
https://jfur.itch.io/shivering-moon
https://bommyknocker-press.itch.io/pit
https://jofas.itch.io/the-crimson-caverns
https://alfalcon.itch.io/the-spires-of-kuyyin
https://wuggy.itch.io/bloodhoney
https://sanchezeli.itch.io/nothing-will-come-of-nothing
https://xenokraft.itch.io/escape-to-blackboot-bog
https://pellep.itch.io/land-of-winter
https://maroonthunder.itch.io/the-tale-of-drowsy-burrow
https://cairnpress.itch.io/trouble-in-twin-lakes
https://lemos.itch.io/the-crypt-of-crimson-ice
https://2-gorblins-in-a-studio.itch.io/widdershins-hollow
https://dungeoncrab.itch.io/hall-of-the-five-moons
https://jason-thomas.itch.io/stony-foot-camp-area
https://gravy-press.itch.io/halls-of-the-beetle-queen
https://giantrobottackler.itch.io/way-down-on-the-waccamaw
https://cairnpress.itch.io/rise-of-the-blood-olms
https://sabrina-tvband.itch.io/beneath-the-green-rooster
https://gordyh.itch.io/the-corvids-coffer
https://gordyh.itch.io/temple-of-the-3-wolf-moon
https://catshavenolord.itch.io/door-hoard
https://junkyardtornado.itch.io/mud-readers-deep
https://chrisair.itch.io/face-of-hgradal-jaquays-memorial
https://junkyardtornado.itch.io/vault-of-the-star-gods-children
https://pellep.itch.io/the-rock-face
https://catshavenolord.itch.io/jaxons-claim
https://paradisebunny.itch.io/a-feast-for-flies
https://wuggy.itch.io/praise-be-god-of-filth
https://joeyv120.itch.io/is-mightier-by-matt
https://palleonpress.itch.io/wands-of-the-whippoorwill-wood
https://noapostrophe.itch.io/witchingwood
https://perplexingruins.itch.io/hunt-for-the-moss-troll
https://pulpee.itch.io/the-bloody-pig-sty
https://hafle.itch.io/flickering-lamplight
https://scribbledmaze.itch.io/a-sword-of-the-forest
https://tlomdev.itch.io/a-reliable-source
https://pankodl.itch.io/house-of-cuckoo
https://pointlessmonument.itch.io/the-chamberlains-chessboard
https://danfawcett.itch.io/seven-stars-of-the-unseen
https://hr-am.itch.io/the-god-of-rot
https://jamie-douglas.itch.io/exton-edge-of-the-west
2026-10-27 08:23:36 +00:00
github-actions[bot] dc2d73bc04 Ingest queued games [2026-10-27] 2026-10-27 04:27:16 +00:00
freeitchgames-admin[bot] e3aaf13b78 Queue 46 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://elevategaming.itch.io/komatsu-pc-60-series
https://kenforest.itch.io/rotten-machines
https://megastyle.itch.io/gridlock
https://natitawrites.itch.io/costa-sul
https://santiago-garcia.itch.io/the-masterplan
https://sima.itch.io/zpellcatz-pumpkin-prologue
https://springvillager.itch.io/your-lantern-burns-with-borrowed-light
https://wuwa-abyss.itch.io/wuthering-waves-abyss
https://yukimisoft.itch.io/if-you-stay
https://dawit.itch.io/the-singing-scar
https://moonphaseproductions.itch.io/exiles-journey
https://davidblandy.itch.io/five-fathoms-deep
https://baying-hog-pit.itch.io/doll-weavers-affluence
https://spicytunarpg.itch.io/the-hands-that-feed
https://72stations.itch.io/infinity-of-ships
https://eryk-sawicki.itch.io/filmmakers-without-cameras-the-trilogy
https://carpedavid.itch.io/dead-horse
https://iznaut.itch.io/bimbo
https://bird-king.itch.io/rot-with-me
https://soulengineproject.itch.io/lightvn
https://fictionfactorygames.itch.io/laugh-track
https://zebark.itch.io/hardest-moon
https://meiri.itch.io/doce-fim
https://datasparrow.itch.io/radio-free-lutesse
https://sfbgames.itch.io/chiptone
https://communistsister.itch.io/lets-fuck
https://the-lost-bay.itch.io/make-accessible-ttrpgs
https://comigo.itch.io/better-creator-pages
https://meiri.itch.io/convert-compress-files
https://leoqb.itch.io/nightcrawler
https://azufx.itch.io/novas-ship
https://gugames.itch.io/eulogy
https://necropocene.itch.io/a-night-for-flesh-and-roses
https://ponpai.itch.io/ponpai-prototype
https://boniae.itch.io/sagebrush
https://deklaration.itch.io/aquavista
https://elyaradine.itch.io/dressmaker
https://monazone.itch.io/mahjong-for-babies
https://arghbulous.itch.io/a-cup-of-eternity
https://devilspider.itch.io/pointnclick-plug-in-for-renpy
https://meiri.itch.io/raguna
https://knickknackpj.itch.io/chimerabaloney
https://xxmissarichanxx.itch.io/beachday
https://lenlen403.itch.io/the-healing-of-sisyphus
https://lenlen403.itch.io/under-the-stars
https://lenlen403.itch.io/talisman-of-dawn
2026-10-27 04:23:32 +00:00
github-actions[bot] 09605aba72 Refresh catalog [2026-10-27] 2026-10-27 03:42:11 +00:00
github-actions[bot] 90782e6e14 Ingest queued games [2026-10-27] 2026-10-27 00:34:57 +00:00
freeitchgames-admin[bot] 65e3990271 Queue 160 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://proton31.itch.io/big-mofo-island
https://gingereno42.itch.io/lets-make-an-island-island
https://ivoziskra.itch.io/ivos-iow-island-spark-table
https://davidblandy.itch.io/ark-of-hope-one-page-ttrpg
https://colmnorrish.itch.io/city-in-the-leaves
https://gatheraround.itch.io/the-dusty-caravan
https://catshavenolord.itch.io/wormtooth
https://athalos-gallant.itch.io/denizen-devilry
https://symphonicstoryteller.itch.io/the-epicurean-caravan
https://caelinaraven.itch.io/life-underneath
https://offworldbogil.itch.io/a-resonant-hum
https://caelinaraven.itch.io/from-dust-to-marquis
https://davidblandy.itch.io/the-art-lover-dungeon-for-jennell
https://davidblandy.itch.io/adventure-template-for-eco-mofos
https://chaoclypse.itch.io/eco-mofos-map-generator
https://marx-of-high-water.itch.io/the-shepherdex
https://caelinaraven.itch.io/facility-of-impending-doom
https://donnytulips.itch.io/withallmyhrt
https://snekofspice.itch.io/sunless-horizon-1-5
https://shan-ka.itch.io/beanstalk-1k
https://goldbuick.itch.io/tower-to-god
https://keksikmaks.itch.io/blank-124
https://puapka.itch.io/our-comix
https://yabeeboy.itch.io/salmon-and-ice
https://autobioarchitech.itch.io/headsrest
https://harpsi.itch.io/beast-of-i
https://yaitso-demona.itch.io/sitting-tenant
https://lily-ruth.itch.io/burning-gates
https://lunaticker.itch.io/ache-vermin
https://thp.itch.io/loonies-8192
https://routevn.itch.io/routevn-creator
https://vl-ad-no.itch.io/hall-3
https://chambersoft.itch.io/babylon-ohio
https://shnoazo.itch.io/post-impact
https://ernestborgnine.itch.io/wmcjtrns
https://fisheranimal.itch.io/what-hath-god-wrought
https://polycube2.itch.io/whatevers-loaded
https://onymonch.itch.io/motherboard
https://bravemule.itch.io/beneathfloes
https://boghog.itch.io/caramel-action-returns
https://dianerds.itch.io/flatline-girls
https://pupn1k.itch.io/nomirame
https://strawberrycongee.itch.io/crip-anthology
https://strawberrycongee.itch.io/alien
https://isopodgames.itch.io/dryjerky
https://sarrukh.itch.io/gainsboro
https://lizryerson.itch.io/problem-attic
https://gongpha.itch.io/cat-var-www-s0
https://illuminesce.itch.io/blind-date-zine
https://akuma-kira.itch.io/acit-soup
https://han-tani.itch.io/anti-animaction-manifesto-environmental-action-manifesto
https://maxjk0.itch.io/yumenoka
https://nickshutter.itch.io/million-bouillon
https://yesbox.itch.io/metropolis1998
https://addedviolence.itch.io/artisanal-gruel
https://callmemonamiral.itch.io/eleggs-mansion
https://holographicdoll.itch.io/returning-to-video-games
https://ggbot.itch.io/xoffline
https://heckmaybe.itch.io/hole-exploration
https://borbware.itch.io/emuurom
https://mimill.itch.io/dream-affection-sleepy-planet
https://sierpinski-simon.itch.io/yume-nikki-maker
https://coisinhaverde.itch.io/micro-battles-muskets
https://onamint.itch.io/agot
https://fotocopiadora.itch.io/anime-girls-of-riven-the-sequel-to-riven
https://zedworks.itch.io/mind-heaven
https://meangirls.itch.io/weave-4
https://mrkogamedev.itch.io/shredoka-magical-girl-skateboarding
https://antichrist-noelle.itch.io/gluttonism-story-tuki-tiki-visual-novel
https://miomancer.itch.io/anyone-can-jump
https://troitsky-park.itch.io/nadvoih
https://lovelesspress.itch.io/a-web-worth-wandering
https://dinopoloclub.itch.io/rtfm
https://matthewlacker.itch.io/gaarl-demo
https://justjonut.itch.io/before-the-moon
https://mad-about-mushrooms.itch.io/hedonist-feedback-needed
https://mayazmaya.itch.io/nekojiru-pm
https://plutonist.itch.io/more-life-dead-interface
https://fusionnist.itch.io/bajillionaire
https://illuminesce.itch.io/ffoam
https://treyfoil.itch.io/meaningless-tragedy
https://electrotriple.itch.io/leons-grand-slam
https://normans-room.itch.io/difference-machine
https://buldozer.itch.io/kraa
https://terriv.itch.io/mundolixo
https://barch.itch.io/unfolding
https://stale-meme.itch.io/oasis3
https://broken-joysticks.itch.io/dont-forget
https://picaroondev.itch.io/the-alchemist
https://picster.itch.io/moldrise
https://2hrgamejamclub.itch.io/five-families
https://obliviist.itch.io/nothing-dies-in-dreamland
https://majd-rouhana.itch.io/paragon-story
https://magicalyuto.itch.io/mystery-of-funeral
https://kolulu.itch.io/senescence
https://lostandfounditch.itch.io/clock-world
https://aug81074.itch.io/the-museum-of-stones-i-found-while-walking
https://saltedslug.itch.io/violence-at-the-end-of-the-world
https://glouderglens.itch.io/a-dolls-decision
https://tabithanikolai.itch.io/the-alembic-hotel
https://alex-huang.itch.io/tapestry
https://karastone.itch.io/known-mysteries
https://claymoregwen.itch.io/haunt-holy
https://onamint.itch.io/dedicated-healer-onamintart
https://kittenm4ster.itch.io/stairway-to-kevin
https://cosmicraycast.itch.io/goldrush64
https://cosmicraycast.itch.io/treblebasie
https://tommulgrew.itch.io/air-pico
https://lunaticker.itch.io/passenger-x-princess
https://technomancy.itch.io/tower-institute-of-linguistics
https://raysberry.itch.io/gossamer
https://auxiliarycarry.itch.io/petitjardin
https://magic-nipples.itch.io/that-damn-fox
https://hudson-the-rock-baird.itch.io/johnnysalamivtpovgp
https://tycobbb.itch.io/boy-ogre
https://splatbones.itch.io/dollhouse-arsonist
https://adriendittrick.itch.io/silksogn
https://wandeer.itch.io/dreams-to-text
https://jyolyu.itch.io/diagram-world-vii
https://elrosso.itch.io/too-many-croquetas
https://desktop-metaphor.itch.io/wet-dripping-face
https://ophanimkei.itch.io/love-battle-doll
https://nullaboxes.itch.io/transfusion
https://bodinhe.itch.io/cycles
https://magpuppy.itch.io/dead-dogs
https://cherry-treehouse.itch.io/wannafest22
https://xra.itch.io/uji
https://apehardware.itch.io/polbo-xigante-mental
https://mrmotarius.itch.io/mrmo-stitch
https://homerduc.itch.io/maison-detre
https://cosmicraycast.itch.io/mazetycoon-demo
https://fat-lazy-cat.itch.io/dungeon-dude
https://fat-lazy-cat.itch.io/rapture-island
https://patchy-illusion-team.itch.io/towelket-one-more-time-kemono
https://snekofspice.itch.io/everyday-sororicide
https://twinbeard.itch.io/it2
https://fish0nland.itch.io/maleghast-night-haunts
https://menutowngames.itch.io/polygonal-toy
https://rpgmaker2003.itch.io/februrary
https://bcat112a.itch.io/squishcraft
https://zaebucca.itch.io/roma-pdm
https://skylyrac.itch.io/ucity-advance
https://ivysly.itch.io/evil-egg
https://fisheranimal.itch.io/murderplant
https://joegran.itch.io/dog-of-wisdom
https://r-goulart.itch.io/magic-gear
https://borderguard.itch.io/chess-and-honor
https://euclicide.itch.io/elegiac
https://bigbeefysharkbaby.itch.io/birds-and-bunkers
https://pixelrye.itch.io/motel-snooze-suite-dreams
https://doggiewoggiez.itch.io/no-dogs-under-heaven
https://heinn.itch.io/catabothic
https://datawest.itch.io/spook-buster
https://starpelly.itch.io/minesweeper
https://verdant-core.itch.io/lectern-book
https://absolutevendingmachine.itch.io/pumpice
https://frogmen.itch.io/10000-rooms-you-could-call-home
https://vitasunday.itch.io/cures-most-fickle
https://mysticalshiz.itch.io/cyberdeliamicro
https://anvilheadhammerhands.itch.io/plinker-demo
2026-10-27 00:23:35 +00:00
poli0981andClaude Opus 5.5 435af85983 docs(rate-limits): a WAF test that reaches the threshold (#169)
The runbook's WAF test now uses a Node fetch one-liner (connection pool):
xargs curl only reached ~20 requests/s, below the rule's 300 per 10 s.
Measured 2026-10-27: 800 requests in 4.9 s -> 111 x 200, 201 x Worker 429,
488 x WAF 1015.

[skip-discuss]

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-27 06:19:14 +07:00
poli0981andClaude Opus 5.5 45f64e6c39 docs(rate-limits): Worker binding counts per machine; test over one connection (#168)
Measured on production after the 4.5.0 deploy: with a new connection per
request, 1,000 requests in 53 s got no 429 from RL_SITE (120/60 s); over
one keep-alive connection, 429 after ~93. The ratelimits binding counts per
machine of a data centre and syncs late, so the zone's WAF rule is the
limit that holds against floods. Verified once the owner set the rule
(300/10 s): 800 requests in 4.9 s gave 111 x 200, 201 x Worker 429 and
488 x WAF 1015, with the site answering again 10 s later.

Runbook test commands, code comments, CLAUDE.md gotcha 43, the 4.5.0
changelog entry.

[skip-discuss]

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-27 06:17:42 +07:00
poli0981andClaude Opus 5.5 7920011c70 feat(worker): rate limits for the whole site (4.5.0) (#167)
Every request that runs the Worker is counted per client (IPv4, or IPv6
/64): RL_SITE 120/min (app pages, public /api, the old apps' /data JSON,
misses), RL_IMG 600/min (covers), RL_ADMIN 300/min (/admin + /api/admin);
RL_SUGGEST 5 and RL_GATE 20 stay on top for their POSTs. Verified bots are
not counted. Over a limit: 429 + Retry-After 60 (JSON for the API, covers,
files and /data with CORS; a script-less EN/VI page for app pages). Fails
open.

Every rate-limit namespace moves to 8801-8806 (staging 8901-8906):
namespace ids are account-wide, and other Workers on the account use
1001-1006, so RL_SUGGEST / RL_GATE shared their counters.

docs/operations.md section 1 step 15: the zone's WAF rate-limiting rule as
the first layer (Free plan: one rule, IP, 10 s; 300 requests / 10 s).

[skip-discuss]

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-27 06:02:49 +07:00
github-actions[bot] 84ab9b7761 Ingest queued games [2026-10-26] 2026-10-26 20:34:41 +00:00
freeitchgames-admin[bot] 656ef15285 Queue 156 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://aedonys-the-great.itch.io/lake-placid
https://ryanyul.itch.io/raise-your-ai
https://coffeetron.itch.io/pumpkin-carver
https://ndipdi.itch.io/flaggervalp
https://shindigs.itch.io/chat-jumper
https://delacannon.itch.io/advs98
https://dkliao.itch.io/mini-outer-wilds
https://markasais.itch.io/big-stretch
https://bum-bum-bum.itch.io/spaghenotti
https://thijsoid.itch.io/skylines
https://klardonics.itch.io/la-sardina
https://not-articulated.itch.io/urbanitas
https://rreveriee.itch.io/layover-horse
https://sweaterparrot.itch.io/aqualung-caverns
https://purplesloth.itch.io/whats-your-gender
https://timmy-beckmann.itch.io/15-minutes
https://obliviist.itch.io/qot
https://nimble.itch.io/catjammer
https://thecatamites.itch.io/international-obsession
https://suika-tabetabe-usagi.itch.io/pw7a
https://werxzy.itch.io/mr-swop
https://illuminesce.itch.io/derpy-derby
https://mutmedia.itch.io/claudio
https://officialelectric.itch.io/nothing-gallery
https://brysonmcbee.itch.io/this-world-is-ending
https://studio-laaya.itch.io/planetboys
https://axel-kulomaa.itch.io/glorpy-clamber
https://korogames.itch.io/high-walk
https://iceglobe-system.itch.io/snowy-glades
https://draknek.itch.io/all-the-gold-in-fort-locks
https://deimosly.itch.io/climb
https://klehrik.itch.io/flail
https://miomancer.itch.io/cornelius-quest
https://turndecassette.itch.io/the-prisoners-on-dozmary-craig
https://soaphia.itch.io/origin-of-me
https://thewaether.itch.io/katelabs
https://vaporwario.itch.io/picard-is-talking-to-me-and-i-cant-calm-down-and-i-should-give-up
https://akuma-kira.itch.io/lavenders
https://3denemy.itch.io/girlballs
https://juiccedev.itch.io/fossara
https://kaiakairos.itch.io/honey-walnut-world
https://beepyeah.itch.io/dotful-dodger
https://vitasunday.itch.io/u-2248
https://ronyaib.itch.io/cannone
https://julink.itch.io/caterpillar-game
https://bombyx-bug.itch.io/fun-facts-with-music
https://fusionnist.itch.io/particle-painter
https://goloob.itch.io/ptsd
https://tafto.itch.io/pump-punks
https://mors-games.itch.io/moon-child-fe
https://antontesh.itch.io/floating
https://bigbeefysharkbaby.itch.io/jumpbaby
https://nelsonje.itch.io/trafico
https://geeni.itch.io/signal
https://red-sauce.itch.io/prerolled
https://topherflorence.itch.io/the-gex-writers-room
https://thecatamites.itch.io/goblet-grotto
https://hubol.itch.io/lady-at-the-costco-gave-me-her-extra-hot-dog-soda-combo
https://managore.itch.io/mr-moneybag
https://cookiecrayon.itch.io/mingle
https://sketbordcat.itch.io/horse-magnifier
https://lunardust.itch.io/chomp-garden
https://zulubo.itch.io/pilot-quest-hd
https://ntesh.itch.io/shrinko
https://infinitetears.itch.io/cityephemera
https://antangsoftware.itch.io/perish-parade
https://gilmo.itch.io/abstraction
https://hatimb00.itch.io/talking-to-my-dad
https://managore.itch.io/ffffff
https://kikamack.itch.io/sunflower-ranch
https://ophanimkei.itch.io/glow-of-honeydew
https://fearless-cloud.itch.io/super-goblin-putt-putt
https://doriencey.itch.io/tad
https://naam.itch.io/apotu
https://hubol.itch.io/lets-hear-it-for-the-boys
https://pokeninjaguy.itch.io/pizza-planet
https://jakeonaut.itch.io/orange-ocean
https://nilson.itch.io/heal-slime
https://drewg8.itch.io/pelican-post
https://hubol.itch.io/lottie
https://katsaii.itch.io/selenewrecked
https://hubol.itch.io/kitty-on-the-run
https://adamatomic.itch.io/kolydr
https://g-aku.itch.io/frog-frost
https://hubol.itch.io/oddwargs-birthday-2026
https://managore.itch.io/tricky-tangled-train-tracks
https://siobhan-dent.itch.io/who-is-johnny-sixgun
https://adamatomic.itch.io/space-corgi-2
https://brysonmcbee.itch.io/cat-fish
https://forwardinstinct.itch.io/7dfps-mossguard-technical-demo
https://xenonfossil.itch.io/game-zette-printable-templates
https://hyphinett.itch.io/dronelord-hyperviber
https://bulboka.itch.io/rest
https://tehrealsalt.itch.io/snap-the-sentinel
https://polclarissou.itch.io/vermin3000-dataheist
https://kaiakairos.itch.io/plinkos-bomb-defusal
https://tsunscreen.itch.io/micro-games-for-macro-brains
https://ripriprip.itch.io/doggoworld-island-adventures-1
https://digitalgodtower.itch.io/wizards-wizards-wizards
https://cookiecrayon.itch.io/pikwip
https://forwardinstinct.itch.io/panchin-is-frustrated
https://june-flower.itch.io/elbe
https://olszoj.itch.io/syf
https://tinytouchtales.itch.io/gnomitaire
https://doriencey.itch.io/snippo
https://unnamedcollective.itch.io/retriggered
https://mattstark.itch.io/mazegarden
https://tobydo.itch.io/grass-mud-horse
https://mariopartygod.itch.io/michael-clayton
https://smarto-club.itch.io/rental
https://ripriprip.itch.io/wareware
https://rosettedotnet.itch.io/homoworld
https://brysonmcbee.itch.io/mp3d
https://amptomp.itch.io/walk-it
https://michaelsnewgame.itch.io/slow-fourier-transform
https://managore.itch.io/daniel-linssens-typing-challenge
https://unlessgames.itch.io/risofauna
https://planet-bluto.itch.io/moonhaunt
https://justcamh.itch.io/crane-game
https://nanobot567.itch.io/musik
https://bippinbits.itch.io/shleep
https://anoukh.itch.io/yes
https://adamatomic.itch.io/dust-bunny
https://dominoclub.itch.io/portrait-on-imagined-horizon
https://cyreides.itch.io/ghost-witch-soulstice-sprint
https://computerjames.itch.io/stealth-cw
https://cookiecrayon.itch.io/snug
https://sinclairstrange.itch.io/abyss-vaulter
https://oroshibu.itch.io/snailshock-grand-supreme
https://crayonmelon.itch.io/incar
https://datagoblin.itch.io/dungeonmode
https://jjj4cob.itch.io/hyperkid
https://jouko.itch.io/tiny-climber
https://tsunscreen.itch.io/ephemeral-frame
https://mogdogblog-productions.itch.io/nubbys-number-factory
https://hayd-n.itch.io/pastel-sandfish
https://computerjames.itch.io/dogman95
https://gamesformycomputer.itch.io/growth-spurt
https://hatimb00.itch.io/blue-exploration
https://datagoblin.itch.io/solarknight
https://celechii.itch.io/wolfclaw
https://hthr.itch.io/epistle-3
https://raithza.itch.io/boat-cats
https://dukope.itch.io/moida-mansion
https://seraphbin.itch.io/are-you-kidding-me
https://mattstark.itch.io/islandoodle
https://egordorichev.itch.io/async-chess
https://lukky-nl.itch.io/pick-a-little-one
https://team-bugulon.itch.io/gatotag
https://jakobwahlberg.itch.io/desertsurfdude
https://featurekreep.itch.io/looper
https://shelf.itch.io/afternoon-spaghetti
https://mattstark.itch.io/tramstertram
https://sandervanhove.itch.io/rubblar
https://drenindoku.itch.io/deep-snow-delivery
https://jontopielski.itch.io/pillow-fight
2026-10-26 20:23:29 +00:00
github-actions[bot] 7817a57015 Ingest queued games [2026-10-26] 2026-10-26 16:35:19 +00:00
freeitchgames-admin[bot] 5fe985e62f Queue 165 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://emberhoard.itch.io/dragon-dynasty
https://francescodisa.itch.io/je-suis-maranza
https://teo-tormo.itch.io/kodneogeo
https://warnodeinteractve.itch.io/battle-of-dots-the-last-stand
https://arlothemonk.itch.io/tales-of-nivea-grip
https://aucoustic5.itch.io/gajes-del-oficio
https://darkstorylab.itch.io/danganronpa-ultimate-liar
https://doxussssss.itch.io/moonlight-date-night
https://marusa00jp.itch.io/nukenin
https://spaicy-project.itch.io/spaicy-oneshootstar
https://yaonam.itch.io/gradient-descent
https://brittlstar.itch.io/sophont-first-cut
https://danielhkwan.itch.io/wanderingblades
https://cdoghusk.itch.io/star-wars-one-way-out
https://friendly-ghost.itch.io/hot-circle
https://jnohr.itch.io/mrk-borg-free
https://sevencrowsgames.itch.io/dark-ages
https://emanoelmelo.itch.io/cbrpnk-txt
https://caramelojogos.itch.io/flailbr
https://makapatag.itch.io/10000-swords-against-heaven
https://groov-games.itch.io/grimwild-community-edition
https://claymorerpgs.itch.io/starnet-playable-teaser
https://chains-of-gaelia.itch.io/chains-of-gaelia
https://austin-ramsay.itch.io/time-passes
https://thedevteam.itch.io/cleave-rpg
https://gilarpgs.itch.io/wyrm
https://lonearchivist.itch.io/grand-armor
https://shadowandfae.itch.io/felwoods
https://nerdypapergames.itch.io/sbb
https://ema-acosta.itch.io/crescentbx
https://maison-nebuleuse.itch.io/moon-borg
https://tania-herrero.itch.io/fomoria-quickstart
https://seasidesepulchre.itch.io/capes-in-the-dark
https://wonderxworlds.itch.io/wonder-worlds
https://willzo.itch.io/into-the-grasslands
https://caramelojogos.itch.io/mausritter
https://sulcata.itch.io/fathom
https://sevencrowsgames.itch.io/we-contain-solitudes
https://dngnclub.itch.io/instant-bullets
https://erinking.itch.io/patchwork-world-sixth-edition
https://pandiongames.itch.io/helene-of-the-blue-ridge
https://thepressbetwixt.itch.io/ambition
https://calpalcreates.itch.io/forged-in-the-sun
https://level2janitor.itch.io/tactiquest
https://robotfrancis.itch.io/emerald-haven
https://litzabronwyn.itch.io/dnd-but-shitty
https://stoicheincat.itch.io/ruin-runners
https://domergue.itch.io/witchy-woodland
https://rafaarruda.itch.io/cairn-pt-br
https://stopdroproll.itch.io/why-we-fight
https://sepulchralverdigris.itch.io/path-2-victory
https://royalrabbit.itch.io/summer-no-more
https://felipemuky.itch.io/a-patrulha-da-noite-verso-recruta
https://rookiejet.itch.io/empty-cycle-teaser
https://acegiak.itch.io/dungeonpunk
https://shadowandfae.itch.io/lost-fable-ee
https://comemartin.itch.io/green-dawn-mall
https://mkirin.itch.io/one-page-holiday
https://lari-assmuth.itch.io/the-service-playtest
https://alexandersheep.itch.io/quintaanoite
https://blindink.itch.io/dead-meat
https://symberzite.itch.io/blackacre
https://domergue.itch.io/wanna-play-right-now
https://bullypulpitgames.itch.io/ghosts
https://cairnpress.itch.io/cairn-players-guide
https://cairnpress.itch.io/cairn-wardens-guide
https://felixisaacs.itch.io/pico-hogwild-playtest-pre-gens
https://the-lorelock.itch.io/retrokill-preview
https://hed0rah.itch.io/kill-engn
https://blackfiskpub.itch.io/heroes-of-cerulea
https://possumcreekgames.itch.io/7-part-pact
https://farirpgs.itch.io/charge-rpg
https://rookiejet.itch.io/espers-quickstart
https://sabbotho.itch.io/minibosk
https://mega-corp.itch.io/the-company
https://gilarpgs.itch.io/thorn-seedling
https://dbb-8.itch.io/in-the-dark
https://sandypuggames.itch.io/hellpiercers-preview-edition
https://teethrpg.itch.io/false-kingdom
https://causacreations.itch.io/the-hidden-isle-playtest-version
https://miraclem.itch.io/elegy
https://willphillips.itch.io/hexingtide
https://losing-games.itch.io/mausritter
https://corespring.itch.io/corespringrpg
https://robinaite.itch.io/naiteborne
https://bassbuilt.itch.io/fast-fantasy-tabletop-rpg
https://nerosus.itch.io/mixedadventures
https://calenheydt.itch.io/dirge
https://katamoiran.itch.io/remix
https://prosaiko.itch.io/ghotic-punk
https://traversefantasy.itch.io/fmc
https://lostwaysclub.itch.io/the-museum-of-lost-things
https://prosaiko.itch.io/fluid-realities
https://traversefantasy.itch.io/cinco
https://farirpgs.itch.io/tales-of-the-burned-stones
https://causacreations.itch.io/magdeboerg
https://sdunnewold.itch.io/doskvol-breathes
https://springvillager.itch.io/last-tea-shop
https://alfredvalley.itch.io/excurse
https://loverdrive.itch.io/swords-under-the-sun
https://mkirin.itch.io/iron-valley
https://emielboven.itch.io/durf
https://gilarpgs.itch.io/light
https://hauntedtable.itch.io/triangle-agency-delta-test
https://chrispwolf.itch.io/offworlders
https://worldchampgameco.itch.io/soulburner
https://endurant.itch.io/where-theres-smoke
https://massif-press.itch.io/icon
https://runicagames.itch.io/the-gold-hack
https://mrdrhobo.itch.io/world-of-blades
https://lessthanthreegames.itch.io/one-missed-call
https://strangeworlder.itch.io/pros-and-cons
https://ednaarel.itch.io/342
https://wandeer.itch.io/angel-song
https://cineriarsis.itch.io/a-cherubs-lament
https://featherboy.itch.io/froggy-goes-boating
https://cattowngames.itch.io/out-of-the-bag
https://barbieronpa.itch.io/the-ex-orcism
https://lavendroid.itch.io/myfinaltrial
https://stanwixbuster.itch.io/shut-up
https://celechii.itch.io/cat-says-fuck
https://bmpmp3.itch.io/lineart-dressup
https://haraiva.itch.io/against-gratitude
https://sweetfish.itch.io/future
https://st-chem-atelier.itch.io/guardiangels
https://kiteline.itch.io/soup-rooms
https://bonitaka.itch.io/klostertrieka
https://bonitaka.itch.io/wildflowers
https://trickstersaint.itch.io/aromanticism
https://eyelette.itch.io/wickedaspect
https://officialelectric.itch.io/ruin
https://amptomp.itch.io/how-to-walk-out-the-door
https://alt-kreation.itch.io/dont-play-games
https://bulboka.itch.io/polynya
https://lilithzone.itch.io/symbol
https://harpsi.itch.io/archive-fever
https://akzidenz.itch.io/spies-with-very-little-intelligence
https://akzidenz.itch.io/is-the-kitten-small-or-is-the-kitten-far-away
https://cadnomori.itch.io/llwynog
https://dragonwasabipotato.itch.io/great-ordinary-life-of-a-small-community
https://dragonwasabipotato.itch.io/inventory
https://izzy-blobfish.itch.io/girl-factory
https://club-tartine.itch.io/the-duke
https://ednaarel.itch.io/semper-invicta
https://kmloveletter.itch.io/the-tower
https://mild-kimchi.itch.io/fishing3
https://chattercap.itch.io/my-husband-is-a-stranger
https://sweetfish.itch.io/delete
https://zorionbbq.itch.io/zenigatadate
https://ahmwma.itch.io/plant-metaphor
https://teletuu.itch.io/theworldofacreature
https://taumilicorice.itch.io/melancholic-star
https://vamichaelalaws.itch.io/an-actual-otome
https://senjagames.itch.io/galatea
https://sahil-bajaj.itch.io/meena
https://priro.itch.io/parfum-nostalgique
https://ns-dawn.itch.io/whats-the-tea-sis
https://lunaraydue.itch.io/sunshine-roses
https://maneki-mushi.itch.io/theherosjourney
https://no-xiruo.itch.io/zodiac-paradigm
https://jacobmoooore.itch.io/the-devils-folly
https://adebreg.itch.io/occator
https://tallywinkle.itch.io/garys-fortune-telling-tent
https://winkingcorvid.itch.io/love-limit
https://slitherbop.itch.io/paper-angel
2026-10-26 16:23:42 +00:00
github-actions[bot] 7855ab0017 Ingest queued games [2026-10-26] 2026-10-26 12:29:06 +00:00
freeitchgames-admin[bot] 03a018b059 Queue 79 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://elstoferino.itch.io/undertree-temple-of-the-elf-gods
https://angelccrpggames.itch.io/the-queens-gardens-and-the-kings-burrow
https://mister-kent.itch.io/the-underground-sun
https://maratae.itch.io/library-rats
https://ashvg.itch.io/the-flowers-of-perpetuity
https://owmyknees.itch.io/balthazars-legacy-cairn-2e
https://undead-mole.itch.io/uloxons-chimeric-menagerie
https://thebitbet.itch.io/bramblebaker-bathkeeper
https://kickmaniac.itch.io/trials-of-simal-baragach
https://erathke.itch.io/soul-sick-blues
https://dylanmaidana.itch.io/laberinto-de
https://seeonee.itch.io/pigs-in-a-blanket
https://loopquantumwyrm.itch.io/bargains-on-the-other-land
https://gingereno42.itch.io/rhizomes-floor-of-enchantment
https://maratae.itch.io/bloody-goblin-mines
https://tallertales.itch.io/the-meditation-chapel
https://moltewerf.itch.io/forrestorruin
https://2-gorblins-in-a-studio.itch.io/this-thorny-heart-beats-for-thee
https://epigramps.itch.io/glimmer-gloom-gloaming
https://mtcaval.itch.io/where-the-trails-rot
https://artb92.itch.io/the-tongues-of-vym
https://1pagedungeons.itch.io/pocket-size
https://erathke.itch.io/lost-in-the-mist
https://noseatbelts.itch.io/stories-from-hob-hill
https://gingereno42.itch.io/liminal-woods
https://seeonee.itch.io/tomb-of-the-sin-grinders
https://epigramps.itch.io/the-spiral-prison-of-the-lionmaiden
https://groakette.itch.io/the-fens-of-the-forest-mothers
https://everweird.itch.io/caverns-of-the-hidrida
https://the-common-dm.itch.io/wip-shutdown-the-gauntlet
https://estrandvold.itch.io/inner-sanctum-of-the-immortal-scorpion
https://patrick-buczek.itch.io/the-serpent-wore-silver
https://theomninerd.itch.io/march-of-the-eld-kin
https://waxwingedtraveler.itch.io/snatching-the-kirins-saddlebags
https://dododecahedron.itch.io/jikininki
https://hcharest.itch.io/the-otherworldly-obelisk
https://drew-makes-games.itch.io/rite-of-the-wriggling-gulf
https://indiana-joe.itch.io/the-golden-labyrinth
https://green-mirror.itch.io/hex-of-the-horned-one
https://glardyator.itch.io/loam-queens-decree
https://raspberrycat.itch.io/the-brilliant-bows-of-babylon
https://lonearchivist.itch.io/vanishing-vale
https://noble-gnoll.itch.io/the-byzantine-cataclysm
https://wormod.itch.io/misbegottenchildrenofizanami
https://silvernightingale.itch.io/while-amokye-is-away
https://jamie-douglas.itch.io/ink-stained-coffin
https://lemos.itch.io/lure-of-the-vulpine-voice
https://vastandtrunkless.itch.io/mercy-in-the-rams-hall
https://haughty-homunculus.itch.io/shadows-on-the-spiral-road
https://dannyfist.itch.io/calling-upon-the-bright-blizzard
https://third-country-press.itch.io/the-sunset-empire
https://jameswords.itch.io/on-the-back-of-the-burlywood-toad
https://magicalmonstar.itch.io/the-sludge-hungers
https://orkusporkus.itch.io/thecruciformbeacon
https://dibson.itch.io/the-caged-heart
https://offworldbogil.itch.io/rays-of-beleths-bolide
https://clearkeep.itch.io/vows-of-the-7-stricken-heads
https://kerisiankult.itch.io/stripes-stalks-among-the-swaying-fronds
https://inky-drafts.itch.io/no-loot-without-malice
https://aspinosaurusnamedsimone.itch.io/orobus-ordains-an-adventure-for-cairn
https://noseatbelts.itch.io/the-delicate-diamond
https://rootdevil.itch.io/the-ghouls-of-grondar
https://1pagedungeons.itch.io/the-silver-spires-of-shandu
https://giantrobottackler.itch.io/the-gravity-plague
https://loopquantumwyrm.itch.io/dread-down-below
https://yttikon.itch.io/caves-of-hither-and-yon
https://bymattkelly.itch.io/the-tyrian-traveller
https://dungeonofdelirium.itch.io/the-12th-night-of-thoth
https://vanishing-vault.itch.io/the-hollow-hymn
https://orthopraxy.itch.io/giants-in-the-sky
https://andrewwritegood.itch.io/locked-in-silver-shackles
https://karlyanders.itch.io/stormsong-of-the-crimson-vale
https://jeunemage.itch.io/haut-comme-3-kobs
https://joereilly.itch.io/saboteurs-of-solace
https://barse.itch.io/kith-kindling
https://seeonee.itch.io/the-hole-beneath-chateau-carna
https://maratae.itch.io/the-cave-of-the-orc-princess
https://undead-mole.itch.io/into-the-effigy-of-oriel
https://malachijs.itch.io/pale-horseman
2026-10-26 12:23:22 +00:00
github-actions[bot] 8529167062 Ingest queued games [2026-10-26] 2026-10-26 08:35:20 +00:00
freeitchgames-admin[bot] 396a23d3df Queue 162 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://akiravd.itch.io/greyline
https://brutifene.itch.io/overwrite
https://classywastaken.itch.io/noredflags
https://clemicle.itch.io/pencil-implement
https://haunterrise.itch.io/late-night-flight
https://kemonohenry.itch.io/paranoia
https://longcatstudios.itch.io/maiden-of-the-trench
https://ngo-hoang-man.itch.io/mother
https://nxt-maru.itch.io/miscount
https://sebastien-thon.itch.io/what-matters
https://ukigumosama.itch.io/prince-and-the-demon-maid
https://lambdaori.itch.io/reel-horror
https://gravy-press.itch.io/fu
https://monstersmustdie.itch.io/team-building-activities
https://einflys.itch.io/eins-universal-sci-fi-portrait-pack
https://teobius.itch.io/audio-files-for-gradient-descent-mothership-rpg
https://surgeryhead.itch.io/splicers-mosh
https://drgndrp.itch.io/panic-cards
https://shanevincent.itch.io/zimmco-refreshment-beverages
https://knurrkater.itch.io/the-apostles-of-the-burnt-augur
https://drakkarson.itch.io/ypsilon-14-foundry-vtt-semi-automated
https://astratherium.itch.io/the-still-of-touchstone-station
https://rpga.itch.io/rogue-bots
https://bbegstudios.itch.io/mothership-one-shot-trilogy
https://sambensim.itch.io/mothership-handouts
https://worldzero.itch.io/corporate-portfolio
https://shanevincent.itch.io/mothership-earwrm
https://joshua-kramer.itch.io/the-albatross-a-cosmic-cryptid-for-mothership-rpg
https://reallymiish.itch.io/ambrosia
https://cargoghostgames.itch.io/the-god-box
https://teobius.itch.io/gd-deepdive
https://voidinkpress.itch.io/year-of-the-rat-security-room-terminal
https://voidinkpress.itch.io/heatsignagure-free-inventory-system-guns
https://worldzero.itch.io/reclaimer-players-guide
https://joshua-kramer.itch.io/androids-unleashed
https://teobius.itch.io/equipment-sheet-for-mothership-rpg
https://doublemonk.itch.io/i-loot-the-teamster
https://magnum-galaxy-games.itch.io/preview-dying-hard-on-hardlight-station-ns-1365-anthology-edition
https://doublemonk.itch.io/dead-letters
https://shanevincent.itch.io/finger-on-the-trigger
https://smurphy-games.itch.io/haulers-handbook
https://cp1r8.itch.io/mothership-character-profile-sheet
https://nateybobs.itch.io/mothershipprototype
https://forest-oath.itch.io/violent-encounters-player-aids-for-mothership-rpg
https://smurphy-games.itch.io/hit-the-ground-running
https://fablesmonster.itch.io/lost-mark
https://voidinkpress.itch.io/another-bug-hunt-scenario-2-the-lab-controls-terminal
https://shogunrua.itch.io/act-android-creation-toolkit-for-use-with-mothership-1e
https://derdobs.itch.io/sci-fi-screen
https://bertholet.itch.io/vaarnish-cartographer
https://goblin-zone.itch.io/mothership-employment-contract-template
https://martiancrossbow.itch.io/silentstar
https://windblown-vagrant.itch.io/i-search-the-corridor
https://blackhartbartt.itch.io/abhdossier
https://peerfuture.itch.io/binary-contact
https://scoobygoober.itch.io/d100-new-trinkets
https://windblown-vagrant.itch.io/do-you-have-a-license-for-that
https://armandah.itch.io/grandmothershipbeta
https://ok-robot.itch.io/abyssexe
https://alexfarina.itch.io/calypso-beta
https://lonearchivist.itch.io/the-doom-of-verden-prime
https://communistcoke.itch.io/moon-pool
https://meatcastlegameware.itch.io/second-self
https://gordyh.itch.io/space-marine-art-pack
https://hiticalcrits.itch.io/chuck
https://worldzero.itch.io/reclaimer-a-mothership-module
https://crlbox.itch.io/periphery-4
https://istallri.itch.io/ypsilon-14-companion-images
https://elfenspalter.itch.io/w100-patches
https://chrisair.itch.io/raider-bounty-of-gilgamesh-vii
https://bammax.itch.io/converts-asunder
https://m-allen-hall.itch.io/auctoratus
https://austere-patio-games.itch.io/fear-cow
https://austere-patio-games.itch.io/alien-rpg-map-pack
https://lbonnette.itch.io/station-trappings
https://kesbeacon.itch.io/cyberpunk-corporation-gene
https://deptofunusual.itch.io/sector-grids
https://octopusink.itch.io/mothership-campaign-notebook-template-for-obsidian-md
https://meatcastlegameware.itch.io/meatcastle-annual-1
https://gm-lazarus.itch.io/ghost-ship-maps
https://benking.itch.io/the-stillroom
https://chrisair.itch.io/high-water
https://chrisair.itch.io/cendrillon-mercs
https://jbfh.itch.io/void-m4chine
https://the-lost-bay.itch.io/operations-hq
https://shanemichael.itch.io/high-moon
https://chrisair.itch.io/mitosis-escape-from-stars
https://chrisair.itch.io/5mw-rpg
https://chrisair.itch.io/great-crossing-heresies
https://raccomputing.itch.io/sunset-over-ithaca
https://octopusink.itch.io/anomalous-investigations
https://monovektor.itch.io/white-ichor
https://monovektor.itch.io/the-bone-parasite
https://mandalastudios.itch.io/ghostsintheblack
https://mandalastudios.itch.io/house-rules-management-class
https://mandalastudios.itch.io/house-rules
https://mandalastudios.itch.io/house-rules-nbc-wounds
https://mandalastudios.itch.io/house-rules-criminal-class
https://eniteris.itch.io/wumpus-hunt
https://poisonpress.itch.io/easy-work
https://500poundsofnothing.itch.io/rb12-moonlit-medicine
https://numbered-works.itch.io/sally-port-farm
https://500poundsofnothing.itch.io/rb9-under-that-black-sky
https://500poundsofnothing.itch.io/rb11-under-the-dunes
https://500poundsofnothing.itch.io/rb10-cold-opening
https://monovektor.itch.io/mothership-rpg
https://atpublishing.itch.io/sand
https://chrisair.itch.io/snag-evac
https://benking.itch.io/sidney-shipgraver
https://bigsmog.itch.io/mechs-in-the-city
https://yesterweird.itch.io/static-clearing
https://500poundsofnothing.itch.io/rb6-red-screen
https://orly1010.itch.io/guardian-angels
https://500poundsofnothing.itch.io/rb8-deep-space-marines
https://worldsbywatt.itch.io/cloudempress
https://chrisair.itch.io/burn-vermin
https://500poundsofnothing.itch.io/rb7-gear-for-a-spacefarer
https://500poundsofnothing.itch.io/rb5-exclusion-zone
https://poisonpress.itch.io/the-yellow-code
https://lonearchivist.itch.io/mosh-char-keeper
https://smurphy-games.itch.io/alone-in-the-deep
https://atsumo.itch.io/mother-lod
https://unchartedworlds.itch.io/neon-jungle
https://500poundsofnothing.itch.io/rb4-slaughter-on
https://meatcastlegameware.itch.io/venusian-opossum
https://500poundsofnothing.itch.io/rb3-for-queen-and-company
https://arkimedz.itch.io/starmap
https://500poundsofnothing.itch.io/rb2-disciples-of-a-cracked-skull
https://attack-cat-games.itch.io/space-st-station
https://natetreme.itch.io/object25
https://meatcastlegameware.itch.io/voidtouched
https://strangeworlder.itch.io/wreck-crawl
https://octopusink.itch.io/rimward-classes-for-mothership-rpg
https://gm-lazarus.itch.io/compact-character-sheet-for-mothership-rpg
https://500poundsofnothing.itch.io/rbt1-soul-seller
https://toddmoonbounce.itch.io/wardens-player-reference-for-mothershiprpg
https://500poundsofnothing.itch.io/carrion-protocol
https://necrocorvo.itch.io/mothership-google-sheets
https://catwargames.itch.io/the-keepers-chopshop
https://ng76.itch.io/nautilus-of-time
https://ialath.itch.io/bumpy-ride-at-bore-ix
https://millibeast.itch.io/immune-inception
https://500poundsofnothing.itch.io/the-beast-of-rs4
https://gm-lazarus.itch.io/compact-ship-sheet
https://worldsbywatt.itch.io/the-cabinet-of-rz
https://gm-lazarus.itch.io/azure-base-maps
https://delacannon.itch.io/derelict-ship-generator
https://likmsw.itch.io/sycamore-station
https://anodyne-printware.itch.io/within-wheels-model
https://mcfin.itch.io/fractal-station
https://mcfin.itch.io/crush-depth
https://awkwardturtle.itch.io/1-bit-mothership
https://mattumland.itch.io/cascading-failure
https://jbfh.itch.io/muttershiff
https://dismaster-frane.itch.io/mothership-online-character-sheet
https://lonearchivist.itch.io/relay-point-alpha
https://suikyun.itch.io/lazurith
https://unenthuser.itch.io/the-horror-of-station-xk-629
https://anodyne-printware.itch.io/from-nightmares
https://ashen-victor.itch.io/sci-fi-character-portraits-poject
https://skulldixon.itch.io/feynmans-mining-station
https://skulldixon.itch.io/theblackpyramid-maps
2026-10-26 08:23:37 +00:00
poli0981andClaude Opus 5.5 753709e9ab chore(deps): weekly updates, close build-tool advisories (4.4.3) (#164)
The updates of Dependabot #159-#163 plus lucide-react / Zustand; wrangler 4.152 with regenerated Worker types; overrides.undici ^7.30.1 (miniflare pin, GHSA-xjj6-f33q-929c) and zod 4.6.7; knip follows CSS imports; cargo update (tauri 2.12.5, tokio 1.54.1); certifi / coverage / Ruff; actions/setup-python 7.1.0; version 4.4.3.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-26 14:15:45 +07:00
github-actions[bot] ea4393da4c Ingest queued games [2026-10-26] 2026-10-26 04:23:56 +00:00
freeitchgames-admin[bot] fddb8c3cc5 Queue 4 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://koalapanda54.itch.io/flakeparty
https://muchamaker.itch.io/super-pancake-flip
https://themilitarysimularper.itch.io/ragdoll-sandbox
https://vegros101.itch.io/great-expanse-road-to-immortality
2026-10-26 04:23:22 +00:00
github-actions[bot] c26e4bd682 Refresh catalog [2026-10-26] 2026-10-26 03:37:36 +00:00
github-actions[bot] beb911c99b Ingest queued games [2026-10-26] 2026-10-26 00:25:13 +00:00
freeitchgames-admin[bot] 05b63c9d10 Queue 6 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://2gold.itch.io/find-me
https://haridraws.itch.io/the-murmuring-depths
https://jpde.itch.io/apex-sweeper
https://sora-lab.itch.io/dxsuzuki-handover-dx
https://spiritguide-games.itch.io/shadowstarter
https://vaalribbok.itch.io/end-of-the-world-is-nice
2026-10-26 00:23:17 +00:00
github-actions[bot] a00c8374bb Ingest queued games [2026-10-25] 2026-10-25 20:23:44 +00:00
freeitchgames-admin[bot] bed2c2a6c0 Queue 3 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://isobeye.itch.io/tamam-ulan-asker-kahretsin-2-mobile-port
https://nanstudiotw.itch.io/nobunaga-mobile
https://thornido.itch.io/tiny-bastion
2026-10-25 20:23:17 +00:00
github-actions[bot] 8eeeb4938c Ingest queued games [2026-10-25] 2026-10-25 16:24:00 +00:00
freeitchgames-admin[bot] 44d0109371 Queue 8 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://altsakana.itch.io/in-your-dream
https://cowboy-starshine.itch.io/knock-at-the-door
https://fshift.itch.io/branchy
https://goose-onion.itch.io/forma-clinic-growth-secrets
https://hiki-0009.itch.io/give-me-your-heart
https://humangarbage-01.itch.io/heaven-knows-your-name
https://redthreadstudio.itch.io/court-of-the-bull
https://xylem-sap.itch.io/capturezip
2026-10-25 16:23:17 +00:00
github-actions[bot] 37311e73a6 Ingest queued games [2026-10-25] 2026-10-25 12:23:42 +00:00
freeitchgames-admin[bot] 131e7fd963 Queue 2 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://tasogare-vore.itch.io/marunomi-supporter
https://thebaldporter.itch.io/336-9-v25-android-port
2026-10-25 12:23:17 +00:00
github-actions[bot] e602351f1c Ingest queued games [2026-10-25] 2026-10-25 08:24:01 +00:00
freeitchgames-admin[bot] 41fae13bcf Queue 8 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://cadmiumivy.itch.io/skys-door
https://darael-18.itch.io/lauras-secret-diary
https://glodory-studio.itch.io/late-night
https://l0rdluiz.itch.io/my-dear-cherry
https://midwestemorevival.itch.io/disappear-here
https://nekotorine.itch.io/kawafuku
https://philiaaa.itch.io/crisisstage
https://sphearicalking.itch.io/embering-everheart
2026-10-25 08:23:18 +00:00
github-actions[bot] 7b44602f3e Ingest queued games [2026-10-25] 2026-10-25 04:25:09 +00:00
freeitchgames-admin[bot] 7e75fb2921 Queue 23 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://altila.itch.io/scattered-flowers
https://cheesynerd27.itch.io/10-days-to-ithaka
https://danyifri.itch.io/the-trees-were-walking
https://demonward.itch.io/best-friends-for-dinner
https://draklord123.itch.io/watcher
https://gizmood.itch.io/project-love
https://igoraidiary.itch.io/monsoon
https://k-ramstack.itch.io/the-manor-and-the-sea
https://lenlen403.itch.io/enlils-enigma
https://monsaru.itch.io/encephalophage
https://rinuinui.itch.io/natsu-no-uchini-en
https://smol-kitten.itch.io/el-sereno
https://stubby-artist.itch.io/from-rose-to-thorn
https://threwen.itch.io/the-door
https://through-the-window.itch.io/the-ota-express
https://yetilongago.itch.io/long-time-listener
https://yukidaruman.itch.io/desk-no-31
https://bucket-full-games.itch.io/chair-champions
https://carachapadu.itch.io/double-dragon-zeebo-md
https://hirazi.itch.io/factory-go
https://levion.itch.io/chainedpath
https://lil999999.itch.io/sahi
https://nebudi.itch.io/ndd
2026-10-25 04:23:17 +00:00
github-actions[bot] 8d8e4ba24f Refresh catalog [2026-10-25] 2026-10-25 03:31:35 +00:00
github-actions[bot] afb02097b7 Ingest queued games [2026-10-24] 2026-10-24 20:23:56 +00:00
freeitchgames-admin[bot] 7f1fb112d5 Queue 5 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://bbgames-it.itch.io/indiana-jones-and-the-temple-of-doom-unofficial
https://drowsyrui.itch.io/rpg-in-another-world
https://purmalis.itch.io/system-intruder
https://raktsra.itch.io/1inasamkhyeya
https://shintoworks.itch.io/rei-tashitokimashita
2026-10-24 20:23:17 +00:00
github-actions[bot] c8f2fe17c1 Ingest queued games [2026-10-24] 2026-10-24 12:23:41 +00:00
freeitchgames-admin[bot] e5c74972e0 Queue 2 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://megugames.itch.io/powder-peak-tycoon
https://soytg.itch.io/shape-of-you-crossing
2026-10-24 12:23:17 +00:00
github-actions[bot] 0a931cd1be Ingest queued games [2026-10-24] 2026-10-24 08:23:48 +00:00
freeitchgames-admin[bot] f04bcc230c Queue 3 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://amygood.itch.io/the-cat-did-it
https://modernvintagegamer.itch.io/splatterhouse-aga
https://yellow44-bedibbstudios.itch.io/caventure
2026-10-24 08:23:18 +00:00
github-actions[bot] 0e97453096 Refresh catalog [2026-10-24] 2026-10-24 03:30:29 +00:00
dependabot[bot] 44e037b0eb chore(deps): Bump tauri in /webapp/src-tauri in the tauri-rs group (#158)
Bumps the tauri-rs group in /webapp/src-tauri with 1 update: [tauri](https://github.com/tauri-apps/tauri).


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

---
updated-dependencies:
- dependency-name: tauri
  dependency-version: 2.12.4
  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-24 07:43:26 +07:00
github-actions[bot] 3bfc5b883f Ingest queued games [2026-10-24] 2026-10-24 00:24:08 +00:00
freeitchgames-admin[bot] c9900b682a Queue 9 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://amy-sparkle.itch.io/a
https://chipibaka.itch.io/zigzag-dungeon
https://heart-of-unicornia.itch.io/halloween-2026
https://jep129.itch.io/ninety-days
https://lunabloomgames.itch.io/made-just-for-you
https://marikraigames.itch.io/most-v-nikuda
https://preciousthingtostole.itch.io/dojomaker
https://stirkexd.itch.io/halloween-vampire-hunt
https://tuurensaari-games.itch.io/tuurensaari-stories-1
2026-10-24 00:23:18 +00:00
github-actions[bot] 857f0a2941 Ingest queued games [2026-10-23] 2026-10-23 20:24:04 +00:00
freeitchgames-admin[bot] 1419cb687c Queue 8 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://b0nifacy.itch.io/reroll
https://ch3ckpo1nt.itch.io/monster-fight
https://dan1322.itch.io/sekedar-mengingatkan-visual-novel
https://hikkka.itch.io/ousama-game
https://irineesan.itch.io/let-down-your-hair
https://kayquin.itch.io/kuroshio
https://wanyuhsieh.itch.io/being-a-master-demon-slayer-in-ancient-times
https://yahikoashs.itch.io/taiwanese-oyster-omelette
2026-10-23 20:23:20 +00:00
github-actions[bot] 296f9467c6 Ingest queued games [2026-10-23] 2026-10-23 16:23:51 +00:00
freeitchgames-admin[bot] a80abe66a4 Queue 2 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://barribob.itch.io/golem-quest
https://ericrod.itch.io/pong
2026-10-23 16:23:20 +00:00
github-actions[bot] 421ac5568e Ingest queued games [2026-10-23] 2026-10-23 08:24:26 +00:00
freeitchgames-admin[bot] a1171eac0a Queue 9 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://elemony.itch.io/the-deviation-line
https://glitterandsaline.itch.io/out-of-touch
https://hectummy.itch.io/mise-en-place
https://jahemas.itch.io/hotshot
https://kazeneko.itch.io/0317
https://leiathecat1220.itch.io/tiny-black-legs
https://mothfox1.itch.io/butterfly
https://vavanessaz.itch.io/the-witch-and-the-swan
https://vempyy.itch.io/jungle-tag
2026-10-23 08:23:38 +00:00
github-actions[bot] 66846552fb Ingest queued games [2026-10-23] 2026-10-23 04:25:01 +00:00
freeitchgames-admin[bot] 378a053ebd Queue 15 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://dadddydarko.itch.io/the-wickerman-and-i
https://gnemying.itch.io/blooming-rues
https://komitsu.itch.io/a-living-thing
https://lampyr-interactive.itch.io/nocturne-academy
https://laurzzz.itch.io/automated-love-obsession
https://leekexe.itch.io/sound-of-what
https://miss-signal-guy.itch.io/waiting-for-the-bus
https://needy-aoi.itch.io/doki-doki-second-draft
https://o-yu.itch.io/simons-play-house
https://quingi.itch.io/anamnesis
https://thomas-tung.itch.io/day-five-v1
https://anttihaavikko.itch.io/carbineball
https://digital-mosaic-games.itch.io/living-scraps
https://funbanan.itch.io/abattlacus
https://krivosrun99990.itch.io/chickenwar
2026-10-23 04:23:56 +00:00
github-actions[bot] 519546d6f0 Refresh catalog [2026-10-23] 2026-10-23 03:33:14 +00:00
poli0981andClaude Opus 5.5 40b17e620d ci(sonar): analyse in GitHub Actions with test coverage (#157)
SonarQube Cloud analyses in GitHub Actions instead of Automatic
Analysis, with test coverage (sonarcloud.yml): token (skips Dependabot
and fork PRs, which get no SONAR_TOKEN) → coverage (pytest-cov and
Vitest v8, no secrets) → scan (sonarqube-scan-action v8.3.0, full
history, sonar.projectVersion from webapp/package.json).

sonar-project.properties replaces .sonarcloud.properties: tests marked
as tests, coverage exclusions for code without unit tests by design,
Python 3.14 (the analyzer has no 3.15 yet), binary images and the
SQLite migrations (claimed by the PL/SQL analyzer, which only warned)
left out.
Adds pytest-cov / coverage (dev lock recompiled on Python 3.14) and
@vitest/coverage-v8 (Dependabot group with vitest). Docs: CLAUDE.md
gotcha 41, THIRD_PARTY, dev_env, CONTRIBUTING (EN + VI).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-22 20:30:20 +07:00
github-actions[bot] 43663e4220 Ingest queued games [2026-10-22] 2026-10-22 12:23:57 +00:00
freeitchgames-admin[bot] c755d97048 Queue 1 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://piro775.itch.io/efp-fangame
2026-10-22 12:23:39 +00:00
poli0981andClaude Opus 5.5 999d0887ee Fix the SonarQube Cloud findings; release 4.4.2 (#155)
The first SonarQube Cloud scan reported 57 issues. 45 are fixed in code, the 11 on the saved itch.io test pages leave the scan via .sonarcloud.properties, and css:S8776 (Tailwind's @utility nesting) is a false positive to mark on SonarQube Cloud.

Worker: trailing slashes and the gate cookie's padding are trimmed by trimEnd() instead of /\/+$/ (quadratic on the public 404 path); the feed and collection parsers lose their backtracking regexes; compareCodeUnits keeps the code-unit sorts (the rule's localeCompare is locale-dependent); Number.*, DEFAULT_SIZES, crypto.randomUUID; i18n-edit.mjs reads stdin. Pipeline: the NSFW notices are one selector list, either class (the rule's ".a.b" would need both), each tested; plain if-guards; update_info.main returns None; no plain-http adapter; [[ ]] in cf_build_status.sh.

Supply chain: requirements*.txt are hash-locked pip-tools compiles of requirements*.in (on Python 3.14, which Dependabot reads from the header), installed with --require-hashes --only-binary :all: in block scalars; npm ci --ignore-scripts in CI and the release builds (verified by manual release runs on all platforms); npm run cf:check.

Release 4.4.2: also ships the toolchain upgrade (#149, #154) and Dependabot #141-#148, #150, #152, #153. CLAUDE.md gotchas 40 and 41.

[skip-discuss]

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-22 18:16:12 +07:00
github-actions[bot] 9a67bbc536 Ingest queued games [2026-10-22] 2026-10-22 08:23:58 +00:00
freeitchgames-admin[bot] 8ad93b7739 Queue 6 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://ajaxdoesshit.itch.io/attic-love
https://archiepvc.itch.io/death-of-a-party
https://augustine-ina.itch.io/comfort-and-warmth
https://cloud9games.itch.io/echo
https://exca.itch.io/tea-cup-dragon
https://mlazuli.itch.io/redecorar
2026-10-22 08:23:20 +00:00
github-actions[bot] 44abf558e3 Ingest queued games [2026-10-22] 2026-10-22 04:24:23 +00:00
freeitchgames-admin[bot] d126d100ee Queue 14 game(s) for ingest [auto]
By the admin page's automatic rules (auto-approve, watched collections).

https://auriaca.itch.io/nakphachonphrai-first-light
https://dreamtalegames.itch.io/aeronauts
https://lavris.itch.io/techromancy
https://narurinya.itch.io/phnxddd
https://oppai-games.itch.io/quickie-fantasy-adventure
https://oworlon.itch.io/femboy-apocalypse
https://raxeris.itch.io/just-a-sip
https://tand0c.itch.io/st-kilda-beach-in-winter
https://featurekreep.itch.io/choo-choo-mania
https://orderframe.itch.io/shrimply-genetics
https://saveslot0.itch.io/relicta-in-memoriam
https://sheepolution.itch.io/troll-the-king
https://strafkollektiv.itch.io/the-dreaming-keep
https://veltes.itch.io/von-neumann
2026-10-22 04:23:17 +00:00
github-actions[bot] f57f40c2f2 Refresh catalog [2026-10-22] 2026-10-22 03:31:21 +00:00
dependabot[bot] 590a662717 chore(deps-dev): Bump vitest from 5.0.3 to 5.0.5 in /webapp
Bumps [vitest](https://github.com/vitest-dev/vitest/tree/HEAD/packages/vitest) from 5.0.3 to 5.0.5.
- [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.5/packages/vitest)

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

Signed-off-by: dependabot[bot] <support@github.com>
2026-10-22 09:23:37 +07:00
dependabot[bot] 5c6866c891 chore(deps): Bump the tauri-rs group across 1 directory with 3 updates
Bumps the tauri-rs group with 3 updates in the /webapp/src-tauri directory: [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-plugin-opener` from 2.7.1 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.1...dialog-v2.7.2)

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

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

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

Signed-off-by: dependabot[bot] <support@github.com>
2026-10-22 09:12:11 +07:00
dependabot[bot] 3c4cdcd254 chore(deps): Bump lucide-react from 1.53.0 to 1.59.0 in /webapp
Bumps [lucide-react](https://github.com/lucide-icons/lucide/tree/HEAD/packages/lucide-react) from 1.53.0 to 1.59.0.
- [Release notes](https://github.com/lucide-icons/lucide/releases)
- [Commits](https://github.com/lucide-icons/lucide/commits/1.59.0/packages/lucide-react)

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

Signed-off-by: dependabot[bot] <support@github.com>
2026-10-22 09:00:18 +07:00
dependabot[bot] 24dc0e7bc2 chore(deps): Bump the tanstack group in /webapp with 3 updates
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.3 to 5.104.4
- [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.4/packages/react-query)

Updates `@tanstack/react-query-devtools` from 5.104.3 to 5.104.4
- [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.4/packages/react-query-devtools)

Updates `@tanstack/react-query-persist-client` from 5.104.3 to 5.104.4
- [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.4/packages/react-query-persist-client)

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

Signed-off-by: dependabot[bot] <support@github.com>
2026-10-22 08:59:39 +07:00
poli0981andClaude Opus 5.5 41ad57f229 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:57:03 +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
484 changed files with 241279 additions and 28190 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
+103
View File
@@ -0,0 +1,103 @@
name: ♿ Accessibility barrier
description: Something on the website or in the apps doesn't work with your keyboard, screen reader, zoom, contrast settings or other assistive technology
title: "[Accessibility] "
labels: ["accessibility"]
body:
- type: markdown
attributes:
value: |
Thank you for taking the time to report this. Every report helps, even a partial one — describe what happened in your own words, and skip whatever you'd rather not share. Please don't include health information.
Prefer email, or don't have a GitHub account? Write to **contact@poli0981.dev** (English or Vietnamese). What happens next, and the response targets, are in [ACCESSIBILITY.md](https://github.com/poli0981/free-games-itchio-list/blob/main/ACCESSIBILITY.md#7-reporting-an-accessibility-barrier).
**Found a security vulnerability?** Please don't file it here: report it privately (see SECURITY.md).
- 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
- Not sure
validations:
required: true
- type: input
id: page
attributes:
label: Page or screen
description: The address of the page, or the screen in the app.
placeholder: e.g. https://freeitchgames.win/charts, or "the Games list in the Android app"
- type: textarea
id: details
attributes:
label: What were you trying to do, and what happened?
description: What you expected, what happened instead, and the steps to get there if you can.
placeholder: |
e.g. I pressed Tab to reach the "Platform" filter, but focus jumped back to the top of the page.
validations:
required: true
- type: dropdown
id: kind
attributes:
label: What kind of barrier? (optional)
multiple: true
options:
- Keyboard (can't reach or use something, focus lost or hidden)
- Screen reader (missing or wrong name, nothing announced, wrong reading order)
- Zoom, text size or layout at large sizes
- Colour or contrast (including Windows contrast themes)
- Motion or animation
- Charts
- Language (read in the wrong language or voice)
- Speech input or switch access
- Something else
- type: dropdown
id: severity
attributes:
label: How much does it get in your way?
description: Just your best guess; it may change during triage.
options:
- Critical — I can't do a main task at all (find, open or read a game, change settings)
- Serious — I can, but only with great effort or a workaround
- Moderate — annoying or inconsistent, but I get there
- Minor — a small polish issue
validations:
required: true
- type: input
id: assistive-tech
attributes:
label: Assistive technology and version (if any)
placeholder: e.g. Windows Narrator, NVDA 2026.1, VoiceOver on iOS 26, TalkBack, keyboard only, Windows contrast theme
- type: input
id: environment
attributes:
label: Device, operating system, browser or app version
description: The app version is shown on the About page.
placeholder: e.g. Windows 11 + Edge 142; Android 15 + app 4.6.0
- type: textarea
id: media
attributes:
label: Screenshot or recording (optional)
description: Paste or drag files here. Please hide any personal information.
- type: checkboxes
id: conduct
attributes:
label: Code of Conduct
description: By submitting this issue you agree to follow the project's [Code of Conduct](https://github.com/poli0981/free-games-itchio-list/blob/main/CODE_OF_CONDUCT.md).
options:
- label: I agree to follow the Code of Conduct.
required: true
+23 -7
View File
@@ -1,12 +1,19 @@
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.
The game must be playable or downloadable **on its itch.io page itself** (a browser build or an uploaded file). A page that only points to a launcher or a download on another site doesn't qualify.
**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 +32,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 +48,17 @@ 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)
- label: Each page has its own browser build or download on itch.io (not only a link to another site)
- type: checkboxes
id: agreement
@@ -50,4 +66,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
+56 -17
View File
@@ -1,12 +1,49 @@
name: 🐛 Bug Report
description: Report a bug in the list, tables, scripts, or anything broken
name: 🛠️ Report a problem (wrong data, something broke)
description: Wrong or outdated game data, a dead link, or something that stopped working on the website or in the apps. Not for feature requests.
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.
**The project is in maintenance mode** (stable, no new features): this form is for wrong game data and for things that broke. Ideas and feature requests are closed without review.
**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.
Something doesn't work with your keyboard, screen reader, zoom or contrast settings? The "Accessibility barrier" template asks the right questions.
- 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 +51,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 +67,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 +75,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 +94,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
+14
View File
@@ -0,0 +1,14 @@
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.
- name: 💬 Questions, feedback, anything else
url: https://github.com/poli0981/free-games-itchio-list/discussions
about: Issues are for the catalog data only (add, fix or remove a game). Everything else goes to Discussions.
- name: 🧊 Feature requests are closed
url: https://github.com/poli0981/free-games-itchio-list#project-status
about: The project is stable and in maintenance mode — security fixes and dependency updates only. Feature requests and code pull requests are closed without review.
@@ -1,62 +0,0 @@
name: 💡 Feature Request / Improvement
description: Suggest a new feature or code improvement
title: "[Feature/Improvement] "
labels: ["enhancement"]
body:
- type: markdown
attributes:
value: |
Yo legend! My code is mediocre at best, so ideas are welcome. Grok helps, but you might have better ones :D
- type: checkboxes
id: type
attributes:
label: Type (choose one only)
options:
- label: New Feature
- label: Code Improvement
validations:
required: true
- type: input
id: title
attributes:
label: Feature/Improvement Name
description: Short title — what is it?
validations:
required: true
- type: textarea
id: reason
attributes:
label: Why? (e.g tables too slow, missing info, etc.)
description: Explain the problem it solves or why it's cool/good for the repo.
validations:
required: true
- type: checkboxes
id: priority
attributes:
label: How necessary? (choose one only)
options:
- label: Not urgent (nice to have)
- label: Maybe needed
- label: Very needed
- label: Extremely urgent (repo dying without it)
validations:
required: true
- type: textarea
id: code
attributes:
label: (Optional) Pseudo-code, snippet, or file idea
description: |
Share code ideas — I'll check (no malware pls, I'm paranoid and lazy :D). My skill is average, so keep it simple.
- type: checkboxes
id: agreement
attributes:
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
-36
View File
@@ -1,36 +0,0 @@
name: 💬 Feedback
description: General feedback about the repo/docs
title: "[Feedback] "
labels: ["feedback"]
body:
- type: markdown
attributes:
value: |
Roast me, praise me, or complain — I'm introvert but I'll read :D
- type: checkboxes
id: reasons
attributes:
label: What's the feedback about? (can check multiple)
options:
- label: EULA/ToS too strict/annoying
- label: Repo concept wrong/bad
- label: Anti-AI vibes (but Grok built half of it :v)
- label: Delete the repo pls
- label: Other (describe below)
- type: textarea
id: details
attributes:
label: Full feedback/details
description: Be honest — my self-loathing can handle it
validations:
required: true
- type: checkboxes
id: agreement
attributes:
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
-68
View File
@@ -1,68 +0,0 @@
name: 🤖 Game already submitted via Telegram bot
description: Tracking issue for games you submitted via @my_skull_bot
title: "[Bot] "
labels: ["contribution", "games", "via-telegram-bot"]
body:
- type: markdown
attributes:
value: |
Use this template **only after** the bot has acknowledged your submission
in Telegram. This issue is for tracking + so you get credited in
ACKNOWLEDGEMENTS.md.
New here? See [CONTRIBUTING §1b — Add games via Telegram bot](../blob/main/CONTRIBUTING.md#1b-add-games-via-telegram-bot-my_skull_bot--alternative-to-issues).
**Privacy reminder**: do **not** paste your Telegram numeric ID into
this issue. The numeric ID is private; the username (@SkullMute0011-style)
is fine if you want credit on it.
- type: input
id: telegram_username
attributes:
label: Telegram username (optional, for credit)
description: e.g. `@yourname`. Leave blank if you'd rather stay anonymous.
placeholder: "@yourname"
- type: input
id: bot_run_id
attributes:
label: Bot run ID or commit SHA
description: |
Either the GitHub Actions run ID the bot reported back to you in
Telegram, or the commit SHA `bot-ingest: run NNN`.
placeholder: "e.g. 25627763897 or 2b22b85"
validations:
required: true
- type: textarea
id: links
attributes:
label: itch.io URLs you submitted (one per line)
description: |
Same URLs you sent the bot. Helps cross-check that the scraper picked
them up correctly.
placeholder: |
https://example.itch.io/game1
https://example.itch.io/game2
validations:
required: true
- type: textarea
id: notes
attributes:
label: Anything weird with the run? (optional)
description: |
Bot timed out, scraper missed a field, duplicate already in catalog,
etc. If everything went smoothly leave this blank.
- type: checkboxes
id: agreement
attributes:
label: Agreement (required)
options:
- label: I confirm the bot acknowledged this submission in Telegram before I opened this issue.
required: true
- label: I did NOT paste my Telegram numeric ID into this issue.
required: true
- label: I agree to the [Terms of Use](../blob/main/docs/ToS.md) and [Privacy Policy](../blob/main/docs/PrivacyPolicy.md).
required: true
@@ -1,25 +0,0 @@
name: ❓ General / Off-Topic
description: Anything not fitting other templates
title: "[General] "
labels: ["question"]
body:
- type: markdown
attributes:
value: |
Not bug/feature/games/feedback? Drop it here. Memes welcome :D
- type: textarea
id: content
attributes:
label: What's on your mind?
description: Questions, random thoughts, or just saying hi
validations:
required: true
- type: checkboxes
id: agreement
attributes:
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
+57 -8
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"]
labels: ["delete-game"]
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
+10 -10
View File
@@ -1,20 +1,20 @@
**🎮 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
- [ ] Each page has its own browser build or download on itch.io (not only a link to another site)
- [ ] 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! 🚀
-25
View File
@@ -1,25 +0,0 @@
**🐛 Bug Fix**
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
- [ ] Scraping failure (itch.io changed HTML again)
- [ ] Generate MD tables broken (split/part wrong)
- [ ] GitHub Actions fail
- [ ] Other (describe below)
### Description
Explain the bug and how your fix works. Bonus points if you tested locally!
### Related Issues
Closes # (link issue number if any)
### Checklist
- [ ] Tested locally (run update_games.py + generate_md.py)
- [ ] No new bugs introduced (hopefully)
- [ ] Followed the vibe (chill, no drama)
Grok approved? (just kidding, but thanks legend!) 🚀
@@ -1,22 +0,0 @@
**📝 Documentation Update / Other**
Not code or games? Fix my bad English, typos, or update legal docs — still super helpful!
### What did you update?
- [ ] Fix typo/grammar in README/docs
- [ ] Update DISCLAIMER/PRIVACY/TERMS/etc.
- [ ] Improve MY_STUFF or ACKNOWLEDGEMENTS
- [ ] Add badges/screenshots
- [ ] Other small polish
### Description
Explain changes and why.
### Related Issues
References # (if any)
### Checklist
- [ ] No breaking changes
- [ ] Keeps the self-deprecating vibe :D
Even small fixes make this repo look less noob — thanks bro! 🚀
@@ -1,24 +0,0 @@
**💡 New Feature / Code Improvement**
Yo legend! My code is "kinda works" level, so any upgrade is huge. Grok helps me, but real humans are better :D
### 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)
- [ ] Refactor my messy code
- [ ] Other (describe)
### Description
Explain what it does and why it's cool. Include code snippets if needed.
### Related Issues
References # (link if any)
### Checklist
- [ ] Tested locally
- [ ] Doesn't break daily update
- [ ] Keeps the noob vibe intact
If this makes the repo less mediocre — you're the MVP. 🚀
+87
View File
@@ -0,0 +1,87 @@
# Dependabot version updates. Security updates are a separate switch in
# Settings → Code security (when on, 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/*']
# @vitest/coverage-v8 requires the exact vitest version (peer dependency).
vitest:
patterns: ['vitest', '@vitest/*']
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']
+31
View File
@@ -0,0 +1,31 @@
<!--
The project is in maintenance mode (stable, no new features — see README → Project status).
Pull requests from contributors are accepted for ONE thing: adding itch.io URLs to
scripts/temp_link.json. For that, add ?template=add_games.md to this page's address.
Code, UI and docs pull requests are closed without review; a game's data is fixed or removed
through an issue or email (CONTRIBUTING.md). This template is the Maintainer's own checklist.
-->
### What and why
What does this change, and why?
### Related issues
Closes # (if any)
### Checklist
- [ ] Tested locally — Python: `pytest`, `ruff check scripts tests webapp/scripts`; webapp: `npm test`, `npm run lint`, `npm run knip`, `npx tsc -b`
- [ ] No secrets, tokens or personal data in the diff
- [ ] New UI text is in both `webapp/src/lib/i18n/en.ts` and `vi.ts`; a changed English doc has its Vietnamese mirror updated (or I said so above)
- [ ] I agree my contribution is licensed like the part it changes: MIT for code, CC BY 4.0 for data and docs
### Accessibility (UI or docs changes — see [ACCESSIBILITY.md](https://github.com/poli0981/free-games-itchio-list/blob/main/ACCESSIBILITY.md#8-for-contributors))
- [ ] N/A — no UI or docs change
- [ ] Works with the keyboard alone: everything reachable, focus visible and never lost
- [ ] Every control has a name; nothing relies on colour alone; `npm test` (contrast check) passes
- [ ] Respects reduced motion; no new auto-playing motion
- [ ] Checked once with a screen reader (Narrator, NVDA, VoiceOver or TalkBack)
- [ ] Docs: headings in order, descriptive link text, alt text for images
+1
View File
@@ -0,0 +1 @@
3.15
+29 -19
View File
@@ -2,9 +2,9 @@ name: Announce to Discussion
# Two triggers, two destinations:
# 1. release:published → Announcements category
# 2. push (paths: docs/**, CHANGELOG.md, README.md, README.vi.md) → General
# The push job is gated by a `[skip-discuss]` token in the head-commit message
# so dev can opt out for typo-only commits.
# 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").
@@ -16,10 +16,8 @@ on:
push:
branches: [main]
paths:
- 'docs/**'
- 'CHANGELOG.md'
- 'README.md'
- 'README.vi.md'
- 'changelog/**'
workflow_dispatch:
inputs:
mode:
@@ -33,9 +31,7 @@ on:
type: string
required: false
permissions:
contents: read
discussions: write
permissions: {}
concurrency:
group: announce-discussion-${{ github.ref }}
@@ -48,6 +44,9 @@ jobs:
(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:
@@ -104,22 +103,28 @@ jobs:
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="${{ steps.ids.outputs.repo_id }}" \
-f c="${{ steps.ids.outputs.category_id }}" \
-f t="${{ steps.rel.outputs.title }}" \
-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]') &&
!startsWith(github.event.head_commit.message, 'bot-ingest:')
!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:
@@ -150,15 +155,16 @@ jobs:
echo "category_id=$CAT_ID" >> "$GITHUB_OUTPUT"
- name: Checkout (last 2 commits for diff)
uses: actions/checkout@v6
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 -- docs/ CHANGELOG.md README.md README.vi.md > changed.txt || true
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
@@ -185,11 +191,15 @@ jobs:
- 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="${{ steps.ids.outputs.repo_id }}" \
-f c="${{ steps.ids.outputs.category_id }}" \
-f t="${{ steps.body.outputs.title }}" \
-f r="$REPO_ID" \
-f c="$CATEGORY_ID" \
-f t="$TITLE" \
-F b=@body.md
+13 -6
View File
@@ -10,14 +10,21 @@ on:
required: true
type: string
# Reusable announce-release.yml only needs `contents: read` to fetch
# release metadata via the gh CLI.
permissions:
contents: read
permissions: {}
jobs:
announce:
uses: poli0981/.github/.github/workflows/announce-release.yml@main
# 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: inherit
secrets:
DISCORD_RELEASES_WEBHOOK: ${{ secrets.DISCORD_RELEASES_WEBHOOK }}
DISCORD_REPO_WEBHOOK: ${{ secrets.DISCORD_REPO_WEBHOOK }}
DISCORD_PING_ROLE_ID: ${{ secrets.DISCORD_PING_ROLE_ID }}
-202
View File
@@ -1,202 +0,0 @@
# Place this file at .github/workflows/bot-ingest.yml in the itchio-f2p-tracker repo.
#
# Triggered by telegram-scraper-bot via workflow_dispatch.
# Required repository secret:
# - TELEGRAM_BOT_TOKEN (same token the bot uses)
#
# Differences from Steam version:
# • temp_link.json is a JSON array, not JSONL → parse + extend + write
# • Entry script is update_info.py, not ingest_new.py
# • Output dirs are data_game/ and scripts/deleted_games.json (not data/ and removed_games.jsonl)
name : Bot Ingest
on :
workflow_dispatch :
inputs :
links :
description : "Newline-separated itch.io URLs"
required : true
chat_id :
description : "Telegram chat ID for callback"
required : true
message_id :
description : "Telegram message ID to edit"
required : true
permissions :
contents : write
# Queue concurrent dispatches to prevent commit conflicts on data_game/ shards.
concurrency :
group : bot-ingest
cancel-in-progress : false
jobs :
ingest :
runs-on : ubuntu-latest
timeout-minutes : 30
steps :
-
uses : actions/checkout@v6
-
uses : actions/setup-python@v6
with :
python-version : "3.12"
-
name : Install deps
run : pip install --quiet beautifulsoup4 requests
-
name : Append links to temp_link.json (JSON array)
env :
LINKS : ${{ inputs.links }}
run : |
python <<'PY'
import json, os, pathlib
path = pathlib.Path("scripts/temp_link.json")
path.parent.mkdir(parents=True, exist_ok=True)
# Load existing array (or start fresh)
existing = []
if path.exists():
try:
loaded = json.loads(path.read_text(encoding="utf-8"))
if isinstance(loaded, list):
existing = loaded
except json.JSONDecodeError:
print("⚠ temp_link.json was malformed, resetting to []")
# Append new links (dedupe within this batch only — update_info.py
# also dedupes against the full data_game/ index)
before = len(existing)
seen = set(existing)
for line in os.environ["LINKS"].splitlines():
line = line.strip()
if line and line not in seen:
existing.append(line)
seen.add(line)
path.write_text(
json.dumps(existing, ensure_ascii=False, indent=4) + "\n",
encoding="utf-8",
)
print(f"temp_link.json: {before} → {len(existing)} entries (+{len(existing) - before})")
PY
-
name : Run update_info.py
id : ingest
run : |
set -o pipefail
python scripts/update_info.py 2>&1 | tee /tmp/ingest.log
# Capture the final summary line. update_info.py prints:
# "Done — N added, N paid (skipped), N duplicates, N failed, N total."
summary=$(grep -E "^Done —" /tmp/ingest.log | tail -n 1 || true)
if [ -z "$summary" ]; then
summary="(no summary line found in output)"
fi
{
echo "summary<<EOF"
echo "$summary"
echo "EOF"
} >> "$GITHUB_OUTPUT"
-
name : Commit changes
id : commit
run : |
git config user.name "github-actions[bot]"
git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
git add data_game/ scripts/temp_link.json scripts/deleted_games.json 2>/dev/null || true
if git diff --staged --quiet; then
echo "committed=false" >> "$GITHUB_OUTPUT"
echo "No changes to commit."
else
git commit -m "bot-ingest: run ${{ github.run_id }}"
git push
echo "committed=true" >> "$GITHUB_OUTPUT"
fi
-
name : Notify Telegram (success)
if : success()
env :
BOT_TOKEN : ${{ secrets.TELEGRAM_BOT_TOKEN }}
CHAT_ID : ${{ inputs.chat_id }}
MSG_ID : ${{ inputs.message_id }}
SUMMARY : ${{ steps.ingest.outputs.summary }}
COMMITTED : ${{ steps.commit.outputs.committed }}
RUN_URL : ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
run : |
python <<'PY'
import os, urllib.request, urllib.parse
summary = os.environ.get("SUMMARY", "(no summary)")
committed = os.environ.get("COMMITTED", "false") == "true"
run_url = os.environ["RUN_URL"]
status = "✅" if committed else "ℹ️"
commit_line = "Committed to repo." if committed else "No changes (all duplicates / paid / failed)."
text = (
f"{status} *itch ingest done*\n\n"
f"```\n{summary}\n```\n"
f"{commit_line}\n\n"
f"[View workflow run]({run_url})"
)
payload = urllib.parse.urlencode({
"chat_id": os.environ["CHAT_ID"],
"message_id": os.environ["MSG_ID"],
"parse_mode": "Markdown",
"text": text,
}).encode()
url = f"https://api.telegram.org/bot{os.environ['BOT_TOKEN']}/editMessageText"
req = urllib.request.Request(url, data=payload)
try:
with urllib.request.urlopen(req, timeout=30) as resp:
print(f"Telegram callback: HTTP {resp.status}")
except Exception as e:
print(f"Telegram callback failed: {e}")
PY
-
name : Notify Telegram (failure)
if : failure()
env :
BOT_TOKEN : ${{ secrets.TELEGRAM_BOT_TOKEN }}
CHAT_ID : ${{ inputs.chat_id }}
MSG_ID : ${{ inputs.message_id }}
RUN_URL : ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
run : |
python <<'PY'
import os, urllib.request, urllib.parse
text = (
"❌ *itch ingest failed*\n\n"
f"[View workflow run]({os.environ['RUN_URL']})"
)
payload = urllib.parse.urlencode({
"chat_id": os.environ["CHAT_ID"],
"message_id": os.environ["MSG_ID"],
"parse_mode": "Markdown",
"text": text,
}).encode()
url = f"https://api.telegram.org/bot{os.environ['BOT_TOKEN']}/editMessageText"
req = urllib.request.Request(url, data=payload)
try:
with urllib.request.urlopen(req, timeout=30) as resp:
print(f"Telegram callback: HTTP {resp.status}")
except Exception as e:
print(f"Telegram callback failed: {e}")
PY
-29
View File
@@ -1,29 +0,0 @@
name: Check dead game links
on:
schedule:
- cron: '0 7 */2 * *' # Every 2 days at 07:00 UTC (3h after check_paid)
workflow_dispatch:
permissions:
contents: write
jobs:
check-alive:
runs-on: ubuntu-latest
timeout-minutes: 120
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: Check for dead links
run: |
chmod +x ./bash/check_alive.sh
./bash/check_alive.sh
shell: bash
-29
View File
@@ -1,29 +0,0 @@
name: Check paid games
on:
schedule:
- cron: '0 4 */2 * *' # Every 2 days at 04:00 UTC
workflow_dispatch:
permissions:
contents: write
jobs:
check-paid:
runs-on: ubuntu-latest
timeout-minutes: 180 # May take long for large lists
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: Check for paid games
run: |
chmod +x ./bash/check_paid.sh
./bash/check_paid.sh
shell: bash
+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 }}
-60
View File
@@ -1,60 +0,0 @@
name: Deploy webapp to GitHub Pages
on:
push:
branches: [main]
paths:
- 'webapp/**'
- '.github/workflows/deploy_webapp.yml'
workflow_dispatch:
permissions:
contents: read
pages: write
id-token: write
concurrency:
group: pages
cancel-in-progress: false
jobs:
build:
runs-on: ubuntu-latest
timeout-minutes: 10
steps:
- name: Checkout repository
uses: actions/checkout@v6
- name: Set up Node.js
uses: actions/setup-node@v6
with:
node-version: 22
cache: npm
cache-dependency-path: webapp/package-lock.json
- name: Install dependencies
working-directory: webapp
run: npm ci
- name: Build webapp
working-directory: webapp
run: npm run build
- name: Configure GitHub Pages
uses: actions/configure-pages@v6
- name: Upload Pages artifact
uses: actions/upload-pages-artifact@v4
with:
path: docs/app
deploy:
needs: build
runs-on: ubuntu-latest
environment:
name: github-pages
url: ${{ steps.deployment.outputs.page_url }}
steps:
- name: Deploy to GitHub Pages
id: deployment
uses: actions/deploy-pages@v5
+36 -20
View File
@@ -1,34 +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 = re-scrape ALL games)'
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:
contents: write
permissions: {}
jobs:
force-update:
queue:
runs-on: ubuntu-latest
timeout-minutes: 180
timeout-minutes: 5
permissions:
actions: write # dispatch refresh.yml (a workflow_dispatch from GITHUB_TOKEN does start a run)
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: Force re-scrape (preserve safe_virus / notes / nsfw)
- name: Queue a full refresh
env:
INPUT_URL: ${{ inputs.url }}
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: |
chmod +x ./bash/force_update.sh
./bash/force_update.sh
shell: bash
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"
-38
View File
@@ -1,38 +0,0 @@
name: Generate Table of Game
on:
workflow_run:
workflows:
- 'Update JSON file game information'
- 'Check paid games'
- 'Check dead game links'
- 'Update reviews'
- 'Update status'
- 'Force update'
types: [completed]
workflow_dispatch:
permissions:
contents: write
jobs:
generate:
if: >-
github.event_name == 'workflow_dispatch' ||
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: Generate markdown tables
run: |
chmod +x ./bash/table.sh
./bash/table.sh
shell: bash
-34
View File
@@ -1,34 +0,0 @@
name: Export deleted games log
on:
workflow_run:
workflows:
- 'Check paid games'
- 'Check dead game links'
types: [completed]
workflow_dispatch:
permissions:
contents: write
jobs:
log-deleted:
if: >-
github.event_name == 'workflow_dispatch' ||
github.event.workflow_run.conclusion == 'success'
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: Export deleted games log
run: |
chmod +x ./bash/log_deleted.sh
./bash/log_deleted.sh
shell: bash
-27
View File
@@ -1,27 +0,0 @@
name: Notify CI Failures
on:
workflow_run:
# Listen only to data-pipeline workflows. Deploy/release/scanner notifications
# have their own dedicated wrappers (notify-deploy, notify-release-pipeline,
# plus CodeQL/Dependabot upstream defaults). Listing them explicitly avoids
# the "skip storm" of no-op runs that `workflows: ["*"]` produces.
workflows:
- "Update JSON file game information"
- "Generate Table of Game"
- "Check dead game links"
- "Check paid games"
- "Export deleted games log"
- "Bot Ingest"
types: [completed]
# REQUIRED: declare permissions matching the reusable workflow's needs.
# Reusable needs `actions: read` to inspect workflow_run details.
permissions:
contents: read
actions: read
jobs:
notify:
uses: poli0981/.github/.github/workflows/notify-ci-failure.yml@main
secrets: inherit
-16
View File
@@ -1,16 +0,0 @@
name: Notify Deploy Status
on:
workflow_run:
workflows:
- "Deploy webapp to GitHub Pages"
types: [completed]
permissions:
contents: read
actions: read
jobs:
notify:
uses: poli0981/.github/.github/workflows/notify-deploy.yml@main
secrets: inherit
+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"
+15 -6
View File
@@ -1,17 +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:
workflow_run: # zizmor: ignore[dangerous-triggers]
workflows:
- "Release desktop installers (Tauri)"
- "Release Android APK (Tauri)"
- "Announce Release to Discord"
types: [completed]
permissions:
contents: read
actions: read
permissions: {}
jobs:
notify:
uses: poli0981/.github/.github/workflows/notify-release-pipeline.yml@main
secrets: inherit
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 }}
+76
View File
@@ -0,0 +1,76 @@
# 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'
- 'requirements*.in'
- 'pyproject.toml'
- '.github/python-version'
- '.github/workflows/python-ci.yml'
push:
branches: [main]
paths:
- 'scripts/**'
- 'tests/**'
- 'data_game/**'
- 'requirements*.txt'
- 'requirements*.in'
- '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@6d4fd22b20465ccc0f7354476588e8df7c9ca0e0 # v7.1.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.txt
requirements-dev.txt
# Both hash-locked files at once: pip fails if their pins disagree.
# Wheels only, so no package runs a build script here.
- name: Install dependencies
run: |
pip install --require-hashes --only-binary :all: -r requirements.txt -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
+195
View File
@@ -0,0 +1,195 @@
# Qodana (JetBrains) static analysis, one linter per Qodana Cloud project:
#
# typescript — qodana-js webapp/ https://qodana.cloud/projects/wwgZ1
# python — qodana-python the repository root https://qodana.cloud/projects/GgGnX
# rust — qodana-rust webapp/src-tauri/ https://qodana.cloud/projects/P2Rd7
#
# Each project has its own token (a repository secret) and its own settings
# file (`qodana.yaml` in the directory above). Every run analyses the whole
# project (`pr-mode: false`), so a pull request and `main` report the same way.
#
# Dependabot and fork PRs get no repository secrets: the analysis is skipped
# there, not failed (the `tokens` job). Dependencies are installed before the
# scan, in steps that don't see the token.
name: Qodana
on:
push:
branches: [main]
# Data commits (the pipeline's, the admin Worker's) and docs change no code.
paths-ignore:
- 'data_game/**'
- 'scripts/temp_link.json'
- 'scripts/deleted_games.json'
- 'scripts/state/**'
- '**.md'
pull_request:
paths-ignore:
- 'data_game/**'
- 'scripts/temp_link.json'
- 'scripts/deleted_games.json'
- 'scripts/state/**'
- '**.md'
workflow_dispatch:
permissions: {}
concurrency:
group: qodana-${{ github.ref }}
cancel-in-progress: true
jobs:
tokens:
runs-on: ubuntu-latest
timeout-minutes: 5
permissions: {}
outputs:
present: ${{ steps.check.outputs.present }}
steps:
- name: Check for the Qodana tokens
id: check
env:
TOKEN_TS_JS: ${{ secrets.QODANA_TOKEN_TS_JS }}
TOKEN_PYTHON: ${{ secrets.QODANA_TOKEN_PYTHON }}
TOKEN_RUST: ${{ secrets.QODANA_TOKEN_RUST }}
run: |
if [ -n "$TOKEN_TS_JS" ] && [ -n "$TOKEN_PYTHON" ] && [ -n "$TOKEN_RUST" ]; then
echo "present=true" >> "$GITHUB_OUTPUT"
else
echo "::notice::No Qodana tokens in this run (Dependabot or fork PR): Qodana analysis skipped."
fi
typescript:
name: TypeScript / JavaScript
needs: tokens
if: needs.tokens.outputs.present == 'true'
runs-on: ubuntu-latest
timeout-minutes: 30
permissions:
contents: read
checks: write # the action's annotations
steps:
- name: Checkout repository
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
with:
ref: ${{ github.event.pull_request.head.sha || github.sha }}
fetch-depth: 0
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
# The linter resolves imports and types from node_modules.
- name: Install npm dependencies
working-directory: webapp
run: npm ci --ignore-scripts
- name: Qodana scan
uses: JetBrains/qodana-action@3e8d76ff0e0241618abd808682f426afe84bab3f # v2026.2.2
with:
args: --project-dir webapp --repository-root . --linter qodana-js --within-docker false
pr-mode: false
post-pr-comment: false
upload-result: true
artifact-name: qodana-report-typescript
primary-cache-key: qodana-2026.2-js-${{ github.ref }}-${{ github.sha }}
additional-cache-key: qodana-2026.2-js-${{ github.ref }}
cache-default-branch-only: true
env:
QODANA_TOKEN: ${{ secrets.QODANA_TOKEN_TS_JS }}
python:
name: Python
needs: tokens
if: needs.tokens.outputs.present == 'true'
runs-on: ubuntu-latest
timeout-minutes: 30
permissions:
contents: read
checks: write
steps:
- name: Checkout repository
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
with:
ref: ${{ github.event.pull_request.head.sha || github.sha }}
fetch-depth: 0
persist-credentials: false
- name: Set up Python
uses: actions/setup-python@6d4fd22b20465ccc0f7354476588e8df7c9ca0e0 # v7.1.0
with:
python-version-file: .github/python-version
cache: pip
cache-dependency-path: |
requirements.txt
requirements-dev.txt
# Hash-locked, wheels only (CLAUDE.md, gotcha 40). In native mode the
# linter finds no interpreter by itself: it gets this virtual environment
# (QODANA_PYTHON_PATH below) and resolves imports from it.
- name: Install Python dependencies
run: |
python -m venv .venv
.venv/bin/pip install --require-hashes --only-binary :all: -r requirements.txt -r requirements-dev.txt
- name: Qodana scan
uses: JetBrains/qodana-action@3e8d76ff0e0241618abd808682f426afe84bab3f # v2026.2.2
with:
args: --linter qodana-python --within-docker false
pr-mode: false
post-pr-comment: false
upload-result: true
artifact-name: qodana-report-python
primary-cache-key: qodana-2026.2-python-${{ github.ref }}-${{ github.sha }}
additional-cache-key: qodana-2026.2-python-${{ github.ref }}
cache-default-branch-only: true
env:
QODANA_TOKEN: ${{ secrets.QODANA_TOKEN_PYTHON }}
QODANA_PYTHON_PATH: ${{ github.workspace }}/.venv/bin/python
rust:
name: Rust
needs: tokens
if: needs.tokens.outputs.present == 'true'
runs-on: ubuntu-latest
timeout-minutes: 45
permissions:
contents: read
checks: write
steps:
- name: Checkout repository
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
with:
ref: ${{ github.event.pull_request.head.sha || github.sha }}
fetch-depth: 0
persist-credentials: false
# tauri::generate_context!() refuses to expand without the frontend
# directory (frontendDist): an empty page stands in for the web build.
- name: Stand-in for the web build
run: |
mkdir -p webapp/dist
echo '<!doctype html><title>stand-in</title>' > webapp/dist/index.html
# qodana-rust ships only as a Docker image (Early Access). It runs as
# root so that its bootstrap (webapp/src-tauri/qodana.yaml) can install
# the C toolchain and the libraries Tauri links against; the crates go
# to the (cached) Qodana cache directory. `cargo check` runs the build
# scripts of the locked dependencies in that container.
- name: Qodana scan
uses: JetBrains/qodana-action@3e8d76ff0e0241618abd808682f426afe84bab3f # v2026.2.2
with:
args: --project-dir webapp/src-tauri --repository-root . --linter qodana-rust -u root -e CARGO_HOME=/data/cache/cargo
pr-mode: false
post-pr-comment: false
upload-result: true
artifact-name: qodana-report-rust
primary-cache-key: qodana-2026.2-rust-${{ github.ref }}-${{ github.sha }}
additional-cache-key: qodana-2026.2-rust-${{ github.ref }}
cache-default-branch-only: true
env:
QODANA_TOKEN: ${{ secrets.QODANA_TOKEN_RUST }}
+163
View File
@@ -0,0 +1,163 @@
# 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@6d4fd22b20465ccc0f7354476588e8df7c9ca0e0 # v7.1.0
with:
python-version-file: .github/python-version
cache: pip
cache-dependency-path: requirements.txt
- name: Install dependencies
run: |
pip install --require-hashes --only-binary :all: -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@6d4fd22b20465ccc0f7354476588e8df7c9ca0e0 # v7.1.0
with:
python-version-file: .github/python-version
cache: pip
cache-dependency-path: requirements.txt
- name: Install dependencies
run: |
pip install --require-hashes --only-binary :all: -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@77dd5b2ce225ea11469928ac317850245a74ae78 # v6.2.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 --ignore-scripts
- 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
+80 -27
View File
@@ -1,14 +1,63 @@
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:
build-tauri:
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:
@@ -26,6 +75,8 @@ jobs:
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: ''
@@ -38,25 +89,24 @@ jobs:
runs-on: ${{ matrix.platform }}
steps:
- name: Checkout repository
uses: actions/checkout@v6
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
with:
persist-credentials: false
- name: Set up Node.js
uses: actions/setup-node@v6
uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7.1.0
with:
node-version: 22
cache: npm
cache-dependency-path: webapp/package-lock.json
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@stable
uses: dtolnay/rust-toolchain@683b588c487a69d01f6c6ddf40f036ff682cc2c8 # master
with:
toolchain: stable
targets: ${{ matrix.tauri_target }}
- name: Cache cargo
uses: Swatinem/rust-cache@v2
with:
workspaces: webapp/src-tauri
- name: Install Linux deps
if: matrix.platform == 'ubuntu-22.04'
run: |
@@ -71,18 +121,16 @@ jobs:
- name: Install npm deps
working-directory: webapp
run: npm ci
run: npm ci --ignore-scripts
- name: Build Tauri app
uses: tauri-apps/tauri-action@v0
uses: tauri-apps/tauri-action@1deb371b0cd8bd54025b384f1cd735e725c4060f # action-v1.0.0
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
with:
projectPath: webapp
tagName: ${{ github.ref_name }}
releaseName: 'Itch.io Free Games DB ${{ github.ref_name }}'
releaseDraft: true
prerelease: false
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
@@ -90,13 +138,18 @@ jobs:
# 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: always() && startsWith(matrix.platform, 'macos') && startsWith(github.ref, 'refs/tags/')
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
BUNDLE_DIR="webapp/src-tauri/target/${{ matrix.tauri_target }}/release/bundle/macos"
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
@@ -107,16 +160,16 @@ jobs:
echo "::warning::No .app bundle found — skipping pkgbuild."
exit 0
fi
VERSION=$(node -p "require('${{ github.workspace }}/webapp/src-tauri/tauri.conf.json').version")
PKG_NAME="$(basename "$APP" .app)_${VERSION}_${{ matrix.arch_label }}.pkg"
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 com.poli0981.free-games-itchio-webapp \
--identifier "$IDENTIFIER" \
--version "$VERSION" \
--install-location /Applications \
"$PKG_NAME"
ls -la "$PKG_NAME"
# Make sure the (draft) release exists so upload doesn't 404.
gh release view "${{ github.ref_name }}" --repo "${{ github.repository }}" >/dev/null 2>&1 \
|| gh release create "${{ github.ref_name }}" --repo "${{ github.repository }}" --draft --notes "Pending desktop installers."
gh release upload "${{ github.ref_name }}" "$PKG_NAME" --repo "${{ github.repository }}" --clobber
gh release upload "$TAG" "$PKG_NAME" --repo "$REPO" --clobber
+149
View File
@@ -0,0 +1,149 @@
# SonarQube Cloud: CI-based analysis with test coverage
# (https://sonarcloud.io/project/overview?id=poli0981_free-games-itchio-list).
# Automatic Analysis is switched off on sonarcloud.io — while it is on, the
# scanner refuses to run. Settings: sonar-project.properties. The SonarQube
# Cloud app reports each PR's quality gate as the "SonarCloud Code Analysis" check.
#
# token — is SONAR_TOKEN available? Dependabot and fork PRs get no
# repository secrets: the analysis is skipped there, not failed.
# coverage — pytest-cov and Vitest (v8) coverage reports, without the token.
# scan — sonarqube-scan-action with those reports: the only step that
# uses the token, in a job that runs no project or dependency code.
name: SonarQube Cloud
on:
push:
branches: [main]
# Data commits (the pipeline's, the admin Worker's) and docs change no code.
paths-ignore:
- 'data_game/**'
- 'scripts/temp_link.json'
- 'scripts/deleted_games.json'
- 'scripts/state/**'
- '**.md'
pull_request:
paths-ignore:
- 'data_game/**'
- 'scripts/temp_link.json'
- 'scripts/deleted_games.json'
- 'scripts/state/**'
- '**.md'
workflow_dispatch:
permissions: {}
concurrency:
group: sonarcloud-${{ github.ref }}
cancel-in-progress: true
jobs:
token:
runs-on: ubuntu-latest
timeout-minutes: 5
permissions: {}
outputs:
present: ${{ steps.check.outputs.present }}
steps:
- name: Check for SONAR_TOKEN
id: check
env:
SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }}
run: |
if [ -n "$SONAR_TOKEN" ]; then
echo "present=true" >> "$GITHUB_OUTPUT"
else
echo "::notice::No SONAR_TOKEN in this run (Dependabot or fork PR): SonarQube Cloud analysis skipped."
fi
coverage:
needs: token
if: needs.token.outputs.present == 'true'
runs-on: ubuntu-latest
timeout-minutes: 15
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@6d4fd22b20465ccc0f7354476588e8df7c9ca0e0 # v7.1.0
with:
python-version-file: .github/python-version
cache: pip
cache-dependency-path: |
requirements.txt
requirements-dev.txt
# Hash-locked, wheels only (CLAUDE.md, gotcha 40).
- name: Install Python dependencies
run: |
pip install --require-hashes --only-binary :all: -r requirements.txt -r requirements-dev.txt
- name: Pytest with coverage
run: pytest --cov --cov-report=xml
- 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 npm dependencies
working-directory: webapp
run: npm ci --ignore-scripts
- name: Vitest with coverage
working-directory: webapp
run: npm run test:coverage
- name: Upload coverage reports
uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
with:
name: coverage
path: |
coverage.xml
webapp/coverage/lcov.info
retention-days: 1
if-no-files-found: error
scan:
needs: coverage
runs-on: ubuntu-latest
timeout-minutes: 15
permissions:
contents: read
steps:
- name: Checkout repository
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
with:
# Full history: blame data, and the new-code diff of a PR.
fetch-depth: 0
persist-credentials: false
- name: Download coverage reports
uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
with:
name: coverage
# The app version is the analysis version, so on main "new code" (New Code
# definition: previous version) starts over at each version bump.
- name: Read the app version
id: version
run: |
version=$(jq -r .version webapp/package.json)
if ! [[ "$version" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
echo "::error::webapp/package.json has no x.y.z version"
exit 1
fi
echo "version=$version" >> "$GITHUB_OUTPUT"
- name: SonarQube Cloud scan
uses: SonarSource/sonarqube-scan-action@e805d875275f728fac1885b413934be6d7c63f65 # v8.4.1
env:
SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }}
with:
args: -Dsonar.projectVersion=${{ steps.version.outputs.version }}
+58 -16
View File
@@ -1,7 +1,19 @@
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:
@@ -9,29 +21,59 @@ on:
required: false
type: string
permissions:
contents: write
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: 120
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@6d4fd22b20465ccc0f7354476588e8df7c9ca0e0 # v7.1.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
- name: Install dependencies
run: |
pip install --require-hashes --only-binary :all: -r requirements.txt
- name: Scrape queued links
timeout-minutes: 50
env:
INPUT_URL: ${{ inputs.url }}
run: |
chmod +x ./bash/test.sh
./bash/test.sh
shell: bash
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 }}
-29
View File
@@ -1,29 +0,0 @@
name: Update reviews
on:
schedule:
- cron: '0 5 1,15 * *' # 05:00 UTC on the 1st and 15th of each month
workflow_dispatch:
permissions:
contents: write
jobs:
update-reviews:
runs-on: ubuntu-latest
timeout-minutes: 180
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: Refresh rating + rating_count
run: |
chmod +x ./bash/update_reviews.sh
./bash/update_reviews.sh
shell: bash
-29
View File
@@ -1,29 +0,0 @@
name: Update status
on:
schedule:
- cron: '0 6 1 * *' # 06:00 UTC on the 1st of each month
workflow_dispatch:
permissions:
contents: write
jobs:
update-status:
runs-on: ubuntu-latest
timeout-minutes: 180
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: Refresh status field
run: |
chmod +x ./bash/update_status.sh
./bash/update_status.sh
shell: bash
+66
View File
@@ -0,0 +1,66 @@
# 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
# No install scripts: esbuild's and workerd's postinstall only check their
# platform binary, which their launchers find without it.
- name: Install dependencies
run: npm ci --ignore-scripts
# 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: npm run cf:check
+16 -2
View File
@@ -1,9 +1,23 @@
/docs/app/
# 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/coverage/
/webapp/src-tauri/target/
/webapp/src-tauri/gen/
/webapp/src-tauri/Cargo.lock
.idea/*
cmake-build-*/
+196
View File
@@ -0,0 +1,196 @@
# Accessibility
Last updated: 2026-11-09
Applies from: the release of version 4.6.0 (the website and the desktop and Android apps).
This is a hobby project run by one person, poli0981 (SkullMute), called "the Maintainer" below: a catalog of free itch.io games, on the website https://freeitchgames.win and in desktop and Android apps that show the same pages. Everyone should be able to use it, whether with a keyboard alone, a screen reader, zoom, a high-contrast theme, speech input or anything else. This statement says what works, how it is checked, what doesn't work yet, and how to tell the Maintainer when something gets in your way.
A Vietnamese translation is available at [`docs/i18n/vi/ACCESSIBILITY.md`](docs/i18n/vi/ACCESSIBILITY.md). If the two differ, this English version prevails.
> **TL;DR**
>
> - The goal is [WCAG 2.2](https://www.w3.org/TR/WCAG22/) Level AA for the website and the apps. That is a target, not a certificate: nobody outside the project has audited it.
> - Every page works with the keyboard alone and with a screen reader. The Maintainer tests with the keyboard only, Windows Narrator, and VoiceOver on an iPhone.
> - Colours meet the WCAG contrast ratios in the light and dark themes, and a test checks them on every change. Windows contrast themes are supported, and the site follows your system's "reduce motion" setting.
> - Every chart comes with a data table.
> - Known gaps are listed in [§6](#6-known-limitations).
> - Something in your way? Open an [accessibility issue](https://github.com/poli0981/free-games-itchio-list/issues/new?template=accessibility.yml) or email **contact@poli0981.dev**.
## 1. Scope
This statement covers:
- **the website** https://freeitchgames.win: every public page (Home, Games, the game pages, Charts, Removed, Suggest, Settings, About, the error pages) and the verification page shown before them;
- **the desktop apps** (Windows, macOS, Linux) **and the Android app**, which show the same pages in the system's web view.
It doesn't cover:
- the games themselves, their itch.io pages, and what their creators wrote or made (titles, descriptions, tags, cover images);
- Cloudflare Turnstile, the third-party check on the verification page and on the Suggest form (Cloudflare is responsible for its accessibility);
- the Maintainer's admin page, which has one user;
- other sites the pages link to, GitHub included.
## 2. Goals and priorities
- **Target**: [WCAG 2.2](https://www.w3.org/TR/WCAG22/) Level AA, as far as a one-person hobby project can get.
- **First**: the main tasks with a keyboard and a screen reader: find a game, read its details, open it on itch.io, change your settings, suggest a game.
- **Then**: readable text and controls (contrast, zoom, reflow), no motion you didn't ask for, and the right language for screen readers (English or Vietnamese).
- **Always**: new features keep all of this working (see [§8](#8-for-contributors)).
## 3. What works today
### Moving around
- "Skip to content" is the first thing the Tab key reaches.
- Each page has named landmarks (header, main navigation, search, main content, pager, footer), one level-1 heading, and its own title.
- After you follow a link inside the site, focus moves to the new page's heading, so a screen reader announces the page and Tab continues from there. Going back returns focus to the link you used, for example the game you opened from the list.
- The sticky header never covers what has keyboard focus.
### Keyboard
- Everything works with the keyboard alone: menus, filters, dialogs and charts.
- Focus is always visible: a purple outline, or the system highlight in a contrast theme.
- Dialogs keep focus inside while they are open and return it to where you were when they close.
- "/" jumps to the search box. You can switch this shortcut off in **Settings → Accessibility**, which helps with speech input or if the key clashes with your screen reader or your browser's quick find.
- When a control disappears after you use it (clearing a search, removing a filter), focus moves to the next sensible place instead of getting lost.
### Screen readers
- Every control has a name, in English or Vietnamese. Icons are hidden from screen readers.
- The number of results, search suggestions, loading states and form messages are announced.
- On wide screens the game list is a table with column headers; on phones it is a simple list.
- Links that open a new tab (in the apps: your browser) say so.
- Text in the other language, such as the language names and the English-only names of the legal documents, is marked with its language.
### Seeing the content
- Text and controls meet the WCAG 2.2 AA contrast ratios in both themes: 4.5:1 for text, 3:1 for field borders, the focus outline and chart colours. The test [`webapp/scripts/check-contrast.test.mjs`](webapp/scripts/check-contrast.test.mjs) checks the colours on every change.
- Light, dark or system theme, compact or normal rows, and hidden scrollbars: all in Settings.
- Windows contrast themes (forced colours): the selected tab, pressed toggles, the current page and switches use the system's highlight colours.
- Zoom is never blocked. At 400 % zoom or in a 320-pixel-wide window the phone layout takes over, and the page doesn't scroll sideways.
- Links inside sentences are underlined. Nothing is shown by colour alone: states also change the text, an outline or an underline.
### Motion
- With "reduce motion" switched on in your system, animations, chart entrances and smooth scrolling are off.
- On the website, covers are normally shown as still images (animated covers are turned into stills).
- Apart from loading placeholders, nothing moves on its own.
### Charts
- Each chart is named after its heading. Focus it and use the left and right arrow keys: the value you move to is read out.
- Under every chart, **Data table** opens the same numbers as a table, with each part's share for the pie charts.
### Language
- The pages are in English or Vietnamese (Settings), and the page language follows your choice, so screen readers pick the right voice. Numbers and dates follow it too.
## 4. How it is tested
- **By the Maintainer, by hand** (November 2026): the website on Windows 11 and the Windows desktop app, with the keyboard only (mouse switched off) and Windows Narrator. No blocking problems were found.
- **On a real phone** (November 2026, version 4.6.0): the website on an iPhone 14 Pro with VoiceOver, in Safari, Chrome and Brave. It passed.
- **For 4.6.0**: the main pages and dialogs were walked through with the keyboard, and their accessibility tree was checked (names, roles, headings, landmarks, announcements) in English and Vietnamese, on a desktop and a phone-sized screen.
- **Automatically, on every change**: the contrast test above and the app's unit tests (where focus goes after a page change, the chart tables).
- **Before each release**: a short smoke test. That means a keyboard pass through the main tasks, a screen reader spot check, 200 % zoom and a narrow window, reduced motion, and a Windows contrast theme.
- **Not yet**: automated browser scans (such as axe or Lighthouse) in CI, and testing by people who use a wide range of assistive technology every day. Help is welcome.
## 5. Supported environments
| | Versions |
|---|---|
| Website | Current Chrome, Edge, Firefox and Safari on computers and phones. The oldest versions the site is built for are Chrome and Edge 111, Firefox 114, and Safari and iOS 15.4. |
| Desktop apps | Windows 10 and 11 (Microsoft Edge WebView2), macOS (WebKit 16.4 or newer), Linux (WebKitGTK 4.1) |
| Android app | Android 11 or newer |
Assistive technology:
- **Tested**: Windows Narrator on Windows 11, VoiceOver on iOS (iPhone 14 Pro: Safari, Chrome and Brave), and keyboard-only use.
- **Expected to work, not regularly tested**: NVDA and JAWS on Windows, VoiceOver on macOS, TalkBack on Android, browser zoom, Windows contrast themes, speech input. They rely on the same standard markup.
- **Limited**: Orca in the Linux desktop app, because WebKitGTK supports screen readers less well than the browsers do.
## 6. Known limitations
- **Creators' text isn't marked with its language.** Game titles, descriptions and tags come from itch.io in many languages, and a screen reader reads them in the page's language.
- **Cover images have a generic description** ("Game name cover"). What the image shows isn't described.
- **Charts**: the arrow keys only move left and right. The genre treemap can't be stepped through, but its numbers are in its data table and in the Genres chart. Chart text has a fixed pixel size, so a larger default font size in your browser doesn't change it (page zoom does).
- **Desktop apps**: there are no zoom keys inside the app, the window can't be maximized, and it can't be made smaller than 900 × 600. If you need larger text, use your system's display scaling or the website in a browser.
- **Android app**: pinch-to-zoom is off. The website can be zoomed in your phone's browser.
- **Animated covers in the apps**: the apps load covers straight from itch.io, so an animated cover keeps playing there.
- **Cloudflare's checks**: the verification check (website only) and the anti-spam check on the Suggest form are Cloudflare Turnstile widgets. They usually pass without anything to do. If one ever asks for something you can't do, email the Maintainer.
- **GitHub pages**: the policies, this statement and the issue forms live on GitHub, so GitHub's own accessibility applies there.
- **No external audit**, and one maintainer.
## 7. Reporting an accessibility barrier
If something stops you or slows you down, please say so. Partial reports help too.
- **GitHub**: open an [Accessibility barrier issue](https://github.com/poli0981/free-games-itchio-list/issues/new?template=accessibility.yml).
- **Email**: **contact@poli0981.dev**. No GitHub account needed; English or Vietnamese both work.
Details that help, as far as you're comfortable sharing them (never send health information):
- what you were trying to do, and what happened instead;
- the page (its address) or the app and its version, shown on the About page;
- your device, operating system and browser;
- the assistive technology you use and its version, if any;
- a screenshot or a recording, if you can.
How much it gets in your way:
| Severity | Meaning |
|---|---|
| Critical | You can't do a main task at all, for example open a game or read its details. |
| Serious | You can, but only with great effort or a workaround. |
| Moderate | It's annoying or inconsistent, but you get there. |
| Minor | A small polish issue. |
What happens next. These are targets, not guarantees, since this is a solo hobby project:
- **Acknowledgement** within 7 days, often sooner.
- **A fix or a workaround**: Critical within 30 days, Serious within 60 days, Moderate and Minor in a later release.
- **Website fixes** go live when they are deployed; **app fixes** come with the next release.
- You'll be asked whether the fix works for you, and credited in the release notes if you want.
Security vulnerabilities don't belong in a public issue: see [SECURITY.md](SECURITY.md).
## 8. For contributors
Changes to the interface must keep [§3](#3-what-works-today) true:
- **Keyboard**: every control can be reached and used, focus stays visible and never gets lost.
- **Names**: every control has a label, with its text in both `webapp/src/lib/i18n/en.ts` and `vi.ts`.
- **Colour**: use the theme tokens. `npm test` checks contrast (4.5:1 for text, 3:1 for borders, focus and chart colours), and colour is never the only signal.
- **Motion**: respect `prefers-reduced-motion`; the shared CSS rule and `SERIES_ANIMATION` already do.
- **Screen reader**: check the change once with one (Narrator, NVDA, VoiceOver or TalkBack).
- **Markup**: prefer native elements and the Radix / shadcn components already in use, and add ARIA only when it's needed.
Documentation: headings in order, link text that says where it goes, alt text for images, header cells in tables, and the Vietnamese translation updated (or say in the pull request that it isn't).
The [pull request template](.github/pull_request_template.md) has the checklist.
## 9. Finding accessible games
The catalog shows the accessibility features that creators list on their itch.io pages, such as subtitles, configurable controls or colour-blind modes:
- on each game's page, under "Accessibility";
- as the Accessibility filter on the Games page, for example https://freeitchgames.win/games?access=Subtitles;
- in the "Accessibility Features" chart (Charts → Discovery).
Creators declare these features themselves, and the project doesn't verify them. If a game's information is wrong, report it with the "Bug Report" issue template.
## 10. References
- [Open Source Guides: Accessibility best practices for your project](https://opensource.guide/accessibility-best-practices-for-your-project/)
- [Open Source Accessibility toolkit](https://github.com/open-source-accessibility/accessibility-toolkit): this statement follows the outline of its ACCESSIBILITY.md example, in its own words.
- [Web Content Accessibility Guidelines (WCAG) 2.2](https://www.w3.org/TR/WCAG22/)
- [W3C: Developing an accessibility statement](https://www.w3.org/WAI/planning/statements/)
## 11. Contact
- **Accessibility barriers**: the [issue form](https://github.com/poli0981/free-games-itchio-list/issues/new?template=accessibility.yml) or **contact@poli0981.dev**.
- **Everything else**: see the addresses in [README → Legal](README.md#legal).
## 12. Final vibes
One person, one catalog, every way of browsing it. If something here doesn't work the way you use the web, the Maintainer would really like to hear it — that's how this list gets better. 🚀
+65 -550
View File
@@ -1,552 +1,67 @@
# Changelog
All notable changes to this project will be documented here.
## [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** — the Tauri NSIS `.exe` now shows an
"I Agree" license step before installing, wired via
`bundle.windows.nsis.license` →
[`webapp/src-tauri/installer/EULA.txt`](webapp/src-tauri/installer/EULA.txt)
(plain text so NSIS renders it cleanly). 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.
## [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`](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`.
## [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`](webapp/src/components/data-table/sortable-header.tsx); [`columns.tsx`](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`](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`](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.
---
## [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`](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`](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`](scripts/update_reviews.py), wrapper [`bash/update_reviews.sh`](bash/update_reviews.sh), and [`.github/workflows/update_reviews.yml`](.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`](scripts/update_status.py), [`bash/update_status.sh`](bash/update_status.sh), and [`.github/workflows/update_status.yml`](.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`](scripts/force_update.py), [`bash/force_update.sh`](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`](webapp/src/lib/github/contents.ts) `readFileWithSha` and [`webapp/src/lib/github/git-data.ts`](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`](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`.
---
## [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`](webapp/src/lib/gpg/canonicalize.ts) builds the exact byte string Git would hash, [`sign.ts`](webapp/src/lib/gpg/sign.ts) lazy-imports `openpgp` and exposes `loadPrivateKey` / `signCommit` / `verifyDetached`, [`storage.ts`](webapp/src/lib/gpg/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`](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`](webapp/src/stores/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`](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`](webapp/src/components/data-table/mobile-card-list.tsx). Below the `md` breakpoint, [`DataTable`](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`](webapp/src/routes/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`](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`](webapp/src/lib/github/git-data.ts) 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()`](webapp/src/lib/github/signer.ts)) 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.
---
## [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`](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`](webapp/src/components/data-table/columns.tsx). [`data-table.tsx`](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`](webapp/public/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`](CONTRIBUTING.md#1b-add-games-via-telegram-bot-my_skull_bot--alternative-to-issues) 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`](.github/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`](.github/workflows/notify-ci-failure.yml), [`notify-deploy.yml`](.github/workflows/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`](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).
---
## [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.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.
---
## [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.
---
## [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`](/scripts/delete_game.py). See [#20](https://github.com/poli0981/free-games-itchio-list/issues/20).
- Export JSON → `.csv`/`.xlsx` in [`export_csv.py`](/scripts/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`](/scripts/check_duplicate.py). See [#19](https://github.com/poli0981/free-games-itchio-list/issues/19).
## [1.0.3] - Date unknown (Improvements ⚙️)
### Improved
- Optimized workflow scheduling.
## [1.0.2] - Date unknown (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`](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).
- 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.
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`.
**Latest release: [4.6.2](changelog/4.x/ver4.6.x.md#462---2026-11-16-dependency-updates) (2026-11-16) — Dependency updates.**
## 4.x
| Version | Date | Highlights |
|---|---|---|
| [4.6.2](changelog/4.x/ver4.6.x.md#462---2026-11-16-dependency-updates) | 2026-11-16 | Dependency updates (wry 0.57.2: app crash fixes) |
| [4.6.1](changelog/4.x/ver4.6.x.md#461---2026-11-11-stable-maintenance-mode) | 2026-11-11 | Stable: maintenance mode (data-only issues and PRs), Qodana code analysis |
| [4.6.0](changelog/4.x/ver4.6.x.md#460---2026-11-09-accessibility) | 2026-11-09 | Accessibility: statement, keyboard and screen-reader fixes, chart data tables, WCAG contrast |
| [4.5.0](changelog/4.x/ver4.5.x.md#450---2026-10-27-rate-limits-for-the-whole-site) | 2026-10-27 | Rate limits for the whole site (HTTP 429), WAF guide |
| [4.4.3](changelog/4.x/ver4.4.x.md#443---2026-10-26-dependency-and-security-updates) | 2026-10-26 | Dependency and security updates (build-tool advisories closed) |
| [4.4.2](changelog/4.x/ver4.4.x.md#442---2026-10-22-toolchain-upgrade-code-scan-fixes) | 2026-10-22 | Toolchain upgrade (TypeScript 7, Node 26, Python 3.15), code-scan fixes |
| [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 |
## 3.x
| 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 🖥️📊 |
## 2.x
| 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.x
| 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 🚀 |
+167 -70
View File
@@ -4,69 +4,94 @@ Quick context so future Claude sessions don't have to re-derive it.
## What this repo is
Two layers stacked on the same JSON catalog of free itch.io games:
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.
- `data_game/game_info_NNN.json` — chunked records, max 500 per file, ~1,470 games as of v3.5.0.
- `data_game/index.json` — chunk manifest (total + per-file counts). `data_game/count_history.json` — date-keyed `{date,total}` series powering the "games over time" chart.
- `scripts/` — `scraper.py` (shared session + parsing), `data_store.py` (chunk load/save/rebalance, writes `index.json` + `count_history.json`), `json_io.py` (shared `load_json`/`save_json` + `dedup_deleted`), `update_info.py`, `check_paid.py`, `check_alive.py`, `check_duplicate.py`, `update_reviews.py`, `update_status.py`, `force_update.py`, `generate_md.py`, `log_deleted.py`, `backfill_count_history.py` (one-time count-history seed). Lint: `ruff check scripts/` (config in root `pyproject.toml`).
- `lists/{genre}.md` — auto-generated, **never edit by hand**.
- `bash/` — wrappers used by the GitHub Actions workflows.
2. **Webapp** — `webapp/` (React 19 + TypeScript 6 + Vite 8 + Tailwind v3 + shadcn/ui, Tauri 2 desktop wrapper in `webapp/src-tauri/`). Reads from `raw.githubusercontent.com`; writes via GitHub API with an encrypted PAT.
1. **Python pipeline** — the data layer (GitHub Actions).
- `data_game/game_info_NNN.json` — chunked records, max 500 per file, 6,069 games on 2026-11-16. 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; `pytest --cov --cov-report=xml` → `coverage.xml` for SonarQube Cloud, gotcha 41). 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). Both requirements files are hash-locked pip-tools compiles of `requirements*.in` — edit the `.in`, then recompile (gotcha 40).
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
npm install
npm run dev # http://localhost:5173
npm run build # writes to ../docs/app/ (NOT webapp/dist — that path is Tauri-only)
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 test:coverage # the same with v8 coverage → coverage/lcov.info (repo-root paths, for SonarQube Cloud)
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)
npm run cf:check # wrangler deploy --dry-run with the project's wrangler (what CI runs; after a build)
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)
```
Path alias: `@/*` → `webapp/src/*`. Vite `define`s `__BUILD_DATE__` so About page shows the build date.
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/*`.
## Code-split layout
## Worker (`webapp/worker/`)
`vite.config.ts` `manualChunks` splits node_modules into `vendor-react` / `vendor-query` / `vendor-ui` / `vendor-charts` (Recharts, ~380 KB) / `vendor-github` (Octokit, ~100 KB) / `vendor-openpgp` (OpenPGP.js, ~387 KB — lazy, only touched when Settings → Commit Signing is opened or a commit is being signed). Routes `/charts`, `/add`, `/workflows`, `/settings`, `/about`, `/games/:slug` are `React.lazy` so the initial bundle stays ~163 KB gzip.
- `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).
- `ratelimit.ts` (since 4.5): every Worker request is counted first, per IP (IPv6 /64, `rateKey`) and per Cloudflare location (approximate, fails open), in one `ratelimits` binding per kind of traffic (counted per machine of the data centre: it holds for one-connection clients, the WAF holds for floods — gotcha 43) — `RL_SITE` 120/60 s (pages, public `/api`, legacy `/data`, misses), `RL_IMG` 600, `RL_ADMIN` 300; `RL_SUGGEST` 5 and `RL_GATE` 20 still apply on top to those POSTs. Verified bots (the gate's header) are not counted. Over a limit: 429 + `Retry-After: 60` — JSON `rate_limited` for `/api`, `/img`, files and `/data` (with CORS), the script-less EN/VI page of `gate-page.ts` for app pages. Keep every `period` 60 and a unique `namespace_id` in 88xx (staging 89xx): namespaces are **account-wide** and other Workers on the account (repolens, ticktune…) use 1001–1006, so the old 1001 / 1003 shared their counters (`ratelimit.test.ts` reads `wrangler.jsonc`). Layer 1 is the zone's WAF rate-limiting rule (Free plan: one rule, IP, 10 s; `docs/operations.md` §1 step 15): only it saves the Worker request a flood costs, and only it covers static assets.
- `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).
## Webapp structure
## Web app structure (`webapp/src/`)
- `src/routes/*.tsx` — one file per route; `App.tsx` wires `react-router-dom` HashRouter.
- `src/components/data-table/*` — `DataTable` (TanStack Table + Virtual + pagination), `data-table-toolbar`, `data-table-pagination`, `faceted-filter`, `columns`. Row keys are URL-based (`getRowId: g => g.url`) so selection survives sort/filter/page changes.
- `src/components/ui/*` — shadcn primitives (Button, Card, Input, Label, Badge, Skeleton, Separator, Tabs, Popover, Checkbox, Select, Switch, Textarea, Dialog).
- `src/components/charts/` — chart module (one file per chart, shared `chart-card.tsx` with `ChartCard` + `PALETTE`). 16 charts across 4 tabs. Each tab is a `React.lazy` default export under `charts/tabs/{overview,reach,quality,discovery}-tab.tsx`, wrapped in `<Suspense>` from `routes/charts.tsx`. **Tabs import chart components directly (no `index.ts` barrel — it was removed in v3.7.0)** so the bundler keeps each tab's components in its own chunk; a barrel re-exporting all 16 would collapse them into one shared chunk and defeat the split. Radix unmounts inactive `TabsContent`, so a non-default tab's component code downloads only on first activation. Recharts (`vendor-charts`) still loads with the default Overview tab.
- `src/components/legal-gate.tsx` — full-screen, non-dismissible first-launch legal-acceptance gate (raw Radix Dialog, no close-X, Esc/outside-click disabled). Wraps the shell in `App.tsx`; renders instead of the shell until `prefs.acceptedLegalVersion === LEGAL_VERSION`. Reuses `LEGAL_LINKS` from `about.ts`; persists via `prefs.acceptLegal()`.
- `src/lib/github/` — `client.ts` (Octokit factory), `data-store.ts` (TS port of `scripts/data_store.py`), `contents.ts` (single-file commits — routed through Git Data API so they can be signed), `git-data.ts` (atomic multi-file commit; optional signer for GPG), `signer.ts` (builds a `CommitSigner` from gpg store + auth + prefs), `workflow.ts` (dispatch + poll).
- `src/lib/gpg/` — `canonicalize.ts` (pure: builds the byte string Git would hash for a commit), `sign.ts` (lazy-imports `openpgp`, exports `loadPrivateKey` / `signCommit` / `verifyDetached`), `storage.ts` (encrypted-key + metadata in localStorage).
- `src/lib/crypto.ts` — AES-GCM 256 + PBKDF2-SHA256 100k rounds. **Uint8Array generic must be `<ArrayBuffer>`** under TS 6, not `<ArrayBufferLike>` — Web Crypto rejects the latter.
- `src/lib/use-is-mobile.ts` — `useIsMobile()` hook based on `matchMedia('(max-width: 767px)')`. Use it for branches that need a distinct mobile layout (e.g. card view instead of a wide table).
- `src/lib/i18n/` — minimal typed i18n. `en.ts` is the source of truth (`MessageKey = keyof typeof en`); `vi.ts` must **never** be static-imported — it stays a lazy chunk via `import('./vi')` in `index.ts` only. `t()` imperative, `useT()` reactive hook; language pref lives in the `prefs` store.
- `src/main.tsx` — react-query cache persisted to IndexedDB via `idb-keyval` (`PersistQueryClientProvider`). Only public catalog queries (`db` / `deleted` / `count-history`) are dehydrated, never PAT-gated data. `buster = APP.version`, so bumping `about.ts` invalidates the cache. **`gcTime` must stay >= persist `maxAge`** or restored queries are garbage-collected right after hydration.
- Error handling — `src/lib/http-error.ts` (`HttpError`), `src/components/error-page.tsx` + `route-error.tsx` + `error-boundary.tsx`. Hidden preview route `/errors/:code` (not linked from nav). `webapp/public/404.html` serves as the GitHub Pages custom 404.
- `src/stores/` — Zustand stores: `auth` (in-memory PAT + GitHub user; idle timeout pulled from `prefs`), `theme`, `prefs` (sidebar collapsed + density + idle timeout + author override + notification settings + language + `acceptedLegalVersion` — re-prompts the legal gate when the exported `LEGAL_VERSION` constant bumps), `gpg` (in-memory PrivateKey + fingerprint + uid + enabled), `undo` (20-entry FIFO of reverse ops).
- `src/lib/about.ts` — keep the `THIRD_PARTY` array up to date when adding npm deps; About page reads it.
- `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; every chart container spreads `chartAria(id)` (named by its card's h2 + description + arrow-key hint), every `<Pie>` has `rootTabIndex={-1}`, every `ChartCard` gets an `id` and a `table` (a lazy `<details>` "Data table" built with `lib/chart-table.ts`), and the tooltip reads its text into the card's polite live region through `ChartAnnounce` (a ref, no re-render — gotcha 33); `chart-theme.test.ts` checks all four; 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 — except where WCAG 2.2 AA needed more (4.6.0): `--primary` #6a48f5 (white text 5.44:1), `--primary-text` for purple text (#9a83ff in dark), `--input` #8a8a93 / #6b6b75 for field borders and the off switch (3:1), `--destructive-solid` for filled destructive buttons; `--brand` keeps the mockup's #7c5cff for the logo (as do the favicon, `og.png`, the app icons and the gate page's logo). `webapp/scripts/check-contrast.test.mjs` fails CI when a token pair or a chart colour (`components/charts/palette.ts`) drops below 4.5:1 (text) / 3:1 (borders, ring, chart marks); `lib/color.ts` does the maths. A `@media (forced-colors: active)` block gives selected tabs / pressed toggles / the current page / the active option and switches the system highlight (Windows contrast themes). Themed scrollbars (`@layer base`, only under `(hover: hover) and (pointer: fine) and (forced-colors: none)`): `::-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).
- Accessibility (statement: root `ACCESSIBILITY.md`; target WCAG 2.2 AA): after an in-app navigation `App.tsx`'s ScrollManager moves focus to the new page's h1 (`lib/route-focus.ts` decides: not on first load or query-only changes; a #hash focuses its section; Back focuses the link last used on that entry), waiting for lazy routes with `components/focus-target.ts` (`whenPresent`, 10 s; `focusElement` adds `tabindex=-1` + `data-focus-target`, which hides the ring). Dialogs without a trigger return focus themselves (18+: the opener, `requestNsfw(returnFocus)`; legal gate: the page h1); menus that navigate `preventDefault` their `onCloseAutoFocus` (gotcha 46). The "/" shortcut is a pref (`slashShortcut`, Settings → Accessibility; WCAG 2.1.4). `CardTitle` renders an h2. `ExtLink` appends "(opens in a new tab)" / "(opens in your browser)" for screen readers. English-only strings shown on a Vietnamese page carry `lang="en"`; `<html lang>` turns `vi` only once the VI dictionary is in. `html { scroll-padding-top }` keeps focus clear of the sticky header. No a11y linter: `eslint-plugin-jsx-a11y` peers ESLint ≤ 9.
- `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 ≈ 189 KB gzip (JS + CSS, gzip -9, measured for 4.6.0; 4.2 added ~4.6 KB for the pack loader, persister and `useQueries`, 4.6 ~3 KB for focus management and the accessibility strings) 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
Of the 23 fields per game, only **3** are user-editable: `safe_virus`, `notes`, `nsfw`. The other 17 are scraper output and rendered as read-only badges.
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` | Daily 03:00 UTC + `workflow_dispatch` (with optional `url` input) | Reads `INPUT_URL` env var; falls back to `scripts/temp_link.json`. |
| `check_paid.yml` | Every 2 days 04:00 UTC | |
| `update_reviews.yml` | 1st + 15th of each month, 05:00 UTC + `workflow_dispatch` | Refresh `rating` + `rating_count`. Skip-on-error keeps old values. |
| `update_status.yml` | 1st of each month, 06:00 UTC + `workflow_dispatch` | Refresh `status` only. Same skip semantics. |
| `check_alive.yml` | Every 2 days 07:00 UTC | |
| `force_update.yml` | `workflow_dispatch` ONLY (optional `url` input) | Emergency re-scrape. Empty input = re-scrape all. Always preserves `safe_virus` / `notes` / `nsfw`. Canonical tool for repairing mojibake. |
| `generate_table.yml` | After update / check / refresh workflows succeed | Rebuilds `lists/*.md`. Chain list lives in this file under `workflow_run.workflows` — keep in sync when adding scrape workflows. |
| `log_deleted.yml` | After check workflows | Exports `deleted_games.txt`. |
| `deploy_webapp.yml` | Push to `main` touching `webapp/`, or manual | Builds → `docs/app/` → GitHub Pages. Requires repo Settings → Pages → Source = "GitHub Actions". |
| `release_desktop.yml` | Tag `v*` push, or manual | Tauri build for Win + macOS aarch64 + macOS x86_64 (cross-compile) + Linux. Uploads `.dmg` / `.app.tar.gz` / `.pkg` (macOS), `.msi` / `.exe` (Windows), `.deb` / `.AppImage` (Linux). |
| `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` (both requirements locks installed at once, so drifting pins fail) / `npm ci --ignore-scripts` + `npm run check:tauri` (gotcha 31) + `npm run cf:types -- --check` + lint + knip + vitest + build + `npm run cf:check` (`wrangler deploy --dry-run`). SonarQube Cloud runs in `sonarcloud.yml`. |
| `sonarcloud.yml` | Push to `main` + PRs (both skip data-only and `.md`-only changes) + `workflow_dispatch` | SonarQube Cloud CI analysis (gotcha 41): `token` (no `SONAR_TOKEN` — Dependabot and fork PRs — → notice, the rest skipped) → `coverage` (pytest-cov + Vitest v8, no secrets; artifact kept 1 day) → `scan` (`sonarqube-scan-action`, full history, `sonar.projectVersion` from `webapp/package.json`; the only step that uses the token). |
| `qodana.yml` | Push to `main` + PRs (both skip data-only and `.md`-only changes) + `workflow_dispatch` | Qodana (JetBrains) analysis (gotcha 49): `tokens` (no Qodana secrets — Dependabot and fork PRs — → notice, the rest skipped) → three jobs, one per Qodana Cloud project and token: `typescript` (`qodana-js`, native, `webapp/qodana.yaml`), `python` (`qodana-python`, native, root `qodana.yaml`), `rust` (`qodana-rust`, Docker image, `webapp/src-tauri/qodana.yaml`). Whole-project scans (`pr-mode: false`), no PR comment; each `qodana.yaml` has a quality gate of 0 problems (`failureConditions`), so a finding fails its job. |
| `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. Python installs are hash-locked and wheels only (`pip install --require-hashes --only-binary :all:`, gotcha 40); npm installs skip install scripts (`npm ci --ignore-scripts` — esbuild's and workerd's launchers find their platform binary without them).
## Release / tag process
@@ -74,44 +99,116 @@ Of the 23 fields per game, only **3** are user-editable: `safe_virus`, `notes`,
git fetch origin
git tag -s vX.Y.Z origin/main -m "summary"
git push origin vX.Y.Z
gh release create vX.Y.Z --title "..." --notes "..." --verify-tag
# 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
```
Tag from `main` only (forking from a feature branch and force-moving on rebase makes a mess). GPG signing is wired through gpg-agent; user's signing key is `03F965C2E2DB5C6B` (EDDSA) and `commit.gpgsign=true` is on, so `git tag -s` and `git commit` both sign.
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.
## Required PAT permissions for the webapp
## Licenses & policies
Fine-grained PAT scoped to **only this repo** with:
- **Contents: Read and write** — edits, deletes, queueing URLs.
- **Actions: Read and write** — dispatching the scraper workflow.
`workflow:write` is **not** what we need (that's for editing `.github/workflows/*.yml` files, which the webapp doesn't do). Classic PATs with the `workflow` scope happen to cover both.
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`. `ACCESSIBILITY.md` (root: GitHub's accessibility community health file; VI mirror `docs/i18n/vi/ACCESSIBILITY.md`) is a statement, not a policy to accept — no `LEGAL_VERSION` bump when it changes, but keep its §3 (what works) and §6 (known limitations) in step with the code; barriers come in through `.github/ISSUE_TEMPLATE/accessibility.yml` (label `accessibility`) or contact@. 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`) instead.
2. **`macos-13` is retired** from free GitHub-hosted runners (late 2024). Cross-compile x86_64 from `macos-latest` (Apple Silicon).
3. **Tauri icons must exist before build.** Generate via `npm run tauri icon -- path/to/source.png`. The 1024×1024 source is gitignored; generated icons are committed.
4. **Tauri doesn't ship `.pkg`.** We build it with `pkgbuild` after `tauri-action` and upload via `gh release upload`. Step uses `if: always()` so a DMG flake doesn't drop the PKG.
5. **Vite v8 `base`** only accepts `'./'`, an absolute URL, or an empty string. Anything else warns and silently breaks asset paths.
6. **TS 6** deprecates `baseUrl`. Use `paths` alone.
7. **lucide-react v1+** removed/renamed brand icons (`Github` → not available). Use `Library`, `Database`, etc. for repo icons.
8. **`/repos/.../contents` `content` is base64 with newlines AND base64-decoded data is UTF-8.** Strip newlines first, but `atob` alone returns a Latin-1 binary string — multi-byte UTF-8 sequences become mojibake. Go through `TextDecoder('utf-8')` via the `base64ToUtf8` helper in `webapp/src/lib/github/encoding.ts`. The matching `utf8ToBase64` is correct as-is.
9. **`createWorkflowDispatch` returns 204 with no run id.** To track the run, list runs filtered by `event=workflow_dispatch` and a dispatch timestamp from a few seconds before.
10. **`docs/app/` is gitignored.** CI builds it. Don't commit build output.
11. **PUT `/repos/.../contents/{path}` can never be "Verified".** GitHub authors that commit itself from the PAT; there is no `signature` field. All webapp writes must go through the Git Data API (blob → tree → commit → updateRef) to allow GPG signing. `contents.ts` `putFile` was removed for this reason — use `commitSingleFile` (wraps `atomicCommit`).
12. **GPG signing must use binary mode in openpgp.js.** `openpgp.createMessage({ text })` normalizes line endings before hashing → signature won't verify against the LF-only Git commit object. Use `createMessage({ binary: TextEncoder.encode(canonical) })`.
13. **Commit object canonical timestamp must match Octokit's `author.date` exactly.** GitHub re-derives `<unix_ts> <±HHMM>` from the ISO date and recomputes the SHA. Use a single `ts + tzOffsetMin` source for both, derive `author.date` via `isoFromTs(ts, tzOffsetMin)`.
14. **TabsList primitive is `inline-flex` with `whitespace-nowrap` triggers.** Many tabs + narrow viewport → overflow. The fix in `/workflows` is dual-render: `<Select>` on mobile (`md:hidden`), TabsList on desktop (`hidden md:inline-flex`). Charts uses `flex-wrap` defensively but the labels are short enough to fit at 430px.
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.
40. **The Python requirements are hash-locked pip-tools compiles** — `requirements.txt` ← `requirements.in`, `requirements-dev.txt` ← `requirements-dev.in` (`-c requirements.txt`) — installed everywhere with `--require-hashes --only-binary :all:`, so a new release of any dependency, indirect ones included, can't reach the jobs that push to `main`, and no sdist build script runs. After editing a `.in`, recompile with **pip-tools on Python 3.14**: `pip-compile --generate-hashes --allow-unsafe --strip-extras requirements.in`, then the same for `requirements-dev.in`. Dependabot takes the Python version from the `# … autogenerated by pip-compile with Python X.Y` header and supports ≤ 3.14 (gotcha 39); the hashes cover every file of a release, so CI's 3.15 still finds its cp315 wheels. `colorama` is listed in `requirements-dev.in` because pytest needs it on Windows only: a lock compiled on Linux (Dependabot's) would otherwise leave it out and the hash-checked local install would fail. Keep those pip commands in a block scalar (`run: |`): in a plain YAML scalar the `: ` of `:all: -r` makes the whole workflow file invalid — GitHub then records a 0-job failed push run named after the file, and a PR simply shows no check for that workflow.
41. **SonarQube Cloud analyses in CI** (`sonarcloud.yml` + `sonar-project.properties`; project `poli0981_free-games-itchio-list`, public). Automatic Analysis is switched off on sonarcloud.io — switched back on, it makes the CI scan fail. PRs get a "SonarCloud Code Analysis" check from the SonarQube Cloud app; Dependabot and fork PRs get no `SONAR_TOKEN`, so their analysis is skipped with a notice (a Dependabot secret of that name would enable it). Tests run in the `coverage` job without the token; besides the `token` job's presence check, only the `scan` step gets it, in a job that runs no project code. Binary images and the D1 migrations (SQLite, claimed by the Oracle PL/SQL analyzer, which then warned on every run) are excluded from the analysis. Coverage: `pytest --cov` (`[tool.coverage.run]` in `pyproject.toml`) and `npm run test:coverage` (`test.coverage` in `vite.config.ts`; the lcov reporter's `projectRoot` is the repo root, so the scanner resolves the paths); `@vitest/coverage-v8` needs vitest's exact version (Dependabot group `vitest`). The built-in "Sonar way" gate fails a PR under 80 % coverage on new code (from 20 new lines up), so code without unit tests by design is in `sonar.coverage.exclusions` — keep that list in step with what the tests reach. `sonar.projectVersion` comes from `webapp/package.json`: on `main`, "new code" (previous version) starts over at each version bump. `sonar.python.version` stays 3.14 until SonarQube Cloud's analyzer supports 3.15 (it warns "No explicit support for version 3.15"). The free plan keeps only `main` and PRs: a manual run on another branch uploads a branch analysis nobody can open ("not allowed to access data from non main branches"). Mark a false positive on the issue itself. Two of its suggested fixes are wrong here: S2871 wants `localeCompare` in `.sort()`, but chunk names, migration files and `unblocked.json` keep code-unit order (= Python's `sorted()`) — pass `compareCodeUnits` (`worker/text.ts`); S8906 wants `select_one('div.a.b')` for bs4's `class_=[a, b]`, which means *either* class — write a selector list `div.a, div.b`. Trim trailing characters with `trimEnd()` (`worker/text.ts`), not `/x+$/` (S8786: quadratic backtracking on a long run). Known false positive: css:S8776 on Tailwind v4's `@utility … { &::-webkit-scrollbar … }` (the `&` is required for variants).
42. **miniflare (wrangler's local runtime) pins `undici` exactly, so Dependabot can't fix an undici alert** until a wrangler release moves the pin. The stopgap is `overrides.undici` in `webapp/package.json` (4.4.3–4.5.0 carried `^7.30.1` over wrangler 4.152's 7.29.1; dropped with wrangler 4.156, whose miniflare pins 7.30.1). Only miniflare uses undici; nothing of it reaches the site, the Worker or the apps. Remove such an override once `npm ls undici` without it shows the fixed version, and before miniflare moves to a new undici major (the override would hold it back).
43. **The Workers rate-limit binding counts per machine, not per data centre.** Measured on production right after the 4.5.0 deploy (CDG): 1,000 requests in 53 s, each `curl` on a new connection, against `RL_SITE` 120/60 s → **no 429 at all**; 200 requests on **one** keep-alive connection → 93 × 200, then 429s. A data centre has many machines, each counts locally and syncs late, so a client that keeps one connection (browsers over HTTP/2, scripts with keep-alive) is held to the limit, while one that opens a new connection per request is spread across machines and barely counted. The zone's WAF rule counts across the data centre: it is the limit that holds against floods. Test the Worker limits over one connection (`curl URL URL …` in one invocation, or `--next`), never with `xargs curl`; under `wrangler dev` (miniflare: one process) every request counts. The WAF rule (300 / 10 s, set 2026-10-27) needs > 30 requests a second, which `xargs curl` doesn't reach from a home line: use the runbook's Node `fetch` one-liner (800 requests in 4.9 s → 111 × 200, 201 × Worker 429, 488 × WAF 1015).
44. **Tailwind v4's `outline-hidden` adds a visible 2 px outline in forced-colours mode.** On a focus variant that is the point (inputs keep a system-coloured focus ring in Windows contrast themes); used unconditionally on a container (`<main tabIndex={-1}>`, the games list, popovers) it drew a permanent frame there. Containers use `outline-none`, fields `focus-visible:outline-hidden`.
45. **Vitest stubs CSS imports — `./index.css?raw` is an empty string in tests.** A test that reads a stylesheet lives in `webapp/scripts/*.test.mjs` and uses `node:fs` (`check-contrast.test.mjs`; `src/` has no Node types).
46. **Radix FocusScope gives focus back to the trigger in a `setTimeout` after unmount.** A link inside a menu or sheet that navigates would have focus pulled back to the menu button, away from the new page's h1: `SheetContent` / `PopoverContent` call `e.preventDefault()` in `onCloseAutoFocus` when the path changed. A modal opened without a Radix trigger (the 18+ dialog) drops focus to `<body>` unless `onCloseAutoFocus` focuses something. Radix 1.3.1 sets no `aria-modal` (it hides the rest with `aria-hidden`).
47. **Name Recharts charts with `aria-labelledby`, not their `title` prop** (`title` also shows a native browser tooltip over the whole chart); `Treemap`'s props type has no `role`. A custom tooltip loses Recharts' live region, and the tooltip box is `visibility: hidden` while inactive, so announcements go through the card (`ChartAnnounce`).
48. **The tool permissions refuse loading third-party code into the preview page** (an axe-core `<script>` from a CDN). Check pages with the browser's accessibility tree and DOM queries instead; Lighthouse / axe DevTools are for the owner's own browser.
49. **Qodana takes one linter per Qodana Cloud project**, hence three projects (`itch-typescript` wwgZ1, `itch-python` GgGnX, `itch-rust` P2Rd7; team "My first team", public) and three secrets (`QODANA_TOKEN_TS_JS` / `_PYTHON` / `_RUST`). All three linters need an **Ultimate** licence (a trial in Nov 2026; the Rust linter is Early Access and its image carries its own evaluation licence, to 2027-01-10): when it ends the scans fail on the licence — renew, or delete `qodana.yml` and the three `qodana.yaml`. What the first runs cost: (a) **native `qodana-python` finds no interpreter by itself** (`SDKs.json` empty), and then calls every `X | None` an invalid type hint and a dataclass a class without `__init__` — the job builds `.venv` and passes `QODANA_PYTHON_PATH`; (b) **the `qodana-rust` image has no C linker and none of Tauri's system libraries, and its container runs as the runner's user**, who can't write the image's `CARGO_HOME` or `apt-get install` (`cargo metadata` / `cargo check` fail → "Cargo project loading" sanity problem, analysis degraded, `run` unresolved) — the job passes `-u root -e CARGO_HOME=/data/cache/cargo`, `webapp/src-tauri/qodana.yaml` installs the packages in `bootstrap`, and a stand-in `webapp/dist/index.html` lets `tauri::generate_context!()` expand; (c) `--project-dir <subdir> --repository-root .` is how a subdirectory project keeps its git data; (d) the default cache keys are the same for every job of a run — each job sets its own. `gh run view --log` returns nothing until the whole run has finished; the report (SARIF + IDE logs) is the `qodana-report-*` artifact, a zip inside the artifact. Inspections switched off on purpose are listed with their reason in `webapp/qodana.yaml` (throw-to-own-catch in Worker handlers, kept regex escapes, non-ASCII keys); deliberate uses of deprecated DOM APIs carry `// noinspection JSDeprecatedSymbols`. Recharts' `<Cell>` is deprecated (gone in 4.0): a pie slice's colour is the `fill` of its data entry (`paletteFills` in `components/charts/palette.ts`).
## Safe-edit rules
- Don't edit `lists/*.md` directly — they're regenerated by `generate_md.py`.
- Don't commit `webapp/dist/`, `webapp/src-tauri/target/`, `Cargo.lock`, or `webapp/src-tauri/icon-source.png`.
- Don't commit a real PAT, ever. Settings page handles it client-side; CI uses `secrets.GH_TOKEN`.
- When adding an npm dep, also add it to `webapp/src/lib/about.ts` so the About page lists it.
- 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. A Python dep goes into `requirements*.in`, then recompile the locks (gotcha 40).
## Current state (as of v3.7.0)
## Current state (Nov 2026)
`main` is the trunk. All feature work has merged. Tags `v3.0.0` through `v3.7.0` exist (all GPG-signed). The webapp is published at `https://poli0981.github.io/free-games-itchio-list/app/`. v3.7.0 added the first-launch legal-acceptance gate, the Windows NSIS installer EULA page, and per-tab lazy-loading of the charts route.
**Maintenance mode since v4.6.1 (2026-11-11) — the owner's decision.** The project is stable and feature-complete. Work is limited to security fixes (CVEs), runtime / dependency updates (the weekly sweep) and repairs when the site or the data pipeline breaks; **no new features, redesigns or refactors**. Issues and PRs are accepted for the data only (add, fix, remove a game — README → Project status, CONTRIBUTING); accessibility barriers and security reports keep their channels (kept because ACCESSIBILITY.md §7 and SECURITY.md promise them). Feature requests and code PRs are closed without review. Don't propose features in this repo.
**v4.6.2** (2026-11-16, PR #195): dependency-only release — the 2026-11-16 sweep below. Released because wry 0.57.2 fixes Android crashes and a memory leak, macOS panics and a Windows focus issue, which reach the apps only through a release (web-only updates redeploy on merge and need none). The owner wants a deps-only release's notes short: one "Update deps:" list (changelog + GitHub release). README count 6,000+ (6,069 games that day). No policy change (`LEGAL_VERSION` unchanged).
**v4.6.1** (2026-11-11): maintenance mode + Qodana. Docs (EN + VI): "Project status" in the READMEs, CONTRIBUTING rewritten around the data-only scope, SECURITY note, runbook §2 step 5 (Qodana) and §4. Templates: `bug_report.yml` is now "Report a problem"; `feature_request.yml`, `feedback.yml`, `general_question.yml` and the PR templates `bug_fix.md`, `new_features.md`, `documentation.md` are deleted; the issue chooser links Discussions. README badges (status, Python CI, SonarQube quality gate + coverage, Qodana, WCAG target) and the game count (5,900+; 5,907 games that day). `qodana.yml` + three `qodana.yaml` (gotcha 49). Code changes are only the first Qodana findings: pie charts without `<Cell>`, `ElementRef` → `ComponentRef`, `FormEvent` → `SubmitEvent`, an awaited `res.json()`, three Python nits, the unused `serde_json` crate dropped from the Tauri shell. No policy change (`LEGAL_VERSION` unchanged).
**v4.6.0** (2026-11-09): accessibility. Root `ACCESSIBILITY.md` + VI mirror (the owner had tested the website and the Windows app with the keyboard only and Windows Narrator; this release fixed what a WCAG 2.2 AA review found; after it, the owner's VoiceOver test on a real iPhone 14 Pro in Safari, Chrome and Brave passed), the `accessibility.yml` issue form and labels `accessibility` / `feedback`, a default `.github/pull_request_template.md` (GitHub's community profile ignores `PULL_REQUEST_TEMPLATE/`). Code: focus management (route h1, Back to the used link, dialogs), the "/" shortcut switch, header search options / count, h2 card titles, `lang` marking, screen-reader text for counts / loading / new tabs, contrast tokens + `check-contrast.test.mjs`, forced-colours CSS, chart names / arrow-key announcements / data tables. Docs sync: dead `@freeitchgames.win` addresses in `data_game/LICENSE.md`, stale dates / VI revision notes / library versions, `check:tauri` in the check lists, the About page's removal link, `remove_game.yml` → label `delete-game`. Not done by choice: desktop zoom (`zoomHotkeysEnabled` off, `maximizable: false`, min 900×600 — a known limitation in the statement). No policy change (`LEGAL_VERSION` unchanged). Ships the two deps sweeps below.
**Deps sweeps since v4.5.0** (11-02 and 11-09 shipped in 4.6.0 — the catalog had 5,818 games on 2026-11-09 —, 11-16 in 4.6.2). Each combines the week's Dependabot PRs plus what Dependabot didn't open (its 5-PR limit, pip / actions / cargo), with the 3-day cooldown applied by hand to every ecosystem (cargo and actions have none in `dependabot.yml`):
- 2026-11-02, PR #176: Dependabot #171–#175 (react-router 8.5.1, TanStack Query 5.105.0, lucide-react 1.64.0, knip 6.44.0, typescript-eslint 8.72.1, wrangler 4.156.0 + regenerated types), jose 6.2.14, `overrides.undici` dropped (gotcha 42), pytest 9.2.0 / Ruff 0.17.3, sonarqube-scan-action 8.4.0, `cargo update`.
- 2026-11-09, PR #182: Dependabot #177–#181 (TanStack Query 5.106.1, vitest 5.1.0, vite 8.3.6, @vitejs/plugin-react 6.2.1, Tailwind 4.3.4, eslint 10.14.0, knip 6.44.1, wrangler 4.158.0 + regenerated types, jose 6.2.15, globals 17.14.0), lucide-react 1.69.0, soupsieve 4.0.1 (a major whose breaking changes only touch `<template>` / `<iframe>` contents), coverage 7.17.2 / Ruff 0.17.4, setup-java 6.2.0, sonarqube-scan-action 8.4.1, `cargo update` (wasm-bindgen 0.2.130 family …).
- 2026-11-16, PR #195: Dependabot #190–#194 (TanStack Query 5.107.1, @tauri-apps/plugin-opener 2.7.3, Tailwind 4.3.5, @vitejs/plugin-react 6.3.0, knip 6.45.1, typescript-eslint 8.72.2, vite 8.3.8, wrangler 4.161.0 + regenerated types, jose 6.2.17, lucide-react 1.72.0), zustand 5.1.0 (`persist` still hydrates sync storage synchronously; `rehydrate()` now returns a `Promise`), soupsieve 4.1 / coverage 7.17.3 / Ruff 0.17.5, `cargo update` (wry 0.57.2 — it pulls `dom_query` 0.29 next to tauri-utils' 0.28 —, tauri-plugin-opener 2.7.3; brotli, bumpalo, cc, ctor, jiff, mio held at older versions by the cooldown); transitive npm bumps checked too (tapable 2.3.4 held at 2.3.3 in the lock; `npm audit signatures` all verified). Held for the next sweep: eslint 10.15.0, eslint-plugin-react-refresh 0.5.8, lucide-react 1.73.0, wrangler 4.162.0, soupsieve 4.1.1, sonarqube-scan-action 8.5.0, setup-java 6.3.0. Rust stable 1.100.0 (2026-11-12) is what the release builds now get (`toolchain: stable`).
Node 26.13.1 (LTS; the 2026-11-11 security release — http2 / TLS server fixes) with its npm 11.20.0 is current: CI and Workers Builds follow `.node-version` / `NODE_VERSION` `26` by themselves; only local installs need upgrading.
`npm audit`: 9 moderate, all minimatch < 11.0.1 (GHSA-g3hv-75wg-m249) under eslint / typescript-eslint — dev-only, no fix until they accept minimatch 11. `cargo audit`: 0 vulnerabilities, 5 upstream warnings. Security settings unchanged: CodeQL default setup not configured, Dependabot security updates off; 0 open alerts, SonarQube Cloud 0 issues.
**v4.5.0** (2026-10-27): rate limits for the whole site — `worker/ratelimit.ts` + `RL_SITE` / `RL_IMG` / `RL_ADMIN`, every namespace moved to 8801–8806 / staging 8901–8906 (account-wide ids; 1001 / 1003 were shared with other Workers), the 429 page, admin wording, `docs/operations.md` §1 step 15 (the WAF rule: `not cf.client.bot`, not `/assets/` or `/data/pack/`, 300 requests / 10 s, block 10 s — set by the owner in the dashboard). No policy change (`LEGAL_VERSION` unchanged; SECURITY.md EN + VI describe the limits).
**v4.4.3** (2026-10-26): dependency and security updates only — the week's npm updates (Dependabot #159–#163 in one PR, plus lucide-react / Zustand; `knip` kept at 6.42.1 by the 3-day cooldown), wrangler 4.152 with regenerated `worker-configuration.d.ts` (a wrangler bump fails `cf:types -- --check` until it is regenerated — why Dependabot's build-tooling PR failed), `overrides.undici` (gotcha 42), zod 4.6.7, `cargo update` (tauri 2.12.5, tokio 1.54.1; `cargo audit`: 0 vulnerabilities, 5 upstream warnings — glib, zbus family, proc-macro-error), certifi / coverage / Ruff via pip-tools on 3.14, `actions/setup-python` 7.1.0. Repository security state that day: CodeQL default setup **not configured** (last analyses May 2026, 0 open alerts), Dependabot **security updates disabled** in Settings (version updates run), secret scanning + push protection on, SonarQube Cloud gate OK with 0 issues.
**SonarQube Cloud CI** (2026-10-22, shipped in 4.4.3's notes): CI-based analysis with test coverage replaced Automatic Analysis — `sonarcloud.yml`, `sonar-project.properties` (tests marked as tests, coverage exclusions, `.sonarcloud.properties` removed), `pytest-cov` + `@vitest/coverage-v8` (gotcha 41).
**Toolchain** (2026-10-22, #149 + #154, shipped in 4.4.2): 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.2** (2026-10-22): SonarQube Cloud cleanup — the scan's 57 issues: 45 fixed in code, the 11 on the saved itch.io test pages excluded by `.sonarcloud.properties`, css:S8776 (Tailwind `@utility`) left for the owner to mark a false positive (gotcha 41). Worker paths and the gate cookie's padding are trimmed by `trimEnd()` (a `/\/+$/` on the public 404 path was quadratic), the feed / collection parsers have no backtracking regexes left, `compareCodeUnits` makes the code-unit sorts explicit, the NSFW notices are one selector list (each tested). Supply chain: hash-locked Python deps + wheels only in every workflow (gotcha 40), `npm ci --ignore-scripts` in CI and the release builds, `npm run cf:check` instead of `npx wrangler`. `scripts/i18n-edit.mjs` reads its operations from stdin (`node scripts/i18n-edit.mjs < ops.json`). Ships the toolchain upgrade and Dependabot #141–#148, #150, #152, #153.
**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). 🚀
+115 -73
View File
@@ -1,106 +1,148 @@
# Contributing Guidelines
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, Claude Opus 4.7)** 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.
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)
## Project Status: Stable, Maintenance Only
Please use the issue/PR templates — they make my life easier and reduce "wtf" moments.
Since version 4.6.1 (2026-11-11) the project is **stable and in maintenance mode**. It is feature-complete: the website, the apps and the data pipeline keep running, and the catalog keeps updating itself.
### 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.
- **Still done by the Maintainer**: security fixes (CVEs and reports made through [SECURITY.md](SECURITY.md)), runtime and dependency updates, and repairs when something stops the site or the daily data updates from working.
- **Not done any more**: new features, redesigns, refactors.
- **Issues and pull requests are accepted for the data only**: adding games (section 1), fixing a game's data or removing a game (sections 2 and 3). Accessibility barriers (section 3) and security reports keep their own channels. Anything else is closed without review; no hard feelings.
#### 1b. Add games via Telegram bot ([@my_skull_bot](https://t.me/my_skull_bot)) — alternative to issues
## How to Contribute (Use the Right Door, I'm Lazy ;D)
Faster batch path if you have many links and don't want to file an issue per
batch. Privacy-conscious — your Telegram numeric ID never enters this repo.
Games go through the website; data fixes and removals go through the GitHub issue templates or email. They make my life easier and reduce "wtf" moments.
1. **Contact owner** privately on Telegram ([@SkullMute0011](https://t.me/SkullMute0011)) — or via any channel listed in [About](https://poli0981.github.io/free-games-itchio-list/app/#/about) → Find me elsewhere.
2. **Find your Telegram numeric ID** — e.g. send `/start` to [@userinfobot](https://t.me/userinfobot) and copy the ID it returns.
3. **DM your ID to the owner.** **Never** post your numeric ID into Discord, X, GitHub comments, or any public channel.
4. Owner adds your ID to the bot's local whitelist (operator-side, not committed to this repo).
5. **Owner runs the bot** in a local Docker container, ~2–5 hours per day. Status visible at [@my_skull_bot](https://t.me/my_skull_bot).
6. **Follow the bot's prompts** — paste itch.io URLs, the bot dispatches the `bot-ingest.yml` workflow, and edits the same Telegram message with the result when done.
### 1. Suggest New Games (Most Welcome!)
Full bot behavior + technical flow:
[USER_GUIDE.md](https://github.com/poli0981/telegram-scraper-bot/blob/main/docs/USER_GUIDE.md)
in the bot's repo [poli0981/telegram-scraper-bot](https://github.com/poli0981/telegram-scraper-bot).
- 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.
- The game must be playable or downloadable **on its itch.io page itself** (a browser build or an uploaded file). A page that only points to a launcher or a download on another site doesn't qualify, even when that is free: the [Disclaimer](docs/DISCLAIMER.md) tells visitors that any download happens on itch.io.
- 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.
Privacy + handling of your Telegram ID is documented in
[Terms of Use §14](docs/ToS.md) and [Privacy Policy §15](docs/PrivacyPolicy.md).
Removal request: DM the owner with "remove me from whitelist" — done at next bot start.
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-pull-requests)).
### 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).
#### 1b. Other ways games get in
### 3. Report Bugs
- Open issue → **[Bug Report]** template.
- Checkboxes for common bugs (dead links, wrong flags, table broken, etc.).
- 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? Use the **[Report a problem]** issue template (section 3).
Details live in the [Terms of Use](docs/ToS.md) and the [Disclaimer](docs/DISCLAIMER.md).
### 3. Report a Problem (Wrong Data, Something Broke)
- Open an issue → **[Report a problem]** template ([direct link](https://github.com/poli0981/free-games-itchio-list/issues/new?template=bug_report.yml)).
- It is for **data errors** (dead link, wrong name, genre, tags, cover, `nsfw` or `safe_virus` flag…) and for **things that broke** (a page or an app that stopped working, the catalog no longer updating). It is not for ideas: see section 4.
- Details + screenshots + urgency level.
- If complex — see "Discuss More" below.
- **Security problems are not for the public tracker.** Report them privately: see [SECURITY.md](SECURITY.md).
- **Accessibility barriers** (keyboard, screen reader, zoom, contrast, motion…): use the **[Accessibility barrier]** template ([direct link](https://github.com/poli0981/free-games-itchio-list/issues/new?template=accessibility.yml)), or email contact@poli0981.dev if you'd rather not use GitHub. What happens next is in [ACCESSIBILITY.md](ACCESSIBILITY.md#7-reporting-an-accessibility-barrier).
### 4. Suggest Features or Improvements
- Open 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).
### 4. Features and Improvements (Closed)
### 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.
- The project is in maintenance mode: **feature requests, improvement ideas and code changes are no longer accepted**. Such issues and pull requests are closed without review.
- The code is MIT-licensed: you're welcome to fork it and build your own thing ([README → License](README.md#license)).
### 6. Anything Else (Questions, Memes, Off-Topic)
- Use the **[General / Off-Topic]** template.
- Drop whatever's on your mind.
### 5. Feedback, Questions, Anything Else
### 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).
- Use **[GitHub Discussions](https://github.com/poli0981/free-games-itchio-list/discussions)**, the Discord servers or email (see "Discuss More" below). Roast or praise, my self-loathing can handle it.
- They are read, but they don't turn into new features (section 4).
### 8. Webapp Changes (React + TS)
### 6. Dependencies and Security Fixes
The browse/edit UI lives in [`webapp/`](webapp/). Same MIT license, same PR template.
- Dependency updates are handled by Dependabot and the Maintainer's weekly sweep: please don't send version-bump PRs.
- Found a vulnerability? Report it privately ([SECURITY.md](SECURITY.md)); the Maintainer makes the fix.
### 7. Pull Requests
- **Accepted**: a PR that adds itch.io URLs to `scripts/temp_link.json` (use the [Add Games] PR template). Merging it is the Maintainer's approval.
- **Not accepted**: everything else (code, UI, docs, refactors). Fixing or removing a game's data goes through an issue or email (sections 2 and 3), because the pipeline owns `data_game/`.
- The rules below still apply to every PR, the Maintainer's own included.
**PR rules** (the non-negotiable part):
- **CI must pass.** Python CI (ruff check + format, vulture, pytest, `validate.py`) and Webapp CI (Tauri crate/npm version check, type generation check, lint, knip, tests, build, `wrangler deploy --dry-run`) both run on PRs. Red CI = no merge. SonarQube Cloud also analyses each PR (with test coverage) and reports its quality gate as the "SonarCloud Code Analysis" check, and Qodana (JetBrains) analyses the TypeScript / JavaScript, Python and Rust code. Both skip PRs from forks, which get no repository secrets.
- **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 (and ExtLink tells screen readers the link opens a new tab).
- **Accessibility**: UI changes keep working with the keyboard alone and with screen readers, and keep the contrast ratios (`npm test` checks the colours). The checklist is in [ACCESSIBILITY.md → For contributors](ACCESSIBILITY.md#8-for-contributors) and in the pull request template.
### 8. Dev Setup (Summary)
For forks, and for the Maintainer's own maintenance work.
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`):
**Local dev** (Node 22+, npm):
```sh
cd webapp
npm install
npm run dev # http://localhost:5173
npm run build # writes to docs/app/ (verify before pushing)
npm run lint # eslint
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
```
**Tauri desktop dev** (also needs Rust via https://rustup.rs and platform deps — see [`webapp/TAURI.md`](webapp/TAURI.md)):
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 # produce installers in src-tauri/target/release/bundle/
npm run tauri:build # installers in src-tauri/target/release/bundle/
```
**House rules**:
- Don't commit `webapp/dist/` or `docs/app/` — CI builds them on push to `main`.
- Don't commit a real PAT into the repo (that's also a webapp Settings concern, not a CI concern).
- Add new third-party deps? Update `webapp/src/lib/about.ts` so the About page lists them.
## 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 — there are actual servers now (introvert god-mode breached):
- **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, and anything outside the maintenance scope above, 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 are best for tracking data problems, but if you wanna chit-chat, ask something, or share noob stories, there are [GitHub Discussions](https://github.com/poli0981/free-games-itchio-list/discussions) and 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
- 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)
@@ -111,8 +153,8 @@ Issues/PRs are best for tracking, but if you wanna describe bugs/features in dep
**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 can't join Discord, but ping me on any channel — I'll try not to ghost.
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-10-16
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.*
+307 -136
View File
@@ -1,167 +1,286 @@
# Free Itch.io Games List
[![Version](https://img.shields.io/badge/version-3.6.1-blue.svg)](https://github.com/poli0981/free-games-itchio-list/)
[![Version](https://img.shields.io/badge/version-4.6.2-blue.svg)](https://github.com/poli0981/free-games-itchio-list/releases/latest)
[![Status: stable, maintenance only](https://img.shields.io/badge/status-stable%20%C2%B7%20maintenance%20only-brightgreen.svg)](#project-status)
[![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)
[![Python CI](https://github.com/poli0981/free-games-itchio-list/actions/workflows/python-ci.yml/badge.svg?branch=main)](https://github.com/poli0981/free-games-itchio-list/actions/workflows/python-ci.yml)
[![Quality gate](https://sonarcloud.io/api/project_badges/measure?project=poli0981_free-games-itchio-list&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=poli0981_free-games-itchio-list)
[![Coverage](https://sonarcloud.io/api/project_badges/measure?project=poli0981_free-games-itchio-list&metric=coverage)](https://sonarcloud.io/summary/new_code?id=poli0981_free-games-itchio-list)
[![Qodana](https://github.com/poli0981/free-games-itchio-list/actions/workflows/qodana.yml/badge.svg?branch=main)](https://github.com/poli0981/free-games-itchio-list/actions/workflows/qodana.yml)
[![Accessibility: WCAG 2.2 AA target](https://img.shields.io/badge/accessibility-WCAG%202.2%20AA%20target-informational.svg)](ACCESSIBILITY.md)
[![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)
> 🇻🇳 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.
A curated, auto-updating catalog of free games on [itch.io](https://itch.io). Games are scraped, validated, and
organized into browsable markdown tables — updated daily via GitHub Actions.
A curated, auto-updating catalog of **6,000+ 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.
## Project status
**Stable, maintenance only** (since version 4.6.1, 2026-11-11). The project is feature-complete: the
website, the apps and the data pipeline keep running, and the catalog keeps updating itself every day.
- **What still happens**: security fixes (CVEs and reports made through [SECURITY.md](SECURITY.md)),
runtime and dependency updates (Node.js, Python, Rust, npm / pip / cargo packages, GitHub Actions),
and repairs when something stops the site or the daily data updates from working.
- **What no longer happens**: new features, redesigns and refactors. Feature requests and code
pull requests are closed without review.
- **Issues and pull requests are for the data only**: adding games, fixing a game's data, removing a
game. See [Contributing](#contributing).
## Table of contents
- [Browse by genre](#browse-by-genre)
- [Webapp (browse + edit + analytics)](#webapp-browse--edit--analytics)
- [How it works](#how-it-works)
- [Project status](#project-status)
- [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 (GitHub Actions)](#automation-github-actions)
- [Automation](#automation)
- [Data fields](#data-fields)
- [Contributing](#contributing)
- [Connect / support](#connect--support)
- [License](#license)
- [Legal](#legal)
## Browse by genre
## Browse the catalog
Tables are auto-generated and split by primary genre (max 300 games per file). New genres appear automatically as games
are added.
Everything lives on the website, **<https://freeitchgames.win>**:
- [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)
- [Platformer](lists/platformer.md)
- [Other](lists/other.md)
- *(more genres auto-create as needed)*
- **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.
- **Made for every way of browsing.** Everything works with the keyboard alone and with screen readers,
colours meet the WCAG contrast ratios in both themes, every chart has a data table, and the site
follows your system's reduced-motion and contrast settings. What works, the known gaps and how to
report a barrier: [ACCESSIBILITY.md](ACCESSIBILITY.md).
## Webapp (browse + edit + analytics)
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.
A React + TypeScript SPA in [`webapp/`](webapp/) provides a browsable UI on top of the same JSON
catalog: virtualized DataTable for all 500+ games, faceted filters (genre / status / platforms /
NSFW), 16 charts (Recharts), bulk edit/delete via the GitHub Git Data API, and a one-click "add"
flow that dispatches the scraper workflow with a URL input.
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.
- **Web build**: deployed to GitHub Pages by [`.github/workflows/deploy_webapp.yml`](.github/workflows/deploy_webapp.yml)
— pushes to `main` that touch `webapp/` ship automatically. (One-time setup: repo
Settings → Pages → Source = "GitHub Actions".)
- **Desktop build (optional)**: same React code wraps as a Tauri 2 native app for Windows / macOS
/ Linux. See [`webapp/TAURI.md`](webapp/TAURI.md) for prerequisites and `npm run tauri:dev`.
Multi-platform installers are built by [`.github/workflows/release_desktop.yml`](.github/workflows/release_desktop.yml)
on tag push (`v*`).
- **Auth**: a fine-grained PAT with `contents:write` + `workflow:write` is encrypted in
localStorage with a passphrase (AES-GCM, PBKDF2-SHA256). Decrypted token only lives in memory.
Reads are public (no auth needed).
- **Edits commit as `chore(webapp): …`** so they're easy to filter from the daily scraper
commits.
(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.)
Local dev:
## Desktop and Android apps
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):
| 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) |
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).
### Android (download & install)
No Play Store: just grab the `.apk` and sideload it (Android is fine with this, it just asks nicely first):
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 install
npm run dev # http://localhost:5173
npm run build # writes to docs/app/
npm run tauri:dev # native desktop (requires Rust)
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)
```
## How it works
```
temp_link.json → update_info.py → data_game/
(new URLs added here) (scrape + free check) game_info_001.json
game_info_002.json ...
│
┌─────────────────────────────────────────┘
▼ ▼
generate_md.py check_paid.py
(MD tables) check_alive.py
(cleanup)
```
1. **Add links** — paste itch.io URLs into `scripts/temp_link.json` (manually, via PR, or via the companion browser
extension).
2. **Daily scrape** — GitHub Actions runs `update_info.py` at 03:00 UTC. Each link is fetched, checked for free status,
and scraped for metadata. Paid games are automatically skipped.
3. **Generate tables** — `generate_md.py` groups games by primary genre and outputs markdown tables into `/lists/`.
4. **Periodic cleanup** — every 2 days, `check_paid.py` re-checks if any game in the list became paid, and
`check_alive.py` verifies that game pages still exist. Removed games are logged with a reason.
## Project structure
```
data_game/ # Game database (chunked JSON, max 500 per file)
data_game/ # Catalog (chunked JSON, max 500 per file) + LICENSE.md (CC BY 4.0)
├── game_info_001.json
├── game_info_002.json
└── ...
├── ...
├── index.json # Chunk manifest (total + per-file counts)
└── count_history.json # Daily totals for the "games over time" chart
scripts/
├── scraper.py # Shared module: session, rate-limiting, free detection, parsing
├── data_store.py # Shared module: multi-file load/save/rebalance
├── update_info.py # Scrape new games from temp_link.json → data_game/
├── check_paid.py # Re-check existing games for paid status
├── check_alive.py # Verify game URLs still exist (404/410 → remove)
├── generate_md.py # Generate per-genre markdown tables
├── log_deleted.py # Export deleted_games.json → deleted_games.txt
├── temp_link.json # Input queue for new URLs
└── deleted_games.json # Log of removed games with reasons
├── 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/
├── test.sh # Wrapper: scrape + reset temp_link
├── table.sh # Wrapper: generate MD tables
├── check_paid.sh # Wrapper: check paid status
├── check_alive.sh # Wrapper: check dead links
└── log_deleted.sh # Wrapper: export deletion log
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
lists/ # Auto-generated markdown tables (one per genre)
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
.github/workflows/
├── update.yml # Daily 03:00 UTC — scrape new games
│ # (also accepts an optional `url` input from webapp)
├── generate_table.yml # Runs after update/check workflows
├── check_paid.yml # Every 2 days 04:00 UTC
├── check_alive.yml # Every 2 days 07:00 UTC
├── log_deleted.yml # Runs after check workflows
├── deploy_webapp.yml # Build webapp/ → GitHub Pages on push to main
└── release_desktop.yml # Build Tauri installers (Win/macOS/Linux) on v* tag
webapp/ # React + TS SPA + Tauri desktop wrapper
├── src/ # React app (routes, components, hooks, stores)
├── src-tauri/ # Rust + Tauri 2 config (icons, capabilities, main.rs)
├── TAURI.md # Desktop build prerequisites and instructions
├── package.json
├── vite.config.ts
└── tailwind.config.ts
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 (GitHub Actions)
## Automation
| Workflow | Schedule | Purpose |
|--------------------|------------------------|-------------------------------------------------------------|
| Update game info | Daily 03:00 UTC | Scrape new links from `temp_link.json` (+ optional `url` input from webapp), skip paid |
| Generate tables | After update/checks | Rebuild markdown tables in `/lists/` |
| Check paid games | Every 2 days 04:00 UTC | Remove games that became paid |
| Check dead links | Every 2 days 07:00 UTC | Remove 404/410 game pages |
| Log deleted games | After check workflows | Export deletion log to `deleted_games.txt` |
| Deploy webapp | On push to main | Build `webapp/` → GitHub Pages (`docs/app/`) |
| Release desktop | On `v*` tag push | Build Tauri installers (Win/macOS/Linux) → draft Release |
| 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 |
| Code analysis (`sonarcloud.yml`, `qodana.yml`) | Pull requests and pushes to `main` that change code | SonarQube Cloud (with test coverage) and Qodana (TypeScript / JavaScript, Python, Rust) |
| 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 |
All workflows include rate-limiting (random delays, batch pauses) to avoid being blocked by itch.io. Network errors are
treated as transient — games are only removed on confirmed 404/410 or confirmed paid status.
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 entry in `data_game/game_info_NNN.json` contains:
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` | Short description (first sentence, max 200 chars) |
| `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 |
@@ -174,25 +293,33 @@ Each game entry in `data_game/game_info_NNN.json` contains:
| `average_session` | Typical play session length |
| `languages` | Supported languages |
| `inputs` | Input methods (keyboard, mouse, gamepad) |
| `nsfw` | NSFW flag (auto-detected from tags, warnings, description) |
| `safe_virus` | Manual safety note (default: `?`) |
| `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` | Thumbnail image URL |
| `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`, …) |
All fields default to `N/A` when not available on the game page.
Scraped fields default to `N/A` when not available on the game page.
## Contributing
See [CONTRIBUTING.md](./CONTRIBUTING.md) for full details.
See [CONTRIBUTING.md](CONTRIBUTING.md) for the full guide.
- **Add games** — use the "Add New Games" issue template (max 50 links per issue).
- **Add games via Telegram bot** — alternative path for batch submissions through
[@my_skull_bot](https://t.me/my_skull_bot); DM the owner to be whitelisted.
Full flow + privacy notes: [CONTRIBUTING §1b](CONTRIBUTING.md#1b-add-games-via-telegram-bot-my_skull_bot--alternative-to-issues)
· Bot repo: [poli0981/telegram-scraper-bot](https://github.com/poli0981/telegram-scraper-bot)
([USER_GUIDE.md](https://github.com/poli0981/telegram-scraper-bot/blob/main/docs/USER_GUIDE.md)).
- **Report bugs** — use the "Bug Report" template.
- **Request features** — open an issue or submit a PR.
- **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 a problem**: wrong data, a dead link, or something broken on the site or in the apps: use the
"Report a problem" issue template.
- **Accessibility barriers**: use the ["Accessibility barrier" issue template](https://github.com/poli0981/free-games-itchio-list/issues/new?template=accessibility.yml) or email
contact@poli0981.dev. See [ACCESSIBILITY.md](ACCESSIBILITY.md).
- **Features and code changes**: not accepted any more, the project is in
[maintenance mode](#project-status). Questions and feedback are welcome in
[Discussions](https://github.com/poli0981/free-games-itchio-list/discussions).
- **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).
@@ -201,21 +328,65 @@ Maintainer hardware + dev environment: [`docs/pc_spec.md`](docs/pc_spec.md), [`d
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)
- **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) · [Telegram bot — game submission](https://t.me/my_skull_bot) (DM your numeric ID privately, never in public channels)
- **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 slow, introvert max level. The About page in the [webapp](https://poli0981.github.io/free-games-itchio-list/app/#/about) has the same list with one-click buttons.
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
- [Disclaimer](docs/DISCLAIMER.md)
- [Terms of Use](docs/ToS.md): covers the website and everything on it
- [Privacy Policy](docs/PrivacyPolicy.md)
- [Terms of Service](docs/ToS.md)
- [EULA](docs/EULA.md)
- [Code of Conduct](./CODE_OF_CONDUCT.md)
- [Security](./SECURITY.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)
- [Accessibility statement](ACCESSIBILITY.md): what works with assistive technology, known gaps, how to report a barrier
- [NOTICE](NOTICE.md)
Licensed under [MIT](LICENSE).
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/)
+258 -82
View File
@@ -1,131 +1,307 @@
# Danh sách Game Itch.io Miễn Phí
[![Version](https://img.shields.io/badge/version-3.6.1-blue.svg)](https://github.com/poli0981/free-games-itchio-list/)
[![License: MIT](https://img.shields.io/badge/license-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Version](https://img.shields.io/badge/version-4.6.2-blue.svg)](https://github.com/poli0981/free-games-itchio-list/releases/latest)
[![Trạng thái: ổn định, chỉ bảo trì](https://img.shields.io/badge/status-stable%20%C2%B7%20maintenance%20only-brightgreen.svg)](#trạng-thái-dự-án)
[![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)
[![Python CI](https://github.com/poli0981/free-games-itchio-list/actions/workflows/python-ci.yml/badge.svg?branch=main)](https://github.com/poli0981/free-games-itchio-list/actions/workflows/python-ci.yml)
[![Quality gate](https://sonarcloud.io/api/project_badges/measure?project=poli0981_free-games-itchio-list&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=poli0981_free-games-itchio-list)
[![Coverage](https://sonarcloud.io/api/project_badges/measure?project=poli0981_free-games-itchio-list&metric=coverage)](https://sonarcloud.io/summary/new_code?id=poli0981_free-games-itchio-list)
[![Qodana](https://github.com/poli0981/free-games-itchio-list/actions/workflows/qodana.yml/badge.svg?branch=main)](https://github.com/poli0981/free-games-itchio-list/actions/workflows/qodana.yml)
[![Trợ năng: mục tiêu WCAG 2.2 AA](https://img.shields.io/badge/accessibility-WCAG%202.2%20AA%20target-informational.svg)](docs/i18n/vi/ACCESSIBILITY.md)
[![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)
> Đây là bản dịch tiếng Việt mang tính tham khảo cho cộng đồng. Bản tiếng Anh tại [`README.md`](README.md) là bản chính thức cho mọi điều khoản pháp lý / kỹ thuật.
> Bản dịch từ bản tiếng Anh cập nhật ngày 2026-11-11 (English source revision 2026-11-11). 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 duy trì tự động của các game miễn phí trên [itch.io](https://itch.io). Game được cào (scrape), xác thực và tổ chức thành các bảng markdown có thể duyệt — cập nhật hàng ngày qua GitHub Actions.
Một danh mục được tuyển chọn và tự động cập nhật gồm **hơn 6,000 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.
## Trạng thái dự án
**Ổn định, chỉ bảo trì** (từ phiên bản 4.6.1, 2026-11-11). Dự án đã đủ tính năng: website, các ứng dụng và pipeline dữ liệu vẫn chạy, danh mục vẫn tự cập nhật mỗi ngày.
- **Những gì vẫn được làm**: vá bảo mật (CVE và báo cáo gửi qua [SECURITY](docs/i18n/vi/SECURITY.md)), cập nhật runtime và thư viện phụ thuộc (Node.js, Python, Rust, gói npm / pip / cargo, GitHub Actions), và sửa khi có gì đó làm website hoặc việc cập nhật dữ liệu hằng ngày ngừng chạy.
- **Những gì không còn làm**: tính năng mới, thiết kế lại, refactor. Đề xuất tính năng và pull request về code sẽ bị đóng mà không review.
- **Issue và pull request chỉ dành cho dữ liệu**: thêm game, sửa dữ liệu của một game, gỡ game. Xem [Đóng góp](#đóng-góp).
## Mục lục
- [Duyệt theo thể loại](#duyệt-theo-thể-loại)
- [Webapp (duyệt + sửa + analytics)](#webapp-duyệt--sửa--analytics)
- [Cách hoạt động](#cách-hoạt-động)
- [Trạng thái dự án](#trạng-thái-dự-án)
- [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 (GitHub Actions)](#tự-động-hóa-github-actions)
- [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 theo thể loại
## Duyệt danh mục
Các bảng được tự tạo và chia theo thể loại chính (tối đa 300 game / file). Thể loại mới sẽ tự xuất hiện khi có game được thêm vào.
Mọi thứ nằm trên website **<https://freeitchgames.win>**:
- [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)
- [Platformer](lists/platformer.md)
- [Other](lists/other.md)
- *(các thể loại khác sẽ tự tạo khi cần)*
- **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.
- **Dành cho mọi cách duyệt web.** Mọi thứ dùng được chỉ với bàn phím và với trình đọc màn hình, màu sắc đạt tỉ lệ tương phản WCAG ở cả hai giao diện, mỗi biểu đồ có bảng dữ liệu, và site làm theo thiết lập giảm chuyển động và tương phản của hệ thống. Những gì đã hỗ trợ, các hạn chế đã biết và cách báo rào cản: [Trợ năng](docs/i18n/vi/ACCESSIBILITY.md) ([EN](ACCESSIBILITY.md)).
## Webapp (duyệt + sửa + analytics)
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.
Một SPA React + TypeScript trong [`webapp/`](webapp/) cung cấp giao diện duyệt trên cùng catalog JSON: DataTable virtualized cho 500+ game, faceted filter (thể loại / trạng thái / nền tảng / NSFW), 16 chart (Recharts), bulk edit/delete qua GitHub Git Data API, và một flow "add" một-click dispatch workflow scraper với input URL.
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.
- **Bản web**: deploy lên GitHub Pages bởi [`.github/workflows/deploy_webapp.yml`](.github/workflows/deploy_webapp.yml) — push vào `main` chạm `webapp/` sẽ tự ship. (Setup một lần: repo Settings → Pages → Source = "GitHub Actions".)
- **Bản desktop (tùy chọn)**: cùng code React đóng gói thành app native Tauri 2 cho Windows / macOS / Linux. Xem [`webapp/TAURI.md`](webapp/TAURI.md) để biết yêu cầu và `npm run tauri:dev`.
- **Auth**: PAT fine-grained với `contents:write` + `actions:write` được mã hóa AES-GCM trong localStorage (PBKDF2-SHA256). Token đã giải mã chỉ tồn tại trong bộ nhớ.
- **Edit commit dạng `chore(webapp): …`** để dễ lọc khỏi commit của scraper hàng ngày.
(Đị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.)
Dev cục bộ:
## Ứ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 install
npm run dev # http://localhost:5173
npm run build # ghi vào docs/app/
npm run tauri:dev # native desktop (cần Rust)
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ách hoạt động
```
temp_link.json → update_info.py → data_game/
(URL mới thêm vào đây) (scrape + check free) game_info_001.json
game_info_002.json ...
│
┌─────────────────────────────────────────┘
▼ ▼
generate_md.py check_paid.py
(bảng MD) check_alive.py
(cleanup)
```
1. **Thêm link** — dán URL itch.io vào `scripts/temp_link.json` (thủ công, qua PR, hoặc qua extension trình duyệt đi kèm).
2. **Scrape hàng ngày** — GitHub Actions chạy `update_info.py` lúc 03:00 UTC. Mỗi link được fetch, kiểm tra trạng thái free và cào metadata. Game trả phí tự bị bỏ qua.
3. **Tạo bảng** — `generate_md.py` nhóm game theo thể loại chính và xuất các bảng markdown vào `/lists/`.
4. **Cleanup định kỳ** — mỗi 2 ngày, `check_paid.py` kiểm tra lại game nào đã chuyển sang trả phí, và `check_alive.py` xác minh các trang game còn tồn tại. Game bị gỡ được log kèm lý do.
## Cấu trúc dự án
Xem [`README.md`](README.md#project-structure) phiên bản tiếng Anh để có sơ đồ thư mục đầy đủ và mới nhất.
```
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"
## Tự động hóa (GitHub Actions)
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
| Workflow | Lịch | Mục đích |
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 |
|---|---|---|
| Update game info | Hàng ngày 03:00 UTC | Scrape link mới từ `temp_link.json` (+ input `url` tùy chọn từ webapp), bỏ qua game trả phí |
| Generate tables | Sau update/checks | Build lại các bảng markdown trong `/lists/` |
| Check paid games | Mỗi 2 ngày 04:00 UTC | Gỡ game đã chuyển sang trả phí |
| Check dead links | Mỗi 2 ngày 07:00 UTC | Gỡ trang game 404/410 |
| Log deleted games | Sau check workflows | Xuất log gỡ ra `deleted_games.txt` |
| Deploy webapp | Khi push vào main | Build `webapp/` → GitHub Pages (`docs/app/`) |
| Release desktop | Khi push tag `v*` | Build installer Tauri (Win/macOS/Linux) → draft Release |
| 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 |
| Phân tích code (`sonarcloud.yml`, `qodana.yml`) | Pull request và push vào `main` có đổi code | SonarQube Cloud (kèm test coverage) và Qodana (TypeScript / JavaScript, Python, Rust) |
| 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 |
Tất cả workflow có rate-limit (delay ngẫu nhiên, batch pause) để tránh bị itch.io block. Lỗi mạng được coi là tạm thời — game chỉ bị gỡ khi xác nhận 404/410 hoặc xác nhận trả phí.
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.vi](docs/i18n/vi/CONTRIBUTING.md) (hoặc [bản tiếng Anh CONTRIBUTING.md](CONTRIBUTING.md) cho bản chính thức).
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 issue template "Add New Games" (tối đa 50 link / issue).
- **Thêm game qua Telegram bot** — đường thay thế cho batch submissions qua
[@my_skull_bot](https://t.me/my_skull_bot); DM owner để được whitelist.
Flow đầy đủ + ghi chú riêng tư: [CONTRIBUTING §1b](docs/i18n/vi/CONTRIBUTING.md#1b-th%C3%AAm-game-qua-telegram-bot-my_skull_bot--thay-th%E1%BA%BF-cho-issue)
· Repo bot: [poli0981/telegram-scraper-bot](https://github.com/poli0981/telegram-scraper-bot)
([USER_GUIDE.md](https://github.com/poli0981/telegram-scraper-bot/blob/main/docs/USER_GUIDE.md)).
- **Báo bug** — dùng template "Bug Report".
- **Đề xuất tính năng** — mở issue hoặc gửi PR.
- **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 sự cố**: dữ liệu sai, link chết, hoặc có gì đó hỏng trên website hay trong ứng dụng: dùng issue template "Report a problem".
- **Rào cản trợ năng**: dùng [issue template "Accessibility barrier"](https://github.com/poli0981/free-games-itchio-list/issues/new?template=accessibility.yml) hoặc gửi email tới contact@poli0981.dev. Xem [Trợ năng](docs/i18n/vi/ACCESSIBILITY.md) ([EN](ACCESSIBILITY.md)).
- **Tính năng và thay đổi code**: không còn được nhận, dự án đang ở [chế độ bảo trì](#trạng-thái-dự-án). Câu hỏi và góp ý xin gửi vào [Discussions](https://github.com/poli0981/free-games-itchio-list/discussions).
- **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 maintainer + môi trường dev: [`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)).
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)
- **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)
- **Messaging**: [Telegram (DM)](https://t.me/SkullMute0011) · [Telegram bot — gửi game](https://t.me/my_skull_bot) (DM numeric ID riêng tư, đừng đăng kênh chung)
- **Hỗ trợ** (hoàn toàn tùy chọn, mirror [`.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)
- **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ở khắp nơi — trả lời chậm, introvert max level. Trang About trong [webapp](https://poli0981.github.io/free-games-itchio-list/app/#/about) có cùng danh sách dạng nút bấm.
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ý.
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ý.
- [Disclaimer](docs/i18n/vi/DISCLAIMER.md) ([EN](docs/DISCLAIMER.md))
- [Privacy Policy](docs/i18n/vi/PrivacyPolicy.md) ([EN](docs/PrivacyPolicy.md))
- [Terms of Use](docs/i18n/vi/ToS.md) ([EN](docs/ToS.md))
- [EULA](docs/i18n/vi/EULA.md) ([EN](docs/EULA.md))
- [Code of Conduct](docs/i18n/vi/CODE_OF_CONDUCT.md) ([EN](CODE_OF_CONDUCT.md))
- [Security](docs/i18n/vi/SECURITY.md) ([EN](SECURITY.md))
- [Đ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))
- [Tuyên bố trợ năng (Accessibility)](docs/i18n/vi/ACCESSIBILITY.md) ([EN](ACCESSIBILITY.md)): những gì đã hỗ trợ cho công cụ trợ năng, các hạn chế đã biết, cách báo rào cản
- [NOTICE](NOTICE.md)
Cấp phép theo [MIT](LICENSE).
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/)
+75 -37
View File
@@ -1,54 +1,92 @@
# Security Policy
Last updated: 2026-05-04
Last updated: 2026-11-11
Yo, this is mostly a hobby repo — a curated list of free itch.io games with Python scraping scripts on GitHub Actions, plus a React/TypeScript webapp (and Tauri desktop wrapper) for browsing and editing the catalog. Still no backend, no database, no telemetry. The one security-relevant thing is the GitHub Personal Access Token the webapp can hold for write operations — see below.
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.
- Webapp deps (npm/Rust)? Dependabot/security alerts on the repo cover those — bumps land via PR.
A good report includes:
## Webapp PAT handling (read this if you use the writeable webapp)
- 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.
The browse-only flows (Dashboard, Games table, Charts, Deleted) need **no** auth and use the public CDN at `raw.githubusercontent.com`. Write flows (edit annotations, bulk edit/delete, dispatch the scraper workflow) need a GitHub Personal Access Token, which the webapp stores like this:
## 2. Scope
- **Use a fine-grained PAT** scoped to **only** `poli0981/free-games-itchio-list` with the minimum scopes you need:
- `contents: write` — required for edits / deletes / queueing URLs.
- `actions: write` — required for the Add page / Workflows page dispatch buttons.
- `metadata: read` is implicit.
- **At rest** the PAT is encrypted with AES-GCM 256-bit; the key is derived from your passphrase via PBKDF2-SHA256 (100k iterations) with a fresh per-token salt. The encrypted blob lives in `localStorage` under `webapp.pat.encrypted`.
- **In memory** the decrypted PAT only exists in the React app's Zustand store between unlock and explicit Lock (or tab close).
- **Lock or remove anytime** from Settings. Removing also wipes the localStorage entry.
- **Don't paste a classic PAT** with full repo scope unless you really mean to. Fine-grained tokens are scoped to one repo and one set of operations.
- **Don't share `localStorage`** between users (e.g., shared kiosk machine). The encryption protects the PAT from a casual file-system reader, not from someone who knows your passphrase.
**In scope**
If you find a way to bypass the encryption, exfiltrate the PAT from memory through a CSP gap, or trick the webapp into sending writes to the wrong repo — please report privately as above.
- 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.
## Web/desktop dependency reporting
**Out of scope**
For Tauri / Rust crate vulnerabilities or npm package CVEs that affect the webapp, opening a normal `[Security]` issue is fine; if it's actively exploitable in the deployed Pages site, please prefix `[CRITICAL]` so I can yank the deploy until it's fixed.
- 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.
No bounties (bank account < $50), but eternal thanks and a shoutout.
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.
This repo is MIT licensed and super low-risk. Stay safe out there — especially when downloading random free games.
## 3. Supported versions
Thanks for reporting responsibly. You're better at security than me already. 🚀
| 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.
Since version 4.6.1 the project is in **maintenance mode**: no new features, but security fixes and runtime and dependency updates continue as described here.
## 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 website limits how many requests one address can send in a short time (a Cloudflare WAF rule, then per-route limits in the Worker that answer HTTP 429), and the Suggest form adds Cloudflare Turnstile and a stricter limit of its own.
- 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."
-12
View File
@@ -1,12 +0,0 @@
#!/bin/bash
set -euo pipefail
pip install --quiet beautifulsoup4 requests
python scripts/check_alive.py
git config --global user.name "github-actions[bot]"
git config --global user.email "41898282+github-actions[bot]@users.noreply.github.com"
git add data_game/ scripts/deleted_games.json
git diff --staged --quiet && echo "No changes – skip commit" \
|| (git commit -m "Remove dead game links [$(date +'%Y-%m-%d')]" && git push)
-12
View File
@@ -1,12 +0,0 @@
#!/bin/bash
set -euo pipefail
pip install --quiet beautifulsoup4 requests
python scripts/check_paid.py
git config --global user.name "github-actions[bot]"
git config --global user.email "41898282+github-actions[bot]@users.noreply.github.com"
git add data_game/ scripts/deleted_games.json
git diff --staged --quiet && echo "No changes – skip commit" \
|| (git commit -m "Remove paid games [$(date +'%Y-%m-%d')]" && git push)
+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
-20
View File
@@ -1,20 +0,0 @@
#!/bin/bash
set -euo pipefail
pip install --quiet beautifulsoup4 requests
# INPUT_URL is passed through from the workflow_dispatch input.
python scripts/force_update.py
git config --global user.name "github-actions[bot]"
git config --global user.email "41898282+github-actions[bot]@users.noreply.github.com"
git add data_game/
if [[ -n "${INPUT_URL:-}" ]]; then
msg="Force update ${INPUT_URL} [$(date +'%Y-%m-%d')]"
else
msg="Force update [$(date +'%Y-%m-%d')]"
fi
git diff --staged --quiet && echo "No changes – skip commit" \
|| (git commit -m "${msg}" && git push)
-10
View File
@@ -1,10 +0,0 @@
#!/bin/bash
set -euo pipefail
python scripts/log_deleted.py
git config --global user.name "github-actions[bot]"
git config --global user.email "41898282+github-actions[bot]@users.noreply.github.com"
git add deleted_games.txt scripts/deleted_games.json
git diff --staged --quiet && echo "No changes – skip commit" \
|| (git commit -m "Update deleted games log [$(date +'%Y-%m-%d')]" && git push)
-12
View File
@@ -1,12 +0,0 @@
#!/bin/bash
set -euo pipefail
python scripts/generate_md.py
ls -la lists/*.md
git config --global user.name "github-actions[bot]"
git config --global user.email "41898282+github-actions[bot]@users.noreply.github.com"
git add lists/
git diff --staged --quiet && echo "No changes – skip commit" \
|| (git commit -m "Update game tables [$(date +'%Y-%m-%d')]" && git push)
-17
View File
@@ -1,17 +0,0 @@
#!/bin/bash
set -euo pipefail
pip install --quiet beautifulsoup4 requests
python scripts/update_info.py
echo "Game info has been updated."
# Reset temp links
echo "[]" > scripts/temp_link.json
echo "Temporary link file has been reset."
git config --global user.name "github-actions[bot]"
git config --global user.email "41898282+github-actions[bot]@users.noreply.github.com"
git add data_game/ scripts/temp_link.json
git diff --staged --quiet && echo "No changes – skip commit" \
|| (git commit -m "Update game info [$(date +'%Y-%m-%d')]" && git push)
-12
View File
@@ -1,12 +0,0 @@
#!/bin/bash
set -euo pipefail
pip install --quiet beautifulsoup4 requests
python scripts/update_reviews.py
git config --global user.name "github-actions[bot]"
git config --global user.email "41898282+github-actions[bot]@users.noreply.github.com"
git add data_game/
git diff --staged --quiet && echo "No changes – skip commit" \
|| (git commit -m "Update reviews [$(date +'%Y-%m-%d')]" && git push)
-12
View File
@@ -1,12 +0,0 @@
#!/bin/bash
set -euo pipefail
pip install --quiet beautifulsoup4 requests
python scripts/update_status.py
git config --global user.name "github-actions[bot]"
git config --global user.email "41898282+github-actions[bot]@users.noreply.github.com"
git add data_game/
git diff --staged --quiet && echo "No changes – skip commit" \
|| (git commit -m "Update status [$(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.
+192
View File
@@ -0,0 +1,192 @@
# Changelog — 4.4.x
Release notes for 4.4.0 to 4.4.3, newest first. Every version: [CHANGELOG.md](../../CHANGELOG.md).
## [4.4.3] - 2026-10-26 (Dependency and security updates)
A maintenance release: nothing changes on the site or in the apps. It brings the week's dependency
updates and closes the open security advisories in the project's build tools.
### Upgrade notes
- **Nothing to accept again**: no policy changed.
- **Desktop and Android apps**: install 4.4.3 over 4.4.2 as usual.
### Security
- **Build tools**: wrangler's local development server (miniflare) pins `undici` 7.29.1, which has
three advisories (GHSA-xjj6-f33q-929c, high; GHSA-4qv8-2p9j-2685 and GHSA-f72v-6w45-q472,
moderate). An npm `overrides` entry lifts it to 7.30.1 until miniflare does so itself. `zod`,
which the lint tools use, moves to 4.6.7 (GHSA-mrhx-c7xc-m3w5). Neither package is part of the site,
the Worker or the apps; `npm audit` now reports none.
- **Desktop and Android apps**: the Rust dependencies are refreshed, among them `tokio` 1.54.1
(RUSTSEC-2026-0386) and a `yoke-derive` release that replaces a yanked one. `cargo audit` reports no
vulnerabilities; its remaining warnings are on Linux libraries that Tauri depends on (`glib`, the
`zbus` family), which have no fixed release yet.
### Changed
- **Code scanning** (#157): SonarQube Cloud analyses the repository in CI instead of its automatic
analysis, and imports the test coverage of the Python and TypeScript suites.
- **Dependencies** (the updates of Dependabot #159–#163, and a few more): React Router 8.5.0,
TanStack Query 5.104.5, jose 6.2.13, lucide-react 1.61.0, Zustand 5.0.16, Vite 8.3.5,
wrangler 4.152.0 (its generated Worker types refreshed), ESLint 10.13.0, typescript-eslint 8.72.0,
knip 6.42.1 (it now follows the stylesheet's imports, so its config no longer has to exempt
Tailwind), the Tauri CLI 2.12.4 and the `tauri` crate 2.12.5; Ruff 0.17.2, coverage 7.17.0 and
certifi 2026.10.23 for the pipeline; `actions/setup-python` 7.1.0 in the workflows.
## [4.4.2] - 2026-10-22 (Toolchain upgrade, code-scan fixes)
A maintenance release: nothing you would notice changes on the site or in the apps. The project now
builds with TypeScript 7, Node 26 and Python 3.15, and the issues a SonarQube Cloud scan of the
repository reported are fixed — the one that mattered was a path check in the Worker's not-found
handler that a crafted address could make expensive.
### Upgrade notes
- **Nothing to accept again**: no policy changed.
- **Desktop and Android apps**: install 4.4.2 over 4.4.1 as usual.
- **Building or running your own copy?** Use Node 26 for the web app and Python 3.15 for the
pipeline. The Python dependencies are now pinned with hashes: `pip install -r requirements-dev.txt`
works as before; to change one, edit `requirements.in` or `requirements-dev.in` and recompile with
pip-tools (the command is at the top of each file).
### Fixed
- **Worker**: trailing slashes on request paths (not-found handler, admin routes, the Access issuer)
and the verification cookie's base64 padding are trimmed by a loop instead of a regular expression
that backtracked — a path with a long run of slashes cost quadratic CPU time on a public route. The
itch.io feed and collection parsers lost three more expressions of that kind; a collection link's
attributes are now read by splitting on quotes.
- **Pipeline**: itch.io's two mature-content notices are matched by one CSS selector, so either of
them still marks a game NSFW (each now has a test). A few checks are written out so the scanner can
follow them, without a change in behaviour, and the scraper no longer sets up plain-http requests
(every page it fetches is https).
### Changed
- **Build tooling** (#149, #154): TypeScript 7.0, the native compiler, runs the type check, with the
6.0 API installed beside it for typescript-eslint. Node 26 builds the web app and the release apps,
and npm runs only the install scripts of esbuild and workerd. Python 3.15 runs the pipeline (UTF-8
mode is now the default); its CI pin moved to `.github/python-version`, out of Dependabot's way.
- **Supply chain**: the pipeline's Python dependencies, indirect ones included, are locked with hashes
(`requirements.txt`, `requirements-dev.txt`, compiled from `requirements*.in`) and installed from
wheels only, so a new release of a dependency can no longer slip into the jobs that commit to the
catalog. CI and the release builds install npm packages with `--ignore-scripts`, and the Workers
config check runs the project's own wrangler (`npm run cf:check`).
- **Code scanning**: `.sonarcloud.properties` keeps the saved itch.io test pages out of the scan;
the maintainer's `i18n-edit` script reads its operations from stdin instead of a file path.
- **Dependencies**: React 19.3.1 (#141), TanStack Query 5.104.4 (#142, #150), Radix UI primitives
(#143), `@tauri-apps/api` 2.12.4, CLI 2.12.3 and `plugin-opener` 2.7.2 (#144) with the matching
crates `tauri-build` 2.7.3, `tauri-plugin-opener` 2.7.2 and `tauri-plugin-single-instance` 2.5.4
(#146), lucide-react 1.59.0 (#152), Vitest 5.0.5 (#153), Ruff 0.17.1 and Pillow 13 (#147),
`actions/setup-java` 6.1.0 and `dtolnay/rust-toolchain` in the release workflows (#148).
## [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.
+44
View File
@@ -0,0 +1,44 @@
# Changelog — 4.5.x
Release notes for 4.5.0, newest first. Every version: [CHANGELOG.md](../../CHANGELOG.md).
## [4.5.0] - 2026-10-27 (Rate limits for the whole site)
The website now limits how many requests one connection can send in a short time, on every page,
cover image and API address — not only on the Suggest form and the verification check. Normal
browsing never comes close to the limits; a script that floods the site gets HTTP 429 ("Too many
requests") and has to wait a minute. Nothing changes in the desktop and Android apps.
### Upgrade notes
- **Nothing to accept again**: no policy changed. The Privacy Policy already says that your IP
address is used, without being stored, to count requests and limit abuse.
- **Desktop and Android apps**: install 4.5.0 over 4.4.3 as usual; they don't use the limited
addresses (4.0–4.1.1 count against the site limit when they read the old catalog files).
### Added
- **Per-connection limits in the Worker**: every request that runs the site's server code counts,
per minute and per address (an IPv6 connection by its /64): 120 for pages, the public API and the
catalog files of the old apps, 600 for cover images (a Games page shows up to 100), 300 for the
admin. The Suggest form (5 a minute) and the verification check (20 a minute) keep their own,
stricter limits on top. Search engines that Cloudflare has verified are not counted.
- **The "Too many requests" answer**: pages get a short page in English or Vietnamese (no scripts),
the API and cover images a JSON `{"error":"rate_limited"}`; both say when to retry
(`Retry-After: 60`) and are never cached. The admin shows "Too many requests from this connection".
- **A first layer in front of the Worker**: the maintainer's runbook (`docs/operations.md`, section 1
step 15) sets up a Cloudflare WAF rate-limiting rule that blocks floods before they reach the site's
code, and covers the static files the Worker never sees. The Worker's own counts are approximate
(Cloudflare counts them per server and syncs them late), so the WAF rule is what holds against a
flood that opens a new connection for every request.
### Fixed
- **Suggest and verification limits counted other sites too**: a rate limit's namespace is shared by
every Worker of the Cloudflare account, and the two existing limits used the same numbers as other
Workers there, so their visits could use up this site's Suggest or verification allowance. All of
this site's limits now have namespaces of their own.
### Changed
- **Security policy**: says how the site limits requests (EN + VI); no new obligations.
+173
View File
@@ -0,0 +1,173 @@
# Changelog — 4.6.x
Release notes for 4.6.0 – 4.6.2, newest first. Every version: [CHANGELOG.md](../../CHANGELOG.md).
## [4.6.2] - 2026-11-16 (Dependency updates)
Update deps:
- **Desktop and Android apps**: wry 0.57.2 (Android crash and memory-leak fixes, macOS crash fixes,
a Windows focus fix), tauri-plugin-opener 2.7.3, and the other Rust crates (`cargo update`).
- **Website**: TanStack Query 5.107.1, Zustand 5.1.0, lucide-react 1.72.0, jose 6.2.17.
- **Data pipeline**: Soup Sieve 4.1.
- **Tooling**: Vite 8.3.8, @vitejs/plugin-react 6.3.0, Tailwind CSS 4.3.5, Wrangler 4.161.0,
typescript-eslint 8.72.2, knip 6.45.1, coverage 7.17.3, Ruff 0.17.5.
No policy changed: nothing to accept again.
## [4.6.1] - 2026-11-11 (Stable: maintenance mode)
The project is now **stable and in maintenance mode**. It is feature-complete: the website, the apps
and the data pipeline keep running, and the catalog keeps updating itself every day. Nothing changes
for visitors.
### What maintenance mode means
- **Still done**: security fixes (CVEs and reports made through [SECURITY.md](../../SECURITY.md)),
runtime and dependency updates (Node.js, Python, Rust, npm / pip / cargo packages, GitHub Actions),
and repairs when something stops the site or the daily data updates from working.
- **Not done any more**: new features, redesigns and refactors.
- **Issues and pull requests are for the data only**: adding games, fixing a game's data, removing a
game. Accessibility barriers and security reports keep their own channels
([ACCESSIBILITY.md](../../ACCESSIBILITY.md), [SECURITY.md](../../SECURITY.md)). Feature requests
and code pull requests are closed without review; questions and feedback are welcome in
[Discussions](https://github.com/poli0981/free-games-itchio-list/discussions).
### Upgrade notes
- **Nothing to accept again**: no policy changed.
- **Desktop and Android apps**: 4.6.1 behaves like 4.6.0. Install it over 4.6.0 if you want the
current version number; there is no need to.
### Added
- **Qodana (JetBrains) code analysis in CI** (`qodana.yml`): three jobs, one per Qodana Cloud
project — TypeScript / JavaScript (`webapp/`), Python (the data pipeline) and Rust (the Tauri
shell) — on pull requests and on pushes to `main` that change code. It runs next to SonarQube
Cloud and, like it, skips Dependabot and fork pull requests, which get no repository secrets.
All three projects start at 0 problems, and a new one fails its job.
- **Badges** in both READMEs: project status, Python CI, SonarQube Cloud quality gate and coverage,
Qodana, and the accessibility target.
### Changed
- **Docs for maintenance mode** (EN + VI): a "Project status" section in the READMEs, CONTRIBUTING
rewritten around the data-only scope, a note in SECURITY.md, and the runbook
([docs/operations.md](../../docs/operations.md)) with the Qodana setup.
- **Issue and pull request templates**: "Bug Report" became "Report a problem" (wrong data, or
something that broke); the Feature Request, Feedback and General templates and the Bug Fix, New
Feature and Documentation pull request templates are gone; the issue chooser points to
Discussions.
- **The README's game count**: 5,900+ (it still said 2,600+).
### Fixed
Findings of the first Qodana reports. None changes what the site or the apps do.
- **Pie charts no longer use Recharts' deprecated `Cell`** (removed in Recharts 4.0): each slice
takes its colour from its data entry. Colours and legends are unchanged.
- **React 19 types**: `ElementRef` → `ComponentRef` in the UI components, `FormEvent` →
`SubmitEvent` on the Suggest form, and a `React.` type used without an import.
- **Small cleanups**: an awaited `res.json()` in the Worker's data loader, a simpler regular
expression and return statement in the Games filters, and three Python nits in the pipeline (a
shadowed name and an untyped number format in `refresh.py`, a value assigned but never read in
`update_info.py`).
- **The Tauri shell no longer declares `serde_json`**, which its own code never used (Tauri still
brings it in).
## [4.6.0] - 2026-11-09 (Accessibility)
The website and the apps work better with a keyboard, a screen reader, Windows contrast themes and
reduced motion, and the project now has an accessibility statement,
[ACCESSIBILITY.md](../../ACCESSIBILITY.md) (in Vietnamese:
[docs/i18n/vi/ACCESSIBILITY.md](../../docs/i18n/vi/ACCESSIBILITY.md)). It says what works, what
doesn't yet, and how to report a barrier. The Maintainer had already tested the website and the
Windows app with the keyboard only and Windows Narrator; this release fixes the gaps a review against
WCAG 2.2 AA found.
### Upgrade notes
- **Nothing to accept again**: no policy changed. The accessibility statement isn't a policy you
accept, so the first-visit notice doesn't come back.
- **A new setting**: **Settings → Accessibility** turns off the "/" shortcut that jumps to the search
box (useful with speech input, or when the key clashes with a screen reader or your browser's quick
find).
- **Colours**: buttons and purple text are a shade darker, form fields have darker borders, and the
selected tab, the current page and the highlighted search suggestion are marked with an outline, an
underline or a bar. This brings the contrast up to WCAG 2.2 AA. The logo and the app icons are
unchanged.
- **Desktop and Android apps**: install 4.6.0 over 4.5.0 as usual.
### Added
- **Accessibility statement** ([ACCESSIBILITY.md](../../ACCESSIBILITY.md), EN + VI): the WCAG 2.2
AA target, what works, how it is tested, supported browsers and assistive technology, known
limitations, and how to report a barrier, with severity levels and response targets. It is
linked from the About page, the footer, Settings and the README.
- **Reporting a barrier**: an "Accessibility barrier" issue form (label `accessibility`), or email
contact@poli0981.dev, no GitHub account needed.
- **Charts you can read**: every chart is named after its heading, reads each value aloud as you
step through it with the left and right arrow keys, and has a **Data table** under it with the
same numbers (plus each part's share for pie charts).
- **Settings → Accessibility**: the "/" shortcut switch and a link to the statement.
- **A contrast check in CI**: a test fails if a colour token or a chart colour drops below the
WCAG 2.2 AA ratios.
- **A default pull request template** with an accessibility checklist.
### Changed
- **Focus follows the page**: after you follow a link inside the site, focus moves to the new page's
heading, so a screen reader announces it and Tab continues from there. Back returns focus to the
link you used, for example the game you opened from the list. Links to a section (About →
Support) move focus there too.
- **Contrast**: white text on buttons goes from 4.35 to 5.44:1, purple text from 4.2 to 5.2:1 (6.6:1
in dark mode), field borders and the off position of switches reach 3:1. Chart colours reach 3:1 on
the light theme too, treemap labels pick a readable colour per cell, and axis labels are readable
in dark mode. The Online/Offline chart is blue and orange, which colour-blind readers can tell
apart.
- **Windows contrast themes**: the selected tab, pressed toggles, the current page, the active
search suggestion and switches use the system's highlight colours, and chart text follows the
system text colour.
- **Screen readers hear more**: the number of search suggestions, loading states, rating counts,
filter counts ("Genre, 2 selected"), the reason and date of each removed game, and that a link
opens a new tab (in the apps: your browser). Card titles on the About and Charts pages are real
headings, and the game-not-found page and the 18+ notice have their own page titles.
- **Language**: text in the other language (the language names, the English-only names of the legal
documents) is marked as such, the page's language switches to Vietnamese only once the Vietnamese
text has loaded, and the Suggest page's anti-spam check uses the site's language.
- **Search box**: "See all results" can be reached with the arrow keys.
- **Suggest form**: the game link is checked when you leave the field or send the form, not at the
first keystroke, and the Send button stays reachable and says what is missing.
- **First-visit notice**: "Accept & continue" can be reached with Tab before the box is ticked
(pressing it moves you to the box), and focus moves to the page once you accept.
- **Links inside sentences are underlined.**
### Fixed
- **The 18+ dialog lost keyboard focus when it closed**; focus now returns to the button or switch
that opened it.
- **The sticky header could cover the element that had keyboard focus.**
- **Focus was lost** when the control you used disappeared: clearing the search, removing a filter,
"Clear" in a filter menu, "back to top".
- **Reduced motion**: looping loading animations now stop and "back to top" no longer scrolls
smoothly when your system asks for less motion.
- **Short screens**: the 18+ dialog, the phone menu and the display menu scroll instead of being cut
off.
- **Docs**: the catalog data license still listed the @freeitchgames.win addresses retired in 4.1.1;
the About page's "Content removal" link opened the YAML source of the issue form; some "Last
updated" dates, translation notes and library versions were behind.
### Dependencies
The two weekly updates since 4.5.0, which have been on the website since they were merged:
- **2026-11-02** (#176, Dependabot #171–#175 and a few more): React Router 8.5.1, TanStack Query
5.105.0, lucide-react 1.64.0, knip 6.44.0, typescript-eslint 8.72.1, wrangler 4.156.0 (its
generated Worker types refreshed), jose 6.2.14; the `undici` override dropped (wrangler's own
version now has the fix); pytest 9.2.0 and Ruff 0.17.3 for the pipeline;
`sonarqube-scan-action` 8.4.0; the Rust dependencies refreshed.
- **2026-11-09** (#182, Dependabot #177–#181 and a few more): TanStack Query 5.106.1, Vitest 5.1.0,
Vite 8.3.6, @vitejs/plugin-react 6.2.1, Tailwind CSS 4.3.4, ESLint 10.14.0, knip 6.44.1,
wrangler 4.158.0 (types refreshed), jose 6.2.15, globals 17.14.0, lucide-react 1.69.0;
soupsieve 4.0.1, coverage 7.17.2 and Ruff 0.17.4 for the pipeline; `actions/setup-java` 6.2.0 and
`sonarqube-scan-action` 8.4.1; the Rust dependencies refreshed (wasm-bindgen 0.2.130 and others).
+137
View File
@@ -0,0 +1,137 @@
# Catalog data license
Last updated: 2026-11-09
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@poli0981.dev** 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@poli0981.dev**.*
+276
View File
@@ -274,5 +274,281 @@
{
"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": 3528
},
{
"date": "2026-10-23",
"total": 3561
},
{
"date": "2026-10-24",
"total": 3571
},
{
"date": "2026-10-25",
"total": 3612
},
{
"date": "2026-10-26",
"total": 4184
},
{
"date": "2026-10-27",
"total": 4849
},
{
"date": "2026-10-28",
"total": 5426
},
{
"date": "2026-10-29",
"total": 5536
},
{
"date": "2026-10-30",
"total": 5573
},
{
"date": "2026-10-31",
"total": 5615
},
{
"date": "2026-11-01",
"total": 5641
},
{
"date": "2026-11-02",
"total": 5674
},
{
"date": "2026-11-03",
"total": 5702
},
{
"date": "2026-11-04",
"total": 5720
},
{
"date": "2026-11-05",
"total": 5737
},
{
"date": "2026-11-06",
"total": 5771
},
{
"date": "2026-11-07",
"total": 5798
},
{
"date": "2026-11-08",
"total": 5818
},
{
"date": "2026-11-09",
"total": 5858
},
{
"date": "2026-11-10",
"total": 5875
},
{
"date": "2026-11-11",
"total": 5922
},
{
"date": "2026-11-12",
"total": 5966
},
{
"date": "2026-11-13",
"total": 5991
},
{
"date": "2026-11-14",
"total": 6028
},
{
"date": "2026-11-15",
"total": 6069
}
]
+3967 -1849
View File
File diff suppressed because it is too large. Load diff
+4637 -2449
View File
File diff suppressed because it is too large. Load diff
+4612 -2859
View File
File diff suppressed because it is too large. Load diff
+5410 -3124
View File
File diff suppressed because it is too large. Load diff
+18600 -2088
View File
File diff suppressed because it is too large. Load diff
+20424
View File
File diff suppressed because it is too large. Load diff
+20523
View File
File diff suppressed because it is too large. Load diff
+17165
View File
File diff suppressed because it is too large. Load diff
+18205
View File
File diff suppressed because it is too large. Load diff
+19533
View File
File diff suppressed because it is too large. Load diff
+18773
View File
File diff suppressed because it is too large. Load diff
+19092
View File
File diff suppressed because it is too large. Load diff
+2533
View File
File diff suppressed because it is too large. Load diff
+35 -3
View File
@@ -1,7 +1,7 @@
{
"total_games": 2097,
"total_games": 6069,
"max_per_file": 500,
"last_updated": "2026-06-13T08:31:05Z",
"last_updated": "2026-11-15T20:24:18Z",
"files": [
{
"name": "game_info_001.json",
@@ -21,7 +21,39 @@
},
{
"name": "game_info_005.json",
"count": 97
"count": 500
},
{
"name": "game_info_006.json",
"count": 500
},
{
"name": "game_info_007.json",
"count": 500
},
{
"name": "game_info_008.json",
"count": 500
},
{
"name": "game_info_009.json",
"count": 500
},
{
"name": "game_info_010.json",
"count": 500
},
{
"name": "game_info_011.json",
"count": 500
},
{
"name": "game_info_012.json",
"count": 500
},
{
"name": "game_info_013.json",
"count": 69
}
]
}
-188
View File
@@ -1,188 +0,0 @@
=== Deleted Games Log ===
Total deleted: 46
==================================================
1. [2026-06-11] wageslave: probation period
URL: https://cauldron.itch.io/wageslave
Reason: Game became paid
2. [2026-06-07] Frunkers Lyratick Pluse [Animus_Gulitar's take]
URL: https://xxxanimusxxx.itch.io/frunkers-lyratick-pluse-animus-gulitars-take
Reason: Game page no longer exists (HTTP 404)
3. [2026-06-07] Neverwood (EARLY ALPHA)
URL: https://bellainthegame.itch.io/neverwood
Reason: Game became paid
4. [2026-06-05] Seek VR: Reimagined
URL: https://underdevlar.itch.io/seek
Reason: Game page no longer exists (HTTP 404)
5. [2026-06-05] cigarette christine
URL: https://aliothgames.itch.io/cigarette-christine
Reason: Game page no longer exists (HTTP 404)
6. [2026-06-05] Snacktorio
URL: https://tngineers.itch.io/snacktorio
Reason: Game became paid
7. [2026-06-05] The Method of Hiding a Body
URL: https://sea-of-ghosts.itch.io/the-method-of-hiding-a-body
Reason: Game became paid
8. [2026-06-03] idle primes
URL: https://ipipgamedev.itch.io/idle-primes
Reason: Game page no longer exists (HTTP 404)
9. [2026-06-03] Lとじゃんけんするだけ
URL: https://superleisurelylife.itch.io/l-rockpaperscissors-l-fanmadegame
Reason: Game page no longer exists (HTTP 404)
10. [2026-05-31] BERSERK SURVIVOR
URL: https://renzk.itch.io/berserksurvivor
Reason: Game page no longer exists (HTTP 404)
11. [2026-05-29] Arcane KItchen v.3
URL: https://diegodelgadog6.itch.io/arcane-kitchen-v3
Reason: Game page no longer exists (HTTP 404)
12. [2026-05-29] Low Effort Romance [Prototype]
URL: https://azurextwilight.itch.io/low-effort-romance
Reason: Game page no longer exists (HTTP 404)
13. [2026-05-27] GORILLA BOUNCER V4
URL: https://zohaven.itch.io/gorilla-bouncers
Reason: Game page no longer exists (HTTP 404)
14. [2026-05-27] ClickRealm - Online MMORPG
URL: https://clutch-games.itch.io/clickrealm-idle-mmorpg
Reason: Game page no longer exists (HTTP 404)
15. [2026-05-27] Spralt V3
URL: https://talihi.itch.io/spralt-remake-overhaul-re-overhauled
Reason: Game page no longer exists (HTTP 404)
16. [2026-05-23] Zenith Miner - Space Project - English
URL: https://gamersz.itch.io/zenith-miner-space-project-english-version
Reason: Game page no longer exists (HTTP 404)
17. [2026-05-23] Tarotro
URL: https://worsteventgames.itch.io/tarotro
Reason: Game became paid
18. [2026-05-19] Pretend it's not There
URL: https://dreadloom-studios.itch.io/pretend-its-not-there
Reason: Game page no longer exists (HTTP 404)
19. [2026-05-19] PakuPaku Gyaru! 「 パクパクギャル!」
URL: https://sumi03c.itch.io/pakupaku-gyaru
Reason: Game page no longer exists (HTTP 404)
20. [2026-05-19] Alone in Christmas
URL: https://dreadloom-studios.itch.io/alone-in-christmas
Reason: Game page no longer exists (HTTP 404)
21. [2026-05-16] Samsara: Again Regain Again Rewind - Retrain.WIZE/SIGNED
URL: https://kozarto.itch.io/samsara-again-regain-again-rewind-retrainwizesigned
Reason: Game page no longer exists (HTTP 404)
22. [2026-05-16] Skeleton Quest
URL: https://kozarto.itch.io/skeleton-quest
Reason: Game page no longer exists (HTTP 404)
23. [2026-05-16] Samsara: Again Regain Again Rewind - Retrain.WIZE/SIGNED
URL: https://delightfulredstar.itch.io/samsara-again-regain-again-rewind-retrainwizesigned
Reason: Game page no longer exists (HTTP 404)
24. [2026-05-13] Código 404
URL: https://carlosgames.itch.io/codigo-404
Reason: Game page no longer exists (HTTP 404)
25. [2026-05-13] La casa abandonada
URL: https://carlosgames.itch.io/la-casa-abandonada
Reason: Game page no longer exists (HTTP 404)
26. [2026-05-01] Through His Eyes
URL: https://tawarre31.itch.io/through-her-eyes
Reason: Game page no longer exists (HTTP 404)
27. [2026-05-01] A Crown of Velvet Thorns
URL: https://anonymous-soul.itch.io/a-crown-of-velvet-thorns
Reason: Game page no longer exists (HTTP 404)
28. [2026-05-01] Love the Guard, Be the King (complete)
URL: https://ligianunes.itch.io/love-the-guard-be-the-king
Reason: Game became paid
29. [2026-04-27] Pepsi express free
URL: https://sickycreator.itch.io/pepsi-express-free
Reason: Game page no longer exists (HTTP 404)
30. [2026-04-25] C++ Console Games
URL: https://hunterelise.itch.io/console-games
Reason: Game page no longer exists (HTTP 404)
31. [2026-04-23] Soap Killer
URL: https://rhynlen.itch.io/soap-killer
Reason: Game page no longer exists (HTTP 404)
32. [2026-04-23] Lost Ball
URL: https://ellena132005.itch.io/lost-ball
Reason: Game page no longer exists (HTTP 404)
33. [2026-04-21] devastate
URL: https://e6atejib-hobn4kob.itch.io/devastate
Reason: Game page no longer exists (HTTP 404)
34. [2026-04-17] My take splnuko Idk
URL: https://pro-monkey.itch.io/my-take-splnuko-idk
Reason: Game page no longer exists (HTTP 404)
35. [2026-04-13] SCP-3008 Infinite Store
URL: https://christopher-elliot.itch.io/scp-3008-infinite-store
Reason: Game page no longer exists (HTTP 404)
36. [2026-04-09] Burning Boundaries |Sex Game
URL: https://hentaeiie.itch.io/burning-boundaries-sex-game
Reason: Game page no longer exists (HTTP 404)
37. [2026-04-09] FreshWomen - Season 2
URL: https://epoorew.itch.io/freshwomen-season-2
Reason: Game page no longer exists (HTTP 404)
38. [2026-04-09] Married Into Hell |Sex Hentai|
URL: https://sexheantai.itch.io/married-into-hell-sex-hentai
Reason: Game page no longer exists (HTTP 404)
39. [2026-04-09] Fuckstone
URL: https://ehn-sabedra.itch.io/turtle-care-simulator
Reason: Game page no longer exists (HTTP 404)
40. [2026-04-09] Zero
URL: https://ahdevgames.itch.io/zero
Reason: Game became paid
41. [2026-04-07] The Seat Across From Mine
URL: https://orb-star.itch.io/in-his-gaze
Reason: Game page no longer exists (HTTP 404)
42. [2026-04-03] Package You Shouldn’t Open
URL: https://cryzeder.itch.io/package-you-shouldnt-open
Reason: Game page no longer exists (HTTP 404)
43. [2026-04-01] Space Travel is Boring
URL: https://potpan.itch.io/spacetravelisboring
Reason: Game page no longer exists (HTTP 404)
44. [2026-03-29] Femdom First Timers
URL: https://brayden-vargas.itch.io/femdom-first-timers
Reason: Game page no longer exists (HTTP 404)
45. [2026-03-21] Little Witch Inuko
URL: https://jordan-smirnov.itch.io/little-witch-inuko
Reason: Game page no longer exists (HTTP 404)
46. [2026-03-13] Follower
URL: https://grantrimi.itch.io/follower
Reason: Game became paid
Loaded 100 of 484 files, more files were not shown because too many files have changed in this diff. Show more