How poli0981/free-games-itchio-list works
Free Itch.io Games List is a public read-only catalog with web and native viewers, plus a maintainer workflow for reviewing additions and a daily data-refresh pipeline. Visitors browse, filter, inspect, and explore catalog charts or removed games; submitters can suggest games, while maintainers review candidates and edit catalog data. The sampled sources show the frontend entry points, Worker routing, and parts of admin handling; README capabilities fill in unsampled domain branches. Some pipeline and storage relationships are documented but their implementation was not sampled.
Main entry points: index.ts Request router · App.tsx Web app · catalog.ts Catalog data · admin.ts Admin API
Components 28
Public catalog
- Web app
webapp/src/App.tsx - Game browsing
webapp/src/routes/games.tsx - Game details
webapp/src/routes/game-detail.tsx - Catalog charts
webapp/src/routes/charts.tsx - Removed games
webapp/src/routes/deleted.tsx - Suggestions
webapp/src/routes/suggest.tsx
Edge services
- Request router
webapp/worker/index.ts - Visitor gate
webapp/worker/gate.ts - Image resizing
webapp/worker/img.ts
Maintainer workflow
- Admin app
webapp/admin/app.tsx - Review and editing
webapp/admin/add.tsx - Admin API client
webapp/admin/api.ts - Admin API
webapp/worker/admin.ts - Candidate queue
webapp/worker/queue.ts
Catalog updates
- Catalog repository
webapp/worker/repo.ts - Automatic discovery
webapp/worker/discover.ts - Automated rules
webapp/worker/automation.ts - Itch scraper
scripts/scraper.py - Data refresh
scripts/refresh.py - Raw catalog
scripts/data_store.py
App runtime
- Catalog data
webapp/src/lib/data/catalog.ts - Native viewers
webapp/src-tauri/src/lib.rs
Other components
- Visitor
- itch.io
- Maintainer
- Cloudflare D1
- Static assets
- GitHub repository
Connections 32
- Visitor → Web app: opens
README.md - Web app → Game browsing: routes to
webapp/src/App.tsx - Web app → Game details: routes to
webapp/src/App.tsx - Web app → Catalog charts: routes to
webapp/src/App.tsx - Web app → Removed games: routes to
webapp/src/App.tsx - Web app → Suggestions: routes to
README.md - Game browsing → Catalog data: reads
- Game details → Catalog data: reads
- Catalog charts → Catalog data: reads
- Removed games → Catalog data: reads
- Native viewers → Catalog data: downloads
README.md - Visitor → Request router: requests
webapp/worker/index.ts - Request router → Visitor gate: checks pass
webapp/worker/index.ts - Request router → Image resizing: dispatches
webapp/worker/index.ts - Image resizing → Static assets: reads
webapp/worker/img.ts - Request router → Static assets: serves
webapp/worker/index.ts - Maintainer → Admin app: uses
README.md - Admin app → Review and editing: routes to
webapp/admin/app.tsx - Review and editing → Admin API client: calls
webapp/admin/add.tsx - Admin API client → Admin API: requests
webapp/admin/api.ts - Request router → Admin API: dispatches
webapp/worker/index.ts - Admin API → Candidate queue: reads and writes
webapp/worker/admin.ts - Admin API → Catalog repository: updates
webapp/worker/admin.ts - Request router → Automatic discovery: runs
webapp/worker/index.ts - Request router → Automated rules: runs
webapp/worker/index.ts - Automatic discovery → itch.io: reads feeds
README.md - Automated rules → Catalog repository: uses
- Data refresh → Itch scraper: uses
- Data refresh → Raw catalog: updates
- Itch scraper → itch.io: scrapes
README.md - Catalog repository → GitHub repository: reads and writes
- Request router → Cloudflare D1: stores queue