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>
This commit is contained in:
1 parent
dddb6e41c2
commit
0e0e442de5
55 files changed
+599
-369
No files matched your search
@@ -1,5 +1,5 @@
|
|||||||
name: 🐛 Bug Report
|
name: 🛠️ Report a problem (wrong data, something broke)
|
||||||
description: Report a bug on the website, in the desktop/Android app, in the game data, or in the scripts
|
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] "
|
title: "[Bug] "
|
||||||
labels: ["bug"]
|
labels: ["bug"]
|
||||||
body:
|
body:
|
||||||
@@ -8,6 +8,8 @@ body:
|
|||||||
value: |
|
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.
|
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.
|
**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.
|
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.
|
Something doesn't work with your keyboard, screen reader, zoom or contrast settings? The "Accessibility barrier" template asks the right questions.
|
||||||
|
|||||||
@@ -6,3 +6,9 @@ contact_links:
|
|||||||
- name: 🔒 Report a security vulnerability (private)
|
- name: 🔒 Report a security vulnerability (private)
|
||||||
url: https://github.com/poli0981/free-games-itchio-list/security/advisories/new
|
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.
|
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
|
|
||||||
@@ -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,28 +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
|
|
||||||
- [ ] Touched the UI? It still works with the keyboard alone and a screen reader ([checklist](https://github.com/poli0981/free-games-itchio-list/blob/main/ACCESSIBILITY.md#8-for-contributors))
|
|
||||||
- [ ] 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,27 +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/ACCESSIBILITY/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>`
|
|
||||||
- [ ] Headings in order, link text that says where it goes, alt text for images, header cells in tables
|
|
||||||
- [ ] 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,31 +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
|
|
||||||
- [ ] UI changes pass the [accessibility checklist](https://github.com/poli0981/free-games-itchio-list/blob/main/ACCESSIBILITY.md#8-for-contributors): keyboard, focus, labels in `en.ts` + `vi.ts`, contrast (`npm test`), reduced motion, one screen-reader check
|
|
||||||
- [ ] 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. 🚀
|
|
||||||
@@ -1,6 +1,9 @@
|
|||||||
<!--
|
<!--
|
||||||
Thanks for the PR! For a more specific checklist, add ?template=bug_fix.md (or new_features.md,
|
The project is in maintenance mode (stable, no new features — see README → Project status).
|
||||||
documentation.md, add_games.md) to this page's address — they live in .github/PULL_REQUEST_TEMPLATE/.
|
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 and why
|
||||||
|
|||||||
@@ -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 }}
|
||||||
+2
-1
@@ -3,12 +3,13 @@
|
|||||||
All notable changes to this project, newest first. The notes of each release live in
|
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`.
|
[`changelog/`](changelog/), one file per minor version: `changelog/<major>.x/ver<major>.<minor>.x.md`.
|
||||||
|
|
||||||
**Latest release: [4.6.0](changelog/4.x/ver4.6.x.md#460---2026-11-09-accessibility) (2026-11-09) — Accessibility.**
|
**Latest release: [4.6.1](changelog/4.x/ver4.6.x.md#461---2026-11-11-stable-maintenance-mode) (2026-11-11) — Stable: maintenance mode.**
|
||||||
|
|
||||||
## 4.x
|
## 4.x
|
||||||
|
|
||||||
| Version | Date | Highlights |
|
| Version | Date | Highlights |
|
||||||
|---|---|---|
|
|---|---|---|
|
||||||
|
| [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.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.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.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) |
|
||||||
|
|||||||
@@ -8,7 +8,7 @@ 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:
|
everyone; the old github.io URL only redirects). Three layers share one JSON catalog:
|
||||||
|
|
||||||
1. **Python pipeline** — the data layer (GitHub Actions).
|
1. **Python pipeline** — the data layer (GitHub Actions).
|
||||||
- `data_game/game_info_NNN.json` — chunked records, max 500 per file, 5,818 games on 2026-11-09. 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, 5,907 games on 2026-11-11. 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.
|
- `data_game/index.json` — chunk manifest (total + per-file counts). `data_game/count_history.json` — date-keyed `{date,total}` series ("games over time" chart). `scripts/deleted_games.json` — removal log (public "Removed" page). `scripts/temp_link.json` — ingest queue.
|
||||||
- `scripts/` — scanners never write the catalog: `update_info.py` (queued URLs) and `refresh.py` (rotating 1/7-per-day check; `--full` re-scrape) emit a URL-keyed **patch** (`patch.py`); `apply_patch.py` applies it to the latest `main` and runs `validate.py`; `bash/commit_push.sh` does fetch → reset → apply → commit → push with retries. Shared: `scraper.py` (session, `Pacer` + 429 back-off, parsing: the info panel incl. itch.io's 2025–26 rows — `AI Disclosure` ("AI Assisted", then what for) / `Content` linking `/games/tag-no-ai` → `ai_disclosure` + `ai_content`, `Accessibility` → `accessibility`; `description` = the creator's tagline (`og:description`), else the first sentence), `data_store.py` (chunks stay in place, rebalance only past thresholds, write-if-changed), `json_io.py`, `canonical.py` (canonical itch.io URL; vectors in `tests/fixtures/url_vectors.json`, shared with the Worker). Pipeline bookkeeping lives in `scripts/state/` (not published), including `ingest_outcomes.json` (how each queued link ended — added / duplicate / paid / dead / private / deleted / gave_up; patch key `ingest_outcomes`; the last 90 days, ≤ 5,000) that the admin's tracking and the cron's reconcile read. Tests: `pytest` (network blocked; `pytest --cov --cov-report=xml` → `coverage.xml` for SonarQube Cloud, gotcha 41). Lint: `ruff check scripts tests webapp/scripts`, `ruff format`, `vulture` (config in root `pyproject.toml`). Local env: Python 3.15 (`.github/python-version`, gotcha 39; ruff `target-version = "py315"`), `python -m venv .venv && .venv/Scripts/pip install -r requirements-dev.txt` (3.15 is in UTF-8 mode by default — no `PYTHONUTF8` needed, the workflows no longer set it). Both requirements files are hash-locked pip-tools compiles of `requirements*.in` — edit the `.in`, then recompile (gotcha 40).
|
- `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.
|
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.
|
||||||
@@ -84,6 +84,7 @@ Each game has **20** fields (plus optional `added_at` / `updated_at`, appended b
|
|||||||
| `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. |
|
| `notify-failure.yml` | `workflow_call` | Discord (`DISCORD_CI_WEBHOOK`) on failure / **cancelled** (job-level timeouts end as cancelled) / rate-limited / mass change / failed Cloudflare build. |
|
||||||
| `python-ci.yml` / `webapp-ci.yml` | PRs (+ pushes for Python) | ruff + format + vulture + pytest + `validate.py` (both requirements locks installed at once, so drifting pins fail) / `npm ci --ignore-scripts` + `npm run check:tauri` (gotcha 31) + `npm run cf:types -- --check` + lint + knip + vitest + build + `npm run cf:check` (`wrangler deploy --dry-run`). SonarQube Cloud runs in `sonarcloud.yml`. |
|
| `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). |
|
| `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). |
|
| `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_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`. |
|
| `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`. |
|
||||||
@@ -160,6 +161,7 @@ Code **MIT** (`LICENSE`); catalog data **CC BY 4.0** for the maintainer's contri
|
|||||||
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`).
|
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`).
|
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.
|
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
|
## Safe-edit rules
|
||||||
|
|
||||||
@@ -170,6 +172,10 @@ Code **MIT** (`LICENSE`); catalog data **CC BY 4.0** for the maintainer's contri
|
|||||||
|
|
||||||
## Current state (Nov 2026)
|
## Current state (Nov 2026)
|
||||||
|
|
||||||
|
**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.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.
|
**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** (shipped in 4.6.0; the catalog had 5,818 games on 2026-11-09). 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`):
|
**Deps sweeps since v4.5.0** (shipped in 4.6.0; the catalog had 5,818 games on 2026-11-09). 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`):
|
||||||
|
|||||||
+33
-25
@@ -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.
|
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)
|
## 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!)
|
### 1. Suggest New Games (Most Welcome!)
|
||||||
|
|
||||||
@@ -15,7 +23,7 @@ Games go through the website; everything else goes through the GitHub issue/PR t
|
|||||||
- 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.
|
- 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.
|
- 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
|
#### 1b. Other ways games get in
|
||||||
|
|
||||||
@@ -32,44 +40,42 @@ 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.
|
- 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.
|
- 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.
|
- 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).
|
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.
|
- Open an issue → **[Report a problem]** template ([direct link](https://github.com/poli0981/free-games-itchio-list/issues/new?template=bug_report.yml)).
|
||||||
- Checkboxes for common bugs (dead links, wrong flags, broken page, etc.).
|
- 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.
|
- Details + screenshots + urgency level.
|
||||||
- **Security problems are not bugs for the public tracker.** Report them privately: see [SECURITY.md](SECURITY.md).
|
- **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).
|
- **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).
|
||||||
- If it's complex, see "Discuss More" below.
|
|
||||||
|
|
||||||
### 4. Suggest Features or Improvements
|
### 4. Features and Improvements (Closed)
|
||||||
|
|
||||||
- Open an issue → **[Feature Request / Improvement]** template.
|
- 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.
|
||||||
- Choose type (new feature or code fix), name, reason, priority (from "nice to have" to "repo dying").
|
- The code is MIT-licensed: you're welcome to fork it and build your own thing ([README → License](README.md#license)).
|
||||||
- Optional: pseudo-code/snippet (no malware pls, I'll check with my average skills :D).
|
|
||||||
|
|
||||||
### 5. Give Feedback
|
### 5. Feedback, Questions, Anything Else
|
||||||
|
|
||||||
- Use the **[Feedback]** template.
|
- 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.
|
||||||
- Checkboxes (EULA/ToS too strict? Repo concept bad? Anti-AI? Delete repo? Other).
|
- They are read, but they don't turn into new features (section 4).
|
||||||
- Roast or praise, my self-loathing can handle it.
|
|
||||||
|
|
||||||
### 6. Anything Else (Questions, Memes, Off-Topic)
|
### 6. Dependencies and Security Fixes
|
||||||
|
|
||||||
- Use the **[General / Off-Topic]** template.
|
- Dependency updates are handled by Dependabot and the Maintainer's weekly sweep: please don't send version-bump PRs.
|
||||||
- Drop whatever's on your mind.
|
- 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]…).
|
- **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.
|
||||||
- Clear description, please. I'll review slowly (unemployed schedule + AI buddies).
|
- **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):
|
**PR rules** (the non-negotiable part):
|
||||||
|
|
||||||
- **CI must pass.** Python CI (ruff check + format, vulture, pytest, `validate.py`) and Webapp CI (Tauri crate/npm version check, type generation check, lint, knip, tests, build, `wrangler deploy --dry-run`) both run on PRs. Red CI = no merge. SonarQube Cloud also analyses each PR (with test coverage) and reports its quality gate as the "SonarCloud Code Analysis" check.
|
- **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): …`).
|
- **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.
|
- **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.
|
- **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.
|
||||||
@@ -81,6 +87,8 @@ Details live in the [Terms of Use](docs/ToS.md) and the [Disclaimer](docs/DISCLA
|
|||||||
|
|
||||||
### 8. Dev Setup (Summary)
|
### 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:
|
Full instructions (Worker, local D1, secrets, Tauri, Android) are in **[`docs/dev_env.md`](docs/dev_env.md)**; the Tauri/Android build notes are in [`webapp/TAURI.md`](webapp/TAURI.md). The short version:
|
||||||
|
|
||||||
**Python pipeline** (Python 3.15, see `.github/python-version`):
|
**Python pipeline** (Python 3.15, see `.github/python-version`):
|
||||||
@@ -125,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.
|
- **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.
|
- **Keep it clean**: only free itch.io games, no paid/demo/malware/duplicates.
|
||||||
- **Be patient**: I'm introvert + lazy, replies might be slow.
|
- **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).
|
- **Be cool**: everything here falls under the [Code of Conduct](CODE_OF_CONDUCT.md).
|
||||||
|
|
||||||
## Discuss More? (If Templates Aren't Enough)
|
## 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**
|
**Chat / community**
|
||||||
- Discord: Repo discussion (#general): https://discord.gg/2aNR3aVt
|
- Discord: Repo discussion (#general): https://discord.gg/2aNR3aVt
|
||||||
|
|||||||
@@ -1,22 +1,42 @@
|
|||||||
# Free Itch.io Games List
|
# Free Itch.io Games List
|
||||||
|
|
||||||
[](https://github.com/poli0981/free-games-itchio-list/releases/latest)
|
[](https://github.com/poli0981/free-games-itchio-list/releases/latest)
|
||||||
|
[](#project-status)
|
||||||
[](https://freeitchgames.win)
|
[](https://freeitchgames.win)
|
||||||
[](https://github.com/poli0981/free-games-itchio-list/stargazers)
|
[](https://github.com/poli0981/free-games-itchio-list/stargazers)
|
||||||
[](https://github.com/poli0981/free-games-itchio-list/network/members)
|
[](https://github.com/poli0981/free-games-itchio-list/network/members)
|
||||||
[](https://github.com/poli0981/free-games-itchio-list/commits/main)
|
[](https://github.com/poli0981/free-games-itchio-list/commits/main)
|
||||||
|
[](https://github.com/poli0981/free-games-itchio-list/actions/workflows/python-ci.yml)
|
||||||
|
[](https://sonarcloud.io/summary/new_code?id=poli0981_free-games-itchio-list)
|
||||||
|
[](https://sonarcloud.io/summary/new_code?id=poli0981_free-games-itchio-list)
|
||||||
|
[](https://github.com/poli0981/free-games-itchio-list/actions/workflows/qodana.yml)
|
||||||
|
[](ACCESSIBILITY.md)
|
||||||
[](LICENSE)
|
[](LICENSE)
|
||||||
[](data_game/LICENSE.md)
|
[](data_game/LICENSE.md)
|
||||||
[](README.vi.md)
|
[](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.
|
> 🇻🇳 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 **5,900+ 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
|
**<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.
|
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
|
## Table of contents
|
||||||
|
|
||||||
|
- [Project status](#project-status)
|
||||||
- [Browse the catalog](#browse-the-catalog)
|
- [Browse the catalog](#browse-the-catalog)
|
||||||
- [Desktop and Android apps](#desktop-and-android-apps)
|
- [Desktop and Android apps](#desktop-and-android-apps)
|
||||||
- [Add a game](#add-a-game)
|
- [Add a game](#add-a-game)
|
||||||
@@ -239,6 +259,7 @@ docs/ # Policies, dev environment, third-party list (+ Vietnam
|
|||||||
| Force update (`force_update.yml`) | Manual | Re-scrape every field (one URL or the next batch); keeps `safe_virus` / `notes` / `nsfw` |
|
| Force update (`force_update.yml`) | Manual | Re-scrape every field (one URL or the next batch); keeps `safe_virus` / `notes` / `nsfw` |
|
||||||
| RSS discovery and automatic rules (Cloudflare Worker) | Every 4 hours | Poll one itch.io feed per run into the review queue; auto-approve unflagged items after the waiting time; queue new free games of followed collections |
|
| 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 |
|
| 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 |
|
| 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 |
|
| 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 |
|
| Release desktop / Android | On `v*` tag push | Tauri installers (Win/macOS/Linux) and signed APK → draft Release |
|
||||||
@@ -289,10 +310,13 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for the full guide.
|
|||||||
- **Add games**: use the [Suggest page](https://freeitchgames.win/suggest).
|
- **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 / 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).
|
["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.
|
- **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
|
- **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).
|
contact@poli0981.dev. See [ACCESSIBILITY.md](ACCESSIBILITY.md).
|
||||||
- **Request features**: use the "Feature Request / Improvement" template, or send a PR.
|
- **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).
|
- **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.
|
- **Privacy questions**: see the [Privacy Policy](docs/PrivacyPolicy.md) or email privacy@poli0981.dev.
|
||||||
- Please follow the [Code of Conduct](CODE_OF_CONDUCT.md).
|
- Please follow the [Code of Conduct](CODE_OF_CONDUCT.md).
|
||||||
|
|||||||
+21
-5
@@ -1,22 +1,37 @@
|
|||||||
# Danh sách Game Itch.io Miễn Phí
|
# Danh sách Game Itch.io Miễn Phí
|
||||||
|
|
||||||
[](https://github.com/poli0981/free-games-itchio-list/releases/latest)
|
[](https://github.com/poli0981/free-games-itchio-list/releases/latest)
|
||||||
|
[](#trạng-thái-dự-án)
|
||||||
[](https://freeitchgames.win)
|
[](https://freeitchgames.win)
|
||||||
[](https://github.com/poli0981/free-games-itchio-list/stargazers)
|
[](https://github.com/poli0981/free-games-itchio-list/stargazers)
|
||||||
[](https://github.com/poli0981/free-games-itchio-list/network/members)
|
[](https://github.com/poli0981/free-games-itchio-list/network/members)
|
||||||
[](https://github.com/poli0981/free-games-itchio-list/commits/main)
|
[](https://github.com/poli0981/free-games-itchio-list/commits/main)
|
||||||
|
[](https://github.com/poli0981/free-games-itchio-list/actions/workflows/python-ci.yml)
|
||||||
|
[](https://sonarcloud.io/summary/new_code?id=poli0981_free-games-itchio-list)
|
||||||
|
[](https://sonarcloud.io/summary/new_code?id=poli0981_free-games-itchio-list)
|
||||||
|
[](https://github.com/poli0981/free-games-itchio-list/actions/workflows/qodana.yml)
|
||||||
|
[](docs/i18n/vi/ACCESSIBILITY.md)
|
||||||
[](LICENSE)
|
[](LICENSE)
|
||||||
[](data_game/LICENSE.md)
|
[](data_game/LICENSE.md)
|
||||||
[](README.md)
|
[](README.md)
|
||||||
|
|
||||||
> 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 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/).
|
> 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 5,900 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
|
## 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)
|
- [Duyệt danh mục](#duyệt-danh-mục)
|
||||||
- [Ứng dụng desktop và Android](#ứng-dụng-desktop-và-android)
|
- [Ứng dụng desktop và Android](#ứng-dụng-desktop-và-android)
|
||||||
- [Thêm game](#thêm-game)
|
- [Thêm game](#thêm-game)
|
||||||
@@ -177,6 +192,7 @@ docs/ # Chính sách, môi trường dev, danh sách bên th
|
|||||||
| 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` |
|
| Force update (`force_update.yml`) | Thủ công | Cào lại mọi trường (một URL hoặc lô tiếp theo); giữ nguyên `safe_virus` / `notes` / `nsfw` |
|
||||||
| Phát hiện qua RSS và quy tắc tự động (Cloudflare Worker) | Mỗi 4 giờ | Đọc một feed itch.io mỗi lượt vào hàng chờ duyệt; tự duyệt mục không có cờ sau thời gian chờ; đưa game miễn phí mới của collection được theo dõi vào hàng chờ ingest |
|
| 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 |
|
| 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 |
|
| 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 |
|
| 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 |
|
| Release desktop / Android | Khi push tag `v*` | Trình cài đặt Tauri (Win/macOS/Linux) và APK đã ký → draft Release |
|
||||||
@@ -221,9 +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).
|
- **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).
|
- **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".
|
- **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)).
|
- **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)).
|
||||||
- **Đề xuất tính năng**: dùng template "Feature Request / Improvement", hoặc gửi PR.
|
- **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)).
|
- **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.
|
- **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)).
|
- Vui lòng tuân thủ [Quy tắc ứng xử](docs/i18n/vi/CODE_OF_CONDUCT.md) ([EN](CODE_OF_CONDUCT.md)).
|
||||||
|
|||||||
+3
-1
@@ -1,6 +1,6 @@
|
|||||||
# Security Policy
|
# Security Policy
|
||||||
|
|
||||||
Last updated: 2026-10-27
|
Last updated: 2026-11-11
|
||||||
|
|
||||||
Applies from: the release of version 4.0.0.
|
Applies from: the release of version 4.0.0.
|
||||||
|
|
||||||
@@ -49,6 +49,8 @@ The browser extension (poli0981/itch-f2p-extension) and the Telegram bot (poli09
|
|||||||
|
|
||||||
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.
|
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
|
## 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.
|
- **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.
|
||||||
|
|||||||
@@ -1,6 +1,66 @@
|
|||||||
# Changelog — 4.6.x
|
# Changelog — 4.6.x
|
||||||
|
|
||||||
Release notes for 4.6.0, newest first. Every version: [CHANGELOG.md](../../CHANGELOG.md).
|
Release notes for 4.6.0 – 4.6.1, newest first. Every version: [CHANGELOG.md](../../CHANGELOG.md).
|
||||||
|
|
||||||
|
## [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)
|
## [4.6.0] - 2026-11-09 (Accessibility)
|
||||||
|
|
||||||
|
|||||||
+3
-2
@@ -69,7 +69,7 @@ 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](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-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 |
|
| [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,
|
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.
|
WKWebView on macOS (Safari/WebKit 16.4 or later), WebKitGTK on Linux and Android System WebView on Android.
|
||||||
@@ -128,7 +128,7 @@ 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`,
|
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/setup-python`, `actions/setup-java`, `actions/cache`, `actions/upload-artifact`,
|
||||||
`actions/download-artifact`, `android-actions/setup-android`, `dtolnay/rust-toolchain`,
|
`actions/download-artifact`, `android-actions/setup-android`, `dtolnay/rust-toolchain`,
|
||||||
`tauri-apps/tauri-action`, `SonarSource/sonarqube-scan-action` and reusable workflows from
|
`tauri-apps/tauri-action`, `SonarSource/sonarqube-scan-action`, `JetBrains/qodana-action` and reusable workflows from
|
||||||
[poli0981/.github](https://github.com/poli0981/.github).
|
[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
|
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.
|
distributed with the project; each one is under the license in its own repository.
|
||||||
@@ -141,6 +141,7 @@ distributed with the project; each one is under the license in its own repositor
|
|||||||
| **Google Workspace** | The Maintainer's mailbox on poli0981.dev, which receives the project's contact addresses |
|
| **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 |
|
| **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 |
|
| **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 |
|
| **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 |
|
| **Discord** | Receives automated CI and release notifications only |
|
||||||
|
|
||||||
|
|||||||
@@ -186,6 +186,10 @@ npm run cf:check # wrangler deploy --dry-run: validates th
|
|||||||
`npm run test:coverage` runs the tests with v8 coverage and writes `coverage/lcov.info`, as the
|
`npm run test:coverage` runs the tests with v8 coverage and writes `coverage/lcov.info`, as the
|
||||||
SonarQube Cloud workflow (`sonarcloud.yml`) does.
|
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
|
After editing `wrangler.jsonc`, run `npm run cf:types` and commit the regenerated
|
||||||
`worker-configuration.d.ts`.
|
`worker-configuration.d.ts`.
|
||||||
|
|
||||||
|
|||||||
@@ -1,14 +1,22 @@
|
|||||||
# Hướng dẫn đóng góp
|
# Hướng dẫn đóng góp
|
||||||
|
|
||||||
> 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 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.
|
> 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.
|
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)
|
## 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!)
|
### 1. Đề xuất game mới (Hoan nghênh nhất!)
|
||||||
|
|
||||||
@@ -19,7 +27,7 @@ Game thì gửi qua website; mọi thứ khác thì qua các template issue/PR t
|
|||||||
- 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.
|
- 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.
|
- 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
|
#### 1b. Những cách khác để game được thêm vào
|
||||||
|
|
||||||
@@ -36,44 +44,42 @@ RSS feed vào cùng hàng chờ duyệt với trang Suggest. (Extension trình d
|
|||||||
- 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.
|
- 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.
|
- 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ý.
|
- 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).
|
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]**.
|
- 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)).
|
||||||
- Checkbox cho các lỗi thường gặp (link chết, cờ sai, trang hỏng, v.v.).
|
- 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.
|
- 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).
|
- **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).
|
- **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).
|
||||||
- Nếu phức tạp, xem mục "Muốn thảo luận thêm?" bên dưới.
|
|
||||||
|
|
||||||
### 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]**.
|
- 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.
|
||||||
- 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").
|
- 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)).
|
||||||
- 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).
|
|
||||||
|
|
||||||
### 5. Gửi góp ý
|
### 5. Góp ý, câu hỏi, mọi thứ khác
|
||||||
|
|
||||||
- Dùng template **[Feedback]**.
|
- 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.
|
||||||
- Checkbox (EULA/ToS quá khắt khe? Concept repo dở? Anti-AI? Xóa repo? Khác).
|
- Tôi có đọc, nhưng chúng không biến thành tính năng mới (mục 4).
|
||||||
- Chê hay khen đều được, sự tự ti của tôi chịu được.
|
|
||||||
|
|
||||||
### 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]**.
|
- 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.
|
||||||
- Có gì trong đầu cứ đăng.
|
- 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]…).
|
- **Đượ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.
|
||||||
- Mô tả rõ ràng giúp nhé. Tôi sẽ review chậm (lịch thất nghiệp + hai AI buddy).
|
- **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):
|
**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 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".
|
- **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): …`).
|
- **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.
|
- **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 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 đủ.
|
||||||
@@ -85,6 +91,8 @@ Chi tiết có trong [Điều khoản sử dụng](ToS.md) và [Tuyên bố mi
|
|||||||
|
|
||||||
### 8. Thiết lập môi trường dev (tóm tắt)
|
### 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:
|
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.15, xem `.github/python-version`):
|
**Pipeline Python** (Python 3.15, xem `.github/python-version`):
|
||||||
@@ -129,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 đó.
|
- **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.
|
- **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.
|
- **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).
|
- **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 đủ)
|
## 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**
|
**Chat / cộng đồng**
|
||||||
- Discord: Repo discussion (#general): https://discord.gg/2aNR3aVt
|
- Discord: Repo discussion (#general): https://discord.gg/2aNR3aVt
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
# Chính sách bảo mật (Security Policy)
|
# Chính sách bảo mật (Security Policy)
|
||||||
|
|
||||||
Cập nhật lần cuối: 2026-10-27
|
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.
|
Áp dụng từ: khi phát hành phiên bản 4.0.0.
|
||||||
|
|
||||||
@@ -51,6 +51,8 @@ Tiện ích trình duyệt (poli0981/itch-f2p-extension) và Telegram bot (poli0
|
|||||||
|
|
||||||
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.
|
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
|
## 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.
|
- **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.
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
# Môi trường phát triển
|
# 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-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 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ả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.
|
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.
|
||||||
@@ -187,6 +187,10 @@ npm run cf:check # wrangler deploy --dry-run: kiểm tra c
|
|||||||
`npm run test:coverage` chạy test kèm coverage v8 và ghi `coverage/lcov.info`, giống workflow
|
`npm run test:coverage` chạy test kèm coverage v8 và ghi `coverage/lcov.info`, giống workflow
|
||||||
SonarQube Cloud (`sonarcloud.yml`).
|
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
|
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.
|
được tạo lại.
|
||||||
|
|
||||||
|
|||||||
@@ -206,6 +206,16 @@ Do these once (and again with the `-staging` names for the staging Worker).
|
|||||||
`GH_TOKEN`, `TELEGRAM_BOT_TOKEN` and the three `DISCUSSION_*` secrets, which no workflow used any
|
`GH_TOKEN`, `TELEGRAM_BOT_TOKEN` and the three `DISCUSSION_*` secrets, which no workflow used any
|
||||||
more, were deleted on 2026-10-16.
|
more, were deleted on 2026-10-16.
|
||||||
4. **Signing key**: the old key `03F965C2E2DB5C6B` was exposed; sign with the replacement key.
|
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
|
## 3. Releasing a version
|
||||||
|
|
||||||
@@ -231,6 +241,10 @@ Do these once (and again with the `-staging` names for the staging Worker).
|
|||||||
|
|
||||||
## 4. Routine
|
## 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
|
- **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
|
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`.
|
are real, dispatch **Refresh catalog** with `allow_mass_removal`.
|
||||||
|
|||||||
+36
@@ -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
|
||||||
+2
-2
@@ -150,7 +150,7 @@ def select_targets(
|
|||||||
first_urls = {g["url"] for g in first}
|
first_urls = {g["url"] for g in first}
|
||||||
rest = sorted(
|
rest = sorted(
|
||||||
(g for g in games if g["url"] not in first_urls),
|
(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]
|
return (first + rest)[:budget]
|
||||||
|
|
||||||
@@ -299,7 +299,7 @@ def _write_outputs(stats: dict) -> None:
|
|||||||
("Errors / parse failures", f"{stats['errors']} / {stats['parse_fail']}"),
|
("Errors / parse failures", f"{stats['errors']} / {stats['parse_fail']}"),
|
||||||
("HTTP 429/503", stats["http_429"]),
|
("HTTP 429/503", stats["http_429"]),
|
||||||
("Stopped", stats["stopped"] or "completed"),
|
("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:
|
with open(summary, "a", encoding="utf-8") as f:
|
||||||
f.write("### Catalog refresh\n\n| | |\n|---|---|\n")
|
f.write("### Catalog refresh\n\n| | |\n|---|---|\n")
|
||||||
|
|||||||
@@ -167,7 +167,6 @@ def main(argv: list[str] | None = None) -> None:
|
|||||||
stats["retry"] += 1
|
stats["retry"] += 1
|
||||||
continue
|
continue
|
||||||
|
|
||||||
outcome = ""
|
|
||||||
if page.status == 200 and page.soup is not None and is_password_protected(page.soup):
|
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
|
outcome = "private" # final: nobody can open it, so retrying won't help
|
||||||
elif page.status == 200 and page.soup is not None:
|
elif page.status == 200 and page.soup is not None:
|
||||||
|
|||||||
Generated
+2
-2
@@ -1,12 +1,12 @@
|
|||||||
{
|
{
|
||||||
"name": "webapp",
|
"name": "webapp",
|
||||||
"version": "4.6.0",
|
"version": "4.6.1",
|
||||||
"lockfileVersion": 3,
|
"lockfileVersion": 3,
|
||||||
"requires": true,
|
"requires": true,
|
||||||
"packages": {
|
"packages": {
|
||||||
"": {
|
"": {
|
||||||
"name": "webapp",
|
"name": "webapp",
|
||||||
"version": "4.6.0",
|
"version": "4.6.1",
|
||||||
"license": "MIT",
|
"license": "MIT",
|
||||||
"dependencies": {
|
"dependencies": {
|
||||||
"@fontsource-variable/geist": "^5.3.0",
|
"@fontsource-variable/geist": "^5.3.0",
|
||||||
|
|||||||
+1
-1
@@ -1,7 +1,7 @@
|
|||||||
{
|
{
|
||||||
"name": "webapp",
|
"name": "webapp",
|
||||||
"private": true,
|
"private": true,
|
||||||
"version": "4.6.0",
|
"version": "4.6.1",
|
||||||
"license": "MIT",
|
"license": "MIT",
|
||||||
"type": "module",
|
"type": "module",
|
||||||
"engines": {
|
"engines": {
|
||||||
|
|||||||
@@ -0,0 +1,34 @@
|
|||||||
|
# Qodana for JavaScript / TypeScript: the web app, the admin app, the Worker
|
||||||
|
# and the build scripts. Run by .github/workflows/qodana.yml (job
|
||||||
|
# `typescript`), reported to https://qodana.cloud/projects/wwgZ1.
|
||||||
|
version: "1.0"
|
||||||
|
linter: qodana-js
|
||||||
|
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:
|
||||||
|
# Build output and reports.
|
||||||
|
- dist
|
||||||
|
- coverage
|
||||||
|
# Generated by `npm run cf:types`.
|
||||||
|
- worker-configuration.d.ts
|
||||||
|
# The Tauri shell is the Rust project (src-tauri/qodana.yaml).
|
||||||
|
- src-tauri
|
||||||
|
# A Worker handler throws to its own catch on purpose: one place turns every
|
||||||
|
# failure into the response (worker/gate.ts, worker/suggest.ts).
|
||||||
|
- name: ExceptionCaughtLocallyJS
|
||||||
|
# The escapes of } and ] stay: without them a pattern only parses in
|
||||||
|
# non-unicode (Annex B) mode.
|
||||||
|
- name: RegExpRedundantEscape
|
||||||
|
# Catalog strings with typographic apostrophes are used as object keys.
|
||||||
|
- name: JSNonASCIINames
|
||||||
|
# The Node test scripts import by relative path: the @/ alias is Vite's.
|
||||||
|
- name: ES6PreferShortImport
|
||||||
|
paths:
|
||||||
|
- scripts
|
||||||
Generated
+1
-2
@@ -1027,10 +1027,9 @@ dependencies = [
|
|||||||
|
|
||||||
[[package]]
|
[[package]]
|
||||||
name = "free-games-itchio-webapp"
|
name = "free-games-itchio-webapp"
|
||||||
version = "4.6.0"
|
version = "4.6.1"
|
||||||
dependencies = [
|
dependencies = [
|
||||||
"serde",
|
"serde",
|
||||||
"serde_json",
|
|
||||||
"tauri",
|
"tauri",
|
||||||
"tauri-build",
|
"tauri-build",
|
||||||
"tauri-plugin-opener",
|
"tauri-plugin-opener",
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
[package]
|
[package]
|
||||||
name = "free-games-itchio-webapp"
|
name = "free-games-itchio-webapp"
|
||||||
version = "4.6.0"
|
version = "4.6.1"
|
||||||
description = "Itch.io free games catalog viewer"
|
description = "Itch.io free games catalog viewer"
|
||||||
authors = ["poli0981"]
|
authors = ["poli0981"]
|
||||||
license = "MIT"
|
license = "MIT"
|
||||||
@@ -19,7 +19,6 @@ tauri-build = { version = "2", features = [] }
|
|||||||
tauri = { version = "2", features = [] }
|
tauri = { version = "2", features = [] }
|
||||||
tauri-plugin-opener = "2"
|
tauri-plugin-opener = "2"
|
||||||
serde = { version = "1", features = ["derive"] }
|
serde = { version = "1", features = ["derive"] }
|
||||||
serde_json = "1"
|
|
||||||
|
|
||||||
[target.'cfg(not(any(target_os = "android", target_os = "ios")))'.dependencies]
|
[target.'cfg(not(any(target_os = "android", target_os = "ios")))'.dependencies]
|
||||||
tauri-plugin-single-instance = "2"
|
tauri-plugin-single-instance = "2"
|
||||||
|
|||||||
@@ -0,0 +1,23 @@
|
|||||||
|
# Qodana for Rust (Early Access): the Tauri shell of the desktop and Android
|
||||||
|
# apps. Run by .github/workflows/qodana.yml (job `rust`), reported to
|
||||||
|
# https://qodana.cloud/projects/P2Rd7.
|
||||||
|
version: "1.0"
|
||||||
|
linter: qodana-rust
|
||||||
|
profile:
|
||||||
|
name: qodana.recommended
|
||||||
|
# The quality gate: any problem fails the job (and turns the README badge red).
|
||||||
|
failureConditions:
|
||||||
|
severityThresholds:
|
||||||
|
any: 0
|
||||||
|
# The linter evaluates build scripts and expands macros with `cargo check`,
|
||||||
|
# and its image has neither a C linker nor the libraries Tauri links against.
|
||||||
|
# Needs root in the container (the workflow passes `-u root`).
|
||||||
|
bootstrap: |
|
||||||
|
apt-get update -qq
|
||||||
|
DEBIAN_FRONTEND=noninteractive apt-get install -y -qq --no-install-recommends build-essential pkg-config libwebkit2gtk-4.1-dev libayatana-appindicator3-dev librsvg2-dev libssl-dev libxdo-dev
|
||||||
|
exclude:
|
||||||
|
- name: All
|
||||||
|
paths:
|
||||||
|
# Build output and the generated Android project.
|
||||||
|
- target
|
||||||
|
- gen
|
||||||
@@ -1,7 +1,7 @@
|
|||||||
{
|
{
|
||||||
"$schema": "https://schema.tauri.app/config/2",
|
"$schema": "https://schema.tauri.app/config/2",
|
||||||
"productName": "Itch.io Free Games DB",
|
"productName": "Itch.io Free Games DB",
|
||||||
"version": "4.6.0",
|
"version": "4.6.1",
|
||||||
"identifier": "com.poli0981.freegamesitchio",
|
"identifier": "com.poli0981.freegamesitchio",
|
||||||
"build": {
|
"build": {
|
||||||
"beforeDevCommand": "npm run dev",
|
"beforeDevCommand": "npm run dev",
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
import { useMemo } from 'react'
|
import { useMemo } from 'react'
|
||||||
import { Cell, Legend, Pie, PieChart, ResponsiveContainer, Tooltip } from 'recharts'
|
import { Legend, Pie, PieChart, ResponsiveContainer, Tooltip } from 'recharts'
|
||||||
import { aiLabel } from '@/lib/ai-disclosure'
|
import { aiLabel } from '@/lib/ai-disclosure'
|
||||||
import { aiDisclosureCounts } from '@/lib/analytics'
|
import { aiDisclosureCounts } from '@/lib/analytics'
|
||||||
import { tableRows } from '@/lib/chart-table'
|
import { tableRows } from '@/lib/chart-table'
|
||||||
@@ -21,7 +21,12 @@ const COLOR: Record<string, string> = {
|
|||||||
export function AiDisclosureChart({ games }: { games: Game[] }) {
|
export function AiDisclosureChart({ games }: { games: Game[] }) {
|
||||||
const t = useT()
|
const t = useT()
|
||||||
const data = useMemo(
|
const data = useMemo(
|
||||||
() => aiDisclosureCounts(games).map((e) => ({ ...e, label: aiLabel(e.key, t) })),
|
() =>
|
||||||
|
aiDisclosureCounts(games).map((e) => ({
|
||||||
|
...e,
|
||||||
|
label: aiLabel(e.key, t),
|
||||||
|
fill: COLOR[e.key] ?? PALETTE[8],
|
||||||
|
})),
|
||||||
[games, t],
|
[games, t],
|
||||||
)
|
)
|
||||||
const total = data.reduce((sum, d) => sum + d.count, 0)
|
const total = data.reduce((sum, d) => sum + d.count, 0)
|
||||||
@@ -51,11 +56,7 @@ export function AiDisclosureChart({ games }: { games: Game[] }) {
|
|||||||
outerRadius="80%"
|
outerRadius="80%"
|
||||||
paddingAngle={2}
|
paddingAngle={2}
|
||||||
stroke={SLICE_STROKE}
|
stroke={SLICE_STROKE}
|
||||||
>
|
/>
|
||||||
{data.map((d) => (
|
|
||||||
<Cell key={d.key} fill={COLOR[d.key] ?? PALETTE[8]} />
|
|
||||||
))}
|
|
||||||
</Pie>
|
|
||||||
<Tooltip {...TOOLTIP_BASE} content={<ChartTooltipContent total={total} />} />
|
<Tooltip {...TOOLTIP_BASE} content={<ChartTooltipContent total={total} />} />
|
||||||
{/* In the data's order: no AI, AI-assisted, not disclosed. */}
|
{/* In the data's order: no AI, AI-assisted, not disclosed. */}
|
||||||
<Legend {...LEGEND_BASE} />
|
<Legend {...LEGEND_BASE} />
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
import { useMemo } from 'react'
|
import { useMemo } from 'react'
|
||||||
import { Cell, Legend, Pie, PieChart, ResponsiveContainer, Tooltip } from 'recharts'
|
import { Legend, Pie, PieChart, ResponsiveContainer, Tooltip } from 'recharts'
|
||||||
import { deletionReasonCounts } from '@/lib/analytics'
|
import { deletionReasonCounts } from '@/lib/analytics'
|
||||||
import { tableRows } from '@/lib/chart-table'
|
import { tableRows } from '@/lib/chart-table'
|
||||||
import { useT } from '@/lib/i18n'
|
import { useT } from '@/lib/i18n'
|
||||||
@@ -7,11 +7,11 @@ import type { DeletedGameEntry } from '@/types/game'
|
|||||||
import { ChartCard } from './chart-card'
|
import { ChartCard } from './chart-card'
|
||||||
import { chartAria, LEGEND_BASE, SERIES_ANIMATION, SLICE_STROKE, TOOLTIP_BASE } from './chart-theme'
|
import { chartAria, LEGEND_BASE, SERIES_ANIMATION, SLICE_STROKE, TOOLTIP_BASE } from './chart-theme'
|
||||||
import { ChartTooltipContent } from './chart-tooltip'
|
import { ChartTooltipContent } from './chart-tooltip'
|
||||||
import { PALETTE } from './palette'
|
import { paletteFills } from './palette'
|
||||||
|
|
||||||
export function DeletionReasonsChart({ deleted }: { deleted: DeletedGameEntry[] }) {
|
export function DeletionReasonsChart({ deleted }: { deleted: DeletedGameEntry[] }) {
|
||||||
const t = useT()
|
const t = useT()
|
||||||
const data = useMemo(() => deletionReasonCounts(deleted), [deleted])
|
const data = useMemo(() => paletteFills(deletionReasonCounts(deleted)), [deleted])
|
||||||
const total = data.reduce((sum, d) => sum + d.count, 0)
|
const total = data.reduce((sum, d) => sum + d.count, 0)
|
||||||
return (
|
return (
|
||||||
<ChartCard
|
<ChartCard
|
||||||
@@ -32,11 +32,7 @@ export function DeletionReasonsChart({ deleted }: { deleted: DeletedGameEntry[]
|
|||||||
outerRadius="80%"
|
outerRadius="80%"
|
||||||
paddingAngle={2}
|
paddingAngle={2}
|
||||||
stroke={SLICE_STROKE}
|
stroke={SLICE_STROKE}
|
||||||
>
|
/>
|
||||||
{data.map((_, i) => (
|
|
||||||
<Cell key={i} fill={PALETTE[i % PALETTE.length]} />
|
|
||||||
))}
|
|
||||||
</Pie>
|
|
||||||
<Tooltip {...TOOLTIP_BASE} content={<ChartTooltipContent total={total} />} />
|
<Tooltip {...TOOLTIP_BASE} content={<ChartTooltipContent total={total} />} />
|
||||||
<Legend {...LEGEND_BASE} />
|
<Legend {...LEGEND_BASE} />
|
||||||
</PieChart>
|
</PieChart>
|
||||||
|
|||||||
@@ -1,4 +1,4 @@
|
|||||||
import { useMemo } from 'react'
|
import { useMemo, type ComponentProps } from 'react'
|
||||||
import { ResponsiveContainer, Tooltip, Treemap, type TooltipPayloadEntry } from 'recharts'
|
import { ResponsiveContainer, Tooltip, Treemap, type TooltipPayloadEntry } from 'recharts'
|
||||||
import { genreTreemapData } from '@/lib/analytics'
|
import { genreTreemapData } from '@/lib/analytics'
|
||||||
import { treemapRows } from '@/lib/chart-table'
|
import { treemapRows } from '@/lib/chart-table'
|
||||||
@@ -61,7 +61,7 @@ export function GenreTreemapChart({ games }: { games: Game[] }) {
|
|||||||
const data = useMemo(() => genreTreemapData(games, 12), [games])
|
const data = useMemo(() => genreTreemapData(games, 12), [games])
|
||||||
// Recharts' Treemap data prop demands an index signature; our typed nodes
|
// Recharts' Treemap data prop demands an index signature; our typed nodes
|
||||||
// are valid treemap data at runtime, so cast through unknown.
|
// are valid treemap data at runtime, so cast through unknown.
|
||||||
const treemapData = data as unknown as React.ComponentProps<typeof Treemap>['data']
|
const treemapData = data as unknown as ComponentProps<typeof Treemap>['data']
|
||||||
return (
|
return (
|
||||||
// The treemap can't be stepped through with the keyboard: its table (and the Genres chart) carry the numbers.
|
// The treemap can't be stepped through with the keyboard: its table (and the Genres chart) carry the numbers.
|
||||||
<ChartCard
|
<ChartCard
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
import { useMemo } from 'react'
|
import { useMemo } from 'react'
|
||||||
import { Cell, Legend, Pie, PieChart, ResponsiveContainer, Tooltip } from 'recharts'
|
import { Legend, Pie, PieChart, ResponsiveContainer, Tooltip } from 'recharts'
|
||||||
import { topMadeWith } from '@/lib/analytics'
|
import { topMadeWith } from '@/lib/analytics'
|
||||||
import { tableRows } from '@/lib/chart-table'
|
import { tableRows } from '@/lib/chart-table'
|
||||||
import { useT } from '@/lib/i18n'
|
import { useT } from '@/lib/i18n'
|
||||||
@@ -7,11 +7,11 @@ import type { Game } from '@/types/game'
|
|||||||
import { ChartCard } from './chart-card'
|
import { ChartCard } from './chart-card'
|
||||||
import { chartAria, LEGEND_BASE, SERIES_ANIMATION, SLICE_STROKE, TOOLTIP_BASE } from './chart-theme'
|
import { chartAria, LEGEND_BASE, SERIES_ANIMATION, SLICE_STROKE, TOOLTIP_BASE } from './chart-theme'
|
||||||
import { ChartTooltipContent } from './chart-tooltip'
|
import { ChartTooltipContent } from './chart-tooltip'
|
||||||
import { PALETTE } from './palette'
|
import { paletteFills } from './palette'
|
||||||
|
|
||||||
export function MadeWithChart({ games }: { games: Game[] }) {
|
export function MadeWithChart({ games }: { games: Game[] }) {
|
||||||
const t = useT()
|
const t = useT()
|
||||||
const data = useMemo(() => topMadeWith(games, 8), [games])
|
const data = useMemo(() => paletteFills(topMadeWith(games, 8)), [games])
|
||||||
return (
|
return (
|
||||||
<ChartCard
|
<ChartCard
|
||||||
id="made-with"
|
id="made-with"
|
||||||
@@ -31,11 +31,7 @@ export function MadeWithChart({ games }: { games: Game[] }) {
|
|||||||
outerRadius="80%"
|
outerRadius="80%"
|
||||||
paddingAngle={2}
|
paddingAngle={2}
|
||||||
stroke={SLICE_STROKE}
|
stroke={SLICE_STROKE}
|
||||||
>
|
/>
|
||||||
{data.map((_, i) => (
|
|
||||||
<Cell key={i} fill={PALETTE[i % PALETTE.length]} />
|
|
||||||
))}
|
|
||||||
</Pie>
|
|
||||||
<Tooltip {...TOOLTIP_BASE} content={<ChartTooltipContent />} />
|
<Tooltip {...TOOLTIP_BASE} content={<ChartTooltipContent />} />
|
||||||
<Legend {...LEGEND_BASE} />
|
<Legend {...LEGEND_BASE} />
|
||||||
</PieChart>
|
</PieChart>
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
import { useMemo } from 'react'
|
import { useMemo } from 'react'
|
||||||
import { Cell, Legend, Pie, PieChart, ResponsiveContainer, Tooltip } from 'recharts'
|
import { Legend, Pie, PieChart, ResponsiveContainer, Tooltip } from 'recharts'
|
||||||
import { classifyOnline } from '@/lib/analytics'
|
import { classifyOnline } from '@/lib/analytics'
|
||||||
import { tableRows } from '@/lib/chart-table'
|
import { tableRows } from '@/lib/chart-table'
|
||||||
import { useT } from '@/lib/i18n'
|
import { useT } from '@/lib/i18n'
|
||||||
@@ -12,9 +12,10 @@ import { PALETTE } from './palette'
|
|||||||
export function OnlineOfflineChart({ games }: { games: Game[] }) {
|
export function OnlineOfflineChart({ games }: { games: Game[] }) {
|
||||||
const t = useT()
|
const t = useT()
|
||||||
const split = useMemo(() => classifyOnline(games), [games])
|
const split = useMemo(() => classifyOnline(games), [games])
|
||||||
|
// Blue and orange: apart in lightness and for colour-blind readers (green and amber were not).
|
||||||
const data = [
|
const data = [
|
||||||
{ key: t('charts.onlineOffline.online'), count: split.online },
|
{ key: t('charts.onlineOffline.online'), count: split.online, fill: PALETTE[4] },
|
||||||
{ key: t('charts.onlineOffline.offline'), count: split.offline },
|
{ key: t('charts.onlineOffline.offline'), count: split.offline, fill: PALETTE[6] },
|
||||||
]
|
]
|
||||||
return (
|
return (
|
||||||
<ChartCard
|
<ChartCard
|
||||||
@@ -29,7 +30,6 @@ export function OnlineOfflineChart({ games }: { games: Game[] }) {
|
|||||||
>
|
>
|
||||||
<ResponsiveContainer width="100%" height="100%">
|
<ResponsiveContainer width="100%" height="100%">
|
||||||
<PieChart {...chartAria('online-offline')}>
|
<PieChart {...chartAria('online-offline')}>
|
||||||
{/* Blue and orange: apart in lightness and for colour-blind readers (green and amber were not). */}
|
|
||||||
<Pie
|
<Pie
|
||||||
{...SERIES_ANIMATION}
|
{...SERIES_ANIMATION}
|
||||||
rootTabIndex={-1}
|
rootTabIndex={-1}
|
||||||
@@ -40,10 +40,7 @@ export function OnlineOfflineChart({ games }: { games: Game[] }) {
|
|||||||
outerRadius="80%"
|
outerRadius="80%"
|
||||||
paddingAngle={2}
|
paddingAngle={2}
|
||||||
stroke={SLICE_STROKE}
|
stroke={SLICE_STROKE}
|
||||||
>
|
/>
|
||||||
<Cell fill={PALETTE[4]} />
|
|
||||||
<Cell fill={PALETTE[6]} />
|
|
||||||
</Pie>
|
|
||||||
<Tooltip {...TOOLTIP_BASE} content={<ChartTooltipContent total={split.online + split.offline} />} />
|
<Tooltip {...TOOLTIP_BASE} content={<ChartTooltipContent total={split.online + split.offline} />} />
|
||||||
<Legend {...LEGEND_BASE} />
|
<Legend {...LEGEND_BASE} />
|
||||||
</PieChart>
|
</PieChart>
|
||||||
|
|||||||
@@ -23,3 +23,11 @@ export const PALETTE_LABEL = PALETTE.map((color) => readableOn(color))
|
|||||||
|
|
||||||
/** "Unknown / not disclosed" slices: a mid gray that reads on both themes' cards. */
|
/** "Unknown / not disclosed" slices: a mid gray that reads on both themes' cards. */
|
||||||
export const NEUTRAL = '#6b6b74'
|
export const NEUTRAL = '#6b6b74'
|
||||||
|
|
||||||
|
/**
|
||||||
|
* A pie slice takes its colour from the `fill` of its data entry (Recharts'
|
||||||
|
* `<Cell>` is deprecated and goes away in 4.0): the palette colours, in order.
|
||||||
|
*/
|
||||||
|
export function paletteFills<T extends object>(data: readonly T[]): (T & { fill: string })[] {
|
||||||
|
return data.map((entry, i) => ({ ...entry, fill: PALETTE[i % PALETTE.length] }))
|
||||||
|
}
|
||||||
@@ -1,5 +1,5 @@
|
|||||||
import { useMemo } from 'react'
|
import { useMemo } from 'react'
|
||||||
import { Cell, Legend, Pie, PieChart, ResponsiveContainer, Tooltip } from 'recharts'
|
import { Legend, Pie, PieChart, ResponsiveContainer, Tooltip } from 'recharts'
|
||||||
import { countByArray } from '@/lib/analytics'
|
import { countByArray } from '@/lib/analytics'
|
||||||
import { tableRows } from '@/lib/chart-table'
|
import { tableRows } from '@/lib/chart-table'
|
||||||
import { useT } from '@/lib/i18n'
|
import { useT } from '@/lib/i18n'
|
||||||
@@ -7,11 +7,11 @@ import type { Game } from '@/types/game'
|
|||||||
import { ChartCard } from './chart-card'
|
import { ChartCard } from './chart-card'
|
||||||
import { chartAria, LEGEND_BASE, SERIES_ANIMATION, SLICE_STROKE, TOOLTIP_BASE } from './chart-theme'
|
import { chartAria, LEGEND_BASE, SERIES_ANIMATION, SLICE_STROKE, TOOLTIP_BASE } from './chart-theme'
|
||||||
import { ChartTooltipContent } from './chart-tooltip'
|
import { ChartTooltipContent } from './chart-tooltip'
|
||||||
import { PALETTE } from './palette'
|
import { paletteFills } from './palette'
|
||||||
|
|
||||||
export function PlatformChart({ games }: { games: Game[] }) {
|
export function PlatformChart({ games }: { games: Game[] }) {
|
||||||
const t = useT()
|
const t = useT()
|
||||||
const data = useMemo(() => countByArray(games, 'platforms'), [games])
|
const data = useMemo(() => paletteFills(countByArray(games, 'platforms')), [games])
|
||||||
return (
|
return (
|
||||||
// No shares in the table: a game can count for several platforms.
|
// No shares in the table: a game can count for several platforms.
|
||||||
<ChartCard
|
<ChartCard
|
||||||
@@ -32,11 +32,7 @@ export function PlatformChart({ games }: { games: Game[] }) {
|
|||||||
outerRadius="80%"
|
outerRadius="80%"
|
||||||
paddingAngle={2}
|
paddingAngle={2}
|
||||||
stroke={SLICE_STROKE}
|
stroke={SLICE_STROKE}
|
||||||
>
|
/>
|
||||||
{data.map((_, i) => (
|
|
||||||
<Cell key={i} fill={PALETTE[i % PALETTE.length]} />
|
|
||||||
))}
|
|
||||||
</Pie>
|
|
||||||
<Tooltip {...TOOLTIP_BASE} content={<ChartTooltipContent />} />
|
<Tooltip {...TOOLTIP_BASE} content={<ChartTooltipContent />} />
|
||||||
<Legend {...LEGEND_BASE} />
|
<Legend {...LEGEND_BASE} />
|
||||||
</PieChart>
|
</PieChart>
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
import { useMemo } from 'react'
|
import { useMemo } from 'react'
|
||||||
import { Cell, Legend, Pie, PieChart, ResponsiveContainer, Tooltip } from 'recharts'
|
import { Legend, Pie, PieChart, ResponsiveContainer, Tooltip } from 'recharts'
|
||||||
import { countBy } from '@/lib/analytics'
|
import { countBy } from '@/lib/analytics'
|
||||||
import { tableRows } from '@/lib/chart-table'
|
import { tableRows } from '@/lib/chart-table'
|
||||||
import { useT } from '@/lib/i18n'
|
import { useT } from '@/lib/i18n'
|
||||||
@@ -7,11 +7,11 @@ import type { Game } from '@/types/game'
|
|||||||
import { ChartCard } from './chart-card'
|
import { ChartCard } from './chart-card'
|
||||||
import { chartAria, LEGEND_BASE, SERIES_ANIMATION, SLICE_STROKE, TOOLTIP_BASE } from './chart-theme'
|
import { chartAria, LEGEND_BASE, SERIES_ANIMATION, SLICE_STROKE, TOOLTIP_BASE } from './chart-theme'
|
||||||
import { ChartTooltipContent } from './chart-tooltip'
|
import { ChartTooltipContent } from './chart-tooltip'
|
||||||
import { PALETTE } from './palette'
|
import { paletteFills } from './palette'
|
||||||
|
|
||||||
export function StatusChart({ games }: { games: Game[] }) {
|
export function StatusChart({ games }: { games: Game[] }) {
|
||||||
const t = useT()
|
const t = useT()
|
||||||
const data = useMemo(() => countBy(games, 'status'), [games])
|
const data = useMemo(() => paletteFills(countBy(games, 'status')), [games])
|
||||||
const total = data.reduce((sum, d) => sum + d.count, 0)
|
const total = data.reduce((sum, d) => sum + d.count, 0)
|
||||||
return (
|
return (
|
||||||
<ChartCard
|
<ChartCard
|
||||||
@@ -30,11 +30,7 @@ export function StatusChart({ games }: { games: Game[] }) {
|
|||||||
nameKey="key"
|
nameKey="key"
|
||||||
outerRadius="80%"
|
outerRadius="80%"
|
||||||
stroke={SLICE_STROKE}
|
stroke={SLICE_STROKE}
|
||||||
>
|
/>
|
||||||
{data.map((_, i) => (
|
|
||||||
<Cell key={i} fill={PALETTE[i % PALETTE.length]} />
|
|
||||||
))}
|
|
||||||
</Pie>
|
|
||||||
<Tooltip {...TOOLTIP_BASE} content={<ChartTooltipContent total={total} />} />
|
<Tooltip {...TOOLTIP_BASE} content={<ChartTooltipContent total={total} />} />
|
||||||
<Legend {...LEGEND_BASE} />
|
<Legend {...LEGEND_BASE} />
|
||||||
</PieChart>
|
</PieChart>
|
||||||
|
|||||||
@@ -85,6 +85,8 @@ export function GlobalSearch({ className }: { className?: string }) {
|
|||||||
|
|
||||||
const onKeyDown = (e: KeyboardEvent<HTMLInputElement>) => {
|
const onKeyDown = (e: KeyboardEvent<HTMLInputElement>) => {
|
||||||
// Enter / arrows that finish an IME composition (e.g. Vietnamese Telex) aren't commands.
|
// Enter / arrows that finish an IME composition (e.g. Vietnamese Telex) aren't commands.
|
||||||
|
// Safari fires that keydown after compositionend, with isComposing false: only keyCode 229 tells.
|
||||||
|
// noinspection JSDeprecatedSymbols
|
||||||
if (e.nativeEvent.isComposing || e.keyCode === 229) return
|
if (e.nativeEvent.isComposing || e.keyCode === 229) return
|
||||||
if (e.key === 'ArrowDown' && hasQuery) {
|
if (e.key === 'ArrowDown' && hasQuery) {
|
||||||
e.preventDefault()
|
e.preventDefault()
|
||||||
|
|||||||
@@ -1,10 +1,10 @@
|
|||||||
import * as CheckboxPrimitive from '@radix-ui/react-checkbox'
|
import * as CheckboxPrimitive from '@radix-ui/react-checkbox'
|
||||||
import { Check } from 'lucide-react'
|
import { Check } from 'lucide-react'
|
||||||
import { forwardRef, type ComponentPropsWithoutRef, type ElementRef } from 'react'
|
import { forwardRef, type ComponentPropsWithoutRef, type ComponentRef } from 'react'
|
||||||
import { cn } from '@/lib/utils'
|
import { cn } from '@/lib/utils'
|
||||||
|
|
||||||
export const Checkbox = forwardRef<
|
export const Checkbox = forwardRef<
|
||||||
ElementRef<typeof CheckboxPrimitive.Root>,
|
ComponentRef<typeof CheckboxPrimitive.Root>,
|
||||||
ComponentPropsWithoutRef<typeof CheckboxPrimitive.Root>
|
ComponentPropsWithoutRef<typeof CheckboxPrimitive.Root>
|
||||||
>(({ className, ...props }, ref) => (
|
>(({ className, ...props }, ref) => (
|
||||||
<CheckboxPrimitive.Root
|
<CheckboxPrimitive.Root
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
import * as DialogPrimitive from '@radix-ui/react-dialog'
|
import * as DialogPrimitive from '@radix-ui/react-dialog'
|
||||||
import { X } from 'lucide-react'
|
import { X } from 'lucide-react'
|
||||||
import { forwardRef, type ComponentPropsWithoutRef, type ElementRef } from 'react'
|
import { forwardRef, type ComponentPropsWithoutRef, type ComponentRef } from 'react'
|
||||||
import { cn } from '@/lib/utils'
|
import { cn } from '@/lib/utils'
|
||||||
|
|
||||||
export const Dialog = DialogPrimitive.Root
|
export const Dialog = DialogPrimitive.Root
|
||||||
@@ -9,7 +9,7 @@ export const DialogDescription = DialogPrimitive.Description
|
|||||||
|
|
||||||
/** A centered modal panel (same look as the 18+ dialog), scrolling when taller than the screen. */
|
/** A centered modal panel (same look as the 18+ dialog), scrolling when taller than the screen. */
|
||||||
export const DialogContent = forwardRef<
|
export const DialogContent = forwardRef<
|
||||||
ElementRef<typeof DialogPrimitive.Content>,
|
ComponentRef<typeof DialogPrimitive.Content>,
|
||||||
ComponentPropsWithoutRef<typeof DialogPrimitive.Content>
|
ComponentPropsWithoutRef<typeof DialogPrimitive.Content>
|
||||||
>(({ className, children, ...props }, ref) => (
|
>(({ className, children, ...props }, ref) => (
|
||||||
<DialogPrimitive.Portal>
|
<DialogPrimitive.Portal>
|
||||||
|
|||||||
@@ -1,9 +1,9 @@
|
|||||||
import * as LabelPrimitive from '@radix-ui/react-label'
|
import * as LabelPrimitive from '@radix-ui/react-label'
|
||||||
import { forwardRef, type ComponentPropsWithoutRef, type ElementRef } from 'react'
|
import { forwardRef, type ComponentPropsWithoutRef, type ComponentRef } from 'react'
|
||||||
import { cn } from '@/lib/utils'
|
import { cn } from '@/lib/utils'
|
||||||
|
|
||||||
export const Label = forwardRef<
|
export const Label = forwardRef<
|
||||||
ElementRef<typeof LabelPrimitive.Root>,
|
ComponentRef<typeof LabelPrimitive.Root>,
|
||||||
ComponentPropsWithoutRef<typeof LabelPrimitive.Root>
|
ComponentPropsWithoutRef<typeof LabelPrimitive.Root>
|
||||||
>(({ className, ...props }, ref) => (
|
>(({ className, ...props }, ref) => (
|
||||||
<LabelPrimitive.Root
|
<LabelPrimitive.Root
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
import * as PopoverPrimitive from '@radix-ui/react-popover'
|
import * as PopoverPrimitive from '@radix-ui/react-popover'
|
||||||
import { forwardRef, type ComponentPropsWithoutRef, type ElementRef } from 'react'
|
import { forwardRef, type ComponentPropsWithoutRef, type ComponentRef } from 'react'
|
||||||
import { cn } from '@/lib/utils'
|
import { cn } from '@/lib/utils'
|
||||||
|
|
||||||
export const Popover = PopoverPrimitive.Root
|
export const Popover = PopoverPrimitive.Root
|
||||||
@@ -7,7 +7,7 @@ export const PopoverTrigger = PopoverPrimitive.Trigger
|
|||||||
export const PopoverClose = PopoverPrimitive.Close
|
export const PopoverClose = PopoverPrimitive.Close
|
||||||
|
|
||||||
export const PopoverContent = forwardRef<
|
export const PopoverContent = forwardRef<
|
||||||
ElementRef<typeof PopoverPrimitive.Content>,
|
ComponentRef<typeof PopoverPrimitive.Content>,
|
||||||
ComponentPropsWithoutRef<typeof PopoverPrimitive.Content>
|
ComponentPropsWithoutRef<typeof PopoverPrimitive.Content>
|
||||||
>(({ className, align = 'center', sideOffset = 4, ...props }, ref) => (
|
>(({ className, align = 'center', sideOffset = 4, ...props }, ref) => (
|
||||||
<PopoverPrimitive.Portal>
|
<PopoverPrimitive.Portal>
|
||||||
|
|||||||
@@ -1,9 +1,9 @@
|
|||||||
import * as SeparatorPrimitive from '@radix-ui/react-separator'
|
import * as SeparatorPrimitive from '@radix-ui/react-separator'
|
||||||
import { forwardRef, type ComponentPropsWithoutRef, type ElementRef } from 'react'
|
import { forwardRef, type ComponentPropsWithoutRef, type ComponentRef } from 'react'
|
||||||
import { cn } from '@/lib/utils'
|
import { cn } from '@/lib/utils'
|
||||||
|
|
||||||
export const Separator = forwardRef<
|
export const Separator = forwardRef<
|
||||||
ElementRef<typeof SeparatorPrimitive.Root>,
|
ComponentRef<typeof SeparatorPrimitive.Root>,
|
||||||
ComponentPropsWithoutRef<typeof SeparatorPrimitive.Root>
|
ComponentPropsWithoutRef<typeof SeparatorPrimitive.Root>
|
||||||
>(({ className, orientation = 'horizontal', decorative = true, ...props }, ref) => (
|
>(({ className, orientation = 'horizontal', decorative = true, ...props }, ref) => (
|
||||||
<SeparatorPrimitive.Root
|
<SeparatorPrimitive.Root
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
import * as DialogPrimitive from '@radix-ui/react-dialog'
|
import * as DialogPrimitive from '@radix-ui/react-dialog'
|
||||||
import { X } from 'lucide-react'
|
import { X } from 'lucide-react'
|
||||||
import { forwardRef, type ComponentPropsWithoutRef, type ElementRef } from 'react'
|
import { forwardRef, type ComponentPropsWithoutRef, type ComponentRef } from 'react'
|
||||||
import { cva, type VariantProps } from 'class-variance-authority'
|
import { cva, type VariantProps } from 'class-variance-authority'
|
||||||
import { cn } from '@/lib/utils'
|
import { cn } from '@/lib/utils'
|
||||||
|
|
||||||
@@ -9,7 +9,7 @@ export const SheetTrigger = DialogPrimitive.Trigger
|
|||||||
const SheetPortal = DialogPrimitive.Portal
|
const SheetPortal = DialogPrimitive.Portal
|
||||||
|
|
||||||
const SheetOverlay = forwardRef<
|
const SheetOverlay = forwardRef<
|
||||||
ElementRef<typeof DialogPrimitive.Overlay>,
|
ComponentRef<typeof DialogPrimitive.Overlay>,
|
||||||
ComponentPropsWithoutRef<typeof DialogPrimitive.Overlay>
|
ComponentPropsWithoutRef<typeof DialogPrimitive.Overlay>
|
||||||
>(({ className, ...props }, ref) => (
|
>(({ className, ...props }, ref) => (
|
||||||
<DialogPrimitive.Overlay
|
<DialogPrimitive.Overlay
|
||||||
@@ -47,7 +47,7 @@ export interface SheetContentProps
|
|||||||
}
|
}
|
||||||
|
|
||||||
export const SheetContent = forwardRef<
|
export const SheetContent = forwardRef<
|
||||||
ElementRef<typeof DialogPrimitive.Content>,
|
ComponentRef<typeof DialogPrimitive.Content>,
|
||||||
SheetContentProps
|
SheetContentProps
|
||||||
>(({ side = 'right', className, children, showClose = true, closeLabel = 'Close', ...props }, ref) => (
|
>(({ side = 'right', className, children, showClose = true, closeLabel = 'Close', ...props }, ref) => (
|
||||||
<SheetPortal>
|
<SheetPortal>
|
||||||
@@ -66,7 +66,7 @@ export const SheetContent = forwardRef<
|
|||||||
SheetContent.displayName = 'SheetContent'
|
SheetContent.displayName = 'SheetContent'
|
||||||
|
|
||||||
export const SheetTitle = forwardRef<
|
export const SheetTitle = forwardRef<
|
||||||
ElementRef<typeof DialogPrimitive.Title>,
|
ComponentRef<typeof DialogPrimitive.Title>,
|
||||||
ComponentPropsWithoutRef<typeof DialogPrimitive.Title>
|
ComponentPropsWithoutRef<typeof DialogPrimitive.Title>
|
||||||
>(({ className, ...props }, ref) => (
|
>(({ className, ...props }, ref) => (
|
||||||
<DialogPrimitive.Title
|
<DialogPrimitive.Title
|
||||||
@@ -78,7 +78,7 @@ export const SheetTitle = forwardRef<
|
|||||||
SheetTitle.displayName = 'SheetTitle'
|
SheetTitle.displayName = 'SheetTitle'
|
||||||
|
|
||||||
export const SheetDescription = forwardRef<
|
export const SheetDescription = forwardRef<
|
||||||
ElementRef<typeof DialogPrimitive.Description>,
|
ComponentRef<typeof DialogPrimitive.Description>,
|
||||||
ComponentPropsWithoutRef<typeof DialogPrimitive.Description>
|
ComponentPropsWithoutRef<typeof DialogPrimitive.Description>
|
||||||
>(({ className, ...props }, ref) => (
|
>(({ className, ...props }, ref) => (
|
||||||
<DialogPrimitive.Description
|
<DialogPrimitive.Description
|
||||||
|
|||||||
@@ -1,9 +1,9 @@
|
|||||||
import * as SwitchPrimitive from '@radix-ui/react-switch'
|
import * as SwitchPrimitive from '@radix-ui/react-switch'
|
||||||
import { forwardRef, type ComponentPropsWithoutRef, type ElementRef } from 'react'
|
import { forwardRef, type ComponentPropsWithoutRef, type ComponentRef } from 'react'
|
||||||
import { cn } from '@/lib/utils'
|
import { cn } from '@/lib/utils'
|
||||||
|
|
||||||
export const Switch = forwardRef<
|
export const Switch = forwardRef<
|
||||||
ElementRef<typeof SwitchPrimitive.Root>,
|
ComponentRef<typeof SwitchPrimitive.Root>,
|
||||||
ComponentPropsWithoutRef<typeof SwitchPrimitive.Root>
|
ComponentPropsWithoutRef<typeof SwitchPrimitive.Root>
|
||||||
>(({ className, ...props }, ref) => (
|
>(({ className, ...props }, ref) => (
|
||||||
<SwitchPrimitive.Root
|
<SwitchPrimitive.Root
|
||||||
|
|||||||
@@ -1,11 +1,11 @@
|
|||||||
import * as TabsPrimitive from '@radix-ui/react-tabs'
|
import * as TabsPrimitive from '@radix-ui/react-tabs'
|
||||||
import { forwardRef, type ComponentPropsWithoutRef, type ElementRef } from 'react'
|
import { forwardRef, type ComponentPropsWithoutRef, type ComponentRef } from 'react'
|
||||||
import { cn } from '@/lib/utils'
|
import { cn } from '@/lib/utils'
|
||||||
|
|
||||||
export const Tabs = TabsPrimitive.Root
|
export const Tabs = TabsPrimitive.Root
|
||||||
|
|
||||||
export const TabsList = forwardRef<
|
export const TabsList = forwardRef<
|
||||||
ElementRef<typeof TabsPrimitive.List>,
|
ComponentRef<typeof TabsPrimitive.List>,
|
||||||
ComponentPropsWithoutRef<typeof TabsPrimitive.List>
|
ComponentPropsWithoutRef<typeof TabsPrimitive.List>
|
||||||
>(({ className, ...props }, ref) => (
|
>(({ className, ...props }, ref) => (
|
||||||
<TabsPrimitive.List
|
<TabsPrimitive.List
|
||||||
@@ -20,7 +20,7 @@ export const TabsList = forwardRef<
|
|||||||
TabsList.displayName = TabsPrimitive.List.displayName
|
TabsList.displayName = TabsPrimitive.List.displayName
|
||||||
|
|
||||||
export const TabsTrigger = forwardRef<
|
export const TabsTrigger = forwardRef<
|
||||||
ElementRef<typeof TabsPrimitive.Trigger>,
|
ComponentRef<typeof TabsPrimitive.Trigger>,
|
||||||
ComponentPropsWithoutRef<typeof TabsPrimitive.Trigger>
|
ComponentPropsWithoutRef<typeof TabsPrimitive.Trigger>
|
||||||
>(({ className, ...props }, ref) => (
|
>(({ className, ...props }, ref) => (
|
||||||
<TabsPrimitive.Trigger
|
<TabsPrimitive.Trigger
|
||||||
@@ -35,7 +35,7 @@ export const TabsTrigger = forwardRef<
|
|||||||
TabsTrigger.displayName = TabsPrimitive.Trigger.displayName
|
TabsTrigger.displayName = TabsPrimitive.Trigger.displayName
|
||||||
|
|
||||||
export const TabsContent = forwardRef<
|
export const TabsContent = forwardRef<
|
||||||
ElementRef<typeof TabsPrimitive.Content>,
|
ComponentRef<typeof TabsPrimitive.Content>,
|
||||||
ComponentPropsWithoutRef<typeof TabsPrimitive.Content>
|
ComponentPropsWithoutRef<typeof TabsPrimitive.Content>
|
||||||
>(({ className, ...props }, ref) => (
|
>(({ className, ...props }, ref) => (
|
||||||
<TabsPrimitive.Content
|
<TabsPrimitive.Content
|
||||||
|
|||||||
@@ -8,7 +8,7 @@ export interface ThirdParty {
|
|||||||
|
|
||||||
export const APP = {
|
export const APP = {
|
||||||
name: 'Free Itch Games',
|
name: 'Free Itch Games',
|
||||||
version: '4.6.0',
|
version: '4.6.1',
|
||||||
repo: 'https://github.com/poli0981/free-games-itchio-list',
|
repo: 'https://github.com/poli0981/free-games-itchio-list',
|
||||||
license: 'code MIT · data CC BY 4.0',
|
license: 'code MIT · data CC BY 4.0',
|
||||||
} as const
|
} as const
|
||||||
|
|||||||
@@ -117,7 +117,7 @@ export function ratingOf(game: Game): number | null {
|
|||||||
}
|
}
|
||||||
|
|
||||||
export function ratingCountOf(game: Game): number {
|
export function ratingCountOf(game: Game): number {
|
||||||
const n = Number.parseInt(String(game.rating_count).replace(/[^\d]/g, ''), 10)
|
const n = Number.parseInt(String(game.rating_count).replace(/\D/g, ''), 10)
|
||||||
return Number.isFinite(n) ? n : 0
|
return Number.isFinite(n) ? n : 0
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -160,8 +160,7 @@ export function filterGames(
|
|||||||
if (!wanted.some((v) => have.includes(v))) return false
|
if (!wanted.some((v) => have.includes(v))) return false
|
||||||
}
|
}
|
||||||
if (query.minRating !== null && (ratingOf(game) ?? -1) < query.minRating) return false
|
if (query.minRating !== null && (ratingOf(game) ?? -1) < query.minRating) return false
|
||||||
if (query.browser && !playsInBrowser(game)) return false
|
return !query.browser || playsInBrowser(game)
|
||||||
return true
|
|
||||||
})
|
})
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|||||||
@@ -91,6 +91,8 @@ async function copyText(text: string): Promise<boolean> {
|
|||||||
document.body.appendChild(area)
|
document.body.appendChild(area)
|
||||||
area.select()
|
area.select()
|
||||||
try {
|
try {
|
||||||
|
// The fallback for webviews without the async Clipboard API.
|
||||||
|
// noinspection JSDeprecatedSymbols
|
||||||
return document.execCommand('copy')
|
return document.execCommand('copy')
|
||||||
} catch {
|
} catch {
|
||||||
return false
|
return false
|
||||||
|
|||||||
@@ -1,4 +1,4 @@
|
|||||||
import { useEffect, useRef, useState, type FormEvent } from 'react'
|
import { useEffect, useRef, useState, type SubmitEvent } from 'react'
|
||||||
import { useQuery } from '@tanstack/react-query'
|
import { useQuery } from '@tanstack/react-query'
|
||||||
import { Button } from '@/components/ui/button'
|
import { Button } from '@/components/ui/button'
|
||||||
import { Input } from '@/components/ui/input'
|
import { Input } from '@/components/ui/input'
|
||||||
@@ -106,7 +106,7 @@ function SuggestForm() {
|
|||||||
const urlError = touched && url !== '' && !urlValid
|
const urlError = touched && url !== '' && !urlValid
|
||||||
const ready = urlValid && Boolean(token) && !sending
|
const ready = urlValid && Boolean(token) && !sending
|
||||||
|
|
||||||
async function submit(e: FormEvent) {
|
async function submit(e: SubmitEvent<HTMLFormElement>) {
|
||||||
e.preventDefault()
|
e.preventDefault()
|
||||||
if (sending) return
|
if (sending) return
|
||||||
// The button stays focusable (aria-disabled): say what is missing instead of doing nothing.
|
// The button stays focusable (aria-disabled): say what is missing instead of doing nothing.
|
||||||
|
|||||||
@@ -26,7 +26,7 @@ export function resetDataCache(): void {
|
|||||||
async function fetchJson<T>(src: DataSource, file: string): Promise<T> {
|
async function fetchJson<T>(src: DataSource, file: string): Promise<T> {
|
||||||
const res = await src.assets.fetch(new Request(`${src.origin}/data/${file}`))
|
const res = await src.assets.fetch(new Request(`${src.origin}/data/${file}`))
|
||||||
if (!res.ok) throw new Error(`${file}: ${res.status}`)
|
if (!res.ok) throw new Error(`${file}: ${res.status}`)
|
||||||
return res.json() as Promise<T>
|
return (await res.json()) as T
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
|||||||
Reference in new issue
Block a user