How poli0981/free-steam-games-list works
This repository curates a Steam free-to-play game dataset through a Python discovery and maintenance pipeline, then serves it through a public web app and companion desktop/Android apps. The main contributor workflow runs discovery, submits candidate games for admin review, and publishes accepted changes; the public app then serves browse, search, charts, and exports from the dataset. The graph also shows the admin and Worker API, plus pipeline monitoring. Source excerpts are partial, so some subsystem links are documented rather than traced through every handler.
Main entry points: ingest_new.py Game Discovery · admin.ts Admin Handlers · routes Web App · index.ts Worker Router
Components 20
Dataset Pipeline
- Game Discovery
scripts/ingest_new.py - Pipeline Core
scripts/core - Published Dataset
data
Public Apps
- Web App
web/src/routes - Dataset Client
web/src/lib/fetcher.ts - Charts
web/src/routes/charts - Desktop & Android
web/src-tauri/src/lib.rs
Admin Review
- Admin Console
web/admin/src/App.svelte - Review Queue
web/admin/src/views/QueueView.svelte - Pipeline Monitor
web/admin/src/views/PipelineView.svelte - Admin API Client
web/admin/src/lib/api.ts
Worker Services
- Worker Router
web/worker/index.ts - Candidate Ingest
web/worker/routes/ingest.ts - Admin Handlers
web/worker/routes/admin.ts - Pipeline API
web/worker/routes/pipeline.ts - Git Commit Service
web/worker/lib/git-commit.ts - Review Queue DB
web/worker/routes/ingest.ts
Other components
- Maintainer
- GitHub Actions & Git
- Steam Data Sources
Connections 22
- Maintainer → Game Discovery: runs sweep
- Game Discovery → Steam Data Sources: fetches game data
- Game Discovery → Candidate Ingest: submits candidates
web/worker/routes/ingest.ts - Game Discovery → Pipeline Core: uses pipeline helpers
scripts/ingest_new.py - Pipeline Core → Published Dataset: maintains data
- Maintainer → Admin Console: reviews candidates
- Admin Console → Review Queue: renders queue
web/admin/src/App.svelte - Review Queue → Admin API Client: requests admin API
web/admin/src/views/QueueView.svelte - Admin API Client → Admin Handlers: calls API
web/admin/src/lib/api.ts - Admin Handlers → Review Queue DB: reads and updates
web/worker/routes/admin.ts - Admin Handlers → Git Commit Service: commits changes
web/worker/routes/admin.ts - Git Commit Service → GitHub Actions & Git: writes Git commits
web/worker/lib/git-commit.ts - Admin Console → Pipeline Monitor: renders monitor
web/admin/src/App.svelte - Pipeline Monitor → Pipeline API: requests status
web/admin/src/views/PipelineView.svelte - Pipeline API → GitHub Actions & Git: reads workflow runs
web/worker/routes/pipeline.ts - Worker Router → Candidate Ingest: routes requests
web/worker/index.ts - Worker Router → Admin Handlers: routes requests
web/worker/index.ts - Worker Router → Pipeline API: routes requests
- Web App → Dataset Client: loads dataset
- Dataset Client → Published Dataset: fetches data
web/src/lib/fetcher.ts - Web App → Charts: offers charts
- Web App → Desktop & Android: shares app experience