docs: put the project in maintenance mode

The project is stable: no new features, code changes only for security
advisories and runtime/dependency updates, and issues and pull requests
are for the data (add, correct, remove a game).

- README: status, build, quality, version, licence and runtime badges, a
  "Project status" section, and a data-first Contribute section
- CONTRIBUTING, SECURITY, Contact, the PR template and CLAUDE.md state
  the same policy
- Issue forms: add_game and edit_game are new; feature_request, feedback
  and off_topic are removed; blank issues are off (config.yml)
- About page: "Report something" links the five remaining forms

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
This commit is contained in:
poli0981andClaude Fable 5.2 committed 2026-11-11 20:49:27 +07:00
1 parent 6c7c6e844e
commit fa8dbaf92b
18 files changed
+331 -197

No files matched your search

+39
View File
@@ -0,0 +1,39 @@
name: ➕ Add Games
description: A free-to-play Steam game that is missing from the list (max 10)
title: "[Add Games] "
labels: [ "add-game" ]
body:
- type: markdown
attributes:
value: |
Thanks for the tip! New free games are found on Steam automatically every day,
so most turn up on their own within a few days. Use this for one that is still missing.
Every game is fetched from Steam and checked (free, a game, reachable) before it is listed.
- type: textarea
id: games
attributes:
label: Games to add (Steam store links, one per line, max 10)
description: A store link or a bare appid. Nothing else is needed, the rest comes from Steam.
placeholder: |
https://store.steampowered.com/app/730/
https://store.steampowered.com/app/570/
validations:
required: true
- type: textarea
id: notes
attributes:
label: Anything worth knowing? (optional)
description: e.g. "safe, played 50 h", "kernel anti-cheat", "servers shut down in 2027". Public, like everything here.
- type: checkboxes
id: terms
attributes:
label: Final check
description: Spam/off-topic requests ignored by default. Good luck bro :))
options:
- label: These games are free to play on Steam right now - not a demo, not DLC, not a paid game
required: true
- label: I searched the site and they are not listed yet
required: true
+6 -6
View File
@@ -1,5 +1,5 @@
name: 🐛 Bug Report
description: Report a bug or wrong data (broken thumbnail, wrong genre, web app issue, etc.)
description: Something is broken (web app, desktop or Android app, stale or wrong numbers, broken thumbnail)
title: "[Bug] "
labels: ["bug"]
body:
@@ -7,10 +7,10 @@ body:
attributes:
value: |
Thanks for reporting! This broke unemployed dev will check when caffeine kicks in :))
For things that aren't bugs: a missing game or a wrong genre goes in
[Discussions › Ideas](https://github.com/poli0981/free-steam-games-list/discussions/categories/ideas),
a game that should go uses **Delete game**, and something you can't use with a keyboard,
a screen reader or zoom has its own **Accessibility barrier** form.
The project is in maintenance mode: a bug gets a fix, a wish does not get a feature.
For things that aren't bugs: a missing game uses **Add games**, a wrong genre, type,
anti-cheat or note **Edit game**, a game that should go **Delete games**, and something
you can't use with a keyboard, a screen reader or zoom has its own **Accessibility barrier** form.
- type: dropdown
id: surface
@@ -35,7 +35,7 @@ body:
label: What kind of bug?
description: Check all that apply (multiple OK).
options:
- label: Wrong game name / genre / metadata
- label: Wrong or stale data from Steam (name, tags, languages, dates)
- label: Broken or dead link
- label: Thumbnail not showing
- label: Reviews / players not updating
+11
View File
@@ -0,0 +1,11 @@
# The repository is in maintenance mode (CONTRIBUTING.md): issues are for the
# data, for something broken and for accessibility barriers. Everything else
# is sent elsewhere, and blank issues are off so nothing bypasses the forms.
blank_issues_enabled: false
contact_links:
- name: 🔒 Security vulnerability
url: https://github.com/poli0981/free-steam-games-list/security/advisories/new
about: Report it privately, never as a public issue. See SECURITY.md.
- name: 💬 Questions, feedback, chit-chat
url: https://github.com/poli0981/free-steam-games-list/discussions
about: Discussions. Feature requests are not taken - the project is stable and in maintenance mode.
+60
View File
@@ -0,0 +1,60 @@
name: ✏️ Edit Game
description: A listed game has something wrong (genre, type, anti-cheat, notes, safe)
title: "[Edit Game] "
labels: [ "edit-game" ]
body:
- type: markdown
attributes:
value: |
Thanks for the correction! It is recorded as an override, which every pipeline run keeps.
Only the human-judged fields can be corrected here. Name, tags, languages, reviews and
player counts are whatever Steam says and are refreshed from Steam - if one of those
is stale or wrong, use **Bug report** instead.
- type: input
id: game
attributes:
label: Game (Steam store link or page on the site)
placeholder: https://store.steampowered.com/app/730/
validations:
required: true
- type: checkboxes
id: fields
attributes:
label: What is wrong?
description: Check all that apply.
options:
- label: Genre
- label: Type (online / offline)
- label: Anti-cheat (product, or kernel-level or not)
- label: Safe (y / n / ?)
- label: Notes
validations:
required: true
- type: textarea
id: change
attributes:
label: What should it say?
description: Current value → correct value, per field.
placeholder: |
genre: Casual → RTS
anti_cheat: none → Easy Anti-Cheat (kernel)
validations:
required: true
- type: textarea
id: source
attributes:
label: How do you know? (optional but helpful)
description: A link to the store page, the developer's announcement, or "I play it". Public, like everything here.
- type: checkboxes
id: terms
attributes:
label: Final check
description: Spam/off-topic requests ignored by default. Good luck bro :))
options:
- label: I agree – this is a correction to a game on the list
required: true
@@ -1,68 +0,0 @@
name: 💡 Feature Request / Improvement
description: Suggest new feature or improve existing one
title: "[Feature] "
labels: [ "enhancement" ]
body:
- type: markdown
attributes:
value: |
Thanks for the idea! This noob dev appreciates it (Claude buddy will help code :)))
- type: checkboxes
id: type
attributes:
label: Type (choose one only)
options:
- label: New feature
- label: Improvement to existing code/feature
validations:
required: true
- type: input
id: title
attributes:
label: Feature/Improvement name
description: Short title (e.g., "Add peak players column")
validations:
required: true
- type: textarea
id: reason
attributes:
label: Why? Reason
description: How does it help? (e.g., "Current tables load slow with 200+ games")
validations:
required: true
- type: checkboxes
id: priority
attributes:
label: Priority level (choose one only)
options:
- label: Not urgent (nice to have)
- label: Could be useful
- label: Very needed
- label: Urgent af
validations:
required: true
- type: textarea
id: description
attributes:
label: How it works? (optional)
description: More details or example
- type: textarea
id: code
attributes:
label: Code snippet/mockup (optional – no malware pls, I'll check though lazy :D)
render: text
- type: checkboxes
id: terms
attributes:
label: Final check
description: Off-topic/spam ignored by default. Good luck bro :))
options:
- label: I agree – this is on-topic
required: true
-37
View File
@@ -1,37 +0,0 @@
name: 📢 Feedback / Rant
description: General feedback, complaints, or suggestions not fitting other templates
title: "[Feedback] "
labels: [ "feedback" ]
body:
- type: markdown
attributes:
value: |
Spill it bro – good, bad, ugly. This noob dev reads (sometimes :)))
- type: textarea
id: feedback
attributes:
label: Your feedback
description: Docs too strict? Contributing guidelines wrong? Copyright issue? Repo like shit? Something else?
validations:
required: true
- type: checkboxes
id: common
attributes:
label: Common issues? (optional, check all)
options:
- label: Docs too harsh/complicated
- label: Contributing rules wrong
- label: Possible copyright/problematic game
- label: Repo sucks / needs total overhaul
- label: Other (described above)
- type: checkboxes
id: terms
attributes:
label: Final check
description: Off-topic/spam/rude stuff ignored by default. Good luck :))
options:
- label: I agree – this is real feedback
required: true
-26
View File
@@ -1,26 +0,0 @@
name: ❓ Off-Topic / Other
description: Anything that isn't a bug, feature, removal, feedback or accessibility report
title: "[Other] "
labels: ["off-topic"]
body:
- type: markdown
attributes:
value: |
For random stuff, questions, chit-chat. But if off-topic/spam/violate policy – ignored by default :))
- type: textarea
id: description
attributes:
label: What is it?
description: Go ahead bro
validations:
required: true
- type: checkboxes
id: terms
attributes:
label: Final check
description: I understand this might be ignored. Good luck :))
options:
- label: I agree
required: true
+18 -1
View File
@@ -3,19 +3,36 @@ Thanks for the PR! One person reviews these by hand, so a short "what and why" g
Everything here is public and permanent: keep personal info (email, real name, account IDs) out of it.
Written with an AI assistant? Fine - so was most of this repo. You still checked the boxes yourself.
Delete the sections that don't apply.
The project is stable and in maintenance mode (CONTRIBUTING.md). A pull request is merged when it is:
- data: a game added, corrected or removed;
- a security fix (report it privately first, SECURITY.md);
- a runtime or dependency update, or the repair of what one broke.
New features are not taken.
-->
## What and why
<!-- A sentence or two. "Closes #123" if it fixes an issue. -->
## Kind of change
- [ ] Data: add a game (`scripts/temp_info.jsonl`)
- [ ] Data: correct a game (`data/overrides/<appid>.json`, written by `scripts/edit_game.py`)
- [ ] Data: remove a game (`data/blocklist.jsonl`, written by `scripts/delete_game.py`)
- [ ] Security fix
- [ ] Runtime / dependency update, or a fix for what one broke
- [ ] Docs
## Checks
- [ ] Web (`web/`): `npm run typecheck && npm test && npm run build && node scripts/verify-dist.mjs --web`
- [ ] Pipeline (`scripts/`): `python -m pytest scripts/tests`
- [ ] Overrides or blocklist: `python scripts/edit_game.py --check` / `python scripts/delete_game.py --check`
- [ ] Docs or queued links only - nothing to run
- [ ] No hand edit to `data/data_*.jsonl` or `data/index.json`
## Accessibility (interface changes)
## Accessibility (only if the interface changed)
The longer version is in [ACCESSIBILITY.md](https://github.com/poli0981/free-steam-games-list/blob/main/ACCESSIBILITY.md#for-contributors).
@@ -80,7 +80,7 @@ jobs:
'',
'---',
'',
'*(Auto-posted by `.github/workflows/announce-release-discussion.yml`. Reply with feedback, install issues, or feature requests — full bug reports still go through the [issue templates](../../issues/new/choose).)*',
'*(Auto-posted by `.github/workflows/announce-release-discussion.yml`. Reply with feedback or install issues. The project is in maintenance mode, so feature requests are not taken — bug reports and data changes go through the [issue templates](../../issues/new/choose).)*',
]
.filter(Boolean)
.join('\n');
+25
View File
@@ -4,6 +4,31 @@ All notable changes to this awesome noob repo will be documented here.
## [Unreleased]
### 🧊 Stable: maintenance mode (2026-11-11)
The project does what it set out to do, so from here it is kept running
rather than extended. Nothing changes for readers: the pipeline still
refreshes the list every day, and the site and the apps stay up.
- **No new features.** Code changes only for security advisories, runtime and
dependency updates, and whatever those break.
- **Issues and pull requests are for the data.** Two new forms, **Add games**
and **Edit game**, join **Delete games**; **Bug report** and
**Accessibility barrier** stay for things that are broken. The feature
request, feedback and off-topic forms are gone, blank issues are off, and
the chooser sends questions to Discussions and vulnerabilities to private
reporting.
- The About page's "Report something" links follow: add, correct, remove,
bug, accessibility. The released apps (2.5.1) still link the old feature
form, which now opens the form chooser; they take the new links with their
next release.
- README: a status badge, build badges (Web CI, Python Tests, CodeQL,
SonarCloud gate and coverage), live desktop and Android version badges, and
the licences and runtimes. CONTRIBUTING, SECURITY, the pull-request
template and CLAUDE.md state the same policy.
- No legal document you accept changed, so nobody is asked to accept the
terms again.
### 🧰 Tooling & misc
- Dependencies: patch releases of the icon, dialog, toast and virtual-list
+23
View File
@@ -11,6 +11,29 @@ scraping pipeline (`scripts/`) driven by GitHub Actions.
**Git is the source of truth for game data.** Nothing else is. Keep it that way.
## Project status: stable, maintenance only (since 2026-11-11)
The project is finished, not abandoned. The pipeline, the site and the apps
keep running; the code no longer grows. What that means for any change:
- **No new features**, and no refactor or redesign for its own sake. A
request for one is declined, whoever asks in an issue or a pull request.
- **Code changes only for** a security advisory (CVE, CodeQL, RustSec,
`npm audit`), a runtime or dependency update (Node, Python, Rust, npm / pip
/ cargo packages, pinned Actions), and whatever those break. A bug or an
accessibility barrier gets the smallest fix that closes it.
- **Issues and pull requests from others are for the data**: add a game
(`scripts/temp_info.jsonl`), correct one (`data/overrides/`), remove one
(`data/blocklist.jsonl`). The issue forms are `add_game`, `edit_game`,
`delete_game`, `bug_report` and `accessibility`; blank issues are off
(`.github/ISSUE_TEMPLATE/config.yml`). The About page links those five by
file name, so renaming a form is a web change.
- The policy is stated in `README.md` ("Project status"), `CONTRIBUTING.md`,
`SECURITY.md` and the pull-request template: change them together.
- Every rule below still holds. Maintenance mode is when they matter most:
the next change will be made by someone who has not touched the code for
months.
## Data invariants — get these wrong and you corrupt the dataset
- **`appid` is not a stored field.** It is parsed out of `link` with
+68 -28
View File
@@ -2,7 +2,28 @@
Yo, thanks for stopping by! This repo is a hobby project by a broke, unemployed Vietnamese dev (20-something, introvert max level, dropped out uni year 3, mooching off family, Steam library 400+ games 80% under $10 sale addiction). Powered ~70% by AI assistants — Grok for v1, Claude for v2+ — the only non-judgmental friends keeping this alive while I play Easy mode only :))
Want to help? Awesome — no strict rules, life's hard enough. Pick whichever path below is least-friction for you.
Want to help? Awesome — life's hard enough, so the rules are short.
## Project status: stable, maintenance only
Since 2026-11-11 the project is finished rather than abandoned. The pipeline
still refreshes the list every day and the site and apps stay up, but the code
is no longer growing:
- **No new features.** Feature requests are not taken, as issues, discussions
or pull requests. A pull request that adds one is closed, however good it is.
- **Code changes only for** security advisories (CVEs), runtime and dependency
updates (Node, Python, Rust, the npm / pip / cargo packages, the GitHub
Actions), and whatever those break. Dependabot opens most of them.
- **Issues and pull requests are for the data:** adding a game, correcting one,
removing one.
- Something **broken** (the site, an app, a wrong number) or an
**accessibility barrier** can still be reported. It gets a fix, not a
redesign.
- A **vulnerability** goes through [`SECURITY.md`](SECURITY.md), never a public
issue.
Forks are welcome to go further: the code is MIT and the dataset CC BY 4.0.
## Maintainer contact
@@ -27,52 +48,71 @@ reporting, see [`SECURITY.md`](SECURITY.md)), and <https://poli0981.dev/> or
## How to contribute
### 1. Open an issue (bugs, requests, removals)
### 1. Open an issue
Go to the [Issues tab](https://github.com/poli0981/free-steam-games-list/issues/new/choose) and pick a template:
Go to the [Issues tab](https://github.com/poli0981/free-steam-games-list/issues/new/choose) and pick a form:
- ➖ **Delete game** (max 10 per issue)
- 🐛 **Bug report**
- ➕ **Add game** — a free game that is still missing (max 10 per issue)
- ✏️ **Edit game** — a published game with something wrong: genre, type, anti-cheat, notes, safe
- ➖ **Delete game** — paid now, not a game, malware, duplicate (max 10 per issue)
- 🐛 **Bug report** — something that is broken
- ♿ **Accessibility barrier** — something you can't use with a keyboard, a screen reader or zoom (see [`ACCESSIBILITY.md`](ACCESSIBILITY.md))
- 💡 **Feature request / improvement**
- 📢 **Feedback / rant**
- ❓ **Off-topic**
Fill the form (checkboxes, dropdowns, short descriptions). Every template is reviewed by hand when caffeine hits — none of them auto-run a workflow.
Blank issues are off. Every form is reviewed by hand when caffeine hits — none of them auto-run a workflow.
> Issues are for **reports**, not game submissions. To suggest a game, see section 2.
New free games are found on Steam automatically every day and reviewed before they are listed, so most turn up on their own. Use **Add game** for one that is still missing a few days after it went free.
### 2. Open a pull request (data)
### 2. Suggest a game, or a correction
Fork → branch → one of these → push → open the PR. The template has a short checklist.
New free games are found on Steam automatically every day and reviewed before they are listed, so most turn up on their own. If one is still missing a few days after it went free, or a published game has something wrong (genre, anti-cheat, notes…), post it in [Discussions › Ideas](https://github.com/poli0981/free-steam-games-list/discussions/categories/ideas) with the store link. A correction becomes an override that every pipeline run keeps.
**Add a game:** append store links to `scripts/temp_info.jsonl`.
The companion browser extension ([steam-f2p-extension](https://github.com/poli0981/steam-f2p-extension)) is archived and no longer a way in.
### 3. Manual: fork + commit (most invasive)
For code changes, or to queue games yourself:
1. Fork → branch.
2. Edit code in `scripts/` / `web/src/` / docs, or append store links to `scripts/temp_info.jsonl`:
```jsonl
{"link": "730"}
{"link": "https://store.steampowered.com/app/570/"}
```
3. Push → open PR. The template has a short checklist: what and why, the tests you ran, and an accessibility pass for interface changes. Reviewer (= me) will look when caffeine hits.
A queued line is a link and nothing else: any other key is ignored, and the game is fetched from Steam and checked (free, a game, reachable) before it is published.
A queued line is a link and nothing else (full URL, short URL or bare appid): any other key is ignored, and the game is fetched from Steam and checked (free, a game, reachable) before it is published.
**Correct a game:** add an override. It is a standing instruction in `data/overrides/<appid>.json` that every pipeline run keeps.
```bash
python scripts/edit_game.py 730 --show
python scripts/edit_game.py 730 --set genre="FPS" --reason "Steam's genre is too coarse"
```
Only the human-judged fields can be overridden: `genre`, `type_game`, `safe`, `notes`, `anti_cheat`, `anti_cheat_note`, `is_kernel_ac`. Everything else (name, tags, languages, reviews, players…) is whatever Steam says and is refreshed from Steam.
**Remove a game:** add a blocklist line. The reason and the note are public.
```bash
python scripts/delete_game.py 730 --reason not_free --note "paid since 2026-11"
```
Reasons: `not_free`, `not_a_game`, `duplicate`, `broken`, `inappropriate`, `other`.
Leave out `--apply` in both commands, and **never edit `data/data_*.jsonl` or `data/index.json` by hand**: the pipeline rewrites them on its next run and an edit there is lost (and breaks the hashes the apps check). `Check Overrides` validates an override or blocklist change on the pull request.
### 3. Pull requests that touch code
Only two kinds are merged now:
- a **security fix** — report it privately first ([`SECURITY.md`](SECURITY.md));
- a **runtime or dependency update**, or the repair of what one broke.
`npm run typecheck && npm test && npm run build && node scripts/verify-dist.mjs --web` must pass in `web/`, and `python -m pytest scripts/tests` for the pipeline. Dependencies are pinned and hashed; the rules are in [`CLAUDE.md`](CLAUDE.md) ("CI installs only what is pinned").
The companion browser extension ([steam-f2p-extension](https://github.com/poli0981/steam-f2p-extension)) is archived and no longer a way in.
---
## Tips for smooth contributions
- **Games must be free-to-play on Steam.** No demos, no paid-now games, no malware-flagged ones.
- **Notes / safe** are worth mentioning in a suggestion ("safe to play", "Toxic max", "Grind phê Easy mode"); the maintainer records them as overrides.
- **Spam / off-topic** issues get closed without comment. Don't be that person.
- **Code style:** match the surrounding file. No hard rules. The Python pipeline is intentionally low-ceremony; the web side (SvelteKit, the Worker, `admin/`) is TS-strict.
- **Tests:** for web changes, `npm run typecheck && npm test && npm run build && node scripts/verify-dist.mjs --web` must pass (in `web/`). For pipeline changes, `python -m pytest scripts/tests`.
- **Accessibility:** interface changes get a keyboard pass and keep their names, focus and contrast. The short list is in [`ACCESSIBILITY.md`](ACCESSIBILITY.md#for-contributors) and in the PR template.
- **Notes / safe** are worth mentioning in an Add or Edit request ("safe to play", "Toxic max", "Grind phê Easy mode"); the maintainer records them as overrides.
- **Spam / off-topic / feature-request** issues get closed without comment. Don't be that person.
- **Questions and chit-chat** go to [Discussions](https://github.com/poli0981/free-steam-games-list/discussions), not issues.
## Code of conduct
@@ -82,4 +122,4 @@ A queued line is a link and nothing else: any other key is ignored, and the game
Thanks for making this noob repo better! Star if you find a hidden gem, or buy me a coffee via [FUNDING.yml](.github/FUNDING.yml) to fuel instant noodles + more sale games ✨
Questions? Open an issue — that's contributing too :))
Questions? [Discussions](https://github.com/poli0981/free-steam-games-list/discussions) — that's contributing too :))
+56 -21
View File
@@ -1,11 +1,27 @@
[![Status](https://img.shields.io/badge/status-stable%20%C2%B7%20maintenance%20only-2ea44f?style=flat)](#project-status)
[![Games Count](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fraw.githubusercontent.com%2Fpoli0981%2Ffree-steam-games-list%2Fmain%2Fdata%2Findex.json&query=%24.total&label=Games&color=green&style=flat&logo=steam)](data/)
[![Last Updated](https://img.shields.io/badge/Updated-Daily-blue?style=flat&logo=github-actions)](.github/workflows)
[![Top Online](https://img.shields.io/badge/Top%20Online-Live%20Leaderboard-red?style=flat&logo=steam)](games/top-online.md)
[![Version](https://img.shields.io/github/v/release/poli0981/free-steam-games-list?filter=v*&sort=semver&label=version&color=purple&style=flat&logo=github)](https://github.com/poli0981/free-steam-games-list/releases)
[![Web App](https://img.shields.io/badge/Web%20App-Live-2563eb?style=flat&logo=svelte)](https://free-steam-games.win/)
[![Desktop](https://img.shields.io/badge/Desktop-Tauri%202-FFC131?style=flat&logo=tauri)](https://github.com/poli0981/free-steam-games-list/releases)
[![Android](https://img.shields.io/badge/Android-11%2B%20APK-3DDC84?style=flat&logo=android)](https://github.com/poli0981/free-steam-games-list/releases)
[![Health Check](https://img.shields.io/badge/Health%20Check-Daily-orange?style=flat&logo=github-actions)](.github/workflows/purge-unhealthy.yml)
[![Version](https://img.shields.io/github/v/release/poli0981/free-steam-games-list?filter=v*&sort=semver&label=dataset&color=purple&style=flat&logo=github)](https://github.com/poli0981/free-steam-games-list/releases)
[![Desktop](https://img.shields.io/github/v/release/poli0981/free-steam-games-list?filter=desktop-v*&label=desktop&color=FFC131&style=flat&logo=tauri)](https://github.com/poli0981/free-steam-games-list/releases)
[![Android](https://img.shields.io/github/v/release/poli0981/free-steam-games-list?filter=android-v*&label=android%2011%2B&color=3DDC84&style=flat&logo=android)](https://github.com/poli0981/free-steam-games-list/releases)
[![Web App](https://img.shields.io/website?url=https%3A%2F%2Ffree-steam-games.win%2F&label=web%20app&style=flat&logo=svelte)](https://free-steam-games.win/)
[![Web CI](https://github.com/poli0981/free-steam-games-list/actions/workflows/web-ci.yml/badge.svg?branch=main)](https://github.com/poli0981/free-steam-games-list/actions/workflows/web-ci.yml)
[![Python Tests](https://github.com/poli0981/free-steam-games-list/actions/workflows/python-tests.yml/badge.svg?branch=main)](https://github.com/poli0981/free-steam-games-list/actions/workflows/python-tests.yml)
[![CodeQL](https://github.com/poli0981/free-steam-games-list/actions/workflows/codeql.yml/badge.svg?branch=main)](https://github.com/poli0981/free-steam-games-list/actions/workflows/codeql.yml)
[![Quality Gate](https://sonarcloud.io/api/project_badges/measure?project=poli0981_free-steam-games-list&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=poli0981_free-steam-games-list)
[![Coverage](https://sonarcloud.io/api/project_badges/measure?project=poli0981_free-steam-games-list&metric=coverage)](https://sonarcloud.io/summary/new_code?id=poli0981_free-steam-games-list)
[![Dependabot](https://img.shields.io/badge/Dependabot-enabled-025E8C?style=flat&logo=dependabot)](.github/dependabot.yml)
[![Code: MIT](https://img.shields.io/badge/code-MIT-yellow?style=flat)](LICENSE)
[![Data: CC BY 4.0](https://img.shields.io/badge/data-CC%20BY%204.0-lightgrey?style=flat&logo=creativecommons)](LICENSE-DATA)
[![Node 26](https://img.shields.io/badge/Node-26-5FA04E?style=flat&logo=nodedotjs)](web/.node-version)
[![Python 3.15](https://img.shields.io/badge/Python-3.15-3776AB?style=flat&logo=python)](requirements.txt)
[![SvelteKit 3](https://img.shields.io/badge/SvelteKit-3-FF3E00?style=flat&logo=svelte)](web/README.md)
[![Tauri 2](https://img.shields.io/badge/Tauri-2-24C8D8?style=flat&logo=tauri)](web/src-tauri/TAURI.md)
![Visitors](https://visitor-badge.laobi.icu/badge?page_id=poli0981.free-steam-games-list)
[![Sponsor](https://img.shields.io/badge/Sponsor-Buy%20me%20a%20coffee-ff5f5f?style=flat&logo=buy-me-a-coffee)](.github/FUNDING.yml)
@@ -23,6 +39,23 @@ A **curated list** of free-to-play games on Steam — the badge above has today'
**Wallet safe (for now). Play at your own risk.**
### Project status
> [!NOTE]
> **Stable, maintenance only (since 2026-11-11).** The project does what it set
> out to do, so it is finished rather than abandoned: the pipeline keeps the
> list fresh every day, and the site and apps stay up.
>
> - **No new features.** Feature requests are not taken, as issues or as pull requests.
> - **Code changes only for** security advisories (CVEs), runtime and dependency
> updates, and whatever those break.
> - **Issues and pull requests are for the data:** adding a game, correcting
> one, removing one. Something broken or an accessibility barrier can still be
> reported; it gets a fix, not a redesign.
> - A vulnerability goes through [`SECURITY.md`](SECURITY.md), never a public issue.
>
> Details in [`CONTRIBUTING.md`](CONTRIBUTING.md).
### Quick links
| Surface | URL |
@@ -208,33 +241,34 @@ The site itself is deployed by Cloudflare Workers Builds, not by a workflow.
### Contribute
The repository is in [maintenance mode](#project-status): contributions are
about the **data**.
New games arrive on their own: `Discover New Games` sweeps the Steam store
daily, in every language, into a review queue, and the maintainer approves them at `/admin` — by
hand, or with an auto-approve rule that has a daily cap and is off until turned
on. Discovery only proposes, and every approved game is checked again by the
pipeline (free, a game, reachable) before it is published. Missing a free game
a few days after it went free? Post its store link in
[Discussions › Ideas](https://github.com/poli0981/free-steam-games-list/discussions/categories/ideas).
pipeline (free, a game, reachable) before it is published.
The companion browser extension, [steam-f2p-extension](https://github.com/poli0981/steam-f2p-extension),
is archived and no longer a way in.
**Issues** are for reports, not submissions:
[Bug report](.github/ISSUE_TEMPLATE/bug_report.yml),
[Accessibility barrier](.github/ISSUE_TEMPLATE/accessibility.yml),
[Feature request](.github/ISSUE_TEMPLATE/feature_request.yml),
[Delete game](.github/ISSUE_TEMPLATE/delete_game.yml),
[Feedback](.github/ISSUE_TEMPLATE/feedback.yml) and
[Off-topic](.github/ISSUE_TEMPLATE/off_topic.yml). All reviewed by hand.
**The manual way.** Fork, append store links to `scripts/temp_info.jsonl`, and open a pull request:
| You want to | Issue form | Or a pull request that |
| --- | --- | --- |
| **Add** a free game that is still missing a few days after it went free | [Add game](.github/ISSUE_TEMPLATE/add_game.yml) | appends its store link to `scripts/temp_info.jsonl` |
| **Correct** a published game (genre, type, anti-cheat, notes, safe) | [Edit game](.github/ISSUE_TEMPLATE/edit_game.yml) | adds an override with `python scripts/edit_game.py <appid> --set field=value --reason "…"` |
| **Remove** a game (paid now, not a game, malware, duplicate) | [Delete game](.github/ISSUE_TEMPLATE/delete_game.yml) | adds a blocklist line with `python scripts/delete_game.py <appid> --reason <code>` |
```jsonl
{"link": "730"}
{"link": "https://store.steampowered.com/app/570/"}
```
Accepts a full URL, short URL, or bare appid. A line is a link and nothing else: any other key is ignored, and the game is fetched from Steam. A correction to a published game (genre, anti-cheat, notes…) goes in a Discussion; the maintainer records it as an override.
A queued line accepts a full URL, short URL, or bare appid, and is a link and nothing else: any other key is ignored, and the game is fetched from Steam. Never edit `data/data_*.jsonl` or `data/index.json` by hand: the pipeline rewrites them, and an edit there is lost.
Two more forms stay open, for things that are broken rather than wished for:
[Bug report](.github/ISSUE_TEMPLATE/bug_report.yml) and
[Accessibility barrier](.github/ISSUE_TEMPLATE/accessibility.yml). All reviewed by hand.
The companion browser extension, [steam-f2p-extension](https://github.com/poli0981/steam-f2p-extension),
is archived and no longer a way in.
See [CONTRIBUTING.md](CONTRIBUTING.md) for the full flow.
@@ -247,6 +281,7 @@ Unemployed, introvert max level, dropped out uni year 3, mooching off family. Ne
- v2.1 was spaghetti with proper seasoning. It got a scraper.
- v3.0 was spaghetti with a website on top, a desktop app, and bilingual menus.
- **v4.0 is the same spaghetti, rebuilt, with a review queue so it stops needing to be cooked by hand.** Still a hobby.
- v4.7 is where the cooking stops: the dish is served, and from here it is only kept warm.
> [!WARNING]
> **Disclaimer.** Quality / fun / safety: who knows. The maintainer only vouches for games personally played (`safe` column: `y` = yes, `?` = dunno, `n` = nope). Problems with a game are between you, Valve, and the developer of that game — not the maintainer. See [`docs/DISCLAIMER.md`](docs/DISCLAIMER.md) for the specific accuracy caveats.
@@ -255,7 +290,7 @@ Unemployed, introvert max level, dropped out uni year 3, mooching off family. Ne
- [AUTHORS](AUTHORS.md) — maintainer + canonical handle map + AI-assistant disclosure.
- [CHANGELOG](CHANGELOG.md) — what changed in each version.
- [CONTRIBUTING](CONTRIBUTING.md) — issue templates, suggesting a game, manual fork.
- [CONTRIBUTING](CONTRIBUTING.md) — maintenance mode, what is accepted, and how to add, correct or remove a game.
- [PC spec](docs/pc_spec.md) ([VI](docs/i18n/vi/pc_spec.md)) — maintainer's dev hardware + test devices.
- [Dev environment](docs/dev_env.md) ([VI](docs/i18n/vi/dev_env.md)) — IDE, toolchains (Python 3.15 / Node 26 / TypeScript 7 / Rust stable / Tauri 2), workflow.
- [Tauri build](web/src-tauri/TAURI.md) — desktop build prerequisites + signing + auto-update.
+6
View File
@@ -96,3 +96,9 @@ broke are not a joke. Credit in `docs/ACKNOWLEDGEMENTs.md` if you want it.
The deployed site and `main` are the only supported versions. Desktop and
Android releases are supported at the latest tag only; there are no backports.
The project is stable and in maintenance mode (see
[`CONTRIBUTING.md`](CONTRIBUTING.md)): no new features are developed, and
security fixes and runtime / dependency updates are exactly what it is still
maintained for. Dependabot, CodeQL and SonarCloud keep running, and a fix
ships as a new site deploy and, when the apps are affected, a new app release.
+9 -5
View File
@@ -44,12 +44,16 @@ half of which I never checked.
**Adding a F2P game to the list?** Don’t DM me about it. New free games are
found on Steam automatically every day and reviewed before they are listed. If
one is still missing a few days after it went free, post its store link in
[Discussions › Ideas](https://github.com/poli0981/free-steam-games-list/discussions/categories/ideas).
The browser extension is archived, and the Telegram bot and the issue template
are gone; if you read about whitelisting a Telegram `user_id` somewhere, that
one is still missing a few days after it went free, use the
[Add games](https://github.com/poli0981/free-steam-games-list/issues/new?template=add_game.yml)
form; a wrong genre or anti-cheat has
[Edit game](https://github.com/poli0981/free-steam-games-list/issues/new?template=edit_game.yml).
The project is stable and in maintenance mode, so those data forms, bug
reports and accessibility reports are what issues are for; feature requests
are not taken.
The browser extension is archived and the Telegram bot is gone; if you read about whitelisting a Telegram `user_id` somewhere, that
doc is stale.
Or open an issue here (Wiki first, or gentle RTFM). Luck’s on your side.
Anything else: [Discussions](https://github.com/poli0981/free-steam-games-list/discussions) (gentle RTFM first). Luck’s on your side.
Thanks for peeking behind the curtain. Make the web (and life) less annoying.
+2 -1
View File
@@ -368,7 +368,8 @@
"maintainerBlurb": "One Vietnamese developer, running this in spare time.",
"legalBlurb": "Code, docs and this web app are MIT-licensed. The dataset is licensed separately under CC BY 4.0. Each document is rendered here from the repository.",
"tplBug": "Bug report",
"tplFeature": "Feature request",
"tplAdd": "Add a game",
"tplEdit": "Correct a game",
"tplDelete": "Delete a game",
"tplAccessibility": "Accessibility barrier",
"a11yBlurb": "Can't use something here with a keyboard, a screen reader or zoom? The accessibility form is for that, and you don't have to say anything about yourself. The statement lists what works today and what doesn't yet.",
+2 -1
View File
@@ -368,7 +368,8 @@
"maintainerBlurb": "Một lập trình viên Việt Nam, làm dự án này lúc rảnh.",
"legalBlurb": "Mã nguồn, tài liệu và ứng dụng web theo giấy phép MIT. Bộ dữ liệu theo giấy phép riêng CC BY 4.0. Mỗi tài liệu được kết xuất tại đây từ kho mã.",
"tplBug": "Báo lỗi",
"tplFeature": "Đề xuất tính năng",
"tplAdd": "Thêm một game",
"tplEdit": "Sửa thông tin game",
"tplDelete": "Xóa một game",
"tplAccessibility": "Rào cản tiếp cận",
"a11yBlurb": "Có chỗ nào ở đây không dùng được bằng bàn phím, trình đọc màn hình hay khi phóng to? Form về khả năng tiếp cận là để báo việc đó, và bạn không cần nói gì về bản thân. Bản tuyên bố liệt kê những gì đã dùng được và những gì chưa.",
+5 -2
View File
@@ -5,6 +5,8 @@
import ExternalLink from "@lucide/svelte/icons/external-link";
import Scale from "@lucide/svelte/icons/scale";
import Sparkles from "@lucide/svelte/icons/sparkles";
import Plus from "@lucide/svelte/icons/plus";
import Pencil from "@lucide/svelte/icons/pencil";
import TriangleAlert from "@lucide/svelte/icons/triangle-alert";
import FileText from "@lucide/svelte/icons/file-text";
import Bug from "@lucide/svelte/icons/bug";
@@ -70,9 +72,10 @@
];
const ISSUE_TEMPLATES = $derived([
{ id: "bug_report", label: t("about.tplBug"), icon: Bug },
{ id: "feature_request", label: t("about.tplFeature"), icon: Sparkles },
{ id: "add_game", label: t("about.tplAdd"), icon: Plus },
{ id: "edit_game", label: t("about.tplEdit"), icon: Pencil },
{ id: "delete_game", label: t("about.tplDelete"), icon: TriangleAlert },
{ id: "bug_report", label: t("about.tplBug"), icon: Bug },
{ id: "accessibility", label: t("about.tplAccessibility"), icon: Accessibility },
]);
</script>