Compare commits

..
405 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
260 changed files with 154787 additions and 20906 deletions

No files matched your search

+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
+3
View File
@@ -8,6 +8,8 @@ body:
value: |
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).
@@ -56,6 +58,7 @@ body:
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
+5 -2
View File
@@ -1,5 +1,5 @@
name: 🐛 Bug Report
description: Report a bug on the website, in the desktop/Android app, in the game data, or in the scripts
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:
@@ -8,8 +8,11 @@ body:
value: |
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
+6
View File
@@ -6,3 +6,9 @@ contact_links:
- 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
@@ -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
+1 -1
View File
@@ -1,7 +1,7 @@
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:
@@ -12,6 +12,7 @@ Optional: short notes, why they rock, NSFW/safety concerns (the Maintainer sets
### Checklist
- [ ] 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`)
-27
View File
@@ -1,27 +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?
- [ ] Wrong game info or NSFW/safety flag (usually easier as a Bug Report issue — please don't hand-edit `data_game/`, the pipeline writes it)
- [ ] Scraping failure (itch.io changed HTML again)
- [ ] Data pipeline / GitHub Actions fail
- [ ] Website bug (`webapp/src/`)
- [ ] Worker bug (`webapp/worker/` — image proxy, Suggest API, admin API)
- [ ] Desktop/Android app (Tauri) bug
- [ ] Other (describe below)
### Description
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 — Python: `pytest`, `ruff check scripts tests webapp/scripts`, `python scripts/validate.py`; webapp: `npm test`, `npm run lint`, `npx tsc -b`
- [ ] No new bugs introduced (hopefully)
- [ ] No secrets, tokens or personal data in the diff
- [ ] I agree my contribution is licensed under the MIT License (see `LICENSE`)
- [ ] Followed the vibe (chill, no drama)
Grok approved? (just kidding, but thanks legend!) 🚀
@@ -1,26 +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/EULA/SECURITY/etc.
- [ ] Update the Vietnamese mirror (`README.vi.md`, `docs/i18n/vi/`)
- [ ] 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
- [ ] Relative links still resolve; website links use `https://freeitchgames.win/<path>`
- [ ] If I changed an English doc that has a Vietnamese mirror, I updated the mirror too (or said so above so someone else can)
- [ ] I agree my contribution is licensed under CC BY 4.0, like the rest of the documentation
- [ ] Keeps the self-deprecating vibe :D
Even small fixes make this repo look less noob — thanks bro! 🚀
@@ -1,30 +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
Heads-up: the website and apps are read-only for visitors on purpose — no accounts, no ads, no profiling, no telemetry in the apps. Features that would add those (or new cookies, or a new third-party service) need a chat in an issue first, since the Privacy Policy would have to change.
### What feature/improvement?
- [ ] Better scraping (more info, rating, etc.)
- [ ] Website/app UI (new page, filter, chart, better mobile layout)
- [ ] Desktop/Android app (Tauri)
- [ ] Automation (pipeline, GitHub Actions)
- [ ] Performance fix (faster pages, faster Actions)
- [ ] Refactor my messy code
- [ ] Other (describe)
### Description
Explain what it does and why it's cool. Include code snippets if needed.
### Related Issues
References # (link 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`)
- [ ] Doesn't break the daily refresh or the ingest workflow
- [ ] New npm dependency? Added it to `webapp/src/lib/about.ts` so the About page lists it
- [ ] Edited `webapp/wrangler.jsonc`? Ran `npm run cf:types`
- [ ] I agree my contribution is licensed under the MIT License (see `LICENSE`)
- [ ] Keeps the noob vibe intact
If this makes the repo less mediocre — you're the MVP. 🚀
+17 -7
View File
@@ -1,5 +1,5 @@
# Dependabot version updates. Security updates are enabled separately in
# Settings → Code security (they are not limited by open-pull-requests-limit).
# 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
@@ -21,11 +21,15 @@ updates:
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/*'
@@ -36,12 +40,14 @@ updates:
- 'wrangler'
- '@cloudflare/*'
ignore:
# typescript-eslint supports TypeScript < 6.1 only.
# `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'
versions: ['>=6.1']
# Match the Node 24 runtime.
update-types: ['version-update:semver-major']
# Match the Node 26 runtime.
- dependency-name: '@types/node'
versions: ['>=25']
versions: ['>=27']
- package-ecosystem: pip
directory: /
@@ -63,10 +69,14 @@ updates:
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: monthly
interval: weekly
day: monday
groups:
tauri-rs:
patterns: ['tauri*']
+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
+16 -10
View File
@@ -1,5 +1,5 @@
# Lint + tests for the data pipeline, and schema validation of the catalog.
# Pushes by GitHub Apps (browser extension, admin Worker) also trigger this,
# Pushes by the admin Worker's GitHub App also trigger this,
# so every externally written data change is validated.
name: Python CI
@@ -10,8 +10,9 @@ on:
- 'tests/**'
- 'data_game/**'
- 'requirements*.txt'
- 'requirements*.in'
- 'pyproject.toml'
- '.python-version'
- '.github/python-version'
- '.github/workflows/python-ci.yml'
push:
branches: [main]
@@ -20,8 +21,9 @@ on:
- 'tests/**'
- 'data_game/**'
- 'requirements*.txt'
- 'requirements*.in'
- 'pyproject.toml'
- '.python-version'
- '.github/python-version'
- '.github/workflows/python-ci.yml'
permissions: {}
@@ -30,9 +32,6 @@ concurrency:
group: python-ci-${{ github.ref }}
cancel-in-progress: true
env:
PYTHONUTF8: '1'
jobs:
test:
runs-on: ubuntu-latest
@@ -46,14 +45,21 @@ jobs:
persist-credentials: false
- name: Set up Python
uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
uses: actions/setup-python@6d4fd22b20465ccc0f7354476588e8df7c9ca0e0 # v7.1.0
with:
python-version-file: .python-version
# Not .python-version: Dependabot's pip updater reads that file and
# supports Python <= 3.14 only (CLAUDE.md gotcha 39).
python-version-file: .github/python-version
cache: pip
cache-dependency-path: requirements-dev.txt
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 -r requirements-dev.txt
run: |
pip install --require-hashes --only-binary :all: -r requirements.txt -r requirements-dev.txt
- name: Ruff
run: |
+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 }}
+10 -9
View File
@@ -48,7 +48,6 @@ concurrency:
env:
PYTHONUNBUFFERED: '1'
PYTHONUTF8: '1'
jobs:
scan:
@@ -69,14 +68,15 @@ jobs:
persist-credentials: false
- name: Set up Python
uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
uses: actions/setup-python@6d4fd22b20465ccc0f7354476588e8df7c9ca0e0 # v7.1.0
with:
python-version-file: .python-version
python-version-file: .github/python-version
cache: pip
cache-dependency-path: requirements.txt
- name: Install dependencies
run: pip install -r requirements.txt
run: |
pip install --require-hashes --only-binary :all: -r requirements.txt
- name: Check a slice of the catalog
id: refresh
@@ -95,7 +95,7 @@ jobs:
- name: Upload patch
if: always()
uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
with:
name: refresh-patch
path: ${{ runner.temp }}/patch.json
@@ -124,17 +124,18 @@ jobs:
ref: main
- name: Set up Python
uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
uses: actions/setup-python@6d4fd22b20465ccc0f7354476588e8df7c9ca0e0 # v7.1.0
with:
python-version-file: .python-version
python-version-file: .github/python-version
cache: pip
cache-dependency-path: requirements.txt
- name: Install dependencies
run: pip install -r requirements.txt
run: |
pip install --require-hashes --only-binary :all: -r requirements.txt
- name: Download patch
uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
with:
name: refresh-patch
path: ${{ runner.temp }}
+5 -5
View File
@@ -45,7 +45,7 @@ jobs:
persist-credentials: false
- name: Set up JDK
uses: actions/setup-java@de7274f081f381c8f8158605e0321c36c376e2e6 # v6.0.1
uses: actions/setup-java@77dd5b2ce225ea11469928ac317850245a74ae78 # v6.2.0
with:
distribution: temurin
java-version: '17'
@@ -55,7 +55,7 @@ jobs:
# (it hard-errors otherwise). Release builds use no caches at all.
- name: Set up Node.js
uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
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
@@ -63,7 +63,7 @@ jobs:
package-manager-cache: false
- name: Set up Rust
uses: dtolnay/rust-toolchain@7e38f4b43b4db5c8dd498af069a4f6196df1d067 # master
uses: dtolnay/rust-toolchain@683b588c487a69d01f6c6ddf40f036ff682cc2c8 # master
with:
toolchain: stable
targets: aarch64-linux-android
@@ -81,7 +81,7 @@ jobs:
- name: Install npm deps
working-directory: webapp
run: npm ci
run: npm ci --ignore-scripts
- name: Initialize Android project
working-directory: webapp
@@ -129,7 +129,7 @@ jobs:
echo "apk_name=$OUT" >> "$GITHUB_OUTPUT"
- name: Upload APK as workflow artifact
uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
with:
name: ${{ steps.sign.outputs.apk_name }}
path: ${{ steps.sign.outputs.apk_path }}
+3 -3
View File
@@ -94,7 +94,7 @@ jobs:
persist-credentials: false
- name: Set up Node.js
uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
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
@@ -102,7 +102,7 @@ jobs:
package-manager-cache: false
- name: Set up Rust
uses: dtolnay/rust-toolchain@7e38f4b43b4db5c8dd498af069a4f6196df1d067 # master
uses: dtolnay/rust-toolchain@683b588c487a69d01f6c6ddf40f036ff682cc2c8 # master
with:
toolchain: stable
targets: ${{ matrix.tauri_target }}
@@ -121,7 +121,7 @@ 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@1deb371b0cd8bd54025b384f1cd735e725c4060f # action-v1.0.0
+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 }}
+6 -6
View File
@@ -1,5 +1,5 @@
# Ingest queued links from scripts/temp_link.json (written by the browser
# extension, and later the admin Worker) plus an optional dispatched URL.
# 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),
@@ -34,7 +34,6 @@ concurrency:
env:
PYTHONUNBUFFERED: '1'
PYTHONUTF8: '1'
jobs:
ingest:
@@ -49,14 +48,15 @@ jobs:
ref: main
- name: Set up Python
uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
uses: actions/setup-python@6d4fd22b20465ccc0f7354476588e8df7c9ca0e0 # v7.1.0
with:
python-version-file: .python-version
python-version-file: .github/python-version
cache: pip
cache-dependency-path: requirements.txt
- name: Install dependencies
run: pip install -r requirements.txt
run: |
pip install --require-hashes --only-binary :all: -r requirements.txt
- name: Scrape queued links
timeout-minutes: 50
+11 -3
View File
@@ -30,14 +30,22 @@ jobs:
persist-credentials: false
- name: Set up Node.js
uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
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
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
@@ -55,4 +63,4 @@ jobs:
run: npm run build
- name: Validate Workers config (dry run)
run: npx wrangler deploy --dry-run --env=""
run: npm run cf:check
+1
View File
@@ -15,6 +15,7 @@
/webapp/node_modules/
/webapp/dist/
/webapp/coverage/
/webapp/src-tauri/target/
/webapp/src-tauri/gen/
-1
View File
@@ -1 +0,0 @@
3.14
+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. 🚀
+9 -1
View File
@@ -3,12 +3,20 @@
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.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.**
**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) |
+80 -23
View File
@@ -8,25 +8,27 @@ A curated, auto-updating catalog of free itch.io games, published at **https://f
everyone; the old github.io URL only redirects). Three layers share one JSON catalog:
1. **Python pipeline** — the data layer (GitHub Actions).
- `data_game/game_info_NNN.json` — chunked records, max 500 per file, 2,811 games on 2026-09-24. 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/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). Tests: `pytest` (network blocked). Lint: `ruff check scripts tests webapp/scripts`, `ruff format`, `vulture` (config in root `pyproject.toml`). Local env: `python -m venv .venv && .venv/Scripts/pip install -r requirements-dev.txt` (Windows: run with `PYTHONUTF8=1`).
- `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 6.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/`).
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), the maintainer's browser extension (`POST /api/ingest`, Access service token; repo `poli0981/itch-f2p-extension`), and RSS discovery (Worker cron) all feed a **D1 review queue**; approving in `/admin` commits the URLs to `scripts/temp_link.json` as a GitHub App, which triggers `update.yml`.
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
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
@@ -39,15 +41,16 @@ Local admin without Access: put `DEV_ADMIN_EMAIL=you@example.com` in `webapp/.de
## Worker (`webapp/worker/`)
- `index.ts` routes: `/img/*` (img.ts, behind the gate), `/api/health`, `/api/verify` (gate.ts), `/api/suggest` (suggest.ts), `/api/ingest` (ingest.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 * * *`): `discover.ts` (one itch.io RSS feed per run, 6 h back-off on 429) → `QueueStore.reconcile` (queued → ingested / failed after 3 days) → `purge` (idempotency 7 d, Suggest notes 180 d).
- `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; ingest = service-token `common_name`.
- `admin.ts`: API (queue list / approve / reject / add / edit the 3 fields / delete with reason + R2 cleanup / restore) and the `/admin` shell with its own CSP. The maintainer's email goes only to the D1 audit log, never into a commit (the repo is public).
- `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). `data.ts`: catalog facts read from the site's own `/data` via `env.ASSETS`, cached per isolate (loaded values only — see gotchas).
- `queue.ts`: URL classification (catalog → blocklist → pending → previously deleted) + the D1 store (`worker/migrations/`, additive only — never edit an applied migration; `0002` added `candidates.outcome`, `settings` and `watched_collections`; the `idempotency` table and `'ext'` in the `candidates.source` CHECK are unused leftovers of the ingest API removed in 4.4.1; URL lists bind in `IN` slices of 90, gotcha 37). `data.ts`: catalog facts read from the site's own `/data` via `env.ASSETS`, cached per isolate (loaded values only — see gotchas).
- Configuration: non-secret settings are `vars` in `wrangler.jsonc` (empty until setup); secrets (`GH_APP_PRIVATE_KEY` — the PEM GitHub downloads (PKCS#1) or PKCS#8; `github.ts` converts, `ADMIN_EMAILS`, `TURNSTILE_SECRET`, `GATE_SECRET`, `GATE_BOT_TOKEN`) via `wrangler secret put`, typed in `worker/env.ts` as optional. A feature whose settings are missing answers **503** (the gate just stays off); the public site needs none of them. `env.staging` = Worker `free-games-itchio-list-staging` on `staging.freeitchgames.win` (no cron, own R2/D1/rate-limit namespaces).
## Web app structure (`webapp/src/`)
@@ -57,14 +60,15 @@ Local admin without Access: put `DEV_ADMIN_EMAIL=you@example.com` in `webapp/.de
- 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, **no barrel `index.ts`**; every Recharts tooltip/cursor comes from `chart-theme.ts` + `chart-tooltip.tsx`), `components/game-thumb.tsx` (`lib/thumbnail.ts` → `/img/160|640/...` on the web, the original URL in Tauri), `components/legal-gate.tsx` (a non-dismissable Radix dialog **over** the page, so deep links land where they pointed; links flagged `inGate` in `lib/about.ts`; re-prompts when `LEGAL_VERSION` in `stores/prefs.ts` changes; no "Leave" button in Tauri).
- Styling: **Tailwind v4** via `@tailwindcss/vite` (no PostCSS, no `tailwind.config`); tokens are hex CSS variables in `src/index.css` (`:root` / `.dark`, `@theme inline`; `--brand-soft`, `--thumb`, `--success`, `--scrollbar-thumb(-hover/-active)` besides the shadcn set) and must match the approved mockup. Themed scrollbars (`@layer base`, only under `(hover: hover) and (pointer: fine)`): `::-webkit-scrollbar*` for Chromium/Safari, `scrollbar-color` / `scrollbar-width: thin` for Firefox only (gotcha 28); "Hide scrollbars" = unlayered `html[data-scrollbars='hidden']` rules (`hooks/useScrollbarsEffect.ts`). 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`.
- `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 ≈ 179 KB gzip (JS + CSS, gzip -9; 4.2 added ~4.6 KB for the pack loader, persister and `useQueries`) plus ~51 KB of Geist woff2; catalog data on a first visit ≈ 264 KB (main packs + log + history), descriptions ≈ 170 KB on demand. `fflate` is a lazy chunk, never preloaded. Web build `target` is Safari/iOS 15.4 (Radix class static blocks otherwise break iOS 15); Tauri uses the default.
- 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
@@ -74,18 +78,20 @@ Each game has **20** fields (plus optional `added_at` / `updated_at`, appended b
| Workflow | Trigger | Notes |
|---|---|---|
| `update.yml` | Push to `main` touching `scripts/temp_link.json` + daily 01:23 UTC + `workflow_dispatch` (`url`) | Ingest queue → patch → `commit_push.sh`. Workflow-level `concurrency: ingest` with **`queue: max`** (the default queue replaces a pending run, which would drop its dispatched `url`). A dispatched `url` is processed first and written to `temp_link.json` (`queue_add`) until it reaches a final outcome. Failed fetches count as an attempt only ≥ 6 h apart (`last_attempt`; 3 → given up), and a 429 counts as none. GitHub-App pushes (extension, admin Worker) 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 or paid 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`. |
| `update.yml` | Push to `main` touching `scripts/temp_link.json` + daily 01:23 UTC + `workflow_dispatch` (`url`) | Ingest queue → patch → `commit_push.sh`. Workflow-level `concurrency: ingest` with **`queue: max`** (the default queue replaces a pending run, which would drop its dispatched `url`). A dispatched `url` is processed first and written to `temp_link.json` (`queue_add`) until it reaches a final outcome. Failed fetches count as an attempt only ≥ 6 h apart (`last_attempt`; 3 → given up), and a 429 counts as none. GitHub-App pushes (the admin Worker and its cron) trigger it; its own `GITHUB_TOKEN` push does not (no loop). Keep the filename. |
| `refresh.yml` | Daily 02:47 UTC + `workflow_dispatch` (`budget`, `url`, `allow_mass_removal`, `full`) | scan (read-only, 55-min step timeout, checks out the branch as it is when the job starts — not the queued SHA — so runs waiting in the queue see the previous run's state; patch artifact uploaded `if: always()`) → apply (`!cancelled()`: a failed / timed-out scan's checkpoint is applied, a cancelled run's is not) → notify. Workflow-level `concurrency: refresh-pipeline` + `queue: max` runs one whole scan → apply at a time (scheduled, manual and force-update runs alike). Removal needs the same 404/410, paid or `private` (itch.io's password form, `is_password_protected`; ingest drops such links as final) strike seen again ≥ 20 h after the first sighting (`strike_at`). Checkpoints never carry removals. **Mass-change guard:** a run whose removals or new strikes exceed max(10, 10 %) of the games it checked withholds all its removals and marks them — and, on a strike spike, all its strikes — `withheld_at`; later runs keep withholding those (they take at most half a run's budget) until a healthy check clears them, and alert (`mass_change`) — that pattern means itch.io markup changed; dispatch with `allow_mass_removal` only after checking on itch.io. `apply_patch.py` re-checks the same per-run limit and max(25, 5 %) of the catalog unless `ALLOW_MASS_REMOVAL=1`. |
| `force_update.yml` | `workflow_dispatch` ONLY (`url`, `budget`, `allow_mass_removal`) | Dispatches `refresh.yml` with `full: true` (`actions: write`; it used to call it through `uses:`, which failed at startup with no annotation): re-scrapes every scraper field for one URL or the next batch (rotates on `full` timestamps). Dispatch it N times in a row to cover N consecutive batches (FIFO, each from the latest main). Always preserves `safe_virus` / `notes` / `nsfw`. Canonical tool for repairing mojibake. |
| `notify-failure.yml` | `workflow_call` | Discord (`DISCORD_CI_WEBHOOK`) on failure / **cancelled** (job-level timeouts end as cancelled) / rate-limited / mass change / failed Cloudflare build. |
| `python-ci.yml` / `webapp-ci.yml` | PRs (+ pushes for Python) | ruff + format + vulture + pytest + `validate.py` / `npm run cf:types -- --check` + lint + knip + vitest + build + `wrangler deploy --dry-run --env=""`. |
| `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.
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
@@ -98,11 +104,11 @@ git push origin vX.Y.Z
gh release edit vX.Y.Z --draft=false
```
Draft-first: **never** `gh release create` by hand before CI — tauri-action v1 refuses to upload into a published release, and announcements would go out before installers exist. Merge PRs into `main` with squash or a merge commit, never by fast-forward pushing a branch: its commits' preview-build check runs would then sit on main's own line and confuse `deploy-status.yml`. Tag from `main` only. Release notes go to `changelog/<major>.x/ver<major>.<minor>.x.md` plus a row in the `CHANGELOG.md` index (each row keeps the anchor of the old single-file heading as `<a name>`: published release notes link to them). Versions live in `webapp/src/lib/about.ts` (`APP.version`), `webapp/package.json`, `webapp/src-tauri/tauri.conf.json` and `Cargo.toml` (+ `Cargo.lock`) — keep them equal. GPG signing is wired through gpg-agent (`commit.gpgsign=true`, so `git tag -s` and `git commit` both sign; the pinentry must be answered — in unattended sessions commits fail rather than going unsigned). The historical key `03F965C2E2DB5C6B` was exposed in the browser extension's storage (Sept 2026) and is being replaced — use the maintainer's current key.
Draft-first: **never** `gh release create` by hand before CI — tauri-action v1 refuses to upload into a published release, and announcements would go out before installers exist. Merge PRs into `main` with squash or a merge commit, never by fast-forward pushing a branch: its commits' preview-build check runs would then sit on main's own line and confuse `deploy-status.yml`. Tag from `main` only. Release notes go to `changelog/<major>.x/ver<major>.<minor>.x.md` plus a row in the `CHANGELOG.md` index (each row keeps the anchor of the old single-file heading as `<a name>`: published release notes link to them). Versions live in `webapp/src/lib/about.ts` (`APP.version`), `webapp/package.json`, `webapp/src-tauri/tauri.conf.json` and `Cargo.toml` (+ `Cargo.lock`) — keep them equal. GPG signing is wired through gpg-agent (`commit.gpgsign=true`, so `git tag -s` and `git commit` both sign; the pinentry must be answered — in unattended sessions commits fail rather than going unsigned). Signing key since 2026-10-10: `838884804847BE7AE5FCF0A96AD1AB0921B96825` (ed25519 certify-only primary, generated locally and never published before; signing subkey `ED0BFD3005662D5D`; `user.signingkey` = the primary fingerprint, global + repo). The old key `03F965C2E2DB5C6B` is **revoked** (compromised: it sat in the browser extension's storage, Sept 2026); tags up to v4.3.0 and older commits carry it. The owner's offline backup and revocation certificates live outside the repo.
## Licenses & policies
Code **MIT** (`LICENSE`); catalog data **CC BY 4.0** for the maintainer's contribution — excluding creators' descriptions, cover images, names/trademarks (`data_game/LICENSE.md`, `LICENSES/CC-BY-4.0.txt`); docs **CC BY 4.0**; map + non-affiliation in `NOTICE.md`. Policies (EN in `docs/`, VI mirrors in `docs/i18n/vi/`, English controls): ToS (website + data + content removal), EULA (desktop/Android binaries only; also `webapp/src-tauri/installer/EULA.rtf`), Privacy Policy, Disclaimer, `SECURITY.md`, `CODE_OF_CONDUCT.md`. When a policy changes, bump `LEGAL_VERSION` (`webapp/src/stores/prefs.ts`) and the dates in `about.legal.desc` (EN/VI) so the legal gate asks again. Contact addresses `contact@ / legal@ / privacy@ / security@ / takedown@poli0981.dev` are aliases of the maintainer's Google Workspace mailbox (not Cloudflare Email Routing; the Privacy Policy lists Google as the email processor). The maintainer's site https://poli0981.dev/ and channel hub https://poli0981.dev/links/ are linked from the About page (`DEV` in `lib/about.ts`).
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)
@@ -111,7 +117,7 @@ Code **MIT** (`LICENSE`); catalog data **CC BY 4.0** for the maintainer's contri
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. **TS 6** deprecates `baseUrl`. Use `paths` alone. Stay on TS 6.0.x until typescript-eslint supports newer.
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.
@@ -136,17 +142,68 @@ Code **MIT** (`LICENSE`); catalog data **CC BY 4.0** for the maintainer's contri
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 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.
- 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 (Oct 2026)
## Current state (Nov 2026)
**v4.3.0** (2026-10-10): 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. Rolled out with a full re-scrape: after the merge, `force_update.yml` dispatched 6× (budget 600, one ~41-min batch each at ≈14.5 games/min, FIFO); the daily refresh fills the new fields in on its own within a week. A 250-page sample before the release: No AI 47 %, AI Assisted 10 %, not disclosed 43 %; accessibility listed on ≈20 % of games.
**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).
@@ -154,4 +211,4 @@ Code **MIT** (`LICENSE`); catalog data **CC BY 4.0** for the maintainer's contri
**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. `/api/ingest` stays unused — the browser extension is archived. **Still open (owner):** the legal-text review items; a new GPG signing key (commits are still signed with the exposed `03F965C2E2DB5C6B`); deleting the unused repo secrets `GH_TOKEN`, `TELEGRAM_BOT_TOKEN`, `DISCUSSION_*`.
**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).
+42 -31
View File
@@ -2,9 +2,17 @@
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.
## Project Status: Stable, Maintenance Only
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.
- **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.
## How to Contribute (Use the Right Door, I'm Lazy ;D)
Games go through the website; everything else goes through the GitHub issue/PR templates. They make my life easier and reduce "wtf" moments.
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. Suggest New Games (Most Welcome!)
@@ -12,16 +20,17 @@ Games go through the website; everything else goes through the GitHub issue/PR t
- Optional: a short note (why it's good, content warnings…), up to 500 characters. Notes are deleted after 180 days. Please don't put personal data in it.
- A Cloudflare Turnstile check and a rate limit keep bots out; if you get blocked, wait a bit and try again.
- Only **free** itch.io games. Paid games are dropped automatically when the game page is scraped.
- Nothing goes live instantly: every suggestion lands in a **review queue**, and nothing enters the catalog until the Maintainer approves it. Approved links are then scraped by the data pipeline and show up on the site after the next deploy.
- 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.
Got a whole list? The **[Add Games (bulk list)]** issue template takes up to 15 links at once, and a PR that adds itch.io URLs to `scripts/temp_link.json` works too (use the [Add Games] PR template). Both go through the same review: the Maintainer checks every link before it is queued, and merging such a PR is the approval. Please don't edit `data_game/` by hand: the pipeline owns those files (see [section 7](#7-submit-code-changes-pr)).
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)).
#### 1b. Other ways games get in
- The Maintainer's companion browser extension ([itch-f2p-extension](https://github.com/poli0981/itch-f2p-extension), separate repo, GPL-3.0) sends links through an authenticated API while browsing itch.io. It is the Maintainer's own tool, not a public submission channel.
- 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).
Both land in the same review queue as the Suggest page. (The old Telegram bot path is retired.)
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
@@ -31,56 +40,58 @@ Game creators especially: if you want your game off the list, or its data correc
- Include the game URL, who you are (the creator / rights holder, or someone authorized by them) and the reason.
- The Maintainer removes the record from the catalog (logged with a reason on the public [removed-games page](https://freeitchgames.win/removed)) and deletes the resized cover copies the site stores; cached copies expire on their own. Target: within 7 days, urgent legal requests sooner.
- Heads-up: this is a public git repo, so past versions stay in its history. Rewriting public history is only done in exceptional cases of legal necessity.
- Wrong `safe_virus` / `nsfw` / notes, or other data errors that aren't a removal? A **[Bug Report]** issue is fine too.
- 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 Bugs
### 3. Report a Problem (Wrong Data, Something Broke)
- Open an issue → **[Bug Report]** template.
- Checkboxes for common bugs (dead links, wrong flags, broken page, etc.).
- 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.
- **Security problems are not bugs for the public tracker.** Report them privately: see [SECURITY.md](SECURITY.md).
- If it's complex, see "Discuss More" below.
- **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
### 4. Features and Improvements (Closed)
- Open an issue → **[Feature Request / Improvement]** template.
- Choose type (new feature or code fix), name, reason, priority (from "nice to have" to "repo dying").
- Optional: pseudo-code/snippet (no malware pls, I'll check with my average skills :D).
- 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)).
### 5. Give Feedback
### 5. Feedback, Questions, Anything Else
- 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.
- 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).
### 6. Anything Else (Questions, Memes, Off-Topic)
### 6. Dependencies and Security Fixes
- Use the **[General / Off-Topic]** template.
- Drop whatever's on your mind.
- 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. Submit Code Changes (PR)
### 7. Pull Requests
- Fork → branch → code → open a PR against `main` with the matching PR template ([Bug Fix], [New Feature], [Documentation]…).
- Clear description, please. I'll review slowly (unemployed schedule + AI buddies).
- **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 (type generation check, lint, knip, tests, build, `wrangler deploy --dry-run`) both run on PRs. Red CI = no merge.
- **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.
- 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.14, see `.python-version`):
**Python pipeline** (Python 3.15, see `.github/python-version`):
```sh
python -m venv .venv
@@ -96,7 +107,7 @@ 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 22.22+, CI uses the version in `webapp/.node-version`):
**Webapp + Worker** (Node.js 26+, CI uses the version in `webapp/.node-version`):
```sh
cd webapp
@@ -122,12 +133,12 @@ npm run tauri:build # installers in src-tauri/target/release/bundle/
- **Test locally**: run the checks from section 8 before pushing; CI runs the same ones.
- **Keep it clean**: only free itch.io games, no paid/demo/malware/duplicates.
- **Be patient**: I'm introvert + lazy, replies might be slow.
- **Agreement**: all issue templates have a required checkbox. Off-topic/spam/policy violations get ignored/closed without drama :D
- **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/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):
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
+2 -2
View File
@@ -1,6 +1,6 @@
# Notice
Last updated: 2026-09-29
Last updated: 2026-10-16
Applies from: the release of version 4.0.0.
@@ -45,7 +45,7 @@ The process is described in the [Terms of Use](docs/ToS.md).
| **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** | [poli0981/itch-f2p-extension](https://github.com/poli0981/itch-f2p-extension), a separate repository | GPL-3.0 | That repository |
| **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
+59 -21
View File
@@ -1,22 +1,42 @@
# Free Itch.io Games List
[![Version](https://img.shields.io/badge/version-4.2.0-blue.svg)](https://github.com/poli0981/free-games-itchio-list/releases/latest)
[![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)
[![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 **2,600+ free games on [itch.io](https://itch.io)**. Browse it at
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
- [Project status](#project-status)
- [Browse the catalog](#browse-the-catalog)
- [Desktop and Android apps](#desktop-and-android-apps)
- [Add a game](#add-a-game)
@@ -45,6 +65,10 @@ Everything lives on the website, **<https://freeitchgames.win>**:
- **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).
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.
@@ -93,20 +117,26 @@ still gets security hardening and that we actually test on (≈87% of active dev
## Add a game
There are three ways a game gets into the catalog. **All three go through a review queue**: nothing is
added until the Maintainer approves it.
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. **Browser extension**: the Maintainer's own
[itch-f2p-extension](https://github.com/poli0981/itch-f2p-extension) (separate repo, GPL-3.0) sends
links through an authenticated API while browsing itch.io.
3. **Automatic discovery**: every 4 hours the site reads one of itch.io's public RSS feeds of new and
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 reviews the queue in a private admin area (protected by Cloudflare Access). Approved links
are handed to the data pipeline, which scrapes each game page; paid games are dropped.
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).
@@ -120,9 +150,9 @@ Details: [Terms of Use](docs/ToS.md) and [Disclaimer](docs/DISCLAIMER.md).
## How the data stays fresh
```
Suggest page ──┐
Extension ──┼─→ review queue ─→ Maintainer approves ─→ scripts/temp_link.json
RSS feeds ──┘ (admin) │
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
@@ -156,14 +186,14 @@ The pipeline is polite to itch.io: it identifies itself as
- **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 and ingest APIs, the review queue
(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.14): scraper, refresh, patch/apply and validation,
- **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
@@ -225,10 +255,11 @@ docs/ # Policies, dev environment, third-party list (+ Vietnam
| 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 games, rating, status |
| 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 (Cloudflare Worker) | Every 4 hours | Poll one itch.io feed per run; new games go to the review queue |
| 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 |
@@ -279,8 +310,13 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for the full guide.
- **Add games**: use the [Suggest page](https://freeitchgames.win/suggest).
- **Remove a game / fix its data**: email takedown@poli0981.dev or open a
["Remove a game" issue](https://github.com/poli0981/free-games-itchio-list/issues/new?template=remove_game.yml).
- **Report bugs**: use the "Bug Report" issue template.
- **Request features**: use the "Feature Request / Improvement" template, or send a PR.
- **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).
@@ -328,8 +364,9 @@ Free itch.io games catalog by poli0981 (SkullMute) — https://freeitchgames.win
```
Third-party components keep their own licenses: see [`docs/THIRD_PARTY.md`](docs/THIRD_PARTY.md) and the
site's About page. The 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.
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
@@ -343,6 +380,7 @@ belong to their respective owners.
- [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)
Contact (the Maintainer's own mailbox on poli0981.dev):
+38 -17
View File
@@ -1,22 +1,37 @@
# Danh sách Game Itch.io Miễn Phí
[![Version](https://img.shields.io/badge/version-4.2.0-blue.svg)](https://github.com/poli0981/free-games-itchio-list/releases/latest)
[![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)
> Bản dịch từ bản tiếng Anh cập nhật ngày 2026-09-24 (English source revision 2026-09-24). Nếu có khác biệt, bản tiếng Anh được ưu tiên.
> Bản 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 tuyển chọn và tự động cập nhật gồm **hơn 2,600 game miễn phí trên [itch.io](https://itch.io)**. Duyệt tại **<https://freeitchgames.win>**: tìm kiếm, lọc, sắp xếp và mở thẳng trang itch.io của bất kỳ game nào. Website chỉ để xem, với tất cả mọi người: không tài khoản, không đăng nhập, không bình luận, không quảng cáo, không thanh toán.
Mộ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
- [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)
@@ -39,6 +54,7 @@ Mọi thứ nằm trên website **<https://freeitchgames.win>**:
- **Đã 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)).
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.
@@ -71,13 +87,15 @@ Lưu ý: **chỉ arm64-v8a** (mọi điện thoại từ ~2017; không hỗ tr
## Thêm game
Có ba cách để một game vào danh mục. **Cả ba đều đi qua hàng chờ duyệt**: không có gì được thêm cho tới khi Maintainer duyệt.
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. **Extension trình duyệt**: [itch-f2p-extension](https://github.com/poli0981/itch-f2p-extension) của chính Maintainer (repo riêng, GPL-3.0) gửi link qua một API có xác thực trong lúc duyệt itch.io.
3. **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ờ.
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).
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). 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.
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).
@@ -86,9 +104,9 @@ Muốn **gỡ** một game, hoặc sửa dữ liệu của nó (nhất là các
## Dữ liệu được cập nhật thế nào
```
Trang Suggest ─┐
Extension ─┼─→ hàng chờ duyệt ─→ Maintainer duyệt ─→ scripts/temp_link.json
RSS feed ─┘ (admin) │
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
@@ -108,10 +126,10 @@ Pipeline cư xử lịch sự với itch.io: nó tự xưng danh là `FreeItchGa
## 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 và ingest, 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).
- **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.14): scraper, refresh, patch/apply và validate, chạy bằng GitHub Actions.
- **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.
@@ -170,10 +188,11 @@ docs/ # Chính sách, môi trường dev, danh sách bên th
| Tác vụ | Lịch | Mục đích |
|---|---|---|
| Ingest (`update.yml`) | Khi hàng chờ đổi + hằng ngày 01:23 UTC | Cào link đã duyệt từ `temp_link.json`, bỏ qua game trả phí / đã chết / từng bị gỡ |
| Refresh (`refresh.yml`) | Hằng ngày 02:47 UTC | Kiểm tra lại 1/7 danh mục: link chết, game chuyển sang trả phí, rating, trạng thái |
| 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 (Cloudflare Worker) | Mỗi 4 giờ | Đọc một feed itch.io mỗi lượt; game mới vào hàng chờ duyệt |
| 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 |
@@ -218,8 +237,9 @@ Xem [CONTRIBUTING (tiếng Việt)](docs/i18n/vi/CONTRIBUTING.md) để có hư
- **Thêm game**: dùng [trang Suggest](https://freeitchgames.win/suggest).
- **Gỡ game / sửa dữ liệu**: gửi email tới takedown@poli0981.dev hoặc mở issue ["Remove a game"](https://github.com/poli0981/free-games-itchio-list/issues/new?template=remove_game.yml).
- **Báo lỗi**: dùng issue template "Bug Report".
- **Đề xuất tính năng**: dùng template "Feature Request / Improvement", hoặc gửi PR.
- **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)).
@@ -261,7 +281,7 @@ 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 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.
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.
@@ -275,6 +295,7 @@ Bản tiếng Việt nằm trong [`docs/i18n/vi/`](docs/i18n/vi/); bản tiếng
- [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)
Liên hệ (hộp thư riêng của Maintainer trên poli0981.dev):
+6 -4
View File
@@ -1,6 +1,6 @@
# Security Policy
Last updated: 2026-09-29
Last updated: 2026-11-11
Applies from: the release of version 4.0.0.
@@ -24,7 +24,7 @@ A good report includes:
**In scope**
- The website https://freeitchgames.win and its Cloudflare Worker, including the image proxy (`/img`), the Suggest API (`/api/suggest`), the ingest API used by the Maintainer's browser extension (`/api/ingest`), and the admin app and API (`/admin`, `/api/admin`).
- 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.
@@ -37,7 +37,7 @@ A good report includes:
- Volumetric denial-of-service (DoS/DDoS) and load testing.
- Reports from automated scanners without a working proof of concept.
The browser extension (poli0981/itch-f2p-extension) lives in its own repository; report issues in the extension itself there. Issues in the ingest API it talks to are in scope here.
The browser extension (poli0981/itch-f2p-extension) and the Telegram bot (poli0981/telegram-scraper-bot) are archived and no longer supported, so they are out of scope.
## 3. Supported versions
@@ -49,6 +49,8 @@ The browser extension (poli0981/itch-f2p-extension) lives in its own repository;
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.
@@ -76,7 +78,7 @@ What the repository actually does:
- **Dependabot** ([`.github/dependabot.yml`](.github/dependabot.yml)) is configured to keep npm, pip, GitHub Actions and cargo dependencies current.
- Every third-party **GitHub Action is pinned by full commit SHA**, and each workflow declares least-privilege `permissions`.
- Writes to the repository from the website's admin go through a **GitHub App** (verified commits), and the admin page is behind Cloudflare Access (GitHub login or one-time email PIN) and limited to the Maintainer.
- The Suggest form is protected by Cloudflare Turnstile and rate limiting.
- The 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.
+5 -5
View File
@@ -36,7 +36,7 @@ api() {
}
output() {
if [ -n "${GITHUB_OUTPUT:-}" ]; then echo "$1" >>"$GITHUB_OUTPUT"; fi
if [[ -n "${GITHUB_OUTPUT:-}" ]]; then echo "$1" >>"$GITHUB_OUTPUT"; fi
}
commits=$(api "repos/$GITHUB_REPOSITORY/commits?sha=main&per_page=100" \
@@ -44,14 +44,14 @@ commits=$(api "repos/$GITHUB_REPOSITORY/commits?sha=main&per_page=100" \
declare -A parent=()
sha=""
while read -r commit first_parent; do
[ -n "$commit" ] || continue
[ -n "$sha" ] || sha=$commit
[[ -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
[[ -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
@@ -67,7 +67,7 @@ for _ in $(seq 1 "$MAX_COMMITS"); do
;;
*)
age_h=$(((now - $(date -u -d "$completed" +%s)) / 3600))
if [ "$age_h" -lt "$WINDOW_H" ]; then
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"
+1 -1
View File
@@ -3,7 +3,7 @@
#
# Usage: bash bash/commit_push.sh PATCH.json "commit message"
#
# Every data writer (refresh, ingest, admin Worker, browser extension) pushes
# 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.
+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).
+3 -3
View File
@@ -1,6 +1,6 @@
# Catalog data license
Last updated: 2026-10-03
Last updated: 2026-11-09
Applies from: the release of version 4.0.0.
@@ -113,7 +113,7 @@ a guarantee. The project does not scan downloads. See the [Disclaimer](../docs/D
## 7. Corrections and removals
Game creators and rights holders can ask for a game to be removed or its data corrected. Email
**takedown@freeitchgames.win** or open the
**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).
@@ -134,4 +134,4 @@ to the Data from version 4.0.0 on.
*This is a plain-language summary written by a hobby maintainer, not a lawyer, and it is not legal advice.
If this file and the CC BY 4.0 legal code disagree, the legal code wins. Questions:
**legal@freeitchgames.win**.*
**legal@poli0981.dev**.*
+141 -1
View File
@@ -409,6 +409,146 @@
},
{
"date": "2026-10-10",
"total": 3251
"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
}
]
+3281 -1343
View File
File diff suppressed because it is too large. Load diff
+3475 -1589
View File
File diff suppressed because it is too large. Load diff
+3459 -1648
View File
File diff suppressed because it is too large. Load diff
+3643 -1684
View File
File diff suppressed because it is too large. Load diff
+3748 -1952
View File
File diff suppressed because it is too large. Load diff
+5349 -2798
View File
File diff suppressed because it is too large. Load diff
+13782 -2827
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
+32 -8
View File
@@ -1,7 +1,7 @@
{
"total_games": 3251,
"total_games": 6069,
"max_per_file": 500,
"last_updated": "2026-10-10T03:56:42Z",
"last_updated": "2026-11-15T20:24:18Z",
"files": [
{
"name": "game_info_001.json",
@@ -9,27 +9,51 @@
},
{
"name": "game_info_002.json",
"count": 499
"count": 500
},
{
"name": "game_info_003.json",
"count": 499
"count": 500
},
{
"name": "game_info_004.json",
"count": 499
"count": 500
},
{
"name": "game_info_005.json",
"count": 499
"count": 500
},
{
"name": "game_info_006.json",
"count": 496
"count": 500
},
{
"name": "game_info_007.json",
"count": 259
"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
}
]
}
+3 -3
View File
@@ -19,7 +19,7 @@ This repo wouldn't exist without a lot of help — mostly from tools and platfor
The website, the Worker and the desktop / Android apps build on a stack of open-source libraries. The full list with licenses lives in [`THIRD_PARTY.md`](THIRD_PARTY.md), and the runtime libraries are also on the [About page](https://freeitchgames.win/about) (from the `THIRD_PARTY` array in [`webapp/src/lib/about.ts`](../webapp/src/lib/about.ts)). Highlights:
- **Core**: React 19, TypeScript 6, Vite 8, React Router 8, Zustand 5
- **Core**: React 19, TypeScript 7, Vite 8, React Router 8, Zustand 5
- **UI**: Tailwind CSS, tw-animate-css, shadcn/ui (pattern), Radix UI primitives, lucide-react, class-variance-authority, tailwind-merge, clsx, Recharts, the Geist and Geist Mono typefaces (via Fontsource)
- **Data**: TanStack Query, idb-keyval
- **Worker**: jose, Wrangler
@@ -27,9 +27,9 @@ The website, the Worker and the desktop / Android apps build on a stack of open-
When you add a new dep to `webapp/package.json`, also add it to the `THIRD_PARTY` array so the About page lists it, and to [`THIRD_PARTY.md`](THIRD_PARTY.md). House rules are in [CONTRIBUTING.md](../CONTRIBUTING.md).
## Browser extension — the other way in
## Retired helpers
[poli0981/itch-f2p-extension](https://github.com/poli0981/itch-f2p-extension) (GPL-3.0, separate repo) lets me queue itch.io games straight from the browser. It sends them through an authenticated API into the same review queue as the public [Suggest page](https://freeitchgames.win/suggest) and the RSS discovery. Nothing goes live until I approve it. (The old Telegram bot did this job in v3 and is now retired.)
Two side projects used to feed the catalog: the browser extension [poli0981/itch-f2p-extension](https://github.com/poli0981/itch-f2p-extension) (GPL-3.0) and, in v3, the Telegram bot [poli0981/telegram-scraper-bot](https://github.com/poli0981/telegram-scraper-bot) (MIT). Both were hardly used, so they are archived now (October 2026). Games come in through the public [Suggest page](https://freeitchgames.win/suggest), the RSS discovery and the itch.io collections I follow, and nothing goes live until it is approved.
## Find me / Support me
Real channels exist now (still introvert max level, replies slow):
+2 -2
View File
@@ -1,6 +1,6 @@
# Disclaimer
Last updated: 2026-09-29
Last updated: 2026-10-16
Applies from: the release of version 4.0.0.
@@ -31,7 +31,7 @@ The Project is independent. It is **not affiliated with, endorsed by, or sponsor
The Project **does not make, host, distribute, sell or endorse** the games it lists. Every game links to its own page on itch.io, and any download happens there, under itch.io's terms and the creator's own terms or license.
Games reach the catalog through the public Suggest page, the Maintainer's browser extension, or itch.io's public RSS feeds, and nothing is added until the Maintainer approves it. That approval is **not** a security audit, a quality check or an endorsement.
Games reach the catalog through the public Suggest page, itch.io's public RSS feeds, or public itch.io collections the Maintainer follows. Each one is approved by the Maintainer, one by one or through automatic rules the Maintainer sets. That approval is **not** a security audit, a quality check or an endorsement.
## 5. No warranty as to the games
+2 -2
View File
@@ -1,6 +1,6 @@
# End-User License Agreement (EULA)
Last updated: 2026-10-03
Last updated: 2026-10-16
Applies from: the release of version 4.2.0.
@@ -82,7 +82,7 @@ You agree not to:
- Present a modified build as an official release, for example by distributing it under the project's name and icon, or with the official app identifier `com.poli0981.freegamesitchio`, without clearly marking it as unofficial. Forks are welcome under the MIT License; just make it obvious they are Yours.
- Use the Maintainer's name, the GitHub handle `poli0981`, or the alias "SkullMute" to endorse or promote derivative works without prior written permission.
- Use the App, or a modified version of it, in a way that breaks the Website's [Terms of Use](ToS.md), for example automated bulk requests to the Website (the data is in the Repository), or attempts to reach the admin area or the ingest API without authorization.
- Use the App, or a modified version of it, in a way that breaks the Website's [Terms of Use](ToS.md), for example automated bulk requests to the Website (the data is in the Repository), or attempts to reach the admin area without authorization.
- Use the App or its installers to host, distribute or facilitate malware, phishing, or content that violates applicable law.
These rules are about how You use the App and the project's name and services. They sit alongside the MIT License and do not limit the rights it grants over the source code.
+9 -10
View File
@@ -1,8 +1,8 @@
# Privacy Policy
Last updated: 2026-10-03
Last updated: 2026-10-16
Applies from: 2026-10-03 on the Website, and from version 4.2.0 of the Apps.
Applies from: 2026-10-13 on the Website, and from version 4.4.0 of the Apps.
This Privacy Policy explains what personal data the `free-games-itchio-list` project processes, why, who helps process it, how long it is kept, and what rights you have. It covers the website **https://freeitchgames.win**, the desktop and Android apps, the public catalog data and the repository. The short version: there are no accounts, no ads and no tracking cookies. The Project keeps as little as it can, and most of what exists stays in your own browser.
@@ -36,7 +36,7 @@ The controller of the personal data described in this Policy is **the Maintainer
### 1.3 What this Policy does not cover
This Policy does not cover services that handle data on their own account: itch.io (every game link and every download goes there), GitHub for your GitHub account and your activity on github.com, Cloudflare's use of data for its own purposes as described in its privacy policy, the games themselves, or the Maintainer's browser extension, which is a separate project with its own documentation. Their own policies apply (links in section 4).
This Policy does not cover services that handle data on their own account: itch.io (every game link and every download goes there), GitHub for your GitHub account and your activity on github.com, Cloudflare's use of data for its own purposes as described in its privacy policy, or the games themselves. Their own policies apply (links in section 4).
## 2. What is processed and why
@@ -65,14 +65,14 @@ When you use the Suggest page (https://freeitchgames.win/suggest):
- **What is stored**: the game URL, your optional note (up to 500 characters) and the time of submission, in the review queue (section 2.4). No name, email address or account is asked for or stored.
- **Anti-spam**: Cloudflare Turnstile processes signals about your device and browser to tell people from bots. To check the result, the Website sends the Turnstile token and your IP address to Cloudflare's verification service.
- **Rate limiting**: your IP address is used transiently to count requests. The Project does not store it.
- **Purpose**: to review your suggestion. If it is approved, the game URL becomes part of the public Catalog. Your note is never published and is **deleted automatically after 180 days**.
- **Purpose**: to review your suggestion, by the Maintainer or by the automatic rules the Maintainer sets (section 2.4). If it is approved, the game URL becomes part of the public Catalog. Your note is never published and is **deleted automatically after 180 days**.
- **Please don't put personal data in the note**, yours or anyone else's. The form is for game links only.
### 2.4 The review queue and the admin area
- **How games arrive**: suggestions from the Suggest page; submissions from the Maintainer's browser extension through an authenticated API (the game URL, an optional title and note, and the extension's service-token ID; the records that prevent duplicate submissions are kept for 7 days); and automatic discovery from itch.io's public RSS feeds.
- **The review queue** (Cloudflare D1) holds candidate game URLs with their source, the title, cover-image URL and genre hint taken from itch.io, automatic flags, notes, timestamps and the Maintainer's decision. Nothing enters the Catalog until the Maintainer approves it. Rejected URLs are kept indefinitely as a blocklist; only the URL is needed to avoid reviewing the same game again.
- **The admin area** (https://freeitchgames.win/admin) is for the Maintainer only. It is protected by Cloudflare Access (GitHub login or a one-time PIN sent by email), which sets a `CF_Authorization` session cookie in the Maintainer's browser. Admin actions are recorded in an audit log together with the Maintainer's email address. The audit log is never published.
- **How games arrive**: suggestions from the Suggest page; automatic discovery from itch.io's public RSS feeds; and new free games in public itch.io collections the Maintainer follows (the Website reads those public pages; nothing about you is involved).
- **The review queue** (Cloudflare D1) holds candidate game URLs with their source, the title, cover-image URL and genre hint taken from itch.io, automatic flags, notes, timestamps and the Maintainer's decision. Games enter the Catalog when the Maintainer approves them: one by one, or through automatic rules the Maintainer sets and can change at any time (items without a warning flag that nobody rejected within a waiting time; new free games in collections the Maintainer follows). Automatic approvals are recorded in the audit log like the Maintainer's own. Rejected URLs are kept indefinitely as a blocklist; only the URL is needed to avoid reviewing the same game again.
- **The admin area** (https://freeitchgames.win/admin) is for the Maintainer only. It is protected by Cloudflare Access (GitHub login or a one-time PIN sent by email), which sets a `CF_Authorization` session cookie in the Maintainer's browser. Admin actions, including changes to the automatic rules, are recorded in an audit log together with the Maintainer's email address. The audit log is never published.
### 2.5 Public game data in the Catalog
@@ -145,7 +145,6 @@ Cloudflare and Google may process data anywhere on their global networks (see se
| IP address used for rate limiting and Turnstile | Used transiently; never stored by the Project |
| Suggest note | Deleted automatically after **180 days** |
| Suggested or discovered game URLs, with source and timestamps | In the review queue while needed to avoid reviewing the same game twice. Approved URLs become part of the public Catalog; rejected URLs are kept indefinitely as a blocklist |
| Duplicate-submission records from the browser extension | **7 days** |
| Admin audit log (with the Maintainer's email address) | Kept as the record of admin changes; never published |
| Catalog entries (including developer and publisher names) | While the game is listed. Removal records stay in the public removed-games list, and the Repository's Git history keeps past versions (see section 7.3) |
| Emails, including removal and copyright requests | As long as needed to handle the request |
@@ -219,8 +218,8 @@ Under the GDPR and the UK GDPR, you can also ask for processing to be restricted
- The Website is served only over HTTPS.
- Automated traffic has to pass a Cloudflare Turnstile check before the Website's pages and cover images load (section 2.1).
- Data minimization: no accounts, no IP addresses stored by the Project's code, Suggest notes deleted after 180 days, duplicate-submission records after 7 days.
- The admin area and the ingest API are protected by Cloudflare Access, and the Website's server code verifies the Access token itself on every protected request.
- Data minimization: no accounts, no IP addresses stored by the Project's code, Suggest notes deleted after 180 days.
- The admin area is protected by Cloudflare Access, and the Website's server code verifies the Access token itself on every protected request.
- Secrets (such as the GitHub App's private key) are kept in Cloudflare's secret storage, never in the Repository. The admin area writes to the Repository as a GitHub App, with verified commits.
- A strict Content Security Policy limits scripts to the Website itself plus Cloudflare Web Analytics and Turnstile.
- GitHub Actions are pinned to exact commit SHAs with least-privilege permissions, and Dependabot keeps dependencies up to date.
+20 -13
View File
@@ -1,6 +1,6 @@
# Third-party components
Last updated: 2026-10-03
Last updated: 2026-11-09
Applies from: the release of version 4.0.0.
@@ -28,22 +28,22 @@ shared UI components).
| Component | Version | Used for | License |
|---|---|---|---|
| [React](https://react.dev) (`react`, `react-dom`) | 19.3 | UI framework | MIT |
| [React Router](https://reactrouter.com) (`react-router`) | 8.4 | Routing | MIT |
| [React Router](https://reactrouter.com) (`react-router`) | 8.5 | Routing | MIT |
| [Zustand](https://github.com/pmndrs/zustand) | 5.0 | Preference and theme stores | MIT |
| [TanStack Query](https://tanstack.com/query) (`@tanstack/react-query`, `react-query-persist-client`) | 5.103 | Data fetching and the local catalog cache | MIT |
| [TanStack Query](https://tanstack.com/query) (`@tanstack/react-query`, `react-query-persist-client`) | 5.106 | Data fetching and the local catalog cache | MIT |
| [idb-keyval](https://github.com/jakearchibald/idb-keyval) | 6.3 | IndexedDB storage for the compressed catalog cache | Apache-2.0 |
| [fflate](https://github.com/101arrowz/fflate) | 0.8 | Decompressing the catalog where the browser has no Compression Streams (older Safari / iOS) | MIT |
| [Recharts](https://recharts.org) | 3.10 | Charts | MIT |
| [Radix UI](https://www.radix-ui.com) primitives (`@radix-ui/react-checkbox`, `-dialog`, `-label`, `-popover`, `-separator`, `-slot`, `-switch`, `-tabs`) | 1.x / 2.x | Accessible UI building blocks | MIT |
| [shadcn/ui](https://ui.shadcn.com) | pattern | Component patterns copied into `webapp/src/components/ui/` | MIT |
| [lucide-react](https://lucide.dev) | 1.47 | Icons | ISC |
| [lucide-react](https://lucide.dev) | 1.69 | Icons | ISC |
| [class-variance-authority](https://cva.style) | 0.7 | Component variants | Apache-2.0 |
| [clsx](https://github.com/lukeed/clsx) | 2.1 | Class-name helper | MIT |
| [tailwind-merge](https://github.com/dcastil/tailwind-merge) | 3.7 | Class-name merging | MIT |
| [Tailwind CSS](https://tailwindcss.com) (`tailwindcss`, `@tailwindcss/vite`) and [tw-animate-css](https://github.com/Wombosvideo/tw-animate-css) | 4.3 / 1.4 | Generate the site's CSS at build time | MIT |
| [Geist and Geist Mono](https://vercel.com/font) (`@fontsource-variable/geist`, `@fontsource-variable/geist-mono`) | 5.3 | The site's typefaces | OFL-1.1 (fonts), MIT (Fontsource packaging) |
| [`@tauri-apps/api`](https://github.com/tauri-apps/tauri/tree/dev/packages/api) | 2.11 | App-only bridge to the native shell | Apache-2.0 OR MIT |
| [`@tauri-apps/plugin-opener`](https://github.com/tauri-apps/plugins-workspace/tree/v2/plugins/opener) | 2.5 | App-only: opens itch.io links in the system browser | Apache-2.0 OR MIT |
| [`@tauri-apps/api`](https://github.com/tauri-apps/tauri/tree/dev/packages/api) | 2.12 | App-only bridge to the native shell | Apache-2.0 OR MIT |
| [`@tauri-apps/plugin-opener`](https://github.com/tauri-apps/plugins-workspace/tree/v2/plugins/opener) | 2.7 | App-only: opens itch.io links in the system browser | Apache-2.0 OR MIT |
`@tanstack/react-query-devtools` (MIT) is listed as a dependency but only renders in development builds.
@@ -69,20 +69,21 @@ components. Section 7 lists every service the project uses.
| [tauri](https://tauri.app), `tauri-build` | 2 | App shell and build helper | Apache-2.0 OR MIT |
| [tauri-plugin-opener](https://github.com/tauri-apps/plugins-workspace/tree/v2/plugins/opener) | 2 | Opening links in the system browser | Apache-2.0 OR MIT |
| [tauri-plugin-single-instance](https://github.com/tauri-apps/plugins-workspace/tree/v2/plugins/single-instance) | 2 | Desktop only: focuses the running window instead of starting a second copy | Apache-2.0 OR MIT |
| [serde](https://serde.rs), [serde_json](https://github.com/serde-rs/json) | 1 | Serialization | MIT OR Apache-2.0 |
| [serde](https://serde.rs) | 1 | Serialization | MIT OR Apache-2.0 |
The apps render with the system web view that the operating system provides: WebView2 on Windows,
WKWebView on macOS (Safari/WebKit 16.4 or later), WebKitGTK on Linux and Android System WebView on Android.
## 4. Data pipeline (Python 3.14)
## 4. Data pipeline (Python 3.15)
| Package | Version | Used for | License |
|---|---|---|---|
| [requests](https://requests.readthedocs.io) | 2.34+ | HTTP requests to public itch.io pages | Apache-2.0 |
| [beautifulsoup4](https://www.crummy.com/software/BeautifulSoup/) | 4.15+ | Parsing itch.io pages | MIT |
| [urllib3](https://urllib3.readthedocs.io) | 2.8+ | Retry policy of the scraper's HTTP session | MIT |
These pull in `urllib3` (MIT), `certifi` (MPL-2.0), `charset-normalizer` (MIT), `idna` (BSD-3-Clause) and
`soupsieve` (MIT).
These pull in `certifi` (MPL-2.0), `charset-normalizer` (MIT), `idna` (BSD-3-Clause) and `soupsieve`
(MIT).
## 5. Development and test tooling (never shipped)
@@ -104,8 +105,9 @@ These tools never end up in a build, but they keep the code honest.
- **[ESLint](https://eslint.org)** with `@eslint/js`, **[typescript-eslint](https://typescript-eslint.io)**,
`eslint-plugin-react-hooks`, `eslint-plugin-react-refresh` and `globals` (all MIT): webapp linting.
Config: [`webapp/eslint.config.js`](../webapp/eslint.config.js). Run: `cd webapp && npm run lint`
- **[TypeScript](https://www.typescriptlang.org)** 6.0 (Apache-2.0): `noUnusedLocals` and
`noUnusedParameters` reject unused code at build time. Run: `cd webapp && npx tsc -b`
- **[TypeScript](https://www.typescriptlang.org)** 7.0 (Apache-2.0): `noUnusedLocals` and
`noUnusedParameters` reject unused code at build time. Run: `cd webapp && npx tsc -b`. The 6.0 API
(`@typescript/typescript6`, installed as `typescript`) stays for typescript-eslint, which needs it
### Build, test and deploy
@@ -113,10 +115,12 @@ These tools never end up in a build, but they keep the code honest.
|---|---|---|
| [Vite](https://vite.dev) 8 and `@vitejs/plugin-react` | Bundling the site, the admin app and the apps' front end | MIT |
| [Vitest](https://vitest.dev) 5 | Tests (`npm test`) | MIT |
| [`@vitest/coverage-v8`](https://vitest.dev/guide/coverage) 5 | Test coverage for SonarQube Cloud (`npm run test:coverage`) | MIT |
| [Wrangler](https://developers.cloudflare.com/workers/wrangler/) 4 | Local Worker dev, D1 migrations, deploys | MIT OR Apache-2.0 |
| [`@tauri-apps/cli`](https://tauri.app) 2 | Building the desktop and Android apps | Apache-2.0 OR MIT |
| `@types/node`, `@types/react`, `@types/react-dom` | Type definitions | MIT |
| [pytest](https://pytest.org) | Python tests (network blocked) | MIT |
| [pytest-cov](https://pytest-cov.readthedocs.io) and [coverage.py](https://coverage.readthedocs.io) | Python test coverage for SonarQube Cloud (`pytest --cov`) | MIT; Apache-2.0 |
| [Pillow](https://python-pillow.github.io) | [`webapp/scripts/gen_assets.py`](../webapp/scripts/gen_assets.py), which generates the icons and the social preview image | MIT-CMU |
## 6. GitHub Actions
@@ -124,7 +128,8 @@ These tools never end up in a build, but they keep the code honest.
The workflows in [`.github/workflows/`](../.github/workflows/) use `actions/checkout`, `actions/setup-node`,
`actions/setup-python`, `actions/setup-java`, `actions/cache`, `actions/upload-artifact`,
`actions/download-artifact`, `android-actions/setup-android`, `dtolnay/rust-toolchain`,
`tauri-apps/tauri-action` and reusable workflows from [poli0981/.github](https://github.com/poli0981/.github).
`tauri-apps/tauri-action`, `SonarSource/sonarqube-scan-action`, `JetBrains/qodana-action` and reusable workflows from
[poli0981/.github](https://github.com/poli0981/.github).
Every external action is pinned to a commit SHA. The actions run on GitHub's runners and are not
distributed with the project; each one is under the license in its own repository.
@@ -135,6 +140,8 @@ distributed with the project; each one is under the license in its own repositor
| **Cloudflare** | DNS, CDN, WAF, TLS; Workers and static assets (the website); R2 (resized cover images); D1 (the review queue); Images (resizing); Turnstile (the verification page and the Suggest page); Web Analytics (cookieless, aggregate); Workers Logs; Access (admin login); Rate Limiting |
| **Google Workspace** | The Maintainer's mailbox on poli0981.dev, which receives the project's contact addresses |
| **GitHub** | Code, catalog data, issues and discussions, Actions (the pipeline), release downloads |
| **SonarQube Cloud** (SonarSource) | Code analysis and test coverage of the public repository, on pushes to `main` and on pull requests |
| **Qodana** (JetBrains) | Code analysis of the public repository (TypeScript / JavaScript, Python, Rust), on pushes to `main` and on pull requests |
| **itch.io** | Where the games live; the pipeline and RSS discovery read public itch.io pages and feeds |
| **Discord** | Receives automated CI and release notifications only |
+4 -4
View File
@@ -1,8 +1,8 @@
# Terms of Use
Last updated: 2026-10-03
Last updated: 2026-10-16
Applies from: 2026-10-03 on the Website, and from version 4.2.0 of the Apps.
Applies from: 2026-10-13 on the Website, and from version 4.4.0 of the Apps.
These Terms of Use ("Terms") govern your use of the website **https://freeitchgames.win**, the desktop and Android apps, and the public catalog data of `free-games-itchio-list`. They are written in plain language, but they are a real agreement. They replace the older Terms and also cover what the old web-app "EULA" used to say; the [EULA](EULA.md) now covers only the app installers and the Android APK.
@@ -47,7 +47,7 @@ These Terms of Use ("Terms") govern your use of the website **https://freeitchga
- **Suggest page** (https://freeitchgames.win/suggest): you can submit an itch.io game link and an optional note of up to 500 characters. The page uses Cloudflare Turnstile against spam and is rate limited.
- The note is seen only by the Maintainer and is deleted after 180 days. **Do not put personal data in it.** See the [Privacy Policy](PrivacyPolicy.md).
- Every suggestion goes into a **review queue**. Nothing enters the Catalog until the Maintainer approves it, and the Maintainer has no obligation to accept a suggestion or to reply. Approved links are then scraped by the pipeline, and games that turn out to be paid are dropped.
- Every suggestion goes into a **review queue**. The Maintainer approves or rejects it there, one by one or through automatic rules the Maintainer sets: a suggestion that raises no warning flag and that nobody rejected within the waiting time the Maintainer chose (currently about a day) may be approved automatically. The Maintainer has no obligation to accept a suggestion or to reply. Approved links are then scraped by the pipeline, and games that turn out to be paid are dropped.
- Only genuinely **free-to-play** games on itch.io qualify. Demos of paid games, "name your own price" titles with a minimum above zero, and time-limited free promotions do not.
- By submitting anything to the Project (a suggestion, an issue, a pull request or a comment), you confirm that:
- it is your own work, or you have the right to share it;
@@ -62,7 +62,7 @@ You agree **not** to:
1. **Bulk-scrape** the Website or its API, including the files under `/data`. Get the data from the Repository instead; it is cheaper for everyone.
2. **Abuse the image proxy** (`/img`): it exists only to show cover images on the Website. Don't hotlink `/img` URLs from other sites or apps, and don't use it to fetch images in bulk.
3. **Access restricted areas without authorization**: `/admin`, the admin API (`/api/admin/…`) and the ingest API (`/api/ingest`) are for the Maintainer only. Good-faith security research is welcome under the rules of the [Security Policy](../SECURITY.md).
3. **Access restricted areas without authorization**: `/admin` and the admin API (`/api/admin/…`) are for the Maintainer only. Good-faith security research is welcome under the rules of the [Security Policy](../SECURITY.md).
4. **Spam the Suggest form**, or circumvent the Website's verification check, Turnstile or the rate limits (for example with scripts, shared verification cookies or rotating IP addresses).
5. **Submit links to malware**, scams, phishing, or illegal content, anywhere in the Project.
6. **Misrepresent affiliation**: don't claim to be the Maintainer or the Project, don't present a fork or copy as the official Project, don't claim that the Project is run or endorsed by itch.io, and don't use the names "poli0981" or "SkullMute" to endorse your own work without prior written permission.
+26 -5
View File
@@ -15,12 +15,17 @@ JetBrains 2026.x (paid lineup):
VS Code, Sublime, vim, etc. all work fine; nothing JetBrains-specific is
checked into the repo.
TypeScript 7 (the `tsc` that `npm run build` runs) is a native binary without `tsserver`. In VS Code,
install the TypeScript Native Preview extension (`TypeScriptTeam.native-preview`) for the TS 7
language server. In WebStorm, use its TypeScript 7 support or point *Languages & Frameworks →
TypeScript* at `webapp/node_modules/@typescript/old` (TypeScript 6.0, which reports the same errors).
## Language toolchains
| Stack | Required | Used for |
|-------|----------|----------|
| Python | 3.14 (`.python-version`) | Data pipeline (`scripts/`) and its tests |
| Node.js | 22.22+ (CI uses `webapp/.node-version`) | Web app, admin app, Worker, Tauri front end |
| Python | 3.15 (`.github/python-version`) | Data pipeline (`scripts/`) and its tests |
| Node.js | 26+ (CI uses `webapp/.node-version`) | Web app, admin app, Worker, Tauri front end |
| npm | ships with Node.js | Dependencies (`npm ci` from `package-lock.json`) |
| Wrangler | project dependency (`npx wrangler`) | Local Worker, local D1, deploys |
| Rust | stable (via `rustup`) | Tauri desktop / Android builds only |
@@ -39,8 +44,13 @@ python -m venv .venv
pip install -r requirements-dev.txt
```
On Windows, set `PYTHONUTF8=1` (PowerShell: `$env:PYTHONUTF8 = "1"`) so Python reads and writes
the catalog files as UTF-8.
Python 3.15 reads and writes files as UTF-8 by default (UTF-8 mode, PEP 686), so Windows no longer
needs `PYTHONUTF8=1`.
Both requirements files pin every package with its hashes; pip checks them on install. To add or
change a dependency, edit `requirements.in` or `requirements-dev.in` and recompile the lock with
pip-tools — the command is at the top of each `.in` file (run it on Python 3.14, which Dependabot
can read; CLAUDE.md, gotcha 40).
### Checks (same as `python-ci.yml`)
@@ -52,6 +62,9 @@ vulture # dead code
python scripts/validate.py # checks every catalog data file
```
`pytest --cov --cov-report=xml` also measures coverage and writes `coverage.xml`, as the SonarQube
Cloud workflow (`sonarcloud.yml`) does.
### Try a real scrape
These make real requests to itch.io:
@@ -160,15 +173,23 @@ the queue bookkeeping. Use it sparingly.
```sh
cd webapp
npm run check:tauri # Tauri crates and their npm packages share major.minor
npm run cf:types -- --check # worker-configuration.d.ts matches wrangler.jsonc
npm run lint # ESLint
npm run knip # unused files / exports / dependencies
npm test # Vitest: app + Worker; D1 tests start a local workerd
npx tsc -b # type-check only (npm run build runs it too)
npm run build
npx wrangler deploy --dry-run --env="" # validates the Worker config, deploys nothing
npm run cf:check # wrangler deploy --dry-run: validates the Worker config, deploys nothing
```
`npm run test:coverage` runs the tests with v8 coverage and writes `coverage/lcov.info`, as the
SonarQube Cloud workflow (`sonarcloud.yml`) does.
Qodana (JetBrains) also analyses the code in CI (`qodana.yml`: TypeScript / JavaScript, Python and
Rust, each with its own `qodana.yaml`). It needs the project tokens, so it has no local command here;
the same inspections are built into WebStorm, PyCharm and RustRover.
After editing `wrangler.jsonc`, run `npm run cf:types` and commit the regenerated
`worker-configuration.d.ts`.
+196
View File
@@ -0,0 +1,196 @@
# Trợ năng (Accessibility)
Cập nhật lần cuối: 2026-11-09
Áp dụng từ: khi phát hành phiên bản 4.6.0 (website và các ứng dụng desktop, Android).
> Bản dịch từ bản tiếng Anh cập nhật ngày 2026-11-09 (English source revision 2026-11-09). Nếu có khác biệt, bản tiếng Anh được ưu tiên. Bản gốc: [`ACCESSIBILITY.md`](../../../ACCESSIBILITY.md).
Đây là một dự án sở thích do một người vận hành, poli0981 (SkullMute), dưới đây gọi là "Người duy trì": một danh mục game itch.io miễn phí, có trên website https://freeitchgames.win và trong các ứng dụng desktop, Android hiển thị cùng các trang đó. Ai cũng nên dùng được, dù bạn chỉ dùng bàn phím, trình đọc màn hình, phóng to, giao diện tương phản cao, nhập liệu bằng giọng nói hay bất cứ công cụ nào khác. Tuyên bố này cho biết những gì đã hoạt động, cách kiểm tra, những gì chưa ổn, và cách báo cho Người duy trì khi có gì đó cản trở bạn.
> **Tóm tắt (TL;DR)**
>
> - Mục tiêu là [WCAG 2.2](https://www.w3.org/TR/WCAG22/) mức AA cho website và các ứng dụng. Đó là mục tiêu, không phải chứng nhận: chưa có ai ngoài dự án đánh giá.
> - Mọi trang đều dùng được chỉ với bàn phím và với trình đọc màn hình. Người duy trì kiểm tra bằng bàn phím (không dùng chuột), Windows Narrator, và VoiceOver trên iPhone.
> - Màu sắc đạt tỉ lệ tương phản WCAG ở cả giao diện sáng và tối, và một bài test kiểm tra lại sau mỗi thay đổi. Hỗ trợ chế độ tương phản (Contrast themes) của Windows và làm theo thiết lập "giảm chuyển động" của hệ thống.
> - Mỗi biểu đồ đều có bảng dữ liệu đi kèm.
> - Các hạn chế đã biết nằm ở [§6](#6-các-hạn-chế-đã-biết).
> - Có gì cản trở bạn? Hãy mở một [issue trợ năng](https://github.com/poli0981/free-games-itchio-list/issues/new?template=accessibility.yml) hoặc email **contact@poli0981.dev**.
## 1. Phạm vi
Tuyên bố này áp dụng cho:
- **website** https://freeitchgames.win: mọi trang công khai (Trang chủ, Games, trang từng game, Charts, Removed, Suggest, Settings, About, các trang lỗi) và trang xác minh hiện ra trước đó;
- **các ứng dụng desktop** (Windows, macOS, Linux) **và ứng dụng Android**, vốn hiển thị cùng các trang trong web view của hệ thống.
Tuyên bố này không áp dụng cho:
- bản thân các game, trang itch.io của chúng, và những gì người tạo game viết hay làm ra (tên, mô tả, tag, ảnh bìa);
- Cloudflare Turnstile, bước kiểm tra của bên thứ ba trên trang xác minh và trên form Suggest (Cloudflare chịu trách nhiệm về trợ năng của nó);
- trang quản trị của Người duy trì, vốn chỉ có một người dùng;
- các trang web khác được liên kết tới, kể cả GitHub.
## 2. Mục tiêu và ưu tiên
- **Mục tiêu**: [WCAG 2.2](https://www.w3.org/TR/WCAG22/) mức AA, trong khả năng của một dự án sở thích do một người làm.
- **Trước hết**: các việc chính dùng được với bàn phím và trình đọc màn hình: tìm game, đọc thông tin, mở game trên itch.io, đổi cài đặt, gợi ý game.
- **Tiếp theo**: chữ và nút dễ đọc (tương phản, phóng to, dàn lại bố cục), không có chuyển động bạn không yêu cầu, và đúng ngôn ngữ cho trình đọc màn hình (tiếng Anh hoặc tiếng Việt).
- **Luôn luôn**: tính năng mới phải giữ được tất cả những điều trên (xem [§8](#8-dành-cho-người-đóng-góp)).
## 3. Những gì đã hoạt động
### Di chuyển trong trang
- "Chuyển đến nội dung" (Skip to content) là thứ đầu tiên phím Tab chạm tới.
- Mỗi trang có các vùng mốc (landmark) được đặt tên (đầu trang, menu chính, tìm kiếm, nội dung chính, phân trang, chân trang), một tiêu đề cấp 1 và tiêu đề trang riêng.
- Khi bạn bấm một liên kết bên trong site, focus chuyển tới tiêu đề của trang mới, nên trình đọc màn hình đọc tên trang và phím Tab đi tiếp từ đó. Khi quay lại, focus trở về liên kết bạn vừa dùng, ví dụ game bạn mở từ danh sách.
- Thanh đầu trang cố định không bao giờ che phần tử đang có focus bàn phím.
### Bàn phím
- Mọi thứ đều dùng được chỉ với bàn phím: menu, bộ lọc, hộp thoại và biểu đồ.
- Focus luôn nhìn thấy được: một đường viền tím, hoặc màu tô sáng của hệ thống trong chế độ tương phản.
- Hộp thoại giữ focus bên trong khi đang mở và trả focus về chỗ cũ khi đóng.
- Phím "/" đưa bạn tới ô tìm kiếm. Bạn có thể tắt phím tắt này trong **Settings → Trợ năng**, hữu ích khi nhập liệu bằng giọng nói hoặc khi phím này xung đột với trình đọc màn hình hay chức năng tìm nhanh của trình duyệt.
- Khi một nút biến mất sau khi bạn dùng nó (xoá ô tìm kiếm, bỏ một bộ lọc), focus chuyển tới chỗ hợp lý tiếp theo thay vì bị mất.
### Trình đọc màn hình
- Mọi nút điều khiển đều có tên, bằng tiếng Anh hoặc tiếng Việt. Biểu tượng được ẩn khỏi trình đọc màn hình.
- Số kết quả, gợi ý tìm kiếm, trạng thái đang tải và thông báo của form đều được đọc lên.
- Trên màn hình rộng, danh sách game là một bảng có tiêu đề cột; trên điện thoại là một danh sách đơn giản.
- Liên kết mở thẻ mới (trong ứng dụng: mở trình duyệt) đều nói rõ điều đó.
- Chữ thuộc ngôn ngữ kia, như tên các ngôn ngữ và tên tiếng Anh của các văn bản pháp lý, được đánh dấu đúng ngôn ngữ.
### Nhìn nội dung
- Chữ và nút đạt tỉ lệ tương phản WCAG 2.2 AA ở cả hai giao diện: 4.5:1 cho chữ, 3:1 cho viền ô nhập, đường viền focus và màu biểu đồ. Bài test [`webapp/scripts/check-contrast.test.mjs`](../../../webapp/scripts/check-contrast.test.mjs) kiểm tra màu sau mỗi thay đổi.
- Giao diện sáng, tối hoặc theo hệ thống; dòng gọn hoặc thường; ẩn thanh cuộn: tất cả nằm trong Settings.
- Chế độ tương phản của Windows (forced colors): tab đang chọn, nút bật/tắt đang bấm, trang hiện tại và các công tắc dùng màu tô sáng của hệ thống.
- Không bao giờ chặn phóng to. Ở mức phóng 400 % hoặc cửa sổ rộng 320 pixel, bố cục điện thoại được dùng và trang không phải cuộn ngang.
- Liên kết nằm trong câu đều được gạch chân. Không có gì chỉ dựa vào màu sắc: trạng thái luôn kèm thay đổi chữ, viền hoặc gạch chân.
### Chuyển động
- Khi bạn bật "giảm chuyển động" trong hệ thống, hiệu ứng, phần biểu đồ hiện ra và cuộn mượt đều tắt.
- Trên website, ảnh bìa thường được hiển thị dạng ảnh tĩnh (ảnh bìa động được chuyển thành ảnh tĩnh).
- Ngoài các khối giữ chỗ khi đang tải, không có gì tự chuyển động.
### Biểu đồ
- Mỗi biểu đồ được đặt tên theo tiêu đề của nó. Đưa focus vào biểu đồ rồi dùng phím mũi tên trái, phải: giá trị bạn chuyển tới sẽ được đọc lên.
- Dưới mỗi biểu đồ, **Bảng dữ liệu** mở cùng các số liệu dưới dạng bảng, kèm tỉ lệ từng phần với biểu đồ tròn.
### Ngôn ngữ
- Các trang có tiếng Anh và tiếng Việt (Settings), và ngôn ngữ của trang đi theo lựa chọn của bạn, nên trình đọc màn hình chọn đúng giọng đọc. Số và ngày tháng cũng theo ngôn ngữ đó.
## 4. Cách kiểm tra
- **Người duy trì kiểm tra thủ công** (tháng 11/2026): website trên Windows 11 và ứng dụng desktop Windows, chỉ dùng bàn phím (tắt chuột) và Windows Narrator. Không thấy lỗi nào chặn việc sử dụng.
- **Trên điện thoại thật** (tháng 11/2026, phiên bản 4.6.0): website trên iPhone 14 Pro với VoiceOver, trong Safari, Chrome và Brave. Kết quả: đạt.
- **Cho bản 4.6.0**: các trang chính và hộp thoại được đi hết bằng bàn phím, và cây trợ năng (accessibility tree) của chúng được kiểm tra (tên, vai trò, tiêu đề, vùng mốc, thông báo) bằng tiếng Anh và tiếng Việt, trên màn hình máy tính và màn hình cỡ điện thoại.
- **Tự động, sau mỗi thay đổi**: bài test tương phản ở trên và các unit test của ứng dụng (focus đi đâu sau khi đổi trang, bảng dữ liệu biểu đồ).
- **Trước mỗi lần phát hành**: một lượt kiểm tra nhanh. Gồm đi hết các việc chính bằng bàn phím, thử nhanh với trình đọc màn hình, phóng to 200 % và cửa sổ hẹp, giảm chuyển động, và một chế độ tương phản của Windows.
- **Chưa có**: quét tự động trên trình duyệt (như axe hay Lighthouse) trong CI, và việc kiểm tra bởi những người dùng hằng ngày nhiều công cụ hỗ trợ khác nhau. Mọi sự giúp đỡ đều được hoan nghênh.
## 5. Môi trường được hỗ trợ
| | Phiên bản |
|---|---|
| Website | Chrome, Edge, Firefox và Safari hiện hành trên máy tính và điện thoại. Các phiên bản cũ nhất mà site được build cho là Chrome và Edge 111, Firefox 114, Safari và iOS 15.4. |
| Ứng dụng desktop | Windows 10 và 11 (Microsoft Edge WebView2), macOS (WebKit 16.4 trở lên), Linux (WebKitGTK 4.1) |
| Ứng dụng Android | Android 11 trở lên |
Công cụ hỗ trợ (assistive technology):
- **Đã kiểm tra**: Windows Narrator trên Windows 11, VoiceOver trên iOS (iPhone 14 Pro: Safari, Chrome và Brave), và dùng chỉ bàn phím.
- **Dự kiến dùng được, chưa kiểm tra thường xuyên**: NVDA và JAWS trên Windows, VoiceOver trên macOS, TalkBack trên Android, phóng to của trình duyệt, chế độ tương phản của Windows, nhập liệu bằng giọng nói. Chúng dựa trên cùng mã HTML chuẩn.
- **Hạn chế**: Orca trong ứng dụng desktop Linux, vì WebKitGTK hỗ trợ trình đọc màn hình kém hơn các trình duyệt.
## 6. Các hạn chế đã biết
- **Chữ của người tạo game không được đánh dấu ngôn ngữ.** Tên, mô tả và tag của game lấy từ itch.io bằng nhiều ngôn ngữ, và trình đọc màn hình đọc chúng theo ngôn ngữ của trang.
- **Ảnh bìa chỉ có mô tả chung** ("Tên game cover"). Nội dung bức ảnh không được mô tả.
- **Biểu đồ**: phím mũi tên chỉ di chuyển trái và phải. Biểu đồ treemap thể loại không đi từng phần được, nhưng số liệu của nó có trong bảng dữ liệu và trong biểu đồ Genres. Chữ trong biểu đồ có cỡ pixel cố định, nên tăng cỡ chữ mặc định của trình duyệt không làm nó to lên (phóng to trang thì có).
- **Ứng dụng desktop**: không có phím phóng to bên trong ứng dụng, cửa sổ không phóng to toàn màn hình (maximize) được, và không thu nhỏ hơn 900 × 600. Nếu cần chữ lớn hơn, hãy dùng tỉ lệ hiển thị (display scaling) của hệ thống hoặc mở website trong trình duyệt.
- **Ứng dụng Android**: không phóng to bằng hai ngón tay được. Website trong trình duyệt điện thoại thì phóng to được.
- **Ảnh bìa động trong ứng dụng**: ứng dụng tải ảnh bìa trực tiếp từ itch.io, nên ảnh bìa động vẫn chạy ở đó.
- **Bước kiểm tra của Cloudflare**: bước xác minh (chỉ trên website) và bước chống spam của form Suggest là widget Cloudflare Turnstile. Thường chúng tự qua mà bạn không cần làm gì. Nếu có lúc chúng yêu cầu điều bạn không làm được, hãy email Người duy trì.
- **Trang trên GitHub**: các chính sách, tuyên bố này và các form issue nằm trên GitHub, nên trợ năng của chính GitHub áp dụng ở đó.
- **Chưa có đánh giá độc lập**, và chỉ có một người duy trì.
## 7. Báo cáo rào cản trợ năng
Nếu có gì ngăn bạn hoặc làm bạn chậm lại, hãy cho biết. Báo cáo chưa đầy đủ cũng có ích.
- **GitHub**: mở một [issue Accessibility barrier](https://github.com/poli0981/free-games-itchio-list/issues/new?template=accessibility.yml).
- **Email**: **contact@poli0981.dev**. Không cần tài khoản GitHub; viết tiếng Anh hay tiếng Việt đều được.
Những chi tiết có ích, trong chừng mực bạn thấy thoải mái chia sẻ (đừng bao giờ gửi thông tin sức khoẻ):
- bạn đang định làm gì, và điều gì đã xảy ra;
- trang (địa chỉ) hoặc ứng dụng và phiên bản của nó, xem trên trang About;
- thiết bị, hệ điều hành và trình duyệt;
- công cụ hỗ trợ bạn dùng và phiên bản, nếu có;
- ảnh chụp màn hình hoặc video, nếu được.
Mức độ ảnh hưởng:
| Mức độ | Ý nghĩa |
|---|---|
| Critical (nghiêm trọng nhất) | Bạn hoàn toàn không làm được một việc chính, ví dụ mở game hay đọc thông tin của nó. |
| Serious (nghiêm trọng) | Bạn làm được, nhưng rất vất vả hoặc phải đi đường vòng. |
| Moderate (trung bình) | Gây phiền hoặc không nhất quán, nhưng vẫn làm được. |
| Minor (nhỏ) | Một chi tiết nhỏ cần chỉnh. |
Điều gì xảy ra tiếp theo. Đây là mục tiêu, không phải cam kết, vì đây là dự án sở thích của một người:
- **Xác nhận đã nhận** trong vòng 7 ngày, thường sớm hơn.
- **Sửa lỗi hoặc đưa cách khắc phục tạm**: Critical trong 30 ngày, Serious trong 60 ngày, Moderate và Minor ở một bản phát hành sau.
- **Bản sửa cho website** có hiệu lực khi được deploy; **bản sửa cho ứng dụng** đi kèm bản phát hành tiếp theo.
- Bạn sẽ được hỏi bản sửa đã ổn với bạn chưa, và được ghi công trong release notes nếu muốn.
Lỗ hổng bảo mật không nên đưa vào issue công khai: xem [Chính sách bảo mật](SECURITY.md).
## 8. Dành cho người đóng góp
Thay đổi giao diện phải giữ đúng những điều ở [§3](#3-những-gì-đã-hoạt-động):
- **Bàn phím**: mọi nút đều tới được và dùng được, focus luôn nhìn thấy và không bị mất.
- **Tên**: mọi nút có nhãn, với chữ có trong cả `webapp/src/lib/i18n/en.ts` và `vi.ts`.
- **Màu sắc**: dùng các token của theme. `npm test` kiểm tra tương phản (4.5:1 cho chữ, 3:1 cho viền, focus và màu biểu đồ), và màu sắc không bao giờ là tín hiệu duy nhất.
- **Chuyển động**: tôn trọng `prefers-reduced-motion`; quy tắc CSS dùng chung và `SERIES_ANIMATION` đã làm việc đó.
- **Trình đọc màn hình**: kiểm tra thay đổi ít nhất một lần với một trình đọc (Narrator, NVDA, VoiceOver hoặc TalkBack).
- **Mã HTML**: ưu tiên phần tử gốc và các component Radix / shadcn đang dùng, chỉ thêm ARIA khi thật cần.
Tài liệu: tiêu đề theo đúng thứ tự, chữ của liên kết nói rõ nó dẫn tới đâu, ảnh có alt, bảng có ô tiêu đề, và bản tiếng Việt được cập nhật (hoặc ghi rõ trong pull request là chưa).
[Pull request template](../../../.github/pull_request_template.md) có sẵn danh sách kiểm tra.
## 9. Tìm game có hỗ trợ tiếp cận
Danh mục hiển thị các tính năng hỗ trợ tiếp cận mà người tạo game liệt kê trên trang itch.io của họ, như phụ đề, điều khiển tuỳ chỉnh được hay chế độ cho người mù màu:
- trên trang của từng game, ở mục "Hỗ trợ tiếp cận";
- trong bộ lọc Hỗ trợ tiếp cận ở trang Games, ví dụ https://freeitchgames.win/games?access=Subtitles;
- trong biểu đồ "Tính năng hỗ trợ tiếp cận" (Charts → Khám phá).
Người tạo game tự khai báo các tính năng này, và dự án không kiểm chứng. Nếu thông tin của một game sai, hãy báo bằng issue template "Bug Report".
## 10. Tài liệu tham khảo
- [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): tuyên bố này theo dàn ý của mẫu ACCESSIBILITY.md trong đó, với lời văn riêng.
- [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. Liên hệ
- **Rào cản trợ năng**: [form issue](https://github.com/poli0981/free-games-itchio-list/issues/new?template=accessibility.yml) hoặc **contact@poli0981.dev**.
- **Mọi việc khác**: xem các địa chỉ trong [README → Pháp lý](../../../README.vi.md#pháp-lý).
## 12. Lời cuối
Một người, một danh mục, và mọi cách duyệt web. Nếu có gì ở đây không hợp với cách bạn dùng web, Người duy trì thật sự muốn được biết — đó là cách danh sách này ngày càng tốt hơn. 🚀
+1 -1
View File
@@ -4,7 +4,7 @@ Cập nhật lần cuối: 2026-09-29
Áp dụng từ: khi phát hành phiên bản 4.0.0.
> Bản dịch từ bản tiếng Anh cập nhật ngày 2026-09-18 (English source revision 2026-09-18). Nếu có khác biệt, bản tiếng Anh được ưu tiên. Bản gốc: [`CODE_OF_CONDUCT.md`](../../../CODE_OF_CONDUCT.md).
> Bản dịch từ bản tiếng Anh cập nhật ngày 2026-09-29 (English source revision 2026-09-29). Nếu có khác biệt, bản tiếng Anh được ưu tiên. Bản gốc: [`CODE_OF_CONDUCT.md`](../../../CODE_OF_CONDUCT.md).
Đây là một repo sở thích nhỏ về game itch.io miễn phí, do một dev noob đang thất nghiệp vận hành: poli0981 (SkullMute), dưới đây gọi là "Người duy trì". Nói đơn giản: hãy cư xử đàng hoàng. Người duy trì là introvert max level với kỹ năng xã hội bằng không, nên mình cùng giữ mọi thứ tích cực nhé.
+43 -32
View File
@@ -1,14 +1,22 @@
# Hướng dẫn đóng góp
> Bản dịch từ bản tiếng Anh cập nhật ngày 2026-09-24 (English source revision 2026-09-24). Nếu có khác biệt, bản tiếng Anh được ưu tiên.
> Bản 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 [`CONTRIBUTING.md`](../../../CONTRIBUTING.md) là bản chính thức.
Cảm ơn bạn vì đã có suy nghĩ đóng góp cho cái repo random này! Tôi chỉ là một dev người Việt thất nghiệp, hướng nội, kỹ năng tầm tầm, có hai trợ lý AI không phán xét: **Grok (xAI)** cho brainstorming đêm khuya và **Claude Code (Anthropic)** cho phần việc code/docs nặng hơn. Danh sách này sống nhờ sự giúp đỡ của cộng đồng, vì tôi quá lười để tự đi săn/sửa hết một mình :D Bất kỳ đóng góp nào (kể cả chỉ một game) cũng khiến bạn thành huyền thoại.
## 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 ở trạng thái **ổn định và chỉ bảo trì**. 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.
- **Maintainer vẫn làm**: vá bảo mật (CVE và báo cáo gửi qua [SECURITY](SECURITY.md)), cập nhật runtime và thư viện phụ thuộc, 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.
- **Không còn làm**: tính năng mới, thiết kế lại, refactor.
- **Issue và pull request chỉ được nhận cho dữ liệu**: thêm game (mục 1), sửa dữ liệu của một game hoặc gỡ game (mục 2 và 3). Rào cản trợ năng (mục 3) và báo cáo bảo mật vẫn giữ kênh riêng. Mọi thứ khác sẽ bị đóng mà không review; không giận gì nhau cả.
## Cách đóng góp (Đi đúng cửa, tôi lười ;D)
Game thì gửi qua website; mọi thứ khác thì qua các template issue/PR trên GitHub. Chúng làm cuộc đời tôi dễ hơn và giảm các khoảnh khắc "wtf".
Game thì gửi qua website; sửa dữ liệu và gỡ game thì qua các issue template trên GitHub hoặc email. Chúng làm cuộc đời tôi dễ hơn và giảm các khoảnh khắc "wtf".
### 1. Đề xuất game mới (Hoan nghênh nhất!)
@@ -16,16 +24,17 @@ Game thì gửi qua website; mọi thứ khác thì qua các template issue/PR t
- Tùy chọn: một ghi chú ngắn (vì sao game hay, cảnh báo nội dung…), tối đa 500 ký tự. Ghi chú bị xóa sau 180 ngày. Vui lòng đừng ghi dữ liệu cá nhân vào đó.
- Một bước kiểm tra Cloudflare Turnstile và giới hạn tần suất giúp chặn bot; nếu bị chặn, đợi một lúc rồi thử lại.
- Chỉ game itch.io **miễn phí**. Game trả phí sẽ tự động bị loại khi trang game được cào.
- Không có gì lên site ngay lập tức: mọi đề xuất đều vào **hàng chờ duyệt**, và không có gì vào danh mục cho tới khi Maintainer duyệt. Link được duyệt sau đó được pipeline dữ liệu cào và xuất hiện trên site sau lần deploy kế tiếp.
- Game phải chơi được hoặc tải được **ngay trên trang itch.io của nó** (bản chạy trên trình duyệt hoặc file đã tải lên). Trang chỉ dẫn sang launcher hay link tải ở site khác thì không đủ điều kiện, kể cả khi miễn phí: [Tuyên bố miễn trừ](DISCLAIMER.md) nói với người dùng rằng mọi lượt tải diễn ra trên itch.io.
- Không có gì lên site ngay lập tức: mọi đề xuất đều vào **hàng chờ duyệt**, nơi Maintainer duyệt hoặc từ chối, bằng tay hoặc qua quy tắc tự động (một đề xuất không có cờ cảnh báo mà không ai từ chối trong khoảng một ngày có thể được duyệt tự động). Link được duyệt sau đó được pipeline dữ liệu cào và xuất hiện trên site sau lần deploy kế tiếp.
Có cả một danh sách? Issue template **[Add Games (bulk list)]** nhận tối đa 15 link một lần, và một PR thêm URL itch.io vào `scripts/temp_link.json` cũng được (dùng PR template [Add Games]). Cả hai đều đi qua cùng quy trình duyệt: Maintainer kiểm tra từng link trước khi đưa vào hàng chờ, và việc merge một PR như vậy chính là sự phê duyệt. Vui lòng đừng sửa tay `data_game/`: các file đó do pipeline quản lý (xem [mục 7](#7-gửi-thay-đổi-code-pr)).
Có cả một danh sách? Issue template **[Add Games (bulk list)]** nhận tối đa 15 link một lần, và một PR thêm URL itch.io vào `scripts/temp_link.json` cũng được (dùng PR template [Add Games]). Cả hai đều đi qua cùng quy trình duyệt: Maintainer kiểm tra từng link trước khi đưa vào hàng chờ, và việc merge một PR như vậy chính là sự phê duyệt. Vui lòng đừng sửa tay `data_game/`: các file đó do pipeline quản lý (xem [mục 7](#7-pull-request)).
#### 1b. Những cách khác để game được thêm vào
- Extension trình duyệt đi kèm của Maintainer ([itch-f2p-extension](https://github.com/poli0981/itch-f2p-extension), repo riêng, GPL-3.0) gửi link qua một API có xác thực trong lúc duyệt itch.io. Đây là công cụ riêng của Maintainer, không phải kênh gửi công khai.
- Website đọc các RSS feed công khai của itch.io về game miễn phí mới và phổ biến mỗi 4 giờ (mỗi lượt một feed) và đưa những gì tìm được vào hàng chờ.
- Website cũng đọc các collection công khai trên itch.io mà Maintainer theo dõi và đưa thẳng game miễn phí mới của chúng vào hàng chờ ingest (game từng bị gỡ, hoặc có cờ cảnh báo, thì vào hàng chờ duyệt).
Cả hai đều vào cùng hàng chờ duyệt với trang Suggest. (Đường thêm game qua Telegram bot cũ đã ngừng hoạt động.)
RSS feed vào cùng hàng chờ duyệt với trang Suggest. (Extension trình duyệt của Maintainer và Telegram bot cũ đã ngừng hoạt động; repo của chúng, [itch-f2p-extension](https://github.com/poli0981/itch-f2p-extension) và [telegram-scraper-bot](https://github.com/poli0981/telegram-scraper-bot), đã được lưu trữ (archive).)
### 2. Gỡ game hoặc sửa dữ liệu game
@@ -35,56 +44,58 @@ Cả hai đều vào cùng hàng chờ duyệt với trang Suggest. (Đường t
- Ghi rõ URL game, bạn là ai (người tạo / chủ sở hữu quyền, hoặc người được họ ủy quyền) và lý do.
- Maintainer sẽ gỡ bản ghi khỏi danh mục (ghi kèm lý do trên [trang game đã gỡ](https://freeitchgames.win/removed) công khai) và xóa các bản ảnh bìa thu nhỏ mà site lưu trữ; các bản trong cache sẽ tự hết hạn. Mục tiêu: trong vòng 7 ngày, yêu cầu pháp lý khẩn cấp thì sớm hơn.
- Lưu ý: đây là một repo git công khai, nên các phiên bản cũ vẫn còn trong lịch sử. Việc viết lại lịch sử công khai chỉ được làm trong trường hợp ngoại lệ vì bắt buộc về pháp lý.
- `safe_virus` / `nsfw` / ghi chú bị sai, hoặc lỗi dữ liệu khác không phải yêu cầu gỡ? Mở issue **[Bug Report]** cũng được.
- `safe_virus` / `nsfw` / ghi chú bị sai, hoặc lỗi dữ liệu khác không phải yêu cầu gỡ? Dùng issue template **[Report a problem]** (mục 3).
Chi tiết có trong [Điều khoản sử dụng](ToS.md) và [Tuyên bố miễn trừ](DISCLAIMER.md).
### 3. Báo lỗi
### 3. Báo sự cố (dữ liệu sai, có gì đó bị hỏng)
- Mở issue → template **[Bug Report]**.
- Checkbox cho các lỗi thường gặp (link chết, cờ sai, trang hỏng, v.v.).
- Mở issue → template **[Report a problem]** ([link trực tiếp](https://github.com/poli0981/free-games-itchio-list/issues/new?template=bug_report.yml)).
- Dành cho **lỗi dữ liệu** (link chết, sai tên, thể loại, tag, ảnh bìa, cờ `nsfw` hoặc `safe_virus`…) và cho **những thứ bị hỏng** (một trang hay ứng dụng ngừng hoạt động, danh mục không còn cập nhật). Không dành cho ý tưởng: xem mục 4.
- Chi tiết + ảnh chụp màn hình + mức độ khẩn cấp.
- **Vấn đề bảo mật không phải lỗi để đăng lên tracker công khai.** Hãy báo cáo riêng tư: xem [SECURITY](SECURITY.md).
- Nếu phức tạp, xem mục "Muốn thảo luận thêm?" bên dưới.
- **Vấn đề bảo mật không dành cho tracker công khai.** Hãy báo cáo riêng tư: xem [SECURITY](SECURITY.md).
- **Rào cản trợ năng** (bàn phím, trình đọc màn hình, phóng to, tương phản, chuyển động…): dùng template **[Accessibility barrier]** ([link trực tiếp](https://github.com/poli0981/free-games-itchio-list/issues/new?template=accessibility.yml)), hoặc gửi email tới contact@poli0981.dev nếu bạn không muốn dùng GitHub. Điều gì xảy ra tiếp theo nằm trong [Trợ năng](ACCESSIBILITY.md#7-báo-cáo-rào-cản-trợ-năng).
### 4. Đề xuất tính năng / cải tiến
### 4. Tính năng và cải tiến (đã đóng)
- Mở issue → template **[Feature Request / Improvement]**.
- Chọn loại (tính năng mới hoặc sửa code), tên, lý do, độ ưu tiên (từ "nice to have" tới "repo sắp chết").
- Tùy chọn: pseudo-code/snippet (đừng có malware nhé, tôi sẽ check bằng kỹ năng tầm thường của mình :D).
- Dự án đang ở chế độ bảo trì: **đề xuất tính năng, ý tưởng cải tiến và thay đổi code không còn được nhận**. Issue và pull request loại này sẽ bị đóng mà không review.
- Code dùng giấy phép MIT: bạn cứ thoải mái fork và tự làm phiên bản của mình ([README → Giấy phép](../../../README.vi.md#giấy-phép)).
### 5. Gửi góp ý
### 5. Góp ý, câu hỏi, mọi thứ khác
- Dùng template **[Feedback]**.
- Checkbox (EULA/ToS quá khắt khe? Concept repo dở? Anti-AI? Xóa repo? Khác).
- Chê hay khen đều được, sự tự ti của tôi chịu được.
- Dùng **[GitHub Discussions](https://github.com/poli0981/free-games-itchio-list/discussions)**, các server Discord hoặc email (xem "Muốn thảo luận thêm?" bên dưới). Chê hay khen đều được, sự tự ti của tôi chịu được.
- Tôi có đọc, nhưng chúng không biến thành tính năng mới (mục 4).
### 6. Mọi thứ khác (câu hỏi, meme, lạc đề)
### 6. Thư viện phụ thuộc và vá bảo mật
- Dùng template **[General / Off-Topic]**.
- Có gì trong đầu cứ đăng.
- Việc cập nhật thư viện phụ thuộc do Dependabot và đợt rà soát hằng tuần của Maintainer lo: xin đừng gửi PR nâng phiên bản.
- Tìm thấy lỗ hổng? Hãy báo cáo riêng tư ([SECURITY](SECURITY.md)); Maintainer sẽ tự vá.
### 7. Gửi thay đổi code (PR)
### 7. Pull request
- Fork → tạo branch → code → mở PR vào `main` với PR template phù hợp ([Bug Fix], [New Feature], [Documentation]…).
- Mô tả rõ ràng giúp nhé. Tôi sẽ review chậm (lịch thất nghiệp + hai AI buddy).
- **Được nhận**: PR thêm URL itch.io vào `scripts/temp_link.json` (dùng PR template [Add Games]). Merge PR chính là sự chấp thuận của Maintainer.
- **Không được nhận**: mọi thứ khác (code, giao diện, tài liệu, refactor). Sửa hoặc gỡ dữ liệu của một game thì đi qua issue hoặc email (mục 2 và 3), vì pipeline quản lý `data_game/`.
- Các quy tắc dưới đây vẫn áp dụng cho mọi PR, kể cả PR của chính Maintainer.
**Quy tắc PR** (phần không thương lượng):
- **CI phải pass.** Python CI (ruff check + format, vulture, pytest, `validate.py`) và Webapp CI (kiểm tra type sinh ra, lint, knip, test, build, `wrangler deploy --dry-run`) đều chạy trên PR. CI đỏ = không merge.
- **CI phải pass.** Python CI (ruff check + format, vulture, pytest, `validate.py`) và Webapp CI (kiểm tra phiên bản Tauri crate/npm, kiểm tra type sinh ra, lint, knip, test, build, `wrangler deploy --dry-run`) đều chạy trên PR. CI đỏ = không merge. SonarQube Cloud cũng phân tích mỗi PR (kèm test coverage) và báo quality gate qua check "SonarCloud Code Analysis", còn Qodana (JetBrains) phân tích code TypeScript / JavaScript, Python và Rust. Cả hai bỏ qua PR từ fork, vì fork không nhận được secret của repo.
- **PR được merge bằng squash** (một PR thành một commit trên `main`) **hoặc merge commit, không bao giờ fast-forward**, nên hãy đặt tiêu đề PR như một commit message tốt (repo dùng kiểu `type(scope): tóm tắt`, ví dụ `fix(web): …`).
- **Giấy phép theo nguyên tắc inbound = outbound.** Khi mở PR, bạn đồng ý rằng đóng góp của mình được cấp phép theo cùng giấy phép với phần mà nó thay đổi: **MIT** cho mã nguồn, **CC BY 4.0** cho dữ liệu danh mục và tài liệu (xem [README → Giấy phép](../../../README.vi.md#giấy-phép)). Chỉ gửi những gì bạn có quyền gửi.
- **Không bao giờ commit secret**: không token, API key, file `.dev.vars` / `.env`, private key (chẳng hạn khóa của GitHub App) hay keystore dùng để ký. Nếu lỡ push một cái, hãy báo riêng (security@poli0981.dev) và thay mới (rotate) nó; chỉ xóa commit là không đủ.
- **Không sửa tay `data_game/`.** Thay đổi dữ liệu phải đi qua pipeline (một patch + `apply_patch.py`, có chạy `validate.py`), để các tiến trình ghi đồng thời không đè lên nhau.
- Không commit output build hay file sinh ra: `webapp/dist/`, `webapp/.wrangler/`, `webapp/src-tauri/target/`, `webapp/src-tauri/gen/`. (`webapp/src-tauri/Cargo.lock` **có** được commit; hãy cập nhật nó khi bạn sửa `Cargo.toml`.)
- Thêm dependency npm? Thêm luôn vào danh sách `THIRD_PARTY` trong `webapp/src/lib/about.ts` để trang About ghi công.
- Link ngoài mới trong app? Dùng `<ExtLink href="…">` từ `webapp/src/components/ext-link.tsx`, đừng dùng `<a href="…" target="_blank">` thuần: anchor thuần chạy được trên web nhưng im lặng hỏng trong các app Tauri.
- Link ngoài mới trong app? Dùng `<ExtLink href="…">` từ `webapp/src/components/ext-link.tsx`, đừng dùng `<a href="…" target="_blank">` thuần: anchor thuần chạy được trên web nhưng im lặng hỏng trong các app Tauri (và ExtLink báo cho trình đọc màn hình rằng link mở thẻ mới).
- **Trợ năng**: thay đổi giao diện phải vẫn dùng được chỉ với bàn phím và với trình đọc màn hình, và giữ tỉ lệ tương phản (`npm test` kiểm tra màu). Danh sách kiểm tra nằm trong [Trợ năng → Dành cho người đóng góp](ACCESSIBILITY.md#8-dành-cho-người-đóng-góp) và trong pull request template.
### 8. Thiết lập môi trường dev (tóm tắt)
Dành cho các bản fork, và cho việc bảo trì của chính Maintainer.
Hướng dẫn đầy đủ (Worker, D1 cục bộ, secret, Tauri, Android) nằm trong **[`docs/dev_env.md`](../../dev_env.md)** ([VI](dev_env.md)); ghi chú build Tauri/Android nằm trong [`webapp/TAURI.md`](../../../webapp/TAURI.md). Bản ngắn gọn:
**Pipeline Python** (Python 3.14, xem `.python-version`):
**Pipeline Python** (Python 3.15, xem `.github/python-version`):
```sh
python -m venv .venv
@@ -100,7 +111,7 @@ Muốn thử cào thật trên máy: thêm một URL vào `scripts/temp_link.jso
`python scripts/update_info.py --out patch.json` và `python scripts/apply_patch.py patch.json`
(đừng commit kết quả; xem quy tắc PR ở trên).
**Webapp + Worker** (Node.js 22.22+, CI dùng phiên bản trong `webapp/.node-version`):
**Webapp + Worker** (Node.js 26+, CI dùng phiên bản trong `webapp/.node-version`):
```sh
cd webapp
@@ -126,12 +137,12 @@ npm run tauri:build # trình cài đặt trong src-tauri/target/release/bundle/
- **Test cục bộ**: chạy các bước kiểm tra ở mục 8 trước khi push; CI chạy đúng những bước đó.
- **Giữ sạch**: chỉ game itch.io miễn phí, không trả phí/demo/malware/trùng lặp.
- **Kiên nhẫn**: tôi hướng nội + lười, trả lời có thể chậm.
- **Đồng ý**: mọi issue template đều có một checkbox bắt buộc. Lạc đề/spam/vi phạm chính sách sẽ bị bỏ qua/đóng không drama :D
- **Đồng ý**: mọi issue template đều có một checkbox bắt buộc. Lạc đề/spam/vi phạm chính sách, và mọi thứ nằm ngoài phạm vi bảo trì ở trên, sẽ bị bỏ qua/đóng không drama :D
- **Cư xử đẹp**: mọi thứ ở đây đều theo [Quy tắc ứng xử](CODE_OF_CONDUCT.md).
## Muốn thảo luận thêm? (Nếu template không đủ)
Issue/PR là tốt nhất để theo dõi, nhưng nếu bạn muốn mô tả bug/tính năng kỹ hơn, tán gẫu, hoặc kể chuyện noob, giờ đã có server thật (introvert god-mode bị xuyên thủng):
Issue là tốt nhất để theo dõi vấn đề dữ liệu, nhưng nếu bạn muốn tán gẫu, hỏi gì đó, hoặc kể chuyện noob, giờ đã có [GitHub Discussions](https://github.com/poli0981/free-games-itchio-list/discussions) và server thật (introvert god-mode bị xuyên thủng):
**Chat / cộng đồng**
- Discord: Repo discussion (#general): https://discord.gg/2aNR3aVt
+3 -3
View File
@@ -1,10 +1,10 @@
# Tuyên bố miễn trừ trách nhiệm (Disclaimer)
Cập nhật lần cuối: 2026-09-29
Cập nhật lần cuối: 2026-10-16
Áp dụng từ: khi phát hành phiên bản 4.0.0.
> Bản dịch từ bản tiếng Anh cập nhật ngày 2026-09-18 (English source revision 2026-09-18). Nếu có khác biệt, bản tiếng Anh được ưu tiên. Bản gốc: [`docs/DISCLAIMER.md`](../../DISCLAIMER.md).
> Bản dịch từ bản tiếng Anh cập nhật ngày 2026-10-16 (English source revision 2026-10-16). Nếu có khác biệt, bản tiếng Anh được ưu tiên. Bản gốc: [`docs/DISCLAIMER.md`](../../DISCLAIMER.md).
Dự án này — repository `free-games-itchio-list` và website **[freeitchgames.win](https://freeitchgames.win)** — là một dự án sở thích: một danh mục được tuyển chọn và tự động cập nhật gồm các game miễn phí trên [itch.io](https://itch.io). Dự án do một dev người Việt đang thất nghiệp, poli0981 (SkullMute), vận hành — dưới đây gọi là "Người duy trì" — với các trợ lý AI gánh phần lớn việc nặng. Làm ra vì vibes, để khám phá game indie và giải khuây. Không hứa hẹn gì lớn lao — nhưng các điều khoản mang tính pháp lý dưới đây là thật.
@@ -33,7 +33,7 @@ Dự án hoạt động độc lập. Dự án **không liên kết với, khôn
Dự án **không làm, không lưu trữ, không phân phối, không bán và không chứng thực** các game được liệt kê. Mỗi game liên kết tới trang riêng của nó trên itch.io, và mọi lượt tải về đều diễn ra tại đó, theo điều khoản của itch.io và điều khoản hoặc giấy phép riêng của người làm game.
Game được đưa vào catalog qua trang Suggest công khai, tiện ích trình duyệt của Người duy trì, hoặc các RSS feed công khai của itch.io, và không có gì được thêm vào cho đến khi Người duy trì duyệt. Việc duyệt đó **không phải** là kiểm tra bảo mật, đánh giá chất lượng hay sự chứng thực.
Game được đưa vào catalog qua trang Suggest công khai, các RSS feed công khai của itch.io, hoặc các collection công khai trên itch.io mà Người duy trì theo dõi. Mỗi game đều được Người duy trì duyệt, từng game một hoặc qua các quy tắc tự động do Người duy trì đặt ra. Việc duyệt đó **không phải** là kiểm tra bảo mật, đánh giá chất lượng hay sự chứng thực.
## 5. Không bảo đảm về các game
+3 -3
View File
@@ -1,10 +1,10 @@
# Thỏa thuận cấp phép cho người dùng cuối (EULA)
Cập nhật lần cuối: 2026-10-03
Cập nhật lần cuối: 2026-10-16
Áp dụng từ: khi phát hành phiên bản 4.2.0.
Bản dịch từ bản tiếng Anh cập nhật ngày 2026-10-03 (English source revision 2026-10-03). Nếu có khác biệt, bản tiếng Anh được ưu tiên.
Bản dịch từ bản tiếng Anh cập nhật ngày 2026-10-16 (English source revision 2026-10-16). Nếu có khác biệt, bản tiếng Anh được ưu tiên.
> Bản tiếng Anh: [`docs/EULA.md`](../../EULA.md).
@@ -86,7 +86,7 @@ Bạn đồng ý không:
- Trình bày một bản build đã sửa đổi như một bản phát hành chính thức, ví dụ phân phối nó dưới tên và biểu tượng của dự án, hoặc với app identifier chính thức `com.poli0981.freegamesitchio`, mà không ghi rõ đó là bản không chính thức. Fork luôn được chào đón theo Giấy phép MIT; chỉ cần làm rõ rằng đó là bản của Bạn.
- Sử dụng tên Người duy trì, GitHub handle `poli0981`, hoặc alias "SkullMute" để chứng thực hoặc quảng bá tác phẩm phái sinh mà không có sự cho phép trước bằng văn bản.
- Sử dụng Ứng dụng, hoặc một phiên bản đã sửa đổi của nó, theo cách vi phạm [Điều khoản sử dụng](ToS.md) của Website, ví dụ gửi yêu cầu tự động hàng loạt tới Website (dữ liệu có sẵn trong Repository), hoặc cố truy cập khu vực quản trị (admin) hay ingest API khi không được phép.
- Sử dụng Ứng dụng, hoặc một phiên bản đã sửa đổi của nó, theo cách vi phạm [Điều khoản sử dụng](ToS.md) của Website, ví dụ gửi yêu cầu tự động hàng loạt tới Website (dữ liệu có sẵn trong Repository), hoặc cố truy cập khu vực quản trị (admin) khi không được phép.
- Sử dụng Ứng dụng hoặc các bộ cài của nó để lưu trữ, phân phối hoặc tạo điều kiện phân phối malware, trang phishing, hoặc nội dung vi phạm pháp luật hiện hành.
Các quy tắc này là về cách Bạn sử dụng Ứng dụng cũng như tên và dịch vụ của dự án. Chúng tồn tại song song với Giấy phép MIT và không hạn chế các quyền mà giấy phép đó trao đối với mã nguồn.
+10 -11
View File
@@ -1,10 +1,10 @@
# Chính sách quyền riêng tư (Privacy Policy)
Cập nhật lần cuối: 2026-10-03
Cập nhật lần cuối: 2026-10-16
Áp dụng từ: ngày 2026-10-03 đối với Website, và từ phiên bản 4.2.0 đối với các Ứng dụng.
Áp dụng từ: ngày 2026-10-13 đối với Website, và từ phiên bản 4.4.0 đối với các Ứng dụng.
> Bản dịch từ bản tiếng Anh cập nhật ngày 2026-10-03 (English source revision 2026-10-03). Nếu có khác biệt, bản tiếng Anh được ưu tiên. Bản gốc: [`docs/PrivacyPolicy.md`](../../PrivacyPolicy.md).
> Bản dịch từ bản tiếng Anh cập nhật ngày 2026-10-16 (English source revision 2026-10-16). Nếu có khác biệt, bản tiếng Anh được ưu tiên. Bản gốc: [`docs/PrivacyPolicy.md`](../../PrivacyPolicy.md).
Chính sách quyền riêng tư này giải thích dự án `free-games-itchio-list` xử lý những dữ liệu cá nhân nào, vì sao, ai hỗ trợ xử lý, dữ liệu được lưu trong bao lâu và bạn có những quyền gì. Chính sách áp dụng cho website **https://freeitchgames.win**, các ứng dụng desktop và Android, dữ liệu danh mục công khai và repository. Nói ngắn gọn: không có tài khoản, không quảng cáo, không cookie theo dõi. Dự án giữ ít dữ liệu nhất có thể, và phần lớn những gì tồn tại chỉ nằm trong trình duyệt của chính bạn.
@@ -36,7 +36,7 @@ Bên kiểm soát dữ liệu cá nhân được mô tả trong Chính sách nà
### 1.3 Những gì Chính sách này không áp dụng
Chính sách này không áp dụng cho các dịch vụ tự xử lý dữ liệu với tư cách của chính họ: itch.io (mọi link game và mọi lượt tải đều dẫn tới đó), GitHub đối với tài khoản GitHub và hoạt động của bạn trên github.com, việc Cloudflare dùng dữ liệu cho mục đích riêng của họ như mô tả trong chính sách quyền riêng tư của Cloudflare, bản thân các game, và tiện ích trình duyệt của Người duy trì (một dự án riêng, có tài liệu riêng). Chính sách của từng bên sẽ được áp dụng (link ở mục 4).
Chính sách này không áp dụng cho các dịch vụ tự xử lý dữ liệu với tư cách của chính họ: itch.io (mọi link game và mọi lượt tải đều dẫn tới đó), GitHub đối với tài khoản GitHub và hoạt động của bạn trên github.com, việc Cloudflare dùng dữ liệu cho mục đích riêng của họ như mô tả trong chính sách quyền riêng tư của Cloudflare, và bản thân các game. Chính sách của từng bên sẽ được áp dụng (link ở mục 4).
## 2. Dữ liệu nào được xử lý và vì sao
@@ -65,14 +65,14 @@ Khi bạn dùng trang Suggest (https://freeitchgames.win/suggest):
- **Những gì được lưu**: URL game, ghi chú tùy chọn của bạn (tối đa 500 ký tự) và thời điểm gửi, trong hàng chờ duyệt (mục 2.4). Trang không yêu cầu và không lưu tên, địa chỉ email hay tài khoản nào.
- **Chống spam**: Cloudflare Turnstile xử lý các tín hiệu về thiết bị và trình duyệt của bạn để phân biệt người thật với bot. Để kiểm tra kết quả, Website gửi token Turnstile và địa chỉ IP của bạn tới dịch vụ xác minh của Cloudflare.
- **Giới hạn tần suất**: địa chỉ IP của bạn chỉ được dùng tạm thời để đếm số request. Dự án không lưu nó.
- **Mục đích**: để xem xét đề xuất của bạn. Nếu được duyệt, URL game trở thành một phần của Danh mục công khai. Ghi chú của bạn không bao giờ được công bố và **tự động bị xóa sau 180 ngày**.
- **Mục đích**: để xem xét đề xuất của bạn, do Người duy trì hoặc các quy tắc tự động do Người duy trì đặt ra (mục 2.4). Nếu được duyệt, URL game trở thành một phần của Danh mục công khai. Ghi chú của bạn không bao giờ được công bố và **tự động bị xóa sau 180 ngày**.
- **Vui lòng không đưa dữ liệu cá nhân vào ghi chú**, dù là của bạn hay của người khác. Biểu mẫu này chỉ dành cho link game.
### 2.4 Hàng chờ duyệt và khu vực quản trị
- **Game đến từ đâu**: đề xuất từ trang Suggest; dữ liệu gửi từ tiện ích trình duyệt của Người duy trì qua một API có xác thực (URL game, tiêu đề và ghi chú tùy chọn, và ID service token của tiện ích; các bản ghi chống gửi trùng được giữ 7 ngày); và tự động phát hiện từ các RSS feed công khai của itch.io.
- **Hàng chờ duyệt** (Cloudflare D1) chứa các URL game ứng viên cùng nguồn gửi, tiêu đề, URL ảnh bìa và gợi ý thể loại lấy từ itch.io, các cờ tự động, ghi chú, mốc thời gian và quyết định của Người duy trì. Không game nào được đưa vào Danh mục cho tới khi Người duy trì duyệt. Các URL bị từ chối được giữ vô thời hạn làm danh sách chặn; chỉ cần URL là đủ để không phải xét lại cùng một game.
- **Khu vực quản trị** (https://freeitchgames.win/admin) chỉ dành cho Người duy trì. Khu vực này được bảo vệ bằng Cloudflare Access (đăng nhập bằng GitHub hoặc mã PIN dùng một lần gửi qua email); Cloudflare Access đặt cookie phiên `CF_Authorization` trong trình duyệt của Người duy trì. Các thao tác quản trị được ghi vào nhật ký kiểm tra (audit log) kèm địa chỉ email của Người duy trì. Nhật ký này không bao giờ được công bố.
- **Game đến từ đâu**: đề xuất từ trang Suggest; tự động phát hiện từ các RSS feed công khai của itch.io; và game miễn phí mới trong các collection công khai trên itch.io mà Người duy trì theo dõi (Website đọc các trang công khai đó; không liên quan gì tới dữ liệu của bạn).
- **Hàng chờ duyệt** (Cloudflare D1) chứa các URL game ứng viên cùng nguồn gửi, tiêu đề, URL ảnh bìa và gợi ý thể loại lấy từ itch.io, các cờ tự động, ghi chú, mốc thời gian và quyết định của Người duy trì. Game được đưa vào Danh mục khi Người duy trì duyệt: từng game một, hoặc qua các quy tắc tự động do Người duy trì đặt ra và có thể thay đổi bất cứ lúc nào (mục không có cờ cảnh báo mà không ai từ chối trong thời gian chờ; game miễn phí mới trong các collection Người duy trì theo dõi). Các lượt duyệt tự động được ghi vào nhật ký kiểm tra như thao tác của chính Người duy trì. Các URL bị từ chối được giữ vô thời hạn làm danh sách chặn; chỉ cần URL là đủ để không phải xét lại cùng một game.
- **Khu vực quản trị** (https://freeitchgames.win/admin) chỉ dành cho Người duy trì. Khu vực này được bảo vệ bằng Cloudflare Access (đăng nhập bằng GitHub hoặc mã PIN dùng một lần gửi qua email); Cloudflare Access đặt cookie phiên `CF_Authorization` trong trình duyệt của Người duy trì. Các thao tác quản trị, kể cả thay đổi quy tắc tự động, được ghi vào nhật ký kiểm tra (audit log) kèm địa chỉ email của Người duy trì. Nhật ký này không bao giờ được công bố.
### 2.5 Dữ liệu game công khai trong Danh mục
@@ -145,7 +145,6 @@ Cloudflare và Google có thể xử lý dữ liệu ở bất kỳ đâu trên
| Địa chỉ IP dùng cho giới hạn tần suất và Turnstile | Chỉ dùng tạm thời; Dự án không bao giờ lưu |
| Ghi chú trên trang Suggest | Tự động xóa sau **180 ngày** |
| URL game được đề xuất hoặc được phát hiện, kèm nguồn và mốc thời gian | Nằm trong hàng chờ duyệt chừng nào còn cần để không phải xét cùng một game hai lần. URL được duyệt trở thành một phần của Danh mục công khai; URL bị từ chối được giữ vô thời hạn làm danh sách chặn |
| Bản ghi chống gửi trùng từ tiện ích trình duyệt | **7 ngày** |
| Nhật ký kiểm tra quản trị (kèm địa chỉ email của Người duy trì) | Được giữ làm hồ sơ các thay đổi quản trị; không bao giờ công bố |
| Mục trong Danh mục (bao gồm tên nhà phát triển và nhà phát hành) | Khi game còn được liệt kê. Bản ghi gỡ bỏ vẫn nằm trong danh sách game đã gỡ công khai, và lịch sử Git của Repository giữ các phiên bản trước (xem mục 7.3) |
| Email, bao gồm yêu cầu gỡ game và yêu cầu liên quan đến bản quyền | Trong thời gian cần thiết để xử lý yêu cầu |
@@ -219,8 +218,8 @@ Theo GDPR và UK GDPR, bạn cũng có thể yêu cầu hạn chế việc xử
- Website chỉ được phục vụ qua HTTPS.
- Truy cập tự động phải qua bước kiểm tra Cloudflare Turnstile trước khi các trang và ảnh bìa của Website được tải (mục 2.1).
- Tối thiểu hóa dữ liệu: không tài khoản, mã nguồn của Dự án không lưu địa chỉ IP, ghi chú Suggest bị xóa sau 180 ngày, bản ghi chống gửi trùng bị xóa sau 7 ngày.
- Khu vực quản trị và API ingest được bảo vệ bằng Cloudflare Access, và mã máy chủ của Website tự xác minh token Access ở mọi request được bảo vệ.
- Tối thiểu hóa dữ liệu: không tài khoản, mã nguồn của Dự án không lưu địa chỉ IP, ghi chú Suggest bị xóa sau 180 ngày.
- Khu vực quản trị được bảo vệ bằng Cloudflare Access, và mã máy chủ của Website tự xác minh token Access ở mọi request được bảo vệ.
- Các thông tin bí mật (như private key của GitHub App) được giữ trong kho lưu trữ bí mật của Cloudflare, không bao giờ nằm trong Repository. Khu vực quản trị ghi vào Repository dưới danh nghĩa một GitHub App, với các commit đã được xác minh (verified).
- Content Security Policy chặt chẽ chỉ cho phép script từ chính Website, cộng với Cloudflare Web Analytics và Turnstile.
- Các GitHub Actions được ghim theo commit SHA cụ thể với quyền tối thiểu cần thiết, và Dependabot giữ cho các dependency luôn được cập nhật.
+7 -5
View File
@@ -1,10 +1,10 @@
# Chính sách bảo mật (Security Policy)
Cập nhật lần cuối: 2026-09-29
Cập nhật lần cuối: 2026-11-11
Áp dụng từ: khi phát hành phiên bản 4.0.0.
> Bản dịch từ bản tiếng Anh cập nhật ngày 2026-09-18 (English source revision 2026-09-18). Nếu có khác biệt, bản tiếng Anh được ưu tiên. Bản gốc: [`SECURITY.md`](../../../SECURITY.md).
> Bản dịch từ bản tiếng Anh cập nhật ngày 2026-10-27 (English source revision 2026-10-27). Nếu có khác biệt, bản tiếng Anh được ưu tiên. Bản gốc: [`SECURITY.md`](../../../SECURITY.md).
Chào bạn — đây là một dự án sở thích do một người vận hành, poli0981 (SkullMute), dưới đây gọi là "Người duy trì": một danh mục được tuyển chọn gồm các game itch.io miễn phí. Từ v4, dự án gồm một **website chỉ đọc** tại https://freeitchgames.win (chạy trên một Cloudflare Worker), một **pipeline dữ liệu Python** trên GitHub Actions, và các **ứng dụng desktop và Android chỉ đọc**. Không có tài khoản công khai, không đăng nhập và không thanh toán; lần đăng nhập duy nhất là trang quản trị riêng của Người duy trì, được bảo vệ bởi Cloudflare Access. Bề mặt tấn công nhỏ — nhưng nếu bạn tìm thấy lỗ hổng, Người duy trì thực sự muốn được biết.
@@ -26,7 +26,7 @@ Một báo cáo tốt nên có:
**Trong phạm vi**
- Website https://freeitchgames.win và Cloudflare Worker của nó, bao gồm proxy ảnh (`/img`), API Suggest (`/api/suggest`), API ingest mà tiện ích trình duyệt của Người duy trì sử dụng (`/api/ingest`), cùng ứng dụng và API quản trị (`/admin`, `/api/admin`).
- Website https://freeitchgames.win và Cloudflare Worker của nó, bao gồm proxy ảnh (`/img`), API Suggest (`/api/suggest`), cùng ứng dụng và API quản trị (`/admin`, `/api/admin`).
- Pipeline dữ liệu (`scripts/`) và các workflow GitHub Actions (`.github/workflows/`).
- Các ứng dụng desktop và file APK Android được phát hành trên [GitHub Releases](https://github.com/poli0981/free-games-itchio-list/releases).
- Dữ liệu được công bố (`data_game/`, `scripts/deleted_games.json` và https://freeitchgames.win/data) — ví dụ: một cách đưa nội dung vào catalog mà không cần Người duy trì phê duyệt.
@@ -39,7 +39,7 @@ Một báo cáo tốt nên có:
- Tấn công từ chối dịch vụ theo lưu lượng (DoS/DDoS) và kiểm thử tải.
- Báo cáo từ công cụ quét tự động mà không có proof of concept chạy được.
Tiện ích trình duyệt (poli0981/itch-f2p-extension) nằm trong repository riêng; lỗi của chính tiện ích xin báo ở đó. Lỗi trong API ingest mà tiện ích kết nối tới thì thuộc phạm vi ở đây.
Tiện ích trình duyệt (poli0981/itch-f2p-extension) và Telegram bot (poli0981/telegram-scraper-bot) đã được lưu trữ (archive) và không còn được hỗ trợ, nên nằm ngoài phạm vi.
## 3. Phiên bản được hỗ trợ
@@ -51,6 +51,8 @@ Tiện ích trình duyệt (poli0981/itch-f2p-extension) nằm trong repository
Bản sửa cho website có hiệu lực ngay khi được deploy. Các ứng dụng không tự cập nhật: bản sửa được phát hành trong một bản release mới, bạn tải về từ GitHub Releases.
Từ phiên bản 4.6.1, dự án ở **chế độ bảo trì**: không có tính năng mới, nhưng việc vá bảo mật và cập nhật runtime, thư viện phụ thuộc vẫn tiếp tục như mô tả ở đây.
## 4. Những gì bạn có thể mong đợi
- **Xác nhận đã nhận báo cáo**: mục tiêu trong vòng **7 ngày**. Đây là dự án sở thích do một người làm, nên đó là mục tiêu chứ không phải cam kết, và thường sẽ sớm hơn nhiều.
@@ -78,7 +80,7 @@ Những gì repository thực sự làm:
- **Dependabot** ([`.github/dependabot.yml`](../../../.github/dependabot.yml)) được cấu hình để giữ các dependency npm, pip, GitHub Actions và cargo luôn được cập nhật.
- Mọi **GitHub Action của bên thứ ba đều được ghim theo commit SHA đầy đủ**, và mỗi workflow khai báo `permissions` ở mức tối thiểu cần thiết.
- Các thao tác ghi vào repository từ trang quản trị của website đều đi qua một **GitHub App** (commit được xác minh), và trang quản trị nằm sau Cloudflare Access (đăng nhập GitHub hoặc mã PIN dùng một lần qua email) và chỉ dành cho Người duy trì.
- Form Suggest được bảo vệ bằng Cloudflare Turnstile và giới hạn tốc độ.
- Website giới hạn số request mà một địa chỉ có thể gửi trong thời gian ngắn (một quy tắc WAF của Cloudflare, rồi các giới hạn theo từng loại đường dẫn trong Worker, trả về HTTP 429), và form Suggest còn có thêm Cloudflare Turnstile cùng một giới hạn chặt hơn của riêng nó.
- File APK Android được ký bằng khóa của dự án. Chỉ cài APK, cũng như các ứng dụng desktop, từ trang [GitHub Releases](https://github.com/poli0981/free-games-itchio-list/releases) của dự án.
Nếu một lỗ hổng đã biết trong dependency thực sự ảnh hưởng tới một thành phần đang chạy (website, Worker, pipeline hoặc các ứng dụng), hãy báo cáo riêng tư như ở [§1](#1-báo-cáo-lỗ-hổng). Nếu đó chỉ là một dependency lỗi thời, không có tác động thực tế, thì mở issue hoặc pull request thông thường là được.
+5 -5
View File
@@ -1,10 +1,10 @@
# Điều khoản sử dụng (Terms of Use)
Cập nhật lần cuối: 2026-10-03
Cập nhật lần cuối: 2026-10-16
Áp dụng từ: ngày 2026-10-03 đối với Website, và từ phiên bản 4.2.0 đối với các Ứng dụng.
Áp dụng từ: ngày 2026-10-13 đối với Website, và từ phiên bản 4.4.0 đối với các Ứng dụng.
Bản dịch từ bản tiếng Anh cập nhật ngày 2026-10-03 (English source revision 2026-10-03). Nếu có khác biệt, bản tiếng Anh được ưu tiên.
Bản dịch từ bản tiếng Anh cập nhật ngày 2026-10-16 (English source revision 2026-10-16). Nếu có khác biệt, bản tiếng Anh được ưu tiên.
Bản tiếng Anh: [`docs/ToS.md`](../../ToS.md).
@@ -51,7 +51,7 @@ Các Điều khoản sử dụng này ("Điều khoản") điều chỉnh việc
- **Trang Suggest** (https://freeitchgames.win/suggest): bạn có thể gửi một liên kết game itch.io và một ghi chú tùy chọn dài tối đa 500 ký tự. Trang này dùng Cloudflare Turnstile để chống spam và có giới hạn tần suất (rate limit).
- Ghi chú chỉ Người duy trì xem được và sẽ bị xóa sau 180 ngày. **Đừng đưa dữ liệu cá nhân vào ghi chú.** Xem [Chính sách quyền riêng tư](PrivacyPolicy.md).
- Mọi đề xuất đều vào một **hàng đợi duyệt**. Không có gì được đưa vào Danh mục cho tới khi Người duy trì phê duyệt, và Người duy trì không có nghĩa vụ phải chấp nhận hay phản hồi một đề xuất. Sau khi được duyệt, liên kết sẽ được pipeline scrape, và game nào hóa ra là game trả phí sẽ bị loại.
- Mọi đề xuất đều vào một **hàng đợi duyệt**. Người duy trì duyệt hoặc từ chối đề xuất tại đó, từng cái một hoặc qua các quy tắc tự động do Người duy trì đặt ra: một đề xuất không có cờ cảnh báo và không bị ai từ chối trong thời gian chờ mà Người duy trì chọn (hiện khoảng một ngày) có thể được duyệt tự động. Người duy trì không có nghĩa vụ phải chấp nhận hay phản hồi một đề xuất. Sau khi được duyệt, liên kết sẽ được pipeline scrape, và game nào hóa ra là game trả phí sẽ bị loại.
- Chỉ những game **thực sự miễn phí** trên itch.io mới đủ điều kiện. Bản demo của game trả phí, game "name your own price" có mức giá tối thiểu lớn hơn 0, và game chỉ miễn phí trong thời gian khuyến mãi thì không.
- Khi gửi bất cứ thứ gì cho Dự án (đề xuất, issue, pull request hay comment), bạn xác nhận rằng:
- đó là sản phẩm của chính bạn, hoặc bạn có quyền chia sẻ nó;
@@ -66,7 +66,7 @@ Bạn đồng ý **không**:
1. **Scrape hàng loạt** Website hoặc API của nó, kể cả các file trong `/data`. Hãy lấy dữ liệu từ Repository; cách đó tốn ít tài nguyên hơn cho tất cả mọi người.
2. **Lạm dụng image proxy** (`/img`): proxy này chỉ để hiển thị ảnh bìa trên Website. Đừng hotlink các URL `/img` từ website hay ứng dụng khác, và đừng dùng nó để tải ảnh hàng loạt.
3. **Truy cập trái phép các khu vực bị hạn chế**: `/admin`, API quản trị (`/api/admin/…`) và API ingest (`/api/ingest`) chỉ dành cho Người duy trì. Nghiên cứu bảo mật thiện chí luôn được hoan nghênh, theo các quy tắc trong [Security Policy](SECURITY.md).
3. **Truy cập trái phép các khu vực bị hạn chế**: `/admin` và API quản trị (`/api/admin/…`) chỉ dành cho Người duy trì. Nghiên cứu bảo mật thiện chí luôn được hoan nghênh, theo các quy tắc trong [Security Policy](SECURITY.md).
4. **Spam form Suggest**, hoặc tìm cách vượt qua bước xác minh của Website, Turnstile hay giới hạn tần suất (ví dụ bằng script, dùng chung cookie xác minh hoặc xoay vòng địa chỉ IP).
5. **Gửi liên kết tới malware**, lừa đảo, phishing hoặc nội dung bất hợp pháp, ở bất kỳ đâu trong Dự án.
6. **Mạo nhận liên kết**: đừng tự nhận là Người duy trì hay là Dự án, đừng giới thiệu một bản fork hay bản sao như thể đó là Dự án chính thức, đừng nói rằng Dự án do itch.io vận hành hoặc bảo trợ, và đừng dùng tên "poli0981" hay "SkullMute" để quảng bá sản phẩm của bạn khi chưa có sự cho phép trước bằng văn bản.
+26 -6
View File
@@ -1,6 +1,6 @@
# Môi trường phát triển
> Bản dịch từ bản tiếng Anh cập nhật ngày 2026-09-24 (English source revision 2026-09-24). Nếu có khác biệt, bản tiếng Anh được ưu tiên.
> Bản 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 gốc: [`dev_env.md`](../../dev_env.md).
Bộ công cụ Maintainer dùng để viết và kiểm thử code trong repo này, và cách chạy từng phần trên máy.
@@ -17,12 +17,17 @@ JetBrains 2026.x (dòng trả phí):
VS Code, Sublime, vim, v.v. đều dùng tốt; repo không chứa gì đặc thù của JetBrains.
TypeScript 7 (bản `tsc` mà `npm run build` chạy) là binary native, không có `tsserver`. Trong VS Code,
cài extension TypeScript Native Preview (`TypeScriptTeam.native-preview`) để dùng language server của
TS 7. Trong WebStorm, dùng chế độ hỗ trợ TypeScript 7 hoặc trỏ *Languages & Frameworks → TypeScript*
tới `webapp/node_modules/@typescript/old` (TypeScript 6.0, báo cùng các lỗi).
## Toolchain ngôn ngữ
| Stack | Yêu cầu | Dùng cho |
|-------|---------|----------|
| Python | 3.14 (`.python-version`) | Pipeline dữ liệu (`scripts/`) và test của nó |
| Node.js | 22.22+ (CI dùng `webapp/.node-version`) | Web app, admin app, Worker, phần front end của Tauri |
| Python | 3.15 (`.github/python-version`) | Pipeline dữ liệu (`scripts/`) và test của nó |
| Node.js | 26+ (CI dùng `webapp/.node-version`) | Web app, admin app, Worker, phần front end của Tauri |
| npm | đi kèm Node.js | Dependency (`npm ci` theo `package-lock.json`) |
| Wrangler | dependency của dự án (`npx wrangler`) | Worker chạy local, D1 local, deploy |
| Rust | stable (qua `rustup`) | Chỉ để build Tauri desktop / Android |
@@ -41,8 +46,12 @@ python -m venv .venv
pip install -r requirements-dev.txt
```
Trên Windows, đặt `PYTHONUTF8=1` (PowerShell: `$env:PYTHONUTF8 = "1"`) để Python đọc và ghi các
file catalog dưới dạng UTF-8.
Python 3.15 mặc định đọc và ghi file dưới dạng UTF-8 (UTF-8 mode, PEP 686), nên trên Windows không
cần đặt `PYTHONUTF8=1` nữa.
Hai file requirements ghim mọi package kèm hash; pip kiểm tra hash khi cài. Muốn thêm hoặc đổi một
dependency, sửa `requirements.in` hoặc `requirements-dev.in` rồi compile lại lock bằng pip-tools —
lệnh nằm ở đầu mỗi file `.in` (chạy bằng Python 3.14, bản Dependabot đọc được; CLAUDE.md, gotcha 40).
### Kiểm tra (giống `python-ci.yml`)
@@ -54,6 +63,9 @@ vulture # code chết
python scripts/validate.py # kiểm tra mọi file dữ liệu catalog
```
`pytest --cov --cov-report=xml` đo thêm coverage và ghi `coverage.xml`, giống workflow SonarQube Cloud
(`sonarcloud.yml`).
### Thử scrape thật
Các lệnh này gửi request thật tới itch.io:
@@ -162,15 +174,23 @@ các việc bảo trì queue. Hãy dùng hạn chế.
```sh
cd webapp
npm run check:tauri # crate Tauri và package npm tương ứng cùng major.minor
npm run cf:types -- --check # worker-configuration.d.ts khớp với wrangler.jsonc
npm run lint # ESLint
npm run knip # file / export / dependency không dùng
npm test # Vitest: app + Worker; test D1 khởi động một workerd local
npx tsc -b # chỉ kiểm tra kiểu (npm run build cũng chạy bước này)
npm run build
npx wrangler deploy --dry-run --env="" # kiểm tra cấu hình Worker, không deploy gì
npm run cf:check # wrangler deploy --dry-run: kiểm tra cấu hình Worker, không deploy gì
```
`npm run test:coverage` chạy test kèm coverage v8 và ghi `coverage/lcov.info`, giống workflow
SonarQube Cloud (`sonarcloud.yml`).
Qodana (JetBrains) cũng phân tích code trong CI (`qodana.yml`: TypeScript / JavaScript, Python và
Rust, mỗi phần có `qodana.yaml` riêng). Nó cần token của project nên không có lệnh chạy cục bộ ở đây;
các inspection tương tự có sẵn trong WebStorm, PyCharm và RustRover.
Sau khi sửa `wrangler.jsonc`, chạy `npm run cf:types` và commit file `worker-configuration.d.ts` vừa
được tạo lại.
+114 -21
View File
@@ -8,13 +8,14 @@ secret: secrets are only ever typed into Cloudflare (`wrangler secret put`) or a
| Piece | Where | What it does |
|---|---|---|
| Worker `free-games-itchio-list` | Cloudflare Workers, custom domain `freeitchgames.win` | Serves the built app + the catalog packs `/data/pack/*` (static assets), the readable `/data/*.json` to apps 4.0–4.1.1 only ([`legacy-data.ts`](../webapp/worker/legacy-data.ts)), `/img` (resized covers), the verification gate (`/api/verify`), `/api/suggest`, `/api/ingest`, `/api/admin/*`, `/admin`, and runs the RSS cron. Config: [`webapp/wrangler.jsonc`](../webapp/wrangler.jsonc). |
| Worker `free-games-itchio-list` | Cloudflare Workers, custom domain `freeitchgames.win` | Serves the built app + the catalog packs `/data/pack/*` (static assets), the readable `/data/*.json` to apps 4.0–4.1.1 only ([`legacy-data.ts`](../webapp/worker/legacy-data.ts)), `/img` (resized covers), the verification gate (`/api/verify`), `/api/suggest`, `/api/admin/*`, `/admin`, and runs the RSS cron. Config: [`webapp/wrangler.jsonc`](../webapp/wrangler.jsonc). |
| Workers Builds | Cloudflare dashboard → the Worker → Settings → Build | Builds and deploys `main` on every push (data commits included). |
| R2 `freeitchgames-thumbs` | Cloudflare R2 | Resized WebP covers (`w160/…`, `w640/…`). |
| D1 `freeitchgames` | Cloudflare D1 | Review queue, feed state, audit log, idempotency keys ([`webapp/worker/migrations/`](../webapp/worker/migrations)). |
| Access apps "Admin" / "Ingest" | Cloudflare Zero Trust | Login for `/admin` + `/api/admin/*`; service token for `/api/ingest` (browser extension). |
| D1 `freeitchgames` | Cloudflare D1 | Review queue, feed state, audit log, automation settings, followed collections ([`webapp/worker/migrations/`](../webapp/worker/migrations); the `idempotency` table of the retired ingest API stays, empty). |
| Access app "Admin" | Cloudflare Zero Trust | Login for `/admin` + `/api/admin/*`. |
| Turnstile widget | Cloudflare Turnstile | The verification gate in front of the web app (action `gate`) and anti-spam on `/suggest` (action `suggest`). |
| Transform Rule "Verified bots skip the gate" | Cloudflare → Rules → Transform Rules | Adds `x-fig-known-bot: <GATE_BOT_TOKEN>` to requests from Cloudflare-verified bots, so search engines and link previews skip the gate (section 1, step 14). |
| Rate limits | WAF rule (Security → WAF → Rate limiting rules) + the Worker's `ratelimits` bindings | Two layers of per-IP limits: the WAF rule stops floods before they run (and bill) the Worker; the Worker answers what still gets through with 429 per kind of traffic (section 1, step 15). |
| GitHub App | GitHub → Settings → Developer settings | The Worker's identity for commits (queue approvals, edits, removals). |
| GitHub Actions | [`.github/workflows/`](../.github/workflows) | Data pipeline (`refresh.yml`, `update.yml`, `force_update.yml`), CI, releases, build monitor. |
| Staging Worker `free-games-itchio-list-staging` | `staging.freeitchgames.win` (whole host behind Access) | Optional pre-release checks, deployed by hand from any branch with `npx wrangler deploy --env staging` (`wrangler.jsonc` → `env.staging`). |
@@ -24,7 +25,7 @@ secret: secrets are only ever typed into Cloudflare (`wrangler secret put`) or a
Do these once (and again with the `-staging` names for the staging Worker).
1. **Build settings** (Worker → Settings → Build): root directory `webapp`; build command
`npm run build`; deploy command `npx wrangler deploy`; build variable `NODE_VERSION=24` (no
`npm run build`; deploy command `npx wrangler deploy`; build variable `NODE_VERSION=26` (no
`VITE_CF_BEACON_TOKEN`: the zone injects Web Analytics, step 10). The staging Worker, if you use
it, is deployed by hand (`npx wrangler deploy --env staging`); turn its builds for non-production
branches **off** (otherwise every push to `main` also gets a preview build there).
@@ -37,7 +38,8 @@ Do these once (and again with the `-staging` names for the staging Worker).
(and `freeitchgames-thumbs-staging`). A deploy fails while its bucket is missing.
4. **Images → Transformations**: enable for the zone; allowed source origins: `img.itch.zone` only.
5. **D1**: production `freeitchgames` exists (created 2026-09-18 in APAC with
`npx wrangler d1 create freeitchgames`; its id is in `wrangler.jsonc`; `0001_init.sql` applied).
`npx wrangler d1 create freeitchgames`; its id is in `wrangler.jsonc`; `0001_init.sql` applied,
`0002_automation.sql` (4.4: ingest outcomes, settings, followed collections) applied before the 4.4.0 merge).
Staging: `cd webapp && npx wrangler d1 create freeitchgames-staging`, put the printed id in
`env.staging.d1_databases`, then `npx wrangler d1 migrations apply freeitchgames-staging --remote --env staging`.
Apply every new migration by hand (`npx wrangler d1 migrations apply freeitchgames --remote`)
@@ -48,17 +50,15 @@ Do these once (and again with the `-staging` names for the staging Worker).
- Access → Applications → Self-hosted **"Admin"**: `freeitchgames.win/admin`,
`freeitchgames.win/admin/*`, `freeitchgames.win/api/admin/*`; policy *Allow* → your email(s);
session 24 h. Copy its **AUD** tag.
- Self-hosted **"Ingest"**: `freeitchgames.win/api/ingest`; policy *Service Auth* → a service token
(Access → Service credentials) named e.g. `itch-f2p-extension`, with an expiry; copy the AUD tag.
The extension sends `CF-Access-Client-Id` / `CF-Access-Client-Secret`.
- 4.4.1 removed the browser extension's ingest API: delete the old self-hosted **"Ingest"** app
(`freeitchgames.win/api/ingest`) and its service token (Access → Service credentials) if they still exist.
- Staging: one self-hosted app covering all of `staging.freeitchgames.win`.
7. **Turnstile**: add a widget (Managed) for `freeitchgames.win` and `staging.freeitchgames.win`. The
same widget serves the verification gate (action `gate`) and the Suggest form (action `suggest`);
the Worker checks the token, the hostname and the action, so a token from one can't be used for
the other.
8. **Fill in `wrangler.jsonc` vars** (not secret) and commit: `ACCESS_TEAM_DOMAIN`
(`https://<team>.cloudflareaccess.com`, no trailing slash), `ACCESS_AUD_ADMIN`, `ACCESS_AUD_INGEST`,
`GH_APP_ID`, `GH_APP_INSTALLATION_ID`, `TURNSTILE_SITEKEY` — in both the top level and
(`https://<team>.cloudflareaccess.com`, no trailing slash), `ACCESS_AUD_ADMIN`, `GH_APP_ID`, `GH_APP_INSTALLATION_ID`, `TURNSTILE_SITEKEY` — in both the top level and
`env.staging`. Then `npm run cf:types`. The production values are filled in (2026-09-18). Change
them in the file, not only in the dashboard: every deploy — so every data commit — replaces the
Worker's plain-text variables with the file's values. Secrets are not affected.
@@ -82,8 +82,8 @@ Do these once (and again with the `-staging` names for the staging Worker).
DMARC for poli0981.dev live in that zone's Cloudflare DNS). freeitchgames.win needs no mail setup.
12. **Zone settings**: SSL/TLS Full (strict), Always Use HTTPS, minimum TLS 1.2, TLS 1.3 on; Smart
Tiered Cache; Browser Cache TTL "Respect existing headers"; Rocket Loader and Email Obfuscation
**off** (they rewrite HTML and break the CSP); WAF managed rules on; one rate-limiting rule for
`/api/*`; Bot Fight Mode **off** (it can't be skipped for the extension or the apps; the
**off** (they rewrite HTML and break the CSP); WAF managed rules on; the rate-limiting rule of
step 15; Bot Fight Mode **off** (it can't be skipped for the apps; the
verification gate covers the web app instead). Keep HSTS
`preload` only if every subdomain (including `staging`) will always be HTTPS.
- Measured 2026-10-03: TLS 1.0/1.1 are refused, TLS 1.3 and HTTP/3 answer, `http://` redirects
@@ -137,6 +137,60 @@ Do these once (and again with the `-staging` names for the staging Worker).
`SITE_ORIGIN=http://localhost:8787` and a 32+ character `GATE_SECRET` in `webapp/.dev.vars`, then
`npm run build && npx wrangler dev` (on localhost the cookie is `fig_gate`, without `Secure`, and
no bot token is needed).
15. **Rate limits** — two layers, both per client IP (an IPv6 client by its /64 in the Worker).
- **Layer 1, the zone's WAF rule** (Security → WAF → **Rate limiting rules**). It runs before the
Worker, so a request it blocks costs no Worker request, it is the only limit on static files, and
it counts across the whole data centre — the only limit a flood of new connections can't spread
out of (see layer 2).
On the Free plan there is **one** rule, counted by IP over **10 seconds**, with a 10-second block;
if a rule already exists (the old one for `/api/*`), edit it rather than adding one. Settings:
- Rule name `Flood guard`. *If incoming requests match* → *Edit expression*:
```
(not cf.client.bot and not starts_with(http.request.uri.path, "/assets/") and not starts_with(http.request.uri.path, "/data/pack/"))
```
(In the builder: *Verified Bot* equals off, *URI Path* does not start with `/assets/`, *URI
Path* does not start with `/data/pack/`, joined with And. If the editor refuses
`starts_with`, use `not http.request.uri.path wildcard r"/assets/*"` and the same for
`/data/pack/*`.) Bundles and packs stay out: they are free static assets with a long cache, and
a first visit loads a few dozen of them at once. Verified bots stay out like at the gate.
- *With the same characteristics*: IP. *When rate exceeds*: **300 requests** per **10 seconds**
(30 a second; a person scrolling the Games list fast loads about 100 covers in that time).
*Then take action*: **Block**, default response (429, Cloudflare's "error 1015" page), for
10 seconds. Deploy.
- Lower it once Security → Events shows what real traffic looks like; don't go below ~150 per
10 s (a Games page asks for up to 100 covers).
- **Layer 2, the Worker** ([`webapp/worker/ratelimit.ts`](../webapp/worker/ratelimit.ts),
`ratelimits` in `wrangler.jsonc`, deployed with every build — nothing to set up). Every request
that runs the Worker counts, per 60 s and per Cloudflare location: `RL_SITE` 120 (app pages, the
public `/api`, the readable `/data` JSON, misses), `RL_IMG` 600 (`/img` covers), `RL_ADMIN` 300
(`/admin` + `/api/admin`); on top, `RL_SUGGEST` 5 (Suggest POSTs) and `RL_GATE` 20 (verification
POSTs). Over a limit: 429 + `Retry-After: 60` — JSON `{"error":"rate_limited"}` for the API,
covers and files (with CORS on `/data`), a small "Too many requests" page (EN/VI, no script) for
app pages. Verified bots (the gate's header) are never counted. **These counts are loose**:
each machine of a data centre counts on its own and syncs late, so they hold for a client that
keeps one connection (browsers use one HTTP/2 connection, scripts with keep-alive) but hardly
for one that opens a new connection per request — measured after the 4.5.0 deploy, 1,000 such
requests in a minute got no 429. That is the WAF rule's job. Change a limit in
`wrangler.jsonc` (then `npm run cf:types`); keep `period` 60 and a new `namespace_id` per binding in
88xx (staging 89xx) — the ids are account-wide, and the account's other Workers use the low numbers.
The counts are approximate and fail open (a missing binding or a limiter error lets requests
through).
- **Test** after a change (it blocks your own IP for up to a minute). The Worker's limits, over
**one** connection (a single `curl` with many URLs reuses it):
```sh
curl -s -o /dev/null -w "%{http_code}\n" $(printf 'https://freeitchgames.win/api/health %.0s' $(seq 200)) | sort | uniq -c
curl -s https://freeitchgames.win/api/health # {"error":"rate_limited"} → the Worker; "error code: 1015" → the WAF rule
```
About 120 answer 200 and the rest 429 (fewer pass if you sent requests in the last minute). The
WAF rule needs more than 300 requests within 10 s — faster than `xargs curl` gets from a home
connection (~20 a second). Node's `fetch` keeps a pool of connections and does it:
```sh
node -e "let n=0,t={};const go=async()=>{while(n++<800){const r=await fetch('https://freeitchgames.win/api/health');const b=await r.text();const k=r.status==200?'200':b.includes('1015')?'WAF 1015':b.includes('rate_limited')?'Worker 429':r.status;t[k]=(t[k]||0)+1}};Promise.all(Array.from({length:100},go)).then(()=>console.log(t))"
```
Measured on 2026-10-27 with the rule above: 800 requests in 4.9 s → 111 × 200, 201 × Worker 429,
488 × WAF 1015 (from 1.4 s on), and the site answered normally again 10 s later. Security →
Events lists the WAF blocks; Worker 429s show up in Workers Logs (sampled,
`head_sampling_rate` 0.1).
## 2. GitHub
@@ -149,9 +203,19 @@ Do these once (and again with the `-staging` names for the staging Worker).
policies don't claim them). Rulesets: target the default branch (block deletion and force
pushes); protect tags `v*`. Merge PRs with squash or a merge commit — never fast-forward.
3. **Secrets**: keep `DISCORD_CI_WEBHOOK`, the release webhooks and the Android keystore secrets.
`GH_TOKEN`, `TELEGRAM_BOT_TOKEN` and the three `DISCUSSION_*` secrets are still set but no workflow
uses them any more (checked 2026-09-24): delete them.
`GH_TOKEN`, `TELEGRAM_BOT_TOKEN` and the three `DISCUSSION_*` secrets, which no workflow used any
more, were deleted on 2026-10-16.
4. **Signing key**: the old key `03F965C2E2DB5C6B` was exposed; sign with the replacement key.
5. **Qodana** (JetBrains, <https://qodana.cloud>): one Qodana Cloud project per linter, because a
project takes one linter — `itch-typescript` (`qodana-js`), `itch-python` (`qodana-python`) and
`itch-rust` (`qodana-rust`, Early Access). Each project token is a repository secret:
`QODANA_TOKEN_TS_JS`, `QODANA_TOKEN_PYTHON`, `QODANA_TOKEN_RUST` (Settings → Secrets and variables →
Actions). `qodana.yml` runs the three jobs; the settings are `webapp/qodana.yaml`, `qodana.yaml`
and `webapp/src-tauri/qodana.yaml` (each with a quality gate of 0 problems: a finding fails its
job — fix it, or switch the inspection off there with the reason). The three linters need an **Ultimate** licence: when the
trial or the subscription ends, the scans fail with a licence error — renew it, or delete
`qodana.yml` and the three files (nothing else depends on them). A new token: Qodana Cloud →
the project → Settings, then update the secret.
## 3. Releasing a version
@@ -160,25 +224,50 @@ Do these once (and again with the `-staging` names for the staging Worker).
`webapp/src-tauri/tauri.conf.json`, `webapp/src-tauri/Cargo.toml` + `Cargo.lock`, and the version
badges of `README.md` / `README.vi.md`. Write the notes in
`changelog/<major>.x/ver<major>.<minor>.x.md` and add the row to [`CHANGELOG.md`](../CHANGELOG.md).
2. Open a PR; when CI is green, merge it with squash or a merge commit — never fast-forward. A push
2. Run the accessibility smoke test ([`ACCESSIBILITY.md`](../ACCESSIBILITY.md) §4) on the preview or the
merged site: the main tasks with the keyboard only, a screen reader spot check (Narrator, NVDA or
VoiceOver), 200 % zoom and a narrow window, reduced motion, and a Windows contrast theme. If a
change made a known limitation go away (or added one), update §6 of the statement and its
Vietnamese mirror.
3. Open a PR; when CI is green, merge it with squash or a merge commit — never fast-forward. A push
that touches the changelog posts to Discussions → General unless the head commit says
`[skip-discuss]` (the release announcement usually covers it).
3. Apply any new D1 migration and set any new secret **before** the merge deploys code that needs them.
4. Tag from `main`: `git fetch origin && git tag -s vX.Y.Z origin/main -m "…"`, then
4. Apply any new D1 migration and set any new secret **before** the merge deploys code that needs them.
5. Tag from `main`: `git fetch origin && git tag -s vX.Y.Z origin/main -m "…"`, then
`git push origin vX.Y.Z`. `release_desktop.yml` opens one draft release and the desktop and Android
jobs upload into it (12 assets for 4.x). Never create the release by hand first.
5. When every asset is there, edit the title and notes (from the changelog), then
6. When every asset is there, edit the title and notes (from the changelog), then
`gh release edit vX.Y.Z --draft=false` — that fires the Discord and Discussions announcements.
## 4. Routine
- **Maintenance mode** (since 4.6.1): the project is stable. The work left is the weekly dependency
sweep, security fixes, runtime updates and the items below; feature requests and code pull
requests are closed with a pointer to README → Project status. Issues stay open for the data
only (add, fix, remove a game), accessibility barriers and things that broke.
- **Mass-change alert** (Discord, "mass_change=true"): itch.io probably changed its page markup. Look at
a few flagged games on itch.io. If the parser is wrong, fix `scripts/scraper.py`; if the removals
are real, dispatch **Refresh catalog** with `allow_mass_removal`.
- **Removal / takedown request**: `/admin` → Catalog → the game → Remove (the reason is public). A
wrongly removed game: Catalog → Removed → Restore.
- **Removal / takedown request**: `/admin` → Catalog → the game → Remove… (the reason is public; the
presets get a translated label on the Removed page). Several games: tick up to 100 search results, or
paste their URLs under **Remove by list** — one commit either way. A wrongly removed game: Catalog →
Removed → Restore.
- **Review queue**: `/admin` → Review queue. "Approve with override" is needed for games that were
removed before.
removed before. Selections of any size go out in batches of 200 (one commit each).
- **Adding a list of games**: `/admin` → Add games. Paste any text (or load a file, or read an itch.io
collection), press **Check** to see what Add would do, then **Add**. **Recent batches** follows each
game through the ingest (added / waiting / dropped with the reason); the ingest runs right after each
commit and handles about 650 games per 45-minute run, the rest waits in the queue.
- **Automatic rules**: `/admin` → Settings. Auto-approve (on by default for RSS and Suggest, after 24 h)
queues pending items without a flag that nobody rejected; it only considers items found after the
moment it was switched on ("Include older pending items" lifts that), at most 100 per cron run.
**Followed collections** are read in turn (≤ 30 pages per run, one a second); their new free games
are queued directly, removed or flagged ones go to the review queue. Settings also shows what the
last cron run did (Workers logs are sampled), and a collection whose page could not be read (status
422: itch.io changed its markup) adds nothing until `worker/collections.ts` is fixed.
- **Reviewing new games**: `/admin` → New games (added in the last 7 / 30 days): set 18+ and the virus
check for up to 100 games at once. **Activity** lists every admin action and automatic run with its
commit.
- **Build failed** (Discord from `deploy-status.yml`): open the build log linked in the message; the
site keeps serving the previous deployment meanwhile.
- **New D1 migration**: add `webapp/worker/migrations/000N_*.sql` (never edit applied ones), apply it
@@ -195,6 +284,10 @@ Do these once (and again with the `-staging` names for the staging Worker).
```
`npx wrangler tail` shows the `legacy-data: 410` lines with the requesting `Origin`: an installed
app that sends an unexpected one would show up there.
- **Visitors report "Too many requests" / error 1015**: "error 1015" is the WAF rule (section 1,
step 15) — raise its threshold in the dashboard, effective within a minute. The site's own "Too many
requests" page or `{"error":"rate_limited"}` is the Worker: raise the limit in `wrangler.jsonc` and
deploy. Both reset by themselves (10 s / 60 s).
- **Verification gate misbehaving** (visitors stuck on the check, crawl errors in Search Console):
`npx wrangler secret delete GATE_SECRET` turns it off at once; then look at `npx wrangler tail` and
`curl -s https://freeitchgames.win/api/verify`.
+9 -1
View File
@@ -7,7 +7,7 @@
[tool.ruff]
line-length = 100
target-version = "py314"
target-version = "py315"
[tool.ruff.lint]
select = ["E", "F", "I", "W", "UP", "B", "BLE", "S113"]
@@ -22,3 +22,11 @@ ignore_names = ["no_network"]
testpaths = ["tests"]
# tests/conftest.py blocks all network access; parser tests use saved fixtures.
addopts = "-q"
# `pytest --cov --cov-report=xml` writes coverage.xml for SonarQube Cloud
# (.github/workflows/sonarcloud.yml); plain `pytest` measures nothing.
# Relative paths, so the scan job resolves them in its own checkout.
[tool.coverage.run]
source = ["scripts"]
relative_files = true
branch = true
+36
View File
@@ -0,0 +1,36 @@
# Qodana for Python: the data pipeline (scripts/), its tests and the Python
# maintainer tool in webapp/scripts/. Run by .github/workflows/qodana.yml
# (job `python`), reported to https://qodana.cloud/projects/GgGnX.
# The web app and the Tauri shell have their own projects: webapp/qodana.yaml
# and webapp/src-tauri/qodana.yaml.
version: "1.0"
linter: qodana-python
withinDocker: false
profile:
name: qodana.recommended
# The quality gate: any problem fails the job (and turns the README badge red).
failureConditions:
severityThresholds:
any: 0
exclude:
- name: All
paths:
# Analysed by the other two Qodana projects.
- webapp/src
- webapp/admin
- webapp/worker
- webapp/vite-plugins
- webapp/public
- webapp/src-tauri
# The catalog and the pipeline's state: data, not code.
- data_game
- scripts/state
# itch.io pages saved as served, golden files and vectors for the tests.
- tests/fixtures
# `${{ secrets.NAME }}` in a workflow is a reference to a secret, not a secret.
- name: HardcodedPasswords
paths:
- .github
# It reads requirements.txt only; Pillow, for webapp/scripts/gen_assets.py,
# is a development dependency (requirements-dev.txt).
- name: PyPackageRequirementsInspection
+13
View File
@@ -0,0 +1,13 @@
# Lint and test tools on top of the runtime pins (`-c`). requirements-dev.txt is
# the hash-locked compile of this file; regenerate it after an edit (CLAUDE.md, gotcha 40):
# pip-compile --generate-hashes --allow-unsafe --strip-extras requirements-dev.in
-c requirements.txt
-r requirements.in
ruff>=0.17.1
pytest>=9.1.1
# `pytest --cov`: coverage.xml for SonarQube Cloud (.github/workflows/sonarcloud.yml).
pytest-cov>=7.1.0
vulture>=2.16
pillow>=13.0.0
# pytest needs it on Windows only; listed so a lock compiled on Linux (Dependabot) still installs there.
colorama
+489 -5
View File
@@ -1,5 +1,489 @@
-r requirements.txt
ruff>=0.16.10
pytest>=9.1.1
vulture>=2.16
pillow>=12.3.0
#
# This file is autogenerated by pip-compile with Python 3.14
# by the following command:
#
# pip-compile --allow-unsafe --generate-hashes --strip-extras requirements-dev.in
#
beautifulsoup4==4.15.0 \
--hash=sha256:288e3ca7d54b06f2ac191970bc275c1939cb46d450b255bf6718b04aa37ab4f7 \
--hash=sha256:d6f88de62e1d4e38ecb1077eb9724cd0eff29d2a08ca16a401e9b9e93f117cf9
# via
# -c requirements.txt
# -r requirements.in
certifi==2026.10.23 \
--hash=sha256:a9895e6e2758b371e0545e321a3a8fd1fcfd9829ada8824a936dfb16aaaf36cd \
--hash=sha256:e9b54de76e530bb6cf0ccd036787103acb58fd42ba930ea8bf948ddbaa2f61d1
# via
# -c requirements.txt
# requests
charset-normalizer==3.5.2 \
--hash=sha256:01077390b03f7988f11d700a2194e69b119741a86b1a638b1db88891e3eced8e \
--hash=sha256:01b0c0d2262a9e28e8484a278c7e1b5d650e3ac8cf2683d2967e25899f208bdf \
--hash=sha256:04851f73ae72b8413dddadb16a49dfee95263553741fd42d546f7d66907e6be5 \
--hash=sha256:0521c5665880b33d603717defa76c094048900010897909952397feb3039da56 \
--hash=sha256:0774bf9bf620249fee3e0b8b9fd3065de213be30f3aa94ce2494b3b638949e26 \
--hash=sha256:0891b9d3903c5571c03771ca669a4b0ec5618ca722a5c957d3d29cd4e5062848 \
--hash=sha256:0c951d5e6dd9c2ff60609476752bee49da4206adde960ebc247766937f72e718 \
--hash=sha256:0fed1d06615f022ee3b13caf5e8b180cfea32bb2c5aded8a9d44277afc040f93 \
--hash=sha256:114e4d0c92d618409ed82a99e22b5c5e768fe995f2973f78265f4524f49d4640 \
--hash=sha256:11912e4bb14baae7c5d8791aa55ba0a3a03ec6729073307b0f57270abaa713d3 \
--hash=sha256:11a4d68a6ecda3292cb1e50239e111543ba5d709bb62a6b4ea1afcfa729d8875 \
--hash=sha256:124fbf1a8ff966d87ae05bb8bd45a71f966055ed8bba320d0c7cf450bc5f4d0e \
--hash=sha256:1461ac396c4fdb983a675f20aa555624f0ee18ac83d832b9244ffff3d8055275 \
--hash=sha256:1503bccbeb36d5527790c3930327704c39af22de3112f1b1666a9f3ce15ee204 \
--hash=sha256:15bb4005af6320d259dc7593ca84a38d7fe06a421dbcf7b910ae23979101e787 \
--hash=sha256:15c44f7edfd477b06f517a5cc317fc1707edb9de2c865f43d4b6513907473234 \
--hash=sha256:16fa0eccf81304b79c5cd87f9271c3b85dd9dd99245e4422ae9c0dd45e0f99d3 \
--hash=sha256:183b88127acdb4fabe59d951ab424faf1af7b63cdbb5f776186c1ea2ffcaed98 \
--hash=sha256:195c26fb65950f8fce54e26349852b7bdd7c5f120aeefbcc440b8a20faaed4a3 \
--hash=sha256:1afb975bd5d68d5ce9f6b6d44fdf2f7e34b895a35e95708a7a91b20a3b51d187 \
--hash=sha256:1b4cbc7c3491ccb4aa17fcd8165649d01cf39f76de1696da8631b5f71b85401d \
--hash=sha256:1bc0baf5ef96b6ede57d47f4b8fe4d9d84019c3bfcbeb20a41edc6a6ee341f1f \
--hash=sha256:1c50fe28bbc2ced33386f298650d91218076c05420e6cbd790b913adc41659e7 \
--hash=sha256:1db38f4c5496827c1a501846d64d14c3b80c7e6714e406cd7dc36a9899fa1011 \
--hash=sha256:211d5a3eb6af8f513b8d4ca19a8c1b7accab1b5f0d3175f9826b03c1a920dc1f \
--hash=sha256:23851fb4e1b85ed3f6c2a27b777cdfe2e19fb5b38429a8faf38c7542b7665869 \
--hash=sha256:254eb48b9fa5ee9898a3c445825a1f340fe53712a098904b39b0bddba8ea3cb1 \
--hash=sha256:2625388c6c754520c37abaf3b41eb34d1cc4a373f457898f08606c8e362b891d \
--hash=sha256:281cb91036248400f4cc957495cccd44c275c2e0c5854f7e45ac5cf7dc193847 \
--hash=sha256:28a15fdad492a99b6eccfaaed66ef3f74050680545ea61ec8b2f4c538f1f1320 \
--hash=sha256:28b4f0d66fb834ff90f28209ac7bce77868c45d8c93e26f906709d9b7c2e1af9 \
--hash=sha256:2a925889534b3748302dae5dead07cc13480de1dac3aea80a941b729b471ef93 \
--hash=sha256:2b7b3bbfb4fe8ef40600792d762fbaa9057559f9d3fad209525b7a22b99e91fd \
--hash=sha256:2c9ad19a6cfcd5ea5c0d41161d22f9df1dcc277e9bef2751391334546a314c00 \
--hash=sha256:2cc961b171b3f3440f410489ab3573e86aea8736134ebbb40ea1338b7f0831bc \
--hash=sha256:2ce45c6627b22c47e390bc91a41c3d13032192e699fa0bea96e9671b373d69b0 \
--hash=sha256:2e06a3a98f916dd41d27f3105e02e7a40181c98c94b9158733d03a6f80506c09 \
--hash=sha256:304d5463e65a35d7bb0850550e0780395395f6fcf452f04db7d5ca7cecc425ac \
--hash=sha256:304d8e4d493af723536393eee0c689eb7813f4a474c8b479dee63f1fdd98f621 \
--hash=sha256:30fcd120b732aa79317f08dee04d7de0847822e4cf7ee0e9f445bb958832252c \
--hash=sha256:31f3930700408d211f13378ccbe1c40845d8da54bd0681fac3a9b5aae81c7aa8 \
--hash=sha256:34276fd796040bf0993ab33a369aa572e6979c7aab225a88893667ad8eac8f7a \
--hash=sha256:355ad8011081dec5412240c087a9a0c9d4d5039f3ed11a3f13e18c2b29b56c51 \
--hash=sha256:38a873987f3be698494da8b2e3085e29da02da7b633dce73e79c699a113d7bf0 \
--hash=sha256:39de2a259fc954455c57274dc94c79d5842774e1247a016aff30bc0efed0f4ef \
--hash=sha256:3d14b50de6bf4d0edf857a9386836846f982b8f524e188e2e68b96d702bcf4aa \
--hash=sha256:3d21b8b13c7592db2ac5e544a6d83187b995257472b0c9e8351b6d507ae37ed6 \
--hash=sha256:3d31298449090ab8d47b7b1b2a555ff73cac7ed438a08b7ac160980c7ebed649 \
--hash=sha256:3ddacd27458c45bdacd6bd6db644bfb730efbf9e830310186e3045c9c5be8fb2 \
--hash=sha256:3df041de8887954562c9b261cba85ca0e9ded74048daf125f45edcfaa4832229 \
--hash=sha256:40ab6bffa02ae10a0581e6c198be7d2d8ca5c2a0c64e4ed3465d766df457573e \
--hash=sha256:4275811936e2f06feff5e598fb42a1b7ae852da8e39605211892b56b81a34efd \
--hash=sha256:443eae2bf318abeaf6f15d785138f71fd6de770e99a92158b8b814265e079115 \
--hash=sha256:447441e76ec720b15e64418d32e092297340387053047c7c694f579efb0ee1d9 \
--hash=sha256:4495c5002a7b28557e7e222e77e0b661183e432b7d6d2e788101e3f240e05b8c \
--hash=sha256:44bd4fbb29dfbeba60e7d2bd000c59e4b21ddb3cc53912b14048d37092706d7c \
--hash=sha256:4685902cf26edf013ed7a3da0f426ebba7a00ebb9541386d835afbf002c11cab \
--hash=sha256:498dc3188ca05a68231ac3fdbfc7f57eb67e1343c30e0fea17f8218c1599b253 \
--hash=sha256:4c2b5031f63e331e3839b40aed2dd6f191e9c07edbde303e7876846ea1946995 \
--hash=sha256:4d48f2d08b9de5864e2c8744d4461b862fb149a18274abc8b698c45975573438 \
--hash=sha256:4f87960d57feabfb618e4e0af6e7371645fa26a277860739d6e5d6e0012c92f0 \
--hash=sha256:50e3adfb96fc189eb27b1cf62d3b598b89b4bb0420d93a3d3e42e137409011be \
--hash=sha256:51cf45226a9b588d0d2b4880c62d686934b63ab0bd79ca23ab0e9762eb27441b \
--hash=sha256:52aa6992700996af31f375de0c6bacd402b0097fe40b53c426b9f51a90ebabc7 \
--hash=sha256:55ea99acb17b9325618de155a0cd6a2e8f5d10be008113e1d433bbb58db543b2 \
--hash=sha256:56bc200a365efb37383b7852e4cc5898d3b2da5987289b543956cf8cad71018a \
--hash=sha256:588461c2e8384d309bd63e5826019b6977bc66d629b99ac8737bb795d7b2cb5a \
--hash=sha256:58ca3755ee7ff7f59b57789ec9833c9de9ea275405cdd240eda1f193112e398a \
--hash=sha256:58f361dcbab699cf8f42db3f47c8e7fd1036f138c23a5d08de9fde5f425a730c \
--hash=sha256:598a11a2c7ebaa5334bf698bf29568c9c390abac6a154d8170fedecd1cea38c5 \
--hash=sha256:59f63901b0031c3136cf64704dcb21de0bbae62ce2c9529bc39d27665463de37 \
--hash=sha256:5cde776b7cc66e4f6c99612cea4aa7269aa65863f7a15841b2c264f103822f4e \
--hash=sha256:5e2b6b57e9733d39f0c9fd3185efa6b8e29652c4cd8fe94180272cf6ed9a78c4 \
--hash=sha256:5fb29fb8cd1a46c27a1bf9613ad5ec2599310d46b4025d9556404a6b6a292800 \
--hash=sha256:6045373d5a89a5ec71afde535db987ca28e76dfa276c2d4c818265b375d4b055 \
--hash=sha256:619799369eeef6366ed3e8755a5670f4f2f0fb6b30a0fd7264dc0fdc2357058e \
--hash=sha256:62588a277bfb59def052abd940703fa35107152bf479781a878617d60faf8fb5 \
--hash=sha256:62603db9a7caa0802eaa28c1c46fecd7b3a263a774069c24c3c28c302448721c \
--hash=sha256:65cd72beeeca9d3aaea1201e5923859f308f952f9c71de93f06063c79f0f7a3b \
--hash=sha256:68eb192d85ab8e5f6ec69c2bc6ac0179fbf04a5ac1569d12fbef74883fe102d0 \
--hash=sha256:6bd128f206a7752ae1f2ab6c61bf8a24ba28913a10df8b14c2637b973ff97a80 \
--hash=sha256:6be488a102b8cf28d0391d8c4ba7748938ae28b78ad901f8585520fca33ead1a \
--hash=sha256:7218e8f32b0956cfcd048fd42d9d5779809745ca1d86113ca56f66e7ae1549c4 \
--hash=sha256:7441d755b7ab94f8d4eb3e43ec05482d760842fd263d003a99102d742cd835e2 \
--hash=sha256:749e97e1b32313717a565abbe321bc2190bc8b35f1a67e4cdbc7c56c8d8ffe58 \
--hash=sha256:75a3ceed0724d625d64b86ca20aba182e4df462e04c2414fc941c0f523f06aac \
--hash=sha256:780fbe7cab297b81dad9fb8dc5eb003c0468ffb0d9e5f65068c53a34661a96bc \
--hash=sha256:78456a747de8dc58360ffa581f30a002baf5aa28cb262536545e91f113ed7639 \
--hash=sha256:7967d08cf06dee78443b874f98c98036f624f3a4e73e11f9f64f5be4d25393cf \
--hash=sha256:7a881931aa470808df94a8c380eed2bbbc76cd9dc622310f99665658c821eb6d \
--hash=sha256:7dcd882da75ef9adf94903b1e3b9419e8aa8fb4c7396822b834b9ef7fb96954f \
--hash=sha256:7e841fb9010836c992c9f12fcbd43a831de93a5f726fc1ccd8ca1d0268c5014c \
--hash=sha256:7fdde2c9fd9e3eca40631e024664cf2584272cc8f96308cbe5fdfc930f51d8bc \
--hash=sha256:8024d00c3faf3fc0c16e07a69f4405e8eac7cc0ab15f65fe6cf43827c4cf72b4 \
--hash=sha256:80d02b6f04e92601a081dd97b23d3128033098bff5d35d392ddcc0476ea11253 \
--hash=sha256:838dcc90063569a0448120554591a1d6c4a4ffe11babf048908793154ab86ade \
--hash=sha256:849df64e889b2e17230d58410a03dba311a65b163508fd33679b2b737d4b7858 \
--hash=sha256:87475fabc8d9996fd9c27debb395e642e8c838d78a00b6e932227a0e06b81e26 \
--hash=sha256:87e50a3e7cb90af586b6c5faf23e302a970415ac73bd7bd90a515a04b427ef96 \
--hash=sha256:89b53f3cda69831909888e0494f4fa0bcd3537e3e138dabeb620bd6ad946bae8 \
--hash=sha256:8a893cc101149f80a653f82062ebc95b34525a2614382e1da5458fe7c6997249 \
--hash=sha256:8b2bfab86aa71ae13aa41a6a26aab338e0db2b8bc75434b05aea89e011ff35a4 \
--hash=sha256:8d86d6fc60743dc916eb79e2eb1ec4818e21e427731543af40a3021851174a13 \
--hash=sha256:915563965d418f986e7e145accc592eae9e1a1be3566ff98a05d7a9ec42a76e1 \
--hash=sha256:92888bb3187c5ba50500b00b3b310c9f2c651709d28036077680cb5255450a03 \
--hash=sha256:93223adc95033dd47133a46ccfc316a0139176fd79085762e27202ec56018f03 \
--hash=sha256:9373ad13ef0d2c0fb761e04e55bfdee5a08b52cef2c882c8fbe9935b1517152e \
--hash=sha256:9409a8bf35cf78353942504b24a57de3d75b708997a1e4bd8db71ac8633ce364 \
--hash=sha256:9b7f416ff0978e2f2249330527f0ad6fa02f4932e6199692d3b52da2048c19e4 \
--hash=sha256:9bde855991b7e362c146535e3136a50bfaffc0487d38b33ca7e5edefc6e23849 \
--hash=sha256:9cae88599c7219005d879f98e5ed53341e9a122af585e1091200358a3003d2a0 \
--hash=sha256:9cf9b1a857e25c4baceeb3624e92a56df3668f398c4acba74e174d81fb4d1d3a \
--hash=sha256:9f56f72050826f63dcee7a7f55b0a77168cb3bfc553fd405e7f8f9ece75a4036 \
--hash=sha256:a090bb2c68df85450502e3e20d665e3a5af9c65a84d6508ed477badd49166fd3 \
--hash=sha256:a192e2c40070d92c3ccf777e3a5c4ff515573cd2bb7ed0c537fdadbbec5bbf21 \
--hash=sha256:a19a731138fc27d5682277d3b9df22855cea1239bce7fcec5f78f42ef2d1f3c3 \
--hash=sha256:a66c3bc5ab1f0ff2164fc9965ddd611ff0802173f4b9d24554c563f6ab7e1d6e \
--hash=sha256:a815775b6c38d4e0ff7bcffbeba67feded90202bb6a226b8dd35f1c855217413 \
--hash=sha256:a89012d6d5476ee112d20d998570ed58df2260a852afb1758809cd6900411d21 \
--hash=sha256:ae4f5fea5b8b8ccff88238cc8569303e5ee95efae67fa62922a311397a71f346 \
--hash=sha256:b6856554c4f44d79fc2307d5768854310a8f0096e501c75637542c82292b0429 \
--hash=sha256:b6b751274acb69d77b3323d6b7dbaa3c7fdfc1eb829b7eb61d262f32e1af9685 \
--hash=sha256:b736353c0a625bbd5fcec108576e2385db3496f4f771f785ff32e108d3c3bc45 \
--hash=sha256:b7fd005a73d9e657273b7a10dc71a9e03c8fb9ee6999798d6918ce095b81ac7f \
--hash=sha256:b91363207bd9dc966a691e959bb47f64b30f7ac4b072be9968b366982f7db77c \
--hash=sha256:ba0b1d2620edf869789c3879223f52bf2afc5d31b3cb47cc57b3a12c05e2aa9d \
--hash=sha256:bbbfc8e28816f19d7c0f1816664980c0a9875d01b27cdf8eedddb639d9e108ad \
--hash=sha256:bd16aabe4a02a297c23417aa17ac6299dbd8c49f673bcd645b4929b11f5a4400 \
--hash=sha256:c0afc6800ba57ccc350374c5bd6150419915d95ce93cdbab2d783d75eaf30ecb \
--hash=sha256:c6708715abcf3c73b99508253e961a9967f02fe536532834149574eda6de0d1c \
--hash=sha256:c7c9ab723cde841fefb34efbad91e87f00a674b1fe1cd0784fde742bf2c154dc \
--hash=sha256:c8f3d67aeaf55f017982b73683f0e7342ba2f6635a78f69ce89ebb26aa411e5c \
--hash=sha256:c9790464842f85f437dbbb54417eda1e0e6bfc52dd8d22d6fd1c994b73b2dc74 \
--hash=sha256:ca403d7e4798f525fdfc78e258820419cbbd0f0ecbab9de7840e3c017cf6b8cf \
--hash=sha256:d008d90a7f2471519aef0c90dfbe73b3e6e4d5e66ac48e19154c17e89e98b604 \
--hash=sha256:d19fbd981a488e22cd04883659ca6b08f50b5974f9fd7c95655ef6a043e5893f \
--hash=sha256:d1befeed746d247c81127bb14de9dc3d30edb6e5976d34f83f86ed262b1d9105 \
--hash=sha256:d2374b62878abb00cd8309b32af6c0b715cd02dec0ca74ef12e5069bdc64144a \
--hash=sha256:d376bbd28b3a8999db1a103b3b388aee6f1ddeb3e51bc2172993efdcd86e064d \
--hash=sha256:d4a7319f304a774bed22115bc891618e45f85065ab44ea6acd07d274e750519a \
--hash=sha256:d6734d2ef8a50fbf8445c139477da401f50d62a0606bf00e20ec6d87773fefb1 \
--hash=sha256:d760fe2a4d7c3b226cb9026d6a842868d52a7901bd98420e1baf14e80da85cf5 \
--hash=sha256:d913de495d90407cd859d263bee2e5d1a4ed3eb6573c04e70d9ec619a7cbed7f \
--hash=sha256:db19d07e2e0129e974a0e65d0064fc222a446cd5122c2fd4184d2af9fc734a9e \
--hash=sha256:dca9ab98072a5a54ebacebdc45f53e645336b320c667410b061be1ca588ae709 \
--hash=sha256:ddc7dacc8ece3a182e7f15cb862d1fd616b46d076cb1ae9dd232b2c38b655874 \
--hash=sha256:ddf19c062bea7a0cc80f519243d2c01dd091be0cf952a0750d4ad576709559f5 \
--hash=sha256:def79fa35ef0cef8d2accec024f4fdc7ead3012ff02f5215c783f39f03ef8cfc \
--hash=sha256:df29a0a7107f7011e77f4eebdddec4c7331e24d787a0b21a46d63bdf7445da95 \
--hash=sha256:e09a3942ecbdee5cce73ea9d42da82b81b72ac1bf031ce069b93b5adf4eac8cd \
--hash=sha256:e242bb1c5e76e97dfa9e7f209a71e93a01d7f19ffdd5cfbb2e2d55b4f08f8ab0 \
--hash=sha256:e243bd13217235fc7290c621941c3f5cc8b66e4872495be821d7436ba2fb838d \
--hash=sha256:e2af3aad578aa6bd1384bcf4750fc285e5a9de53f40b7d41e5a0bf748edeb2b3 \
--hash=sha256:e4e81e09c1578b8df602e3db08b0b3ea0a6947ad612f52bf8dc5ea8d47691f0c \
--hash=sha256:e54da4baf05720032d527874d40b65fa4d7e5c6c6a43d0c3adbeffcaf275a2b3 \
--hash=sha256:e80e6c2f55656b4824d72065abb4ddd6a525c74bd78a0aab5d9fc2cf4fb5af50 \
--hash=sha256:ed2a239c0ea213acc1908150a3037257083c7c083128f1a4cec2ec4b97dca491 \
--hash=sha256:ed905975ab14056a2e5eb1c376cb2e1ebc5396baf84163939c518556fccde9f5 \
--hash=sha256:ee21e28f0430bd6dc9086c6e525d5e818a44a5ad19720c8a0ef766792f3eb5e5 \
--hash=sha256:ee43c17b173d46a3212baa6ead3ae258eeabdae48c263a01ccf0218c366dd655 \
--hash=sha256:ef4fcbf3327382cd4c9f540babd61248208af7b93eec4de397b4d5f58a09e288 \
--hash=sha256:eff0ac9dbe711a4aee69bf04a83896aa9b85f19641264053a9f6d48573abb7dd \
--hash=sha256:f0aa869112ef88429ae17820d99c3dd9504c9e9c671d3c246f3d7442cb051084 \
--hash=sha256:f3c96f633825733f735c5a9cf21d21a257d8e1edf0b1cee0a064b9c424ca0f7d \
--hash=sha256:f5833ad231be5eb6553de524a70f48d71b2c8563101750531e0b80184e175cd4 \
--hash=sha256:f5ec61164adcec446f8969a3358ec3f9b26bbda3b9213e5586d219afa8df2915 \
--hash=sha256:f7d486c83842422badd511868fd8a9a20e9407ace71564b6af47ce7e60a336c1 \
--hash=sha256:fb9e68df06293761f9fe66ade60a9bc6d0f5e42b8acf2939a9158af86ab0e5bd \
--hash=sha256:fc14a032f813bf5fe624d991960ea83e9715adc27e4c1830a2361eb1d02ac341 \
--hash=sha256:fcff63213e8e6e47770541a4607175404f47cbb3ebea7b6058cc82d524a0e424 \
--hash=sha256:fd1fbe0f116b6e55da77aca2c6ddcddcfac2186cbf78bdebf40fc156efca389d \
--hash=sha256:fe9753dfee015c570d73df76f899f18444d41388bffcde097deba51c4fadbb9f
# via
# -c requirements.txt
# requests
colorama==0.4.6 \
--hash=sha256:08695f5cb7ed6e0531a20572697297273c47b8cae5a63ffc6d6ed5c201be6e44 \
--hash=sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6
# via
# -r requirements-dev.in
# pytest
coverage==7.17.3 \
--hash=sha256:0241e03dd65a1edf2e841eb19d8d72dca21ada5c869dcef6c9fde1b166d519a9 \
--hash=sha256:0837b71a40749d9c4016cf8c51ba8c6153f7dd40cf4dfa287a2f28376fa50917 \
--hash=sha256:0860a5f27ceccd53ee4070acc182588ed4f15b7401cdcca09d8c0cece9c2ad7d \
--hash=sha256:095ad10d17a28c845f2e5f99e398db2f0c680401731ff63a3a1789f2e61ef1e0 \
--hash=sha256:0bad8245a15bc7b15d26d25ece243bbf5d1b1229144f3db189014174429b63bb \
--hash=sha256:11116ab42247d55980b51ab49b5c066de9b6baa56fe371fd555e54feae338619 \
--hash=sha256:16ed46c0d461a3972e8474268c22bf5d88cdd1088435313edc7e220050c5ac97 \
--hash=sha256:17a4bd9edd312744035e1298a6ac30dd7332a7f1ecdc63c9eb0685589b161eb1 \
--hash=sha256:1b358585003cf99a13d1327e11582af19154d2cf3dea366fe0d10ce479a5c9f9 \
--hash=sha256:1ba5c445d4c7718422753a393bcb0feb6d9834321cdb43dcb585725a392b3edd \
--hash=sha256:1bbbc3e4de867a5e75684d98fc77c20e0687ca3abec69b4421b6f3fb96cd860f \
--hash=sha256:1d26daefd513c4775a6d06846389da9a9e3498b6ddba24982359b75b703dd341 \
--hash=sha256:1e7a015f952798d7d5120e8122c160fce7322b0b9d144b9be6af71552a3e68da \
--hash=sha256:203aa5e42c88e9accfa18a0cc91950499efaa5b179a1da14bcbf5b995afdbcb6 \
--hash=sha256:21745c08f2835b847a16887b748d3084dddeb0571ae2a0d62e33644413568b99 \
--hash=sha256:222bc51858b0f64cb15d51380541712f8d5dc9bb5ce4fd9828bf466503d6debb \
--hash=sha256:228f4bcecadcbb1ec3ed088b0595c5c08f3fca01406b72e8a02209a3af16aff9 \
--hash=sha256:22a80bbdee3c22fb3319befaa112a2ed2d6e1417aa75c310f048235170ceca44 \
--hash=sha256:24389d7d50f1fe98ac8d8ec1c946656a75b97d953b51a714484e174ed9f48eb1 \
--hash=sha256:2765261bdcb5f6c01af41d97ec4fcfe18acd1114d8d2690536a36f86b67c179f \
--hash=sha256:28b05f6b2622551805324196c32f3f20f4fa639bade8ac299ca83073253f6663 \
--hash=sha256:28d082105e1ead78de56eb46edde029b5af88e22f8bde74fd092ca164bf15492 \
--hash=sha256:2b9a39e25bf0e6fe072c6f3bceaa02f5303b9f975e83f590d118c4e92aacf6d8 \
--hash=sha256:320a27997b421ea16eeff42cfd26d40584abd436fb7802ca766d6e8610bc9718 \
--hash=sha256:349ab42e0b6b72892f187a60a0890b3a76710e93b7c31579e81648d46230a8ed \
--hash=sha256:35137f71927b7da9292d391409104391b73c5e80d26b6a0d216d871964092351 \
--hash=sha256:397e5342fd4f19ae930a5234643a63a8eaccc18a2f034a2f1765a5313123489d \
--hash=sha256:39c063c038b710e0bca3afd4997ccee680674bece468fac13cb8aee9af530d31 \
--hash=sha256:3a5691ef42b16e22976ec0352a76a0f7c3b4196fe3d39805dcc765e31ce54f22 \
--hash=sha256:3f6d942e066ca009bd1f7ebf5450287a5e9bfc5a6e20a8d8c408a61b433c7f94 \
--hash=sha256:42a1f511a334745a66b8f580c4d561e728243e35f3ada0ada35444c4b2fb9fa9 \
--hash=sha256:4300ad360b21af19584c4cc82022979544d776ba2fb2df5418b2f3cae1eee6d2 \
--hash=sha256:45268757a45946ab3fc9d2c30019aff2d3804ae660121d5b31f523366f604e67 \
--hash=sha256:47cd7674a39bad6480e565e2a5b77f8089ebfbcd3aacc572abc6cebabe1f4cc9 \
--hash=sha256:47e49fced11190fdc678182b0e7f8947db4fc1c1216094923a1d2bbedba3c84a \
--hash=sha256:499acdc43bf1addf7fecc59a3123847bb96873c07001cfbeb709a71b181fa03d \
--hash=sha256:49a4f12eff115fc2447d3438b2c08d7e5adb3abc811c050ee508f8189718cc5d \
--hash=sha256:49fff24117050f1784447ae8181e75a78b01cfef4b6a8ccba676d466d1d68d9b \
--hash=sha256:4b1300f07904db81508b87a72471e80d37fb6d48debf1168e12edccc81cd0225 \
--hash=sha256:4d64248cb7c995aa66dac34c66286c80fb78b13c19bee1503720cc6e55e5de17 \
--hash=sha256:4dc3c84002968363c37688e0b325d51a51816c53f3c0cbb925254317c675a789 \
--hash=sha256:5559549a14f997b261c936ca463ed67e030511f914ffd1692ad08b3b16ed6034 \
--hash=sha256:56b469b63d8270aa67bc919ab8457f4d83115459556a76d09238052a3ab094db \
--hash=sha256:582c5d80b6de5b1909a4222ec1f5676bb2e03815c6be9ff43db2d8a71de5079c \
--hash=sha256:59b4bd56882387b5a957048a77531669d53d641ce8148c23149d2550e9fd4e25 \
--hash=sha256:59c15dcae783ed291da3af6be2e70762322637ac886b19671d12123521cf6ac3 \
--hash=sha256:61138b3a51d91ee443b04962ec9990fa140208a7a082b1754135ebd1378a420f \
--hash=sha256:620fb331a7d94e3749348cb4a5febcb2ef23ef17192349088e80f4da0cf42647 \
--hash=sha256:6695d1bb2a9a2fbd7806d69d78cf30f35eb0f65045da0ec5b5045242fadd6a78 \
--hash=sha256:683a204e9773f3127ef836640712270bc4893f10bd7e1ce8a21735dca4c14429 \
--hash=sha256:6a8db4bf69a1982cf0fcf16fb11ff17bb2ed3ade5b0e803bb67ad2963a7b1bf3 \
--hash=sha256:6d116e2d3b3f3506f634cc48f58dd01497f34a50263e65acfaf6ad7a162f3384 \
--hash=sha256:6f8f925262bc0d6fea12d5dde6998aa57f162e05d5a7d50b95d400ab05bb4537 \
--hash=sha256:733368982d2799ff04d768916fb755e54d4ce11af3573488ece451745c90d4a7 \
--hash=sha256:76a3ddca94ef96b477b7edceac08b1abe0ff26e1ebe1d7000e35bdd17dcde5c4 \
--hash=sha256:7c420ffa993c25cc74c263e9c1c869fbaea7d16dcb6448eef4fa6f1905560f5a \
--hash=sha256:7f02996b09190bcdee3b2af38bf2279e4a1a65306afd3e6c229029dbe41e42ea \
--hash=sha256:8009572d242674765b84ecceba126c2392b1824b32f41db1f3323d23d4cb598f \
--hash=sha256:80e219a51ef7ccf78fcd584257e523ece0d390cb3d9d3896660eac05a19ac691 \
--hash=sha256:83510c65a385563646297e8dd572e5def63dc300ca08ae15307d99a0225cdfb8 \
--hash=sha256:84b5a474040b33f3d805c0b19fadf5a2e78fdd46e0bcb8b813631e5cac64195e \
--hash=sha256:86563b5323fc13239d943b22a1bb9ec60f9ca17bd9a0be09c40a89836697aea2 \
--hash=sha256:89f49fa6890f28247135934c4d92abb16828124b2cddb681e2496997c37364fd \
--hash=sha256:8a054b755bc6665b339a923fed14a54446c43c942bf4edf08a59b1225b284c93 \
--hash=sha256:8a0aef07b2eaeee9d82ca62241d5c6586aed5dd729300507d2d3f612588c2634 \
--hash=sha256:8b713613ed67d5ed88968799e814888b62c6add21f5becad2cae1ec44260e9d0 \
--hash=sha256:8b8188229ab3b3769a1c4aaa22357447555416deb440326c665a3bd25fd45ce0 \
--hash=sha256:957ba72e11d26b6e6e1abdaa72e41020871f4108c8ff64ff571fc50c81fb57a3 \
--hash=sha256:95da285cf77352d4a527e1fd16c1c5c3762e42d1d71cfa9ef2c72a5c796cce36 \
--hash=sha256:9e331bc028b44496ad85d4a2656dbad0feb35baf4a66500042c4aaa878ea132c \
--hash=sha256:9e888603ea67c63ba264f39f3459f4cf68adc78dcd9f8bfa65dde601265a40f1 \
--hash=sha256:a13a946d8de807d8992e56a09502952d81bfbb4b80204ef77a6a2a38b4ce22be \
--hash=sha256:a1dc44fba727d1cbd8daa88ced7dd867aebef5631b116210f2a2d4da08622d03 \
--hash=sha256:a5fa43619c0a53a0424783cc08dbb26a2115e3a890ab566fef811b77d04d5501 \
--hash=sha256:b355277f181890fdfc7f49af89f398f8735f031b2f9a5801082e678e9ae85972 \
--hash=sha256:b65db089de3f219c850f21a2ca915f43f6fa1da5bfb55871c089d3be82c10369 \
--hash=sha256:b6876123ce43459a4b39d5778108010b06164225c3a25c6a43cb85a97f80c549 \
--hash=sha256:b6db3399e76a366353dd0c9a009fe74c3d1c892de35863331c4d06fbe0dd83b8 \
--hash=sha256:b7028eabf24ad18646dbfc6b352cece01779914e69254ddcacdfb9f805d89f61 \
--hash=sha256:b73148d024d086239fc04c03daaeb1934a6d295312dd0d6a04a937326c1207d4 \
--hash=sha256:bb2b2f47ad4cc671491c725250ae2a5cadf43a3b0f9136e78f7ecf9506a9fd61 \
--hash=sha256:bdf8fefb9f1acb3e92842fb42e29968d053e9545e4e9d9edb5c32a30fab8f899 \
--hash=sha256:bf7a43782b20951fe9ddc6f6c28da51c65d3c0d5d5fc3c5a0e566986aa3ec0aa \
--hash=sha256:c38a85dde92c4129641544aca998382f7448a87a17d202765a6adb8a87a33fc7 \
--hash=sha256:c45c4e99a09c70e7d6fe101f59fe4556b89d99bfc80cd4e7f5e13ebb6c1e4854 \
--hash=sha256:c4ae9befec714c867f42bbea99e1ec25eecdbe51c8faf1cc82164bd65bf4db0c \
--hash=sha256:c53abadc7c4cf7870865fbaf7204e86efbacf93354e010e9188007fe2882a073 \
--hash=sha256:c769e6a28bb645c915449ed8ddf6059765a72d8ef79590bfd6202022a4441cd3 \
--hash=sha256:cc12f44ac4d5d6be301285c0a4f9c4ae52e673672e284b2a2744e20d24025573 \
--hash=sha256:cfb1d2c52bb66e847669000658a5394d50aba835df8e31c2146034f978c8a4cf \
--hash=sha256:d0e0fc055d4436f4b6de83f50cbd9da38af18fb36341b162b408ad7842068a33 \
--hash=sha256:d3353cb2ad4254fa433cc53d1ee1fe80eebde529085b238393f3f6d5af821f70 \
--hash=sha256:d5a3cd933fdffb958b4046d6f19d3138c7c8a28c439aac800badf61fab6d655e \
--hash=sha256:dc116b251f7a4ae0266dba0ef31a742c6c517d3a99b4d50016548a17d407ac5f \
--hash=sha256:dc6f3c1406fe7e8e2d59eed1f476c5429dcdd11cd3fbe1341acf8ddc4bb9b383 \
--hash=sha256:dcd518608b7f869838436ff8d922977e186d1082b9ddad37305ad5282186fd41 \
--hash=sha256:dcd6ea389b3da63f467b05c0f47db037a672592ab2035d4bfbb1f662eef4f4a3 \
--hash=sha256:df0faa493ab92bbf33ff8bdab442c5b75089baa5ba752844871b5ce9d009a026 \
--hash=sha256:e033255f24c1df6e046b6c4e9f91baacae08426beb5296bea8d46176b3a137d8 \
--hash=sha256:e04385647f444d55b483a0e4dc519f46134846eddd80910a0d0953ea19e58358 \
--hash=sha256:e142166a52ec7edc650b6d3a0b9b1f79dac0ab8843c249e8821ec97a71d1fd2a \
--hash=sha256:e266c693c8bd6541f31cd71eda9b5aa3732adecbd04522880ea3d23d99b202eb \
--hash=sha256:e3948b2e5c3af0133af3e117ee033e6cc656c43d7549d3296e4b3807908dec9f \
--hash=sha256:e4d18e90c87621590a0b1cf2e4caa96f0aa511073f8a1caa3244e09e569564cc \
--hash=sha256:e592f790fee57e2bedaa27cdc76988a082090d1aac560ca4bbea80a7a58436ec \
--hash=sha256:e9396d4d90fb47a1e124a985ac6a3172dbd58334d1de5189f06b75ae96ff69ee \
--hash=sha256:eb25b51a30d07db8493901e3040284f2e756ec2b6549ee392798b9ef4c0607b3 \
--hash=sha256:f3347c72d0f4cb3803f4ccdd4331a49a90ef2daa683ce89e2480278400bd2eee \
--hash=sha256:f7ff8b21efcbdf9c7a6c051dc158c9bb9e938b7af33e55ed264d2e529b836d17 \
--hash=sha256:f8356475aba020621f8277f1a81c2dbdbda8286c7c6130f242c9816e044062a9 \
--hash=sha256:f848ec842cb95fddae4b88830b249e8bade41697f16909688d2af80e8b51e7b6 \
--hash=sha256:f8f6252bb4c457d686c18e42965087b30155ff72b0dbda6e79a43ee3682c0870 \
--hash=sha256:fa8903475085973b5c916e8a958afd22101b9559880ffbeab5aeac4196768338 \
--hash=sha256:fab6f713a1f2f0ab7fb7d55f3aea15d1f3fbd31ace61b585ecd87c8e34f898fb \
--hash=sha256:faee34ea548318f6f9010928edab2f91b36a19b58376e69ab0e76d4f3a0bf9df \
--hash=sha256:fb5945d7360fb258dee758258d93ea624a712fae494e7a0037a92505b3eb8b32 \
--hash=sha256:ff0ca078fe63faffff1cff24c804afd4010e35d9c75bb593877b3d4321826c91 \
--hash=sha256:ff273110e4e1505ef7a642523ba43f58eb6770ae9e8f869d72efea816cb4bc2c \
--hash=sha256:ff5069e99039739c2fade5dd12cf8df7dc1b1217a0b915110605e0bbdddf1187
# via pytest-cov
idna==3.20 \
--hash=sha256:a7db850025b95ded1eae8a46181a1a6c56c92c96f0e2b005d9ff8dc0210cab44 \
--hash=sha256:ab7ae7122974553370f0bdb919e1a960b2cd1bc1ef0276416d896db81c14582c
# via
# -c requirements.txt
# requests
iniconfig==2.3.1 \
--hash=sha256:67f4b9c50da0dedf52af349e7749a80a9057a5031199791b906c3bb3ae878960 \
--hash=sha256:9121e2c1fdb355232495be3194c8dfe87ccc2d5dee45947b78e68f499790d7a7
# via pytest
packaging==26.3 \
--hash=sha256:94edc256424af38762eb31306eed28beb9f0efc50a8837492c9d6fd6004aed79 \
--hash=sha256:d7193f7c8e4e93f444fde0262bf90af30e16fa0ad0ad44cb553c87339b23cd1c
# via pytest
pillow==13.0.0 \
--hash=sha256:02464da86f561f410e13b061ec37c3068a9cb557a095494157742d07b3c24a27 \
--hash=sha256:04a63720f79e22fd54d897c233a68314c50ca0603360f54ce2bd5db8f0f43782 \
--hash=sha256:05cd2cd39055d0b9650060e4513ef4a9a0aea870083950bd046a0d6490f93a22 \
--hash=sha256:06903aac074d00c988e77a1fc435286dc498506d4ca8d6f69df9babddf4ecc15 \
--hash=sha256:08b826a9bf1265c76de04a42061d61ea6b109418b7826f28ff1ecdfaa26c5502 \
--hash=sha256:0d1a9cf7bc6917538b20f8d06b9ab2147e542f68849e96fc58eb66bdf6acc692 \
--hash=sha256:10b5019883c98f1dd819ca48ffc6f33a91cee04948fe637c605f4345c7cafd6f \
--hash=sha256:12b0fa15879fe5a9d9eebe66e4e2d74128a773b1a4448010c9c714f45e04b9d8 \
--hash=sha256:12fbb851cf323cc19aac3eea1df5ad17b57e91e9fe3cfd06100dba7bb8208c13 \
--hash=sha256:149a1c323ba366f90b48e6f1a6db6582eb50512df374588de56fc909abc0f0f3 \
--hash=sha256:19b66ca0a4d25cc0200b381ce824c7ea090db61427315e73cfb05dbf1b35c369 \
--hash=sha256:1c774b9c0ba0d0b356f71530677b39028878a2cae5a93e0a13779cfd17120f88 \
--hash=sha256:20722cd5375533ad754053363a80b8fb30c79d37930a6f7228030e237ce3bd5d \
--hash=sha256:20822140c9a2ba9c5e42df342b0a892ab2e102fc0e3db967a133bb9ce3f898bb \
--hash=sha256:21c32061a5512dc13f87cc7303e120e4d77c2f70df89a35af0e3ce246e5ac57f \
--hash=sha256:2310e2adfc13c6d457d7d0f2ffdd5c56a74a317650cf765887df8d515a647ac0 \
--hash=sha256:23edf4ec4b6f4f240e8df6e4985e9ee2ced86474632433e55fb1e2548744bf40 \
--hash=sha256:2d50500a4a3bc6469adcdb319cf05d688b08ca3bf0f22a05339f3b25b433a599 \
--hash=sha256:2e31c4e68cffd7b1f116127626813b82fcba19edf6b940a7b0c266d6484d0055 \
--hash=sha256:34fb3db1149c879343861831728c243c432d4a5afc8f1878ca7612ef8de2a033 \
--hash=sha256:37290fbef0c73e2d51d594eb78fded7dc7170d1c3ad0a890269e6fd8c8c4e061 \
--hash=sha256:405be6058e206a86fedce2f715ecc2343f94072d7925251632dffa2c05f70dca \
--hash=sha256:40a266371ece581e5de13b6635ef78d7487824af80561b6ca27694a88c19bc0f \
--hash=sha256:42d63be3af4f9b951b199b0a9d23365d37ab14687e6d77b74940432c8515c4ca \
--hash=sha256:44629d4498c9cb6b2051806155f22141df0d8a929c56134b166655232dfb2f8c \
--hash=sha256:49c12af515073e9bf511e4ef736743bf70d531a643668722279314b937742ba4 \
--hash=sha256:4a25756244bdcce3b50580baadf320fa48297f0eeb8e114ba64139a40d4d0fc8 \
--hash=sha256:4bd024d567eca931b668978d672dba914d4b8e2628e2c3073a2ad178de8a2620 \
--hash=sha256:4f8db54177035a2b5f717f94475b74907e12a96dc74f6d487f3966b0a4694071 \
--hash=sha256:51ebb529fc5e8abdd55302f6c3f8943037348ec2384329a3e55677f69ae2fdfc \
--hash=sha256:567f20f1c75897d7663830da6ea8af719e03d712b1d9ee7f813319f9ece42e5a \
--hash=sha256:5933fcea5a5ba64c686f55c886a115cbfd92f2900460784a1e79909fdbafd7b6 \
--hash=sha256:5bdb38ba220b61b4ec31dd1046dea6b016d3c6850a23f43ed8b58332b2fc668e \
--hash=sha256:5f56499c1a74d2b862beb0c33b8016f99d095858455df9d21583bbbc1c15b582 \
--hash=sha256:67871a13cf47275201553b536c025da777f997fa562a19eb798af4ad4b97c18f \
--hash=sha256:67c8d44ad89fa7eb88de5d6ef6199b1e03dd24974f85a67639fc8badb801fe79 \
--hash=sha256:6a0920cb55df5a4d3f6862964908078c0bd59332bdd1bcd20d14e8c70ef27cc5 \
--hash=sha256:6bce6a29c3898191f4c9998e4d4e8f69790caeabde46e54da4bc235ce5bde683 \
--hash=sha256:6f38f3f885a09cafc93fd667b1173a92f379e43785d635e7983c893f0da319fb \
--hash=sha256:73ee25cf8cf8b75d5a5aeed7cb6588f5e5dbfbb0fde51707b630bbb23897645c \
--hash=sha256:7b999816b5850a35ada08443e6e03945f1f6488144a83afe2d37b240a552aafa \
--hash=sha256:7c88c10dd432f3b39ccdafc9ed81d0c21b8fd634502574da76d1bfa4fe2c76d0 \
--hash=sha256:7d5e097eabd5d4915c27ac9f6e9325bb1e01a7c94d7348b5c4451d3fc30e8521 \
--hash=sha256:7e91e97a929232cdb828889ee6ad0e48d7f40f4ec38818f4e4a8968b2b1af22e \
--hash=sha256:7f6299e494e46253d40c34653cac369412f44ca53b5f85d848d3f95b1ed0546c \
--hash=sha256:816752a5ef76a80484c8c441c85593b7ea9304f6231fc5776ad1fbff7e773058 \
--hash=sha256:83b37abd87b590acd8f47ca8a61f70893322b11834d36e07c2298dacad4d14d2 \
--hash=sha256:8619685cad8efc4c38c66d3b36aad854523297c43d748b3b6f0cc03c90ba3463 \
--hash=sha256:8bf295fe459343bc6093c8e5e0df60bfa189e0fcb775a22e2c2488fdeccc6c0d \
--hash=sha256:8e459b613cf31f8980f584387b4fe47bf08e076e288d61aa8eba1f7fd4ddbb81 \
--hash=sha256:8f36aa77f74b14a2103622b196402c71330e4e7cf4122ee45c854e9a01e0eecf \
--hash=sha256:93ff9c9c3663ce23aaa5d0b6b6abac55359e2a0c06c7e30f3771829af816be63 \
--hash=sha256:9a635068d9793c7f0d929f39f18b58f1bd86c236e8e7b64167b86af9232ebca0 \
--hash=sha256:9dda0788a9932776a75d8bcc020076edc308ce2508b51f6739a45e3158b3fc42 \
--hash=sha256:a192360d512305fe92d3053e4f7627bbad1f7708f1f4ad38cccd9336acabe9ad \
--hash=sha256:a2a14cd73d5e6c927f644b0110ee81f59c4ef506259ec9183904747f2caacc81 \
--hash=sha256:a625df9a2a5597fa5e5266e01aefc82604bb85d291e3547981e863560d75da6c \
--hash=sha256:a6aaa7871aebca081eb5c45f83e845bbd9712ae99fa9286dbfdcee835e63f4b4 \
--hash=sha256:aa694c49787040943570d61c9b8fc01271bd2a2cfdd55f0d896f8aecdce1a981 \
--hash=sha256:adb3c2124c68e480f4632d06cb7caa3b48a51678475f483b4edb1c6dee29ea43 \
--hash=sha256:b84be41387fc00db28c13c02e30d42b02d8d8f6a4a741a1aee6012ca7f1f6039 \
--hash=sha256:bf97ba1b5542050e9b0c74e632323b6d8136cc99d64e193abebee22fe6013c76 \
--hash=sha256:c3bc8ee0271387e0b1e3ad0ff893645990a656e79bf9c42f4f734a3642b11d51 \
--hash=sha256:c50c80e3591e5cf9a8dfa6007d4f10732f02e32263850999286e56ccd650cfb2 \
--hash=sha256:c6fd031333dedcad7ce3e03d244093f43504f209e86925ebdb2b868fa4037630 \
--hash=sha256:c87a04e7f152ee4db5dbe15f0bfa3fe628a1aeedbe66b81c43b87f52c813f9ac \
--hash=sha256:cdcd1ba258178f7356d74170c9a81ba4eab6a5d55748bc402a5a2a6fe6be3510 \
--hash=sha256:d4737f50d23ddd11d6685faacbb9252887dde0bc7997127757247983d74399d6 \
--hash=sha256:d7710eb676e9bb68965cb045be0d333b4c0d7f9dfbaa7fbf121385b1588683d3 \
--hash=sha256:d9b0a2bee3f3e03e9f29057aedb807dbf1e1d96ee1b9d0f422d9db6c8583271d \
--hash=sha256:e65dd6e75de67b2362a4fa3e16aa627595f65054dc4ec73d64680c84d592fa61 \
--hash=sha256:e892354a424b1e82a78ba16785822bdd40de06f19446a3d4a28047df1a4f8932 \
--hash=sha256:e8ca8f69b7c77fa96dad99f8638c1fc4f1c0bed4acaa1baf7a3c31bdb80a0ab1 \
--hash=sha256:e91c2b1cbeae768c98752e67e717e283d68dae45717b41f2d91eaee648e37b7d \
--hash=sha256:e98b4f91f99b24b1da72e10621ba181f7281922384a7403094debb4199de6c00 \
--hash=sha256:ef5fe6b7db3f501c56000ba8fe7c7e1a35ca1d45824fbeb95a67daa85cff4dbe \
--hash=sha256:f11a3c1358bb3c68012a7b1f41b223c3db9f7bfde90b481df028cfe1c3363313 \
--hash=sha256:f391dc92a015c478745192fe4f2e120c2af2aba18d9fe0616341cbf537599806 \
--hash=sha256:f7cbb7a64e7ec664775195e4f81923bc8a93d9451b963f844e59118f63147a7a \
--hash=sha256:f9bd7d260d986f3553518c5d723544346fa48031f8aef3265d786aeb59845bc0 \
--hash=sha256:fc481f742ccda20e9ed760b8f978dff50f2a4e9bc253ac167fb0a05b0783ef52 \
--hash=sha256:ff3fe9eb621fbb9db4c4be33ab946f6bac5f98ab50ca8d3260503653656c961b \
--hash=sha256:ffea6b2986a797c84b6d1d27d4f43e0b83c73fc16281a930891cd237cf0d08fe
# via -r requirements-dev.in
pluggy==1.7.0 \
--hash=sha256:7dd7b0d8832ba3cb632c306926ded123429211b83641b35dc5c41ad2d34f9bec \
--hash=sha256:d1eaa46ebb595891b860ab086b4d09c8588af65ebd4361b8e8f4bb8920b90ba8
# via
# pytest
# pytest-cov
pygments==2.21.0 \
--hash=sha256:2363c69b61c4a97c838da3b130dcd6468f4848992b21a82f2a63ec34377137d9 \
--hash=sha256:610ca751c9bc2492b38eb9a38a7fbc93edbbb2d7182edaf34e66ae493dee5c8c
# via pytest
pytest==9.2.0 \
--hash=sha256:07acdcf88ec174f907dc01af70bf52d49b014bbab03faeeade31c96b18c2e588 \
--hash=sha256:97c4f3b1f3c7414aa36465e09b8220f1d03627993bd51b1282e193753c80557b
# via
# -r requirements-dev.in
# pytest-cov
pytest-cov==7.1.0 \
--hash=sha256:30674f2b5f6351aa09702a9c8c364f6a01c27aae0c1366ae8016160d1efc56b2 \
--hash=sha256:a0461110b7865f9a271aa1b51e516c9a95de9d696734a2f71e3e78f46e1d4678
# via -r requirements-dev.in
requests==2.34.2 \
--hash=sha256:2a0d60c172f83ac6ab31e4554906c0f3b3588d37b5cb939b1c061f4907e278e0 \
--hash=sha256:f288924cae4e29463698d6d60bc6a4da69c89185ad1e0bcc4104f584e960b9ed
# via
# -c requirements.txt
# -r requirements.in
ruff==0.17.5 \
--hash=sha256:0e5c125c5b31dc8efc948d41357496a4c4a312977565ccba740030efdff83580 \
--hash=sha256:40ca8afaac309b41a5b2e09e4e7beb1f824826b93c25697c4d74f573324fba4e \
--hash=sha256:50dfc3c6b3ebd0a932f11dfd579bd42234b0b7137e68940eb6abdbfdb9d69697 \
--hash=sha256:54c0f67d1be11b55d12c184a819fc229f5eee3ef45c16c4fcad41258e83b4882 \
--hash=sha256:625e57d80cd43352d12ea81690f3eac46cddc8c0f35026d137fb0f157f94592e \
--hash=sha256:64a6fd668a336df959c522991de33e9e3c8be463afc0c9ac8f029f9d19ef756e \
--hash=sha256:6f0db748508f04a04e3fbebcc636a5c8b3bd76274f8ed28f497c44d75c2ea2d7 \
--hash=sha256:6f6a7b138edf9cc402ca736a59d9525e6d766e5395760b72e7e146e6251ac963 \
--hash=sha256:86bd1f3b83c25f9b8055c6e796f0685b39d3127ce947322098c3108cf82fd586 \
--hash=sha256:8e85601bd6d9b6c3e3b95c0e0dccdbac1d23c6bcef006d187fbcddaf8225a5df \
--hash=sha256:aa415d57c244299279901d776607fee3df7831c2a7435433fbfacde8632c6550 \
--hash=sha256:b72fbc232e328bdbb9cdddf4f1aedcd61bd1aa64d75fc012114b4add0bd7f26b \
--hash=sha256:d511dd302982e46a285528942fa6557d57730edc4bdb9def95e86a2603d77396 \
--hash=sha256:dd0dfe7c6fe5a447fce467c58e69893be1d9a7e4378f5b9906432da33d94a97f \
--hash=sha256:e1546609b2ad73f1d6c5c076881b788672b7b3cc3283981182cbdbb6524ed88a \
--hash=sha256:e52622ecf3a0df9d03e796fe3eed4aa085adda65520db7e0619cbd2192a97342 \
--hash=sha256:ec4ecf40fb4d6e1265b009dbe551727920926fc0f769070c452d6d84b422a74d \
--hash=sha256:f93d2b7d449ed9545304f6923699ca20d13c675b69f258481709a08ae61076db
# via -r requirements-dev.in
soupsieve==4.1 \
--hash=sha256:ca9abf7126667010d8f6e9b39bfc1bc3b23c8aed9bcb0f54a754dde969bb8aab \
--hash=sha256:e4d667b3974ce6e038e7390486b8093369854a1d345ffdd4c121dfc4a782e809
# via
# -c requirements.txt
# beautifulsoup4
typing-extensions==4.16.0 \
--hash=sha256:481caa481374e813c1b176ada14e97f1f67a4539ce9cfeb3f350d78d6370c2e8 \
--hash=sha256:dc983d19a509c94dba722ee6abd33940f7c05a89e243c47e907eb4db6f1a43e5
# via
# -c requirements.txt
# beautifulsoup4
urllib3==2.8.0 \
--hash=sha256:0cf3cae568d36aa9576b28dfb35f11328f1cb974ca7647d9475ebb86c75ac6e3 \
--hash=sha256:63bf2ead4c879426ebf22ef2a781eeb4aa3b4ae798a0435506f8687fd5bb9b63
# via
# -c requirements.txt
# -r requirements.in
# requests
vulture==2.16 \
--hash=sha256:6e0f1c312cef1c87856957e5c2ca9608834a7c794c2180477f30bf0e4cc58eee \
--hash=sha256:f8d9f6e2af03011664a3c6c240c9765b3f392917d3135fddca6d6a68d359f717
# via -r requirements-dev.in
+6
View File
@@ -0,0 +1,6 @@
# Runtime dependencies of the data pipeline (scripts/). requirements.txt is the
# hash-locked compile of this file; regenerate it after an edit (CLAUDE.md, gotcha 40):
# pip-compile --generate-hashes --allow-unsafe --strip-extras requirements.in
requests>=2.34.2,<3
beautifulsoup4>=4.15.0,<5
urllib3>=2.8.0,<3
+210 -2
View File
@@ -1,2 +1,210 @@
requests>=2.34.2,<3
beautifulsoup4>=4.15.0,<5
#
# This file is autogenerated by pip-compile with Python 3.14
# by the following command:
#
# pip-compile --allow-unsafe --generate-hashes --strip-extras requirements.in
#
beautifulsoup4==4.15.0 \
--hash=sha256:288e3ca7d54b06f2ac191970bc275c1939cb46d450b255bf6718b04aa37ab4f7 \
--hash=sha256:d6f88de62e1d4e38ecb1077eb9724cd0eff29d2a08ca16a401e9b9e93f117cf9
# via -r requirements.in
certifi==2026.10.23 \
--hash=sha256:a9895e6e2758b371e0545e321a3a8fd1fcfd9829ada8824a936dfb16aaaf36cd \
--hash=sha256:e9b54de76e530bb6cf0ccd036787103acb58fd42ba930ea8bf948ddbaa2f61d1
# via requests
charset-normalizer==3.5.2 \
--hash=sha256:01077390b03f7988f11d700a2194e69b119741a86b1a638b1db88891e3eced8e \
--hash=sha256:01b0c0d2262a9e28e8484a278c7e1b5d650e3ac8cf2683d2967e25899f208bdf \
--hash=sha256:04851f73ae72b8413dddadb16a49dfee95263553741fd42d546f7d66907e6be5 \
--hash=sha256:0521c5665880b33d603717defa76c094048900010897909952397feb3039da56 \
--hash=sha256:0774bf9bf620249fee3e0b8b9fd3065de213be30f3aa94ce2494b3b638949e26 \
--hash=sha256:0891b9d3903c5571c03771ca669a4b0ec5618ca722a5c957d3d29cd4e5062848 \
--hash=sha256:0c951d5e6dd9c2ff60609476752bee49da4206adde960ebc247766937f72e718 \
--hash=sha256:0fed1d06615f022ee3b13caf5e8b180cfea32bb2c5aded8a9d44277afc040f93 \
--hash=sha256:114e4d0c92d618409ed82a99e22b5c5e768fe995f2973f78265f4524f49d4640 \
--hash=sha256:11912e4bb14baae7c5d8791aa55ba0a3a03ec6729073307b0f57270abaa713d3 \
--hash=sha256:11a4d68a6ecda3292cb1e50239e111543ba5d709bb62a6b4ea1afcfa729d8875 \
--hash=sha256:124fbf1a8ff966d87ae05bb8bd45a71f966055ed8bba320d0c7cf450bc5f4d0e \
--hash=sha256:1461ac396c4fdb983a675f20aa555624f0ee18ac83d832b9244ffff3d8055275 \
--hash=sha256:1503bccbeb36d5527790c3930327704c39af22de3112f1b1666a9f3ce15ee204 \
--hash=sha256:15bb4005af6320d259dc7593ca84a38d7fe06a421dbcf7b910ae23979101e787 \
--hash=sha256:15c44f7edfd477b06f517a5cc317fc1707edb9de2c865f43d4b6513907473234 \
--hash=sha256:16fa0eccf81304b79c5cd87f9271c3b85dd9dd99245e4422ae9c0dd45e0f99d3 \
--hash=sha256:183b88127acdb4fabe59d951ab424faf1af7b63cdbb5f776186c1ea2ffcaed98 \
--hash=sha256:195c26fb65950f8fce54e26349852b7bdd7c5f120aeefbcc440b8a20faaed4a3 \
--hash=sha256:1afb975bd5d68d5ce9f6b6d44fdf2f7e34b895a35e95708a7a91b20a3b51d187 \
--hash=sha256:1b4cbc7c3491ccb4aa17fcd8165649d01cf39f76de1696da8631b5f71b85401d \
--hash=sha256:1bc0baf5ef96b6ede57d47f4b8fe4d9d84019c3bfcbeb20a41edc6a6ee341f1f \
--hash=sha256:1c50fe28bbc2ced33386f298650d91218076c05420e6cbd790b913adc41659e7 \
--hash=sha256:1db38f4c5496827c1a501846d64d14c3b80c7e6714e406cd7dc36a9899fa1011 \
--hash=sha256:211d5a3eb6af8f513b8d4ca19a8c1b7accab1b5f0d3175f9826b03c1a920dc1f \
--hash=sha256:23851fb4e1b85ed3f6c2a27b777cdfe2e19fb5b38429a8faf38c7542b7665869 \
--hash=sha256:254eb48b9fa5ee9898a3c445825a1f340fe53712a098904b39b0bddba8ea3cb1 \
--hash=sha256:2625388c6c754520c37abaf3b41eb34d1cc4a373f457898f08606c8e362b891d \
--hash=sha256:281cb91036248400f4cc957495cccd44c275c2e0c5854f7e45ac5cf7dc193847 \
--hash=sha256:28a15fdad492a99b6eccfaaed66ef3f74050680545ea61ec8b2f4c538f1f1320 \
--hash=sha256:28b4f0d66fb834ff90f28209ac7bce77868c45d8c93e26f906709d9b7c2e1af9 \
--hash=sha256:2a925889534b3748302dae5dead07cc13480de1dac3aea80a941b729b471ef93 \
--hash=sha256:2b7b3bbfb4fe8ef40600792d762fbaa9057559f9d3fad209525b7a22b99e91fd \
--hash=sha256:2c9ad19a6cfcd5ea5c0d41161d22f9df1dcc277e9bef2751391334546a314c00 \
--hash=sha256:2cc961b171b3f3440f410489ab3573e86aea8736134ebbb40ea1338b7f0831bc \
--hash=sha256:2ce45c6627b22c47e390bc91a41c3d13032192e699fa0bea96e9671b373d69b0 \
--hash=sha256:2e06a3a98f916dd41d27f3105e02e7a40181c98c94b9158733d03a6f80506c09 \
--hash=sha256:304d5463e65a35d7bb0850550e0780395395f6fcf452f04db7d5ca7cecc425ac \
--hash=sha256:304d8e4d493af723536393eee0c689eb7813f4a474c8b479dee63f1fdd98f621 \
--hash=sha256:30fcd120b732aa79317f08dee04d7de0847822e4cf7ee0e9f445bb958832252c \
--hash=sha256:31f3930700408d211f13378ccbe1c40845d8da54bd0681fac3a9b5aae81c7aa8 \
--hash=sha256:34276fd796040bf0993ab33a369aa572e6979c7aab225a88893667ad8eac8f7a \
--hash=sha256:355ad8011081dec5412240c087a9a0c9d4d5039f3ed11a3f13e18c2b29b56c51 \
--hash=sha256:38a873987f3be698494da8b2e3085e29da02da7b633dce73e79c699a113d7bf0 \
--hash=sha256:39de2a259fc954455c57274dc94c79d5842774e1247a016aff30bc0efed0f4ef \
--hash=sha256:3d14b50de6bf4d0edf857a9386836846f982b8f524e188e2e68b96d702bcf4aa \
--hash=sha256:3d21b8b13c7592db2ac5e544a6d83187b995257472b0c9e8351b6d507ae37ed6 \
--hash=sha256:3d31298449090ab8d47b7b1b2a555ff73cac7ed438a08b7ac160980c7ebed649 \
--hash=sha256:3ddacd27458c45bdacd6bd6db644bfb730efbf9e830310186e3045c9c5be8fb2 \
--hash=sha256:3df041de8887954562c9b261cba85ca0e9ded74048daf125f45edcfaa4832229 \
--hash=sha256:40ab6bffa02ae10a0581e6c198be7d2d8ca5c2a0c64e4ed3465d766df457573e \
--hash=sha256:4275811936e2f06feff5e598fb42a1b7ae852da8e39605211892b56b81a34efd \
--hash=sha256:443eae2bf318abeaf6f15d785138f71fd6de770e99a92158b8b814265e079115 \
--hash=sha256:447441e76ec720b15e64418d32e092297340387053047c7c694f579efb0ee1d9 \
--hash=sha256:4495c5002a7b28557e7e222e77e0b661183e432b7d6d2e788101e3f240e05b8c \
--hash=sha256:44bd4fbb29dfbeba60e7d2bd000c59e4b21ddb3cc53912b14048d37092706d7c \
--hash=sha256:4685902cf26edf013ed7a3da0f426ebba7a00ebb9541386d835afbf002c11cab \
--hash=sha256:498dc3188ca05a68231ac3fdbfc7f57eb67e1343c30e0fea17f8218c1599b253 \
--hash=sha256:4c2b5031f63e331e3839b40aed2dd6f191e9c07edbde303e7876846ea1946995 \
--hash=sha256:4d48f2d08b9de5864e2c8744d4461b862fb149a18274abc8b698c45975573438 \
--hash=sha256:4f87960d57feabfb618e4e0af6e7371645fa26a277860739d6e5d6e0012c92f0 \
--hash=sha256:50e3adfb96fc189eb27b1cf62d3b598b89b4bb0420d93a3d3e42e137409011be \
--hash=sha256:51cf45226a9b588d0d2b4880c62d686934b63ab0bd79ca23ab0e9762eb27441b \
--hash=sha256:52aa6992700996af31f375de0c6bacd402b0097fe40b53c426b9f51a90ebabc7 \
--hash=sha256:55ea99acb17b9325618de155a0cd6a2e8f5d10be008113e1d433bbb58db543b2 \
--hash=sha256:56bc200a365efb37383b7852e4cc5898d3b2da5987289b543956cf8cad71018a \
--hash=sha256:588461c2e8384d309bd63e5826019b6977bc66d629b99ac8737bb795d7b2cb5a \
--hash=sha256:58ca3755ee7ff7f59b57789ec9833c9de9ea275405cdd240eda1f193112e398a \
--hash=sha256:58f361dcbab699cf8f42db3f47c8e7fd1036f138c23a5d08de9fde5f425a730c \
--hash=sha256:598a11a2c7ebaa5334bf698bf29568c9c390abac6a154d8170fedecd1cea38c5 \
--hash=sha256:59f63901b0031c3136cf64704dcb21de0bbae62ce2c9529bc39d27665463de37 \
--hash=sha256:5cde776b7cc66e4f6c99612cea4aa7269aa65863f7a15841b2c264f103822f4e \
--hash=sha256:5e2b6b57e9733d39f0c9fd3185efa6b8e29652c4cd8fe94180272cf6ed9a78c4 \
--hash=sha256:5fb29fb8cd1a46c27a1bf9613ad5ec2599310d46b4025d9556404a6b6a292800 \
--hash=sha256:6045373d5a89a5ec71afde535db987ca28e76dfa276c2d4c818265b375d4b055 \
--hash=sha256:619799369eeef6366ed3e8755a5670f4f2f0fb6b30a0fd7264dc0fdc2357058e \
--hash=sha256:62588a277bfb59def052abd940703fa35107152bf479781a878617d60faf8fb5 \
--hash=sha256:62603db9a7caa0802eaa28c1c46fecd7b3a263a774069c24c3c28c302448721c \
--hash=sha256:65cd72beeeca9d3aaea1201e5923859f308f952f9c71de93f06063c79f0f7a3b \
--hash=sha256:68eb192d85ab8e5f6ec69c2bc6ac0179fbf04a5ac1569d12fbef74883fe102d0 \
--hash=sha256:6bd128f206a7752ae1f2ab6c61bf8a24ba28913a10df8b14c2637b973ff97a80 \
--hash=sha256:6be488a102b8cf28d0391d8c4ba7748938ae28b78ad901f8585520fca33ead1a \
--hash=sha256:7218e8f32b0956cfcd048fd42d9d5779809745ca1d86113ca56f66e7ae1549c4 \
--hash=sha256:7441d755b7ab94f8d4eb3e43ec05482d760842fd263d003a99102d742cd835e2 \
--hash=sha256:749e97e1b32313717a565abbe321bc2190bc8b35f1a67e4cdbc7c56c8d8ffe58 \
--hash=sha256:75a3ceed0724d625d64b86ca20aba182e4df462e04c2414fc941c0f523f06aac \
--hash=sha256:780fbe7cab297b81dad9fb8dc5eb003c0468ffb0d9e5f65068c53a34661a96bc \
--hash=sha256:78456a747de8dc58360ffa581f30a002baf5aa28cb262536545e91f113ed7639 \
--hash=sha256:7967d08cf06dee78443b874f98c98036f624f3a4e73e11f9f64f5be4d25393cf \
--hash=sha256:7a881931aa470808df94a8c380eed2bbbc76cd9dc622310f99665658c821eb6d \
--hash=sha256:7dcd882da75ef9adf94903b1e3b9419e8aa8fb4c7396822b834b9ef7fb96954f \
--hash=sha256:7e841fb9010836c992c9f12fcbd43a831de93a5f726fc1ccd8ca1d0268c5014c \
--hash=sha256:7fdde2c9fd9e3eca40631e024664cf2584272cc8f96308cbe5fdfc930f51d8bc \
--hash=sha256:8024d00c3faf3fc0c16e07a69f4405e8eac7cc0ab15f65fe6cf43827c4cf72b4 \
--hash=sha256:80d02b6f04e92601a081dd97b23d3128033098bff5d35d392ddcc0476ea11253 \
--hash=sha256:838dcc90063569a0448120554591a1d6c4a4ffe11babf048908793154ab86ade \
--hash=sha256:849df64e889b2e17230d58410a03dba311a65b163508fd33679b2b737d4b7858 \
--hash=sha256:87475fabc8d9996fd9c27debb395e642e8c838d78a00b6e932227a0e06b81e26 \
--hash=sha256:87e50a3e7cb90af586b6c5faf23e302a970415ac73bd7bd90a515a04b427ef96 \
--hash=sha256:89b53f3cda69831909888e0494f4fa0bcd3537e3e138dabeb620bd6ad946bae8 \
--hash=sha256:8a893cc101149f80a653f82062ebc95b34525a2614382e1da5458fe7c6997249 \
--hash=sha256:8b2bfab86aa71ae13aa41a6a26aab338e0db2b8bc75434b05aea89e011ff35a4 \
--hash=sha256:8d86d6fc60743dc916eb79e2eb1ec4818e21e427731543af40a3021851174a13 \
--hash=sha256:915563965d418f986e7e145accc592eae9e1a1be3566ff98a05d7a9ec42a76e1 \
--hash=sha256:92888bb3187c5ba50500b00b3b310c9f2c651709d28036077680cb5255450a03 \
--hash=sha256:93223adc95033dd47133a46ccfc316a0139176fd79085762e27202ec56018f03 \
--hash=sha256:9373ad13ef0d2c0fb761e04e55bfdee5a08b52cef2c882c8fbe9935b1517152e \
--hash=sha256:9409a8bf35cf78353942504b24a57de3d75b708997a1e4bd8db71ac8633ce364 \
--hash=sha256:9b7f416ff0978e2f2249330527f0ad6fa02f4932e6199692d3b52da2048c19e4 \
--hash=sha256:9bde855991b7e362c146535e3136a50bfaffc0487d38b33ca7e5edefc6e23849 \
--hash=sha256:9cae88599c7219005d879f98e5ed53341e9a122af585e1091200358a3003d2a0 \
--hash=sha256:9cf9b1a857e25c4baceeb3624e92a56df3668f398c4acba74e174d81fb4d1d3a \
--hash=sha256:9f56f72050826f63dcee7a7f55b0a77168cb3bfc553fd405e7f8f9ece75a4036 \
--hash=sha256:a090bb2c68df85450502e3e20d665e3a5af9c65a84d6508ed477badd49166fd3 \
--hash=sha256:a192e2c40070d92c3ccf777e3a5c4ff515573cd2bb7ed0c537fdadbbec5bbf21 \
--hash=sha256:a19a731138fc27d5682277d3b9df22855cea1239bce7fcec5f78f42ef2d1f3c3 \
--hash=sha256:a66c3bc5ab1f0ff2164fc9965ddd611ff0802173f4b9d24554c563f6ab7e1d6e \
--hash=sha256:a815775b6c38d4e0ff7bcffbeba67feded90202bb6a226b8dd35f1c855217413 \
--hash=sha256:a89012d6d5476ee112d20d998570ed58df2260a852afb1758809cd6900411d21 \
--hash=sha256:ae4f5fea5b8b8ccff88238cc8569303e5ee95efae67fa62922a311397a71f346 \
--hash=sha256:b6856554c4f44d79fc2307d5768854310a8f0096e501c75637542c82292b0429 \
--hash=sha256:b6b751274acb69d77b3323d6b7dbaa3c7fdfc1eb829b7eb61d262f32e1af9685 \
--hash=sha256:b736353c0a625bbd5fcec108576e2385db3496f4f771f785ff32e108d3c3bc45 \
--hash=sha256:b7fd005a73d9e657273b7a10dc71a9e03c8fb9ee6999798d6918ce095b81ac7f \
--hash=sha256:b91363207bd9dc966a691e959bb47f64b30f7ac4b072be9968b366982f7db77c \
--hash=sha256:ba0b1d2620edf869789c3879223f52bf2afc5d31b3cb47cc57b3a12c05e2aa9d \
--hash=sha256:bbbfc8e28816f19d7c0f1816664980c0a9875d01b27cdf8eedddb639d9e108ad \
--hash=sha256:bd16aabe4a02a297c23417aa17ac6299dbd8c49f673bcd645b4929b11f5a4400 \
--hash=sha256:c0afc6800ba57ccc350374c5bd6150419915d95ce93cdbab2d783d75eaf30ecb \
--hash=sha256:c6708715abcf3c73b99508253e961a9967f02fe536532834149574eda6de0d1c \
--hash=sha256:c7c9ab723cde841fefb34efbad91e87f00a674b1fe1cd0784fde742bf2c154dc \
--hash=sha256:c8f3d67aeaf55f017982b73683f0e7342ba2f6635a78f69ce89ebb26aa411e5c \
--hash=sha256:c9790464842f85f437dbbb54417eda1e0e6bfc52dd8d22d6fd1c994b73b2dc74 \
--hash=sha256:ca403d7e4798f525fdfc78e258820419cbbd0f0ecbab9de7840e3c017cf6b8cf \
--hash=sha256:d008d90a7f2471519aef0c90dfbe73b3e6e4d5e66ac48e19154c17e89e98b604 \
--hash=sha256:d19fbd981a488e22cd04883659ca6b08f50b5974f9fd7c95655ef6a043e5893f \
--hash=sha256:d1befeed746d247c81127bb14de9dc3d30edb6e5976d34f83f86ed262b1d9105 \
--hash=sha256:d2374b62878abb00cd8309b32af6c0b715cd02dec0ca74ef12e5069bdc64144a \
--hash=sha256:d376bbd28b3a8999db1a103b3b388aee6f1ddeb3e51bc2172993efdcd86e064d \
--hash=sha256:d4a7319f304a774bed22115bc891618e45f85065ab44ea6acd07d274e750519a \
--hash=sha256:d6734d2ef8a50fbf8445c139477da401f50d62a0606bf00e20ec6d87773fefb1 \
--hash=sha256:d760fe2a4d7c3b226cb9026d6a842868d52a7901bd98420e1baf14e80da85cf5 \
--hash=sha256:d913de495d90407cd859d263bee2e5d1a4ed3eb6573c04e70d9ec619a7cbed7f \
--hash=sha256:db19d07e2e0129e974a0e65d0064fc222a446cd5122c2fd4184d2af9fc734a9e \
--hash=sha256:dca9ab98072a5a54ebacebdc45f53e645336b320c667410b061be1ca588ae709 \
--hash=sha256:ddc7dacc8ece3a182e7f15cb862d1fd616b46d076cb1ae9dd232b2c38b655874 \
--hash=sha256:ddf19c062bea7a0cc80f519243d2c01dd091be0cf952a0750d4ad576709559f5 \
--hash=sha256:def79fa35ef0cef8d2accec024f4fdc7ead3012ff02f5215c783f39f03ef8cfc \
--hash=sha256:df29a0a7107f7011e77f4eebdddec4c7331e24d787a0b21a46d63bdf7445da95 \
--hash=sha256:e09a3942ecbdee5cce73ea9d42da82b81b72ac1bf031ce069b93b5adf4eac8cd \
--hash=sha256:e242bb1c5e76e97dfa9e7f209a71e93a01d7f19ffdd5cfbb2e2d55b4f08f8ab0 \
--hash=sha256:e243bd13217235fc7290c621941c3f5cc8b66e4872495be821d7436ba2fb838d \
--hash=sha256:e2af3aad578aa6bd1384bcf4750fc285e5a9de53f40b7d41e5a0bf748edeb2b3 \
--hash=sha256:e4e81e09c1578b8df602e3db08b0b3ea0a6947ad612f52bf8dc5ea8d47691f0c \
--hash=sha256:e54da4baf05720032d527874d40b65fa4d7e5c6c6a43d0c3adbeffcaf275a2b3 \
--hash=sha256:e80e6c2f55656b4824d72065abb4ddd6a525c74bd78a0aab5d9fc2cf4fb5af50 \
--hash=sha256:ed2a239c0ea213acc1908150a3037257083c7c083128f1a4cec2ec4b97dca491 \
--hash=sha256:ed905975ab14056a2e5eb1c376cb2e1ebc5396baf84163939c518556fccde9f5 \
--hash=sha256:ee21e28f0430bd6dc9086c6e525d5e818a44a5ad19720c8a0ef766792f3eb5e5 \
--hash=sha256:ee43c17b173d46a3212baa6ead3ae258eeabdae48c263a01ccf0218c366dd655 \
--hash=sha256:ef4fcbf3327382cd4c9f540babd61248208af7b93eec4de397b4d5f58a09e288 \
--hash=sha256:eff0ac9dbe711a4aee69bf04a83896aa9b85f19641264053a9f6d48573abb7dd \
--hash=sha256:f0aa869112ef88429ae17820d99c3dd9504c9e9c671d3c246f3d7442cb051084 \
--hash=sha256:f3c96f633825733f735c5a9cf21d21a257d8e1edf0b1cee0a064b9c424ca0f7d \
--hash=sha256:f5833ad231be5eb6553de524a70f48d71b2c8563101750531e0b80184e175cd4 \
--hash=sha256:f5ec61164adcec446f8969a3358ec3f9b26bbda3b9213e5586d219afa8df2915 \
--hash=sha256:f7d486c83842422badd511868fd8a9a20e9407ace71564b6af47ce7e60a336c1 \
--hash=sha256:fb9e68df06293761f9fe66ade60a9bc6d0f5e42b8acf2939a9158af86ab0e5bd \
--hash=sha256:fc14a032f813bf5fe624d991960ea83e9715adc27e4c1830a2361eb1d02ac341 \
--hash=sha256:fcff63213e8e6e47770541a4607175404f47cbb3ebea7b6058cc82d524a0e424 \
--hash=sha256:fd1fbe0f116b6e55da77aca2c6ddcddcfac2186cbf78bdebf40fc156efca389d \
--hash=sha256:fe9753dfee015c570d73df76f899f18444d41388bffcde097deba51c4fadbb9f
# via requests
idna==3.20 \
--hash=sha256:a7db850025b95ded1eae8a46181a1a6c56c92c96f0e2b005d9ff8dc0210cab44 \
--hash=sha256:ab7ae7122974553370f0bdb919e1a960b2cd1bc1ef0276416d896db81c14582c
# via requests
requests==2.34.2 \
--hash=sha256:2a0d60c172f83ac6ab31e4554906c0f3b3588d37b5cb939b1c061f4907e278e0 \
--hash=sha256:f288924cae4e29463698d6d60bc6a4da69c89185ad1e0bcc4104f584e960b9ed
# via -r requirements.in
soupsieve==4.1 \
--hash=sha256:ca9abf7126667010d8f6e9b39bfc1bc3b23c8aed9bcb0f54a754dde969bb8aab \
--hash=sha256:e4d667b3974ce6e038e7390486b8093369854a1d345ffdd4c121dfc4a782e809
# via beautifulsoup4
typing-extensions==4.16.0 \
--hash=sha256:481caa481374e813c1b176ada14e97f1f67a4539ce9cfeb3f350d78d6370c2e8 \
--hash=sha256:dc983d19a509c94dba722ee6abd33940f7c05a89e243c47e907eb4db6f1a43e5
# via beautifulsoup4
urllib3==2.8.0 \
--hash=sha256:0cf3cae568d36aa9576b28dfb35f11328f1cb974ca7647d9475ebb86c75ac6e3 \
--hash=sha256:63bf2ead4c879426ebf22ef2a781eeb4aa3b4ae798a0435506f8687fd5bb9b63
# via
# -r requirements.in
# requests
+37
View File
@@ -12,6 +12,9 @@ always works on the latest data. Idempotent: applying the same patch twice
- *_state: merged into scripts/state/*.json (null drops an entry); for
refresh_state the newer `checked` wins and the newest `full`
stamp from either side is kept
- ingest_outcomes: merged into scripts/state/ingest_outcomes.json (the newer
`at` wins; entries more than 90 days older than the newest one,
and all but the newest 5,000, are dropped)
- unlog / unblock_remove: an unblocked (restored) game that was re-added
leaves the deleted log and scripts/state/unblocked.json; one whose
ingest ended otherwise leaves only the allow-list
@@ -32,6 +35,7 @@ Usage: python scripts/apply_patch.py PATCH.json
import math
import os
import sys
from datetime import datetime, timedelta
sys.path.insert(0, os.path.dirname(__file__))
from canonical import canonicalize
@@ -46,9 +50,12 @@ DELETED_LOG = "scripts/deleted_games.json"
TEMP_LINK = "scripts/temp_link.json"
REFRESH_STATE = "scripts/state/refresh_state.json"
INGEST_STATE = "scripts/state/ingest_state.json"
INGEST_OUTCOMES = "scripts/state/ingest_outcomes.json"
UNBLOCKED = "scripts/state/unblocked.json"
MASS_REMOVAL_FLOOR = 25
MASS_REMOVAL_SHARE = 0.05
OUTCOMES_DAYS = 90
OUTCOMES_KEEP = 5000
def mass_removal_limit(patch: dict, total: int) -> int:
@@ -59,6 +66,31 @@ def mass_removal_limit(patch: dict, total: int) -> int:
return limit
def merge_outcomes(current: dict, delta: dict) -> dict:
"""ingest_outcomes.json after a patch: per URL the newer `at` wins.
Pruned relative to the newest entry, not the clock, so applying the same
patch twice gives the same file.
"""
merged = {
url: e for url, e in current.items() if isinstance(e, dict) and isinstance(e.get("at"), str)
}
for url, entry in delta.items():
if not isinstance(entry, dict) or not isinstance(entry.get("at"), str):
continue
old = merged.get(url)
if old is None or entry["at"] >= old["at"]:
merged[url] = entry
if not merged:
return {}
newest = datetime.fromisoformat(max(e["at"] for e in merged.values()).replace("Z", "+00:00"))
cutoff = (newest - timedelta(days=OUTCOMES_DAYS)).strftime("%Y-%m-%dT%H:%M:%SZ")
recent = sorted(
((e["at"], url) for url, e in merged.items() if e["at"] >= cutoff), reverse=True
)[:OUTCOMES_KEEP]
return {url: merged[url] for _, url in recent}
def _queue_key(url: str) -> str:
return canonicalize(url) or url
@@ -161,6 +193,11 @@ def apply(patch: dict) -> dict:
state = {u: e for u, e in state.items() if u in live_urls}
save_state_map(path, state)
outcomes = patch.get("ingest_outcomes", {})
if outcomes:
current = load_json(INGEST_OUTCOMES, default={})
save_state_map(INGEST_OUTCOMES, merge_outcomes(current, outcomes))
unlog = {u for u in patch.get("unlog", []) if isinstance(u, str)}
finished = unlog | {u for u in patch.get("unblock_remove", []) if isinstance(u, str)}
if unlog:
+1 -1
View File
@@ -1,7 +1,7 @@
"""
canonical.py — One canonical form for itch.io game URLs.
Every ingest channel (extension, admin, Suggest form, RSS, workflow input) and
Every ingest channel (admin, Suggest form, RSS, collections, workflow input) and
the pipeline itself compare URLs through canonicalize(), so the same game can
never be queued twice under two spellings. The Worker ports this function; both
implementations are tested against tests/fixtures/url_vectors.json.
+462
View File
@@ -664,5 +664,467 @@
"name": "SWALLOWED",
"reason": "Game page no longer exists (HTTP 404)",
"deleted_at": "2026-10-09T03:01:17Z"
},
{
"url": "https://v0id2.itch.io/burrow",
"name": "Burrow",
"reason": "Game page no longer exists (HTTP 404)",
"deleted_at": "2026-10-11T03:02:17Z"
},
{
"url": "https://wolf-hal.itch.io/sprunki",
"name": "Sprunki",
"reason": "Game page no longer exists (HTTP 404)",
"deleted_at": "2026-10-11T03:02:19Z"
},
{
"url": "https://sekarsarasu1981.itch.io/my-raising-diary",
"name": "My Raising Diary",
"reason": "Game page no longer exists (HTTP 404)",
"deleted_at": "2026-10-11T03:02:23Z"
},
{
"url": "https://sreejithnm78.itch.io/unquiet-grey",
"name": "Unquiet Grey",
"reason": "Game page no longer exists (HTTP 404)",
"deleted_at": "2026-10-11T03:02:27Z"
},
{
"url": "https://elinzeiart-z.itch.io/salvation-of-the-righteous",
"name": "Salvation of the Righteous",
"reason": "Game page no longer exists (HTTP 404)",
"deleted_at": "2026-10-11T03:02:31Z"
},
{
"url": "https://esgeetha5.itch.io/enter-furry-world",
"name": "Enter Furry World",
"reason": "Game page no longer exists (HTTP 404)",
"deleted_at": "2026-10-11T03:02:34Z"
},
{
"url": "https://kanagarajv021.itch.io/endless-labyrinth-of-night-roads",
"name": "Endless Labyrinth of Night Roads",
"reason": "Game page no longer exists (HTTP 404)",
"deleted_at": "2026-10-11T03:02:38Z"
},
{
"url": "https://coren-baili.itch.io/six-rules-the-visual-novel",
"name": "Six Rules: The Visual Novel",
"reason": "Game page no longer exists (HTTP 404)",
"deleted_at": "2026-10-11T03:02:40Z"
},
{
"url": "https://everium.itch.io/underthethorns",
"name": "Under the Thorns",
"reason": "Game page is password-protected",
"deleted_at": "2026-10-12T03:08:14Z"
},
{
"url": "https://ronhelleredfn-boop.itch.io/bb-blackwood",
"name": "B&B Blackwood",
"reason": "Game page no longer exists (HTTP 404)",
"deleted_at": "2026-10-12T03:08:17Z"
},
{
"url": "https://toro-comicss.itch.io/emergency-monster-team-chapter-0",
"name": "EMERGENCY! Monster Team Chapter 0",
"reason": "Game page no longer exists (HTTP 404)",
"deleted_at": "2026-10-12T03:08:20Z"
},
{
"url": "https://life-crises.itch.io/your-redacted-boyfriend",
"name": "your [REDACTED] boyfriend",
"reason": "Game page no longer exists (HTTP 404)",
"deleted_at": "2026-10-12T03:08:22Z"
},
{
"url": "https://antoine-aubin.itch.io/a-wave-that-i-a-furry-visual-novel",
"name": "A wave that I . . . ( A furry visual novel)",
"reason": "Game page no longer exists (HTTP 404)",
"deleted_at": "2026-10-12T03:08:25Z"
},
{
"url": "https://imrank-seo.itch.io/stranded-with-you",
"name": "Stranded with You",
"reason": "Game page no longer exists (HTTP 404)",
"deleted_at": "2026-10-12T03:08:28Z"
},
{
"url": "https://akaerocore.itch.io/raising-a-happy-neet",
"name": "Raising a Happy NEET",
"reason": "Game page no longer exists (HTTP 404)",
"deleted_at": "2026-10-12T03:08:31Z"
},
{
"url": "https://chandhira2604.itch.io/sun-stars",
"name": "Sun & Stars",
"reason": "Game page no longer exists (HTTP 404)",
"deleted_at": "2026-10-18T02:53:39Z"
},
{
"url": "https://ronnafemto.itch.io/recipe-frenzy",
"name": "Recipe Frenzy",
"reason": "Game became paid",
"deleted_at": "2026-10-18T02:53:43Z"
},
{
"url": "https://bluedragondreaming.itch.io/elemental-harmony",
"name": "Elemental Harmony",
"reason": "Game became paid",
"deleted_at": "2026-10-19T02:57:14Z"
},
{
"url": "https://writer31.itch.io/say-youll-forgive-me",
"name": "Say You'll Forgive Me",
"reason": "Game page no longer exists (HTTP 404)",
"deleted_at": "2026-10-19T02:57:18Z"
},
{
"url": "https://lguidolin.itch.io/one-more-saturday",
"name": "One More Saturday",
"reason": "Game became paid",
"deleted_at": "2026-10-19T02:57:22Z"
},
{
"url": "https://meta-and-flash.itch.io/flash-taggers",
"name": "🪵Twig Tagg🪵",
"reason": "Game page no longer exists (HTTP 404)",
"deleted_at": "2026-10-20T02:55:15Z"
},
{
"url": "https://baldigaming99.itch.io/geometry-dash-220922091-apkandpc",
"name": "Geometry Dash 2.209/2.2091 (APK and PC).",
"reason": "Game page no longer exists (HTTP 404)",
"deleted_at": "2026-10-21T02:55:57Z"
},
{
"url": "https://teo-tormo.itch.io/sf2cengcd",
"name": "Street Fighter II Champion Edition for Neo Geo CD",
"reason": "Game page no longer exists (HTTP 404)",
"deleted_at": "2026-10-22T02:56:06Z"
},
{
"url": "https://twindark.itch.io/godseater",
"name": "GodsEater",
"reason": "Game became paid",
"deleted_at": "2026-10-22T02:56:10Z"
},
{
"url": "https://m0dgames.itch.io/granny-remake-free-pc-android",
"name": "Granny Remake Free",
"reason": "Game page no longer exists (HTTP 404)",
"deleted_at": "2026-10-24T02:54:26Z"
},
{
"url": "https://ethane1.itch.io/home-watcher",
"name": "Home Watcher",
"reason": "Game became paid",
"deleted_at": "2026-10-24T02:54:30Z"
},
{
"url": "https://ethane1.itch.io/warehouse",
"name": "Warehouse Shift",
"reason": "Game became paid",
"deleted_at": "2026-10-24T02:54:33Z"
},
{
"url": "https://zackabrah.itch.io/seedfolk",
"name": "Seedfolk",
"reason": "Game page no longer exists (HTTP 404)",
"deleted_at": "2026-10-24T02:54:37Z"
},
{
"url": "https://2tonmucho.itch.io/suburb2065",
"name": "Suburb2065-PC/Japanese-",
"reason": "Game page no longer exists (HTTP 404)",
"deleted_at": "2026-10-24T02:54:40Z"
},
{
"url": "https://tattershallstudios.itch.io/gravewell",
"name": "Gravewell",
"reason": "Game became paid",
"deleted_at": "2026-10-24T02:54:43Z"
},
{
"url": "https://oppai-games.itch.io/quickie-fantasy-adventure",
"name": "Quickie: Fantasy Adventure",
"reason": "Game page no longer exists (HTTP 404)",
"deleted_at": "2026-10-24T02:54:47Z"
},
{
"url": "https://oworlon.itch.io/femboy-apocalypse",
"name": "Femboy Apocalypse",
"reason": "Game page no longer exists (HTTP 404)",
"deleted_at": "2026-10-24T02:54:51Z"
},
{
"url": "https://augustine-ina.itch.io/comfort-and-warmth",
"name": "Comfort and Warmth",
"reason": "Game page no longer exists (HTTP 404)",
"deleted_at": "2026-10-24T02:54:55Z"
},
{
"url": "https://emika-games.itch.io/absolutely-nothing-good",
"name": "ABSOLUTELY NOTHING GOOD",
"reason": "Game became paid",
"deleted_at": "2026-10-25T02:55:35Z"
},
{
"url": "https://geistworld.itch.io/lupa-rossi-redux",
"name": "Lupa Rossi Redux",
"reason": "Game page is password-protected",
"deleted_at": "2026-10-25T02:55:39Z"
},
{
"url": "https://stelladevt.itch.io/mascot-testimonial-css-for-itchio",
"name": "Mascot Testimonial CSS for itch.io",
"reason": "Not a game",
"deleted_at": "2026-10-28T02:41:27Z"
},
{
"url": "https://gabrielnjlc.itch.io/dont-close-your-eyes",
"name": "Don’t Close Your Eyes (DEMO)",
"reason": "Game page no longer exists (HTTP 404)",
"deleted_at": "2026-11-01T02:49:55Z"
},
{
"url": "https://digitalwaste.itch.io/moroz",
"name": "MOROZ",
"reason": "Game page no longer exists (HTTP 404)",
"deleted_at": "2026-11-01T02:49:57Z"
},
{
"url": "https://little-ones.itch.io/cozy-game-company",
"name": "Cozy Game Company",
"reason": "Game became paid",
"deleted_at": "2026-11-01T02:50:01Z"
},
{
"url": "https://arubberducky.itch.io/futanari-destroying-sex-robot",
"name": "Futanari Destroying Sex Robot",
"reason": "Game page no longer exists (HTTP 404)",
"deleted_at": "2026-11-01T02:50:04Z"
},
{
"url": "https://quiirisk.itch.io/stepmom-who-fell-on-a-hike",
"name": "Stepmom Who Fell on a Hike",
"reason": "Game page no longer exists (HTTP 404)",
"deleted_at": "2026-11-01T02:50:07Z"
},
{
"url": "https://bokendev-studio.itch.io/turbovektor",
"name": "TurboVektor",
"reason": "Game page no longer exists (HTTP 404)",
"deleted_at": "2026-11-01T02:50:10Z"
},
{
"url": "https://msky-dev.itch.io/sandtrix",
"name": "Sandtrix",
"reason": "Game became paid",
"deleted_at": "2026-11-02T02:49:51Z"
},
{
"url": "https://kikinndev.itch.io/lost-in-the-store",
"name": "Lost In The Store",
"reason": "Game page no longer exists (HTTP 404)",
"deleted_at": "2026-11-03T02:50:25Z"
},
{
"url": "https://lucius39.itch.io/happy-chicken-master",
"name": "Happy chicken master",
"reason": "Game became paid",
"deleted_at": "2026-11-03T02:50:29Z"
},
{
"url": "https://thomas-tung.itch.io/day-five-v1",
"name": "Day Five - v1",
"reason": "Game page no longer exists (HTTP 404)",
"deleted_at": "2026-11-03T02:50:32Z"
},
{
"url": "https://countlessbathory.itch.io/autumns-end",
"name": "Autumn's end (FREE UNTIL HALLOWEEN)",
"reason": "Game became paid",
"deleted_at": "2026-11-04T02:50:09Z"
},
{
"url": "https://mimu2026.itch.io/empty-box",
"name": "Empty Box-DEMO",
"reason": "Game became paid",
"deleted_at": "2026-11-04T02:50:12Z"
},
{
"url": "https://sasbyxan.itch.io/farm-factory-demo",
"name": "Farm Factory | Demo",
"reason": "Game page no longer exists (HTTP 404)",
"deleted_at": "2026-11-04T02:50:16Z"
},
{
"url": "https://raxeris.itch.io/99",
"name": "99%",
"reason": "Game became paid",
"deleted_at": "2026-11-04T02:50:18Z"
},
{
"url": "https://andrealphus.itch.io/that-time-i-got-reincarnated-as-a-barbarian",
"name": "That Time I Got Reincarnated As A Barbarian",
"reason": "Game became paid",
"deleted_at": "2026-11-04T02:50:21Z"
},
{
"url": "https://nytraam.itch.io/spooky-escape",
"name": "A Spooky Escape (CJ)",
"reason": "Game page no longer exists (HTTP 404)",
"deleted_at": "2026-11-04T02:50:24Z"
},
{
"url": "https://xeif.itch.io/kizuna-zx-spectrum",
"name": "KIZUNA - ZX Spectrum",
"reason": "Game became paid",
"deleted_at": "2026-11-04T02:50:27Z"
},
{
"url": "https://nanaroba.itch.io/the-intruder",
"name": "The Intruder (DEMO)",
"reason": "Game page no longer exists (HTTP 404)",
"deleted_at": "2026-11-05T02:50:12Z"
},
{
"url": "https://glodory-studio.itch.io/late-night",
"name": "Late Order",
"reason": "Game became paid",
"deleted_at": "2026-11-05T02:50:15Z"
},
{
"url": "https://lemos.itch.io/lure-of-the-vulpine-voice",
"name": "Lure of the Vulpine Voice",
"reason": "Game became paid",
"deleted_at": "2026-11-06T02:49:50Z"
},
{
"url": "https://star2dfd.itch.io/starlock",
"name": "StarLock v2.2.12",
"reason": "Game page no longer exists (HTTP 404)",
"deleted_at": "2026-11-07T02:49:35Z"
},
{
"url": "https://hotpink.itch.io/cryptid-park",
"name": "Cryptid Park",
"reason": "Game became paid",
"deleted_at": "2026-11-07T02:49:40Z"
},
{
"url": "https://deeddomanion.itch.io/deed-dominion",
"name": "Deed & Dominion",
"reason": "Game page is password-protected",
"deleted_at": "2026-11-08T02:50:59Z"
},
{
"url": "https://choic-e.itch.io/whyher",
"name": "I Can't Fix Her",
"reason": "Game page no longer exists (HTTP 404)",
"deleted_at": "2026-11-08T02:51:07Z"
},
{
"url": "https://zackanuar.itch.io/heir-of-the-dog",
"name": "Heir of the Dog",
"reason": "Game page no longer exists (HTTP 404)",
"deleted_at": "2026-11-08T02:51:11Z"
},
{
"url": "https://datasparrow.itch.io/shardana-hydro-trail-gp",
"name": "Shardana: Hydro Trail GP",
"reason": "Game became paid",
"deleted_at": "2026-11-09T02:49:47Z"
},
{
"url": "https://bksil.itch.io/hyperfall",
"name": "Hyperfall",
"reason": "Game page no longer exists (HTTP 404)",
"deleted_at": "2026-11-11T02:50:09Z"
},
{
"url": "https://kenmaryuji.itch.io/mineminemine",
"name": "MINE! MINE! MINE! (v1.2)",
"reason": "Game became paid",
"deleted_at": "2026-11-11T02:50:11Z"
},
{
"url": "https://wistarck.itch.io/joyandme",
"name": "Joy and me Chapter 1",
"reason": "Game page no longer exists (HTTP 404)",
"deleted_at": "2026-11-12T02:49:43Z"
},
{
"url": "https://star2dfd.itch.io/starbetablock",
"name": "StarCensor v0.1",
"reason": "Game page no longer exists (HTTP 404)",
"deleted_at": "2026-11-12T02:49:47Z"
},
{
"url": "https://pollikk-studios.itch.io/marketfield",
"name": "Marketfield",
"reason": "Game became paid",
"deleted_at": "2026-11-13T02:49:46Z"
},
{
"url": "https://red-anarhy173.itch.io/sprunki-hypershifted-peppers-take",
"name": "Sprunki Hypershifted Pepper's Take",
"reason": "Game page no longer exists (HTTP 404)",
"deleted_at": "2026-11-13T02:49:50Z"
},
{
"url": "https://funday-games.itch.io/booster-pack-heroes",
"name": "Booster Pack Heroes",
"reason": "Game became paid",
"deleted_at": "2026-11-13T02:49:54Z"
},
{
"url": "https://leonncamayo.itch.io/failrooms",
"name": "FailRooms - Demo",
"reason": "Game page no longer exists (HTTP 404)",
"deleted_at": "2026-11-13T02:49:56Z"
},
{
"url": "https://joerenwick.itch.io/girl-scarecrow",
"name": "Girl & Scarecrow DEMO",
"reason": "Game became paid",
"deleted_at": "2026-11-13T02:50:00Z"
},
{
"url": "https://vempyy.itch.io/jungle-tag",
"name": "Jungle tag V99",
"reason": "Game page no longer exists (HTTP 404)",
"deleted_at": "2026-11-13T02:50:03Z"
},
{
"url": "https://alfri00.itch.io/ballrollterror",
"name": "BallRollTerror",
"reason": "Game page no longer exists (HTTP 404)",
"deleted_at": "2026-11-13T02:50:07Z"
},
{
"url": "https://zapakitul.itch.io/night-cart-the-immortal-plague",
"name": "Night Cart: The Immortal Plague",
"reason": "Game became paid",
"deleted_at": "2026-11-14T02:49:35Z"
},
{
"url": "https://turtlevaniagames.itch.io/penguin-planet",
"name": "Penguin Planet",
"reason": "Game page no longer exists (HTTP 404)",
"deleted_at": "2026-11-14T02:49:39Z"
},
{
"url": "https://shibaki-dev.itch.io/ninefold",
"name": "Ninefold",
"reason": "Game page no longer exists (HTTP 404)",
"deleted_at": "2026-11-14T02:49:42Z"
},
{
"url": "https://nhungtt2804.itch.io/abyssal-drift",
"name": "Abyssal drift",
"reason": "Game page no longer exists (HTTP 404)",
"deleted_at": "2026-11-14T02:49:44Z"
}
]
+6 -2
View File
@@ -3,8 +3,8 @@ patch.py — The hand-off format between pipeline scans and the commit step.
Scanners (refresh.py, update_info.py) never write the catalog directly. They
emit a patch; apply_patch.py applies it idempotently to whatever `main` looks
like at push time, so concurrent writers (other workflows, the admin Worker,
the browser extension) never overwrite each other.
like at push time, so concurrent writers (other workflows, the admin Worker
and its cron) never overwrite each other.
Patch v1:
{
@@ -16,6 +16,8 @@ Patch v1:
"removals": [{"url", "name", "reason", "deleted_at"}],
"refresh_state": {"<url>": {...} | null}, # null = drop entry
"ingest_state": {"<url>": {...} | null},
"ingest_outcomes": {"<url>": {"outcome", "at"}}, # how a queued link ended (added, paid,
# dead, private, duplicate, deleted, gave_up)
"queue_add": ["<url>", ...], # append to temp_link.json if absent
"queue_remove": ["<url>", ...], # drop from temp_link.json
"unlog": ["<url>", ...], # unblocked + re-added: drop from the
@@ -42,6 +44,7 @@ def new_patch(kind: str) -> dict:
"removals": [],
"refresh_state": {},
"ingest_state": {},
"ingest_outcomes": {},
"queue_add": [],
"queue_remove": [],
"unlog": [],
@@ -71,6 +74,7 @@ def is_empty(patch: dict) -> bool:
"removals",
"refresh_state",
"ingest_state",
"ingest_outcomes",
"queue_add",
"queue_remove",
"unlog",
+18 -4
View File
@@ -10,6 +10,7 @@ then the least recently checked — about 1/7 of the catalog by default, so
every game is re-checked weekly. From that single page it derives:
- alive: 404/410 → "dead" strike
- price: paid → "paid" strike
- access: itch.io's password form instead of the game → "private" strike
- rating, rating_count, status, ai_disclosure / ai_content / accessibility
(+ backfills release_date / thumbnail / updated_at when missing)
A game is removed only when the same strike is seen again at least
@@ -58,6 +59,7 @@ from scraper import (
find_title,
has_info_panel,
is_free_game,
is_password_protected,
now_iso,
parse_game,
parse_info_table,
@@ -80,12 +82,18 @@ MASS_FLOOR = 10
MASS_SHARE = 0.10
REASON_PAID = "Game became paid"
REASON_PRIVATE = "Game page is password-protected"
def reason_dead(code: int) -> str:
return f"Game page no longer exists (HTTP {code})"
def removal_kind(reason: str) -> str:
"""The strike kind ("dead", "paid", "private") a removal reason was written for."""
return {REASON_PAID: "paid", REASON_PRIVATE: "private"}.get(reason, "dead")
# ---------------------------------------------------------------------------
# Target selection
# ---------------------------------------------------------------------------
@@ -142,7 +150,7 @@ def select_targets(
first_urls = {g["url"] for g in first}
rest = sorted(
(g for g in games if g["url"] not in first_urls),
key=lambda g: state.get(g["url"], {}).get(stamp, ""),
key=lambda game: state.get(game["url"], {}).get(stamp, ""),
)
return (first + rest)[:budget]
@@ -227,6 +235,8 @@ def check_game(
return strike("dead", reason_dead(page.status))
soup = page.soup
if soup is not None and is_password_protected(soup):
return strike("private", REASON_PRIVATE)
if soup is None or find_title(soup) == NA:
entry["fails"] = entry.get("fails", 0) + 1
return "parse_fail", {}, None, entry
@@ -281,12 +291,15 @@ def _write_outputs(stats: dict) -> None:
("Checked", stats["checked"]),
("Fields changed (games)", stats["changed"]),
("New strikes", stats["strikes"]),
("Removed (dead / paid)", f"{stats['removed_dead']} / {stats['removed_paid']}"),
(
"Removed (dead / paid / private)",
f"{stats['removed_dead']} / {stats['removed_paid']} / {stats['removed_private']}",
),
("Removals withheld (mass-change guard)", stats["withheld"]),
("Errors / parse failures", f"{stats['errors']} / {stats['parse_fail']}"),
("HTTP 429/503", stats["http_429"]),
("Stopped", stats["stopped"] or "completed"),
("Duration", f"{stats['duration_s'] / 60:.1f} min"),
("Duration", f"{float(stats['duration_s']) / 60:.1f} min"),
]
with open(summary, "a", encoding="utf-8") as f:
f.write("### Catalog refresh\n\n| | |\n|---|---|\n")
@@ -309,7 +322,7 @@ def keep_struck(patch: dict, state: dict, removals: list[dict], stats: dict, mar
entry["full"] = removal["deleted_at"]
patch["refresh_state"][removal["url"]] = entry
stats["removed"] -= 1
stats["removed_" + ("paid" if removal["reason"] == REASON_PAID else "dead")] -= 1
stats["removed_" + removal_kind(removal["reason"])] -= 1
patch["removals"] = [r for r in patch["removals"] if r["url"] not in urls]
@@ -425,6 +438,7 @@ def main(argv: list[str] | None = None) -> int:
"removed",
"removed_dead",
"removed_paid",
"removed_private",
"errors",
"parse_fail",
"http_429",
+21 -6
View File
@@ -77,8 +77,8 @@ def create_session() -> requests.Session:
raise_on_status=False,
)
adapter = HTTPAdapter(max_retries=retry)
# Every URL we fetch is canonical https (canonical.py); no adapter for plain http.
session.mount("https://", adapter)
session.mount("http://", adapter)
return session
@@ -233,7 +233,17 @@ def find_title(soup: BeautifulSoup) -> str:
def has_info_panel(soup: BeautifulSoup) -> bool:
wrapper = soup.find("div", class_="info_panel_wrapper")
return bool(wrapper and wrapper.find("table"))
if not wrapper:
return False
return wrapper.find("table") is not None
def is_password_protected(soup: BeautifulSoup) -> bool:
"""itch.io's "A password is required to view this page" form instead of the game (HTTP 200)."""
return bool(
soup.find("div", class_="game_password_page")
or soup.find("input", attrs={"name": "game_password"})
)
# ---------------------------------------------------------------------------
@@ -362,7 +372,9 @@ def _cap(text: str) -> str:
def extract_tagline(soup: BeautifulSoup) -> str:
"""The creator's "short description or tagline" (itch.io puts it in og:description)."""
meta = soup.find("meta", property="og:description")
text = " ".join(str(meta.get("content", "")).split()) if meta else ""
if not meta:
return NA
text = " ".join(str(meta.get("content", "")).split())
return _cap(text) if text else NA
@@ -391,8 +403,10 @@ def extract_description(soup: BeautifulSoup) -> str:
# ---------------------------------------------------------------------------
def extract_thumbnail(soup: BeautifulSoup) -> str:
meta = soup.find("meta", property="og:image")
if meta and str(meta.get("content", "")).startswith("http"):
return meta["content"]
if meta:
content = str(meta.get("content", ""))
if content.startswith("http"):
return content
ss = soup.find("div", class_="screenshot_list")
if ss:
@@ -421,7 +435,8 @@ def detect_nsfw(soup: BeautifulSoup, tags, *texts: str) -> str:
return "Yes"
if any(text != NA and _NSFW_RE.search(text) for text in texts):
return "Yes"
if soup.find("div", class_=["view_game_warning", "mature_content_notice"]):
# Either notice (a class list in find() would mean the same; ".a.b" would need both).
if soup.select_one("div.view_game_warning, div.mature_content_notice"):
return "Yes"
return "No"
File diff suppressed because it is too large. Load diff
+3 -1
View File
@@ -1 +1,3 @@
{}
{
"https://ratking.itch.io/mops-and-mobs": {"attempts": 3, "gave_up": "2026-10-14T20:24:20Z", "last_attempt": "2026-10-14T20:24:20Z", "last_error": "error: HTTP 403"}
}
File diff suppressed because it is too large. Load diff
+37 -12
View File
@@ -4,9 +4,10 @@ update_info.py — Scrape queued game links into a pipeline patch.
Flow:
1. Read URLs from scripts/temp_link.json (+ INPUT_URL from workflow_dispatch)
2. Canonicalize; drop invalid URLs, duplicates, games already in the catalog
and games in scripts/deleted_games.json (the admin restores a deleted
game by removing its log entry when approving it again)
3. Fetch each page → keep only free games (with an `added_at` stamp)
and games in scripts/deleted_games.json (unless the admin restored them:
scripts/state/unblocked.json)
3. Fetch each page → keep only free games (with an `added_at` stamp); a
password-protected page ends the link like a dead one
4. Emit a patch (see patch.py). URLs that finished (added / paid / dead /
skipped) are dropped from the queue; transient failures stay queued and
are retried; a link is given up after MAX_ATTEMPTS failures at least
@@ -18,9 +19,12 @@ Flow:
(`queue_add`), so it survives a retry, a deadline or a rate-limit stop.
A second spelling of a queued game is left alone: the first copy's
outcome removes every spelling (apply_patch compares canonical forms).
5. How each link ended (added, paid, dead, private, duplicate, deleted,
gave_up) goes to `ingest_outcomes` → scripts/state/ingest_outcomes.json,
which the admin page reads to follow a batch it queued.
apply_patch.py then applies the patch to the latest `main`, so links queued
while this ran (extension, admin) are never overwritten.
while this ran (admin, cron) are never overwritten.
Usage: python scripts/update_info.py --out patch.json [--deadline-min 50]
"""
@@ -37,7 +41,7 @@ from data_store import get_all_urls, load_all_games
from json_io import load_json
from patch import new_patch, write_patch
from refresh import fetch_with_backoff
from scraper import NA, Pacer, create_session, now_iso, parse_game
from scraper import NA, Pacer, create_session, is_password_protected, now_iso, parse_game
TEMP_LINK = "scripts/temp_link.json"
DELETED_LOG = "scripts/deleted_games.json"
@@ -69,7 +73,12 @@ def failed_attempt(previous: dict, outcome: str, now: str) -> dict:
return {"attempts": previous["attempts"] + 1, "last_attempt": now, "last_error": outcome}
def main(argv: list[str] | None = None) -> int:
def record_outcome(patch: dict, url: str, outcome: str) -> None:
"""How a queued link ended, for the admin page's tracking of the batches it queued."""
patch["ingest_outcomes"][url] = {"outcome": outcome, "at": now_iso()}
def main(argv: list[str] | None = None) -> None:
ap = argparse.ArgumentParser(description="Scrape queued links into a patch.")
ap.add_argument("--out", required=True, help="patch file to write")
ap.add_argument("--deadline-min", type=float, default=50.0)
@@ -87,7 +96,18 @@ def main(argv: list[str] | None = None) -> int:
print(f"Added from workflow input: {input_url}")
stats = dict.fromkeys(
("queued", "added", "paid", "dead", "duplicate", "deleted", "invalid", "retry", "gave_up"),
(
"queued",
"added",
"paid",
"dead",
"private",
"duplicate",
"deleted",
"invalid",
"retry",
"gave_up",
),
0,
)
stats["queued"] = len(queue)
@@ -95,7 +115,7 @@ def main(argv: list[str] | None = None) -> int:
if not queue:
print("No links to process (temp_link.json empty and no INPUT_URL).")
write_patch(args.out, patch)
return 0
return
catalog_urls = get_all_urls(load_all_games())
deleted_urls = {e.get("url") for e in load_json(DELETED_LOG)}
@@ -118,11 +138,13 @@ def main(argv: list[str] | None = None) -> int:
if url in catalog_urls:
print(f"Skip duplicate: {url}")
stats["duplicate"] += 1
record_outcome(patch, url, "duplicate")
if url in unblocked:
patch["unlog"].append(url)
elif url in deleted_urls and url not in unblocked:
print(f"Skip previously deleted: {url} (restore it from the admin page)")
stats["deleted"] += 1
record_outcome(patch, url, "deleted")
else:
todo.append(url)
continue
@@ -145,8 +167,9 @@ def main(argv: list[str] | None = None) -> int:
stats["retry"] += 1
continue
outcome = ""
if page.status == 200 and page.soup is not None:
if page.status == 200 and page.soup is not None and is_password_protected(page.soup):
outcome = "private" # final: nobody can open it, so retrying won't help
elif page.status == 200 and page.soup is not None:
record = parse_game(page.soup, url)
if record["name"] == NA:
outcome = "error: no title"
@@ -168,6 +191,7 @@ def main(argv: list[str] | None = None) -> int:
patch["queue_remove"].append(url)
patch["ingest_state"][url] = {**entry, "gave_up": entry["last_attempt"]}
stats["gave_up"] += 1
record_outcome(patch, url, "gave_up")
if url in unblocked:
patch["unblock_remove"].append(url)
else:
@@ -178,6 +202,7 @@ def main(argv: list[str] | None = None) -> int:
print(f" → {outcome}")
stats[outcome] += 1
record_outcome(patch, url, outcome)
patch["queue_remove"].append(url)
patch["ingest_state"][url] = None
if url in unblocked:
@@ -186,11 +211,11 @@ def main(argv: list[str] | None = None) -> int:
write_patch(args.out, patch)
print(
f"\nDone — {stats['added']} added, {stats['paid']} paid, {stats['dead']} dead, "
f"{stats['private']} password-protected, "
f"{stats['duplicate']} duplicates, {stats['deleted']} previously deleted, "
f"{stats['invalid']} invalid, {stats['retry']} to retry, {stats['gave_up']} given up."
)
return 0
if __name__ == "__main__":
sys.exit(main())
main()
+22
View File
@@ -14,6 +14,7 @@ Checks:
- index.json agrees with the chunk files
- count_history.json: one {date, total} row per day, sorted
- deleted_games.json entries are complete; temp_link.json is a list of strings
- state/ingest_outcomes.json (when present): canonical URL → {outcome, at}
`--fix` applies safe normalizations (safe_virus / nsfw spelling) and saves.
"""
@@ -55,9 +56,27 @@ NSFW = {"Yes", "No"}
_SAFE_VIRUS_ALIASES = {"y": "Yes", "yes": "Yes", "n": "No", "no": "No", "caution": "Caution"}
_NSFW_ALIASES = {"y": "Yes", "yes": "Yes", "n": "No", "no": "No"}
_DATE_RE = re.compile(r"^\d{4}-\d{2}-\d{2}$")
_STAMP_RE = re.compile(r"^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}Z$")
INGEST_OUTCOMES_VALUES = {"added", "duplicate", "paid", "dead", "private", "deleted", "gave_up"}
DELETED_LOG = "scripts/deleted_games.json"
TEMP_LINK = "scripts/temp_link.json"
INGEST_OUTCOMES = "scripts/state/ingest_outcomes.json"
def check_outcomes(outcomes) -> list[str]:
"""scripts/state/ingest_outcomes.json: canonical URL → {outcome, at}."""
if not isinstance(outcomes, dict):
return ["ingest_outcomes.json: top level must be an object"]
errors = []
for url, entry in outcomes.items():
if not is_canonical(url):
errors.append(f"ingest_outcomes.json: {url!r} is not a canonical game URL")
elif not isinstance(entry, dict) or entry.get("outcome") not in INGEST_OUTCOMES_VALUES:
errors.append(f"ingest_outcomes.json[{url}]: unknown outcome")
elif not isinstance(entry.get("at"), str) or not _STAMP_RE.match(entry["at"]):
errors.append(f"ingest_outcomes.json[{url}]: 'at' must be YYYY-MM-DDTHH:MM:SSZ")
return errors
def check_record(game, where: str) -> tuple[list[str], list[str]]:
@@ -161,6 +180,9 @@ def validate() -> tuple[list[str], list[str]]:
if not isinstance(queue, list) or not all(isinstance(u, str) for u in queue):
errors.append("temp_link.json must be a JSON array of URL strings")
if os.path.exists(INGEST_OUTCOMES):
errors += check_outcomes(load_json(INGEST_OUTCOMES))
return errors, warnings
+45
View File
@@ -0,0 +1,45 @@
# SonarQube Cloud, CI-based analysis: .github/workflows/sonarcloud.yml
# (https://sonarcloud.io/project/overview?id=poli0981_free-games-itchio-list).
# Automatic Analysis is switched off on sonarcloud.io: the two can't run together.
# Mark a false positive on the issue itself (CLAUDE.md, gotcha 41).
sonar.organization=poli0981
sonar.projectKey=poli0981_free-games-itchio-list
sonar.projectName=free-games-itchio-list
sonar.sourceEncoding=UTF-8
# The project runs on 3.15 (.github/python-version), but SonarQube Cloud's Python
# analyzer stops at 3.14 ("No explicit support for version 3.15", then it falls
# back to 3.14). Raise this once it supports 3.15.
sonar.python.version=3.14
# The whole repository, as Automatic Analysis read it, with the tests as tests.
sonar.sources=.
# The tests (below); the binary images, which, indexed as text, only made the
# scanner warn about their encoding; and the D1 migrations, SQLite that the
# Oracle PL/SQL analyzer claims, only to warn that it has no data dictionary.
sonar.exclusions=tests/**,webapp/**/*.test.*,webapp/worker/test/**,**/*.png,**/*.ico,**/*.icns,**/*.webp,**/*.sql
sonar.tests=.
sonar.test.inclusions=tests/**,webapp/**/*.test.*,webapp/worker/test/**
# itch.io pages saved as served, for the scraper tests: their markup is
# itch.io's (tables without <th>, tabindex on divs, …), and editing it would
# make the tests check something itch.io never sends.
sonar.test.exclusions=tests/fixtures/**
# Written by the workflow's coverage job, with paths from the repository root:
# `pytest --cov --cov-report=xml` (Cobertura) and `npm run test:coverage` (lcov).
sonar.python.coverage.reportPaths=coverage.xml
sonar.javascript.lcov.reportPaths=webapp/coverage/lcov.info
# No unit tests by design — the React UI (components, routes, hooks, stores),
# the i18n message catalogs, configs, maintainer tools and the Tauri shell — so
# they don't count towards coverage (the "Sonar way" quality gate wants 80 % on
# new code). Keep this list in step with what the tests can reach.
sonar.coverage.exclusions=\
**/*.tsx,\
webapp/src/components/**,\
webapp/src/hooks/**,\
webapp/src/lib/use-*.ts,\
webapp/src/stores/**,\
webapp/src/lib/i18n/**,\
webapp/*.config.*,\
webapp/scripts/gen_assets.py,\
webapp/scripts/i18n-edit.mjs,\
webapp/src-tauri/**
+22
View File
@@ -0,0 +1,22 @@
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Secret Garden by Quiet Studio - itch.io</title>
<meta content="Secret Garden by Quiet Studio" property="og:title"/>
</head>
<body class="locale_en layout_widget responsive" data-page_name="view_game">
<div class="header_widget base_widget"><h1 class="title">itch.io</h1></div>
<div class="main"><div class="inner_column">
<div class="game_password_page page_widget base_widget" id="game_password_123456"><div class="padded"><section>
<h2>A password is required to view this page</h2>
<form action="https://quietstudio.itch.io/secret-garden/password" autocomplete="off" class="form" method="post">
<input name="csrf_token" type="hidden" value="token"/>
<div class="input_row"><label><input autocomplete="new-password" name="game_password" placeholder="Required" required="required" type="password"/></label></div>
<input name="return_to" type="hidden" value="https://quietstudio.itch.io/secret-garden"/>
<div class="buttons"><button class="button">Submit</button></div>
</form>
</section></div></div>
</div></div>
</body>
</html>
+65
View File
@@ -220,3 +220,68 @@ def test_refresh_patch_removals_are_capped_by_games_checked(repo):
patch["removals"] = patch["removals"][:12]
write_patch("patch.json", patch)
assert apply_patch.main(["patch.json"]) == 0
def _outcome(outcome, at):
return {"outcome": outcome, "at": at}
def test_ingest_outcomes_merge_newest_wins_and_reapply_is_a_noop(repo):
seed_catalog([make_game("a")])
save_json(
_state_file("ingest_outcomes"),
{
"https://dev.itch.io/a": _outcome("added", "2026-10-01T00:00:00Z"),
"https://dev.itch.io/b": _outcome("paid", "2026-10-05T00:00:00Z"),
},
)
patch = new_patch("ingest")
patch["ingest_outcomes"] = {
"https://dev.itch.io/b": _outcome("added", "2026-10-04T00:00:00Z"), # older: ignored
"https://dev.itch.io/c": _outcome("dead", "2026-10-06T00:00:00Z"),
}
write_patch("patch.json", patch)
assert apply_patch.main(["patch.json"]) == 0
expected = {
"https://dev.itch.io/a": _outcome("added", "2026-10-01T00:00:00Z"),
"https://dev.itch.io/b": _outcome("paid", "2026-10-05T00:00:00Z"),
"https://dev.itch.io/c": _outcome("dead", "2026-10-06T00:00:00Z"),
}
assert read_json(_state_file("ingest_outcomes")) == expected
before = (repo / _state_file("ingest_outcomes")).read_bytes()
assert apply_patch.main(["patch.json"]) == 0
assert (repo / _state_file("ingest_outcomes")).read_bytes() == before
def test_a_patch_with_only_outcomes_is_applied(repo):
seed_catalog([make_game("a")])
patch = new_patch("ingest")
patch["ingest_outcomes"] = {
"https://dev.itch.io/a": _outcome("duplicate", "2026-10-06T00:00:00Z")
}
write_patch("patch.json", patch)
assert apply_patch.main(["patch.json"]) == 0
assert (
read_json(_state_file("ingest_outcomes"))["https://dev.itch.io/a"]["outcome"] == "duplicate"
)
def test_ingest_outcomes_are_pruned_by_age_and_count(monkeypatch):
current = {
"https://dev.itch.io/old": _outcome("paid", "2026-06-01T00:00:00Z"), # > 90 days before
"https://dev.itch.io/kept": _outcome("added", "2026-07-10T00:00:00Z"),
"not a dict": "x",
}
delta = {"https://dev.itch.io/new": _outcome("dead", "2026-10-01T00:00:00Z")}
merged = apply_patch.merge_outcomes(current, delta)
assert set(merged) == {"https://dev.itch.io/kept", "https://dev.itch.io/new"}
monkeypatch.setattr(apply_patch, "OUTCOMES_KEEP", 2)
many = {
f"https://dev.itch.io/g{i}": _outcome("added", f"2026-10-0{i}T00:00:00Z")
for i in range(1, 5)
}
assert set(apply_patch.merge_outcomes(many, {})) == {
"https://dev.itch.io/g4",
"https://dev.itch.io/g3",
}
+15
View File
@@ -11,6 +11,7 @@ from scraper import (
detect_nsfw,
extract_description,
extract_tagline,
is_password_protected,
parse_game,
parse_retry_after,
)
@@ -115,11 +116,25 @@ def test_page_without_info_panel():
assert record["genre"] == NA and record["tags"] == []
def test_password_page_is_recognised():
assert is_password_protected(load_fixture_soup("game_password.html"))
assert not is_password_protected(load_fixture_soup("game_free_full.html"))
assert not is_password_protected(load_fixture_soup("game_no_info.html"))
def test_mature_notice_marks_nsfw():
record = parse_game(load_fixture_soup("game_nsfw_warning.html"), "https://x.itch.io/y")
assert record["nsfw"] == "Yes"
@pytest.mark.parametrize("notice", ["view_game_warning", "mature_content_notice"])
def test_either_mature_notice_alone_marks_nsfw(notice):
from bs4 import BeautifulSoup
soup = BeautifulSoup(f'<div class="{notice}"></div>', "html.parser")
assert detect_nsfw(soup, [], NA) == "Yes"
@pytest.mark.parametrize(
("tags", "description", "expected"),
[
+17
View File
@@ -83,6 +83,23 @@ def test_paid_page_strike_then_removal():
assert outcome == "removed_paid" and removal["reason"] == "Game became paid"
def test_password_protected_page_strike_then_removal():
game = make_game("a")
outcome, updates, removal, entry = refresh.check_game(
game, ok_page("game_password.html"), {"fails": 3}, NOW
)
assert outcome == "strike_private" and removal is None and not updates
assert entry["strike"] == "private" and "fails" in entry
outcome, _, removal, _ = refresh.check_game(
game, ok_page("game_password.html"), entry, TOMORROW_NOW
)
assert outcome == "removed_private"
assert removal["reason"] == "Game page is password-protected"
assert refresh.removal_kind(removal["reason"]) == "private"
assert refresh.removal_kind("Game became paid") == "paid"
assert refresh.removal_kind("Game page no longer exists (HTTP 404)") == "dead"
def test_different_strike_kind_restarts_the_count():
game = make_game("a")
entry = {"strike": "paid", "strike_at": "2026-09-10T03:00:00Z"}
+24 -4
View File
@@ -12,7 +12,7 @@ def _run(monkeypatch, pages: dict[str, Page], queue: list, **env):
monkeypatch.setattr(
update_info, "fetch_with_backoff", lambda _s, url, _p, _c: pages.get(url, Page(status=500))
)
assert update_info.main(["--out", "patch.json"]) == 0
update_info.main(["--out", "patch.json"])
return read_json("patch.json")
@@ -33,12 +33,16 @@ def test_ingest_outcomes(repo, monkeypatch):
"https://dev.itch.io/free": Page(status=200, soup=load_fixture_soup("game_free_full.html")),
"https://dev.itch.io/paid": Page(status=200, soup=load_fixture_soup("game_paid.html")),
"https://dev.itch.io/dead": Page(status=404),
"https://dev.itch.io/locked": Page(
status=200, soup=load_fixture_soup("game_password.html")
),
}
queue = [
"https://DEV.itch.io/free/", # canonicalized
"https://dev.itch.io/free", # duplicate within the queue
"https://dev.itch.io/paid",
"https://dev.itch.io/dead",
"https://dev.itch.io/locked", # password-protected: final, not retried
"https://dev.itch.io/known",
"https://dev.itch.io/removed",
"https://dev.itch.io/flaky", # 500 → retry later
@@ -54,13 +58,28 @@ def test_ingest_outcomes(repo, monkeypatch):
assert flaky["attempts"] == 1 and flaky["last_error"] == "error: HTTP 500"
stats = patch["stats"]
assert (stats["added"], stats["paid"], stats["dead"], stats["duplicate"]) == (1, 1, 1, 1)
# A password-protected page is final: dropped from the queue, no attempt kept.
assert stats["private"] == 1 and patch["ingest_state"]["https://dev.itch.io/locked"] is None
assert (stats["deleted"], stats["invalid"], stats["retry"]) == (1, 1, 1)
# How each finished link ended, for the admin's batch tracking: retries, invalid
# entries and second spellings leave no outcome.
outcomes = {url: e["outcome"] for url, e in patch["ingest_outcomes"].items()}
assert outcomes == {
"https://dev.itch.io/free": "added",
"https://dev.itch.io/paid": "paid",
"https://dev.itch.io/dead": "dead",
"https://dev.itch.io/locked": "private",
"https://dev.itch.io/known": "duplicate",
"https://dev.itch.io/removed": "deleted",
}
assert all(e["at"].endswith("Z") for e in patch["ingest_outcomes"].values())
# apply_patch compares canonical forms, so each processed link is covered once.
removed = {canonicalize(u) or u for u in patch["queue_remove"]}
assert removed == {
"https://dev.itch.io/free",
"https://dev.itch.io/paid",
"https://dev.itch.io/dead",
"https://dev.itch.io/locked",
"https://dev.itch.io/known",
"https://dev.itch.io/removed",
"not a url",
@@ -74,6 +93,7 @@ def test_gives_up_after_three_attempts_and_resets_on_requeue(repo, monkeypatch):
patch = _run(monkeypatch, {}, [url])
assert url in patch["queue_remove"]
assert patch["ingest_state"][url]["attempts"] == 3 and "gave_up" in patch["ingest_state"][url]
assert patch["ingest_outcomes"][url]["outcome"] == "gave_up"
save_json("scripts/state/ingest_state.json", {url: patch["ingest_state"][url]})
patch = _run(monkeypatch, {}, [url])
@@ -119,7 +139,7 @@ def test_duplicate_spelling_survives_a_rate_limit_stop(repo, monkeypatch):
queue = ["https://dev.itch.io/a", "https://dev.itch.io/a"]
save_json("scripts/temp_link.json", queue)
monkeypatch.setattr(update_info, "fetch_with_backoff", lambda *_a: None)
assert update_info.main(["--out", "patch.json"]) == 0
update_info.main(["--out", "patch.json"])
assert _apply(read_json("patch.json")) == queue
@@ -141,7 +161,7 @@ def test_dispatched_url_is_processed_first_and_queued_until_done(repo, monkeypat
save_json("scripts/temp_link.json", ["https://dev.itch.io/backlog"])
monkeypatch.setenv("INPUT_URL", "https://dev.itch.io/Dispatched/")
monkeypatch.setattr(update_info, "fetch_with_backoff", fetch)
assert update_info.main(["--out", "patch.json"]) == 0
update_info.main(["--out", "patch.json"])
patch = read_json("patch.json")
assert seen[0] == "https://dev.itch.io/dispatched"
assert patch["queue_add"] == ["https://dev.itch.io/dispatched"]
@@ -185,7 +205,7 @@ def test_failures_count_only_when_spaced_out(repo, monkeypatch):
"2026-09-18T14:00:00Z", # 3 -> given up
):
monkeypatch.setattr(update_info, "now_iso", lambda s=stamp: s)
assert update_info.main(["--out", "patch.json"]) == 0
update_info.main(["--out", "patch.json"])
write_patch("patch.json", read_json("patch.json"))
assert apply_patch.main(["patch.json"]) == 0
entry = read_json("scripts/state/ingest_state.json").get(url, {})
+19
View File
@@ -87,3 +87,22 @@ def test_state_map_one_line_per_url(tmp_path):
assert json.loads(path.read_text(encoding="utf-8"))["https://b.itch.io/x"]["fails"] == 1
save_state_map(str(path), {})
assert json.loads(path.read_text(encoding="utf-8")) == {}
def test_ingest_outcomes_file_is_checked_when_present(repo):
seed_catalog([make_game("a")])
good = {"https://dev.itch.io/a": {"outcome": "added", "at": "2026-10-01T00:00:00Z"}}
save_state_map("scripts/state/ingest_outcomes.json", good)
assert validate.validate() == ([], [])
save_json(
"scripts/state/ingest_outcomes.json",
{
"https://DEV.itch.io/a/": {"outcome": "added", "at": "2026-10-01T00:00:00Z"},
"https://dev.itch.io/b": {"outcome": "maybe", "at": "2026-10-01T00:00:00Z"},
"https://dev.itch.io/c": {"outcome": "paid", "at": "yesterday"},
},
)
text = "\n".join(validate.validate()[0])
assert "not a canonical game URL" in text
assert "unknown outcome" in text
assert "'at' must be" in text
+1 -1
View File
@@ -1 +1 @@
24
26
+30 -18
View File
@@ -3,12 +3,12 @@
One codebase for everything people see of the catalog:
- the website **<https://freeitchgames.win>** — read-only for everyone (no accounts, no sign-in);
- its **Cloudflare Worker** — image proxy, the public Suggest form, the browser-extension ingest API,
the admin API and the scheduled RSS discovery;
- its **Cloudflare Worker** — image proxy, the public Suggest form, the admin API and the scheduled RSS
discovery;
- the **admin** app at `/admin/` — Maintainer only, behind Cloudflare Access;
- the **desktop and Android apps** — the same public app wrapped with Tauri 2 (see [`TAURI.md`](TAURI.md)).
Stack: React 19 + TypeScript 6 + Vite 8 (Rolldown) + Tailwind CSS 4 (`@tailwindcss/vite`, tokens in
Stack: React 19 + TypeScript 7 + Vite 8 (Rolldown) + Tailwind CSS 4 (`@tailwindcss/vite`, tokens in
[`src/index.css`](src/index.css)) + shadcn/ui (Radix), TanStack Query, React Router 8, Zustand, and the
self-hosted Geist fonts. The Worker is plain TypeScript on Cloudflare Workers
(R2, D1, Images, Turnstile, Rate Limiting, Access).
@@ -28,12 +28,12 @@ key entries) and rewrites old `#/…` links to real paths ([`src/lib/legacy.ts`]
| [`vite-plugins/catalog-data.ts`](vite-plugins/catalog-data.ts) | Bundles the catalog into `dist/data/` (packs + legacy JSON) + `sitemap.xml` |
| [`public/`](public/) | Static files; [`public/_headers`](public/_headers) sets headers + CSP for them |
| [`src-tauri/`](src-tauri/) | Tauri 2 shell for the desktop and Android apps |
| [`scripts/`](scripts/) | `gen_assets.py` (PWA icons + OG image), `i18n-edit.mjs` (edit `en`/`vi` keys together) |
| [`scripts/`](scripts/) | `gen_assets.py` (PWA icons + OG image), `i18n-edit.mjs` (edit `en`/`vi` keys together), `check-tauri-versions.mjs` (`npm run check:tauri`), and the repo-level tests `check-csp-hashes.test.mjs` (inline script hashes in the CSPs) and `check-contrast.test.mjs` (WCAG contrast of the colour tokens and the chart palette) |
| [`wrangler.jsonc`](wrangler.jsonc) | Worker config: assets, bindings, vars, cron, `staging` env |
## Local dev
Requires Node.js 22.22+ (CI uses the version in [`.node-version`](.node-version)) and npm. The full
Requires Node.js 26+ (CI uses the version in [`.node-version`](.node-version)) and npm. The full
setup, including the Python pipeline, is in [`docs/dev_env.md`](../docs/dev_env.md).
```sh
@@ -73,12 +73,13 @@ Path alias `@/*` → `src/*`. Vite injects `__BUILD_DATE__` for the About page.
The same steps as [`webapp-ci.yml`](../.github/workflows/webapp-ci.yml):
```sh
npm run check:tauri # Tauri crates and their npm packages share major.minor
npm run cf:types -- --check # worker-configuration.d.ts matches wrangler.jsonc
npm run lint # ESLint
npm run knip # unused files / exports / deps
npm test # Vitest: app + Worker (D1 tests run a local workerd)
npm run build # includes tsc -b (or run npx tsc -b on its own)
npx wrangler deploy --dry-run --env=""
npm run cf:check # wrangler deploy --dry-run (deploys nothing)
```
After editing `wrangler.jsonc`, run `npm run cf:types` and commit the regenerated
@@ -95,7 +96,7 @@ local secrets can't leak into it. Secrets are typed by hand in [`worker/env.ts`]
| `/charts` | [src/routes/charts.tsx](src/routes/charts.tsx) | Charts + KPI cards across 4 tabs |
| `/removed` | [src/routes/deleted.tsx](src/routes/deleted.tsx) | Removed games, with reasons (`/deleted` redirects here) |
| `/suggest` | [src/routes/suggest.tsx](src/routes/suggest.tsx) | Suggest a game (Turnstile, goes to the review queue) |
| `/settings` | [src/routes/settings.tsx](src/routes/settings.tsx) | Theme, language, density, 18+ content opt-in (the header's display menu has the same) |
| `/settings` | [src/routes/settings.tsx](src/routes/settings.tsx) | Theme, language, density, hide scrollbars, accessibility (the "/" search shortcut), 18+ content opt-in (the header's display menu has most of them) |
| `/about` | [src/routes/about.tsx](src/routes/about.tsx) | Project info, legal links, third-party credits |
| `/errors/:code` | [src/routes/error-preview.tsx](src/routes/error-preview.tsx) | Hidden error-page preview (not in the nav) |
@@ -116,8 +117,18 @@ verification page instead of the shell on every app route (and `403` on `/img`);
Maintainer only. Cloudflare Access (the "Admin" application) guards `/admin` and `/api/admin/*`, and
the Worker re-verifies the Access JWT and the `ADMIN_EMAILS` allow-list on every request
([`worker/access.ts`](worker/access.ts), [`worker/admin.ts`](worker/admin.ts)). The app shell is only
served after that check. Pages (hash routes): **Review queue**, **Add games**, **Catalog** (edit
`safe_virus` / `notes` / `nsfw`, remove or restore a game).
served after that check. Pages (hash routes):
- **Review queue**: approve (with override for removed games) or reject, in batches of 200.
- **Add games**: paste any text or load a file, or read an itch.io collection; **Check** shows what Add
would do with each URL before anything is written; Add queues the list in batches of 200 and then
follows each game through the ingest (added / waiting / dropped and why, from
`scripts/state/ingest_outcomes.json`).
- **Catalog**: search, edit one game, or select up to 100 for a bulk edit (`nsfw` / `safe_virus` /
`notes`) or a removal with a public reason (one commit); remove by list; restore removed games.
- **New games** (added in the last 7 / 30 days, to review 18+ and virus checks in bulk), **Activity**
(the D1 audit log) and **Settings** (auto-approve rules, followed itch.io collections, the last
automatic run).
Writes go to the repo as a **GitHub App** (GraphQL `createCommitOnBranch`, so commits are
"Verified"; [`worker/github.ts`](worker/github.ts), [`worker/repo.ts`](worker/repo.ts)). Approving a
@@ -135,21 +146,22 @@ Worker. It runs for `wrangler.jsonc` `assets.run_worker_first` (`/`, `/img/*`, `
| `/img/<160\|640>/<path>` | [worker/img.ts](worker/img.ts) | Resized WebP covers, stored in R2; only thumbnails that are in the catalog (`/data/urls.json`), upstream fixed to `img.itch.zone` |
| `/api/health` | [worker/index.ts](worker/index.ts) | Health check |
| `/api/suggest` | [worker/suggest.ts](worker/suggest.ts) | Suggest form: same-origin POST, per-IP rate limit, Turnstile, canonical itch.io URL, note ≤ 500 chars |
| `/api/ingest` | [worker/ingest.ts](worker/ingest.ts) | Browser extension: Access service token, `Idempotency-Key`, rate limit per token |
| `/api/admin/*` | [worker/admin.ts](worker/admin.ts) | Admin API (queue, add, edit, remove, restore) |
| `/api/admin/*` | [worker/admin.ts](worker/admin.ts) | Admin API (queue, check, add, track, edit and remove one or up to 100 games, restore, activity, settings, itch.io collections) |
| `/admin`, `/admin/*` | [worker/admin.ts](worker/admin.ts) | Admin app shell, after the Access check |
| `/data/*.json` (not `/data/pack/`) | [worker/legacy-data.ts](worker/legacy-data.ts) | The readable catalog JSON, passed only to apps 4.0–4.1.1 (Tauri `Origin`); everyone else gets 410 + the repository links |
| anything else | [worker/spa.ts](worker/spa.ts) | App shell for routes, real 404 for missing files (a missing pack too: `no-store`) |
**Cron** (`23 */4 * * *`, [`worker/discover.ts`](worker/discover.ts)): polls **one** itch.io RSS feed
per run into the review queue, then does queue bookkeeping (queued → ingested / failed) and retention
(idempotency records after 7 days, Suggest notes after 180). Nothing enters the catalog without the
Maintainer's approval.
**Cron** (`23 */4 * * *`, [`worker/index.ts`](worker/index.ts)), four steps that fail independently:
[`discover.ts`](worker/discover.ts) polls **one** itch.io RSS feed into the review queue; queue
bookkeeping settles queued rows with the pipeline's ingest outcomes (queued → ingested / failed);
[`automation.ts`](worker/automation.ts) applies the Maintainer's automatic rules (auto-approve of
unflagged items after the waiting time, new free games of followed collections, read with
[`collections.ts`](worker/collections.ts)) in **one** commit; then retention (Suggest notes after 180
days).
**Bindings**: `ASSETS`, `THUMBS` (R2 `freeitchgames-thumbs`), `DB` (D1 `freeitchgames`),
`RL_SUGGEST` / `RL_INGEST` / `RL_GATE` (rate limits). **Vars**: `SITE_ORIGIN`, `GITHUB_REPO`, `BOT_UA`, `GH_APP_ID`,
`GH_APP_INSTALLATION_ID`, `ACCESS_TEAM_DOMAIN`, `ACCESS_AUD_ADMIN`, `ACCESS_AUD_INGEST`,
`TURNSTILE_SITEKEY`. **Secrets**: `GH_APP_PRIVATE_KEY`, `ADMIN_EMAILS`, `TURNSTILE_SECRET`
`RL_SUGGEST` / `RL_GATE` (rate limits). **Vars**: `SITE_ORIGIN`, `GITHUB_REPO`, `BOT_UA`, `GH_APP_ID`,
`GH_APP_INSTALLATION_ID`, `ACCESS_TEAM_DOMAIN`, `ACCESS_AUD_ADMIN`, `TURNSTILE_SITEKEY`. **Secrets**: `GH_APP_PRIVATE_KEY`, `ADMIN_EMAILS`, `TURNSTILE_SECRET`
(`DEV_ADMIN_EMAIL` is for local runs only). Logs: Workers Observability, 10% head sampling.
`canonical.ts` and `catalog.ts` are ports of `scripts/canonical.py` and `scripts/data_store.py` +
+141
View File
@@ -0,0 +1,141 @@
import { useState } from 'react'
import { useInfiniteQuery } from '@tanstack/react-query'
import { Badge } from '@/components/ui/badge'
import { Button } from '@/components/ui/button'
import { adminApi, shortSha, type AuditRow } from './api'
import { errorText, when } from './texts'
import { Notice, TabBar } from './ui'
const FILTERS = {
all: { label: 'All', actions: [] },
approvals: { label: 'Approvals', actions: ['approve', 'approve_override', 'auto_approve'] },
collections: { label: 'Collections', actions: ['collection_add', 'collection_watch', 'collection_unwatch', 'collection_toggle'] },
removals: { label: 'Removals', actions: ['delete'] },
edits: { label: 'Edits', actions: ['edit'] },
rejections: { label: 'Rejections', actions: ['reject'] },
other: { label: 'Restores & settings', actions: ['restore', 'settings'] },
} as const
type Filter = keyof typeof FILTERS
const ACTION: Record<string, string> = {
approve: 'approved',
approve_override: 'approved (override)',
auto_approve: 'auto-approved',
collection_add: 'added from a collection',
collection_watch: 'followed a collection',
collection_unwatch: 'stopped following',
collection_toggle: 'switched a collection',
delete: 'removed',
edit: 'edited',
reject: 'rejected',
restore: 'restored',
settings: 'changed settings',
}
/** The audit log: every admin action and automatic run, with its commit. */
export function ActivityPage({ repo }: { repo: string | null }) {
const [filter, setFilter] = useState<Filter>('all')
const log = useInfiniteQuery({
queryKey: ['activity', filter],
queryFn: ({ pageParam }) => adminApi.activity({ before: pageParam, actions: [...FILTERS[filter].actions] }),
initialPageParam: null as number | null,
getNextPageParam: (last) => last.next,
})
const rows = log.data?.pages.flatMap((p) => p.items) ?? []
return (
<section>
<h1 className="mb-3 text-lg font-semibold">Activity</h1>
<TabBar
label="Kind of action"
value={filter}
onChange={setFilter}
options={(Object.keys(FILTERS) as Filter[]).map((id) => ({ id, label: FILTERS[id].label }))}
/>
{log.error && <Notice text={errorText(log.error)} tone="error" onClose={() => void log.refetch()} />}
{log.isPending && <p className="text-sm text-muted-foreground">Loading…</p>}
{log.data && rows.length === 0 && <p className="text-sm text-muted-foreground">Nothing recorded yet.</p>}
{rows.length > 0 && (
<table className="w-full text-sm">
<thead className="border-b text-left text-xs uppercase text-muted-foreground">
<tr>
<th className="py-2 pr-3">When</th>
<th className="py-2 pr-3">Who</th>
<th className="py-2 pr-3">What</th>
<th className="py-2">Details</th>
</tr>
</thead>
<tbody>
{rows.map((r) => (
<ActivityRow key={r.id} row={r} repo={repo} />
))}
</tbody>
</table>
)}
{log.hasNextPage && (
<Button className="mt-3" variant="outline" size="sm" disabled={log.isFetchingNextPage} onClick={() => void log.fetchNextPage()}>
{log.isFetchingNextPage ? 'Loading…' : 'Load older'}
</Button>
)}
</section>
)
}
function ActivityRow({ row, repo }: { row: AuditRow; repo: string | null }) {
const targets = (row.target ?? '').split(' ').filter(Boolean)
const link = (t: string) =>
t.startsWith('https://') ? (
<a href={t} target="_blank" rel="noreferrer noopener" className="hover:underline">
{t.replace('https://', '')}
</a>
) : (
t
)
return (
<tr className="border-b align-top last:border-0">
<td className="py-2 pr-3 text-xs whitespace-nowrap text-muted-foreground tabular-nums">{when(row.at)}</td>
<td className="max-w-40 truncate py-2 pr-3 text-xs">{row.actor === 'cron' ? 'automatic' : row.actor}</td>
<td className="py-2 pr-3">
<Badge variant={row.action === 'delete' || row.action === 'reject' ? 'destructive' : 'outline'}>
{ACTION[row.action] ?? row.action}
</Badge>
</td>
<td className="py-2 text-xs">
{targets.length === 1 && <div className="truncate">{link(targets[0])}</div>}
{targets.length > 1 && (
<details>
<summary className="cursor-pointer">
{targets.length} games: {link(targets[0])} …
</summary>
<ul className="mt-1 max-h-48 overflow-y-auto">
{targets.map((t) => (
<li key={t} className="truncate">
{link(t)}
</li>
))}
</ul>
</details>
)}
{row.detail && <div className="mt-0.5 break-all text-muted-foreground">{row.detail}</div>}
{row.commit_sha && (
<div className="mt-0.5 text-muted-foreground">
commit{' '}
{repo ? (
<a
href={`https://github.com/${repo}/commit/${row.commit_sha}`}
target="_blank"
rel="noreferrer noopener"
className="font-mono hover:underline"
>
{shortSha(row.commit_sha)}
</a>
) : (
<span className="font-mono">{shortSha(row.commit_sha)}</span>
)}
</div>
)}
</td>
</tr>
)
}
+459 -64
View File
@@ -1,93 +1,488 @@
import { useState } from 'react'
import { useMutation, useQueryClient } from '@tanstack/react-query'
import { useMemo, useRef, useState, type DragEvent } from 'react'
import { useQuery, useQueryClient } from '@tanstack/react-query'
import { Button } from '@/components/ui/button'
import { adminApi, errorText, shortSha, type AddResult } from './api'
import { Notice, PUBLISH_NOTE } from './app'
import { Input } from '@/components/ui/input'
import { cn } from '@/lib/utils'
import { MAX_TRACK_URLS, MAX_URLS } from '../worker/limits'
import {
adminApi,
shortSha,
type AddResult,
type CheckResult,
type CollectionItem,
type CollectionRead,
type TrackItem,
} from './api'
import { chunk, runBatches } from './batch'
import { GROUPS, groupResults } from './check-groups'
import { confirm } from './confirm'
import { extractGameUrls } from './extract'
import { INGEST_TEXT, PUBLISH_NOTE, errorText, plural, when } from './texts'
import { summarize, useTracking, type TrackedBatch } from './tracking'
import { BatchProgress, Notice, TabBar, type NoticeState } from './ui'
const OUTCOME: Record<string, string> = {
queued: 'new',
invalid_url: 'not an itch.io game URL',
duplicate_in_request: 'listed twice',
duplicate_catalog: 'already in the catalog',
duplicate_pending: 'already in the queue',
previously_deleted: 'removed before',
rejected: 'rejected before',
const MAX_FILE_BYTES = 5 * 1024 * 1024
/** One ingest run (45 minutes at ≈ 14.5 games a minute) handles about this many games. */
const PER_INGEST_RUN = 650
type Source = 'paste' | 'collection'
interface Collected {
read: CollectionRead['collection']
free: CollectionItem[]
priced: number
pages: number
nextPage: number | null
stopped?: string
}
export function AddPage() {
const [source, setSource] = useState<Source>('paste')
const [text, setText] = useState('')
const [override, setOverride] = useState(false)
const [result, setResult] = useState<AddResult | null>(null)
const [error, setError] = useState<string | null>(null)
const [collected, setCollected] = useState<Collected | null>(null)
const [checked, setChecked] = useState<{ key: string; results: CheckResult[] } | null>(null)
const [withRemoved, setWithRemoved] = useState(false)
const [withRejected, setWithRejected] = useState(false)
const [progress, setProgress] = useState<{ label: string; done: number; total: number } | null>(null)
const [notice, setNotice] = useState<NoticeState>(null)
const client = useQueryClient()
const urls = text
.split(/\s+/)
.map((u) => u.trim())
.filter(Boolean)
const track = useTracking((s) => s.track)
const add = useMutation({
mutationFn: () => adminApi.add(urls, override),
onSuccess: (r) => {
setResult(r)
setError(null)
if (r.results.some((x) => x.approved)) setText('')
void client.invalidateQueries({ queryKey: ['queue'] })
},
onError: (e) => setError(errorText(e)),
})
const pasted = useMemo(() => extractGameUrls(text), [text])
const urls = source === 'paste' ? pasted.urls : (collected?.free.map((i) => i.url) ?? [])
const via = source === 'collection' && collected ? `collection:${collected.read.id}` : undefined
const key = `${source}\n${urls.join('\n')}`
const results = checked?.key === key ? checked.results : null
const groups = useMemo(() => (results ? groupResults(results) : null), [results])
const busy = progress !== null
const check = async () => {
setNotice(null)
const run = await runBatches(
chunk(urls, MAX_URLS),
(batch) => adminApi.check(batch),
(done, total) => setProgress({ label: 'Checking', done, total }),
)
setProgress(null)
if (run.failed) setNotice({ tone: 'error', text: errorText(run.failed.error) })
else setChecked({ key, results: run.results.flatMap((r) => r.results) })
}
const add = async () => {
if (!groups) return
const normal = [...groups.new, ...groups.waiting]
const override = [...(withRemoved ? groups.removed : []), ...(withRejected ? groups.rejected : [])]
const total = normal.length + override.length
if (total > 1000) {
const runs = Math.ceil(total / PER_INGEST_RUN)
const ok = await confirm({
title: `Queue ${plural(total, 'game')}?`,
body: `The ingest workflow handles about ${PER_INGEST_RUN} games per run, so this takes about ${runs} runs (45 minutes each); the rest waits in the queue meanwhile.`,
action: `Queue ${plural(total, 'game')}`,
})
if (!ok) return
}
setNotice(null)
const batches = [
...chunk(normal, MAX_URLS).map((b) => ({ urls: b, override: false })),
...chunk(override, MAX_URLS).map((b) => ({ urls: b, override: true })),
]
const run = await runBatches(
batches.map((b) => [b]),
([b]) => adminApi.add(b.urls, b.override, via),
(done, all) => setProgress({ label: 'Adding', done, total: all }),
)
setProgress(null)
const done: AddResult[] = run.results
const queued = done.flatMap((r) => r.results.filter((x) => x.approved && x.url).map((x) => x.url as string))
if (queued.length > 0 && done[0]) {
const label = via ? `Collection #${collected?.read.id}: ${plural(queued.length, 'game')}` : `Add: ${plural(queued.length, 'game')}`
track(label, done[0].at, queued)
}
const commits = done.map((r) => shortSha(r.sha)).filter((s) => s !== 'no commit')
const lines: string[] = []
if (queued.length > 0 || !run.failed) {
lines.push(
`Queued ${plural(queued.length, 'game')} for ingest${commits.length ? ` (${commits.join(', ')})` : ''}. Follow them under “Recent batches”. ${PUBLISH_NOTE}`,
)
}
if (run.failed) {
lines.push(errorText(run.failed.error))
lines.push(
`${plural(run.remaining.flat().reduce((n, b) => n + b.urls.length, 0), 'game')} not sent: Check again, then Add sends what is left.`,
)
}
setNotice({ tone: run.failed ? 'error' : 'info', text: lines.join('\n') })
if (!run.failed) {
setChecked(null)
if (source === 'paste') setText('')
else setCollected(null)
} else {
// Re-check what is left, so a second Add sends only that.
setChecked(null)
}
void client.invalidateQueries({ queryKey: ['queue'] })
}
const addable = groups ? groups.new.length + groups.waiting.length : 0
const overridable = groups ? (withRemoved ? groups.removed.length : 0) + (withRejected ? groups.rejected.length : 0) : 0
return (
<section className="max-w-3xl">
<section className="max-w-4xl">
<h1 className="mb-1 text-lg font-semibold">Add games</h1>
<p className="mb-3 text-sm text-muted-foreground">
Paste itch.io game URLs (one per line, up to 200). New ones are approved right away and scraped by the
ingest workflow; paid games are dropped there.
Paste or upload any list (plain links, Markdown, CSV, HTML, JSON), or read an itch.io collection. Check it
first: new games are queued for the ingest workflow, which drops the ones that turn out to be paid.
</p>
<TabBar
label="Where the list comes from"
value={source}
onChange={setSource}
options={[
{ id: 'paste', label: 'Paste or upload' },
{ id: 'collection', label: 'itch.io collection' },
]}
/>
{source === 'paste' ? (
<PasteInput text={text} onText={setText} found={pasted.urls.length} repeats={pasted.duplicates} onError={setNotice} />
) : (
<CollectionInput collected={collected} onCollected={setCollected} onError={setNotice} />
)}
{notice && (
<div className="mt-4">
<Notice text={notice.text} tone={notice.tone} onClose={() => setNotice(null)} />
</div>
)}
{progress && <BatchProgress label={progress.label} done={progress.done} total={progress.total} />}
<div className="mt-3 flex flex-wrap items-center gap-3 text-sm">
<Button variant="outline" disabled={urls.length === 0 || busy} onClick={() => void check()}>
{busy && progress?.label === 'Checking' ? 'Checking…' : `Check ${urls.length ? plural(urls.length, 'URL') : ''}`}
</Button>
{groups && (
<Button disabled={addable + overridable === 0 || busy} onClick={() => void add()}>
{busy && progress?.label === 'Adding' ? 'Adding…' : `Add ${plural(addable + overridable, 'game')}`}
</Button>
)}
{urls.length > 0 && !groups && <span className="text-muted-foreground">Check the list to see what Add would do.</span>}
</div>
{groups && (
<div className="mt-4 space-y-2">
{GROUPS.filter((g) => groups[g.id].length > 0).map((g) => (
<details key={g.id} className="rounded-md border px-3 py-2 text-sm" open={g.id === 'new' && groups.new.length <= 20}>
<summary className="flex cursor-pointer flex-wrap items-center gap-2">
<span className="font-medium">{g.label}</span>
<span className="tabular-nums text-muted-foreground">{groups[g.id].length.toLocaleString('en-GB')}</span>
<span className="text-xs text-muted-foreground">{g.hint}</span>
{g.id === 'removed' && (
<label className="ml-auto flex items-center gap-2" onClick={(e) => e.stopPropagation()}>
<input type="checkbox" checked={withRemoved} onChange={(e) => setWithRemoved(e.target.checked)} />
Add with override
</label>
)}
{g.id === 'rejected' && (
<label className="ml-auto flex items-center gap-2" onClick={(e) => e.stopPropagation()}>
<input type="checkbox" checked={withRejected} onChange={(e) => setWithRejected(e.target.checked)} />
Add with override
</label>
)}
</summary>
<ul className="mt-2 max-h-60 overflow-y-auto font-mono text-xs">
{groups[g.id].map((u) => (
<li key={u} className="truncate py-0.5">
{u}
</li>
))}
</ul>
</details>
))}
</div>
)}
<RecentBatches />
</section>
)
}
function PasteInput({
text,
onText,
found,
repeats,
onError,
}: {
text: string
onText: (text: string) => void
found: number
repeats: number
onError: (n: NoticeState) => void
}) {
const file = useRef<HTMLInputElement>(null)
const [dragging, setDragging] = useState(false)
const load = async (files: FileList | null) => {
const picked = files?.[0]
if (!picked) return
if (picked.size > MAX_FILE_BYTES) {
onError({ tone: 'error', text: `${picked.name} is larger than 5 MB.` })
return
}
const content = await picked.text()
onText(text ? `${text}\n${content}` : content)
}
const drop = (e: DragEvent) => {
e.preventDefault()
setDragging(false)
void load(e.dataTransfer.files)
}
return (
<div>
<label htmlFor="urls" className="sr-only">
Game URLs
Game URLs or any text containing them
</label>
<textarea
id="urls"
value={text}
onChange={(e) => setText(e.target.value)}
onChange={(e) => onText(e.target.value)}
onDragOver={(e) => {
e.preventDefault()
setDragging(true)
}}
onDragLeave={() => setDragging(false)}
onDrop={drop}
rows={8}
spellCheck={false}
placeholder="https://creator.itch.io/game"
className="w-full rounded-md border bg-background p-2 font-mono text-sm"
placeholder="https://creator.itch.io/game — or drop a .txt / .csv / .md / .html / .json file here"
className={cn('w-full rounded-md border bg-background p-2 font-mono text-sm', dragging && 'border-primary ring-2 ring-primary/30')}
/>
<div className="mt-2 flex flex-wrap items-center gap-4 text-sm">
<label className="flex items-center gap-2">
<input type="checkbox" checked={override} onChange={(e) => setOverride(e.target.checked)} />
Override: also bring back removed or rejected games
</label>
<Button className="ml-auto" disabled={!urls.length || urls.length > 200 || add.isPending} onClick={() => add.mutate()}>
{add.isPending ? 'Adding…' : `Add ${urls.length || ''}`}
<div className="mt-1 flex flex-wrap items-center gap-3 text-sm">
<span className="text-muted-foreground">
{found ? `${plural(found, 'game URL')} found` : 'No itch.io game URL yet'}
{repeats > 0 && ` (${plural(repeats, 'repeat')} ignored)`}
</span>
<input
ref={file}
type="file"
accept=".txt,.csv,.md,.html,.htm,.json,text/plain,text/csv,text/markdown,text/html,application/json"
className="hidden"
onChange={(e) => {
void load(e.target.files)
e.target.value = ''
}}
/>
<Button size="sm" variant="ghost" onClick={() => file.current?.click()}>
Load a file…
</Button>
{text && (
<Button size="sm" variant="ghost" onClick={() => onText('')}>
Clear
</Button>
)}
</div>
</div>
)
}
{error && (
<div className="mt-4">
<Notice text={error} tone="error" onClose={() => setError(null)} />
function CollectionInput({
collected,
onCollected,
onError,
}: {
collected: Collected | null
onCollected: (c: Collected | null) => void
onError: (n: NoticeState) => void
}) {
const [url, setUrl] = useState('')
const [reading, setReading] = useState(false)
const [watching, setWatching] = useState(false)
const stop = useRef(false)
const client = useQueryClient()
/** Ten pages per request, until the end of the collection or Stop. */
const read = async () => {
stop.current = false
setReading(true)
onError(null)
let page = 1
let free: CollectionItem[] = []
const seen = new Set<string>()
let priced = 0
let pages = 0
try {
for (;;) {
const r = await adminApi.readCollection(url, page)
const fresh = r.items.filter((i) => i.price === null && !seen.has(i.url))
for (const i of fresh) seen.add(i.url)
free = [...free, ...fresh]
priced += r.items.filter((i) => i.price !== null).length
pages += r.pages
onCollected({ read: r.collection, free, priced, pages, nextPage: r.nextPage, stopped: r.stopped })
if (r.nextPage === null || r.stopped || stop.current) break
page = r.nextPage
}
} catch (e) {
onError({ tone: 'error', text: errorText(e) })
} finally {
setReading(false)
}
}
const watch = async () => {
setWatching(true)
try {
const { collection } = await adminApi.watch(collected?.read.url ?? url)
onError({ tone: 'info', text: `Following collection #${collection.id}: the cron queues its new free games (Settings lists it).` })
void client.invalidateQueries({ queryKey: ['settings'] })
} catch (e) {
onError({ tone: 'error', text: errorText(e) })
} finally {
setWatching(false)
}
}
return (
<div className="space-y-2 text-sm">
<div className="flex flex-wrap gap-2">
<Input
value={url}
onChange={(e) => setUrl(e.target.value)}
placeholder="https://itch.io/c/1234567/collection-name"
aria-label="itch.io collection URL"
className="max-w-xl flex-1"
/>
{reading ? (
<Button variant="outline" onClick={() => (stop.current = true)}>
Stop
</Button>
) : (
<Button variant="outline" disabled={!url.trim()} onClick={() => void read()}>
Read collection
</Button>
)}
</div>
{collected && (
<div className="flex flex-wrap items-center gap-3 text-muted-foreground">
<span>
<a href={collected.read.url} target="_blank" rel="noreferrer noopener" className="font-medium text-foreground hover:underline">
Collection #{collected.read.id}
</a>
: {plural(collected.free.length, 'free game')} from {plural(collected.pages, 'page')}
{collected.priced > 0 && ` (${plural(collected.priced, 'priced game')} skipped)`}
{reading && ' — reading…'}
{!reading && collected.nextPage !== null && ' — stopped before the end'}
{collected.stopped && ` — itch.io: ${collected.stopped.replace(/_/g, ' ')}`}
</span>
<Button size="sm" variant="ghost" disabled={watching} onClick={() => void watch()}>
Follow this collection
</Button>
</div>
)}
{result && (
<div className="mt-6">
<p className="mb-2 text-sm">
{result.results.filter((r) => r.approved).length} queued for ingest ({shortSha(result.sha)}). {PUBLISH_NOTE}
</p>
<table className="w-full text-sm">
<tbody>
{result.results.map((r, i) => (
<tr key={`${r.input}-${i}`} className="border-b last:border-0">
<td className="py-1.5 font-mono text-xs">{r.url ?? r.input}</td>
<td className="py-1.5 text-muted-foreground">{OUTCOME[r.outcome] ?? r.outcome}</td>
<td className="py-1.5">{r.approved ? 'queued' : r.reason ? r.reason.replace(/_/g, ' ') : '—'}</td>
</tr>
))}
</tbody>
</table>
</div>
</div>
)
}
const STATE_TEXT: Record<TrackItem['state'], string> = {
waiting: 'waiting for the ingest',
added: 'added',
dropped: 'not added',
unknown: 'unknown',
}
/** The batches queued from this browser, and how each game's ingest went. */
function RecentBatches() {
const batches = useTracking((s) => s.batches)
if (batches.length === 0) return null
return (
<div className="mt-8">
<h2 className="mb-2 text-base font-semibold">Recent batches</h2>
<p className="mb-3 text-xs text-muted-foreground">
Queued from this browser. The ingest workflow starts right after each commit; results show up here as it
finishes (checked every minute while something is waiting).
</p>
<div className="space-y-2">
{batches.map((b, i) => (
<BatchCard key={b.id} batch={b} live={i < 3} />
))}
</div>
</div>
)
}
async function trackAll(batch: TrackedBatch): Promise<TrackItem[]> {
const items: TrackItem[] = []
for (const part of chunk(batch.urls, MAX_TRACK_URLS)) items.push(...(await adminApi.track(part, batch.at)).items)
return items
}
function BatchCard({ batch, live }: { batch: TrackedBatch; live: boolean }) {
const [open, setOpen] = useState(false)
const forget = useTracking((s) => s.forget)
const status = useQuery({
queryKey: ['track', batch.id],
queryFn: () => trackAll(batch),
enabled: live || open,
refetchInterval: (q) => (q.state.data?.some((i) => i.state === 'waiting') ? 60_000 : false),
refetchIntervalInBackground: false,
})
const sum = status.data ? summarize(status.data) : null
return (
<details className="rounded-md border px-3 py-2 text-sm" onToggle={(e) => setOpen(e.currentTarget.open)}>
<summary className="flex cursor-pointer flex-wrap items-center gap-x-3 gap-y-1">
<span className="font-medium">{batch.label}</span>
<span className="text-xs text-muted-foreground">{when(batch.at)}</span>
{sum && (
<span className="text-xs tabular-nums">
<span className="text-success">{sum.added} added</span>
{sum.waiting > 0 && <span className="text-muted-foreground"> · {sum.waiting} waiting</span>}
{sum.dropped > 0 && <span className="text-destructive"> · {sum.dropped} not added</span>}
{sum.unknown > 0 && <span className="text-muted-foreground"> · {sum.unknown} unknown</span>}
</span>
)}
{status.isFetching && <span className="text-xs text-muted-foreground">checking…</span>}
{status.error && <span className="text-xs text-destructive">{errorText(status.error).split('\n')[0]}</span>}
<button
className="ml-auto text-xs text-muted-foreground underline-offset-4 hover:underline"
onClick={(e) => {
e.preventDefault()
void status.refetch()
}}
>
Check now
</button>
<button
className="text-xs text-muted-foreground underline-offset-4 hover:underline"
onClick={(e) => {
e.preventDefault()
forget(batch.id)
}}
>
Forget
</button>
</summary>
{status.data && (
<table className="mt-2 w-full text-xs">
<tbody>
{status.data.map((i) => (
<tr key={i.url} className="border-b last:border-0">
<td className="max-w-0 truncate py-1 pr-2 font-mono">
<a href={i.url} target="_blank" rel="noreferrer noopener" className="hover:underline">
{i.url.replace('https://', '')}
</a>
</td>
<td className="py-1 whitespace-nowrap text-muted-foreground">
{i.outcome ? (INGEST_TEXT[i.outcome] ?? i.outcome) : STATE_TEXT[i.state]}
{i.attempts ? ` (${plural(i.attempts, 'failed attempt')}: ${i.error ?? ''})` : ''}
</td>
</tr>
))}
</tbody>
</table>
)}
</section>
</details>
)
}
+145 -31
View File
@@ -11,7 +11,7 @@ export class SessionExpired extends Error {
}
}
class ApiError extends Error {
export class ApiError extends Error {
readonly status: number
readonly code: string
@@ -42,13 +42,18 @@ export function isSessionExpired(): boolean {
}
async function api<T>(method: string, path: string, body?: unknown): Promise<T> {
const res = await fetch(path, {
method,
credentials: 'same-origin',
redirect: 'manual',
headers: body === undefined ? undefined : { 'Content-Type': 'application/json' },
body: body === undefined ? undefined : JSON.stringify(body),
})
let res: Response
try {
res = await fetch(path, {
method,
credentials: 'same-origin',
redirect: 'manual',
headers: body === undefined ? undefined : { 'Content-Type': 'application/json' },
body: body === undefined ? undefined : JSON.stringify(body),
})
} catch {
throw new ApiError(0, 'network_error')
}
if (res.type === 'opaqueredirect' || res.status === 401) throw new SessionExpired()
const data = (await res.json().catch(() => ({}))) as { error?: string; message?: string }
if (!res.ok) throw new ApiError(res.status, data.error ?? `http_${res.status}`, data.message)
@@ -56,10 +61,11 @@ async function api<T>(method: string, path: string, body?: unknown): Promise<T>
}
export type CandidateStatus = 'pending' | 'rejected' | 'queued' | 'ingested' | 'failed'
export type CandidateSource = 'rss' | 'form' | 'admin'
export interface Candidate {
url: string
source: 'rss' | 'form' | 'ext' | 'admin'
source: CandidateSource
status: CandidateStatus
title: string | null
image_url: string | null
@@ -69,57 +75,165 @@ export interface Candidate {
submitter: string | null
discovered_at: string
decided_at: string | null
decided_by: string | null
/** How the last ingest ended (added, paid, dead, private, …, timeout). */
outcome: string | null
outcome_at: string | null
}
export interface Me {
email: string
writes: boolean
/** "owner/name" of the data repository, for commit links. */
repo: string | null
}
export interface Decision {
sha: string | null
approved: string[]
skipped: { url: string; reason: string }[]
at: string
}
export interface CheckResult {
input: string
url: string | null
outcome: string
/** The queue status of a URL the queue already knows. */
status: CandidateStatus | null
reason?: string
}
export interface AddResult {
sha: string | null
at: string
results: { input: string; url: string | null; outcome: string; approved: boolean; reason?: string }[]
}
export interface TrackItem {
url: string
state: 'waiting' | 'added' | 'dropped' | 'unknown'
outcome?: string
at?: string
attempts?: number
error?: string | null
}
export type GameEdit = Partial<Record<'safe_virus' | 'nsfw' | 'notes', string>>
export interface RemoveResult {
sha: string | null
removed: string[]
notFound: string[]
invalid: string[]
covers: { deleted: number; failed: number }
warnings: string[]
}
export interface BulkEditResult {
sha: string | null
edited: string[]
unchanged: string[]
notFound: string[]
}
export interface AuditRow {
id: number
at: string
actor: string
action: string
target: string | null
commit_sha: string | null
detail: string | null
}
export interface Automation {
enabled: boolean
sources: CandidateSource[]
hours: number
since: string
}
interface LastRun {
at: string
approved: number
added: number
review: number
duplicates: number
pages: number
sha: string | null
errors: string[]
collections: { id: string; status: number | null; found: number; added: number; next_page: number }[]
}
export interface WatchedCollection {
id: string
slug: string
enabled: number
added_at: string
last_polled_at: string | null
last_status: number | null
backoff_until: string | null
next_page: number
last_found: number | null
last_added: number | null
}
export interface SettingsData {
automation: Automation
lastRun: LastRun | null
collections: WatchedCollection[]
writes: boolean
}
export interface CollectionItem {
url: string
title: string
image: string | null
genre: string | null
price: string | null
}
export interface CollectionRead {
collection: { id: string; slug: string; url: string }
items: CollectionItem[]
pages: number
nextPage: number | null
/** Set when the read stopped early on an error, after some pages. */
stopped?: string
}
export const adminApi = {
me: () => api<Me>('GET', '/api/admin/me'),
queue: (status: CandidateStatus) =>
api<{ counts: Record<CandidateStatus, number>; items: Candidate[] }>(
'GET',
`/api/admin/queue?status=${status}&limit=500`,
),
api<{ counts: Record<CandidateStatus, number>; items: Candidate[] }>('GET', `/api/admin/queue?status=${status}&limit=500`),
approve: (urls: string[], override: boolean) =>
api<Decision>('POST', '/api/admin/queue/decide', { action: 'approve', urls, override }),
reject: (urls: string[]) => api<{ rejected: string[] }>('POST', '/api/admin/queue/decide', { action: 'reject', urls }),
add: (urls: string[], override: boolean) => api<AddResult>('POST', '/api/admin/add', { urls, override }),
check: (urls: string[]) => api<{ results: CheckResult[] }>('POST', '/api/admin/check', { urls }),
add: (urls: string[], override: boolean, via?: string) =>
api<AddResult>('POST', '/api/admin/add', { urls, override, ...(via ? { via } : {}) }),
track: (urls: string[], since: string) => api<{ head: string; items: TrackItem[] }>('POST', '/api/admin/track', { urls, since }),
edit: (url: string, edit: GameEdit) => api<{ sha: string | null; edited: number }>('PATCH', '/api/admin/games', { url, edit }),
remove: (url: string, reason: string) =>
api<{ sha: string | null; removed: number }>('DELETE', '/api/admin/games', { url, reason }),
restore: (url: string) => api<{ sha: string | null; queued: boolean }>('POST', '/api/admin/games/restore', { url }),
editMany: (edits: { url: string; edit: GameEdit }[]) => api<BulkEditResult>('PATCH', '/api/admin/games/bulk', { edits }),
removeMany: (urls: string[], reason: string) => api<RemoveResult>('POST', '/api/admin/games/remove', { urls, reason }),
restore: (url: string) => api<{ sha: string | null; queued: boolean; at: string }>('POST', '/api/admin/games/restore', { url }),
activity: (params: { before?: number | null; actions?: string[] }) => {
const q = new URLSearchParams({ limit: '50' })
if (params.before) q.set('before', String(params.before))
if (params.actions?.length) q.set('actions', params.actions.join(','))
return api<{ items: AuditRow[]; next: number | null }>('GET', `/api/admin/activity?${q}`)
},
settings: () => api<SettingsData>('GET', '/api/admin/settings'),
saveAutomation: (automation: Omit<Automation, 'since'> & { includeOlder?: boolean }) =>
api<{ automation: Automation }>('PUT', '/api/admin/settings', { automation }),
readCollection: (url: string, page: number) => api<CollectionRead>('POST', '/api/admin/collections/read', { url, page }),
watch: (url: string) => api<{ collection: WatchedCollection }>('POST', '/api/admin/collections', { url }),
toggleCollection: (id: string, enabled: boolean) =>
api<{ collection: WatchedCollection }>('PATCH', '/api/admin/collections', { id, enabled }),
unwatch: (id: string) => api<{ removed: boolean }>('DELETE', '/api/admin/collections', { id }),
}
export function shortSha(sha: string | null): string {
return sha ? sha.slice(0, 7) : 'no commit'
}
export function errorText(e: unknown): string {
if (e instanceof SessionExpired) return e.message
if (e instanceof ApiError) {
const known: Record<string, string> = {
forbidden: 'This account is not allowed to use the admin.',
not_configured: 'The admin is not configured yet (Cloudflare Access / D1).',
github_not_configured: 'Writes are off: the GitHub App is not configured.',
needs_override: 'Previously removed — approve with override.',
}
return known[e.code] ?? e.message
}
return e instanceof Error ? e.message : String(e)
}
Loaded 100 of 260 files, more files were not shown because too many files have changed in this diff. Show more