Compare commits
No files matched your search
@@ -0,0 +1,103 @@
|
||||
name: ♿ Accessibility barrier
|
||||
description: Something on the website or in the apps doesn't work with your keyboard, screen reader, zoom, contrast settings or other assistive technology
|
||||
title: "[Accessibility] "
|
||||
labels: ["accessibility"]
|
||||
body:
|
||||
- type: markdown
|
||||
attributes:
|
||||
value: |
|
||||
Thank you for taking the time to report this. Every report helps, even a partial one — describe what happened in your own words, and skip whatever you'd rather not share. Please don't include health information.
|
||||
|
||||
Prefer email, or don't have a GitHub account? Write to **contact@poli0981.dev** (English or Vietnamese). What happens next, and the response targets, are in [ACCESSIBILITY.md](https://github.com/poli0981/free-games-itchio-list/blob/main/ACCESSIBILITY.md#7-reporting-an-accessibility-barrier).
|
||||
|
||||
**Found a security vulnerability?** Please don't file it here: report it privately (see SECURITY.md).
|
||||
|
||||
- type: dropdown
|
||||
id: where
|
||||
attributes:
|
||||
label: Where did it happen?
|
||||
description: Pick all that apply.
|
||||
multiple: true
|
||||
options:
|
||||
- Website (freeitchgames.win)
|
||||
- Desktop app — Windows
|
||||
- Desktop app — macOS
|
||||
- Desktop app — Linux
|
||||
- Android app
|
||||
- Not sure
|
||||
validations:
|
||||
required: true
|
||||
|
||||
- type: input
|
||||
id: page
|
||||
attributes:
|
||||
label: Page or screen
|
||||
description: The address of the page, or the screen in the app.
|
||||
placeholder: e.g. https://freeitchgames.win/charts, or "the Games list in the Android app"
|
||||
|
||||
- type: textarea
|
||||
id: details
|
||||
attributes:
|
||||
label: What were you trying to do, and what happened?
|
||||
description: What you expected, what happened instead, and the steps to get there if you can.
|
||||
placeholder: |
|
||||
e.g. I pressed Tab to reach the "Platform" filter, but focus jumped back to the top of the page.
|
||||
validations:
|
||||
required: true
|
||||
|
||||
- type: dropdown
|
||||
id: kind
|
||||
attributes:
|
||||
label: What kind of barrier? (optional)
|
||||
multiple: true
|
||||
options:
|
||||
- Keyboard (can't reach or use something, focus lost or hidden)
|
||||
- Screen reader (missing or wrong name, nothing announced, wrong reading order)
|
||||
- Zoom, text size or layout at large sizes
|
||||
- Colour or contrast (including Windows contrast themes)
|
||||
- Motion or animation
|
||||
- Charts
|
||||
- Language (read in the wrong language or voice)
|
||||
- Speech input or switch access
|
||||
- Something else
|
||||
|
||||
- type: dropdown
|
||||
id: severity
|
||||
attributes:
|
||||
label: How much does it get in your way?
|
||||
description: Just your best guess; it may change during triage.
|
||||
options:
|
||||
- Critical — I can't do a main task at all (find, open or read a game, change settings)
|
||||
- Serious — I can, but only with great effort or a workaround
|
||||
- Moderate — annoying or inconsistent, but I get there
|
||||
- Minor — a small polish issue
|
||||
validations:
|
||||
required: true
|
||||
|
||||
- type: input
|
||||
id: assistive-tech
|
||||
attributes:
|
||||
label: Assistive technology and version (if any)
|
||||
placeholder: e.g. Windows Narrator, NVDA 2026.1, VoiceOver on iOS 26, TalkBack, keyboard only, Windows contrast theme
|
||||
|
||||
- type: input
|
||||
id: environment
|
||||
attributes:
|
||||
label: Device, operating system, browser or app version
|
||||
description: The app version is shown on the About page.
|
||||
placeholder: e.g. Windows 11 + Edge 142; Android 15 + app 4.6.0
|
||||
|
||||
- type: textarea
|
||||
id: media
|
||||
attributes:
|
||||
label: Screenshot or recording (optional)
|
||||
description: Paste or drag files here. Please hide any personal information.
|
||||
|
||||
- type: checkboxes
|
||||
id: conduct
|
||||
attributes:
|
||||
label: Code of Conduct
|
||||
description: By submitting this issue you agree to follow the project's [Code of Conduct](https://github.com/poli0981/free-games-itchio-list/blob/main/CODE_OF_CONDUCT.md).
|
||||
options:
|
||||
- label: I agree to follow the Code of Conduct.
|
||||
required: true
|
||||
@@ -8,6 +8,8 @@ body:
|
||||
value: |
|
||||
Thanks bro! This catalog lives on additions because I'm too lazy to hunt alone :D Only free-to-play itch.io games.
|
||||
|
||||
The game must be playable or downloadable **on its itch.io page itself** (a browser build or an uploaded file). A page that only points to a launcher or a download on another site doesn't qualify.
|
||||
|
||||
**Just one game? Use the Suggest page instead: https://freeitchgames.win/suggest** — no GitHub account needed, and it goes straight into the review queue.
|
||||
This issue form is the fallback for **bulk lists** (several games at once).
|
||||
|
||||
@@ -56,6 +58,7 @@ body:
|
||||
options:
|
||||
- label: I searched https://freeitchgames.win/games and these games aren't listed yet
|
||||
- label: These games are free to play on itch.io (not paid)
|
||||
- label: Each page has its own browser build or download on itch.io (not only a link to another site)
|
||||
|
||||
- type: checkboxes
|
||||
id: agreement
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
name: 🐛 Bug Report
|
||||
description: Report a bug on the website, in the desktop/Android app, in the game data, or in the scripts
|
||||
name: 🛠️ Report a problem (wrong data, something broke)
|
||||
description: Wrong or outdated game data, a dead link, or something that stopped working on the website or in the apps. Not for feature requests.
|
||||
title: "[Bug] "
|
||||
labels: ["bug"]
|
||||
body:
|
||||
@@ -8,8 +8,11 @@ body:
|
||||
value: |
|
||||
Thanks for reporting! I'm a lazy unemployed dev, so bugs happen a lot :D My AI buddies fix most, but your help is gold.
|
||||
|
||||
**The project is in maintenance mode** (stable, no new features): this form is for wrong game data and for things that broke. Ideas and feature requests are closed without review.
|
||||
|
||||
**Found a security vulnerability?** Please don't file it here — report it privately via https://github.com/poli0981/free-games-itchio-list/security/advisories/new or security@poli0981.dev.
|
||||
Want a game removed (or you're its creator)? Use the "Remove a Game" template instead.
|
||||
Something doesn't work with your keyboard, screen reader, zoom or contrast settings? The "Accessibility barrier" template asks the right questions.
|
||||
|
||||
- type: dropdown
|
||||
id: where
|
||||
|
||||
@@ -6,3 +6,9 @@ contact_links:
|
||||
- name: 🔒 Report a security vulnerability (private)
|
||||
url: https://github.com/poli0981/free-games-itchio-list/security/advisories/new
|
||||
about: Please report vulnerabilities privately here (or email security@poli0981.dev), never in a public issue.
|
||||
- name: 💬 Questions, feedback, anything else
|
||||
url: https://github.com/poli0981/free-games-itchio-list/discussions
|
||||
about: Issues are for the catalog data only (add, fix or remove a game). Everything else goes to Discussions.
|
||||
- name: 🧊 Feature requests are closed
|
||||
url: https://github.com/poli0981/free-games-itchio-list#project-status
|
||||
about: The project is stable and in maintenance mode — security fixes and dependency updates only. Feature requests and code pull requests are closed without review.
|
||||
@@ -1,62 +0,0 @@
|
||||
name: 💡 Feature Request / Improvement
|
||||
description: Suggest a new feature or code improvement
|
||||
title: "[Feature/Improvement] "
|
||||
labels: ["enhancement"]
|
||||
body:
|
||||
- type: markdown
|
||||
attributes:
|
||||
value: |
|
||||
Yo legend! My code is mediocre at best, so ideas are welcome. Grok helps, but you might have better ones :D
|
||||
|
||||
- type: checkboxes
|
||||
id: type
|
||||
attributes:
|
||||
label: Type (choose one only)
|
||||
options:
|
||||
- label: New Feature
|
||||
- label: Code Improvement
|
||||
validations:
|
||||
required: true
|
||||
|
||||
- type: input
|
||||
id: title
|
||||
attributes:
|
||||
label: Feature/Improvement Name
|
||||
description: Short title — what is it?
|
||||
validations:
|
||||
required: true
|
||||
|
||||
- type: textarea
|
||||
id: reason
|
||||
attributes:
|
||||
label: Why? (e.g tables too slow, missing info, etc.)
|
||||
description: Explain the problem it solves or why it's cool/good for the repo.
|
||||
validations:
|
||||
required: true
|
||||
|
||||
- type: checkboxes
|
||||
id: priority
|
||||
attributes:
|
||||
label: How necessary? (choose one only)
|
||||
options:
|
||||
- label: Not urgent (nice to have)
|
||||
- label: Maybe needed
|
||||
- label: Very needed
|
||||
- label: Extremely urgent (repo dying without it)
|
||||
validations:
|
||||
required: true
|
||||
|
||||
- type: textarea
|
||||
id: code
|
||||
attributes:
|
||||
label: (Optional) Pseudo-code, snippet, or file idea
|
||||
description: |
|
||||
Share code ideas — I'll check (no malware pls, I'm paranoid and lazy :D). My skill is average, so keep it simple.
|
||||
|
||||
- type: checkboxes
|
||||
id: agreement
|
||||
attributes:
|
||||
label: Agreement (required)
|
||||
options:
|
||||
- label: I agree — if this issue is off-topic, spam, or violates repo policy, it may be ignored/closed without response.
|
||||
required: true
|
||||
@@ -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,7 +1,7 @@
|
||||
name: 🚫 Remove a Game (or copyright request)
|
||||
description: Ask to remove games from the catalog or correct their data, including requests from creators and rights holders (max 10 per issue)
|
||||
title: "[Remove Games] "
|
||||
labels: ["removal"]
|
||||
labels: ["delete-game"]
|
||||
body:
|
||||
- type: markdown
|
||||
attributes:
|
||||
|
||||
@@ -12,6 +12,7 @@ Optional: short notes, why they rock, NSFW/safety concerns (the Maintainer sets
|
||||
|
||||
### Checklist
|
||||
- [ ] All links are free itch.io game pages
|
||||
- [ ] Each page has its own browser build or download on itch.io (not only a link to another site)
|
||||
- [ ] No duplicates (searched https://freeitchgames.win/games)
|
||||
- [ ] Only `scripts/temp_link.json` changed, and it's still valid JSON
|
||||
- [ ] I agree my contribution is licensed under CC BY 4.0, like the rest of the catalog data (`data_game/LICENSE.md`)
|
||||
|
||||
@@ -1,27 +0,0 @@
|
||||
**🐛 Bug Fix**
|
||||
|
||||
Thanks for fixing my mediocre code! I'm just an unemployed noob dev, so bugs are my specialty :D
|
||||
|
||||
### What bug did you fix?
|
||||
- [ ] Wrong game info or NSFW/safety flag (usually easier as a Bug Report issue — please don't hand-edit `data_game/`, the pipeline writes it)
|
||||
- [ ] Scraping failure (itch.io changed HTML again)
|
||||
- [ ] Data pipeline / GitHub Actions fail
|
||||
- [ ] Website bug (`webapp/src/`)
|
||||
- [ ] Worker bug (`webapp/worker/` — image proxy, Suggest API, admin API)
|
||||
- [ ] Desktop/Android app (Tauri) bug
|
||||
- [ ] Other (describe below)
|
||||
|
||||
### Description
|
||||
Explain the bug and how your fix works. Bonus points if you tested locally!
|
||||
|
||||
### Related Issues
|
||||
Closes # (link issue number if any)
|
||||
|
||||
### Checklist
|
||||
- [ ] Tested locally — Python: `pytest`, `ruff check scripts tests webapp/scripts`, `python scripts/validate.py`; webapp: `npm test`, `npm run lint`, `npx tsc -b`
|
||||
- [ ] No new bugs introduced (hopefully)
|
||||
- [ ] No secrets, tokens or personal data in the diff
|
||||
- [ ] I agree my contribution is licensed under the MIT License (see `LICENSE`)
|
||||
- [ ] Followed the vibe (chill, no drama)
|
||||
|
||||
Grok approved? (just kidding, but thanks legend!) 🚀
|
||||
@@ -1,26 +0,0 @@
|
||||
**📝 Documentation Update / Other**
|
||||
|
||||
Not code or games? Fix my bad English, typos, or update legal docs — still super helpful!
|
||||
|
||||
### What did you update?
|
||||
- [ ] Fix typo/grammar in README/docs
|
||||
- [ ] Update DISCLAIMER/PRIVACY/TERMS/EULA/SECURITY/etc.
|
||||
- [ ] Update the Vietnamese mirror (`README.vi.md`, `docs/i18n/vi/`)
|
||||
- [ ] Improve MY_STUFF or ACKNOWLEDGEMENTS
|
||||
- [ ] Add badges/screenshots
|
||||
- [ ] Other small polish
|
||||
|
||||
### Description
|
||||
Explain changes and why.
|
||||
|
||||
### Related Issues
|
||||
References # (if any)
|
||||
|
||||
### Checklist
|
||||
- [ ] No breaking changes
|
||||
- [ ] Relative links still resolve; website links use `https://freeitchgames.win/<path>`
|
||||
- [ ] If I changed an English doc that has a Vietnamese mirror, I updated the mirror too (or said so above so someone else can)
|
||||
- [ ] I agree my contribution is licensed under CC BY 4.0, like the rest of the documentation
|
||||
- [ ] Keeps the self-deprecating vibe :D
|
||||
|
||||
Even small fixes make this repo look less noob — thanks bro! 🚀
|
||||
@@ -1,30 +0,0 @@
|
||||
**💡 New Feature / Code Improvement**
|
||||
|
||||
Yo legend! My code is "kinda works" level, so any upgrade is huge. Grok helps me, but real humans are better :D
|
||||
|
||||
Heads-up: the website and apps are read-only for visitors on purpose — no accounts, no ads, no profiling, no telemetry in the apps. Features that would add those (or new cookies, or a new third-party service) need a chat in an issue first, since the Privacy Policy would have to change.
|
||||
|
||||
### What feature/improvement?
|
||||
- [ ] Better scraping (more info, rating, etc.)
|
||||
- [ ] Website/app UI (new page, filter, chart, better mobile layout)
|
||||
- [ ] Desktop/Android app (Tauri)
|
||||
- [ ] Automation (pipeline, GitHub Actions)
|
||||
- [ ] Performance fix (faster pages, faster Actions)
|
||||
- [ ] Refactor my messy code
|
||||
- [ ] Other (describe)
|
||||
|
||||
### Description
|
||||
Explain what it does and why it's cool. Include code snippets if needed.
|
||||
|
||||
### Related Issues
|
||||
References # (link if any)
|
||||
|
||||
### Checklist
|
||||
- [ ] Tested locally (Python: `pytest`, `ruff check scripts tests webapp/scripts`; webapp: `npm test`, `npm run lint`, `npm run knip`, `npx tsc -b`)
|
||||
- [ ] Doesn't break the daily refresh or the ingest workflow
|
||||
- [ ] New npm dependency? Added it to `webapp/src/lib/about.ts` so the About page lists it
|
||||
- [ ] Edited `webapp/wrangler.jsonc`? Ran `npm run cf:types`
|
||||
- [ ] I agree my contribution is licensed under the MIT License (see `LICENSE`)
|
||||
- [ ] Keeps the noob vibe intact
|
||||
|
||||
If this makes the repo less mediocre — you're the MVP. 🚀
|
||||
@@ -1,5 +1,5 @@
|
||||
# Dependabot version updates. Security updates are enabled separately in
|
||||
# Settings → Code security (they are not limited by open-pull-requests-limit).
|
||||
# Dependabot version updates. Security updates are a separate switch in
|
||||
# Settings → Code security (when on, they are not limited by open-pull-requests-limit).
|
||||
version: 2
|
||||
updates:
|
||||
- package-ecosystem: npm
|
||||
|
||||
@@ -0,0 +1,31 @@
|
||||
<!--
|
||||
The project is in maintenance mode (stable, no new features — see README → Project status).
|
||||
Pull requests from contributors are accepted for ONE thing: adding itch.io URLs to
|
||||
scripts/temp_link.json. For that, add ?template=add_games.md to this page's address.
|
||||
Code, UI and docs pull requests are closed without review; a game's data is fixed or removed
|
||||
through an issue or email (CONTRIBUTING.md). This template is the Maintainer's own checklist.
|
||||
-->
|
||||
|
||||
### What and why
|
||||
|
||||
What does this change, and why?
|
||||
|
||||
### Related issues
|
||||
|
||||
Closes # (if any)
|
||||
|
||||
### Checklist
|
||||
|
||||
- [ ] Tested locally — Python: `pytest`, `ruff check scripts tests webapp/scripts`; webapp: `npm test`, `npm run lint`, `npm run knip`, `npx tsc -b`
|
||||
- [ ] No secrets, tokens or personal data in the diff
|
||||
- [ ] New UI text is in both `webapp/src/lib/i18n/en.ts` and `vi.ts`; a changed English doc has its Vietnamese mirror updated (or I said so above)
|
||||
- [ ] I agree my contribution is licensed like the part it changes: MIT for code, CC BY 4.0 for data and docs
|
||||
|
||||
### Accessibility (UI or docs changes — see [ACCESSIBILITY.md](https://github.com/poli0981/free-games-itchio-list/blob/main/ACCESSIBILITY.md#8-for-contributors))
|
||||
|
||||
- [ ] N/A — no UI or docs change
|
||||
- [ ] Works with the keyboard alone: everything reachable, focus visible and never lost
|
||||
- [ ] Every control has a name; nothing relies on colour alone; `npm test` (contrast check) passes
|
||||
- [ ] Respects reduced motion; no new auto-playing motion
|
||||
- [ ] Checked once with a screen reader (Narrator, NVDA, VoiceOver or TalkBack)
|
||||
- [ ] Docs: headings in order, descriptive link text, alt text for images
|
||||
@@ -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 }}
|
||||
@@ -45,7 +45,7 @@ jobs:
|
||||
persist-credentials: false
|
||||
|
||||
- name: Set up JDK
|
||||
uses: actions/setup-java@b843ebf9b913146b38da2eaa7aeddf76074ae1ad # v6.1.0
|
||||
uses: actions/setup-java@77dd5b2ce225ea11469928ac317850245a74ae78 # v6.2.0
|
||||
with:
|
||||
distribution: temurin
|
||||
java-version: '17'
|
||||
|
||||
@@ -142,7 +142,7 @@ jobs:
|
||||
echo "version=$version" >> "$GITHUB_OUTPUT"
|
||||
|
||||
- name: SonarQube Cloud scan
|
||||
uses: SonarSource/sonarqube-scan-action@d209202bc7d53ff1cc128f7f907dac145c9d6ae9 # v8.3.0
|
||||
uses: SonarSource/sonarqube-scan-action@e805d875275f728fac1885b413934be6d7c63f65 # v8.4.1
|
||||
env:
|
||||
SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }}
|
||||
with:
|
||||
|
||||
@@ -0,0 +1,196 @@
|
||||
# Accessibility
|
||||
|
||||
Last updated: 2026-11-09
|
||||
|
||||
Applies from: the release of version 4.6.0 (the website and the desktop and Android apps).
|
||||
|
||||
This is a hobby project run by one person, poli0981 (SkullMute), called "the Maintainer" below: a catalog of free itch.io games, on the website https://freeitchgames.win and in desktop and Android apps that show the same pages. Everyone should be able to use it, whether with a keyboard alone, a screen reader, zoom, a high-contrast theme, speech input or anything else. This statement says what works, how it is checked, what doesn't work yet, and how to tell the Maintainer when something gets in your way.
|
||||
|
||||
A Vietnamese translation is available at [`docs/i18n/vi/ACCESSIBILITY.md`](docs/i18n/vi/ACCESSIBILITY.md). If the two differ, this English version prevails.
|
||||
|
||||
> **TL;DR**
|
||||
>
|
||||
> - The goal is [WCAG 2.2](https://www.w3.org/TR/WCAG22/) Level AA for the website and the apps. That is a target, not a certificate: nobody outside the project has audited it.
|
||||
> - Every page works with the keyboard alone and with a screen reader. The Maintainer tests with the keyboard only, Windows Narrator, and VoiceOver on an iPhone.
|
||||
> - Colours meet the WCAG contrast ratios in the light and dark themes, and a test checks them on every change. Windows contrast themes are supported, and the site follows your system's "reduce motion" setting.
|
||||
> - Every chart comes with a data table.
|
||||
> - Known gaps are listed in [§6](#6-known-limitations).
|
||||
> - Something in your way? Open an [accessibility issue](https://github.com/poli0981/free-games-itchio-list/issues/new?template=accessibility.yml) or email **contact@poli0981.dev**.
|
||||
|
||||
## 1. Scope
|
||||
|
||||
This statement covers:
|
||||
|
||||
- **the website** https://freeitchgames.win: every public page (Home, Games, the game pages, Charts, Removed, Suggest, Settings, About, the error pages) and the verification page shown before them;
|
||||
- **the desktop apps** (Windows, macOS, Linux) **and the Android app**, which show the same pages in the system's web view.
|
||||
|
||||
It doesn't cover:
|
||||
|
||||
- the games themselves, their itch.io pages, and what their creators wrote or made (titles, descriptions, tags, cover images);
|
||||
- Cloudflare Turnstile, the third-party check on the verification page and on the Suggest form (Cloudflare is responsible for its accessibility);
|
||||
- the Maintainer's admin page, which has one user;
|
||||
- other sites the pages link to, GitHub included.
|
||||
|
||||
## 2. Goals and priorities
|
||||
|
||||
- **Target**: [WCAG 2.2](https://www.w3.org/TR/WCAG22/) Level AA, as far as a one-person hobby project can get.
|
||||
- **First**: the main tasks with a keyboard and a screen reader: find a game, read its details, open it on itch.io, change your settings, suggest a game.
|
||||
- **Then**: readable text and controls (contrast, zoom, reflow), no motion you didn't ask for, and the right language for screen readers (English or Vietnamese).
|
||||
- **Always**: new features keep all of this working (see [§8](#8-for-contributors)).
|
||||
|
||||
## 3. What works today
|
||||
|
||||
### Moving around
|
||||
|
||||
- "Skip to content" is the first thing the Tab key reaches.
|
||||
- Each page has named landmarks (header, main navigation, search, main content, pager, footer), one level-1 heading, and its own title.
|
||||
- After you follow a link inside the site, focus moves to the new page's heading, so a screen reader announces the page and Tab continues from there. Going back returns focus to the link you used, for example the game you opened from the list.
|
||||
- The sticky header never covers what has keyboard focus.
|
||||
|
||||
### Keyboard
|
||||
|
||||
- Everything works with the keyboard alone: menus, filters, dialogs and charts.
|
||||
- Focus is always visible: a purple outline, or the system highlight in a contrast theme.
|
||||
- Dialogs keep focus inside while they are open and return it to where you were when they close.
|
||||
- "/" jumps to the search box. You can switch this shortcut off in **Settings → Accessibility**, which helps with speech input or if the key clashes with your screen reader or your browser's quick find.
|
||||
- When a control disappears after you use it (clearing a search, removing a filter), focus moves to the next sensible place instead of getting lost.
|
||||
|
||||
### Screen readers
|
||||
|
||||
- Every control has a name, in English or Vietnamese. Icons are hidden from screen readers.
|
||||
- The number of results, search suggestions, loading states and form messages are announced.
|
||||
- On wide screens the game list is a table with column headers; on phones it is a simple list.
|
||||
- Links that open a new tab (in the apps: your browser) say so.
|
||||
- Text in the other language, such as the language names and the English-only names of the legal documents, is marked with its language.
|
||||
|
||||
### Seeing the content
|
||||
|
||||
- Text and controls meet the WCAG 2.2 AA contrast ratios in both themes: 4.5:1 for text, 3:1 for field borders, the focus outline and chart colours. The test [`webapp/scripts/check-contrast.test.mjs`](webapp/scripts/check-contrast.test.mjs) checks the colours on every change.
|
||||
- Light, dark or system theme, compact or normal rows, and hidden scrollbars: all in Settings.
|
||||
- Windows contrast themes (forced colours): the selected tab, pressed toggles, the current page and switches use the system's highlight colours.
|
||||
- Zoom is never blocked. At 400 % zoom or in a 320-pixel-wide window the phone layout takes over, and the page doesn't scroll sideways.
|
||||
- Links inside sentences are underlined. Nothing is shown by colour alone: states also change the text, an outline or an underline.
|
||||
|
||||
### Motion
|
||||
|
||||
- With "reduce motion" switched on in your system, animations, chart entrances and smooth scrolling are off.
|
||||
- On the website, covers are normally shown as still images (animated covers are turned into stills).
|
||||
- Apart from loading placeholders, nothing moves on its own.
|
||||
|
||||
### Charts
|
||||
|
||||
- Each chart is named after its heading. Focus it and use the left and right arrow keys: the value you move to is read out.
|
||||
- Under every chart, **Data table** opens the same numbers as a table, with each part's share for the pie charts.
|
||||
|
||||
### Language
|
||||
|
||||
- The pages are in English or Vietnamese (Settings), and the page language follows your choice, so screen readers pick the right voice. Numbers and dates follow it too.
|
||||
|
||||
## 4. How it is tested
|
||||
|
||||
- **By the Maintainer, by hand** (November 2026): the website on Windows 11 and the Windows desktop app, with the keyboard only (mouse switched off) and Windows Narrator. No blocking problems were found.
|
||||
- **On a real phone** (November 2026, version 4.6.0): the website on an iPhone 14 Pro with VoiceOver, in Safari, Chrome and Brave. It passed.
|
||||
- **For 4.6.0**: the main pages and dialogs were walked through with the keyboard, and their accessibility tree was checked (names, roles, headings, landmarks, announcements) in English and Vietnamese, on a desktop and a phone-sized screen.
|
||||
- **Automatically, on every change**: the contrast test above and the app's unit tests (where focus goes after a page change, the chart tables).
|
||||
- **Before each release**: a short smoke test. That means a keyboard pass through the main tasks, a screen reader spot check, 200 % zoom and a narrow window, reduced motion, and a Windows contrast theme.
|
||||
- **Not yet**: automated browser scans (such as axe or Lighthouse) in CI, and testing by people who use a wide range of assistive technology every day. Help is welcome.
|
||||
|
||||
## 5. Supported environments
|
||||
|
||||
| | Versions |
|
||||
|---|---|
|
||||
| Website | Current Chrome, Edge, Firefox and Safari on computers and phones. The oldest versions the site is built for are Chrome and Edge 111, Firefox 114, and Safari and iOS 15.4. |
|
||||
| Desktop apps | Windows 10 and 11 (Microsoft Edge WebView2), macOS (WebKit 16.4 or newer), Linux (WebKitGTK 4.1) |
|
||||
| Android app | Android 11 or newer |
|
||||
|
||||
Assistive technology:
|
||||
|
||||
- **Tested**: Windows Narrator on Windows 11, VoiceOver on iOS (iPhone 14 Pro: Safari, Chrome and Brave), and keyboard-only use.
|
||||
- **Expected to work, not regularly tested**: NVDA and JAWS on Windows, VoiceOver on macOS, TalkBack on Android, browser zoom, Windows contrast themes, speech input. They rely on the same standard markup.
|
||||
- **Limited**: Orca in the Linux desktop app, because WebKitGTK supports screen readers less well than the browsers do.
|
||||
|
||||
## 6. Known limitations
|
||||
|
||||
- **Creators' text isn't marked with its language.** Game titles, descriptions and tags come from itch.io in many languages, and a screen reader reads them in the page's language.
|
||||
- **Cover images have a generic description** ("Game name cover"). What the image shows isn't described.
|
||||
- **Charts**: the arrow keys only move left and right. The genre treemap can't be stepped through, but its numbers are in its data table and in the Genres chart. Chart text has a fixed pixel size, so a larger default font size in your browser doesn't change it (page zoom does).
|
||||
- **Desktop apps**: there are no zoom keys inside the app, the window can't be maximized, and it can't be made smaller than 900 × 600. If you need larger text, use your system's display scaling or the website in a browser.
|
||||
- **Android app**: pinch-to-zoom is off. The website can be zoomed in your phone's browser.
|
||||
- **Animated covers in the apps**: the apps load covers straight from itch.io, so an animated cover keeps playing there.
|
||||
- **Cloudflare's checks**: the verification check (website only) and the anti-spam check on the Suggest form are Cloudflare Turnstile widgets. They usually pass without anything to do. If one ever asks for something you can't do, email the Maintainer.
|
||||
- **GitHub pages**: the policies, this statement and the issue forms live on GitHub, so GitHub's own accessibility applies there.
|
||||
- **No external audit**, and one maintainer.
|
||||
|
||||
## 7. Reporting an accessibility barrier
|
||||
|
||||
If something stops you or slows you down, please say so. Partial reports help too.
|
||||
|
||||
- **GitHub**: open an [Accessibility barrier issue](https://github.com/poli0981/free-games-itchio-list/issues/new?template=accessibility.yml).
|
||||
- **Email**: **contact@poli0981.dev**. No GitHub account needed; English or Vietnamese both work.
|
||||
|
||||
Details that help, as far as you're comfortable sharing them (never send health information):
|
||||
|
||||
- what you were trying to do, and what happened instead;
|
||||
- the page (its address) or the app and its version, shown on the About page;
|
||||
- your device, operating system and browser;
|
||||
- the assistive technology you use and its version, if any;
|
||||
- a screenshot or a recording, if you can.
|
||||
|
||||
How much it gets in your way:
|
||||
|
||||
| Severity | Meaning |
|
||||
|---|---|
|
||||
| Critical | You can't do a main task at all, for example open a game or read its details. |
|
||||
| Serious | You can, but only with great effort or a workaround. |
|
||||
| Moderate | It's annoying or inconsistent, but you get there. |
|
||||
| Minor | A small polish issue. |
|
||||
|
||||
What happens next. These are targets, not guarantees, since this is a solo hobby project:
|
||||
|
||||
- **Acknowledgement** within 7 days, often sooner.
|
||||
- **A fix or a workaround**: Critical within 30 days, Serious within 60 days, Moderate and Minor in a later release.
|
||||
- **Website fixes** go live when they are deployed; **app fixes** come with the next release.
|
||||
- You'll be asked whether the fix works for you, and credited in the release notes if you want.
|
||||
|
||||
Security vulnerabilities don't belong in a public issue: see [SECURITY.md](SECURITY.md).
|
||||
|
||||
## 8. For contributors
|
||||
|
||||
Changes to the interface must keep [§3](#3-what-works-today) true:
|
||||
|
||||
- **Keyboard**: every control can be reached and used, focus stays visible and never gets lost.
|
||||
- **Names**: every control has a label, with its text in both `webapp/src/lib/i18n/en.ts` and `vi.ts`.
|
||||
- **Colour**: use the theme tokens. `npm test` checks contrast (4.5:1 for text, 3:1 for borders, focus and chart colours), and colour is never the only signal.
|
||||
- **Motion**: respect `prefers-reduced-motion`; the shared CSS rule and `SERIES_ANIMATION` already do.
|
||||
- **Screen reader**: check the change once with one (Narrator, NVDA, VoiceOver or TalkBack).
|
||||
- **Markup**: prefer native elements and the Radix / shadcn components already in use, and add ARIA only when it's needed.
|
||||
|
||||
Documentation: headings in order, link text that says where it goes, alt text for images, header cells in tables, and the Vietnamese translation updated (or say in the pull request that it isn't).
|
||||
|
||||
The [pull request template](.github/pull_request_template.md) has the checklist.
|
||||
|
||||
## 9. Finding accessible games
|
||||
|
||||
The catalog shows the accessibility features that creators list on their itch.io pages, such as subtitles, configurable controls or colour-blind modes:
|
||||
|
||||
- on each game's page, under "Accessibility";
|
||||
- as the Accessibility filter on the Games page, for example https://freeitchgames.win/games?access=Subtitles;
|
||||
- in the "Accessibility Features" chart (Charts → Discovery).
|
||||
|
||||
Creators declare these features themselves, and the project doesn't verify them. If a game's information is wrong, report it with the "Bug Report" issue template.
|
||||
|
||||
## 10. References
|
||||
|
||||
- [Open Source Guides: Accessibility best practices for your project](https://opensource.guide/accessibility-best-practices-for-your-project/)
|
||||
- [Open Source Accessibility toolkit](https://github.com/open-source-accessibility/accessibility-toolkit): this statement follows the outline of its ACCESSIBILITY.md example, in its own words.
|
||||
- [Web Content Accessibility Guidelines (WCAG) 2.2](https://www.w3.org/TR/WCAG22/)
|
||||
- [W3C: Developing an accessibility statement](https://www.w3.org/WAI/planning/statements/)
|
||||
|
||||
## 11. Contact
|
||||
|
||||
- **Accessibility barriers**: the [issue form](https://github.com/poli0981/free-games-itchio-list/issues/new?template=accessibility.yml) or **contact@poli0981.dev**.
|
||||
- **Everything else**: see the addresses in [README → Legal](README.md#legal).
|
||||
|
||||
## 12. Final vibes
|
||||
|
||||
One person, one catalog, every way of browsing it. If something here doesn't work the way you use the web, the Maintainer would really like to hear it — that's how this list gets better. 🚀
|
||||
+5
-1
@@ -3,12 +3,16 @@
|
||||
All notable changes to this project, newest first. The notes of each release live in
|
||||
[`changelog/`](changelog/), one file per minor version: `changelog/<major>.x/ver<major>.<minor>.x.md`.
|
||||
|
||||
**Latest release: [4.4.3](changelog/4.x/ver4.4.x.md#443---2026-10-26-dependency-and-security-updates) (2026-10-26) — Dependency and security updates.**
|
||||
**Latest release: [4.6.2](changelog/4.x/ver4.6.x.md#462---2026-11-16-dependency-updates) (2026-11-16) — Dependency updates.**
|
||||
|
||||
## 4.x
|
||||
|
||||
| Version | Date | Highlights |
|
||||
|---|---|---|
|
||||
| [4.6.2](changelog/4.x/ver4.6.x.md#462---2026-11-16-dependency-updates) | 2026-11-16 | Dependency updates (wry 0.57.2: app crash fixes) |
|
||||
| [4.6.1](changelog/4.x/ver4.6.x.md#461---2026-11-11-stable-maintenance-mode) | 2026-11-11 | Stable: maintenance mode (data-only issues and PRs), Qodana code analysis |
|
||||
| [4.6.0](changelog/4.x/ver4.6.x.md#460---2026-11-09-accessibility) | 2026-11-09 | Accessibility: statement, keyboard and screen-reader fixes, chart data tables, WCAG contrast |
|
||||
| [4.5.0](changelog/4.x/ver4.5.x.md#450---2026-10-27-rate-limits-for-the-whole-site) | 2026-10-27 | Rate limits for the whole site (HTTP 429), WAF guide |
|
||||
| [4.4.3](changelog/4.x/ver4.4.x.md#443---2026-10-26-dependency-and-security-updates) | 2026-10-26 | Dependency and security updates (build-tool advisories closed) |
|
||||
| [4.4.2](changelog/4.x/ver4.4.x.md#442---2026-10-22-toolchain-upgrade-code-scan-fixes) | 2026-10-22 | Toolchain upgrade (TypeScript 7, Node 26, Python 3.15), code-scan fixes |
|
||||
| [4.4.1](changelog/4.x/ver4.4.x.md#441---2026-10-16-extension-and-bot-retired) | 2026-10-16 | Extension and bot retired (archived repos), ingest API removed |
|
||||
|
||||
@@ -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:
|
||||
|
||||
1. **Python pipeline** — the data layer (GitHub Actions).
|
||||
- `data_game/game_info_NNN.json` — chunked records, max 500 per file, 3,251 games on 2026-10-10. Serialization is fixed: `json.dumps(..., ensure_ascii=False, indent=4)`, no trailing newline (`json_io.dumps`) — the Worker port (`webapp/worker/catalog.ts`) emits identical bytes (`tests/fixtures/golden/`).
|
||||
- `data_game/game_info_NNN.json` — chunked records, max 500 per file, 6,069 games on 2026-11-16. Serialization is fixed: `json.dumps(..., ensure_ascii=False, indent=4)`, no trailing newline (`json_io.dumps`) — the Worker port (`webapp/worker/catalog.ts`) emits identical bytes (`tests/fixtures/golden/`).
|
||||
- `data_game/index.json` — chunk manifest (total + per-file counts). `data_game/count_history.json` — date-keyed `{date,total}` series ("games over time" chart). `scripts/deleted_games.json` — removal log (public "Removed" page). `scripts/temp_link.json` — ingest queue.
|
||||
- `scripts/` — scanners never write the catalog: `update_info.py` (queued URLs) and `refresh.py` (rotating 1/7-per-day check; `--full` re-scrape) emit a URL-keyed **patch** (`patch.py`); `apply_patch.py` applies it to the latest `main` and runs `validate.py`; `bash/commit_push.sh` does fetch → reset → apply → commit → push with retries. Shared: `scraper.py` (session, `Pacer` + 429 back-off, parsing: the info panel incl. itch.io's 2025–26 rows — `AI Disclosure` ("AI Assisted", then what for) / `Content` linking `/games/tag-no-ai` → `ai_disclosure` + `ai_content`, `Accessibility` → `accessibility`; `description` = the creator's tagline (`og:description`), else the first sentence), `data_store.py` (chunks stay in place, rebalance only past thresholds, write-if-changed), `json_io.py`, `canonical.py` (canonical itch.io URL; vectors in `tests/fixtures/url_vectors.json`, shared with the Worker). Pipeline bookkeeping lives in `scripts/state/` (not published), 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.
|
||||
@@ -42,6 +42,7 @@ Local admin without Access: put `DEV_ADMIN_EMAIL=you@example.com` in `webapp/.de
|
||||
## Worker (`webapp/worker/`)
|
||||
|
||||
- `index.ts` routes: `/img/*` (img.ts, behind the gate), `/api/health`, `/api/verify` (gate.ts), `/api/suggest` (suggest.ts), `/api/admin/*` + `/admin*` (admin.ts), the readable `/data/*.json` (legacy-data.ts), everything else that misses an asset → `spa.ts`. `run_worker_first` also lists `/` (otherwise served straight from `dist/index.html`) so the gate sees it, and the five legacy catalog files one by one (never a `!` pattern — gotcha 26). `scheduled()` (cron `23 */4 * * *`), four steps each in its own try/catch: `discover.ts` (one itch.io RSS feed per run, 6 h back-off on 429) → `QueueStore.reconcile` (queued → ingested / failed with the pipeline's outcome, read at head through the GitHub App; else in the catalog → ingested, > 3 days → failed `timeout`) → `automation.ts` (auto-approve + followed collections, ≤ 30 itch.io pages a run, ONE `[auto]` commit, D1 written only after it lands; the run's summary in settings `automation_last_run`) → `purge` (Suggest notes 180 d). The account is on **Workers Paid** (30 s CPU): admin catalog edits parse and rewrite ~3.8 MB in the Worker (≈ 25–30 ms for 100 removals).
|
||||
- `ratelimit.ts` (since 4.5): every Worker request is counted first, per IP (IPv6 /64, `rateKey`) and per Cloudflare location (approximate, fails open), in one `ratelimits` binding per kind of traffic (counted per machine of the data centre: it holds for one-connection clients, the WAF holds for floods — gotcha 43) — `RL_SITE` 120/60 s (pages, public `/api`, legacy `/data`, misses), `RL_IMG` 600, `RL_ADMIN` 300; `RL_SUGGEST` 5 and `RL_GATE` 20 still apply on top to those POSTs. Verified bots (the gate's header) are not counted. Over a limit: 429 + `Retry-After: 60` — JSON `rate_limited` for `/api`, `/img`, files and `/data` (with CORS), the script-less EN/VI page of `gate-page.ts` for app pages. Keep every `period` 60 and a unique `namespace_id` in 88xx (staging 89xx): namespaces are **account-wide** and other Workers on the account (repolens, ticktune…) use 1001–1006, so the old 1001 / 1003 shared their counters (`ratelimit.test.ts` reads `wrangler.jsonc`). Layer 1 is the zone's WAF rate-limiting rule (Free plan: one rule, IP, 10 s; `docs/operations.md` §1 step 15): only it saves the Worker request a flood costs, and only it covers static assets.
|
||||
- `img.ts`: `/img/<160|640>/<path on img.itch.zone>` — allow-listed against `data/urls.json`, edge cache → R2 `THUMBS` (`w{w}/<sha256>.webp`) → `cf.image` transform (stored once) → fallback streams the original with a 1-day cache (quota error 9422). The fallback original and a missing upstream image are also kept in `caches.default` for a day (GET only); widths are the exact strings `160` / `640` (a `Map`, no `Number()` aliases); background puts log failures. Upstream errors → controlled 502.
|
||||
- `spa.ts`: `not_found_handling` is `"none"`, so misses reach the Worker: `/assets/*`, `/data/*` (a pack from an older deploy included — `no-store`, CORS) and file-like paths get a real 404 (`no-store`); app routes get the shell with 200; unknown paths and game slugs not in the catalog get the shell with **404**; with the gate on, a visitor without a pass gets the verification page instead (checked before the shell is fetched, so never a 304). Keep its `ROUTES` in sync with `src/App.tsx` and `src/hooks/useSeoHead.ts`.
|
||||
- `gate.ts` + `gate-page.ts`: the **verification gate** (web only). App pages and `/img` need a pass: the `__Host-fig_gate` cookie (HMAC of its issue time, HttpOnly, `BOT_GATE_TTL_HOURS`, default 48) set by `POST /api/verify` after a Turnstile check (action `gate`, `RL_GATE`, same-origin); `GET /api/verify` reports `{enabled, valid, via, ttl}`. The page is self-contained (inline CSS/JS with a per-response CSP nonce, EN/VI, the site's og tags, 200 + noindex). Verified bots pass with `x-fig-known-bot: <GATE_BOT_TOKEN>` from a zone Transform Rule; clients that only claim to be a crawler get 503. `/assets`, `/data`, `/api/*`, `/admin*` and the other static files stay open. `turnstile.ts`: siteverify shared with Suggest (hostname + action checked; the test secrets skip both).
|
||||
@@ -59,14 +60,15 @@ Local admin without Access: put `DEV_ADMIN_EMAIL=you@example.com` in `webapp/.de
|
||||
- Cache: react-query persisted to IndexedDB (`webapp.query-cache`, 7 days) by `lib/data/persister.ts` — byte 0 = format (1 deflate-raw, 0 plain), then the JSON; a legacy string is dropped; writes throttled 1 s and skipped when no data object changed. Persisted: `db`, `deleted`, `count-history` and only the `desc` files the current catalog names (`shouldPersistQuery`); stale `desc` queries are removed after a `db` success. `CACHE_BUSTER = ${APP.version}:data-v2`. **`gcTime` must stay >= persist `maxAge`.**
|
||||
- Layout: `components/site/*` (sticky top nav + global search with the `/` shortcut + display menu + phone sheet menu; footer) — the window scrolls, not `<main>`. `/` is the Welcome page (`routes/welcome.tsx`).
|
||||
- `/games`: search, filters, sort and page live in the URL — `lib/game-filters.ts` (`parseQuery` / `toParams` drop defaults; params `q genre platform status tag lang input engine ai access rating browser sort page`; `ai` treats "N/A" / a missing field as its own "Not disclosed" value and lists its options in a fixed order (`aiRank`); unit-tested) — rendered by `components/games/*` (filter chips with facet counts that ignore their own filter, a desktop ARIA table / phone list chosen by `useIsMobile`, 100 per page; the detail page's breadcrumb links back to the same list via router state). Counts show the whole catalog ("2,729 of 2,811") because 18+ games are hidden by default.
|
||||
- `components/charts/` (19 charts, 4 lazy tabs loaded with `lib/lazy-preload.ts` — preloaded when idle or on hover/focus, rendered without a Suspense fallback once loaded — and kept mounted once shown (gotcha 33; skeletons in `chart-skeletons.tsx` match the cards), every series spreading `SERIES_ANIMATION` (300 ms, no delay; a test checks), **no barrel `index.ts`**; every Recharts tooltip/cursor comes from `chart-theme.ts` + `chart-tooltip.tsx`, every pie legend from `LEGEND_BASE` there; below `md` the charts get 12 px legends / 11 px ticks from a media block in `index.css`, the tab bar is one row of equal tabs, and Languages / Avg session switch to horizontal bars via `useIsMobile`), `components/game-thumb.tsx` (`lib/thumbnail.ts` → `/img/160|640/...` on the web, the original URL in Tauri), `components/legal-gate.tsx` (a non-dismissable Radix dialog **over** the page, so deep links land where they pointed; links flagged `inGate` in `lib/about.ts`; re-prompts when `LEGAL_VERSION` in `stores/prefs.ts` changes; no "Leave" button in Tauri).
|
||||
- Styling: **Tailwind v4** via `@tailwindcss/vite` (no PostCSS, no `tailwind.config`); tokens are hex CSS variables in `src/index.css` (`:root` / `.dark`, `@theme inline`; `--brand-soft`, `--thumb`, `--success`, `--scrollbar-thumb(-hover/-active)` besides the shadcn set) and must match the approved mockup. Themed scrollbars (`@layer base`, only under `(hover: hover) and (pointer: fine)`): `::-webkit-scrollbar*` for Chromium/Safari, `scrollbar-color` / `scrollbar-width: thin` for Firefox only (gotcha 28); "Hide scrollbars" = unlayered `html[data-scrollbars='hidden']` rules (`hooks/useScrollbarsEffect.ts`). On mouse devices `<html>` reserves the scrollbar gutter, released while a dialog locks scrolling (gotcha 35). The theme: `stores/theme.ts` (synced across tabs, site ↔ admin), `hooks/useThemeEffect.ts` (`.dark` + the `theme-color` metas), an inline pre-paint script in both HTML entries (gotcha 34), and the display menu's button shows `components/theme-icon.ts`'s icon for the theme in use. Self-hosted Geist / Geist Mono (`@fontsource-variable/*`, CSP `font-src 'self'`). Numbers and dates go through `lib/format.ts` (`useFormat`: en-GB / vi-VN). `webapp/scripts/gen_assets.py` redraws favicon, PWA icons and `og.png` from the same tokens and the Geist fonts in `node_modules`.
|
||||
- `components/charts/` (19 charts, 4 lazy tabs loaded with `lib/lazy-preload.ts` — preloaded when idle or on hover/focus, rendered without a Suspense fallback once loaded — and kept mounted once shown (gotcha 33; skeletons in `chart-skeletons.tsx` match the cards), every series spreading `SERIES_ANIMATION` (300 ms, no delay; a test checks), **no barrel `index.ts`**; every Recharts tooltip/cursor comes from `chart-theme.ts` + `chart-tooltip.tsx`, every pie legend from `LEGEND_BASE` there; every chart container spreads `chartAria(id)` (named by its card's h2 + description + arrow-key hint), every `<Pie>` has `rootTabIndex={-1}`, every `ChartCard` gets an `id` and a `table` (a lazy `<details>` "Data table" built with `lib/chart-table.ts`), and the tooltip reads its text into the card's polite live region through `ChartAnnounce` (a ref, no re-render — gotcha 33); `chart-theme.test.ts` checks all four; below `md` the charts get 12 px legends / 11 px ticks from a media block in `index.css`, the tab bar is one row of equal tabs, and Languages / Avg session switch to horizontal bars via `useIsMobile`), `components/game-thumb.tsx` (`lib/thumbnail.ts` → `/img/160|640/...` on the web, the original URL in Tauri), `components/legal-gate.tsx` (a non-dismissable Radix dialog **over** the page, so deep links land where they pointed; links flagged `inGate` in `lib/about.ts`; re-prompts when `LEGAL_VERSION` in `stores/prefs.ts` changes; no "Leave" button in Tauri).
|
||||
- Styling: **Tailwind v4** via `@tailwindcss/vite` (no PostCSS, no `tailwind.config`); tokens are hex CSS variables in `src/index.css` (`:root` / `.dark`, `@theme inline`; `--brand-soft`, `--thumb`, `--success`, `--scrollbar-thumb(-hover/-active)` besides the shadcn set) and must match the approved mockup — except where WCAG 2.2 AA needed more (4.6.0): `--primary` #6a48f5 (white text 5.44:1), `--primary-text` for purple text (#9a83ff in dark), `--input` #8a8a93 / #6b6b75 for field borders and the off switch (3:1), `--destructive-solid` for filled destructive buttons; `--brand` keeps the mockup's #7c5cff for the logo (as do the favicon, `og.png`, the app icons and the gate page's logo). `webapp/scripts/check-contrast.test.mjs` fails CI when a token pair or a chart colour (`components/charts/palette.ts`) drops below 4.5:1 (text) / 3:1 (borders, ring, chart marks); `lib/color.ts` does the maths. A `@media (forced-colors: active)` block gives selected tabs / pressed toggles / the current page / the active option and switches the system highlight (Windows contrast themes). Themed scrollbars (`@layer base`, only under `(hover: hover) and (pointer: fine) and (forced-colors: none)`): `::-webkit-scrollbar*` for Chromium/Safari, `scrollbar-color` / `scrollbar-width: thin` for Firefox only (gotcha 28); "Hide scrollbars" = unlayered `html[data-scrollbars='hidden']` rules (`hooks/useScrollbarsEffect.ts`). On mouse devices `<html>` reserves the scrollbar gutter, released while a dialog locks scrolling (gotcha 35). The theme: `stores/theme.ts` (synced across tabs, site ↔ admin), `hooks/useThemeEffect.ts` (`.dark` + the `theme-color` metas), an inline pre-paint script in both HTML entries (gotcha 34), and the display menu's button shows `components/theme-icon.ts`'s icon for the theme in use. Self-hosted Geist / Geist Mono (`@fontsource-variable/*`, CSP `font-src 'self'`). Numbers and dates go through `lib/format.ts` (`useFormat`: en-GB / vi-VN). `webapp/scripts/gen_assets.py` redraws favicon, PWA icons and `og.png` from the same tokens and the Geist fonts in `node_modules`.
|
||||
- `lib/gate.ts` (web only): when a tab comes back into view or a cover fails and the verification pass may have run out (`webapp.gate` hint), it asks `GET /api/verify` and reloads into the verification page; `lib/reload.ts` is the shared at-most-every-30-s reload guard.
|
||||
- `hooks/useSeoHead.ts` sets canonical + robots per route (index.html has no static canonical/og:url on purpose).
|
||||
- Accessibility (statement: root `ACCESSIBILITY.md`; target WCAG 2.2 AA): after an in-app navigation `App.tsx`'s ScrollManager moves focus to the new page's h1 (`lib/route-focus.ts` decides: not on first load or query-only changes; a #hash focuses its section; Back focuses the link last used on that entry), waiting for lazy routes with `components/focus-target.ts` (`whenPresent`, 10 s; `focusElement` adds `tabindex=-1` + `data-focus-target`, which hides the ring). Dialogs without a trigger return focus themselves (18+: the opener, `requestNsfw(returnFocus)`; legal gate: the page h1); menus that navigate `preventDefault` their `onCloseAutoFocus` (gotcha 46). The "/" shortcut is a pref (`slashShortcut`, Settings → Accessibility; WCAG 2.1.4). `CardTitle` renders an h2. `ExtLink` appends "(opens in a new tab)" / "(opens in your browser)" for screen readers. English-only strings shown on a Vietnamese page carry `lang="en"`; `<html lang>` turns `vi` only once the VI dictionary is in. `html { scroll-padding-top }` keeps focus clear of the sticky header. No a11y linter: `eslint-plugin-jsx-a11y` peers ESLint ≤ 9.
|
||||
- `lib/i18n/` — `en.ts` is the source of truth; `vi.ts` is `Record<MessageKey, string>` and must never be static-imported (lazy chunk).
|
||||
- `stores/` — Zustand: `prefs` (`webapp.prefs`: language, density, `hideScrollbars`, legal acceptance…), `theme` (`webapp.theme`).
|
||||
- `lib/about.ts` — keep `THIRD_PARTY` up to date when adding npm deps; `LEGAL_LINKS`; `APP.version`.
|
||||
- Code split (`vite.config.ts` rolldown `codeSplitting.groups`): `vendor-react` (priority 100 — must claim React first), `vendor-query`, `vendor-ui`. There is deliberately **no vendor-charts group** (it pulled React/clsx in and put Recharts on the first load); Recharts stays in the lazy chart chunks. Initial load ≈ 179 KB gzip (JS + CSS, gzip -9; 4.2 added ~4.6 KB for the pack loader, persister and `useQueries`) plus ~51 KB of Geist woff2; catalog data on a first visit ≈ 264 KB (main packs + log + history), descriptions ≈ 170 KB on demand. `fflate` is a lazy chunk, never preloaded. Web build `target` is Safari/iOS 15.4 (Radix class static blocks otherwise break iOS 15); Tauri uses the default.
|
||||
- Code split (`vite.config.ts` rolldown `codeSplitting.groups`): `vendor-react` (priority 100 — must claim React first), `vendor-query`, `vendor-ui`. There is deliberately **no vendor-charts group** (it pulled React/clsx in and put Recharts on the first load); Recharts stays in the lazy chart chunks. Initial load ≈ 189 KB gzip (JS + CSS, gzip -9, measured for 4.6.0; 4.2 added ~4.6 KB for the pack loader, persister and `useQueries`, 4.6 ~3 KB for focus management and the accessibility strings) plus ~51 KB of Geist woff2; catalog data on a first visit ≈ 264 KB (main packs + log + history), descriptions ≈ 170 KB on demand. `fflate` is a lazy chunk, never preloaded. Web build `target` is Safari/iOS 15.4 (Radix class static blocks otherwise break iOS 15); Tauri uses the default.
|
||||
|
||||
## Editable vs read-only fields
|
||||
|
||||
@@ -82,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. |
|
||||
| `python-ci.yml` / `webapp-ci.yml` | PRs (+ pushes for Python) | ruff + format + vulture + pytest + `validate.py` (both requirements locks installed at once, so drifting pins fail) / `npm ci --ignore-scripts` + `npm run check:tauri` (gotcha 31) + `npm run cf:types -- --check` + lint + knip + vitest + build + `npm run cf:check` (`wrangler deploy --dry-run`). SonarQube Cloud runs in `sonarcloud.yml`. |
|
||||
| `sonarcloud.yml` | Push to `main` + PRs (both skip data-only and `.md`-only changes) + `workflow_dispatch` | SonarQube Cloud CI analysis (gotcha 41): `token` (no `SONAR_TOKEN` — Dependabot and fork PRs — → notice, the rest skipped) → `coverage` (pytest-cov + Vitest v8, no secrets; artifact kept 1 day) → `scan` (`sonarqube-scan-action`, full history, `sonar.projectVersion` from `webapp/package.json`; the only step that uses the token). |
|
||||
| `qodana.yml` | Push to `main` + PRs (both skip data-only and `.md`-only changes) + `workflow_dispatch` | Qodana (JetBrains) analysis (gotcha 49): `tokens` (no Qodana secrets — Dependabot and fork PRs — → notice, the rest skipped) → three jobs, one per Qodana Cloud project and token: `typescript` (`qodana-js`, native, `webapp/qodana.yaml`), `python` (`qodana-python`, native, root `qodana.yaml`), `rust` (`qodana-rust`, Docker image, `webapp/src-tauri/qodana.yaml`). Whole-project scans (`pr-mode: false`), no PR comment; each `qodana.yaml` has a quality gate of 0 problems (`failureConditions`), so a finding fails its job. |
|
||||
| `deploy-status.yml` | Hourly + manual | Not a deploy. `bash/cf_build_status.sh` walks main's first-parent history to the latest finished `Workers Builds: free-games-itchio-list` check run (Cloudflare posts it only when a build ends; branch commits carry preview builds under the same name) and alerts once per failed build (cache key per check-run id, saved after the Discord post). Scheduled because GitHub never starts `check_run` workflows for `GITHUB_TOKEN` pushes (the data commits). |
|
||||
| `release_desktop.yml` | Tag `v*` push, or manual | `create-release` makes the single draft (id passed to tauri-action v1 `releaseId`); release builds use **no** npm/cargo caches (cache-poisoning). Win + macOS aarch64 + macOS x86_64 (cross-compile) + Linux (`ubuntu-22.04` for a low glibc floor). Uploads `.dmg` / `.app.tar.gz` / `.pkg` (macOS), `.msi` / `.exe` (Windows), `.deb` / `.rpm` / `.AppImage` (Linux). macOS `.pkg` `--identifier` reads `tauri.conf.json`. |
|
||||
| `release_android.yml` | Tag `v*` push, or manual | Tauri **Android** build → arm64-v8a APK, **post-signed** with `zipalign`+`apksigner` (gen/ stays gitignored). Tag → attaches to the same draft Release; manual dispatch → workflow artifact. Secrets: `ANDROID_KEYSTORE_BASE64` / `ANDROID_KEYSTORE_PASSWORD` / `ANDROID_KEY_ALIAS`. |
|
||||
@@ -105,7 +108,7 @@ Draft-first: **never** `gh release create` by hand before CI — tauri-action v1
|
||||
|
||||
## Licenses & policies
|
||||
|
||||
Code **MIT** (`LICENSE`); catalog data **CC BY 4.0** for the maintainer's contribution — excluding creators' descriptions, cover images, names/trademarks (`data_game/LICENSE.md`, `LICENSES/CC-BY-4.0.txt`); docs **CC BY 4.0**; map + non-affiliation in `NOTICE.md`. Policies (EN in `docs/`, VI mirrors in `docs/i18n/vi/`, English controls): ToS (website + data + content removal), EULA (desktop/Android binaries only; also `webapp/src-tauri/installer/EULA.rtf`), Privacy Policy, Disclaimer, `SECURITY.md`, `CODE_OF_CONDUCT.md`. When a policy changes, bump `LEGAL_VERSION` (`webapp/src/stores/prefs.ts`) and the dates in `about.legal.desc` (EN/VI) so the legal gate asks again. Contact addresses `contact@ / legal@ / privacy@ / security@ / takedown@poli0981.dev` are aliases of the maintainer's Google Workspace mailbox (not Cloudflare Email Routing; the Privacy Policy lists Google as the email processor). The maintainer's site https://poli0981.dev/ and channel hub https://poli0981.dev/links/ are linked from the About page (`DEV` in `lib/about.ts`).
|
||||
Code **MIT** (`LICENSE`); catalog data **CC BY 4.0** for the maintainer's contribution — excluding creators' descriptions, cover images, names/trademarks (`data_game/LICENSE.md`, `LICENSES/CC-BY-4.0.txt`); docs **CC BY 4.0**; map + non-affiliation in `NOTICE.md`. Policies (EN in `docs/`, VI mirrors in `docs/i18n/vi/`, English controls): ToS (website + data + content removal), EULA (desktop/Android binaries only; also `webapp/src-tauri/installer/EULA.rtf`), Privacy Policy, Disclaimer, `SECURITY.md`, `CODE_OF_CONDUCT.md`. `ACCESSIBILITY.md` (root: GitHub's accessibility community health file; VI mirror `docs/i18n/vi/ACCESSIBILITY.md`) is a statement, not a policy to accept — no `LEGAL_VERSION` bump when it changes, but keep its §3 (what works) and §6 (known limitations) in step with the code; barriers come in through `.github/ISSUE_TEMPLATE/accessibility.yml` (label `accessibility`) or contact@. When a policy changes, bump `LEGAL_VERSION` (`webapp/src/stores/prefs.ts`) and the dates in `about.legal.desc` (EN/VI) so the legal gate asks again. Contact addresses `contact@ / legal@ / privacy@ / security@ / takedown@poli0981.dev` are aliases of the maintainer's Google Workspace mailbox (not Cloudflare Email Routing; the Privacy Policy lists Google as the email processor). The maintainer's site https://poli0981.dev/ and channel hub https://poli0981.dev/links/ are linked from the About page (`DEV` in `lib/about.ts`).
|
||||
|
||||
## Known gotchas (cost a release each — don't relearn)
|
||||
|
||||
@@ -150,7 +153,15 @@ Code **MIT** (`LICENSE`); catalog data **CC BY 4.0** for the maintainer's contri
|
||||
39. **Dependabot's pip updater reads `.python-version` and aborts on a Python it doesn't support** (3.10–3.14 as of Oct 2026): a `3.15` there stopped pip version updates and the pip dependency graph ("Dependabot detected the following Python requirement … '3.15.*'"). So the CI pin lives in `.github/python-version`, which only `setup-python`'s `python-version-file` reads (python-ci, refresh ×2, update); move it back to `.python-version` once Dependabot lists 3.15.
|
||||
40. **The Python requirements are hash-locked pip-tools compiles** — `requirements.txt` ← `requirements.in`, `requirements-dev.txt` ← `requirements-dev.in` (`-c requirements.txt`) — installed everywhere with `--require-hashes --only-binary :all:`, so a new release of any dependency, indirect ones included, can't reach the jobs that push to `main`, and no sdist build script runs. After editing a `.in`, recompile with **pip-tools on Python 3.14**: `pip-compile --generate-hashes --allow-unsafe --strip-extras requirements.in`, then the same for `requirements-dev.in`. Dependabot takes the Python version from the `# … autogenerated by pip-compile with Python X.Y` header and supports ≤ 3.14 (gotcha 39); the hashes cover every file of a release, so CI's 3.15 still finds its cp315 wheels. `colorama` is listed in `requirements-dev.in` because pytest needs it on Windows only: a lock compiled on Linux (Dependabot's) would otherwise leave it out and the hash-checked local install would fail. Keep those pip commands in a block scalar (`run: |`): in a plain YAML scalar the `: ` of `:all: -r` makes the whole workflow file invalid — GitHub then records a 0-job failed push run named after the file, and a PR simply shows no check for that workflow.
|
||||
41. **SonarQube Cloud analyses in CI** (`sonarcloud.yml` + `sonar-project.properties`; project `poli0981_free-games-itchio-list`, public). Automatic Analysis is switched off on sonarcloud.io — switched back on, it makes the CI scan fail. PRs get a "SonarCloud Code Analysis" check from the SonarQube Cloud app; Dependabot and fork PRs get no `SONAR_TOKEN`, so their analysis is skipped with a notice (a Dependabot secret of that name would enable it). Tests run in the `coverage` job without the token; besides the `token` job's presence check, only the `scan` step gets it, in a job that runs no project code. Binary images and the D1 migrations (SQLite, claimed by the Oracle PL/SQL analyzer, which then warned on every run) are excluded from the analysis. Coverage: `pytest --cov` (`[tool.coverage.run]` in `pyproject.toml`) and `npm run test:coverage` (`test.coverage` in `vite.config.ts`; the lcov reporter's `projectRoot` is the repo root, so the scanner resolves the paths); `@vitest/coverage-v8` needs vitest's exact version (Dependabot group `vitest`). The built-in "Sonar way" gate fails a PR under 80 % coverage on new code (from 20 new lines up), so code without unit tests by design is in `sonar.coverage.exclusions` — keep that list in step with what the tests reach. `sonar.projectVersion` comes from `webapp/package.json`: on `main`, "new code" (previous version) starts over at each version bump. `sonar.python.version` stays 3.14 until SonarQube Cloud's analyzer supports 3.15 (it warns "No explicit support for version 3.15"). The free plan keeps only `main` and PRs: a manual run on another branch uploads a branch analysis nobody can open ("not allowed to access data from non main branches"). Mark a false positive on the issue itself. Two of its suggested fixes are wrong here: S2871 wants `localeCompare` in `.sort()`, but chunk names, migration files and `unblocked.json` keep code-unit order (= Python's `sorted()`) — pass `compareCodeUnits` (`worker/text.ts`); S8906 wants `select_one('div.a.b')` for bs4's `class_=[a, b]`, which means *either* class — write a selector list `div.a, div.b`. Trim trailing characters with `trimEnd()` (`worker/text.ts`), not `/x+$/` (S8786: quadratic backtracking on a long run). Known false positive: css:S8776 on Tailwind v4's `@utility … { &::-webkit-scrollbar … }` (the `&` is required for variants).
|
||||
42. **`overrides.undici` in `webapp/package.json` is a stopgap**: miniflare (wrangler's local runtime) pins `undici` exactly — 7.29.1 in wrangler 4.152, three advisories fixed in 7.30.1, so Dependabot could not raise it — and the override lifts it to `^7.30.1`. Only miniflare uses undici; nothing of it reaches the site, the Worker or the apps. Remove the override once `npm ls undici` without it shows ≥ 7.30.1, and before miniflare moves to undici 8 (the override would hold it on 7).
|
||||
42. **miniflare (wrangler's local runtime) pins `undici` exactly, so Dependabot can't fix an undici alert** until a wrangler release moves the pin. The stopgap is `overrides.undici` in `webapp/package.json` (4.4.3–4.5.0 carried `^7.30.1` over wrangler 4.152's 7.29.1; dropped with wrangler 4.156, whose miniflare pins 7.30.1). Only miniflare uses undici; nothing of it reaches the site, the Worker or the apps. Remove such an override once `npm ls undici` without it shows the fixed version, and before miniflare moves to a new undici major (the override would hold it back).
|
||||
43. **The Workers rate-limit binding counts per machine, not per data centre.** Measured on production right after the 4.5.0 deploy (CDG): 1,000 requests in 53 s, each `curl` on a new connection, against `RL_SITE` 120/60 s → **no 429 at all**; 200 requests on **one** keep-alive connection → 93 × 200, then 429s. A data centre has many machines, each counts locally and syncs late, so a client that keeps one connection (browsers over HTTP/2, scripts with keep-alive) is held to the limit, while one that opens a new connection per request is spread across machines and barely counted. The zone's WAF rule counts across the data centre: it is the limit that holds against floods. Test the Worker limits over one connection (`curl URL URL …` in one invocation, or `--next`), never with `xargs curl`; under `wrangler dev` (miniflare: one process) every request counts. The WAF rule (300 / 10 s, set 2026-10-27) needs > 30 requests a second, which `xargs curl` doesn't reach from a home line: use the runbook's Node `fetch` one-liner (800 requests in 4.9 s → 111 × 200, 201 × Worker 429, 488 × WAF 1015).
|
||||
|
||||
44. **Tailwind v4's `outline-hidden` adds a visible 2 px outline in forced-colours mode.** On a focus variant that is the point (inputs keep a system-coloured focus ring in Windows contrast themes); used unconditionally on a container (`<main tabIndex={-1}>`, the games list, popovers) it drew a permanent frame there. Containers use `outline-none`, fields `focus-visible:outline-hidden`.
|
||||
45. **Vitest stubs CSS imports — `./index.css?raw` is an empty string in tests.** A test that reads a stylesheet lives in `webapp/scripts/*.test.mjs` and uses `node:fs` (`check-contrast.test.mjs`; `src/` has no Node types).
|
||||
46. **Radix FocusScope gives focus back to the trigger in a `setTimeout` after unmount.** A link inside a menu or sheet that navigates would have focus pulled back to the menu button, away from the new page's h1: `SheetContent` / `PopoverContent` call `e.preventDefault()` in `onCloseAutoFocus` when the path changed. A modal opened without a Radix trigger (the 18+ dialog) drops focus to `<body>` unless `onCloseAutoFocus` focuses something. Radix 1.3.1 sets no `aria-modal` (it hides the rest with `aria-hidden`).
|
||||
47. **Name Recharts charts with `aria-labelledby`, not their `title` prop** (`title` also shows a native browser tooltip over the whole chart); `Treemap`'s props type has no `role`. A custom tooltip loses Recharts' live region, and the tooltip box is `visibility: hidden` while inactive, so announcements go through the card (`ChartAnnounce`).
|
||||
48. **The tool permissions refuse loading third-party code into the preview page** (an axe-core `<script>` from a CDN). Check pages with the browser's accessibility tree and DOM queries instead; Lighthouse / axe DevTools are for the owner's own browser.
|
||||
49. **Qodana takes one linter per Qodana Cloud project**, hence three projects (`itch-typescript` wwgZ1, `itch-python` GgGnX, `itch-rust` P2Rd7; team "My first team", public) and three secrets (`QODANA_TOKEN_TS_JS` / `_PYTHON` / `_RUST`). All three linters need an **Ultimate** licence (a trial in Nov 2026; the Rust linter is Early Access and its image carries its own evaluation licence, to 2027-01-10): when it ends the scans fail on the licence — renew, or delete `qodana.yml` and the three `qodana.yaml`. What the first runs cost: (a) **native `qodana-python` finds no interpreter by itself** (`SDKs.json` empty), and then calls every `X | None` an invalid type hint and a dataclass a class without `__init__` — the job builds `.venv` and passes `QODANA_PYTHON_PATH`; (b) **the `qodana-rust` image has no C linker and none of Tauri's system libraries, and its container runs as the runner's user**, who can't write the image's `CARGO_HOME` or `apt-get install` (`cargo metadata` / `cargo check` fail → "Cargo project loading" sanity problem, analysis degraded, `run` unresolved) — the job passes `-u root -e CARGO_HOME=/data/cache/cargo`, `webapp/src-tauri/qodana.yaml` installs the packages in `bootstrap`, and a stand-in `webapp/dist/index.html` lets `tauri::generate_context!()` expand; (c) `--project-dir <subdir> --repository-root .` is how a subdirectory project keeps its git data; (d) the default cache keys are the same for every job of a run — each job sets its own. `gh run view --log` returns nothing until the whole run has finished; the report (SARIF + IDE logs) is the `qodana-report-*` artifact, a zip inside the artifact. Inspections switched off on purpose are listed with their reason in `webapp/qodana.yaml` (throw-to-own-catch in Worker handlers, kept regex escapes, non-ASCII keys); deliberate uses of deprecated DOM APIs carry `// noinspection JSDeprecatedSymbols`. Recharts' `<Cell>` is deprecated (gone in 4.0): a pie slice's colour is the `fill` of its data entry (`paletteFills` in `components/charts/palette.ts`).
|
||||
|
||||
## Safe-edit rules
|
||||
|
||||
@@ -159,7 +170,26 @@ Code **MIT** (`LICENSE`); catalog data **CC BY 4.0** for the maintainer's contri
|
||||
- Never commit secrets (GitHub App key, admin emails, Turnstile secret, tokens). Data workflows push with the job's `GITHUB_TOKEN`; the Worker writes as the GitHub App.
|
||||
- When adding an npm dep, also add it to `webapp/src/lib/about.ts` so the About page lists it. A Python dep goes into `requirements*.in`, then recompile the locks (gotcha 40).
|
||||
|
||||
## Current state (Oct 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.2** (2026-11-16, PR #195): dependency-only release — the 2026-11-16 sweep below. Released because wry 0.57.2 fixes Android crashes and a memory leak, macOS panics and a Windows focus issue, which reach the apps only through a release (web-only updates redeploy on merge and need none). The owner wants a deps-only release's notes short: one "Update deps:" list (changelog + GitHub release). README count 6,000+ (6,069 games that day). No policy change (`LEGAL_VERSION` unchanged).
|
||||
|
||||
**v4.6.1** (2026-11-11): maintenance mode + Qodana. Docs (EN + VI): "Project status" in the READMEs, CONTRIBUTING rewritten around the data-only scope, SECURITY note, runbook §2 step 5 (Qodana) and §4. Templates: `bug_report.yml` is now "Report a problem"; `feature_request.yml`, `feedback.yml`, `general_question.yml` and the PR templates `bug_fix.md`, `new_features.md`, `documentation.md` are deleted; the issue chooser links Discussions. README badges (status, Python CI, SonarQube quality gate + coverage, Qodana, WCAG target) and the game count (5,900+; 5,907 games that day). `qodana.yml` + three `qodana.yaml` (gotcha 49). Code changes are only the first Qodana findings: pie charts without `<Cell>`, `ElementRef` → `ComponentRef`, `FormEvent` → `SubmitEvent`, an awaited `res.json()`, three Python nits, the unused `serde_json` crate dropped from the Tauri shell. No policy change (`LEGAL_VERSION` unchanged).
|
||||
|
||||
**v4.6.0** (2026-11-09): accessibility. Root `ACCESSIBILITY.md` + VI mirror (the owner had tested the website and the Windows app with the keyboard only and Windows Narrator; this release fixed what a WCAG 2.2 AA review found; after it, the owner's VoiceOver test on a real iPhone 14 Pro in Safari, Chrome and Brave passed), the `accessibility.yml` issue form and labels `accessibility` / `feedback`, a default `.github/pull_request_template.md` (GitHub's community profile ignores `PULL_REQUEST_TEMPLATE/`). Code: focus management (route h1, Back to the used link, dialogs), the "/" shortcut switch, header search options / count, h2 card titles, `lang` marking, screen-reader text for counts / loading / new tabs, contrast tokens + `check-contrast.test.mjs`, forced-colours CSS, chart names / arrow-key announcements / data tables. Docs sync: dead `@freeitchgames.win` addresses in `data_game/LICENSE.md`, stale dates / VI revision notes / library versions, `check:tauri` in the check lists, the About page's removal link, `remove_game.yml` → label `delete-game`. Not done by choice: desktop zoom (`zoomHotkeysEnabled` off, `maximizable: false`, min 900×600 — a known limitation in the statement). No policy change (`LEGAL_VERSION` unchanged). Ships the two deps sweeps below.
|
||||
|
||||
**Deps sweeps since v4.5.0** (11-02 and 11-09 shipped in 4.6.0 — the catalog had 5,818 games on 2026-11-09 —, 11-16 in 4.6.2). Each combines the week's Dependabot PRs plus what Dependabot didn't open (its 5-PR limit, pip / actions / cargo), with the 3-day cooldown applied by hand to every ecosystem (cargo and actions have none in `dependabot.yml`):
|
||||
- 2026-11-02, PR #176: Dependabot #171–#175 (react-router 8.5.1, TanStack Query 5.105.0, lucide-react 1.64.0, knip 6.44.0, typescript-eslint 8.72.1, wrangler 4.156.0 + regenerated types), jose 6.2.14, `overrides.undici` dropped (gotcha 42), pytest 9.2.0 / Ruff 0.17.3, sonarqube-scan-action 8.4.0, `cargo update`.
|
||||
- 2026-11-09, PR #182: Dependabot #177–#181 (TanStack Query 5.106.1, vitest 5.1.0, vite 8.3.6, @vitejs/plugin-react 6.2.1, Tailwind 4.3.4, eslint 10.14.0, knip 6.44.1, wrangler 4.158.0 + regenerated types, jose 6.2.15, globals 17.14.0), lucide-react 1.69.0, soupsieve 4.0.1 (a major whose breaking changes only touch `<template>` / `<iframe>` contents), coverage 7.17.2 / Ruff 0.17.4, setup-java 6.2.0, sonarqube-scan-action 8.4.1, `cargo update` (wasm-bindgen 0.2.130 family …).
|
||||
- 2026-11-16, PR #195: Dependabot #190–#194 (TanStack Query 5.107.1, @tauri-apps/plugin-opener 2.7.3, Tailwind 4.3.5, @vitejs/plugin-react 6.3.0, knip 6.45.1, typescript-eslint 8.72.2, vite 8.3.8, wrangler 4.161.0 + regenerated types, jose 6.2.17, lucide-react 1.72.0), zustand 5.1.0 (`persist` still hydrates sync storage synchronously; `rehydrate()` now returns a `Promise`), soupsieve 4.1 / coverage 7.17.3 / Ruff 0.17.5, `cargo update` (wry 0.57.2 — it pulls `dom_query` 0.29 next to tauri-utils' 0.28 —, tauri-plugin-opener 2.7.3; brotli, bumpalo, cc, ctor, jiff, mio held at older versions by the cooldown); transitive npm bumps checked too (tapable 2.3.4 held at 2.3.3 in the lock; `npm audit signatures` all verified). Held for the next sweep: eslint 10.15.0, eslint-plugin-react-refresh 0.5.8, lucide-react 1.73.0, wrangler 4.162.0, soupsieve 4.1.1, sonarqube-scan-action 8.5.0, setup-java 6.3.0. Rust stable 1.100.0 (2026-11-12) is what the release builds now get (`toolchain: stable`).
|
||||
|
||||
Node 26.13.1 (LTS; the 2026-11-11 security release — http2 / TLS server fixes) with its npm 11.20.0 is current: CI and Workers Builds follow `.node-version` / `NODE_VERSION` `26` by themselves; only local installs need upgrading.
|
||||
|
||||
`npm audit`: 9 moderate, all minimatch < 11.0.1 (GHSA-g3hv-75wg-m249) under eslint / typescript-eslint — dev-only, no fix until they accept minimatch 11. `cargo audit`: 0 vulnerabilities, 5 upstream warnings. Security settings unchanged: CodeQL default setup not configured, Dependabot security updates off; 0 open alerts, SonarQube Cloud 0 issues.
|
||||
|
||||
**v4.5.0** (2026-10-27): rate limits for the whole site — `worker/ratelimit.ts` + `RL_SITE` / `RL_IMG` / `RL_ADMIN`, every namespace moved to 8801–8806 / staging 8901–8906 (account-wide ids; 1001 / 1003 were shared with other Workers), the 429 page, admin wording, `docs/operations.md` §1 step 15 (the WAF rule: `not cf.client.bot`, not `/assets/` or `/data/pack/`, 300 requests / 10 s, block 10 s — set by the owner in the dashboard). No policy change (`LEGAL_VERSION` unchanged; SECURITY.md EN + VI describe the limits).
|
||||
|
||||
**v4.4.3** (2026-10-26): dependency and security updates only — the week's npm updates (Dependabot #159–#163 in one PR, plus lucide-react / Zustand; `knip` kept at 6.42.1 by the 3-day cooldown), wrangler 4.152 with regenerated `worker-configuration.d.ts` (a wrangler bump fails `cf:types -- --check` until it is regenerated — why Dependabot's build-tooling PR failed), `overrides.undici` (gotcha 42), zod 4.6.7, `cargo update` (tauri 2.12.5, tokio 1.54.1; `cargo audit`: 0 vulnerabilities, 5 upstream warnings — glib, zbus family, proc-macro-error), certifi / coverage / Ruff via pip-tools on 3.14, `actions/setup-python` 7.1.0. Repository security state that day: CodeQL default setup **not configured** (last analyses May 2026, 0 open alerts), Dependabot **security updates disabled** in Settings (version updates run), secret scanning + push protection on, SonarQube Cloud gate OK with 0 issues.
|
||||
|
||||
|
||||
+37
-26
@@ -2,9 +2,17 @@
|
||||
|
||||
Thanks for even thinking about contributing to this random repo! I'm just an unemployed, introvert Vietnamese dev with mediocre skills and two non-judgmental AI buddies: **Grok (xAI)** for the late-night brainstorming and **Claude Code (Anthropic)** for the heavier code/docs work. This list survives on community help, because I'm too lazy to hunt/fix everything alone :D Any contribution (even one game) makes you a legend.
|
||||
|
||||
## Project Status: Stable, Maintenance Only
|
||||
|
||||
Since version 4.6.1 (2026-11-11) the project is **stable and in maintenance mode**. It is feature-complete: the website, the apps and the data pipeline keep running, and the catalog keeps updating itself.
|
||||
|
||||
- **Still done by the Maintainer**: security fixes (CVEs and reports made through [SECURITY.md](SECURITY.md)), runtime and dependency updates, and repairs when something stops the site or the daily data updates from working.
|
||||
- **Not done any more**: new features, redesigns, refactors.
|
||||
- **Issues and pull requests are accepted for the data only**: adding games (section 1), fixing a game's data or removing a game (sections 2 and 3). Accessibility barriers (section 3) and security reports keep their own channels. Anything else is closed without review; no hard feelings.
|
||||
|
||||
## How to Contribute (Use the Right Door, I'm Lazy ;D)
|
||||
|
||||
Games go through the website; everything else goes through the GitHub issue/PR templates. They make my life easier and reduce "wtf" moments.
|
||||
Games go through the website; data fixes and removals go through the GitHub issue templates or email. They make my life easier and reduce "wtf" moments.
|
||||
|
||||
### 1. Suggest New Games (Most Welcome!)
|
||||
|
||||
@@ -12,9 +20,10 @@ Games go through the website; everything else goes through the GitHub issue/PR t
|
||||
- Optional: a short note (why it's good, content warnings…), up to 500 characters. Notes are deleted after 180 days. Please don't put personal data in it.
|
||||
- A Cloudflare Turnstile check and a rate limit keep bots out; if you get blocked, wait a bit and try again.
|
||||
- Only **free** itch.io games. Paid games are dropped automatically when the game page is scraped.
|
||||
- The game must be playable or downloadable **on its itch.io page itself** (a browser build or an uploaded file). A page that only points to a launcher or a download on another site doesn't qualify, even when that is free: the [Disclaimer](docs/DISCLAIMER.md) tells visitors that any download happens on itch.io.
|
||||
- Nothing goes live instantly: every suggestion lands in a **review queue**, where the Maintainer approves or rejects it, by hand or through automatic rules (a suggestion without a warning flag that nobody rejected within about a day may be approved automatically). Approved links are then scraped by the data pipeline and show up on the site after the next deploy.
|
||||
|
||||
Got a whole list? The **[Add Games (bulk list)]** issue template takes up to 15 links at once, and a PR that adds itch.io URLs to `scripts/temp_link.json` works too (use the [Add Games] PR template). Both go through the same review: the Maintainer checks every link before it is queued, and merging such a PR is the approval. Please don't edit `data_game/` by hand: the pipeline owns those files (see [section 7](#7-submit-code-changes-pr)).
|
||||
Got a whole list? The **[Add Games (bulk list)]** issue template takes up to 15 links at once, and a PR that adds itch.io URLs to `scripts/temp_link.json` works too (use the [Add Games] PR template). Both go through the same review: the Maintainer checks every link before it is queued, and merging such a PR is the approval. Please don't edit `data_game/` by hand: the pipeline owns those files (see [section 7](#7-pull-requests)).
|
||||
|
||||
#### 1b. Other ways games get in
|
||||
|
||||
@@ -31,53 +40,55 @@ Game creators especially: if you want your game off the list, or its data correc
|
||||
- Include the game URL, who you are (the creator / rights holder, or someone authorized by them) and the reason.
|
||||
- The Maintainer removes the record from the catalog (logged with a reason on the public [removed-games page](https://freeitchgames.win/removed)) and deletes the resized cover copies the site stores; cached copies expire on their own. Target: within 7 days, urgent legal requests sooner.
|
||||
- Heads-up: this is a public git repo, so past versions stay in its history. Rewriting public history is only done in exceptional cases of legal necessity.
|
||||
- Wrong `safe_virus` / `nsfw` / notes, or other data errors that aren't a removal? A **[Bug Report]** issue is fine too.
|
||||
- Wrong `safe_virus` / `nsfw` / notes, or other data errors that aren't a removal? Use the **[Report a problem]** issue template (section 3).
|
||||
|
||||
Details live in the [Terms of Use](docs/ToS.md) and the [Disclaimer](docs/DISCLAIMER.md).
|
||||
|
||||
### 3. Report Bugs
|
||||
### 3. Report a Problem (Wrong Data, Something Broke)
|
||||
|
||||
- Open an issue → **[Bug Report]** template.
|
||||
- Checkboxes for common bugs (dead links, wrong flags, broken page, etc.).
|
||||
- Open an issue → **[Report a problem]** template ([direct link](https://github.com/poli0981/free-games-itchio-list/issues/new?template=bug_report.yml)).
|
||||
- It is for **data errors** (dead link, wrong name, genre, tags, cover, `nsfw` or `safe_virus` flag…) and for **things that broke** (a page or an app that stopped working, the catalog no longer updating). It is not for ideas: see section 4.
|
||||
- Details + screenshots + urgency level.
|
||||
- **Security problems are not bugs for the public tracker.** Report them privately: see [SECURITY.md](SECURITY.md).
|
||||
- If it's complex, see "Discuss More" below.
|
||||
- **Security problems are not for the public tracker.** Report them privately: see [SECURITY.md](SECURITY.md).
|
||||
- **Accessibility barriers** (keyboard, screen reader, zoom, contrast, motion…): use the **[Accessibility barrier]** template ([direct link](https://github.com/poli0981/free-games-itchio-list/issues/new?template=accessibility.yml)), or email contact@poli0981.dev if you'd rather not use GitHub. What happens next is in [ACCESSIBILITY.md](ACCESSIBILITY.md#7-reporting-an-accessibility-barrier).
|
||||
|
||||
### 4. Suggest Features or Improvements
|
||||
### 4. Features and Improvements (Closed)
|
||||
|
||||
- Open an issue → **[Feature Request / Improvement]** template.
|
||||
- Choose type (new feature or code fix), name, reason, priority (from "nice to have" to "repo dying").
|
||||
- Optional: pseudo-code/snippet (no malware pls, I'll check with my average skills :D).
|
||||
- The project is in maintenance mode: **feature requests, improvement ideas and code changes are no longer accepted**. Such issues and pull requests are closed without review.
|
||||
- The code is MIT-licensed: you're welcome to fork it and build your own thing ([README → License](README.md#license)).
|
||||
|
||||
### 5. Give Feedback
|
||||
### 5. Feedback, Questions, Anything Else
|
||||
|
||||
- Use the **[Feedback]** template.
|
||||
- Checkboxes (EULA/ToS too strict? Repo concept bad? Anti-AI? Delete repo? Other).
|
||||
- Roast or praise, my self-loathing can handle it.
|
||||
- Use **[GitHub Discussions](https://github.com/poli0981/free-games-itchio-list/discussions)**, the Discord servers or email (see "Discuss More" below). Roast or praise, my self-loathing can handle it.
|
||||
- They are read, but they don't turn into new features (section 4).
|
||||
|
||||
### 6. Anything Else (Questions, Memes, Off-Topic)
|
||||
### 6. Dependencies and Security Fixes
|
||||
|
||||
- Use the **[General / Off-Topic]** template.
|
||||
- Drop whatever's on your mind.
|
||||
- Dependency updates are handled by Dependabot and the Maintainer's weekly sweep: please don't send version-bump PRs.
|
||||
- Found a vulnerability? Report it privately ([SECURITY.md](SECURITY.md)); the Maintainer makes the fix.
|
||||
|
||||
### 7. Submit Code Changes (PR)
|
||||
### 7. Pull Requests
|
||||
|
||||
- Fork → branch → code → open a PR against `main` with the matching PR template ([Bug Fix], [New Feature], [Documentation]…).
|
||||
- Clear description, please. I'll review slowly (unemployed schedule + AI buddies).
|
||||
- **Accepted**: a PR that adds itch.io URLs to `scripts/temp_link.json` (use the [Add Games] PR template). Merging it is the Maintainer's approval.
|
||||
- **Not accepted**: everything else (code, UI, docs, refactors). Fixing or removing a game's data goes through an issue or email (sections 2 and 3), because the pipeline owns `data_game/`.
|
||||
- The rules below still apply to every PR, the Maintainer's own included.
|
||||
|
||||
**PR rules** (the non-negotiable part):
|
||||
|
||||
- **CI must pass.** Python CI (ruff check + format, vulture, pytest, `validate.py`) and Webapp CI (type generation check, lint, knip, tests, build, `wrangler deploy --dry-run`) both run on PRs. Red CI = no merge. 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): …`).
|
||||
- **Licensing is inbound = outbound.** By opening a PR you agree that your contribution is licensed under the same license as the part it changes: **MIT** for code, **CC BY 4.0** for catalog data and documentation (see [README → License](README.md#license)). Only submit work you have the right to submit.
|
||||
- **Never commit secrets**: no tokens, API keys, `.dev.vars` / `.env` files, private keys (such as the GitHub App key) or signing keystores. If you pushed one by accident, report it privately (security@poli0981.dev) and rotate it; deleting the commit is not enough.
|
||||
- **Don't edit `data_game/` by hand.** Data changes go through the pipeline (a patch + `apply_patch.py`, which runs `validate.py`), so concurrent writers never clobber each other.
|
||||
- Don't commit build output or generated files: `webapp/dist/`, `webapp/.wrangler/`, `webapp/src-tauri/target/`, `webapp/src-tauri/gen/`. (`webapp/src-tauri/Cargo.lock` **is** committed; keep it in sync when you change `Cargo.toml`.)
|
||||
- Adding an npm dependency? Also add it to the `THIRD_PARTY` list in `webapp/src/lib/about.ts` so the About page credits it.
|
||||
- New external link in the app? Use `<ExtLink href="…">` from `webapp/src/components/ext-link.tsx`, not a plain `<a href="…" target="_blank">`: plain anchors work on the web but silently break in the Tauri apps.
|
||||
- New external link in the app? Use `<ExtLink href="…">` from `webapp/src/components/ext-link.tsx`, not a plain `<a href="…" target="_blank">`: plain anchors work on the web but silently break in the Tauri apps (and ExtLink tells screen readers the link opens a new tab).
|
||||
- **Accessibility**: UI changes keep working with the keyboard alone and with screen readers, and keep the contrast ratios (`npm test` checks the colours). The checklist is in [ACCESSIBILITY.md → For contributors](ACCESSIBILITY.md#8-for-contributors) and in the pull request template.
|
||||
|
||||
### 8. Dev Setup (Summary)
|
||||
|
||||
For forks, and for the Maintainer's own maintenance work.
|
||||
|
||||
Full instructions (Worker, local D1, secrets, Tauri, Android) are in **[`docs/dev_env.md`](docs/dev_env.md)**; the Tauri/Android build notes are in [`webapp/TAURI.md`](webapp/TAURI.md). The short version:
|
||||
|
||||
**Python pipeline** (Python 3.15, see `.github/python-version`):
|
||||
@@ -122,12 +133,12 @@ npm run tauri:build # installers in src-tauri/target/release/bundle/
|
||||
- **Test locally**: run the checks from section 8 before pushing; CI runs the same ones.
|
||||
- **Keep it clean**: only free itch.io games, no paid/demo/malware/duplicates.
|
||||
- **Be patient**: I'm introvert + lazy, replies might be slow.
|
||||
- **Agreement**: all issue templates have a required checkbox. Off-topic/spam/policy violations get ignored/closed without drama :D
|
||||
- **Agreement**: all issue templates have a required checkbox. Off-topic/spam/policy violations, and anything outside the maintenance scope above, get ignored/closed without drama :D
|
||||
- **Be cool**: everything here falls under the [Code of Conduct](CODE_OF_CONDUCT.md).
|
||||
|
||||
## Discuss More? (If Templates Aren't Enough)
|
||||
|
||||
Issues/PRs are best for tracking, but if you wanna describe bugs/features in depth, chit-chat, or share noob stories, there are actual servers now (introvert god-mode breached):
|
||||
Issues are best for tracking data problems, but if you wanna chit-chat, ask something, or share noob stories, there are [GitHub Discussions](https://github.com/poli0981/free-games-itchio-list/discussions) and actual servers now (introvert god-mode breached):
|
||||
|
||||
**Chat / community**
|
||||
- Discord: Repo discussion (#general): https://discord.gg/2aNR3aVt
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# Notice
|
||||
|
||||
Last updated: 2026-09-29
|
||||
Last updated: 2026-10-16
|
||||
|
||||
Applies from: the release of version 4.0.0.
|
||||
|
||||
|
||||
@@ -1,22 +1,42 @@
|
||||
# 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://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/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)
|
||||
[](data_game/LICENSE.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.
|
||||
|
||||
A curated, auto-updating catalog of **2,600+ free games on [itch.io](https://itch.io)**. Browse it at
|
||||
A curated, auto-updating catalog of **6,000+ free games on [itch.io](https://itch.io)**. Browse it at
|
||||
**<https://freeitchgames.win>**: search, filter, sort, and jump to any game's itch.io page. The site is
|
||||
read-only for everyone: no accounts, no sign-in, no comments, no ads, no payments.
|
||||
|
||||
## Project status
|
||||
|
||||
**Stable, maintenance only** (since version 4.6.1, 2026-11-11). The project is feature-complete: the
|
||||
website, the apps and the data pipeline keep running, and the catalog keeps updating itself every day.
|
||||
|
||||
- **What still happens**: security fixes (CVEs and reports made through [SECURITY.md](SECURITY.md)),
|
||||
runtime and dependency updates (Node.js, Python, Rust, npm / pip / cargo packages, GitHub Actions),
|
||||
and repairs when something stops the site or the daily data updates from working.
|
||||
- **What no longer happens**: new features, redesigns and refactors. Feature requests and code
|
||||
pull requests are closed without review.
|
||||
- **Issues and pull requests are for the data only**: adding games, fixing a game's data, removing a
|
||||
game. See [Contributing](#contributing).
|
||||
|
||||
## Table of contents
|
||||
|
||||
- [Project status](#project-status)
|
||||
- [Browse the catalog](#browse-the-catalog)
|
||||
- [Desktop and Android apps](#desktop-and-android-apps)
|
||||
- [Add a game](#add-a-game)
|
||||
@@ -45,6 +65,10 @@ Everything lives on the website, **<https://freeitchgames.win>**:
|
||||
- **18+ content is hidden by default.** Games flagged `nsfw: Yes` stay hidden (covers included) unless
|
||||
you opt in under Settings after confirming you are 18 or older. That choice is stored only in your
|
||||
browser.
|
||||
- **Made for every way of browsing.** Everything works with the keyboard alone and with screen readers,
|
||||
colours meet the WCAG contrast ratios in both themes, every chart has a data table, and the site
|
||||
follows your system's reduced-motion and contrast settings. What works, the known gaps and how to
|
||||
report a barrier: [ACCESSIBILITY.md](ACCESSIBILITY.md).
|
||||
|
||||
Every link goes to the game's own page on itch.io. Cover images on the website are resized copies served
|
||||
by freeitchgames.win, so your browser does not contact itch.io until you click a link.
|
||||
@@ -235,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` |
|
||||
| RSS discovery and automatic rules (Cloudflare Worker) | Every 4 hours | Poll one itch.io feed per run into the review queue; auto-approve unflagged items after the waiting time; queue new free games of followed collections |
|
||||
| Python CI / Webapp CI | Pull requests (Python CI also on pushes to `main` that touch it) | Lint, tests, data validation / type-check, tests, build |
|
||||
| Code analysis (`sonarcloud.yml`, `qodana.yml`) | Pull requests and pushes to `main` that change code | SonarQube Cloud (with test coverage) and Qodana (TypeScript / JavaScript, Python, Rust) |
|
||||
| Deploy website | On push to `main` | Cloudflare Workers Builds (`webapp/wrangler.jsonc`) → freeitchgames.win |
|
||||
| Build monitor (`deploy-status.yml`) | Hourly | Posts each failed Workers Build of `main` to Discord, once |
|
||||
| Release desktop / Android | On `v*` tag push | Tauri installers (Win/macOS/Linux) and signed APK → draft Release |
|
||||
@@ -285,8 +310,13 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for the full guide.
|
||||
- **Add games**: use the [Suggest page](https://freeitchgames.win/suggest).
|
||||
- **Remove a game / fix its data**: email takedown@poli0981.dev or open a
|
||||
["Remove a game" issue](https://github.com/poli0981/free-games-itchio-list/issues/new?template=remove_game.yml).
|
||||
- **Report bugs**: use the "Bug Report" issue template.
|
||||
- **Request features**: use the "Feature Request / Improvement" template, or send a PR.
|
||||
- **Report a problem**: wrong data, a dead link, or something broken on the site or in the apps: use the
|
||||
"Report a problem" issue template.
|
||||
- **Accessibility barriers**: use the ["Accessibility barrier" issue template](https://github.com/poli0981/free-games-itchio-list/issues/new?template=accessibility.yml) or email
|
||||
contact@poli0981.dev. See [ACCESSIBILITY.md](ACCESSIBILITY.md).
|
||||
- **Features and code changes**: not accepted any more, the project is in
|
||||
[maintenance mode](#project-status). Questions and feedback are welcome in
|
||||
[Discussions](https://github.com/poli0981/free-games-itchio-list/discussions).
|
||||
- **Security issues**: report them privately, never in a public issue. See [SECURITY.md](SECURITY.md).
|
||||
- **Privacy questions**: see the [Privacy Policy](docs/PrivacyPolicy.md) or email privacy@poli0981.dev.
|
||||
- Please follow the [Code of Conduct](CODE_OF_CONDUCT.md).
|
||||
@@ -350,6 +380,7 @@ belong to their respective owners.
|
||||
- [EULA](docs/EULA.md): covers the desktop and Android apps only
|
||||
- [Code of Conduct](CODE_OF_CONDUCT.md)
|
||||
- [Security Policy](SECURITY.md)
|
||||
- [Accessibility statement](ACCESSIBILITY.md): what works with assistive technology, known gaps, how to report a barrier
|
||||
- [NOTICE](NOTICE.md)
|
||||
|
||||
Contact (the Maintainer's own mailbox on poli0981.dev):
|
||||
|
||||
+24
-5
@@ -1,22 +1,37 @@
|
||||
# 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://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/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)
|
||||
[](data_game/LICENSE.md)
|
||||
[](README.md)
|
||||
|
||||
> Bản dịch từ bản tiếng Anh cập nhật ngày 2026-09-24 (English source revision 2026-09-24). Nếu có khác biệt, bản tiếng Anh được ưu tiên.
|
||||
> Bản dịch từ bản tiếng Anh cập nhật ngày 2026-11-11 (English source revision 2026-11-11). Nếu có khác biệt, bản tiếng Anh được ưu tiên.
|
||||
>
|
||||
> Bản tiếng Anh tại [`README.md`](README.md) là bản chính thức. Bản dịch tiếng Việt của các tài liệu chính sách nằm trong [`docs/i18n/vi/`](docs/i18n/vi/).
|
||||
|
||||
Một danh mục được tuyển chọn và tự động cập nhật gồm **hơn 2,600 game miễn phí trên [itch.io](https://itch.io)**. Duyệt tại **<https://freeitchgames.win>**: tìm kiếm, lọc, sắp xếp và mở thẳng trang itch.io của bất kỳ game nào. Website chỉ để xem, với tất cả mọi người: không tài khoản, không đăng nhập, không bình luận, không quảng cáo, không thanh toán.
|
||||
Một danh mục được tuyển chọn và tự động cập nhật gồm **hơn 6,000 game miễn phí trên [itch.io](https://itch.io)**. Duyệt tại **<https://freeitchgames.win>**: tìm kiếm, lọc, sắp xếp và mở thẳng trang itch.io của bất kỳ game nào. Website chỉ để xem, với tất cả mọi người: không tài khoản, không đăng nhập, không bình luận, không quảng cáo, không thanh toán.
|
||||
|
||||
## Trạng thái dự án
|
||||
|
||||
**Ổn định, chỉ bảo trì** (từ phiên bản 4.6.1, 2026-11-11). Dự án đã đủ tính năng: website, các ứng dụng và pipeline dữ liệu vẫn chạy, danh mục vẫn tự cập nhật mỗi ngày.
|
||||
|
||||
- **Những gì vẫn được làm**: vá bảo mật (CVE và báo cáo gửi qua [SECURITY](docs/i18n/vi/SECURITY.md)), cập nhật runtime và thư viện phụ thuộc (Node.js, Python, Rust, gói npm / pip / cargo, GitHub Actions), và sửa khi có gì đó làm website hoặc việc cập nhật dữ liệu hằng ngày ngừng chạy.
|
||||
- **Những gì không còn làm**: tính năng mới, thiết kế lại, refactor. Đề xuất tính năng và pull request về code sẽ bị đóng mà không review.
|
||||
- **Issue và pull request chỉ dành cho dữ liệu**: thêm game, sửa dữ liệu của một game, gỡ game. Xem [Đóng góp](#đóng-góp).
|
||||
|
||||
## Mục lục
|
||||
|
||||
- [Trạng thái dự án](#trạng-thái-dự-án)
|
||||
- [Duyệt danh mục](#duyệt-danh-mục)
|
||||
- [Ứng dụng desktop và Android](#ứng-dụng-desktop-và-android)
|
||||
- [Thêm game](#thêm-game)
|
||||
@@ -39,6 +54,7 @@ Mọi thứ nằm trên website **<https://freeitchgames.win>**:
|
||||
- **Đã gỡ** (Removed): mọi game bị loại khỏi danh mục, kèm lý do (<https://freeitchgames.win/removed>).
|
||||
- **Kiểm tra nhanh trước.** Lần đầu vào, rồi khoảng mỗi 48 giờ, trang sẽ chạy một bước kiểm tra Cloudflare Turnstile ngắn để chặn bot. Thường nó tự qua rồi mở đúng trang bạn cần. Dữ liệu trong `/data` và các ứng dụng không cần bước này.
|
||||
- **Nội dung 18+ bị ẩn theo mặc định.** Game được đánh dấu `nsfw: Yes` sẽ bị ẩn (kể cả ảnh bìa) trừ khi bạn tự bật trong Settings sau khi xác nhận mình đủ 18 tuổi. Lựa chọn đó chỉ được lưu trong trình duyệt của bạn.
|
||||
- **Dành cho mọi cách duyệt web.** Mọi thứ dùng được chỉ với bàn phím và với trình đọc màn hình, màu sắc đạt tỉ lệ tương phản WCAG ở cả hai giao diện, mỗi biểu đồ có bảng dữ liệu, và site làm theo thiết lập giảm chuyển động và tương phản của hệ thống. Những gì đã hỗ trợ, các hạn chế đã biết và cách báo rào cản: [Trợ năng](docs/i18n/vi/ACCESSIBILITY.md) ([EN](ACCESSIBILITY.md)).
|
||||
|
||||
Mọi link đều dẫn tới trang riêng của game trên itch.io. Ảnh bìa trên website là bản thu nhỏ do freeitchgames.win phục vụ, nên trình duyệt của bạn không kết nối tới itch.io cho tới khi bạn bấm vào một link.
|
||||
|
||||
@@ -176,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` |
|
||||
| Phát hiện qua RSS và quy tắc tự động (Cloudflare Worker) | Mỗi 4 giờ | Đọc một feed itch.io mỗi lượt vào hàng chờ duyệt; tự duyệt mục không có cờ sau thời gian chờ; đưa game miễn phí mới của collection được theo dõi vào hàng chờ ingest |
|
||||
| Python CI / Webapp CI | Pull request (Python CI còn chạy khi push vào `main` chạm tới phần Python) | Lint, test, validate dữ liệu / type-check, test, build |
|
||||
| Phân tích code (`sonarcloud.yml`, `qodana.yml`) | Pull request và push vào `main` có đổi code | SonarQube Cloud (kèm test coverage) và Qodana (TypeScript / JavaScript, Python, Rust) |
|
||||
| Deploy website | Khi push vào `main` | Cloudflare Workers Builds (`webapp/wrangler.jsonc`) → freeitchgames.win |
|
||||
| Theo dõi build (`deploy-status.yml`) | Mỗi giờ | Báo mỗi Workers Build lỗi của `main` lên Discord, một lần |
|
||||
| Release desktop / Android | Khi push tag `v*` | Trình cài đặt Tauri (Win/macOS/Linux) và APK đã ký → draft Release |
|
||||
@@ -220,8 +237,9 @@ Xem [CONTRIBUTING (tiếng Việt)](docs/i18n/vi/CONTRIBUTING.md) để có hư
|
||||
|
||||
- **Thêm game**: dùng [trang Suggest](https://freeitchgames.win/suggest).
|
||||
- **Gỡ game / sửa dữ liệu**: gửi email tới takedown@poli0981.dev hoặc mở issue ["Remove a game"](https://github.com/poli0981/free-games-itchio-list/issues/new?template=remove_game.yml).
|
||||
- **Báo lỗi**: dùng issue template "Bug Report".
|
||||
- **Đề xuất tính năng**: dùng template "Feature Request / Improvement", hoặc gửi PR.
|
||||
- **Báo sự cố**: dữ liệu sai, link chết, hoặc có gì đó hỏng trên website hay trong ứng dụng: dùng issue template "Report a problem".
|
||||
- **Rào cản trợ năng**: dùng [issue template "Accessibility barrier"](https://github.com/poli0981/free-games-itchio-list/issues/new?template=accessibility.yml) hoặc gửi email tới contact@poli0981.dev. Xem [Trợ năng](docs/i18n/vi/ACCESSIBILITY.md) ([EN](ACCESSIBILITY.md)).
|
||||
- **Tính năng và thay đổi code**: không còn được nhận, dự án đang ở [chế độ bảo trì](#trạng-thái-dự-án). Câu hỏi và góp ý xin gửi vào [Discussions](https://github.com/poli0981/free-games-itchio-list/discussions).
|
||||
- **Vấn đề bảo mật**: báo cáo riêng tư, đừng bao giờ mở issue công khai. Xem [SECURITY](docs/i18n/vi/SECURITY.md) ([EN](SECURITY.md)).
|
||||
- **Câu hỏi về quyền riêng tư**: xem [Chính sách quyền riêng tư](docs/i18n/vi/PrivacyPolicy.md) ([EN](docs/PrivacyPolicy.md)) hoặc gửi email tới privacy@poli0981.dev.
|
||||
- Vui lòng tuân thủ [Quy tắc ứng xử](docs/i18n/vi/CODE_OF_CONDUCT.md) ([EN](CODE_OF_CONDUCT.md)).
|
||||
@@ -277,6 +295,7 @@ Bản tiếng Việt nằm trong [`docs/i18n/vi/`](docs/i18n/vi/); bản tiếng
|
||||
- [EULA](docs/i18n/vi/EULA.md) ([EN](docs/EULA.md)): chỉ áp dụng cho app desktop và Android
|
||||
- [Quy tắc ứng xử](docs/i18n/vi/CODE_OF_CONDUCT.md) ([EN](CODE_OF_CONDUCT.md))
|
||||
- [Chính sách bảo mật (Security Policy)](docs/i18n/vi/SECURITY.md) ([EN](SECURITY.md))
|
||||
- [Tuyên bố trợ năng (Accessibility)](docs/i18n/vi/ACCESSIBILITY.md) ([EN](ACCESSIBILITY.md)): những gì đã hỗ trợ cho công cụ trợ năng, các hạn chế đã biết, cách báo rào cản
|
||||
- [NOTICE](NOTICE.md)
|
||||
|
||||
Liên hệ (hộp thư riêng của Maintainer trên poli0981.dev):
|
||||
|
||||
+4
-2
@@ -1,6 +1,6 @@
|
||||
# Security Policy
|
||||
|
||||
Last updated: 2026-10-16
|
||||
Last updated: 2026-11-11
|
||||
|
||||
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.
|
||||
|
||||
Since version 4.6.1 the project is in **maintenance mode**: no new features, but security fixes and runtime and dependency updates continue as described here.
|
||||
|
||||
## 4. What to expect
|
||||
|
||||
- **Acknowledgement**: target within **7 days**. This is a solo hobby project, so that is a target rather than a guarantee, and often it will be much sooner.
|
||||
@@ -76,7 +78,7 @@ What the repository actually does:
|
||||
- **Dependabot** ([`.github/dependabot.yml`](.github/dependabot.yml)) is configured to keep npm, pip, GitHub Actions and cargo dependencies current.
|
||||
- Every third-party **GitHub Action is pinned by full commit SHA**, and each workflow declares least-privilege `permissions`.
|
||||
- Writes to the repository from the website's admin go through a **GitHub App** (verified commits), and the admin page is behind Cloudflare Access (GitHub login or one-time email PIN) and limited to the Maintainer.
|
||||
- The Suggest form is protected by Cloudflare Turnstile and rate limiting.
|
||||
- The website limits how many requests one address can send in a short time (a Cloudflare WAF rule, then per-route limits in the Worker that answer HTTP 429), and the Suggest form adds Cloudflare Turnstile and a stricter limit of its own.
|
||||
- The Android APK is signed with the project's key. Install it, and the desktop apps, only from the project's [GitHub Releases](https://github.com/poli0981/free-games-itchio-list/releases) page.
|
||||
|
||||
If a known vulnerability in a dependency actually affects a deployed component (the website, the Worker, the pipeline or the apps), report it privately as in [§1](#1-reporting-a-vulnerability). If it is just an outdated dependency with no practical impact, a normal issue or pull request is fine.
|
||||
|
||||
@@ -0,0 +1,44 @@
|
||||
# Changelog — 4.5.x
|
||||
|
||||
Release notes for 4.5.0, newest first. Every version: [CHANGELOG.md](../../CHANGELOG.md).
|
||||
|
||||
## [4.5.0] - 2026-10-27 (Rate limits for the whole site)
|
||||
|
||||
The website now limits how many requests one connection can send in a short time, on every page,
|
||||
cover image and API address — not only on the Suggest form and the verification check. Normal
|
||||
browsing never comes close to the limits; a script that floods the site gets HTTP 429 ("Too many
|
||||
requests") and has to wait a minute. Nothing changes in the desktop and Android apps.
|
||||
|
||||
### Upgrade notes
|
||||
|
||||
- **Nothing to accept again**: no policy changed. The Privacy Policy already says that your IP
|
||||
address is used, without being stored, to count requests and limit abuse.
|
||||
- **Desktop and Android apps**: install 4.5.0 over 4.4.3 as usual; they don't use the limited
|
||||
addresses (4.0–4.1.1 count against the site limit when they read the old catalog files).
|
||||
|
||||
### Added
|
||||
|
||||
- **Per-connection limits in the Worker**: every request that runs the site's server code counts,
|
||||
per minute and per address (an IPv6 connection by its /64): 120 for pages, the public API and the
|
||||
catalog files of the old apps, 600 for cover images (a Games page shows up to 100), 300 for the
|
||||
admin. The Suggest form (5 a minute) and the verification check (20 a minute) keep their own,
|
||||
stricter limits on top. Search engines that Cloudflare has verified are not counted.
|
||||
- **The "Too many requests" answer**: pages get a short page in English or Vietnamese (no scripts),
|
||||
the API and cover images a JSON `{"error":"rate_limited"}`; both say when to retry
|
||||
(`Retry-After: 60`) and are never cached. The admin shows "Too many requests from this connection".
|
||||
- **A first layer in front of the Worker**: the maintainer's runbook (`docs/operations.md`, section 1
|
||||
step 15) sets up a Cloudflare WAF rate-limiting rule that blocks floods before they reach the site's
|
||||
code, and covers the static files the Worker never sees. The Worker's own counts are approximate
|
||||
(Cloudflare counts them per server and syncs them late), so the WAF rule is what holds against a
|
||||
flood that opens a new connection for every request.
|
||||
|
||||
### Fixed
|
||||
|
||||
- **Suggest and verification limits counted other sites too**: a rate limit's namespace is shared by
|
||||
every Worker of the Cloudflare account, and the two existing limits used the same numbers as other
|
||||
Workers there, so their visits could use up this site's Suggest or verification allowance. All of
|
||||
this site's limits now have namespaces of their own.
|
||||
|
||||
### Changed
|
||||
|
||||
- **Security policy**: says how the site limits requests (EN + VI); no new obligations.
|
||||
@@ -0,0 +1,173 @@
|
||||
# Changelog — 4.6.x
|
||||
|
||||
Release notes for 4.6.0 – 4.6.2, newest first. Every version: [CHANGELOG.md](../../CHANGELOG.md).
|
||||
|
||||
## [4.6.2] - 2026-11-16 (Dependency updates)
|
||||
|
||||
Update deps:
|
||||
|
||||
- **Desktop and Android apps**: wry 0.57.2 (Android crash and memory-leak fixes, macOS crash fixes,
|
||||
a Windows focus fix), tauri-plugin-opener 2.7.3, and the other Rust crates (`cargo update`).
|
||||
- **Website**: TanStack Query 5.107.1, Zustand 5.1.0, lucide-react 1.72.0, jose 6.2.17.
|
||||
- **Data pipeline**: Soup Sieve 4.1.
|
||||
- **Tooling**: Vite 8.3.8, @vitejs/plugin-react 6.3.0, Tailwind CSS 4.3.5, Wrangler 4.161.0,
|
||||
typescript-eslint 8.72.2, knip 6.45.1, coverage 7.17.3, Ruff 0.17.5.
|
||||
|
||||
No policy changed: nothing to accept again.
|
||||
|
||||
## [4.6.1] - 2026-11-11 (Stable: maintenance mode)
|
||||
|
||||
The project is now **stable and in maintenance mode**. It is feature-complete: the website, the apps
|
||||
and the data pipeline keep running, and the catalog keeps updating itself every day. Nothing changes
|
||||
for visitors.
|
||||
|
||||
### What maintenance mode means
|
||||
|
||||
- **Still done**: security fixes (CVEs and reports made through [SECURITY.md](../../SECURITY.md)),
|
||||
runtime and dependency updates (Node.js, Python, Rust, npm / pip / cargo packages, GitHub Actions),
|
||||
and repairs when something stops the site or the daily data updates from working.
|
||||
- **Not done any more**: new features, redesigns and refactors.
|
||||
- **Issues and pull requests are for the data only**: adding games, fixing a game's data, removing a
|
||||
game. Accessibility barriers and security reports keep their own channels
|
||||
([ACCESSIBILITY.md](../../ACCESSIBILITY.md), [SECURITY.md](../../SECURITY.md)). Feature requests
|
||||
and code pull requests are closed without review; questions and feedback are welcome in
|
||||
[Discussions](https://github.com/poli0981/free-games-itchio-list/discussions).
|
||||
|
||||
### Upgrade notes
|
||||
|
||||
- **Nothing to accept again**: no policy changed.
|
||||
- **Desktop and Android apps**: 4.6.1 behaves like 4.6.0. Install it over 4.6.0 if you want the
|
||||
current version number; there is no need to.
|
||||
|
||||
### Added
|
||||
|
||||
- **Qodana (JetBrains) code analysis in CI** (`qodana.yml`): three jobs, one per Qodana Cloud
|
||||
project — TypeScript / JavaScript (`webapp/`), Python (the data pipeline) and Rust (the Tauri
|
||||
shell) — on pull requests and on pushes to `main` that change code. It runs next to SonarQube
|
||||
Cloud and, like it, skips Dependabot and fork pull requests, which get no repository secrets.
|
||||
All three projects start at 0 problems, and a new one fails its job.
|
||||
- **Badges** in both READMEs: project status, Python CI, SonarQube Cloud quality gate and coverage,
|
||||
Qodana, and the accessibility target.
|
||||
|
||||
### Changed
|
||||
|
||||
- **Docs for maintenance mode** (EN + VI): a "Project status" section in the READMEs, CONTRIBUTING
|
||||
rewritten around the data-only scope, a note in SECURITY.md, and the runbook
|
||||
([docs/operations.md](../../docs/operations.md)) with the Qodana setup.
|
||||
- **Issue and pull request templates**: "Bug Report" became "Report a problem" (wrong data, or
|
||||
something that broke); the Feature Request, Feedback and General templates and the Bug Fix, New
|
||||
Feature and Documentation pull request templates are gone; the issue chooser points to
|
||||
Discussions.
|
||||
- **The README's game count**: 5,900+ (it still said 2,600+).
|
||||
|
||||
### Fixed
|
||||
|
||||
Findings of the first Qodana reports. None changes what the site or the apps do.
|
||||
|
||||
- **Pie charts no longer use Recharts' deprecated `Cell`** (removed in Recharts 4.0): each slice
|
||||
takes its colour from its data entry. Colours and legends are unchanged.
|
||||
- **React 19 types**: `ElementRef` → `ComponentRef` in the UI components, `FormEvent` →
|
||||
`SubmitEvent` on the Suggest form, and a `React.` type used without an import.
|
||||
- **Small cleanups**: an awaited `res.json()` in the Worker's data loader, a simpler regular
|
||||
expression and return statement in the Games filters, and three Python nits in the pipeline (a
|
||||
shadowed name and an untyped number format in `refresh.py`, a value assigned but never read in
|
||||
`update_info.py`).
|
||||
- **The Tauri shell no longer declares `serde_json`**, which its own code never used (Tauri still
|
||||
brings it in).
|
||||
|
||||
## [4.6.0] - 2026-11-09 (Accessibility)
|
||||
|
||||
The website and the apps work better with a keyboard, a screen reader, Windows contrast themes and
|
||||
reduced motion, and the project now has an accessibility statement,
|
||||
[ACCESSIBILITY.md](../../ACCESSIBILITY.md) (in Vietnamese:
|
||||
[docs/i18n/vi/ACCESSIBILITY.md](../../docs/i18n/vi/ACCESSIBILITY.md)). It says what works, what
|
||||
doesn't yet, and how to report a barrier. The Maintainer had already tested the website and the
|
||||
Windows app with the keyboard only and Windows Narrator; this release fixes the gaps a review against
|
||||
WCAG 2.2 AA found.
|
||||
|
||||
### Upgrade notes
|
||||
|
||||
- **Nothing to accept again**: no policy changed. The accessibility statement isn't a policy you
|
||||
accept, so the first-visit notice doesn't come back.
|
||||
- **A new setting**: **Settings → Accessibility** turns off the "/" shortcut that jumps to the search
|
||||
box (useful with speech input, or when the key clashes with a screen reader or your browser's quick
|
||||
find).
|
||||
- **Colours**: buttons and purple text are a shade darker, form fields have darker borders, and the
|
||||
selected tab, the current page and the highlighted search suggestion are marked with an outline, an
|
||||
underline or a bar. This brings the contrast up to WCAG 2.2 AA. The logo and the app icons are
|
||||
unchanged.
|
||||
- **Desktop and Android apps**: install 4.6.0 over 4.5.0 as usual.
|
||||
|
||||
### Added
|
||||
|
||||
- **Accessibility statement** ([ACCESSIBILITY.md](../../ACCESSIBILITY.md), EN + VI): the WCAG 2.2
|
||||
AA target, what works, how it is tested, supported browsers and assistive technology, known
|
||||
limitations, and how to report a barrier, with severity levels and response targets. It is
|
||||
linked from the About page, the footer, Settings and the README.
|
||||
- **Reporting a barrier**: an "Accessibility barrier" issue form (label `accessibility`), or email
|
||||
contact@poli0981.dev, no GitHub account needed.
|
||||
- **Charts you can read**: every chart is named after its heading, reads each value aloud as you
|
||||
step through it with the left and right arrow keys, and has a **Data table** under it with the
|
||||
same numbers (plus each part's share for pie charts).
|
||||
- **Settings → Accessibility**: the "/" shortcut switch and a link to the statement.
|
||||
- **A contrast check in CI**: a test fails if a colour token or a chart colour drops below the
|
||||
WCAG 2.2 AA ratios.
|
||||
- **A default pull request template** with an accessibility checklist.
|
||||
|
||||
### Changed
|
||||
|
||||
- **Focus follows the page**: after you follow a link inside the site, focus moves to the new page's
|
||||
heading, so a screen reader announces it and Tab continues from there. Back returns focus to the
|
||||
link you used, for example the game you opened from the list. Links to a section (About →
|
||||
Support) move focus there too.
|
||||
- **Contrast**: white text on buttons goes from 4.35 to 5.44:1, purple text from 4.2 to 5.2:1 (6.6:1
|
||||
in dark mode), field borders and the off position of switches reach 3:1. Chart colours reach 3:1 on
|
||||
the light theme too, treemap labels pick a readable colour per cell, and axis labels are readable
|
||||
in dark mode. The Online/Offline chart is blue and orange, which colour-blind readers can tell
|
||||
apart.
|
||||
- **Windows contrast themes**: the selected tab, pressed toggles, the current page, the active
|
||||
search suggestion and switches use the system's highlight colours, and chart text follows the
|
||||
system text colour.
|
||||
- **Screen readers hear more**: the number of search suggestions, loading states, rating counts,
|
||||
filter counts ("Genre, 2 selected"), the reason and date of each removed game, and that a link
|
||||
opens a new tab (in the apps: your browser). Card titles on the About and Charts pages are real
|
||||
headings, and the game-not-found page and the 18+ notice have their own page titles.
|
||||
- **Language**: text in the other language (the language names, the English-only names of the legal
|
||||
documents) is marked as such, the page's language switches to Vietnamese only once the Vietnamese
|
||||
text has loaded, and the Suggest page's anti-spam check uses the site's language.
|
||||
- **Search box**: "See all results" can be reached with the arrow keys.
|
||||
- **Suggest form**: the game link is checked when you leave the field or send the form, not at the
|
||||
first keystroke, and the Send button stays reachable and says what is missing.
|
||||
- **First-visit notice**: "Accept & continue" can be reached with Tab before the box is ticked
|
||||
(pressing it moves you to the box), and focus moves to the page once you accept.
|
||||
- **Links inside sentences are underlined.**
|
||||
|
||||
### Fixed
|
||||
|
||||
- **The 18+ dialog lost keyboard focus when it closed**; focus now returns to the button or switch
|
||||
that opened it.
|
||||
- **The sticky header could cover the element that had keyboard focus.**
|
||||
- **Focus was lost** when the control you used disappeared: clearing the search, removing a filter,
|
||||
"Clear" in a filter menu, "back to top".
|
||||
- **Reduced motion**: looping loading animations now stop and "back to top" no longer scrolls
|
||||
smoothly when your system asks for less motion.
|
||||
- **Short screens**: the 18+ dialog, the phone menu and the display menu scroll instead of being cut
|
||||
off.
|
||||
- **Docs**: the catalog data license still listed the @freeitchgames.win addresses retired in 4.1.1;
|
||||
the About page's "Content removal" link opened the YAML source of the issue form; some "Last
|
||||
updated" dates, translation notes and library versions were behind.
|
||||
|
||||
### Dependencies
|
||||
|
||||
The two weekly updates since 4.5.0, which have been on the website since they were merged:
|
||||
|
||||
- **2026-11-02** (#176, Dependabot #171–#175 and a few more): React Router 8.5.1, TanStack Query
|
||||
5.105.0, lucide-react 1.64.0, knip 6.44.0, typescript-eslint 8.72.1, wrangler 4.156.0 (its
|
||||
generated Worker types refreshed), jose 6.2.14; the `undici` override dropped (wrangler's own
|
||||
version now has the fix); pytest 9.2.0 and Ruff 0.17.3 for the pipeline;
|
||||
`sonarqube-scan-action` 8.4.0; the Rust dependencies refreshed.
|
||||
- **2026-11-09** (#182, Dependabot #177–#181 and a few more): TanStack Query 5.106.1, Vitest 5.1.0,
|
||||
Vite 8.3.6, @vitejs/plugin-react 6.2.1, Tailwind CSS 4.3.4, ESLint 10.14.0, knip 6.44.1,
|
||||
wrangler 4.158.0 (types refreshed), jose 6.2.15, globals 17.14.0, lucide-react 1.69.0;
|
||||
soupsieve 4.0.1, coverage 7.17.2 and Ruff 0.17.4 for the pipeline; `actions/setup-java` 6.2.0 and
|
||||
`sonarqube-scan-action` 8.4.1; the Rust dependencies refreshed (wasm-bindgen 0.2.130 and others).
|
||||
@@ -1,6 +1,6 @@
|
||||
# Catalog data license
|
||||
|
||||
Last updated: 2026-10-03
|
||||
Last updated: 2026-11-09
|
||||
|
||||
Applies from: the release of version 4.0.0.
|
||||
|
||||
@@ -113,7 +113,7 @@ a guarantee. The project does not scan downloads. See the [Disclaimer](../docs/D
|
||||
## 7. Corrections and removals
|
||||
|
||||
Game creators and rights holders can ask for a game to be removed or its data corrected. Email
|
||||
**takedown@freeitchgames.win** or open the
|
||||
**takedown@poli0981.dev** or open the
|
||||
["Remove a game" issue](https://github.com/poli0981/free-games-itchio-list/issues/new?template=remove_game.yml).
|
||||
Include the game URL, who you are (creator, rights holder, or someone acting for them) and the reason. The
|
||||
full process is in the [Terms of Use](../docs/ToS.md).
|
||||
@@ -134,4 +134,4 @@ to the Data from version 4.0.0 on.
|
||||
|
||||
*This is a plain-language summary written by a hobby maintainer, not a lawyer, and it is not legal advice.
|
||||
If this file and the CC BY 4.0 legal code disagree, the legal code wins. Questions:
|
||||
**legal@freeitchgames.win**.*
|
||||
**legal@poli0981.dev**.*
|
||||
Generated
+81
-1
@@ -469,6 +469,86 @@
|
||||
},
|
||||
{
|
||||
"date": "2026-10-26",
|
||||
"total": 3622
|
||||
"total": 4184
|
||||
},
|
||||
{
|
||||
"date": "2026-10-27",
|
||||
"total": 4849
|
||||
},
|
||||
{
|
||||
"date": "2026-10-28",
|
||||
"total": 5426
|
||||
},
|
||||
{
|
||||
"date": "2026-10-29",
|
||||
"total": 5536
|
||||
},
|
||||
{
|
||||
"date": "2026-10-30",
|
||||
"total": 5573
|
||||
},
|
||||
{
|
||||
"date": "2026-10-31",
|
||||
"total": 5615
|
||||
},
|
||||
{
|
||||
"date": "2026-11-01",
|
||||
"total": 5641
|
||||
},
|
||||
{
|
||||
"date": "2026-11-02",
|
||||
"total": 5674
|
||||
},
|
||||
{
|
||||
"date": "2026-11-03",
|
||||
"total": 5702
|
||||
},
|
||||
{
|
||||
"date": "2026-11-04",
|
||||
"total": 5720
|
||||
},
|
||||
{
|
||||
"date": "2026-11-05",
|
||||
"total": 5737
|
||||
},
|
||||
{
|
||||
"date": "2026-11-06",
|
||||
"total": 5771
|
||||
},
|
||||
{
|
||||
"date": "2026-11-07",
|
||||
"total": 5798
|
||||
},
|
||||
{
|
||||
"date": "2026-11-08",
|
||||
"total": 5818
|
||||
},
|
||||
{
|
||||
"date": "2026-11-09",
|
||||
"total": 5858
|
||||
},
|
||||
{
|
||||
"date": "2026-11-10",
|
||||
"total": 5875
|
||||
},
|
||||
{
|
||||
"date": "2026-11-11",
|
||||
"total": 5922
|
||||
},
|
||||
{
|
||||
"date": "2026-11-12",
|
||||
"total": 5966
|
||||
},
|
||||
{
|
||||
"date": "2026-11-13",
|
||||
"total": 5991
|
||||
},
|
||||
{
|
||||
"date": "2026-11-14",
|
||||
"total": 6028
|
||||
},
|
||||
{
|
||||
"date": "2026-11-15",
|
||||
"total": 6069
|
||||
}
|
||||
]
|
||||
Generated
+239
-234
File diff suppressed because it is too large.
Load diff
Generated
+313
-305
File diff suppressed because it is too large.
Load diff
Generated
+397
-404
File diff suppressed because it is too large.
Load diff
Generated
+409
-412
File diff suppressed because it is too large.
Load diff
Generated
+626
-474
File diff suppressed because it is too large.
Load diff
Generated
+1449
-1265
File diff suppressed because it is too large.
Load diff
Generated
+1984
-1872
File diff suppressed because it is too large.
Load diff
Generated
+13835
-1698
File diff suppressed because it is too large.
Load diff
Generated
+18205
File diff suppressed because it is too large.
Load diff
Generated
+19533
File diff suppressed because it is too large.
Load diff
Generated
+18773
File diff suppressed because it is too large.
Load diff
Generated
+19092
File diff suppressed because it is too large.
Load diff
Generated
+2533
File diff suppressed because it is too large.
Load diff
Generated
+26
-6
@@ -1,7 +1,7 @@
|
||||
{
|
||||
"total_games": 3622,
|
||||
"total_games": 6069,
|
||||
"max_per_file": 500,
|
||||
"last_updated": "2026-10-26T04:23:56Z",
|
||||
"last_updated": "2026-11-15T20:24:18Z",
|
||||
"files": [
|
||||
{
|
||||
"name": "game_info_001.json",
|
||||
@@ -21,19 +21,39 @@
|
||||
},
|
||||
{
|
||||
"name": "game_info_005.json",
|
||||
"count": 496
|
||||
"count": 500
|
||||
},
|
||||
{
|
||||
"name": "game_info_006.json",
|
||||
"count": 498
|
||||
"count": 500
|
||||
},
|
||||
{
|
||||
"name": "game_info_007.json",
|
||||
"count": 496
|
||||
"count": 500
|
||||
},
|
||||
{
|
||||
"name": "game_info_008.json",
|
||||
"count": 132
|
||||
"count": 500
|
||||
},
|
||||
{
|
||||
"name": "game_info_009.json",
|
||||
"count": 500
|
||||
},
|
||||
{
|
||||
"name": "game_info_010.json",
|
||||
"count": 500
|
||||
},
|
||||
{
|
||||
"name": "game_info_011.json",
|
||||
"count": 500
|
||||
},
|
||||
{
|
||||
"name": "game_info_012.json",
|
||||
"count": 500
|
||||
},
|
||||
{
|
||||
"name": "game_info_013.json",
|
||||
"count": 69
|
||||
}
|
||||
]
|
||||
}
|
||||
+9
-8
@@ -1,6 +1,6 @@
|
||||
# Third-party components
|
||||
|
||||
Last updated: 2026-10-03
|
||||
Last updated: 2026-11-09
|
||||
|
||||
Applies from: the release of version 4.0.0.
|
||||
|
||||
@@ -28,22 +28,22 @@ shared UI components).
|
||||
| Component | Version | Used for | License |
|
||||
|---|---|---|---|
|
||||
| [React](https://react.dev) (`react`, `react-dom`) | 19.3 | UI framework | MIT |
|
||||
| [React Router](https://reactrouter.com) (`react-router`) | 8.4 | Routing | MIT |
|
||||
| [React Router](https://reactrouter.com) (`react-router`) | 8.5 | Routing | MIT |
|
||||
| [Zustand](https://github.com/pmndrs/zustand) | 5.0 | Preference and theme stores | MIT |
|
||||
| [TanStack Query](https://tanstack.com/query) (`@tanstack/react-query`, `react-query-persist-client`) | 5.103 | Data fetching and the local catalog cache | MIT |
|
||||
| [TanStack Query](https://tanstack.com/query) (`@tanstack/react-query`, `react-query-persist-client`) | 5.106 | Data fetching and the local catalog cache | MIT |
|
||||
| [idb-keyval](https://github.com/jakearchibald/idb-keyval) | 6.3 | IndexedDB storage for the compressed catalog cache | Apache-2.0 |
|
||||
| [fflate](https://github.com/101arrowz/fflate) | 0.8 | Decompressing the catalog where the browser has no Compression Streams (older Safari / iOS) | MIT |
|
||||
| [Recharts](https://recharts.org) | 3.10 | Charts | MIT |
|
||||
| [Radix UI](https://www.radix-ui.com) primitives (`@radix-ui/react-checkbox`, `-dialog`, `-label`, `-popover`, `-separator`, `-slot`, `-switch`, `-tabs`) | 1.x / 2.x | Accessible UI building blocks | MIT |
|
||||
| [shadcn/ui](https://ui.shadcn.com) | pattern | Component patterns copied into `webapp/src/components/ui/` | MIT |
|
||||
| [lucide-react](https://lucide.dev) | 1.47 | Icons | ISC |
|
||||
| [lucide-react](https://lucide.dev) | 1.69 | Icons | ISC |
|
||||
| [class-variance-authority](https://cva.style) | 0.7 | Component variants | Apache-2.0 |
|
||||
| [clsx](https://github.com/lukeed/clsx) | 2.1 | Class-name helper | MIT |
|
||||
| [tailwind-merge](https://github.com/dcastil/tailwind-merge) | 3.7 | Class-name merging | MIT |
|
||||
| [Tailwind CSS](https://tailwindcss.com) (`tailwindcss`, `@tailwindcss/vite`) and [tw-animate-css](https://github.com/Wombosvideo/tw-animate-css) | 4.3 / 1.4 | Generate the site's CSS at build time | MIT |
|
||||
| [Geist and Geist Mono](https://vercel.com/font) (`@fontsource-variable/geist`, `@fontsource-variable/geist-mono`) | 5.3 | The site's typefaces | OFL-1.1 (fonts), MIT (Fontsource packaging) |
|
||||
| [`@tauri-apps/api`](https://github.com/tauri-apps/tauri/tree/dev/packages/api) | 2.11 | App-only bridge to the native shell | Apache-2.0 OR MIT |
|
||||
| [`@tauri-apps/plugin-opener`](https://github.com/tauri-apps/plugins-workspace/tree/v2/plugins/opener) | 2.5 | App-only: opens itch.io links in the system browser | Apache-2.0 OR MIT |
|
||||
| [`@tauri-apps/api`](https://github.com/tauri-apps/tauri/tree/dev/packages/api) | 2.12 | App-only bridge to the native shell | Apache-2.0 OR MIT |
|
||||
| [`@tauri-apps/plugin-opener`](https://github.com/tauri-apps/plugins-workspace/tree/v2/plugins/opener) | 2.7 | App-only: opens itch.io links in the system browser | Apache-2.0 OR MIT |
|
||||
|
||||
`@tanstack/react-query-devtools` (MIT) is listed as a dependency but only renders in development builds.
|
||||
|
||||
@@ -69,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-plugin-opener](https://github.com/tauri-apps/plugins-workspace/tree/v2/plugins/opener) | 2 | Opening links in the system browser | Apache-2.0 OR MIT |
|
||||
| [tauri-plugin-single-instance](https://github.com/tauri-apps/plugins-workspace/tree/v2/plugins/single-instance) | 2 | Desktop only: focuses the running window instead of starting a second copy | Apache-2.0 OR MIT |
|
||||
| [serde](https://serde.rs), [serde_json](https://github.com/serde-rs/json) | 1 | Serialization | MIT OR Apache-2.0 |
|
||||
| [serde](https://serde.rs) | 1 | Serialization | MIT OR Apache-2.0 |
|
||||
|
||||
The apps render with the system web view that the operating system provides: WebView2 on Windows,
|
||||
WKWebView on macOS (Safari/WebKit 16.4 or later), WebKitGTK on Linux and Android System WebView on Android.
|
||||
@@ -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`,
|
||||
`actions/setup-python`, `actions/setup-java`, `actions/cache`, `actions/upload-artifact`,
|
||||
`actions/download-artifact`, `android-actions/setup-android`, `dtolnay/rust-toolchain`,
|
||||
`tauri-apps/tauri-action`, `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).
|
||||
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.
|
||||
@@ -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 |
|
||||
| **GitHub** | Code, catalog data, issues and discussions, Actions (the pipeline), release downloads |
|
||||
| **SonarQube Cloud** (SonarSource) | Code analysis and test coverage of the public repository, on pushes to `main` and on pull requests |
|
||||
| **Qodana** (JetBrains) | Code analysis of the public repository (TypeScript / JavaScript, Python, Rust), on pushes to `main` and on pull requests |
|
||||
| **itch.io** | Where the games live; the pipeline and RSS discovery read public itch.io pages and feeds |
|
||||
| **Discord** | Receives automated CI and release notifications only |
|
||||
|
||||
|
||||
@@ -173,6 +173,7 @@ the queue bookkeeping. Use it sparingly.
|
||||
|
||||
```sh
|
||||
cd webapp
|
||||
npm run check:tauri # Tauri crates and their npm packages share major.minor
|
||||
npm run cf:types -- --check # worker-configuration.d.ts matches wrangler.jsonc
|
||||
npm run lint # ESLint
|
||||
npm run knip # unused files / exports / dependencies
|
||||
@@ -185,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
|
||||
SonarQube Cloud workflow (`sonarcloud.yml`) does.
|
||||
|
||||
Qodana (JetBrains) also analyses the code in CI (`qodana.yml`: TypeScript / JavaScript, Python and
|
||||
Rust, each with its own `qodana.yaml`). It needs the project tokens, so it has no local command here;
|
||||
the same inspections are built into WebStorm, PyCharm and RustRover.
|
||||
|
||||
After editing `wrangler.jsonc`, run `npm run cf:types` and commit the regenerated
|
||||
`worker-configuration.d.ts`.
|
||||
|
||||
|
||||
@@ -0,0 +1,196 @@
|
||||
# Trợ năng (Accessibility)
|
||||
|
||||
Cập nhật lần cuối: 2026-11-09
|
||||
|
||||
Áp dụng từ: khi phát hành phiên bản 4.6.0 (website và các ứng dụng desktop, Android).
|
||||
|
||||
> Bản dịch từ bản tiếng Anh cập nhật ngày 2026-11-09 (English source revision 2026-11-09). Nếu có khác biệt, bản tiếng Anh được ưu tiên. Bản gốc: [`ACCESSIBILITY.md`](../../../ACCESSIBILITY.md).
|
||||
|
||||
Đây là một dự án sở thích do một người vận hành, poli0981 (SkullMute), dưới đây gọi là "Người duy trì": một danh mục game itch.io miễn phí, có trên website https://freeitchgames.win và trong các ứng dụng desktop, Android hiển thị cùng các trang đó. Ai cũng nên dùng được, dù bạn chỉ dùng bàn phím, trình đọc màn hình, phóng to, giao diện tương phản cao, nhập liệu bằng giọng nói hay bất cứ công cụ nào khác. Tuyên bố này cho biết những gì đã hoạt động, cách kiểm tra, những gì chưa ổn, và cách báo cho Người duy trì khi có gì đó cản trở bạn.
|
||||
|
||||
> **Tóm tắt (TL;DR)**
|
||||
>
|
||||
> - Mục tiêu là [WCAG 2.2](https://www.w3.org/TR/WCAG22/) mức AA cho website và các ứng dụng. Đó là mục tiêu, không phải chứng nhận: chưa có ai ngoài dự án đánh giá.
|
||||
> - Mọi trang đều dùng được chỉ với bàn phím và với trình đọc màn hình. Người duy trì kiểm tra bằng bàn phím (không dùng chuột), Windows Narrator, và VoiceOver trên iPhone.
|
||||
> - Màu sắc đạt tỉ lệ tương phản WCAG ở cả giao diện sáng và tối, và một bài test kiểm tra lại sau mỗi thay đổi. Hỗ trợ chế độ tương phản (Contrast themes) của Windows và làm theo thiết lập "giảm chuyển động" của hệ thống.
|
||||
> - Mỗi biểu đồ đều có bảng dữ liệu đi kèm.
|
||||
> - Các hạn chế đã biết nằm ở [§6](#6-các-hạn-chế-đã-biết).
|
||||
> - Có gì cản trở bạn? Hãy mở một [issue trợ năng](https://github.com/poli0981/free-games-itchio-list/issues/new?template=accessibility.yml) hoặc email **contact@poli0981.dev**.
|
||||
|
||||
## 1. Phạm vi
|
||||
|
||||
Tuyên bố này áp dụng cho:
|
||||
|
||||
- **website** https://freeitchgames.win: mọi trang công khai (Trang chủ, Games, trang từng game, Charts, Removed, Suggest, Settings, About, các trang lỗi) và trang xác minh hiện ra trước đó;
|
||||
- **các ứng dụng desktop** (Windows, macOS, Linux) **và ứng dụng Android**, vốn hiển thị cùng các trang trong web view của hệ thống.
|
||||
|
||||
Tuyên bố này không áp dụng cho:
|
||||
|
||||
- bản thân các game, trang itch.io của chúng, và những gì người tạo game viết hay làm ra (tên, mô tả, tag, ảnh bìa);
|
||||
- Cloudflare Turnstile, bước kiểm tra của bên thứ ba trên trang xác minh và trên form Suggest (Cloudflare chịu trách nhiệm về trợ năng của nó);
|
||||
- trang quản trị của Người duy trì, vốn chỉ có một người dùng;
|
||||
- các trang web khác được liên kết tới, kể cả GitHub.
|
||||
|
||||
## 2. Mục tiêu và ưu tiên
|
||||
|
||||
- **Mục tiêu**: [WCAG 2.2](https://www.w3.org/TR/WCAG22/) mức AA, trong khả năng của một dự án sở thích do một người làm.
|
||||
- **Trước hết**: các việc chính dùng được với bàn phím và trình đọc màn hình: tìm game, đọc thông tin, mở game trên itch.io, đổi cài đặt, gợi ý game.
|
||||
- **Tiếp theo**: chữ và nút dễ đọc (tương phản, phóng to, dàn lại bố cục), không có chuyển động bạn không yêu cầu, và đúng ngôn ngữ cho trình đọc màn hình (tiếng Anh hoặc tiếng Việt).
|
||||
- **Luôn luôn**: tính năng mới phải giữ được tất cả những điều trên (xem [§8](#8-dành-cho-người-đóng-góp)).
|
||||
|
||||
## 3. Những gì đã hoạt động
|
||||
|
||||
### Di chuyển trong trang
|
||||
|
||||
- "Chuyển đến nội dung" (Skip to content) là thứ đầu tiên phím Tab chạm tới.
|
||||
- Mỗi trang có các vùng mốc (landmark) được đặt tên (đầu trang, menu chính, tìm kiếm, nội dung chính, phân trang, chân trang), một tiêu đề cấp 1 và tiêu đề trang riêng.
|
||||
- Khi bạn bấm một liên kết bên trong site, focus chuyển tới tiêu đề của trang mới, nên trình đọc màn hình đọc tên trang và phím Tab đi tiếp từ đó. Khi quay lại, focus trở về liên kết bạn vừa dùng, ví dụ game bạn mở từ danh sách.
|
||||
- Thanh đầu trang cố định không bao giờ che phần tử đang có focus bàn phím.
|
||||
|
||||
### Bàn phím
|
||||
|
||||
- Mọi thứ đều dùng được chỉ với bàn phím: menu, bộ lọc, hộp thoại và biểu đồ.
|
||||
- Focus luôn nhìn thấy được: một đường viền tím, hoặc màu tô sáng của hệ thống trong chế độ tương phản.
|
||||
- Hộp thoại giữ focus bên trong khi đang mở và trả focus về chỗ cũ khi đóng.
|
||||
- Phím "/" đưa bạn tới ô tìm kiếm. Bạn có thể tắt phím tắt này trong **Settings → Trợ năng**, hữu ích khi nhập liệu bằng giọng nói hoặc khi phím này xung đột với trình đọc màn hình hay chức năng tìm nhanh của trình duyệt.
|
||||
- Khi một nút biến mất sau khi bạn dùng nó (xoá ô tìm kiếm, bỏ một bộ lọc), focus chuyển tới chỗ hợp lý tiếp theo thay vì bị mất.
|
||||
|
||||
### Trình đọc màn hình
|
||||
|
||||
- Mọi nút điều khiển đều có tên, bằng tiếng Anh hoặc tiếng Việt. Biểu tượng được ẩn khỏi trình đọc màn hình.
|
||||
- Số kết quả, gợi ý tìm kiếm, trạng thái đang tải và thông báo của form đều được đọc lên.
|
||||
- Trên màn hình rộng, danh sách game là một bảng có tiêu đề cột; trên điện thoại là một danh sách đơn giản.
|
||||
- Liên kết mở thẻ mới (trong ứng dụng: mở trình duyệt) đều nói rõ điều đó.
|
||||
- Chữ thuộc ngôn ngữ kia, như tên các ngôn ngữ và tên tiếng Anh của các văn bản pháp lý, được đánh dấu đúng ngôn ngữ.
|
||||
|
||||
### Nhìn nội dung
|
||||
|
||||
- Chữ và nút đạt tỉ lệ tương phản WCAG 2.2 AA ở cả hai giao diện: 4.5:1 cho chữ, 3:1 cho viền ô nhập, đường viền focus và màu biểu đồ. Bài test [`webapp/scripts/check-contrast.test.mjs`](../../../webapp/scripts/check-contrast.test.mjs) kiểm tra màu sau mỗi thay đổi.
|
||||
- Giao diện sáng, tối hoặc theo hệ thống; dòng gọn hoặc thường; ẩn thanh cuộn: tất cả nằm trong Settings.
|
||||
- Chế độ tương phản của Windows (forced colors): tab đang chọn, nút bật/tắt đang bấm, trang hiện tại và các công tắc dùng màu tô sáng của hệ thống.
|
||||
- Không bao giờ chặn phóng to. Ở mức phóng 400 % hoặc cửa sổ rộng 320 pixel, bố cục điện thoại được dùng và trang không phải cuộn ngang.
|
||||
- Liên kết nằm trong câu đều được gạch chân. Không có gì chỉ dựa vào màu sắc: trạng thái luôn kèm thay đổi chữ, viền hoặc gạch chân.
|
||||
|
||||
### Chuyển động
|
||||
|
||||
- Khi bạn bật "giảm chuyển động" trong hệ thống, hiệu ứng, phần biểu đồ hiện ra và cuộn mượt đều tắt.
|
||||
- Trên website, ảnh bìa thường được hiển thị dạng ảnh tĩnh (ảnh bìa động được chuyển thành ảnh tĩnh).
|
||||
- Ngoài các khối giữ chỗ khi đang tải, không có gì tự chuyển động.
|
||||
|
||||
### Biểu đồ
|
||||
|
||||
- Mỗi biểu đồ được đặt tên theo tiêu đề của nó. Đưa focus vào biểu đồ rồi dùng phím mũi tên trái, phải: giá trị bạn chuyển tới sẽ được đọc lên.
|
||||
- Dưới mỗi biểu đồ, **Bảng dữ liệu** mở cùng các số liệu dưới dạng bảng, kèm tỉ lệ từng phần với biểu đồ tròn.
|
||||
|
||||
### Ngôn ngữ
|
||||
|
||||
- Các trang có tiếng Anh và tiếng Việt (Settings), và ngôn ngữ của trang đi theo lựa chọn của bạn, nên trình đọc màn hình chọn đúng giọng đọc. Số và ngày tháng cũng theo ngôn ngữ đó.
|
||||
|
||||
## 4. Cách kiểm tra
|
||||
|
||||
- **Người duy trì kiểm tra thủ công** (tháng 11/2026): website trên Windows 11 và ứng dụng desktop Windows, chỉ dùng bàn phím (tắt chuột) và Windows Narrator. Không thấy lỗi nào chặn việc sử dụng.
|
||||
- **Trên điện thoại thật** (tháng 11/2026, phiên bản 4.6.0): website trên iPhone 14 Pro với VoiceOver, trong Safari, Chrome và Brave. Kết quả: đạt.
|
||||
- **Cho bản 4.6.0**: các trang chính và hộp thoại được đi hết bằng bàn phím, và cây trợ năng (accessibility tree) của chúng được kiểm tra (tên, vai trò, tiêu đề, vùng mốc, thông báo) bằng tiếng Anh và tiếng Việt, trên màn hình máy tính và màn hình cỡ điện thoại.
|
||||
- **Tự động, sau mỗi thay đổi**: bài test tương phản ở trên và các unit test của ứng dụng (focus đi đâu sau khi đổi trang, bảng dữ liệu biểu đồ).
|
||||
- **Trước mỗi lần phát hành**: một lượt kiểm tra nhanh. Gồm đi hết các việc chính bằng bàn phím, thử nhanh với trình đọc màn hình, phóng to 200 % và cửa sổ hẹp, giảm chuyển động, và một chế độ tương phản của Windows.
|
||||
- **Chưa có**: quét tự động trên trình duyệt (như axe hay Lighthouse) trong CI, và việc kiểm tra bởi những người dùng hằng ngày nhiều công cụ hỗ trợ khác nhau. Mọi sự giúp đỡ đều được hoan nghênh.
|
||||
|
||||
## 5. Môi trường được hỗ trợ
|
||||
|
||||
| | Phiên bản |
|
||||
|---|---|
|
||||
| Website | Chrome, Edge, Firefox và Safari hiện hành trên máy tính và điện thoại. Các phiên bản cũ nhất mà site được build cho là Chrome và Edge 111, Firefox 114, Safari và iOS 15.4. |
|
||||
| Ứng dụng desktop | Windows 10 và 11 (Microsoft Edge WebView2), macOS (WebKit 16.4 trở lên), Linux (WebKitGTK 4.1) |
|
||||
| Ứng dụng Android | Android 11 trở lên |
|
||||
|
||||
Công cụ hỗ trợ (assistive technology):
|
||||
|
||||
- **Đã kiểm tra**: Windows Narrator trên Windows 11, VoiceOver trên iOS (iPhone 14 Pro: Safari, Chrome và Brave), và dùng chỉ bàn phím.
|
||||
- **Dự kiến dùng được, chưa kiểm tra thường xuyên**: NVDA và JAWS trên Windows, VoiceOver trên macOS, TalkBack trên Android, phóng to của trình duyệt, chế độ tương phản của Windows, nhập liệu bằng giọng nói. Chúng dựa trên cùng mã HTML chuẩn.
|
||||
- **Hạn chế**: Orca trong ứng dụng desktop Linux, vì WebKitGTK hỗ trợ trình đọc màn hình kém hơn các trình duyệt.
|
||||
|
||||
## 6. Các hạn chế đã biết
|
||||
|
||||
- **Chữ của người tạo game không được đánh dấu ngôn ngữ.** Tên, mô tả và tag của game lấy từ itch.io bằng nhiều ngôn ngữ, và trình đọc màn hình đọc chúng theo ngôn ngữ của trang.
|
||||
- **Ảnh bìa chỉ có mô tả chung** ("Tên game cover"). Nội dung bức ảnh không được mô tả.
|
||||
- **Biểu đồ**: phím mũi tên chỉ di chuyển trái và phải. Biểu đồ treemap thể loại không đi từng phần được, nhưng số liệu của nó có trong bảng dữ liệu và trong biểu đồ Genres. Chữ trong biểu đồ có cỡ pixel cố định, nên tăng cỡ chữ mặc định của trình duyệt không làm nó to lên (phóng to trang thì có).
|
||||
- **Ứng dụng desktop**: không có phím phóng to bên trong ứng dụng, cửa sổ không phóng to toàn màn hình (maximize) được, và không thu nhỏ hơn 900 × 600. Nếu cần chữ lớn hơn, hãy dùng tỉ lệ hiển thị (display scaling) của hệ thống hoặc mở website trong trình duyệt.
|
||||
- **Ứng dụng Android**: không phóng to bằng hai ngón tay được. Website trong trình duyệt điện thoại thì phóng to được.
|
||||
- **Ảnh bìa động trong ứng dụng**: ứng dụng tải ảnh bìa trực tiếp từ itch.io, nên ảnh bìa động vẫn chạy ở đó.
|
||||
- **Bước kiểm tra của Cloudflare**: bước xác minh (chỉ trên website) và bước chống spam của form Suggest là widget Cloudflare Turnstile. Thường chúng tự qua mà bạn không cần làm gì. Nếu có lúc chúng yêu cầu điều bạn không làm được, hãy email Người duy trì.
|
||||
- **Trang trên GitHub**: các chính sách, tuyên bố này và các form issue nằm trên GitHub, nên trợ năng của chính GitHub áp dụng ở đó.
|
||||
- **Chưa có đánh giá độc lập**, và chỉ có một người duy trì.
|
||||
|
||||
## 7. Báo cáo rào cản trợ năng
|
||||
|
||||
Nếu có gì ngăn bạn hoặc làm bạn chậm lại, hãy cho biết. Báo cáo chưa đầy đủ cũng có ích.
|
||||
|
||||
- **GitHub**: mở một [issue Accessibility barrier](https://github.com/poli0981/free-games-itchio-list/issues/new?template=accessibility.yml).
|
||||
- **Email**: **contact@poli0981.dev**. Không cần tài khoản GitHub; viết tiếng Anh hay tiếng Việt đều được.
|
||||
|
||||
Những chi tiết có ích, trong chừng mực bạn thấy thoải mái chia sẻ (đừng bao giờ gửi thông tin sức khoẻ):
|
||||
|
||||
- bạn đang định làm gì, và điều gì đã xảy ra;
|
||||
- trang (địa chỉ) hoặc ứng dụng và phiên bản của nó, xem trên trang About;
|
||||
- thiết bị, hệ điều hành và trình duyệt;
|
||||
- công cụ hỗ trợ bạn dùng và phiên bản, nếu có;
|
||||
- ảnh chụp màn hình hoặc video, nếu được.
|
||||
|
||||
Mức độ ảnh hưởng:
|
||||
|
||||
| Mức độ | Ý nghĩa |
|
||||
|---|---|
|
||||
| Critical (nghiêm trọng nhất) | Bạn hoàn toàn không làm được một việc chính, ví dụ mở game hay đọc thông tin của nó. |
|
||||
| Serious (nghiêm trọng) | Bạn làm được, nhưng rất vất vả hoặc phải đi đường vòng. |
|
||||
| Moderate (trung bình) | Gây phiền hoặc không nhất quán, nhưng vẫn làm được. |
|
||||
| Minor (nhỏ) | Một chi tiết nhỏ cần chỉnh. |
|
||||
|
||||
Điều gì xảy ra tiếp theo. Đây là mục tiêu, không phải cam kết, vì đây là dự án sở thích của một người:
|
||||
|
||||
- **Xác nhận đã nhận** trong vòng 7 ngày, thường sớm hơn.
|
||||
- **Sửa lỗi hoặc đưa cách khắc phục tạm**: Critical trong 30 ngày, Serious trong 60 ngày, Moderate và Minor ở một bản phát hành sau.
|
||||
- **Bản sửa cho website** có hiệu lực khi được deploy; **bản sửa cho ứng dụng** đi kèm bản phát hành tiếp theo.
|
||||
- Bạn sẽ được hỏi bản sửa đã ổn với bạn chưa, và được ghi công trong release notes nếu muốn.
|
||||
|
||||
Lỗ hổng bảo mật không nên đưa vào issue công khai: xem [Chính sách bảo mật](SECURITY.md).
|
||||
|
||||
## 8. Dành cho người đóng góp
|
||||
|
||||
Thay đổi giao diện phải giữ đúng những điều ở [§3](#3-những-gì-đã-hoạt-động):
|
||||
|
||||
- **Bàn phím**: mọi nút đều tới được và dùng được, focus luôn nhìn thấy và không bị mất.
|
||||
- **Tên**: mọi nút có nhãn, với chữ có trong cả `webapp/src/lib/i18n/en.ts` và `vi.ts`.
|
||||
- **Màu sắc**: dùng các token của theme. `npm test` kiểm tra tương phản (4.5:1 cho chữ, 3:1 cho viền, focus và màu biểu đồ), và màu sắc không bao giờ là tín hiệu duy nhất.
|
||||
- **Chuyển động**: tôn trọng `prefers-reduced-motion`; quy tắc CSS dùng chung và `SERIES_ANIMATION` đã làm việc đó.
|
||||
- **Trình đọc màn hình**: kiểm tra thay đổi ít nhất một lần với một trình đọc (Narrator, NVDA, VoiceOver hoặc TalkBack).
|
||||
- **Mã HTML**: ưu tiên phần tử gốc và các component Radix / shadcn đang dùng, chỉ thêm ARIA khi thật cần.
|
||||
|
||||
Tài liệu: tiêu đề theo đúng thứ tự, chữ của liên kết nói rõ nó dẫn tới đâu, ảnh có alt, bảng có ô tiêu đề, và bản tiếng Việt được cập nhật (hoặc ghi rõ trong pull request là chưa).
|
||||
|
||||
[Pull request template](../../../.github/pull_request_template.md) có sẵn danh sách kiểm tra.
|
||||
|
||||
## 9. Tìm game có hỗ trợ tiếp cận
|
||||
|
||||
Danh mục hiển thị các tính năng hỗ trợ tiếp cận mà người tạo game liệt kê trên trang itch.io của họ, như phụ đề, điều khiển tuỳ chỉnh được hay chế độ cho người mù màu:
|
||||
|
||||
- trên trang của từng game, ở mục "Hỗ trợ tiếp cận";
|
||||
- trong bộ lọc Hỗ trợ tiếp cận ở trang Games, ví dụ https://freeitchgames.win/games?access=Subtitles;
|
||||
- trong biểu đồ "Tính năng hỗ trợ tiếp cận" (Charts → Khám phá).
|
||||
|
||||
Người tạo game tự khai báo các tính năng này, và dự án không kiểm chứng. Nếu thông tin của một game sai, hãy báo bằng issue template "Bug Report".
|
||||
|
||||
## 10. Tài liệu tham khảo
|
||||
|
||||
- [Open Source Guides: Accessibility best practices for your project](https://opensource.guide/accessibility-best-practices-for-your-project/)
|
||||
- [Open Source Accessibility toolkit](https://github.com/open-source-accessibility/accessibility-toolkit): tuyên bố này theo dàn ý của mẫu ACCESSIBILITY.md trong đó, với lời văn riêng.
|
||||
- [Web Content Accessibility Guidelines (WCAG) 2.2](https://www.w3.org/TR/WCAG22/)
|
||||
- [W3C: Developing an accessibility statement](https://www.w3.org/WAI/planning/statements/)
|
||||
|
||||
## 11. Liên hệ
|
||||
|
||||
- **Rào cản trợ năng**: [form issue](https://github.com/poli0981/free-games-itchio-list/issues/new?template=accessibility.yml) hoặc **contact@poli0981.dev**.
|
||||
- **Mọi việc khác**: xem các địa chỉ trong [README → Pháp lý](../../../README.vi.md#pháp-lý).
|
||||
|
||||
## 12. Lời cuối
|
||||
|
||||
Một người, một danh mục, và mọi cách duyệt web. Nếu có gì ở đây không hợp với cách bạn dùng web, Người duy trì thật sự muốn được biết — đó là cách danh sách này ngày càng tốt hơn. 🚀
|
||||
@@ -4,7 +4,7 @@ Cập nhật lần cuối: 2026-09-29
|
||||
|
||||
Áp dụng từ: khi phát hành phiên bản 4.0.0.
|
||||
|
||||
> Bản dịch từ bản tiếng Anh cập nhật ngày 2026-09-18 (English source revision 2026-09-18). Nếu có khác biệt, bản tiếng Anh được ưu tiên. Bản gốc: [`CODE_OF_CONDUCT.md`](../../../CODE_OF_CONDUCT.md).
|
||||
> Bản dịch từ bản tiếng Anh cập nhật ngày 2026-09-29 (English source revision 2026-09-29). Nếu có khác biệt, bản tiếng Anh được ưu tiên. Bản gốc: [`CODE_OF_CONDUCT.md`](../../../CODE_OF_CONDUCT.md).
|
||||
|
||||
Đây là một repo sở thích nhỏ về game itch.io miễn phí, do một dev noob đang thất nghiệp vận hành: poli0981 (SkullMute), dưới đây gọi là "Người duy trì". Nói đơn giản: hãy cư xử đàng hoàng. Người duy trì là introvert max level với kỹ năng xã hội bằng không, nên mình cùng giữ mọi thứ tích cực nhé.
|
||||
|
||||
|
||||
@@ -1,14 +1,22 @@
|
||||
# Hướng dẫn đóng góp
|
||||
|
||||
> Bản dịch từ bản tiếng Anh cập nhật ngày 2026-10-13 (English source revision 2026-10-13). Nếu có khác biệt, bản tiếng Anh được ưu tiên.
|
||||
> Bản dịch từ bản tiếng Anh cập nhật ngày 2026-11-11 (English source revision 2026-11-11). Nếu có khác biệt, bản tiếng Anh được ưu tiên.
|
||||
>
|
||||
> Bản tiếng Anh tại [`CONTRIBUTING.md`](../../../CONTRIBUTING.md) là bản chính thức.
|
||||
|
||||
Cảm ơn bạn vì đã có suy nghĩ đóng góp cho cái repo random này! Tôi chỉ là một dev người Việt thất nghiệp, hướng nội, kỹ năng tầm tầm, có hai trợ lý AI không phán xét: **Grok (xAI)** cho brainstorming đêm khuya và **Claude Code (Anthropic)** cho phần việc code/docs nặng hơn. Danh sách này sống nhờ sự giúp đỡ của cộng đồng, vì tôi quá lười để tự đi săn/sửa hết một mình :D Bất kỳ đóng góp nào (kể cả chỉ một game) cũng khiến bạn thành huyền thoại.
|
||||
|
||||
## Trạng thái dự án: ổn định, chỉ bảo trì
|
||||
|
||||
Từ phiên bản 4.6.1 (2026-11-11), dự án ở trạng thái **ổn định và chỉ bảo trì**. Dự án đã đủ tính năng: website, các ứng dụng và pipeline dữ liệu vẫn chạy, danh mục vẫn tự cập nhật.
|
||||
|
||||
- **Maintainer vẫn làm**: vá bảo mật (CVE và báo cáo gửi qua [SECURITY](SECURITY.md)), cập nhật runtime và thư viện phụ thuộc, và sửa khi có gì đó làm website hoặc việc cập nhật dữ liệu hằng ngày ngừng chạy.
|
||||
- **Không còn làm**: tính năng mới, thiết kế lại, refactor.
|
||||
- **Issue và pull request chỉ được nhận cho dữ liệu**: thêm game (mục 1), sửa dữ liệu của một game hoặc gỡ game (mục 2 và 3). Rào cản trợ năng (mục 3) và báo cáo bảo mật vẫn giữ kênh riêng. Mọi thứ khác sẽ bị đóng mà không review; không giận gì nhau cả.
|
||||
|
||||
## Cách đóng góp (Đi đúng cửa, tôi lười ;D)
|
||||
|
||||
Game thì gửi qua website; mọi thứ khác thì qua các template issue/PR trên GitHub. Chúng làm cuộc đời tôi dễ hơn và giảm các khoảnh khắc "wtf".
|
||||
Game thì gửi qua website; sửa dữ liệu và gỡ game thì qua các issue template trên GitHub hoặc email. Chúng làm cuộc đời tôi dễ hơn và giảm các khoảnh khắc "wtf".
|
||||
|
||||
### 1. Đề xuất game mới (Hoan nghênh nhất!)
|
||||
|
||||
@@ -16,9 +24,10 @@ Game thì gửi qua website; mọi thứ khác thì qua các template issue/PR t
|
||||
- Tùy chọn: một ghi chú ngắn (vì sao game hay, cảnh báo nội dung…), tối đa 500 ký tự. Ghi chú bị xóa sau 180 ngày. Vui lòng đừng ghi dữ liệu cá nhân vào đó.
|
||||
- Một bước kiểm tra Cloudflare Turnstile và giới hạn tần suất giúp chặn bot; nếu bị chặn, đợi một lúc rồi thử lại.
|
||||
- Chỉ game itch.io **miễn phí**. Game trả phí sẽ tự động bị loại khi trang game được cào.
|
||||
- Game phải chơi được hoặc tải được **ngay trên trang itch.io của nó** (bản chạy trên trình duyệt hoặc file đã tải lên). Trang chỉ dẫn sang launcher hay link tải ở site khác thì không đủ điều kiện, kể cả khi miễn phí: [Tuyên bố miễn trừ](DISCLAIMER.md) nói với người dùng rằng mọi lượt tải diễn ra trên itch.io.
|
||||
- Không có gì lên site ngay lập tức: mọi đề xuất đều vào **hàng chờ duyệt**, nơi Maintainer duyệt hoặc từ chối, bằng tay hoặc qua quy tắc tự động (một đề xuất không có cờ cảnh báo mà không ai từ chối trong khoảng một ngày có thể được duyệt tự động). Link được duyệt sau đó được pipeline dữ liệu cào và xuất hiện trên site sau lần deploy kế tiếp.
|
||||
|
||||
Có cả một danh sách? Issue template **[Add Games (bulk list)]** nhận tối đa 15 link một lần, và một PR thêm URL itch.io vào `scripts/temp_link.json` cũng được (dùng PR template [Add Games]). Cả hai đều đi qua cùng quy trình duyệt: Maintainer kiểm tra từng link trước khi đưa vào hàng chờ, và việc merge một PR như vậy chính là sự phê duyệt. Vui lòng đừng sửa tay `data_game/`: các file đó do pipeline quản lý (xem [mục 7](#7-gửi-thay-đổi-code-pr)).
|
||||
Có cả một danh sách? Issue template **[Add Games (bulk list)]** nhận tối đa 15 link một lần, và một PR thêm URL itch.io vào `scripts/temp_link.json` cũng được (dùng PR template [Add Games]). Cả hai đều đi qua cùng quy trình duyệt: Maintainer kiểm tra từng link trước khi đưa vào hàng chờ, và việc merge một PR như vậy chính là sự phê duyệt. Vui lòng đừng sửa tay `data_game/`: các file đó do pipeline quản lý (xem [mục 7](#7-pull-request)).
|
||||
|
||||
#### 1b. Những cách khác để game được thêm vào
|
||||
|
||||
@@ -35,53 +44,55 @@ 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.
|
||||
- Maintainer sẽ gỡ bản ghi khỏi danh mục (ghi kèm lý do trên [trang game đã gỡ](https://freeitchgames.win/removed) công khai) và xóa các bản ảnh bìa thu nhỏ mà site lưu trữ; các bản trong cache sẽ tự hết hạn. Mục tiêu: trong vòng 7 ngày, yêu cầu pháp lý khẩn cấp thì sớm hơn.
|
||||
- Lưu ý: đây là một repo git công khai, nên các phiên bản cũ vẫn còn trong lịch sử. Việc viết lại lịch sử công khai chỉ được làm trong trường hợp ngoại lệ vì bắt buộc về pháp lý.
|
||||
- `safe_virus` / `nsfw` / ghi chú bị sai, hoặc lỗi dữ liệu khác không phải yêu cầu gỡ? Mở issue **[Bug Report]** cũng được.
|
||||
- `safe_virus` / `nsfw` / ghi chú bị sai, hoặc lỗi dữ liệu khác không phải yêu cầu gỡ? Dùng issue template **[Report a problem]** (mục 3).
|
||||
|
||||
Chi tiết có trong [Điều khoản sử dụng](ToS.md) và [Tuyên bố miễn trừ](DISCLAIMER.md).
|
||||
|
||||
### 3. Báo lỗi
|
||||
### 3. Báo sự cố (dữ liệu sai, có gì đó bị hỏng)
|
||||
|
||||
- Mở issue → template **[Bug Report]**.
|
||||
- Checkbox cho các lỗi thường gặp (link chết, cờ sai, trang hỏng, v.v.).
|
||||
- Mở issue → template **[Report a problem]** ([link trực tiếp](https://github.com/poli0981/free-games-itchio-list/issues/new?template=bug_report.yml)).
|
||||
- Dành cho **lỗi dữ liệu** (link chết, sai tên, thể loại, tag, ảnh bìa, cờ `nsfw` hoặc `safe_virus`…) và cho **những thứ bị hỏng** (một trang hay ứng dụng ngừng hoạt động, danh mục không còn cập nhật). Không dành cho ý tưởng: xem mục 4.
|
||||
- Chi tiết + ảnh chụp màn hình + mức độ khẩn cấp.
|
||||
- **Vấn đề bảo mật không phải lỗi để đăng lên tracker công khai.** Hãy báo cáo riêng tư: xem [SECURITY](SECURITY.md).
|
||||
- Nếu phức tạp, xem mục "Muốn thảo luận thêm?" bên dưới.
|
||||
- **Vấn đề bảo mật không dành cho tracker công khai.** Hãy báo cáo riêng tư: xem [SECURITY](SECURITY.md).
|
||||
- **Rào cản trợ năng** (bàn phím, trình đọc màn hình, phóng to, tương phản, chuyển động…): dùng template **[Accessibility barrier]** ([link trực tiếp](https://github.com/poli0981/free-games-itchio-list/issues/new?template=accessibility.yml)), hoặc gửi email tới contact@poli0981.dev nếu bạn không muốn dùng GitHub. Điều gì xảy ra tiếp theo nằm trong [Trợ năng](ACCESSIBILITY.md#7-báo-cáo-rào-cản-trợ-năng).
|
||||
|
||||
### 4. Đề xuất tính năng / cải tiến
|
||||
### 4. Tính năng và cải tiến (đã đóng)
|
||||
|
||||
- Mở issue → template **[Feature Request / Improvement]**.
|
||||
- Chọn loại (tính năng mới hoặc sửa code), tên, lý do, độ ưu tiên (từ "nice to have" tới "repo sắp chết").
|
||||
- Tùy chọn: pseudo-code/snippet (đừng có malware nhé, tôi sẽ check bằng kỹ năng tầm thường của mình :D).
|
||||
- Dự án đang ở chế độ bảo trì: **đề xuất tính năng, ý tưởng cải tiến và thay đổi code không còn được nhận**. Issue và pull request loại này sẽ bị đóng mà không review.
|
||||
- Code dùng giấy phép MIT: bạn cứ thoải mái fork và tự làm phiên bản của mình ([README → Giấy phép](../../../README.vi.md#giấy-phép)).
|
||||
|
||||
### 5. Gửi góp ý
|
||||
### 5. Góp ý, câu hỏi, mọi thứ khác
|
||||
|
||||
- Dùng template **[Feedback]**.
|
||||
- Checkbox (EULA/ToS quá khắt khe? Concept repo dở? Anti-AI? Xóa repo? Khác).
|
||||
- Chê hay khen đều được, sự tự ti của tôi chịu được.
|
||||
- Dùng **[GitHub Discussions](https://github.com/poli0981/free-games-itchio-list/discussions)**, các server Discord hoặc email (xem "Muốn thảo luận thêm?" bên dưới). Chê hay khen đều được, sự tự ti của tôi chịu được.
|
||||
- Tôi có đọc, nhưng chúng không biến thành tính năng mới (mục 4).
|
||||
|
||||
### 6. Mọi thứ khác (câu hỏi, meme, lạc đề)
|
||||
### 6. Thư viện phụ thuộc và vá bảo mật
|
||||
|
||||
- Dùng template **[General / Off-Topic]**.
|
||||
- Có gì trong đầu cứ đăng.
|
||||
- Việc cập nhật thư viện phụ thuộc do Dependabot và đợt rà soát hằng tuần của Maintainer lo: xin đừng gửi PR nâng phiên bản.
|
||||
- Tìm thấy lỗ hổng? Hãy báo cáo riêng tư ([SECURITY](SECURITY.md)); Maintainer sẽ tự vá.
|
||||
|
||||
### 7. Gửi thay đổi code (PR)
|
||||
### 7. Pull request
|
||||
|
||||
- Fork → tạo branch → code → mở PR vào `main` với PR template phù hợp ([Bug Fix], [New Feature], [Documentation]…).
|
||||
- Mô tả rõ ràng giúp nhé. Tôi sẽ review chậm (lịch thất nghiệp + hai AI buddy).
|
||||
- **Được nhận**: PR thêm URL itch.io vào `scripts/temp_link.json` (dùng PR template [Add Games]). Merge PR chính là sự chấp thuận của Maintainer.
|
||||
- **Không được nhận**: mọi thứ khác (code, giao diện, tài liệu, refactor). Sửa hoặc gỡ dữ liệu của một game thì đi qua issue hoặc email (mục 2 và 3), vì pipeline quản lý `data_game/`.
|
||||
- Các quy tắc dưới đây vẫn áp dụng cho mọi PR, kể cả PR của chính Maintainer.
|
||||
|
||||
**Quy tắc PR** (phần không thương lượng):
|
||||
|
||||
- **CI phải pass.** Python CI (ruff check + format, vulture, pytest, `validate.py`) và Webapp CI (kiểm tra type sinh ra, lint, knip, test, build, `wrangler deploy --dry-run`) đều chạy trên PR. CI đỏ = không merge. 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): …`).
|
||||
- **Giấy phép theo nguyên tắc inbound = outbound.** Khi mở PR, bạn đồng ý rằng đóng góp của mình được cấp phép theo cùng giấy phép với phần mà nó thay đổi: **MIT** cho mã nguồn, **CC BY 4.0** cho dữ liệu danh mục và tài liệu (xem [README → Giấy phép](../../../README.vi.md#giấy-phép)). Chỉ gửi những gì bạn có quyền gửi.
|
||||
- **Không bao giờ commit secret**: không token, API key, file `.dev.vars` / `.env`, private key (chẳng hạn khóa của GitHub App) hay keystore dùng để ký. Nếu lỡ push một cái, hãy báo riêng (security@poli0981.dev) và thay mới (rotate) nó; chỉ xóa commit là không đủ.
|
||||
- **Không sửa tay `data_game/`.** Thay đổi dữ liệu phải đi qua pipeline (một patch + `apply_patch.py`, có chạy `validate.py`), để các tiến trình ghi đồng thời không đè lên nhau.
|
||||
- Không commit output build hay file sinh ra: `webapp/dist/`, `webapp/.wrangler/`, `webapp/src-tauri/target/`, `webapp/src-tauri/gen/`. (`webapp/src-tauri/Cargo.lock` **có** được commit; hãy cập nhật nó khi bạn sửa `Cargo.toml`.)
|
||||
- Thêm dependency npm? Thêm luôn vào danh sách `THIRD_PARTY` trong `webapp/src/lib/about.ts` để trang About ghi công.
|
||||
- Link ngoài mới trong app? Dùng `<ExtLink href="…">` từ `webapp/src/components/ext-link.tsx`, đừng dùng `<a href="…" target="_blank">` thuần: anchor thuần chạy được trên web nhưng im lặng hỏng trong các app Tauri.
|
||||
- Link ngoài mới trong app? Dùng `<ExtLink href="…">` từ `webapp/src/components/ext-link.tsx`, đừng dùng `<a href="…" target="_blank">` thuần: anchor thuần chạy được trên web nhưng im lặng hỏng trong các app Tauri (và ExtLink báo cho trình đọc màn hình rằng link mở thẻ mới).
|
||||
- **Trợ năng**: thay đổi giao diện phải vẫn dùng được chỉ với bàn phím và với trình đọc màn hình, và giữ tỉ lệ tương phản (`npm test` kiểm tra màu). Danh sách kiểm tra nằm trong [Trợ năng → Dành cho người đóng góp](ACCESSIBILITY.md#8-dành-cho-người-đóng-góp) và trong pull request template.
|
||||
|
||||
### 8. Thiết lập môi trường dev (tóm tắt)
|
||||
|
||||
Dành cho các bản fork, và cho việc bảo trì của chính Maintainer.
|
||||
|
||||
Hướng dẫn đầy đủ (Worker, D1 cục bộ, secret, Tauri, Android) nằm trong **[`docs/dev_env.md`](../../dev_env.md)** ([VI](dev_env.md)); ghi chú build Tauri/Android nằm trong [`webapp/TAURI.md`](../../../webapp/TAURI.md). Bản ngắn gọn:
|
||||
|
||||
**Pipeline Python** (Python 3.15, xem `.github/python-version`):
|
||||
@@ -126,12 +137,12 @@ npm run tauri:build # trình cài đặt trong src-tauri/target/release/bundle/
|
||||
- **Test cục bộ**: chạy các bước kiểm tra ở mục 8 trước khi push; CI chạy đúng những bước đó.
|
||||
- **Giữ sạch**: chỉ game itch.io miễn phí, không trả phí/demo/malware/trùng lặp.
|
||||
- **Kiên nhẫn**: tôi hướng nội + lười, trả lời có thể chậm.
|
||||
- **Đồng ý**: mọi issue template đều có một checkbox bắt buộc. Lạc đề/spam/vi phạm chính sách sẽ bị bỏ qua/đóng không drama :D
|
||||
- **Đồng ý**: mọi issue template đều có một checkbox bắt buộc. Lạc đề/spam/vi phạm chính sách, và mọi thứ nằm ngoài phạm vi bảo trì ở trên, sẽ bị bỏ qua/đóng không drama :D
|
||||
- **Cư xử đẹp**: mọi thứ ở đây đều theo [Quy tắc ứng xử](CODE_OF_CONDUCT.md).
|
||||
|
||||
## Muốn thảo luận thêm? (Nếu template không đủ)
|
||||
|
||||
Issue/PR là tốt nhất để theo dõi, nhưng nếu bạn muốn mô tả bug/tính năng kỹ hơn, tán gẫu, hoặc kể chuyện noob, giờ đã có server thật (introvert god-mode bị xuyên thủng):
|
||||
Issue là tốt nhất để theo dõi vấn đề dữ liệu, nhưng nếu bạn muốn tán gẫu, hỏi gì đó, hoặc kể chuyện noob, giờ đã có [GitHub Discussions](https://github.com/poli0981/free-games-itchio-list/discussions) và server thật (introvert god-mode bị xuyên thủng):
|
||||
|
||||
**Chat / cộng đồng**
|
||||
- Discord: Repo discussion (#general): https://discord.gg/2aNR3aVt
|
||||
|
||||
@@ -4,7 +4,7 @@ Cập nhật lần cuối: 2026-10-16
|
||||
|
||||
Áp dụng từ: khi phát hành phiên bản 4.0.0.
|
||||
|
||||
> Bản dịch từ bản tiếng Anh cập nhật ngày 2026-10-13 (English source revision 2026-10-13). Nếu có khác biệt, bản tiếng Anh được ưu tiên. Bản gốc: [`docs/DISCLAIMER.md`](../../DISCLAIMER.md).
|
||||
> Bản dịch từ bản tiếng Anh cập nhật ngày 2026-10-16 (English source revision 2026-10-16). Nếu có khác biệt, bản tiếng Anh được ưu tiên. Bản gốc: [`docs/DISCLAIMER.md`](../../DISCLAIMER.md).
|
||||
|
||||
Dự án này — repository `free-games-itchio-list` và website **[freeitchgames.win](https://freeitchgames.win)** — là một dự án sở thích: một danh mục được tuyển chọn và tự động cập nhật gồm các game miễn phí trên [itch.io](https://itch.io). Dự án do một dev người Việt đang thất nghiệp, poli0981 (SkullMute), vận hành — dưới đây gọi là "Người duy trì" — với các trợ lý AI gánh phần lớn việc nặng. Làm ra vì vibes, để khám phá game indie và giải khuây. Không hứa hẹn gì lớn lao — nhưng các điều khoản mang tính pháp lý dưới đây là thật.
|
||||
|
||||
|
||||
@@ -4,7 +4,7 @@ Cập nhật lần cuối: 2026-10-16
|
||||
|
||||
Áp dụng từ: khi phát hành phiên bản 4.2.0.
|
||||
|
||||
Bản dịch từ bản tiếng Anh cập nhật ngày 2026-10-03 (English source revision 2026-10-03). Nếu có khác biệt, bản tiếng Anh được ưu tiên.
|
||||
Bản dịch từ bản tiếng Anh cập nhật ngày 2026-10-16 (English source revision 2026-10-16). Nếu có khác biệt, bản tiếng Anh được ưu tiên.
|
||||
|
||||
> Bản tiếng Anh: [`docs/EULA.md`](../../EULA.md).
|
||||
|
||||
|
||||
@@ -4,7 +4,7 @@ Cập nhật lần cuối: 2026-10-16
|
||||
|
||||
Áp dụng từ: ngày 2026-10-13 đối với Website, và từ phiên bản 4.4.0 đối với các Ứng dụng.
|
||||
|
||||
> Bản dịch từ bản tiếng Anh cập nhật ngày 2026-10-13 (English source revision 2026-10-13). Nếu có khác biệt, bản tiếng Anh được ưu tiên. Bản gốc: [`docs/PrivacyPolicy.md`](../../PrivacyPolicy.md).
|
||||
> Bản dịch từ bản tiếng Anh cập nhật ngày 2026-10-16 (English source revision 2026-10-16). Nếu có khác biệt, bản tiếng Anh được ưu tiên. Bản gốc: [`docs/PrivacyPolicy.md`](../../PrivacyPolicy.md).
|
||||
|
||||
Chính sách quyền riêng tư này giải thích dự án `free-games-itchio-list` xử lý những dữ liệu cá nhân nào, vì sao, ai hỗ trợ xử lý, dữ liệu được lưu trong bao lâu và bạn có những quyền gì. Chính sách áp dụng cho website **https://freeitchgames.win**, các ứng dụng desktop và Android, dữ liệu danh mục công khai và repository. Nói ngắn gọn: không có tài khoản, không quảng cáo, không cookie theo dõi. Dự án giữ ít dữ liệu nhất có thể, và phần lớn những gì tồn tại chỉ nằm trong trình duyệt của chính bạn.
|
||||
|
||||
|
||||
@@ -1,10 +1,10 @@
|
||||
# Chính sách bảo mật (Security Policy)
|
||||
|
||||
Cập nhật lần cuối: 2026-10-16
|
||||
Cập nhật lần cuối: 2026-11-11
|
||||
|
||||
Áp dụng từ: khi phát hành phiên bản 4.0.0.
|
||||
|
||||
> Bản dịch từ bản tiếng Anh cập nhật ngày 2026-09-18 (English source revision 2026-09-18). Nếu có khác biệt, bản tiếng Anh được ưu tiên. Bản gốc: [`SECURITY.md`](../../../SECURITY.md).
|
||||
> Bản dịch từ bản tiếng Anh cập nhật ngày 2026-10-27 (English source revision 2026-10-27). Nếu có khác biệt, bản tiếng Anh được ưu tiên. Bản gốc: [`SECURITY.md`](../../../SECURITY.md).
|
||||
|
||||
Chào bạn — đây là một dự án sở thích do một người vận hành, poli0981 (SkullMute), dưới đây gọi là "Người duy trì": một danh mục được tuyển chọn gồm các game itch.io miễn phí. Từ v4, dự án gồm một **website chỉ đọc** tại https://freeitchgames.win (chạy trên một Cloudflare Worker), một **pipeline dữ liệu Python** trên GitHub Actions, và các **ứng dụng desktop và Android chỉ đọc**. Không có tài khoản công khai, không đăng nhập và không thanh toán; lần đăng nhập duy nhất là trang quản trị riêng của Người duy trì, được bảo vệ bởi Cloudflare Access. Bề mặt tấn công nhỏ — nhưng nếu bạn tìm thấy lỗ hổng, Người duy trì thực sự muốn được biết.
|
||||
|
||||
@@ -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.
|
||||
|
||||
Từ phiên bản 4.6.1, dự án ở **chế độ bảo trì**: không có tính năng mới, nhưng việc vá bảo mật và cập nhật runtime, thư viện phụ thuộc vẫn tiếp tục như mô tả ở đây.
|
||||
|
||||
## 4. Những gì bạn có thể mong đợi
|
||||
|
||||
- **Xác nhận đã nhận báo cáo**: mục tiêu trong vòng **7 ngày**. Đây là dự án sở thích do một người làm, nên đó là mục tiêu chứ không phải cam kết, và thường sẽ sớm hơn nhiều.
|
||||
@@ -78,7 +80,7 @@ Những gì repository thực sự làm:
|
||||
- **Dependabot** ([`.github/dependabot.yml`](../../../.github/dependabot.yml)) được cấu hình để giữ các dependency npm, pip, GitHub Actions và cargo luôn được cập nhật.
|
||||
- Mọi **GitHub Action của bên thứ ba đều được ghim theo commit SHA đầy đủ**, và mỗi workflow khai báo `permissions` ở mức tối thiểu cần thiết.
|
||||
- Các thao tác ghi vào repository từ trang quản trị của website đều đi qua một **GitHub App** (commit được xác minh), và trang quản trị nằm sau Cloudflare Access (đăng nhập GitHub hoặc mã PIN dùng một lần qua email) và chỉ dành cho Người duy trì.
|
||||
- Form Suggest được bảo vệ bằng Cloudflare Turnstile và giới hạn tốc độ.
|
||||
- Website giới hạn số request mà một địa chỉ có thể gửi trong thời gian ngắn (một quy tắc WAF của Cloudflare, rồi các giới hạn theo từng loại đường dẫn trong Worker, trả về HTTP 429), và form Suggest còn có thêm Cloudflare Turnstile cùng một giới hạn chặt hơn của riêng nó.
|
||||
- File APK Android được ký bằng khóa của dự án. Chỉ cài APK, cũng như các ứng dụng desktop, từ trang [GitHub Releases](https://github.com/poli0981/free-games-itchio-list/releases) của dự án.
|
||||
|
||||
Nếu một lỗ hổng đã biết trong dependency thực sự ảnh hưởng tới một thành phần đang chạy (website, Worker, pipeline hoặc các ứng dụng), hãy báo cáo riêng tư như ở [§1](#1-báo-cáo-lỗ-hổng). Nếu đó chỉ là một dependency lỗi thời, không có tác động thực tế, thì mở issue hoặc pull request thông thường là được.
|
||||
|
||||
+1
-1
@@ -4,7 +4,7 @@ Cập nhật lần cuối: 2026-10-16
|
||||
|
||||
Áp dụng từ: ngày 2026-10-13 đối với Website, và từ phiên bản 4.4.0 đối với các Ứng dụng.
|
||||
|
||||
Bản dịch từ bản tiếng Anh cập nhật ngày 2026-10-13 (English source revision 2026-10-13). Nếu có khác biệt, bản tiếng Anh được ưu tiên.
|
||||
Bản dịch từ bản tiếng Anh cập nhật ngày 2026-10-16 (English source revision 2026-10-16). Nếu có khác biệt, bản tiếng Anh được ưu tiên.
|
||||
|
||||
Bản tiếng Anh: [`docs/ToS.md`](../../ToS.md).
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# Môi trường phát triển
|
||||
|
||||
> Bản dịch từ bản tiếng Anh cập nhật ngày 2026-09-24 (English source revision 2026-09-24). Nếu có khác biệt, bản tiếng Anh được ưu tiên.
|
||||
> Bản dịch từ bản tiếng Anh cập nhật ngày 2026-11-11 (English source revision 2026-11-11). Nếu có khác biệt, bản tiếng Anh được ưu tiên.
|
||||
> Bản gốc: [`dev_env.md`](../../dev_env.md).
|
||||
|
||||
Bộ công cụ Maintainer dùng để viết và kiểm thử code trong repo này, và cách chạy từng phần trên máy.
|
||||
@@ -174,6 +174,7 @@ các việc bảo trì queue. Hãy dùng hạn chế.
|
||||
|
||||
```sh
|
||||
cd webapp
|
||||
npm run check:tauri # crate Tauri và package npm tương ứng cùng major.minor
|
||||
npm run cf:types -- --check # worker-configuration.d.ts khớp với wrangler.jsonc
|
||||
npm run lint # ESLint
|
||||
npm run knip # file / export / dependency không dùng
|
||||
@@ -186,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
|
||||
SonarQube Cloud (`sonarcloud.yml`).
|
||||
|
||||
Qodana (JetBrains) cũng phân tích code trong CI (`qodana.yml`: TypeScript / JavaScript, Python và
|
||||
Rust, mỗi phần có `qodana.yaml` riêng). Nó cần token của project nên không có lệnh chạy cục bộ ở đây;
|
||||
các inspection tương tự có sẵn trong WebStorm, PyCharm và RustRover.
|
||||
|
||||
Sau khi sửa `wrangler.jsonc`, chạy `npm run cf:types` và commit file `worker-configuration.d.ts` vừa
|
||||
được tạo lại.
|
||||
|
||||
|
||||
+84
-6
@@ -15,6 +15,7 @@ secret: secrets are only ever typed into Cloudflare (`wrangler secret put`) or a
|
||||
| Access app "Admin" | Cloudflare Zero Trust | Login for `/admin` + `/api/admin/*`. |
|
||||
| Turnstile widget | Cloudflare Turnstile | The verification gate in front of the web app (action `gate`) and anti-spam on `/suggest` (action `suggest`). |
|
||||
| Transform Rule "Verified bots skip the gate" | Cloudflare → Rules → Transform Rules | Adds `x-fig-known-bot: <GATE_BOT_TOKEN>` to requests from Cloudflare-verified bots, so search engines and link previews skip the gate (section 1, step 14). |
|
||||
| Rate limits | WAF rule (Security → WAF → Rate limiting rules) + the Worker's `ratelimits` bindings | Two layers of per-IP limits: the WAF rule stops floods before they run (and bill) the Worker; the Worker answers what still gets through with 429 per kind of traffic (section 1, step 15). |
|
||||
| GitHub App | GitHub → Settings → Developer settings | The Worker's identity for commits (queue approvals, edits, removals). |
|
||||
| GitHub Actions | [`.github/workflows/`](../.github/workflows) | Data pipeline (`refresh.yml`, `update.yml`, `force_update.yml`), CI, releases, build monitor. |
|
||||
| Staging Worker `free-games-itchio-list-staging` | `staging.freeitchgames.win` (whole host behind Access) | Optional pre-release checks, deployed by hand from any branch with `npx wrangler deploy --env staging` (`wrangler.jsonc` → `env.staging`). |
|
||||
@@ -81,8 +82,8 @@ Do these once (and again with the `-staging` names for the staging Worker).
|
||||
DMARC for poli0981.dev live in that zone's Cloudflare DNS). freeitchgames.win needs no mail setup.
|
||||
12. **Zone settings**: SSL/TLS Full (strict), Always Use HTTPS, minimum TLS 1.2, TLS 1.3 on; Smart
|
||||
Tiered Cache; Browser Cache TTL "Respect existing headers"; Rocket Loader and Email Obfuscation
|
||||
**off** (they rewrite HTML and break the CSP); WAF managed rules on; one rate-limiting rule for
|
||||
`/api/*`; Bot Fight Mode **off** (it can't be skipped for the apps; the
|
||||
**off** (they rewrite HTML and break the CSP); WAF managed rules on; the rate-limiting rule of
|
||||
step 15; Bot Fight Mode **off** (it can't be skipped for the apps; the
|
||||
verification gate covers the web app instead). Keep HSTS
|
||||
`preload` only if every subdomain (including `staging`) will always be HTTPS.
|
||||
- Measured 2026-10-03: TLS 1.0/1.1 are refused, TLS 1.3 and HTTP/3 answer, `http://` redirects
|
||||
@@ -136,6 +137,60 @@ Do these once (and again with the `-staging` names for the staging Worker).
|
||||
`SITE_ORIGIN=http://localhost:8787` and a 32+ character `GATE_SECRET` in `webapp/.dev.vars`, then
|
||||
`npm run build && npx wrangler dev` (on localhost the cookie is `fig_gate`, without `Secure`, and
|
||||
no bot token is needed).
|
||||
15. **Rate limits** — two layers, both per client IP (an IPv6 client by its /64 in the Worker).
|
||||
- **Layer 1, the zone's WAF rule** (Security → WAF → **Rate limiting rules**). It runs before the
|
||||
Worker, so a request it blocks costs no Worker request, it is the only limit on static files, and
|
||||
it counts across the whole data centre — the only limit a flood of new connections can't spread
|
||||
out of (see layer 2).
|
||||
On the Free plan there is **one** rule, counted by IP over **10 seconds**, with a 10-second block;
|
||||
if a rule already exists (the old one for `/api/*`), edit it rather than adding one. Settings:
|
||||
- Rule name `Flood guard`. *If incoming requests match* → *Edit expression*:
|
||||
```
|
||||
(not cf.client.bot and not starts_with(http.request.uri.path, "/assets/") and not starts_with(http.request.uri.path, "/data/pack/"))
|
||||
```
|
||||
(In the builder: *Verified Bot* equals off, *URI Path* does not start with `/assets/`, *URI
|
||||
Path* does not start with `/data/pack/`, joined with And. If the editor refuses
|
||||
`starts_with`, use `not http.request.uri.path wildcard r"/assets/*"` and the same for
|
||||
`/data/pack/*`.) Bundles and packs stay out: they are free static assets with a long cache, and
|
||||
a first visit loads a few dozen of them at once. Verified bots stay out like at the gate.
|
||||
- *With the same characteristics*: IP. *When rate exceeds*: **300 requests** per **10 seconds**
|
||||
(30 a second; a person scrolling the Games list fast loads about 100 covers in that time).
|
||||
*Then take action*: **Block**, default response (429, Cloudflare's "error 1015" page), for
|
||||
10 seconds. Deploy.
|
||||
- Lower it once Security → Events shows what real traffic looks like; don't go below ~150 per
|
||||
10 s (a Games page asks for up to 100 covers).
|
||||
- **Layer 2, the Worker** ([`webapp/worker/ratelimit.ts`](../webapp/worker/ratelimit.ts),
|
||||
`ratelimits` in `wrangler.jsonc`, deployed with every build — nothing to set up). Every request
|
||||
that runs the Worker counts, per 60 s and per Cloudflare location: `RL_SITE` 120 (app pages, the
|
||||
public `/api`, the readable `/data` JSON, misses), `RL_IMG` 600 (`/img` covers), `RL_ADMIN` 300
|
||||
(`/admin` + `/api/admin`); on top, `RL_SUGGEST` 5 (Suggest POSTs) and `RL_GATE` 20 (verification
|
||||
POSTs). Over a limit: 429 + `Retry-After: 60` — JSON `{"error":"rate_limited"}` for the API,
|
||||
covers and files (with CORS on `/data`), a small "Too many requests" page (EN/VI, no script) for
|
||||
app pages. Verified bots (the gate's header) are never counted. **These counts are loose**:
|
||||
each machine of a data centre counts on its own and syncs late, so they hold for a client that
|
||||
keeps one connection (browsers use one HTTP/2 connection, scripts with keep-alive) but hardly
|
||||
for one that opens a new connection per request — measured after the 4.5.0 deploy, 1,000 such
|
||||
requests in a minute got no 429. That is the WAF rule's job. Change a limit in
|
||||
`wrangler.jsonc` (then `npm run cf:types`); keep `period` 60 and a new `namespace_id` per binding in
|
||||
88xx (staging 89xx) — the ids are account-wide, and the account's other Workers use the low numbers.
|
||||
The counts are approximate and fail open (a missing binding or a limiter error lets requests
|
||||
through).
|
||||
- **Test** after a change (it blocks your own IP for up to a minute). The Worker's limits, over
|
||||
**one** connection (a single `curl` with many URLs reuses it):
|
||||
```sh
|
||||
curl -s -o /dev/null -w "%{http_code}\n" $(printf 'https://freeitchgames.win/api/health %.0s' $(seq 200)) | sort | uniq -c
|
||||
curl -s https://freeitchgames.win/api/health # {"error":"rate_limited"} → the Worker; "error code: 1015" → the WAF rule
|
||||
```
|
||||
About 120 answer 200 and the rest 429 (fewer pass if you sent requests in the last minute). The
|
||||
WAF rule needs more than 300 requests within 10 s — faster than `xargs curl` gets from a home
|
||||
connection (~20 a second). Node's `fetch` keeps a pool of connections and does it:
|
||||
```sh
|
||||
node -e "let n=0,t={};const go=async()=>{while(n++<800){const r=await fetch('https://freeitchgames.win/api/health');const b=await r.text();const k=r.status==200?'200':b.includes('1015')?'WAF 1015':b.includes('rate_limited')?'Worker 429':r.status;t[k]=(t[k]||0)+1}};Promise.all(Array.from({length:100},go)).then(()=>console.log(t))"
|
||||
```
|
||||
Measured on 2026-10-27 with the rule above: 800 requests in 4.9 s → 111 × 200, 201 × Worker 429,
|
||||
488 × WAF 1015 (from 1.4 s on), and the site answered normally again 10 s later. Security →
|
||||
Events lists the WAF blocks; Worker 429s show up in Workers Logs (sampled,
|
||||
`head_sampling_rate` 0.1).
|
||||
|
||||
## 2. GitHub
|
||||
|
||||
@@ -151,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
|
||||
more, were deleted on 2026-10-16.
|
||||
4. **Signing key**: the old key `03F965C2E2DB5C6B` was exposed; sign with the replacement key.
|
||||
5. **Qodana** (JetBrains, <https://qodana.cloud>): one Qodana Cloud project per linter, because a
|
||||
project takes one linter — `itch-typescript` (`qodana-js`), `itch-python` (`qodana-python`) and
|
||||
`itch-rust` (`qodana-rust`, Early Access). Each project token is a repository secret:
|
||||
`QODANA_TOKEN_TS_JS`, `QODANA_TOKEN_PYTHON`, `QODANA_TOKEN_RUST` (Settings → Secrets and variables →
|
||||
Actions). `qodana.yml` runs the three jobs; the settings are `webapp/qodana.yaml`, `qodana.yaml`
|
||||
and `webapp/src-tauri/qodana.yaml` (each with a quality gate of 0 problems: a finding fails its
|
||||
job — fix it, or switch the inspection off there with the reason). The three linters need an **Ultimate** licence: when the
|
||||
trial or the subscription ends, the scans fail with a licence error — renew it, or delete
|
||||
`qodana.yml` and the three files (nothing else depends on them). A new token: Qodana Cloud →
|
||||
the project → Settings, then update the secret.
|
||||
|
||||
## 3. Releasing a version
|
||||
|
||||
@@ -159,18 +224,27 @@ Do these once (and again with the `-staging` names for the staging Worker).
|
||||
`webapp/src-tauri/tauri.conf.json`, `webapp/src-tauri/Cargo.toml` + `Cargo.lock`, and the version
|
||||
badges of `README.md` / `README.vi.md`. Write the notes in
|
||||
`changelog/<major>.x/ver<major>.<minor>.x.md` and add the row to [`CHANGELOG.md`](../CHANGELOG.md).
|
||||
2. Open a PR; when CI is green, merge it with squash or a merge commit — never fast-forward. A push
|
||||
2. Run the accessibility smoke test ([`ACCESSIBILITY.md`](../ACCESSIBILITY.md) §4) on the preview or the
|
||||
merged site: the main tasks with the keyboard only, a screen reader spot check (Narrator, NVDA or
|
||||
VoiceOver), 200 % zoom and a narrow window, reduced motion, and a Windows contrast theme. If a
|
||||
change made a known limitation go away (or added one), update §6 of the statement and its
|
||||
Vietnamese mirror.
|
||||
3. Open a PR; when CI is green, merge it with squash or a merge commit — never fast-forward. A push
|
||||
that touches the changelog posts to Discussions → General unless the head commit says
|
||||
`[skip-discuss]` (the release announcement usually covers it).
|
||||
3. Apply any new D1 migration and set any new secret **before** the merge deploys code that needs them.
|
||||
4. Tag from `main`: `git fetch origin && git tag -s vX.Y.Z origin/main -m "…"`, then
|
||||
4. Apply any new D1 migration and set any new secret **before** the merge deploys code that needs them.
|
||||
5. Tag from `main`: `git fetch origin && git tag -s vX.Y.Z origin/main -m "…"`, then
|
||||
`git push origin vX.Y.Z`. `release_desktop.yml` opens one draft release and the desktop and Android
|
||||
jobs upload into it (12 assets for 4.x). Never create the release by hand first.
|
||||
5. When every asset is there, edit the title and notes (from the changelog), then
|
||||
6. When every asset is there, edit the title and notes (from the changelog), then
|
||||
`gh release edit vX.Y.Z --draft=false` — that fires the Discord and Discussions announcements.
|
||||
|
||||
## 4. Routine
|
||||
|
||||
- **Maintenance mode** (since 4.6.1): the project is stable. The work left is the weekly dependency
|
||||
sweep, security fixes, runtime updates and the items below; feature requests and code pull
|
||||
requests are closed with a pointer to README → Project status. Issues stay open for the data
|
||||
only (add, fix, remove a game), accessibility barriers and things that broke.
|
||||
- **Mass-change alert** (Discord, "mass_change=true"): itch.io probably changed its page markup. Look at
|
||||
a few flagged games on itch.io. If the parser is wrong, fix `scripts/scraper.py`; if the removals
|
||||
are real, dispatch **Refresh catalog** with `allow_mass_removal`.
|
||||
@@ -210,6 +284,10 @@ Do these once (and again with the `-staging` names for the staging Worker).
|
||||
```
|
||||
`npx wrangler tail` shows the `legacy-data: 410` lines with the requesting `Origin`: an installed
|
||||
app that sends an unexpected one would show up there.
|
||||
- **Visitors report "Too many requests" / error 1015**: "error 1015" is the WAF rule (section 1,
|
||||
step 15) — raise its threshold in the dashboard, effective within a minute. The site's own "Too many
|
||||
requests" page or `{"error":"rate_limited"}` is the Worker: raise the limit in `wrangler.jsonc` and
|
||||
deploy. Both reset by themselves (10 s / 60 s).
|
||||
- **Verification gate misbehaving** (visitors stuck on the check, crawl errors in Search Console):
|
||||
`npx wrangler secret delete GATE_SECRET` turns it off at once; then look at `npx wrangler tail` and
|
||||
`curl -s https://freeitchgames.win/api/verify`.
|
||||
+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
|
||||
+145
-145
@@ -198,126 +198,126 @@ colorama==0.4.6 \
|
||||
# via
|
||||
# -r requirements-dev.in
|
||||
# pytest
|
||||
coverage==7.17.0 \
|
||||
--hash=sha256:032d4c2db4c677eb71d43f2f8b80bf64e9346f7a3f7b6ebb13f1782f3cc6c274 \
|
||||
--hash=sha256:03baf0688e14a5a44ffd1eefa8928dfc92b14565e521174e072b31b971aa1657 \
|
||||
--hash=sha256:045c1eeb19fb4eae949850a761102fffb3a5f638b97f977912f95843e54f6669 \
|
||||
--hash=sha256:09e563b49c81cd0a33734e926d7a4a6ef1778d74304cde2dcc3aff8b30ea1036 \
|
||||
--hash=sha256:0a9cb9a0fb58e6fff5442969af36094ecd6976f4907f179e33b27e15355d8f74 \
|
||||
--hash=sha256:0b8bb651a4406fb6a983a905309fec1783443c65e1771b41e92740a0f4a1176b \
|
||||
--hash=sha256:0cfdc938ca3319d873d1f1252e60620a39aee4ebf9dbd7cc58238109ebda9c51 \
|
||||
--hash=sha256:0d0fac604a962ff546beb038cba9a5a09d88e6e3f01612fb46f7bd4fe5dc8dca \
|
||||
--hash=sha256:0edeb6594f080c8de1263cccb239cb316ef77aeb959e2e0f38f2953fcc72a49e \
|
||||
--hash=sha256:11f5f7fb2d97a0fe865f5e7bad4eb0619b957637f676bc088d13844adf26ba95 \
|
||||
--hash=sha256:12961f738d717a046d4bf3f8d1727eb3ebe2ed5478ff96cd6233d4dfc39323d3 \
|
||||
--hash=sha256:12cb8a20ad904a5811e6660d829a586b216e5254b9b34b76dde8a4d65d827dc6 \
|
||||
--hash=sha256:194562ab1eff0d85aee8a17ce4c5c0bc1ebf70a629a7145257123156ad100fd6 \
|
||||
--hash=sha256:1cabb31531002fef5197de5df3c84730aef01e750e25154b9813a2583435aba2 \
|
||||
--hash=sha256:1ee0a982b0e1230b3edf768a7dd022bd2377303763895327ac62deb5efacee03 \
|
||||
--hash=sha256:2bf3ee38a40c0570c316b9e7507c472469586906a20f289705898528c31aaea8 \
|
||||
--hash=sha256:2c680e838ff9e68d491158625ca2c1ddb17d78d791bba96a31f8b839b4990438 \
|
||||
--hash=sha256:2dc9233f39149b5a4f4aba17a4b6bc5cca22e52cfc4b06fdb07d014439b8b2ea \
|
||||
--hash=sha256:2ed3097c6817bc1a7fc8ae0a6131db74aa1150d863cccc308237ff362d3226b2 \
|
||||
--hash=sha256:3067608b4429629f640c1b23d2f69b05d2fd45e00ebb6ee9e8fad220a6c11722 \
|
||||
--hash=sha256:30f5477aac9c9e4a0a641c55f8f8fddd7f3bd91176c912c50f40ffced96b4034 \
|
||||
--hash=sha256:337f87e62e1c5f43c8198d879f677c342d152f84d3f157add12558853cbb8eaf \
|
||||
--hash=sha256:3393209f6894713161ee82a9b0e673e58237e0f9733c6638e7a6c0c620ef0b33 \
|
||||
--hash=sha256:34d65c9e8e257f48a654908005046fbf1bc48d9540ae3776ad08c0acd010e10c \
|
||||
--hash=sha256:38c86e5d74bbfd88a393fa3f91257c1225c63aa6db6d5918de3e49ab04f91c6e \
|
||||
--hash=sha256:3a4459b0f389dd1e51aac3dbfc4ca35b30cae7dc99caa3c0a086d1997a985709 \
|
||||
--hash=sha256:42e6f170d1ac04b7eb3363310a6c41cdfd82c1fe6bf9ffbc4a86f380bdf091c7 \
|
||||
--hash=sha256:4343a9378b964eb3cb80fa90406385de91c7e982a769ca9314d848f93bc0d3f2 \
|
||||
--hash=sha256:460679f53893081edb94eeed011d26be37228ba649b853fd2aed7e4394fb1f35 \
|
||||
--hash=sha256:4e153f0bd6509dbf837fd585f489b3328bfd98f2a718a0b15ae63032148b285c \
|
||||
--hash=sha256:50678474e714c684b82c108e63fbb8f1bcf1266d8293a49980f1d08526f093b5 \
|
||||
--hash=sha256:55939ea4c097fda2edabf80fac5e49bef15597b950a9f29fc56292a895245feb \
|
||||
--hash=sha256:559f748446ee799803686b5784e3deb54c70d655ac386a860e06b11672504ba7 \
|
||||
--hash=sha256:58a304efdf2253fb2ea03d45d0a04cc174a92a0cd5279c28c5bb893ce7410968 \
|
||||
--hash=sha256:5900055351ec89fdffb34b27898815106529ded29a9496464c1ebd6313fd40fa \
|
||||
--hash=sha256:5b7fa0997b8eba7378ac66f31ec7f70164490353ab79b9667d37c0d365e50177 \
|
||||
--hash=sha256:5cc15faaf318ee5040d835a62c75bc6f122d837274f3b5efd47bf9fbd4ac5b85 \
|
||||
--hash=sha256:5ebfbc87836529a31d25c2dec1262c38eea852ec1c46c0f690a515a7339d9c5b \
|
||||
--hash=sha256:5ee9c8bd13a59e301dc2aefe7aa8384633406808de051b1982775667094eb673 \
|
||||
--hash=sha256:600e121e412cd6bdb52ec105b95c6a04da0c9710d1534f6e64a42db667907802 \
|
||||
--hash=sha256:6052e878b628abcd38fa5f2b64abebc686eed4e2267da42434017a9c6d24f241 \
|
||||
--hash=sha256:61cde5222f1933d476647c5a25ed1a8678b7703098cb5a15f4a0aa39967d8c28 \
|
||||
--hash=sha256:62bb77987d3f72a0aaa77c567ee7f9806bc2e748c8f46fafbe1fdb90dd148398 \
|
||||
--hash=sha256:66efc0fb99cee34626fc17d3adac9c3cd816bfdad563bb1e983c3ef432f566d4 \
|
||||
--hash=sha256:6a80a11b90c4a03df1502304cf24ff953255b6b5d076ef79066ecf88baaff31f \
|
||||
--hash=sha256:6abfb6a4cf1cb1b67bc8fccdde177e2d2b781d0d34449e7078156547025140e5 \
|
||||
--hash=sha256:6ae0453a3390e67f7bfbe34417bbdf5b4ebfc21db23fb446a0a41115eeeca6ca \
|
||||
--hash=sha256:6b4593d2871c4c801656dd5861e759f8f5156febd6b6061b02f6a72d64618b7b \
|
||||
--hash=sha256:6cc31f27240d4e080437e3b8229d92f1d809c9a4f233607385373b73974e183e \
|
||||
--hash=sha256:6e09612b1b82c9df1d2b6c85dee88d5aad3e73d77a8ec0b16ac6a7322cbdf5d9 \
|
||||
--hash=sha256:72edd4f9483ae30cd1ba4f230687840ef7b58a16afb1c9e81131fd6d64655f36 \
|
||||
--hash=sha256:791f9ee09814dd30d9562b4f4eb037a371485ec1c830b53999d2320d20c4e764 \
|
||||
--hash=sha256:79cf71e5f9a48877ccfed5baa2c72f45af4feeaa596249e23eb15b473134830e \
|
||||
--hash=sha256:7b5abcae74750302ac4bc77351eaee87c450e4abd3b6225eacde3858e260f8b2 \
|
||||
--hash=sha256:7c570293f001ea91598b90e90cb9b98fddee833e90bbede432cbd218331ccd8e \
|
||||
--hash=sha256:7d6d9d396c8b7bcaf76d774a10140b218111484e54c73a5f2a1b75655381748e \
|
||||
--hash=sha256:7fef12cec4b96f59e09761cbd4fc9bdf4788062d1ae435b920241fc16c8a9549 \
|
||||
--hash=sha256:804fbaf81d09b34e2f8b1159d01e211a50713d743d32fd9b2ca6cf0ae507a66f \
|
||||
--hash=sha256:84538c040f4e6214f663459d89372ce4e6b2bbdd9d397ef0dca7b3ecd56b8eb2 \
|
||||
--hash=sha256:85682ca89bc4601125dcdff23fa70e6274e13c9ad502fba845e6c274ab2c6569 \
|
||||
--hash=sha256:85932227e9dd38e62cd29c17fefdfecfb919eead6af1e3259522d03cf85de983 \
|
||||
--hash=sha256:88a1a9fb0075b83389dd9b403bb3fce976031b3c2aa0e05e3e57143cf639de69 \
|
||||
--hash=sha256:8d823d66afd59566030539c49c7a6acaf3083996682be2dda760c63555842094 \
|
||||
--hash=sha256:8e8113d3852e9377421a61de1917df27b3abb25404a4ecf69f9e64612c4345b5 \
|
||||
--hash=sha256:912a29f338798541d795e2e25903c6fe7a99dee70a40fe4706a9a124649b523e \
|
||||
--hash=sha256:91e487ad07c511da77b574820141a7c2da09bc2a4b4090b5be2424295d100697 \
|
||||
--hash=sha256:96151262832f3c230ebae23b2d6911ad549e1738465946c97004913ff06112ba \
|
||||
--hash=sha256:968c5fb6e0c83cab752d79a70209648ce4d90cae815c60fa229b59e264601062 \
|
||||
--hash=sha256:99a7b390cbccc6bf029ca4da3f0f607c218bb4085e9cd6b58a90d14ca12993c3 \
|
||||
--hash=sha256:9a66074231799d8884d267234d49f60c90b43a945dfe069646b72f3058cd4e67 \
|
||||
--hash=sha256:9c083e253e96fdeeaf48133fe836cac86ace2db215d235700e7f7532420a200c \
|
||||
--hash=sha256:9d1fdf82c6fea57b5e9dada509f9ce9638c8334664e2c98c7f6f1ccf3d143ad2 \
|
||||
--hash=sha256:a01ef92caeedfa4f2ad171a3a8e6fece4565de871d8bca428151bf9929f41048 \
|
||||
--hash=sha256:a14e8d69464da9cbe1dc29e7116dbd37296d1d51a695327c478e250349085089 \
|
||||
--hash=sha256:a1762e85cbbe3b5ff9c6dcbcc1b89d5c72320094292b7b9572bf882c85e428b7 \
|
||||
--hash=sha256:a25cc5e8c23a590815c6a7aa43624234d25cb23b21b484adb8a0daed59860db5 \
|
||||
--hash=sha256:a32ee5831b15ba239bef5d272ae586ca8acea4a661b5f2941f5a0d380e518b23 \
|
||||
--hash=sha256:a3914e2c98c34b94c26d2add3d2a61ccfd3534fc4eaa879ee290bdbb5184ba6c \
|
||||
--hash=sha256:a59c3b470ac3b2432af3598a996affbeb10236cd899a005c1c4e517fcff8b592 \
|
||||
--hash=sha256:a5e2e0625dfc789af0b2e10acfc106b352f314fffbd19e6392a7961c8cbe5d9a \
|
||||
--hash=sha256:acdb5f3c96046efff9dc6c572a6acb2b8d0da09372d7b9a9ed7249cf7d17434f \
|
||||
--hash=sha256:adabc1079ba844b096799ba8638d8df434aca1613f95bb7d5791af320cf05559 \
|
||||
--hash=sha256:adbf3450c0f3f2b2854e282a8758f2b3eddf787eeff24ec9c9bc2cbc38328cc1 \
|
||||
--hash=sha256:aed06129a9f530a948928260d7d2d81c47261355b0127e3c782251b38958463c \
|
||||
--hash=sha256:b2afebb96da9a1bbca142f8cc12320c14e5c215e0a49cded4f191f5a31506a28 \
|
||||
--hash=sha256:b609df3d6d900464207532c5170a65c6ede8d2e0b91f151f90008a866395cd76 \
|
||||
--hash=sha256:b88fb4d4d7608cbcebdc7ff7dbffc2115e3b81d6c33a79147cd79d54fcb080f4 \
|
||||
--hash=sha256:bac487dce0d2aff28ddf1a533a916f771416eee0e493960f611e49037b878e9d \
|
||||
--hash=sha256:bb5ca66937c55bc85d1a5e9c5900a3e4693a8edf2280a9b3672b7b2661a84b95 \
|
||||
--hash=sha256:bd04fd23206be9ad3de13b0b39313094fafa66a1f6baf70f5471c004a9fac47d \
|
||||
--hash=sha256:bd3e9eb493631ff1ca34bf5efac25b5c66724f837bf6182c4fc771c55946423d \
|
||||
--hash=sha256:bfb6f868af552c0ceb2d19220b8cbcc2be096ca26163ac30e682a13041433429 \
|
||||
--hash=sha256:c2c48a36bb970b7265b196032bfd4237c0b373f2b25ef7012d7e905b5b35c19c \
|
||||
--hash=sha256:c3e11b81faafb1f063248735c3e2c5c4183fc1db2c7f46782170dd7760dffcbc \
|
||||
--hash=sha256:c7c5672ecf1b497de7a0b37743bef40e3b58e3207e9fe2ed6682cb0420836a88 \
|
||||
--hash=sha256:c86a39539d10d666bb819c16c94d7edfc1aa2e0531b937f7c549b83d15177c6e \
|
||||
--hash=sha256:c8a58baa8eb6154c6645eadcc19b6c089deab78c24a612a83206f2a8a5992a7c \
|
||||
--hash=sha256:c9ac886242bbd50fb35a2242ba79555a99891e657da33f98b7ca968e3488a350 \
|
||||
--hash=sha256:cbf0b83ce927de6053279ba61342d9f8892afde1385fcba9144cd05d4023d109 \
|
||||
--hash=sha256:cc010a0a7fbdd9bb8bdfd0d3f04a5151275860213cbd7e2b876b29778489c712 \
|
||||
--hash=sha256:cd7397de6cc782f00fe5ac1d75e9b306bcfa49c8b6b8dd6ed1f7709393ad40b3 \
|
||||
--hash=sha256:d45cdc495671fc99268ff3653e0da4244972e9fc0e1fc3ea9de18781ad28963a \
|
||||
--hash=sha256:d472ee1c64868a917a47f02ffb4ac8c22b477f7589d57a3eb0c58b1ad4f0137c \
|
||||
--hash=sha256:d523da3c2e4bca49417768bcdb1a443c5b359dc44b8b93a3102e118fce912c40 \
|
||||
--hash=sha256:da94ec0484e84fce5c7bf8d0f54b97767a90d992653a129b35634699d516e0a5 \
|
||||
--hash=sha256:db645c81cf4d6bcb392ea1894aad65d55d1588a8472c834b25ca575da3029a56 \
|
||||
--hash=sha256:dc5936491e306f2f6f095bd5fba593de11eb0375cee787ca1f245c3a333a523a \
|
||||
--hash=sha256:dfb12891a773cbc2132349c77c690a045a882fe3f98b4bda50dfabb01893f9bd \
|
||||
--hash=sha256:e42a835271922fe7bf98c7a05c78d4032f4e52bf5b07fafa1eadfdfc2f0ad22f \
|
||||
--hash=sha256:e4eaf11d6b0f2147f46cfbf06fe7edcca6f095d0120da00ddc2458995ee869fc \
|
||||
--hash=sha256:e65a1e61a68493fbfbe44d8bec71b3231d81b9917f62d3dafe0e105072147e83 \
|
||||
--hash=sha256:e8a72b26dc5c9a9422e45472b1d67ba5caf273c524c8668cc04b23062663755e \
|
||||
--hash=sha256:e9494d9e99389d39e6a96227749af898d8924ff591cb63944f8a98e68582bf0e \
|
||||
--hash=sha256:ef65e96f0fc1a7c8b7644c7011d47a8228555e7888ac4d6246f715a7f3d7c398 \
|
||||
--hash=sha256:f1fc9a7cea899c51d8a53e66c2f082a3d9e461ece32418d3ef0a0b90c32bfd3d \
|
||||
--hash=sha256:f6cdb47a9be2d3313829bed1d296086287682a3ee901ff987b3432b45705b771 \
|
||||
--hash=sha256:f72640e02a470b57b15cd655820133f6892760209283a363a60e2df932d5f0fe \
|
||||
--hash=sha256:f8bc2cd4c6aa58be1ca243fb8cddb6c3c42031fe4403991ad9cf2b3baed03d9f \
|
||||
--hash=sha256:fb5745048ee20f796b0e3ab61831049e749acff188563e2af32f58ede957ac1b
|
||||
coverage==7.17.3 \
|
||||
--hash=sha256:0241e03dd65a1edf2e841eb19d8d72dca21ada5c869dcef6c9fde1b166d519a9 \
|
||||
--hash=sha256:0837b71a40749d9c4016cf8c51ba8c6153f7dd40cf4dfa287a2f28376fa50917 \
|
||||
--hash=sha256:0860a5f27ceccd53ee4070acc182588ed4f15b7401cdcca09d8c0cece9c2ad7d \
|
||||
--hash=sha256:095ad10d17a28c845f2e5f99e398db2f0c680401731ff63a3a1789f2e61ef1e0 \
|
||||
--hash=sha256:0bad8245a15bc7b15d26d25ece243bbf5d1b1229144f3db189014174429b63bb \
|
||||
--hash=sha256:11116ab42247d55980b51ab49b5c066de9b6baa56fe371fd555e54feae338619 \
|
||||
--hash=sha256:16ed46c0d461a3972e8474268c22bf5d88cdd1088435313edc7e220050c5ac97 \
|
||||
--hash=sha256:17a4bd9edd312744035e1298a6ac30dd7332a7f1ecdc63c9eb0685589b161eb1 \
|
||||
--hash=sha256:1b358585003cf99a13d1327e11582af19154d2cf3dea366fe0d10ce479a5c9f9 \
|
||||
--hash=sha256:1ba5c445d4c7718422753a393bcb0feb6d9834321cdb43dcb585725a392b3edd \
|
||||
--hash=sha256:1bbbc3e4de867a5e75684d98fc77c20e0687ca3abec69b4421b6f3fb96cd860f \
|
||||
--hash=sha256:1d26daefd513c4775a6d06846389da9a9e3498b6ddba24982359b75b703dd341 \
|
||||
--hash=sha256:1e7a015f952798d7d5120e8122c160fce7322b0b9d144b9be6af71552a3e68da \
|
||||
--hash=sha256:203aa5e42c88e9accfa18a0cc91950499efaa5b179a1da14bcbf5b995afdbcb6 \
|
||||
--hash=sha256:21745c08f2835b847a16887b748d3084dddeb0571ae2a0d62e33644413568b99 \
|
||||
--hash=sha256:222bc51858b0f64cb15d51380541712f8d5dc9bb5ce4fd9828bf466503d6debb \
|
||||
--hash=sha256:228f4bcecadcbb1ec3ed088b0595c5c08f3fca01406b72e8a02209a3af16aff9 \
|
||||
--hash=sha256:22a80bbdee3c22fb3319befaa112a2ed2d6e1417aa75c310f048235170ceca44 \
|
||||
--hash=sha256:24389d7d50f1fe98ac8d8ec1c946656a75b97d953b51a714484e174ed9f48eb1 \
|
||||
--hash=sha256:2765261bdcb5f6c01af41d97ec4fcfe18acd1114d8d2690536a36f86b67c179f \
|
||||
--hash=sha256:28b05f6b2622551805324196c32f3f20f4fa639bade8ac299ca83073253f6663 \
|
||||
--hash=sha256:28d082105e1ead78de56eb46edde029b5af88e22f8bde74fd092ca164bf15492 \
|
||||
--hash=sha256:2b9a39e25bf0e6fe072c6f3bceaa02f5303b9f975e83f590d118c4e92aacf6d8 \
|
||||
--hash=sha256:320a27997b421ea16eeff42cfd26d40584abd436fb7802ca766d6e8610bc9718 \
|
||||
--hash=sha256:349ab42e0b6b72892f187a60a0890b3a76710e93b7c31579e81648d46230a8ed \
|
||||
--hash=sha256:35137f71927b7da9292d391409104391b73c5e80d26b6a0d216d871964092351 \
|
||||
--hash=sha256:397e5342fd4f19ae930a5234643a63a8eaccc18a2f034a2f1765a5313123489d \
|
||||
--hash=sha256:39c063c038b710e0bca3afd4997ccee680674bece468fac13cb8aee9af530d31 \
|
||||
--hash=sha256:3a5691ef42b16e22976ec0352a76a0f7c3b4196fe3d39805dcc765e31ce54f22 \
|
||||
--hash=sha256:3f6d942e066ca009bd1f7ebf5450287a5e9bfc5a6e20a8d8c408a61b433c7f94 \
|
||||
--hash=sha256:42a1f511a334745a66b8f580c4d561e728243e35f3ada0ada35444c4b2fb9fa9 \
|
||||
--hash=sha256:4300ad360b21af19584c4cc82022979544d776ba2fb2df5418b2f3cae1eee6d2 \
|
||||
--hash=sha256:45268757a45946ab3fc9d2c30019aff2d3804ae660121d5b31f523366f604e67 \
|
||||
--hash=sha256:47cd7674a39bad6480e565e2a5b77f8089ebfbcd3aacc572abc6cebabe1f4cc9 \
|
||||
--hash=sha256:47e49fced11190fdc678182b0e7f8947db4fc1c1216094923a1d2bbedba3c84a \
|
||||
--hash=sha256:499acdc43bf1addf7fecc59a3123847bb96873c07001cfbeb709a71b181fa03d \
|
||||
--hash=sha256:49a4f12eff115fc2447d3438b2c08d7e5adb3abc811c050ee508f8189718cc5d \
|
||||
--hash=sha256:49fff24117050f1784447ae8181e75a78b01cfef4b6a8ccba676d466d1d68d9b \
|
||||
--hash=sha256:4b1300f07904db81508b87a72471e80d37fb6d48debf1168e12edccc81cd0225 \
|
||||
--hash=sha256:4d64248cb7c995aa66dac34c66286c80fb78b13c19bee1503720cc6e55e5de17 \
|
||||
--hash=sha256:4dc3c84002968363c37688e0b325d51a51816c53f3c0cbb925254317c675a789 \
|
||||
--hash=sha256:5559549a14f997b261c936ca463ed67e030511f914ffd1692ad08b3b16ed6034 \
|
||||
--hash=sha256:56b469b63d8270aa67bc919ab8457f4d83115459556a76d09238052a3ab094db \
|
||||
--hash=sha256:582c5d80b6de5b1909a4222ec1f5676bb2e03815c6be9ff43db2d8a71de5079c \
|
||||
--hash=sha256:59b4bd56882387b5a957048a77531669d53d641ce8148c23149d2550e9fd4e25 \
|
||||
--hash=sha256:59c15dcae783ed291da3af6be2e70762322637ac886b19671d12123521cf6ac3 \
|
||||
--hash=sha256:61138b3a51d91ee443b04962ec9990fa140208a7a082b1754135ebd1378a420f \
|
||||
--hash=sha256:620fb331a7d94e3749348cb4a5febcb2ef23ef17192349088e80f4da0cf42647 \
|
||||
--hash=sha256:6695d1bb2a9a2fbd7806d69d78cf30f35eb0f65045da0ec5b5045242fadd6a78 \
|
||||
--hash=sha256:683a204e9773f3127ef836640712270bc4893f10bd7e1ce8a21735dca4c14429 \
|
||||
--hash=sha256:6a8db4bf69a1982cf0fcf16fb11ff17bb2ed3ade5b0e803bb67ad2963a7b1bf3 \
|
||||
--hash=sha256:6d116e2d3b3f3506f634cc48f58dd01497f34a50263e65acfaf6ad7a162f3384 \
|
||||
--hash=sha256:6f8f925262bc0d6fea12d5dde6998aa57f162e05d5a7d50b95d400ab05bb4537 \
|
||||
--hash=sha256:733368982d2799ff04d768916fb755e54d4ce11af3573488ece451745c90d4a7 \
|
||||
--hash=sha256:76a3ddca94ef96b477b7edceac08b1abe0ff26e1ebe1d7000e35bdd17dcde5c4 \
|
||||
--hash=sha256:7c420ffa993c25cc74c263e9c1c869fbaea7d16dcb6448eef4fa6f1905560f5a \
|
||||
--hash=sha256:7f02996b09190bcdee3b2af38bf2279e4a1a65306afd3e6c229029dbe41e42ea \
|
||||
--hash=sha256:8009572d242674765b84ecceba126c2392b1824b32f41db1f3323d23d4cb598f \
|
||||
--hash=sha256:80e219a51ef7ccf78fcd584257e523ece0d390cb3d9d3896660eac05a19ac691 \
|
||||
--hash=sha256:83510c65a385563646297e8dd572e5def63dc300ca08ae15307d99a0225cdfb8 \
|
||||
--hash=sha256:84b5a474040b33f3d805c0b19fadf5a2e78fdd46e0bcb8b813631e5cac64195e \
|
||||
--hash=sha256:86563b5323fc13239d943b22a1bb9ec60f9ca17bd9a0be09c40a89836697aea2 \
|
||||
--hash=sha256:89f49fa6890f28247135934c4d92abb16828124b2cddb681e2496997c37364fd \
|
||||
--hash=sha256:8a054b755bc6665b339a923fed14a54446c43c942bf4edf08a59b1225b284c93 \
|
||||
--hash=sha256:8a0aef07b2eaeee9d82ca62241d5c6586aed5dd729300507d2d3f612588c2634 \
|
||||
--hash=sha256:8b713613ed67d5ed88968799e814888b62c6add21f5becad2cae1ec44260e9d0 \
|
||||
--hash=sha256:8b8188229ab3b3769a1c4aaa22357447555416deb440326c665a3bd25fd45ce0 \
|
||||
--hash=sha256:957ba72e11d26b6e6e1abdaa72e41020871f4108c8ff64ff571fc50c81fb57a3 \
|
||||
--hash=sha256:95da285cf77352d4a527e1fd16c1c5c3762e42d1d71cfa9ef2c72a5c796cce36 \
|
||||
--hash=sha256:9e331bc028b44496ad85d4a2656dbad0feb35baf4a66500042c4aaa878ea132c \
|
||||
--hash=sha256:9e888603ea67c63ba264f39f3459f4cf68adc78dcd9f8bfa65dde601265a40f1 \
|
||||
--hash=sha256:a13a946d8de807d8992e56a09502952d81bfbb4b80204ef77a6a2a38b4ce22be \
|
||||
--hash=sha256:a1dc44fba727d1cbd8daa88ced7dd867aebef5631b116210f2a2d4da08622d03 \
|
||||
--hash=sha256:a5fa43619c0a53a0424783cc08dbb26a2115e3a890ab566fef811b77d04d5501 \
|
||||
--hash=sha256:b355277f181890fdfc7f49af89f398f8735f031b2f9a5801082e678e9ae85972 \
|
||||
--hash=sha256:b65db089de3f219c850f21a2ca915f43f6fa1da5bfb55871c089d3be82c10369 \
|
||||
--hash=sha256:b6876123ce43459a4b39d5778108010b06164225c3a25c6a43cb85a97f80c549 \
|
||||
--hash=sha256:b6db3399e76a366353dd0c9a009fe74c3d1c892de35863331c4d06fbe0dd83b8 \
|
||||
--hash=sha256:b7028eabf24ad18646dbfc6b352cece01779914e69254ddcacdfb9f805d89f61 \
|
||||
--hash=sha256:b73148d024d086239fc04c03daaeb1934a6d295312dd0d6a04a937326c1207d4 \
|
||||
--hash=sha256:bb2b2f47ad4cc671491c725250ae2a5cadf43a3b0f9136e78f7ecf9506a9fd61 \
|
||||
--hash=sha256:bdf8fefb9f1acb3e92842fb42e29968d053e9545e4e9d9edb5c32a30fab8f899 \
|
||||
--hash=sha256:bf7a43782b20951fe9ddc6f6c28da51c65d3c0d5d5fc3c5a0e566986aa3ec0aa \
|
||||
--hash=sha256:c38a85dde92c4129641544aca998382f7448a87a17d202765a6adb8a87a33fc7 \
|
||||
--hash=sha256:c45c4e99a09c70e7d6fe101f59fe4556b89d99bfc80cd4e7f5e13ebb6c1e4854 \
|
||||
--hash=sha256:c4ae9befec714c867f42bbea99e1ec25eecdbe51c8faf1cc82164bd65bf4db0c \
|
||||
--hash=sha256:c53abadc7c4cf7870865fbaf7204e86efbacf93354e010e9188007fe2882a073 \
|
||||
--hash=sha256:c769e6a28bb645c915449ed8ddf6059765a72d8ef79590bfd6202022a4441cd3 \
|
||||
--hash=sha256:cc12f44ac4d5d6be301285c0a4f9c4ae52e673672e284b2a2744e20d24025573 \
|
||||
--hash=sha256:cfb1d2c52bb66e847669000658a5394d50aba835df8e31c2146034f978c8a4cf \
|
||||
--hash=sha256:d0e0fc055d4436f4b6de83f50cbd9da38af18fb36341b162b408ad7842068a33 \
|
||||
--hash=sha256:d3353cb2ad4254fa433cc53d1ee1fe80eebde529085b238393f3f6d5af821f70 \
|
||||
--hash=sha256:d5a3cd933fdffb958b4046d6f19d3138c7c8a28c439aac800badf61fab6d655e \
|
||||
--hash=sha256:dc116b251f7a4ae0266dba0ef31a742c6c517d3a99b4d50016548a17d407ac5f \
|
||||
--hash=sha256:dc6f3c1406fe7e8e2d59eed1f476c5429dcdd11cd3fbe1341acf8ddc4bb9b383 \
|
||||
--hash=sha256:dcd518608b7f869838436ff8d922977e186d1082b9ddad37305ad5282186fd41 \
|
||||
--hash=sha256:dcd6ea389b3da63f467b05c0f47db037a672592ab2035d4bfbb1f662eef4f4a3 \
|
||||
--hash=sha256:df0faa493ab92bbf33ff8bdab442c5b75089baa5ba752844871b5ce9d009a026 \
|
||||
--hash=sha256:e033255f24c1df6e046b6c4e9f91baacae08426beb5296bea8d46176b3a137d8 \
|
||||
--hash=sha256:e04385647f444d55b483a0e4dc519f46134846eddd80910a0d0953ea19e58358 \
|
||||
--hash=sha256:e142166a52ec7edc650b6d3a0b9b1f79dac0ab8843c249e8821ec97a71d1fd2a \
|
||||
--hash=sha256:e266c693c8bd6541f31cd71eda9b5aa3732adecbd04522880ea3d23d99b202eb \
|
||||
--hash=sha256:e3948b2e5c3af0133af3e117ee033e6cc656c43d7549d3296e4b3807908dec9f \
|
||||
--hash=sha256:e4d18e90c87621590a0b1cf2e4caa96f0aa511073f8a1caa3244e09e569564cc \
|
||||
--hash=sha256:e592f790fee57e2bedaa27cdc76988a082090d1aac560ca4bbea80a7a58436ec \
|
||||
--hash=sha256:e9396d4d90fb47a1e124a985ac6a3172dbd58334d1de5189f06b75ae96ff69ee \
|
||||
--hash=sha256:eb25b51a30d07db8493901e3040284f2e756ec2b6549ee392798b9ef4c0607b3 \
|
||||
--hash=sha256:f3347c72d0f4cb3803f4ccdd4331a49a90ef2daa683ce89e2480278400bd2eee \
|
||||
--hash=sha256:f7ff8b21efcbdf9c7a6c051dc158c9bb9e938b7af33e55ed264d2e529b836d17 \
|
||||
--hash=sha256:f8356475aba020621f8277f1a81c2dbdbda8286c7c6130f242c9816e044062a9 \
|
||||
--hash=sha256:f848ec842cb95fddae4b88830b249e8bade41697f16909688d2af80e8b51e7b6 \
|
||||
--hash=sha256:f8f6252bb4c457d686c18e42965087b30155ff72b0dbda6e79a43ee3682c0870 \
|
||||
--hash=sha256:fa8903475085973b5c916e8a958afd22101b9559880ffbeab5aeac4196768338 \
|
||||
--hash=sha256:fab6f713a1f2f0ab7fb7d55f3aea15d1f3fbd31ace61b585ecd87c8e34f898fb \
|
||||
--hash=sha256:faee34ea548318f6f9010928edab2f91b36a19b58376e69ab0e76d4f3a0bf9df \
|
||||
--hash=sha256:fb5945d7360fb258dee758258d93ea624a712fae494e7a0037a92505b3eb8b32 \
|
||||
--hash=sha256:ff0ca078fe63faffff1cff24c804afd4010e35d9c75bb593877b3d4321826c91 \
|
||||
--hash=sha256:ff273110e4e1505ef7a642523ba43f58eb6770ae9e8f869d72efea816cb4bc2c \
|
||||
--hash=sha256:ff5069e99039739c2fade5dd12cf8df7dc1b1217a0b915110605e0bbdddf1187
|
||||
# via pytest-cov
|
||||
idna==3.20 \
|
||||
--hash=sha256:a7db850025b95ded1eae8a46181a1a6c56c92c96f0e2b005d9ff8dc0210cab44 \
|
||||
@@ -428,9 +428,9 @@ pygments==2.21.0 \
|
||||
--hash=sha256:2363c69b61c4a97c838da3b130dcd6468f4848992b21a82f2a63ec34377137d9 \
|
||||
--hash=sha256:610ca751c9bc2492b38eb9a38a7fbc93edbbb2d7182edaf34e66ae493dee5c8c
|
||||
# via pytest
|
||||
pytest==9.1.1 \
|
||||
--hash=sha256:1088fbde8f2b49d95a549a195707afa7a76a3ce9bcadc26b6d71f0ffda5fe313 \
|
||||
--hash=sha256:37a86b45efb9a47a61a36449063e8e18d0cab3161329fc099eb21783169c4f0c
|
||||
pytest==9.2.0 \
|
||||
--hash=sha256:07acdcf88ec174f907dc01af70bf52d49b014bbab03faeeade31c96b18c2e588 \
|
||||
--hash=sha256:97c4f3b1f3c7414aa36465e09b8220f1d03627993bd51b1282e193753c80557b
|
||||
# via
|
||||
# -r requirements-dev.in
|
||||
# pytest-cov
|
||||
@@ -444,29 +444,29 @@ requests==2.34.2 \
|
||||
# via
|
||||
# -c requirements.txt
|
||||
# -r requirements.in
|
||||
ruff==0.17.2 \
|
||||
--hash=sha256:122258f6ecde0e0dd1bb60b24263c3edde4338caf723fca711cc729f9bfd414a \
|
||||
--hash=sha256:195ad918027f817c119310ca89a42d347887dfc28934aaa869325e9c5dc9d962 \
|
||||
--hash=sha256:1b59d447f197bef9ef48a22ba1a6016137753c6099e9bac9c36eb566e422424c \
|
||||
--hash=sha256:2d086be452eed686aa51271ecf2cbe5037956517cc6ee39a17b4489ac12f8bbe \
|
||||
--hash=sha256:39c5b55c960515cdb32be16e69efb5734c589c06a0eb38a22694524a336b889d \
|
||||
--hash=sha256:583bd67bb9e7061dd09bc46a0a884bae2bbd214dbcd48e509813612619683869 \
|
||||
--hash=sha256:5875a16b0de70b43cb81eabea5ae5e8f5d1b2fd1b5e6ed07f80cfe5019d0bd5a \
|
||||
--hash=sha256:6bce7d1f5165701ae18f5df85c65afe78cddfa6c5fb4b9bdb0014d60388f3edd \
|
||||
--hash=sha256:7cfd783590edf2b77317882631900f6a13ea2e8eacefe6ebf2370d2715299160 \
|
||||
--hash=sha256:7f8fba429d6ac4128ab29cfb8fa6240d2fa671d04adf7f84d3b22fc7b6b6bea4 \
|
||||
--hash=sha256:84d632402d14c23b488f941db23712d6736a013225162062d34558c3f3c780eb \
|
||||
--hash=sha256:8c21b4ab24485358f17291a4f8dc5399b834e963b8efedd920fe4fdb02081bb4 \
|
||||
--hash=sha256:92a80d2f44584dabb0189b3a6c393e37e525e04942838482010575cb81945be7 \
|
||||
--hash=sha256:96a65e755d8dba094707fb23ab602111d9a31ec2835b3a6992a1914a8fcb211e \
|
||||
--hash=sha256:b7d0906677d89bbf3cf73cde64b5bbe2ab35df3ae43e49ee2627301e91265bac \
|
||||
--hash=sha256:ba405cbd5ec7bda1f555d5e52be1fd68d02608d4d95d24591bdac92cfacb579f \
|
||||
--hash=sha256:c555a877f8f41447e318101cfefea9bf12dfa9f82eedf90c376e57e069f917d0 \
|
||||
--hash=sha256:c60f93fec7142dba5b8f487f94bf2f6231dae24dc11e4c48648347c8b0720004
|
||||
ruff==0.17.5 \
|
||||
--hash=sha256:0e5c125c5b31dc8efc948d41357496a4c4a312977565ccba740030efdff83580 \
|
||||
--hash=sha256:40ca8afaac309b41a5b2e09e4e7beb1f824826b93c25697c4d74f573324fba4e \
|
||||
--hash=sha256:50dfc3c6b3ebd0a932f11dfd579bd42234b0b7137e68940eb6abdbfdb9d69697 \
|
||||
--hash=sha256:54c0f67d1be11b55d12c184a819fc229f5eee3ef45c16c4fcad41258e83b4882 \
|
||||
--hash=sha256:625e57d80cd43352d12ea81690f3eac46cddc8c0f35026d137fb0f157f94592e \
|
||||
--hash=sha256:64a6fd668a336df959c522991de33e9e3c8be463afc0c9ac8f029f9d19ef756e \
|
||||
--hash=sha256:6f0db748508f04a04e3fbebcc636a5c8b3bd76274f8ed28f497c44d75c2ea2d7 \
|
||||
--hash=sha256:6f6a7b138edf9cc402ca736a59d9525e6d766e5395760b72e7e146e6251ac963 \
|
||||
--hash=sha256:86bd1f3b83c25f9b8055c6e796f0685b39d3127ce947322098c3108cf82fd586 \
|
||||
--hash=sha256:8e85601bd6d9b6c3e3b95c0e0dccdbac1d23c6bcef006d187fbcddaf8225a5df \
|
||||
--hash=sha256:aa415d57c244299279901d776607fee3df7831c2a7435433fbfacde8632c6550 \
|
||||
--hash=sha256:b72fbc232e328bdbb9cdddf4f1aedcd61bd1aa64d75fc012114b4add0bd7f26b \
|
||||
--hash=sha256:d511dd302982e46a285528942fa6557d57730edc4bdb9def95e86a2603d77396 \
|
||||
--hash=sha256:dd0dfe7c6fe5a447fce467c58e69893be1d9a7e4378f5b9906432da33d94a97f \
|
||||
--hash=sha256:e1546609b2ad73f1d6c5c076881b788672b7b3cc3283981182cbdbb6524ed88a \
|
||||
--hash=sha256:e52622ecf3a0df9d03e796fe3eed4aa085adda65520db7e0619cbd2192a97342 \
|
||||
--hash=sha256:ec4ecf40fb4d6e1265b009dbe551727920926fc0f769070c452d6d84b422a74d \
|
||||
--hash=sha256:f93d2b7d449ed9545304f6923699ca20d13c675b69f258481709a08ae61076db
|
||||
# via -r requirements-dev.in
|
||||
soupsieve==3.0.4 \
|
||||
--hash=sha256:8412826614f9c632227067d0985aeb9f584bd15efc852955430e097a9fe7afbf \
|
||||
--hash=sha256:924fab84ae21604c19e175e1f39815eb6fa83ba23836e09e9de180925e5bc4c0
|
||||
soupsieve==4.1 \
|
||||
--hash=sha256:ca9abf7126667010d8f6e9b39bfc1bc3b23c8aed9bcb0f54a754dde969bb8aab \
|
||||
--hash=sha256:e4d667b3974ce6e038e7390486b8093369854a1d345ffdd4c121dfc4a782e809
|
||||
# via
|
||||
# -c requirements.txt
|
||||
# beautifulsoup4
|
||||
|
||||
+3
-3
@@ -194,9 +194,9 @@ requests==2.34.2 \
|
||||
--hash=sha256:2a0d60c172f83ac6ab31e4554906c0f3b3588d37b5cb939b1c061f4907e278e0 \
|
||||
--hash=sha256:f288924cae4e29463698d6d60bc6a4da69c89185ad1e0bcc4104f584e960b9ed
|
||||
# via -r requirements.in
|
||||
soupsieve==3.0.4 \
|
||||
--hash=sha256:8412826614f9c632227067d0985aeb9f584bd15efc852955430e097a9fe7afbf \
|
||||
--hash=sha256:924fab84ae21604c19e175e1f39815eb6fa83ba23836e09e9de180925e5bc4c0
|
||||
soupsieve==4.1 \
|
||||
--hash=sha256:ca9abf7126667010d8f6e9b39bfc1bc3b23c8aed9bcb0f54a754dde969bb8aab \
|
||||
--hash=sha256:e4d667b3974ce6e038e7390486b8093369854a1d345ffdd4c121dfc4a782e809
|
||||
# via beautifulsoup4
|
||||
typing-extensions==4.16.0 \
|
||||
--hash=sha256:481caa481374e813c1b176ada14e97f1f67a4539ce9cfeb3f350d78d6370c2e8 \
|
||||
|
||||
@@ -874,5 +874,257 @@
|
||||
"name": "Lupa Rossi Redux",
|
||||
"reason": "Game page is password-protected",
|
||||
"deleted_at": "2026-10-25T02:55:39Z"
|
||||
},
|
||||
{
|
||||
"url": "https://stelladevt.itch.io/mascot-testimonial-css-for-itchio",
|
||||
"name": "Mascot Testimonial CSS for itch.io",
|
||||
"reason": "Not a game",
|
||||
"deleted_at": "2026-10-28T02:41:27Z"
|
||||
},
|
||||
{
|
||||
"url": "https://gabrielnjlc.itch.io/dont-close-your-eyes",
|
||||
"name": "Don’t Close Your Eyes (DEMO)",
|
||||
"reason": "Game page no longer exists (HTTP 404)",
|
||||
"deleted_at": "2026-11-01T02:49:55Z"
|
||||
},
|
||||
{
|
||||
"url": "https://digitalwaste.itch.io/moroz",
|
||||
"name": "MOROZ",
|
||||
"reason": "Game page no longer exists (HTTP 404)",
|
||||
"deleted_at": "2026-11-01T02:49:57Z"
|
||||
},
|
||||
{
|
||||
"url": "https://little-ones.itch.io/cozy-game-company",
|
||||
"name": "Cozy Game Company",
|
||||
"reason": "Game became paid",
|
||||
"deleted_at": "2026-11-01T02:50:01Z"
|
||||
},
|
||||
{
|
||||
"url": "https://arubberducky.itch.io/futanari-destroying-sex-robot",
|
||||
"name": "Futanari Destroying Sex Robot",
|
||||
"reason": "Game page no longer exists (HTTP 404)",
|
||||
"deleted_at": "2026-11-01T02:50:04Z"
|
||||
},
|
||||
{
|
||||
"url": "https://quiirisk.itch.io/stepmom-who-fell-on-a-hike",
|
||||
"name": "Stepmom Who Fell on a Hike",
|
||||
"reason": "Game page no longer exists (HTTP 404)",
|
||||
"deleted_at": "2026-11-01T02:50:07Z"
|
||||
},
|
||||
{
|
||||
"url": "https://bokendev-studio.itch.io/turbovektor",
|
||||
"name": "TurboVektor",
|
||||
"reason": "Game page no longer exists (HTTP 404)",
|
||||
"deleted_at": "2026-11-01T02:50:10Z"
|
||||
},
|
||||
{
|
||||
"url": "https://msky-dev.itch.io/sandtrix",
|
||||
"name": "Sandtrix",
|
||||
"reason": "Game became paid",
|
||||
"deleted_at": "2026-11-02T02:49:51Z"
|
||||
},
|
||||
{
|
||||
"url": "https://kikinndev.itch.io/lost-in-the-store",
|
||||
"name": "Lost In The Store",
|
||||
"reason": "Game page no longer exists (HTTP 404)",
|
||||
"deleted_at": "2026-11-03T02:50:25Z"
|
||||
},
|
||||
{
|
||||
"url": "https://lucius39.itch.io/happy-chicken-master",
|
||||
"name": "Happy chicken master",
|
||||
"reason": "Game became paid",
|
||||
"deleted_at": "2026-11-03T02:50:29Z"
|
||||
},
|
||||
{
|
||||
"url": "https://thomas-tung.itch.io/day-five-v1",
|
||||
"name": "Day Five - v1",
|
||||
"reason": "Game page no longer exists (HTTP 404)",
|
||||
"deleted_at": "2026-11-03T02:50:32Z"
|
||||
},
|
||||
{
|
||||
"url": "https://countlessbathory.itch.io/autumns-end",
|
||||
"name": "Autumn's end (FREE UNTIL HALLOWEEN)",
|
||||
"reason": "Game became paid",
|
||||
"deleted_at": "2026-11-04T02:50:09Z"
|
||||
},
|
||||
{
|
||||
"url": "https://mimu2026.itch.io/empty-box",
|
||||
"name": "Empty Box-DEMO",
|
||||
"reason": "Game became paid",
|
||||
"deleted_at": "2026-11-04T02:50:12Z"
|
||||
},
|
||||
{
|
||||
"url": "https://sasbyxan.itch.io/farm-factory-demo",
|
||||
"name": "Farm Factory | Demo",
|
||||
"reason": "Game page no longer exists (HTTP 404)",
|
||||
"deleted_at": "2026-11-04T02:50:16Z"
|
||||
},
|
||||
{
|
||||
"url": "https://raxeris.itch.io/99",
|
||||
"name": "99%",
|
||||
"reason": "Game became paid",
|
||||
"deleted_at": "2026-11-04T02:50:18Z"
|
||||
},
|
||||
{
|
||||
"url": "https://andrealphus.itch.io/that-time-i-got-reincarnated-as-a-barbarian",
|
||||
"name": "That Time I Got Reincarnated As A Barbarian",
|
||||
"reason": "Game became paid",
|
||||
"deleted_at": "2026-11-04T02:50:21Z"
|
||||
},
|
||||
{
|
||||
"url": "https://nytraam.itch.io/spooky-escape",
|
||||
"name": "A Spooky Escape (CJ)",
|
||||
"reason": "Game page no longer exists (HTTP 404)",
|
||||
"deleted_at": "2026-11-04T02:50:24Z"
|
||||
},
|
||||
{
|
||||
"url": "https://xeif.itch.io/kizuna-zx-spectrum",
|
||||
"name": "KIZUNA - ZX Spectrum",
|
||||
"reason": "Game became paid",
|
||||
"deleted_at": "2026-11-04T02:50:27Z"
|
||||
},
|
||||
{
|
||||
"url": "https://nanaroba.itch.io/the-intruder",
|
||||
"name": "The Intruder (DEMO)",
|
||||
"reason": "Game page no longer exists (HTTP 404)",
|
||||
"deleted_at": "2026-11-05T02:50:12Z"
|
||||
},
|
||||
{
|
||||
"url": "https://glodory-studio.itch.io/late-night",
|
||||
"name": "Late Order",
|
||||
"reason": "Game became paid",
|
||||
"deleted_at": "2026-11-05T02:50:15Z"
|
||||
},
|
||||
{
|
||||
"url": "https://lemos.itch.io/lure-of-the-vulpine-voice",
|
||||
"name": "Lure of the Vulpine Voice",
|
||||
"reason": "Game became paid",
|
||||
"deleted_at": "2026-11-06T02:49:50Z"
|
||||
},
|
||||
{
|
||||
"url": "https://star2dfd.itch.io/starlock",
|
||||
"name": "StarLock v2.2.12",
|
||||
"reason": "Game page no longer exists (HTTP 404)",
|
||||
"deleted_at": "2026-11-07T02:49:35Z"
|
||||
},
|
||||
{
|
||||
"url": "https://hotpink.itch.io/cryptid-park",
|
||||
"name": "Cryptid Park",
|
||||
"reason": "Game became paid",
|
||||
"deleted_at": "2026-11-07T02:49:40Z"
|
||||
},
|
||||
{
|
||||
"url": "https://deeddomanion.itch.io/deed-dominion",
|
||||
"name": "Deed & Dominion",
|
||||
"reason": "Game page is password-protected",
|
||||
"deleted_at": "2026-11-08T02:50:59Z"
|
||||
},
|
||||
{
|
||||
"url": "https://choic-e.itch.io/whyher",
|
||||
"name": "I Can't Fix Her",
|
||||
"reason": "Game page no longer exists (HTTP 404)",
|
||||
"deleted_at": "2026-11-08T02:51:07Z"
|
||||
},
|
||||
{
|
||||
"url": "https://zackanuar.itch.io/heir-of-the-dog",
|
||||
"name": "Heir of the Dog",
|
||||
"reason": "Game page no longer exists (HTTP 404)",
|
||||
"deleted_at": "2026-11-08T02:51:11Z"
|
||||
},
|
||||
{
|
||||
"url": "https://datasparrow.itch.io/shardana-hydro-trail-gp",
|
||||
"name": "Shardana: Hydro Trail GP",
|
||||
"reason": "Game became paid",
|
||||
"deleted_at": "2026-11-09T02:49:47Z"
|
||||
},
|
||||
{
|
||||
"url": "https://bksil.itch.io/hyperfall",
|
||||
"name": "Hyperfall",
|
||||
"reason": "Game page no longer exists (HTTP 404)",
|
||||
"deleted_at": "2026-11-11T02:50:09Z"
|
||||
},
|
||||
{
|
||||
"url": "https://kenmaryuji.itch.io/mineminemine",
|
||||
"name": "MINE! MINE! MINE! (v1.2)",
|
||||
"reason": "Game became paid",
|
||||
"deleted_at": "2026-11-11T02:50:11Z"
|
||||
},
|
||||
{
|
||||
"url": "https://wistarck.itch.io/joyandme",
|
||||
"name": "Joy and me Chapter 1",
|
||||
"reason": "Game page no longer exists (HTTP 404)",
|
||||
"deleted_at": "2026-11-12T02:49:43Z"
|
||||
},
|
||||
{
|
||||
"url": "https://star2dfd.itch.io/starbetablock",
|
||||
"name": "StarCensor v0.1",
|
||||
"reason": "Game page no longer exists (HTTP 404)",
|
||||
"deleted_at": "2026-11-12T02:49:47Z"
|
||||
},
|
||||
{
|
||||
"url": "https://pollikk-studios.itch.io/marketfield",
|
||||
"name": "Marketfield",
|
||||
"reason": "Game became paid",
|
||||
"deleted_at": "2026-11-13T02:49:46Z"
|
||||
},
|
||||
{
|
||||
"url": "https://red-anarhy173.itch.io/sprunki-hypershifted-peppers-take",
|
||||
"name": "Sprunki Hypershifted Pepper's Take",
|
||||
"reason": "Game page no longer exists (HTTP 404)",
|
||||
"deleted_at": "2026-11-13T02:49:50Z"
|
||||
},
|
||||
{
|
||||
"url": "https://funday-games.itch.io/booster-pack-heroes",
|
||||
"name": "Booster Pack Heroes",
|
||||
"reason": "Game became paid",
|
||||
"deleted_at": "2026-11-13T02:49:54Z"
|
||||
},
|
||||
{
|
||||
"url": "https://leonncamayo.itch.io/failrooms",
|
||||
"name": "FailRooms - Demo",
|
||||
"reason": "Game page no longer exists (HTTP 404)",
|
||||
"deleted_at": "2026-11-13T02:49:56Z"
|
||||
},
|
||||
{
|
||||
"url": "https://joerenwick.itch.io/girl-scarecrow",
|
||||
"name": "Girl & Scarecrow DEMO",
|
||||
"reason": "Game became paid",
|
||||
"deleted_at": "2026-11-13T02:50:00Z"
|
||||
},
|
||||
{
|
||||
"url": "https://vempyy.itch.io/jungle-tag",
|
||||
"name": "Jungle tag V99",
|
||||
"reason": "Game page no longer exists (HTTP 404)",
|
||||
"deleted_at": "2026-11-13T02:50:03Z"
|
||||
},
|
||||
{
|
||||
"url": "https://alfri00.itch.io/ballrollterror",
|
||||
"name": "BallRollTerror",
|
||||
"reason": "Game page no longer exists (HTTP 404)",
|
||||
"deleted_at": "2026-11-13T02:50:07Z"
|
||||
},
|
||||
{
|
||||
"url": "https://zapakitul.itch.io/night-cart-the-immortal-plague",
|
||||
"name": "Night Cart: The Immortal Plague",
|
||||
"reason": "Game became paid",
|
||||
"deleted_at": "2026-11-14T02:49:35Z"
|
||||
},
|
||||
{
|
||||
"url": "https://turtlevaniagames.itch.io/penguin-planet",
|
||||
"name": "Penguin Planet",
|
||||
"reason": "Game page no longer exists (HTTP 404)",
|
||||
"deleted_at": "2026-11-14T02:49:39Z"
|
||||
},
|
||||
{
|
||||
"url": "https://shibaki-dev.itch.io/ninefold",
|
||||
"name": "Ninefold",
|
||||
"reason": "Game page no longer exists (HTTP 404)",
|
||||
"deleted_at": "2026-11-14T02:49:42Z"
|
||||
},
|
||||
{
|
||||
"url": "https://nhungtt2804.itch.io/abyssal-drift",
|
||||
"name": "Abyssal drift",
|
||||
"reason": "Game page no longer exists (HTTP 404)",
|
||||
"deleted_at": "2026-11-14T02:49:44Z"
|
||||
}
|
||||
]
|
||||
+2
-2
@@ -150,7 +150,7 @@ def select_targets(
|
||||
first_urls = {g["url"] for g in first}
|
||||
rest = sorted(
|
||||
(g for g in games if g["url"] not in first_urls),
|
||||
key=lambda g: state.get(g["url"], {}).get(stamp, ""),
|
||||
key=lambda game: state.get(game["url"], {}).get(stamp, ""),
|
||||
)
|
||||
return (first + rest)[:budget]
|
||||
|
||||
@@ -299,7 +299,7 @@ def _write_outputs(stats: dict) -> None:
|
||||
("Errors / parse failures", f"{stats['errors']} / {stats['parse_fail']}"),
|
||||
("HTTP 429/503", stats["http_429"]),
|
||||
("Stopped", stats["stopped"] or "completed"),
|
||||
("Duration", f"{stats['duration_s'] / 60:.1f} min"),
|
||||
("Duration", f"{float(stats['duration_s']) / 60:.1f} min"),
|
||||
]
|
||||
with open(summary, "a", encoding="utf-8") as f:
|
||||
f.write("### Catalog refresh\n\n| | |\n|---|---|\n")
|
||||
|
||||
File diff suppressed because it is too large.
Load diff
+6035
-3618
File diff suppressed because it is too large.
Load diff
@@ -167,7 +167,6 @@ def main(argv: list[str] | None = None) -> None:
|
||||
stats["retry"] += 1
|
||||
continue
|
||||
|
||||
outcome = ""
|
||||
if page.status == 200 and page.soup is not None and is_password_protected(page.soup):
|
||||
outcome = "private" # final: nobody can open it, so retrying won't help
|
||||
elif page.status == 200 and page.soup is not None:
|
||||
|
||||
+3
-2
@@ -28,7 +28,7 @@ key entries) and rewrites old `#/…` links to real paths ([`src/lib/legacy.ts`]
|
||||
| [`vite-plugins/catalog-data.ts`](vite-plugins/catalog-data.ts) | Bundles the catalog into `dist/data/` (packs + legacy JSON) + `sitemap.xml` |
|
||||
| [`public/`](public/) | Static files; [`public/_headers`](public/_headers) sets headers + CSP for them |
|
||||
| [`src-tauri/`](src-tauri/) | Tauri 2 shell for the desktop and Android apps |
|
||||
| [`scripts/`](scripts/) | `gen_assets.py` (PWA icons + OG image), `i18n-edit.mjs` (edit `en`/`vi` keys together) |
|
||||
| [`scripts/`](scripts/) | `gen_assets.py` (PWA icons + OG image), `i18n-edit.mjs` (edit `en`/`vi` keys together), `check-tauri-versions.mjs` (`npm run check:tauri`), and the repo-level tests `check-csp-hashes.test.mjs` (inline script hashes in the CSPs) and `check-contrast.test.mjs` (WCAG contrast of the colour tokens and the chart palette) |
|
||||
| [`wrangler.jsonc`](wrangler.jsonc) | Worker config: assets, bindings, vars, cron, `staging` env |
|
||||
|
||||
## Local dev
|
||||
@@ -73,6 +73,7 @@ Path alias `@/*` → `src/*`. Vite injects `__BUILD_DATE__` for the About page.
|
||||
The same steps as [`webapp-ci.yml`](../.github/workflows/webapp-ci.yml):
|
||||
|
||||
```sh
|
||||
npm run check:tauri # Tauri crates and their npm packages share major.minor
|
||||
npm run cf:types -- --check # worker-configuration.d.ts matches wrangler.jsonc
|
||||
npm run lint # ESLint
|
||||
npm run knip # unused files / exports / deps
|
||||
@@ -95,7 +96,7 @@ local secrets can't leak into it. Secrets are typed by hand in [`worker/env.ts`]
|
||||
| `/charts` | [src/routes/charts.tsx](src/routes/charts.tsx) | Charts + KPI cards across 4 tabs |
|
||||
| `/removed` | [src/routes/deleted.tsx](src/routes/deleted.tsx) | Removed games, with reasons (`/deleted` redirects here) |
|
||||
| `/suggest` | [src/routes/suggest.tsx](src/routes/suggest.tsx) | Suggest a game (Turnstile, goes to the review queue) |
|
||||
| `/settings` | [src/routes/settings.tsx](src/routes/settings.tsx) | Theme, language, density, 18+ content opt-in (the header's display menu has the same) |
|
||||
| `/settings` | [src/routes/settings.tsx](src/routes/settings.tsx) | Theme, language, density, hide scrollbars, accessibility (the "/" search shortcut), 18+ content opt-in (the header's display menu has most of them) |
|
||||
| `/about` | [src/routes/about.tsx](src/routes/about.tsx) | Project info, legal links, third-party credits |
|
||||
| `/errors/:code` | [src/routes/error-preview.tsx](src/routes/error-preview.tsx) | Hidden error-page preview (not in the nav) |
|
||||
|
||||
|
||||
@@ -3,7 +3,7 @@ import { ApiError, SessionExpired } from './api'
|
||||
import { ERROR_TEXT, errorText } from './texts'
|
||||
|
||||
// The sources of every error the admin API answers with.
|
||||
const SOURCES = import.meta.glob<string>(['../worker/admin.ts', '../worker/http.ts'], {
|
||||
const SOURCES = import.meta.glob<string>(['../worker/admin.ts', '../worker/http.ts', '../worker/ratelimit.ts'], {
|
||||
query: '?raw',
|
||||
import: 'default',
|
||||
eager: true,
|
||||
@@ -12,8 +12,11 @@ const SOURCES = import.meta.glob<string>(['../worker/admin.ts', '../worker/http.
|
||||
describe('admin error texts', () => {
|
||||
it('has wording for every error code of the admin API', () => {
|
||||
const codes = new Set(
|
||||
Object.values(SOURCES).flatMap((src) => [...src.matchAll(/HttpError\(\d{3}, '([a-z_]+)'/g)].map((m) => m[1])),
|
||||
Object.values(SOURCES).flatMap((src) =>
|
||||
[...src.matchAll(/HttpError\(\d{3}, '([a-z_]+)'|json\(\{ error: '([a-z_]+)' \}/g)].map((m) => m[1] ?? m[2]),
|
||||
),
|
||||
)
|
||||
expect(codes).toContain('rate_limited')
|
||||
expect(codes.size).toBeGreaterThan(15)
|
||||
expect([...codes].filter((c) => !(c in ERROR_TEXT))).toEqual([])
|
||||
})
|
||||
|
||||
@@ -11,6 +11,7 @@ export const ERROR_TEXT: Record<string, string> = {
|
||||
github_error: 'GitHub refused the change.',
|
||||
network_error: 'The server could not be reached. Check the connection and try again.',
|
||||
internal_error: 'Something went wrong on the server.',
|
||||
rate_limited: 'Too many requests from this connection. Wait a minute, then try again.',
|
||||
not_found: 'Not found.',
|
||||
invalid_body: 'The request was malformed.',
|
||||
invalid_json: 'The request was malformed.',
|
||||
|
||||
Generated
+638
-779
File diff suppressed because it is too large.
Load diff
+21
-24
@@ -1,7 +1,7 @@
|
||||
{
|
||||
"name": "webapp",
|
||||
"private": true,
|
||||
"version": "4.4.3",
|
||||
"version": "4.6.2",
|
||||
"license": "MIT",
|
||||
"type": "module",
|
||||
"engines": {
|
||||
@@ -34,52 +34,49 @@
|
||||
"@radix-ui/react-slot": "^1.5.0",
|
||||
"@radix-ui/react-switch": "^1.4.1",
|
||||
"@radix-ui/react-tabs": "^1.2.1",
|
||||
"@tanstack/react-query": "^5.104.5",
|
||||
"@tanstack/react-query-devtools": "^5.104.5",
|
||||
"@tanstack/react-query-persist-client": "^5.104.5",
|
||||
"@tanstack/react-query": "^5.107.1",
|
||||
"@tanstack/react-query-devtools": "^5.107.1",
|
||||
"@tanstack/react-query-persist-client": "^5.107.1",
|
||||
"@tauri-apps/api": "^2.12.4",
|
||||
"@tauri-apps/plugin-opener": "^2.7.2",
|
||||
"@tauri-apps/plugin-opener": "^2.7.3",
|
||||
"class-variance-authority": "^0.7.1",
|
||||
"clsx": "^2.1.1",
|
||||
"fflate": "^0.8.3",
|
||||
"idb-keyval": "^6.3.0",
|
||||
"jose": "^6.2.13",
|
||||
"lucide-react": "^1.61.0",
|
||||
"jose": "^6.2.17",
|
||||
"lucide-react": "^1.72.0",
|
||||
"react": "^19.3.1",
|
||||
"react-dom": "^19.3.1",
|
||||
"react-router": "^8.5.0",
|
||||
"react-router": "^8.5.1",
|
||||
"recharts": "^3.10.1",
|
||||
"tailwind-merge": "^3.7.0",
|
||||
"zustand": "^5.0.16"
|
||||
"zustand": "^5.1.0"
|
||||
},
|
||||
"devDependencies": {
|
||||
"@eslint/js": "^10.0.1",
|
||||
"@tailwindcss/vite": "^4.3.3",
|
||||
"@tailwindcss/vite": "^4.3.5",
|
||||
"@tauri-apps/cli": "^2.12.4",
|
||||
"@types/node": "^26.6.5",
|
||||
"@types/node": "^26.6.6",
|
||||
"@types/react": "^19.3.0",
|
||||
"@types/react-dom": "^19.3.0",
|
||||
"@typescript/native": "npm:typescript@^7.0.2",
|
||||
"@vitejs/plugin-react": "^6.1.2",
|
||||
"@vitest/coverage-v8": "^5.0.5",
|
||||
"eslint": "^10.13.0",
|
||||
"@vitejs/plugin-react": "^6.3.0",
|
||||
"@vitest/coverage-v8": "^5.1.0",
|
||||
"eslint": "^10.14.0",
|
||||
"eslint-plugin-react-hooks": "^7.1.1",
|
||||
"eslint-plugin-react-refresh": "^0.5.7",
|
||||
"globals": "^17.13.0",
|
||||
"knip": "^6.42.1",
|
||||
"tailwindcss": "^4.3.3",
|
||||
"globals": "^17.14.0",
|
||||
"knip": "^6.45.1",
|
||||
"tailwindcss": "^4.3.5",
|
||||
"tw-animate-css": "^1.4.0",
|
||||
"typescript": "npm:@typescript/typescript6@^6.0.2",
|
||||
"typescript-eslint": "^8.72.0",
|
||||
"vite": "^8.3.5",
|
||||
"vitest": "^5.0.5",
|
||||
"wrangler": "^4.152.0"
|
||||
"typescript-eslint": "^8.72.2",
|
||||
"vite": "^8.3.8",
|
||||
"vitest": "^5.1.0",
|
||||
"wrangler": "^4.161.0"
|
||||
},
|
||||
"allowScripts": {
|
||||
"esbuild": true,
|
||||
"workerd": true
|
||||
},
|
||||
"overrides": {
|
||||
"undici": "^7.30.1"
|
||||
}
|
||||
}
|
||||
@@ -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
|
||||
@@ -0,0 +1,92 @@
|
||||
// WCAG 2.2 AA contrast of the design tokens (src/index.css, light and dark) and
|
||||
// of the chart palette: 4.5:1 for text, 3:1 for the parts of controls and charts
|
||||
// people need to see (field borders, the focus ring, chart marks). A colour
|
||||
// change that breaks one of these fails CI with the pair and its ratio.
|
||||
import { readFileSync } from 'node:fs'
|
||||
import { describe, expect, it } from 'vitest'
|
||||
import { NEUTRAL, PALETTE, PALETTE_LABEL } from '../src/components/charts/palette.ts'
|
||||
import { contrastRatio } from '../src/lib/color.ts'
|
||||
|
||||
const TEXT = 4.5
|
||||
const NON_TEXT = 3
|
||||
|
||||
const css = readFileSync(new URL('../src/index.css', import.meta.url), 'utf8').replace(/\r\n/g, '\n')
|
||||
|
||||
/** The 6-digit colour tokens of one `selector { … }` block (alpha tokens skipped). */
|
||||
function tokens(selector) {
|
||||
const start = css.indexOf(`\n${selector} {`)
|
||||
if (start < 0) throw new Error(`index.css: no ${selector} block`)
|
||||
const body = css.slice(start, css.indexOf('\n}', start))
|
||||
return Object.fromEntries([...body.matchAll(/--([\w-]+):\s*(#[0-9a-f]{6})\s*;/gi)].map((m) => [m[1], m[2]]))
|
||||
}
|
||||
|
||||
const LIGHT = tokens(':root')
|
||||
const THEMES = { light: LIGHT, dark: { ...LIGHT, ...tokens('.dark') } }
|
||||
|
||||
// [foreground token, background token]
|
||||
const TEXT_PAIRS = [
|
||||
['foreground', 'background'],
|
||||
['foreground', 'card'],
|
||||
['foreground', 'popover'],
|
||||
['foreground', 'muted'],
|
||||
['muted-foreground', 'background'],
|
||||
['muted-foreground', 'card'],
|
||||
['muted-foreground', 'popover'],
|
||||
['muted-foreground', 'muted'],
|
||||
['muted-foreground', 'accent'],
|
||||
['primary-foreground', 'primary'],
|
||||
['primary-text', 'background'],
|
||||
['primary-text', 'card'],
|
||||
['primary-text', 'muted'],
|
||||
['destructive', 'background'],
|
||||
['destructive', 'card'],
|
||||
['destructive-foreground', 'destructive-solid'],
|
||||
['success', 'card'],
|
||||
]
|
||||
|
||||
const NON_TEXT_PAIRS = [
|
||||
['input', 'background'],
|
||||
['input', 'card'],
|
||||
['input', 'popover'],
|
||||
['ring', 'background'],
|
||||
['ring', 'card'],
|
||||
['ring', 'popover'],
|
||||
['primary', 'card'],
|
||||
]
|
||||
|
||||
function failures(theme, pairs, min) {
|
||||
return pairs.flatMap(([fg, bg]) => {
|
||||
if (!theme[fg] || !theme[bg]) return [`missing --${fg} or --${bg}`]
|
||||
const ratio = contrastRatio(theme[fg], theme[bg])
|
||||
return ratio >= min ? [] : [`--${fg} on --${bg}: ${ratio.toFixed(2)}`]
|
||||
})
|
||||
}
|
||||
|
||||
describe('design tokens (src/index.css)', () => {
|
||||
for (const [name, theme] of Object.entries(THEMES)) {
|
||||
it(`${name}: text reaches ${TEXT}:1`, () => {
|
||||
expect(failures(theme, TEXT_PAIRS, TEXT)).toEqual([])
|
||||
})
|
||||
it(`${name}: field borders, focus ring and accent reach ${NON_TEXT}:1`, () => {
|
||||
expect(failures(theme, NON_TEXT_PAIRS, NON_TEXT)).toEqual([])
|
||||
})
|
||||
}
|
||||
})
|
||||
|
||||
describe('chart palette', () => {
|
||||
it(`every series colour reaches ${NON_TEXT}:1 on both themes' cards`, () => {
|
||||
const low = Object.entries(THEMES).flatMap(([name, theme]) =>
|
||||
[...PALETTE, NEUTRAL]
|
||||
.filter((color) => contrastRatio(color, theme.card) < NON_TEXT)
|
||||
.map((color) => `${color} on the ${name} card: ${contrastRatio(color, theme.card).toFixed(2)}`),
|
||||
)
|
||||
expect(low).toEqual([])
|
||||
})
|
||||
|
||||
it(`labels drawn on a colour (the treemap) reach ${TEXT}:1`, () => {
|
||||
const low = PALETTE.map((color, i) => [color, PALETTE_LABEL[i], contrastRatio(color, PALETTE_LABEL[i])])
|
||||
.filter(([, , ratio]) => ratio < TEXT)
|
||||
.map(([color, label, ratio]) => `${label} on ${color}: ${ratio.toFixed(2)}`)
|
||||
expect(low).toEqual([])
|
||||
})
|
||||
})
|
||||
@@ -20,7 +20,7 @@ SANS = FONTS / "geist" / "files" / "geist-latin-wght-normal.woff2"
|
||||
MONO = FONTS / "geist-mono" / "files" / "geist-mono-latin-wght-normal.woff2"
|
||||
|
||||
# Same values as the dark theme tokens in src/index.css.
|
||||
ACCENT = (124, 92, 255) # --primary #7c5cff
|
||||
ACCENT = (124, 92, 255) # --brand #7c5cff (the logo purple; buttons use the darker --primary)
|
||||
BG = (11, 11, 12) # --background #0b0b0c
|
||||
TEXT = (237, 237, 239) # --foreground
|
||||
MUTED = (155, 155, 164) # --muted-foreground
|
||||
|
||||
Generated
+327
-173
File diff suppressed because it is too large.
Load diff
@@ -1,6 +1,6 @@
|
||||
[package]
|
||||
name = "free-games-itchio-webapp"
|
||||
version = "4.4.3"
|
||||
version = "4.6.2"
|
||||
description = "Itch.io free games catalog viewer"
|
||||
authors = ["poli0981"]
|
||||
license = "MIT"
|
||||
@@ -19,7 +19,6 @@ tauri-build = { version = "2", features = [] }
|
||||
tauri = { version = "2", features = [] }
|
||||
tauri-plugin-opener = "2"
|
||||
serde = { version = "1", features = ["derive"] }
|
||||
serde_json = "1"
|
||||
|
||||
[target.'cfg(not(any(target_os = "android", target_os = "ios")))'.dependencies]
|
||||
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",
|
||||
"productName": "Itch.io Free Games DB",
|
||||
"version": "4.4.3",
|
||||
"version": "4.6.2",
|
||||
"identifier": "com.poli0981.freegamesitchio",
|
||||
"build": {
|
||||
"beforeDevCommand": "npm run dev",
|
||||
|
||||
+69
-11
@@ -1,5 +1,12 @@
|
||||
import { lazy, Suspense, useEffect, useLayoutEffect, useRef } from 'react'
|
||||
import { Navigate, Routes, Route, useLocation, useNavigationType } from 'react-router'
|
||||
import {
|
||||
focusElement,
|
||||
focusUntouchedSince,
|
||||
pageHeading,
|
||||
scrollBehavior,
|
||||
whenPresent,
|
||||
} from '@/components/focus-target'
|
||||
import { LegalGate } from '@/components/legal-gate'
|
||||
import { NsfwDialog } from '@/components/nsfw-dialog'
|
||||
import ScrollToTop from '@/components/scroll-to-top'
|
||||
@@ -13,6 +20,7 @@ import { useScrollbarsEffect } from '@/hooks/useScrollbarsEffect'
|
||||
import { useBackButton } from '@/hooks/useBackButton'
|
||||
import { useSeoHead } from '@/hooks/useSeoHead'
|
||||
import { useT } from '@/lib/i18n'
|
||||
import { hashId, routeFocusTarget, type RouteSpot } from '@/lib/route-focus'
|
||||
import Welcome from '@/routes/welcome'
|
||||
import Games from '@/routes/games'
|
||||
import NotFound from '@/routes/not-found'
|
||||
@@ -26,8 +34,10 @@ const Suggest = lazy(() => import('@/routes/suggest'))
|
||||
const ErrorPreview = lazy(() => import('@/routes/error-preview'))
|
||||
|
||||
function RouteFallback() {
|
||||
const t = useT()
|
||||
return (
|
||||
<div className="mx-auto max-w-[1120px] space-y-3 px-4 pt-8 sm:px-8">
|
||||
<div role="status" className="mx-auto max-w-[1120px] space-y-3 px-4 pt-8 sm:px-8">
|
||||
<span className="sr-only">{t('common.loading')}</span>
|
||||
<Skeleton className="h-8 w-48" />
|
||||
<Skeleton className="h-[60vh]" />
|
||||
</div>
|
||||
@@ -39,36 +49,84 @@ function RouteFallback() {
|
||||
* (a link, the Games pager) starts at the top; a #hash scrolls to its section.
|
||||
* Replaced entries (Games filters, typed searches) keep the position. The
|
||||
* browser's own restoration is off: it runs before React renders.
|
||||
*
|
||||
* Focus follows the page (lib/route-focus.ts): after a page change it moves
|
||||
* to the new h1 (Back: to the link that was used there, e.g. the game row),
|
||||
* after a #hash to that section — waiting for lazy routes to render.
|
||||
*/
|
||||
function ScrollManager() {
|
||||
const { key, pathname, hash } = useLocation()
|
||||
const { key, pathname, search, hash } = useLocation()
|
||||
const navigationType = useNavigationType()
|
||||
const positions = useRef(new Map<string, number>())
|
||||
const lastLinks = useRef(new Map<string, string>())
|
||||
const currentKey = useRef(key)
|
||||
const lastPath = useRef(pathname)
|
||||
const lastSpot = useRef<RouteSpot | null>(null)
|
||||
|
||||
useEffect(() => {
|
||||
if ('scrollRestoration' in window.history) window.history.scrollRestoration = 'manual'
|
||||
// The key is switched in the layout effect below, before any scroll event of the new page.
|
||||
const save = () => positions.current.set(currentKey.current, window.scrollY)
|
||||
// The last link focused inside the page, so Back can return there.
|
||||
const remember = (e: FocusEvent) => {
|
||||
const el = e.target
|
||||
if (!(el instanceof HTMLAnchorElement) || !el.closest('#main')) return
|
||||
const href = el.getAttribute('href')
|
||||
if (href) lastLinks.current.set(currentKey.current, href)
|
||||
}
|
||||
window.addEventListener('scroll', save, { passive: true })
|
||||
return () => window.removeEventListener('scroll', save)
|
||||
document.addEventListener('focusin', remember)
|
||||
return () => {
|
||||
window.removeEventListener('scroll', save)
|
||||
document.removeEventListener('focusin', remember)
|
||||
}
|
||||
}, [])
|
||||
|
||||
useLayoutEffect(() => {
|
||||
currentKey.current = key
|
||||
const saved = positions.current.get(key)
|
||||
if (navigationType === 'POP' && saved !== undefined) {
|
||||
const sectionId = hashId(hash)
|
||||
const cancels: (() => void)[] = []
|
||||
const target = routeFocusTarget(lastSpot.current, { pathname, search, hash })
|
||||
lastSpot.current = { pathname, search, hash }
|
||||
const before = document.activeElement
|
||||
const focus = (el: HTMLElement) => {
|
||||
if (focusUntouchedSince(before)) focusElement(el)
|
||||
}
|
||||
const focusHeading = () => {
|
||||
const main = document.getElementById('main')
|
||||
cancels.push(whenPresent(pageHeading, focus, { missing: () => main && focus(main) }))
|
||||
}
|
||||
|
||||
const restore = navigationType === 'POP' && saved !== undefined
|
||||
if (restore) {
|
||||
window.scrollTo(0, saved)
|
||||
} else if (hash) {
|
||||
requestAnimationFrame(() =>
|
||||
document.getElementById(hash.slice(1))?.scrollIntoView({ behavior: 'smooth', block: 'start' }),
|
||||
)
|
||||
} else if (navigationType === 'PUSH' || pathname !== lastPath.current) {
|
||||
} else if (!sectionId && (navigationType === 'PUSH' || pathname !== lastPath.current)) {
|
||||
window.scrollTo(0, 0)
|
||||
}
|
||||
lastPath.current = pathname
|
||||
}, [key, pathname, hash, navigationType])
|
||||
|
||||
if (sectionId && (!restore || target?.kind === 'hash')) {
|
||||
cancels.push(
|
||||
whenPresent(
|
||||
() => document.getElementById(sectionId),
|
||||
(el) => {
|
||||
if (!restore) el.scrollIntoView({ behavior: scrollBehavior(), block: 'start' })
|
||||
if (target?.kind === 'hash') focus(el)
|
||||
},
|
||||
),
|
||||
)
|
||||
} else if (target?.kind === 'heading') {
|
||||
const href = navigationType === 'POP' ? lastLinks.current.get(key) : undefined
|
||||
if (href) {
|
||||
const link = () => document.querySelector<HTMLAnchorElement>(`#main a[href="${CSS.escape(href)}"]`)
|
||||
cancels.push(whenPresent(link, focus, { timeout: 2000, missing: focusHeading }))
|
||||
} else {
|
||||
focusHeading()
|
||||
}
|
||||
}
|
||||
return () => cancels.forEach((cancel) => cancel())
|
||||
}, [key, pathname, search, hash, navigationType])
|
||||
|
||||
return null
|
||||
}
|
||||
@@ -99,7 +157,7 @@ export default function App() {
|
||||
<ScrollManager />
|
||||
<SkipToContent />
|
||||
<SiteHeader />
|
||||
<main id="main" tabIndex={-1} className="flex-1 outline-hidden">
|
||||
<main id="main" tabIndex={-1} className="flex-1 outline-none">
|
||||
<RouteErrorBoundary>
|
||||
<Suspense fallback={<RouteFallback />}>
|
||||
<Routes>
|
||||
|
||||
@@ -1,11 +1,12 @@
|
||||
import { useMemo } from 'react'
|
||||
import { Bar, BarChart, CartesianGrid, ResponsiveContainer, Tooltip, XAxis, YAxis } from 'recharts'
|
||||
import { countByArray, topN } from '@/lib/analytics'
|
||||
import { tableRows } from '@/lib/chart-table'
|
||||
import { useFormat } from '@/lib/format'
|
||||
import { useT } from '@/lib/i18n'
|
||||
import type { Game } from '@/types/game'
|
||||
import { ChartCard } from './chart-card'
|
||||
import { BAR_CURSOR, SERIES_ANIMATION, TOOLTIP_BASE, truncateLabel } from './chart-theme'
|
||||
import { BAR_CURSOR, chartAria, SERIES_ANIMATION, TOOLTIP_BASE, truncateLabel } from './chart-theme'
|
||||
import { ChartTooltipContent } from './chart-tooltip'
|
||||
import { PALETTE } from './palette'
|
||||
|
||||
@@ -14,12 +15,21 @@ export function AccessibilityChart({ games }: { games: Game[] }) {
|
||||
const fmt = useFormat()
|
||||
const data = useMemo(() => topN(countByArray(games, 'accessibility'), 10), [games])
|
||||
return (
|
||||
<ChartCard title={t('charts.accessibility.title')} description={t('charts.accessibility.desc')}>
|
||||
<ChartCard
|
||||
id="accessibility"
|
||||
title={t('charts.accessibility.title')}
|
||||
description={t('charts.accessibility.desc')}
|
||||
table={
|
||||
data.length
|
||||
? { label: t('games.filter.access'), value: t('charts.series.games'), rows: tableRows(data) }
|
||||
: undefined
|
||||
}
|
||||
>
|
||||
{data.length === 0 ? (
|
||||
<p className="flex h-full items-center justify-center text-sm text-muted-foreground">{t('charts.empty')}</p>
|
||||
) : (
|
||||
<ResponsiveContainer width="100%" height="100%">
|
||||
<BarChart data={data} layout="vertical" margin={{ left: 20 }}>
|
||||
<BarChart {...chartAria('accessibility')} data={data} layout="vertical" margin={{ left: 20 }}>
|
||||
<CartesianGrid horizontal={false} strokeDasharray="3 3" />
|
||||
<XAxis type="number" allowDecimals={false} tickFormatter={fmt.number} />
|
||||
<YAxis
|
||||
|
||||
@@ -1,11 +1,12 @@
|
||||
import { useMemo } from 'react'
|
||||
import { Bar, BarChart, CartesianGrid, ResponsiveContainer, Tooltip, XAxis, YAxis } from 'recharts'
|
||||
import { countByArray } from '@/lib/analytics'
|
||||
import { tableRows } from '@/lib/chart-table'
|
||||
import { useFormat } from '@/lib/format'
|
||||
import { useT } from '@/lib/i18n'
|
||||
import type { Game } from '@/types/game'
|
||||
import { ChartCard } from './chart-card'
|
||||
import { BAR_CURSOR, SERIES_ANIMATION, TOOLTIP_BASE } from './chart-theme'
|
||||
import { BAR_CURSOR, chartAria, SERIES_ANIMATION, TOOLTIP_BASE } from './chart-theme'
|
||||
import { ChartTooltipContent } from './chart-tooltip'
|
||||
import { PALETTE } from './palette'
|
||||
|
||||
@@ -15,12 +16,21 @@ export function AiContentChart({ games }: { games: Game[] }) {
|
||||
const fmt = useFormat()
|
||||
const data = useMemo(() => countByArray(games, 'ai_content'), [games])
|
||||
return (
|
||||
<ChartCard title={t('charts.aiContent.title')} description={t('charts.aiContent.desc')}>
|
||||
<ChartCard
|
||||
id="ai-content"
|
||||
title={t('charts.aiContent.title')}
|
||||
description={t('charts.aiContent.desc')}
|
||||
table={
|
||||
data.length
|
||||
? { label: t('charts.table.use'), value: t('charts.series.games'), rows: tableRows(data) }
|
||||
: undefined
|
||||
}
|
||||
>
|
||||
{data.length === 0 ? (
|
||||
<p className="flex h-full items-center justify-center text-sm text-muted-foreground">{t('charts.empty')}</p>
|
||||
) : (
|
||||
<ResponsiveContainer width="100%" height="100%">
|
||||
<BarChart data={data} layout="vertical" margin={{ left: 20 }}>
|
||||
<BarChart {...chartAria('ai-content')} data={data} layout="vertical" margin={{ left: 20 }}>
|
||||
<CartesianGrid horizontal={false} strokeDasharray="3 3" />
|
||||
<XAxis type="number" allowDecimals={false} tickFormatter={fmt.number} />
|
||||
<YAxis dataKey="key" type="category" width={100} interval={0} tick={{ fontSize: 12 }} />
|
||||
|
||||
@@ -1,12 +1,13 @@
|
||||
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 { aiDisclosureCounts } from '@/lib/analytics'
|
||||
import { tableRows } from '@/lib/chart-table'
|
||||
import { AI_ASSISTED, AI_NONE, AI_UNDISCLOSED } from '@/lib/game-filters'
|
||||
import { useT } from '@/lib/i18n'
|
||||
import type { Game } from '@/types/game'
|
||||
import { ChartCard } from './chart-card'
|
||||
import { 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 { NEUTRAL, PALETTE } from './palette'
|
||||
|
||||
@@ -20,16 +21,34 @@ const COLOR: Record<string, string> = {
|
||||
export function AiDisclosureChart({ games }: { games: Game[] }) {
|
||||
const t = useT()
|
||||
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],
|
||||
)
|
||||
const total = data.reduce((sum, d) => sum + d.count, 0)
|
||||
return (
|
||||
<ChartCard title={t('charts.ai.title')} description={t('charts.ai.desc')}>
|
||||
<ChartCard
|
||||
id="ai-disclosure"
|
||||
title={t('charts.ai.title')}
|
||||
description={t('charts.ai.desc')}
|
||||
table={{
|
||||
label: t('games.filter.ai'),
|
||||
value: t('charts.series.games'),
|
||||
rows: tableRows(
|
||||
data.map((d) => ({ key: d.label, count: d.count })),
|
||||
total,
|
||||
),
|
||||
}}
|
||||
>
|
||||
<ResponsiveContainer width="100%" height="100%">
|
||||
<PieChart>
|
||||
<PieChart {...chartAria('ai-disclosure')}>
|
||||
<Pie
|
||||
{...SERIES_ANIMATION}
|
||||
rootTabIndex={-1}
|
||||
data={data}
|
||||
dataKey="count"
|
||||
nameKey="label"
|
||||
@@ -37,11 +56,7 @@ export function AiDisclosureChart({ games }: { games: Game[] }) {
|
||||
outerRadius="80%"
|
||||
paddingAngle={2}
|
||||
stroke={SLICE_STROKE}
|
||||
>
|
||||
{data.map((d) => (
|
||||
<Cell key={d.key} fill={COLOR[d.key] ?? PALETTE[8]} />
|
||||
))}
|
||||
</Pie>
|
||||
/>
|
||||
<Tooltip {...TOOLTIP_BASE} content={<ChartTooltipContent total={total} />} />
|
||||
{/* In the data's order: no AI, AI-assisted, not disclosed. */}
|
||||
<Legend {...LEGEND_BASE} />
|
||||
|
||||
@@ -1,12 +1,13 @@
|
||||
import { useMemo } from 'react'
|
||||
import { Bar, BarChart, CartesianGrid, ResponsiveContainer, Tooltip, XAxis, YAxis } from 'recharts'
|
||||
import { countBy, topN } from '@/lib/analytics'
|
||||
import { tableRows } from '@/lib/chart-table'
|
||||
import { useFormat } from '@/lib/format'
|
||||
import { useT } from '@/lib/i18n'
|
||||
import { useIsMobile } from '@/lib/use-is-mobile'
|
||||
import type { Game } from '@/types/game'
|
||||
import { ChartCard } from './chart-card'
|
||||
import { BAR_CURSOR, SERIES_ANIMATION, singleLineTick, TOOLTIP_BASE, truncateLabel } from './chart-theme'
|
||||
import { BAR_CURSOR, chartAria, SERIES_ANIMATION, singleLineTick, TOOLTIP_BASE, truncateLabel } from './chart-theme'
|
||||
import { ChartTooltipContent } from './chart-tooltip'
|
||||
import { PALETTE } from './palette'
|
||||
|
||||
@@ -17,9 +18,13 @@ export function AvgSessionChart({ games }: { games: Game[] }) {
|
||||
const isMobile = useIsMobile()
|
||||
const data = useMemo(() => topN(countBy(games, 'average_session'), 8), [games])
|
||||
return (
|
||||
<ChartCard title={t('charts.avgSession.title')}>
|
||||
<ChartCard
|
||||
id="avg-session"
|
||||
title={t('charts.avgSession.title')}
|
||||
table={{ label: t('detail.avgSession'), value: t('charts.series.games'), rows: tableRows(data) }}
|
||||
>
|
||||
<ResponsiveContainer width="100%" height="100%">
|
||||
<BarChart data={data} layout={isMobile ? 'vertical' : 'horizontal'}>
|
||||
<BarChart {...chartAria('avg-session')} data={data} layout={isMobile ? 'vertical' : 'horizontal'}>
|
||||
<CartesianGrid horizontal={!isMobile} strokeDasharray="3 3" />
|
||||
{isMobile ? (
|
||||
<XAxis type="number" allowDecimals={false} tickFormatter={fmt.number} />
|
||||
|
||||
@@ -1,21 +1,68 @@
|
||||
import { useCallback, useRef, useState, type ReactNode } from 'react'
|
||||
import { Card, CardContent, CardHeader, CardTitle } from '@/components/ui/card'
|
||||
import type { TableRow } from '@/lib/chart-table'
|
||||
import { useFormat } from '@/lib/format'
|
||||
import { useT } from '@/lib/i18n'
|
||||
import { cn } from '@/lib/utils'
|
||||
import { ChartAnnounce, chartIds } from './chart-theme'
|
||||
|
||||
interface ChartCardProps {
|
||||
title: string
|
||||
description?: string
|
||||
/** Extra classes for the chart area, e.g. a taller one on phones (`max-md:h-96`). */
|
||||
contentClassName?: string
|
||||
children: React.ReactNode
|
||||
/** The chart's numbers as a table under it (lib/chart-table.ts builds the rows). */
|
||||
interface ChartTableData {
|
||||
/** Heading of the first column (what each row is: genre, date, …). */
|
||||
label: string
|
||||
/** Heading of the value column (games, ratings, removed). */
|
||||
value: string
|
||||
rows: readonly TableRow[]
|
||||
/** Formats the first column, e.g. an ISO date. */
|
||||
formatKey?: (key: string) => string
|
||||
}
|
||||
|
||||
export function ChartCard({ title, description, contentClassName, children }: ChartCardProps) {
|
||||
interface ChartCardProps {
|
||||
/** Unique on the page: the ids of the heading, description and hint derive from it (chartAria). */
|
||||
id: string
|
||||
title: string
|
||||
description?: string
|
||||
/** The same data as a table, for screen readers and anyone who'd rather read numbers. */
|
||||
table?: ChartTableData
|
||||
/** Recharts charts you can step through with the arrow keys (not the list cards or the treemap). */
|
||||
keyboard?: boolean
|
||||
/** Extra classes for the chart area, e.g. a taller one on phones (`max-md:h-96`). */
|
||||
contentClassName?: string
|
||||
children: ReactNode
|
||||
}
|
||||
|
||||
export function ChartCard({
|
||||
id,
|
||||
title,
|
||||
description,
|
||||
table,
|
||||
keyboard = true,
|
||||
contentClassName,
|
||||
children,
|
||||
}: ChartCardProps) {
|
||||
const t = useT()
|
||||
const ids = chartIds(id)
|
||||
// The tooltip's text goes straight into the live region: no state, so hovering
|
||||
// never re-renders the card or the chart in it (charts stay mounted, gotcha 33).
|
||||
const live = useRef<HTMLParagraphElement>(null)
|
||||
const announce = useCallback((text: string) => {
|
||||
if (live.current && live.current.textContent !== text) live.current.textContent = text
|
||||
}, [])
|
||||
return (
|
||||
<Card>
|
||||
<CardHeader>
|
||||
<CardTitle className="text-base">{title}</CardTitle>
|
||||
<CardTitle id={ids.title} className="text-base">
|
||||
{title}
|
||||
</CardTitle>
|
||||
{description && (
|
||||
<p className="text-xs text-muted-foreground">{description}</p>
|
||||
<p id={ids.desc} className="text-xs text-muted-foreground">
|
||||
{description}
|
||||
</p>
|
||||
)}
|
||||
{keyboard && (
|
||||
<p id={ids.keys} className="sr-only">
|
||||
{t('charts.a11y.keys')}
|
||||
</p>
|
||||
)}
|
||||
</CardHeader>
|
||||
{/* Recharts 3 makes the chart focusable (keyboard navigation). A mouse
|
||||
@@ -29,8 +76,66 @@ export function ChartCard({ title, description, contentClassName, children }: Ch
|
||||
if ((e.target as Element).closest('.recharts-wrapper')) e.preventDefault()
|
||||
}}
|
||||
>
|
||||
{children}
|
||||
<ChartAnnounce.Provider value={announce}>{children}</ChartAnnounce.Provider>
|
||||
<p ref={live} className="sr-only" aria-live="polite" aria-atomic="true" />
|
||||
</CardContent>
|
||||
{table && <ChartTable title={title} {...table} />}
|
||||
</Card>
|
||||
)
|
||||
}
|
||||
|
||||
/** A closed <details> under the chart; the table is only built once it is opened. */
|
||||
function ChartTable({ title, label, value, rows, formatKey }: ChartTableData & { title: string }) {
|
||||
const t = useT()
|
||||
const fmt = useFormat()
|
||||
const [open, setOpen] = useState(false)
|
||||
const shares = rows.some((row) => row.share !== null)
|
||||
return (
|
||||
<details className="border-t px-5 py-3 text-sm" onToggle={(e) => setOpen(e.currentTarget.open)}>
|
||||
<summary className="cursor-pointer text-xs font-medium text-muted-foreground hover:text-foreground">
|
||||
{t('charts.table.show')}
|
||||
</summary>
|
||||
{open && (
|
||||
// Scrolls on its own (the game count has a row per day). A scrolling area with nothing focusable
|
||||
// inside must take focus itself, or the keyboard can't scroll it (WCAG 2.1.1; axe's
|
||||
// scrollable-region-focusable): the labelled region + tabIndex 0 pattern. Sonar's S6845
|
||||
// (no tabIndex on non-interactive elements) doesn't know that exception.
|
||||
<div tabIndex={0} /* NOSONAR */ role="region" aria-label={title} className="mt-2 max-h-72 overflow-y-auto">
|
||||
<table className="w-full border-collapse text-xs">
|
||||
<caption className="sr-only">{title}</caption>
|
||||
<thead className="sticky top-0 bg-card text-muted-foreground">
|
||||
<tr className="border-b">
|
||||
<th scope="col" className="py-1.5 pr-3 text-left font-medium">
|
||||
{label}
|
||||
</th>
|
||||
<th scope="col" className="py-1.5 pl-3 text-right font-medium">
|
||||
{value}
|
||||
</th>
|
||||
{shares && (
|
||||
<th scope="col" className="py-1.5 pl-3 text-right font-medium">
|
||||
{t('charts.table.share')}
|
||||
</th>
|
||||
)}
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
{rows.map((row) => (
|
||||
<tr key={row.key} className="border-b last:border-b-0">
|
||||
<th scope="row" className="py-1.5 pr-3 text-left font-normal">
|
||||
{formatKey ? formatKey(row.key) : row.key}
|
||||
</th>
|
||||
<td className="py-1.5 pl-3 text-right font-mono tabular-nums">{fmt.number(row.count)}</td>
|
||||
{shares && (
|
||||
<td className="py-1.5 pl-3 text-right font-mono tabular-nums">
|
||||
{row.share === null ? '' : fmt.percent(row.share)}
|
||||
</td>
|
||||
)}
|
||||
</tr>
|
||||
))}
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
)}
|
||||
</details>
|
||||
)
|
||||
}
|
||||
@@ -1,11 +1,15 @@
|
||||
import { Card, CardContent, CardHeader } from '@/components/ui/card'
|
||||
import { Skeleton } from '@/components/ui/skeleton'
|
||||
import { useT } from '@/lib/i18n'
|
||||
import { cn } from '@/lib/utils'
|
||||
|
||||
export type ChartTab = 'overview' | 'reach' | 'quality' | 'discovery'
|
||||
|
||||
/** A ChartCard while its tab loads: the same header lines and chart area, so nothing moves when it arrives. */
|
||||
function CardSkeleton({ described, tall }: { described: boolean; tall?: boolean }) {
|
||||
/**
|
||||
* A ChartCard while its tab loads: the same header lines, chart area and "Data table"
|
||||
* line, so nothing moves when it arrives.
|
||||
*/
|
||||
function CardSkeleton({ described, tall, table }: CardShape) {
|
||||
return (
|
||||
<Card>
|
||||
<CardHeader>
|
||||
@@ -15,6 +19,11 @@ function CardSkeleton({ described, tall }: { described: boolean; tall?: boolean
|
||||
<CardContent className={cn('h-72', tall && 'max-md:h-96')}>
|
||||
<Skeleton className="h-full w-full" />
|
||||
</CardContent>
|
||||
{table && (
|
||||
<div className="border-t px-5 py-3">
|
||||
<Skeleton className="h-4 w-24" />
|
||||
</div>
|
||||
)}
|
||||
</Card>
|
||||
)
|
||||
}
|
||||
@@ -34,17 +43,31 @@ function KpiSkeleton() {
|
||||
)
|
||||
}
|
||||
|
||||
// Each tab's cards in order: with a description line or not; the Genres chart is taller on phones.
|
||||
const LAYOUT: Record<ChartTab, { described: boolean; tall?: boolean }[]> = {
|
||||
overview: [{ described: true, tall: true }, ...Array.from({ length: 5 }, () => ({ described: true }))],
|
||||
reach: [{ described: true }, { described: false }, { described: false }, { described: true }],
|
||||
quality: Array.from({ length: 4 }, () => ({ described: true })),
|
||||
discovery: Array.from({ length: 4 }, () => ({ described: true })),
|
||||
interface CardShape {
|
||||
described: boolean
|
||||
tall?: boolean
|
||||
table?: boolean
|
||||
}
|
||||
|
||||
// Each tab's cards in order: with a description line or not, with a data table or not
|
||||
// (all but the list of recent deletions); the Genres chart is taller on phones.
|
||||
const LAYOUT: Record<ChartTab, CardShape[]> = {
|
||||
overview: [{ described: true, tall: true, table: true }, ...Array.from({ length: 5 }, () => ({ described: true, table: true }))],
|
||||
reach: [
|
||||
{ described: true, table: true },
|
||||
{ described: false, table: true },
|
||||
{ described: false, table: true },
|
||||
{ described: true },
|
||||
],
|
||||
quality: Array.from({ length: 4 }, () => ({ described: true, table: true })),
|
||||
discovery: Array.from({ length: 4 }, () => ({ described: true, table: true })),
|
||||
}
|
||||
|
||||
export function TabSkeleton({ tab }: { tab: ChartTab }) {
|
||||
const t = useT()
|
||||
return (
|
||||
<div className="space-y-4" aria-busy="true">
|
||||
<div role="status" className="space-y-4" aria-busy="true">
|
||||
<span className="sr-only">{t('common.loading')}</span>
|
||||
{tab === 'overview' && <KpiSkeleton />}
|
||||
<div className="grid gap-4 md:grid-cols-2">
|
||||
{LAYOUT[tab].map((card, i) => (
|
||||
|
||||
@@ -15,3 +15,31 @@ describe('chart series', () => {
|
||||
expect(series.filter((s) => !s.animated)).toEqual([])
|
||||
})
|
||||
})
|
||||
|
||||
describe('chart accessibility', () => {
|
||||
const sources = Object.entries(CHARTS)
|
||||
|
||||
it('every chart is named after its card (chartAria)', () => {
|
||||
const containers = sources.flatMap(([file, src]) =>
|
||||
[...src.matchAll(/<(BarChart|LineChart|PieChart|Treemap)\b[^>]*?>/gs)].map((m) => ({ file, tag: m[0] })),
|
||||
)
|
||||
expect(containers.length).toBeGreaterThanOrEqual(16)
|
||||
expect(containers.filter((c) => !c.tag.includes('{...chartAria(')).map((c) => c.file)).toEqual([])
|
||||
})
|
||||
|
||||
it('pies keep one tab stop (rootTabIndex={-1})', () => {
|
||||
const pies = sources.flatMap(([file, src]) =>
|
||||
[...src.matchAll(/<Pie\b[^>]*?>/gs)].map((m) => ({ file, tag: m[0] })),
|
||||
)
|
||||
expect(pies.length).toBeGreaterThanOrEqual(6)
|
||||
expect(pies.filter((p) => !p.tag.includes('rootTabIndex={-1}')).map((p) => p.file)).toEqual([])
|
||||
})
|
||||
|
||||
it('every chart card offers its data as a table (the recent-deletions list is text already)', () => {
|
||||
const missing = sources
|
||||
.filter(([file]) => !file.includes('recent-deleted'))
|
||||
.filter(([, src]) => !src.includes('table={'))
|
||||
.map(([file]) => file)
|
||||
expect(missing).toEqual([])
|
||||
})
|
||||
})
|
||||
@@ -1,6 +1,33 @@
|
||||
// Shared Recharts props. The design tokens in index.css are hex colours, so
|
||||
// reference them as `var(--x)` — `hsl(var(--x))` is an invalid colour, which
|
||||
// SVG paints black and CSS drops (a transparent tooltip).
|
||||
import { createContext } from 'react'
|
||||
|
||||
/** Element ids inside one chart card: its heading, description and keyboard hint. */
|
||||
export function chartIds(id: string) {
|
||||
return { title: `chart-${id}-title`, desc: `chart-${id}-desc`, keys: `chart-${id}-keys` }
|
||||
}
|
||||
|
||||
/**
|
||||
* Spread on every chart (BarChart, LineChart, PieChart, Treemap). Recharts 3
|
||||
* makes the chart a focusable role="application" with an empty <title>; this
|
||||
* names it after its card's heading and describes it with the card's
|
||||
* description and, for the charts you can step through, the arrow-key hint.
|
||||
* (Recharts' own `title` prop would also show a browser tooltip.)
|
||||
*/
|
||||
export function chartAria(id: string, { keys = true }: { keys?: boolean } = {}) {
|
||||
const ids = chartIds(id)
|
||||
return {
|
||||
'aria-labelledby': ids.title,
|
||||
'aria-describedby': keys ? `${ids.desc} ${ids.keys}` : ids.desc,
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Reads a chart's tooltip out (chart-tooltip.tsx → the card's polite live
|
||||
* region): Recharts' own tooltip is a live region, a custom one isn't.
|
||||
*/
|
||||
export const ChartAnnounce = createContext<(text: string) => void>(() => {})
|
||||
|
||||
/** Every <Tooltip>: no slide-in animation, no focus outline, above the legend. */
|
||||
export const TOOLTIP_BASE = {
|
||||
|
||||
@@ -1,5 +1,7 @@
|
||||
import { useContext, useEffect } from 'react'
|
||||
import type { TooltipContentProps, TooltipPayloadEntry } from 'recharts'
|
||||
import { useFormat } from '@/lib/format'
|
||||
import { ChartAnnounce } from './chart-theme'
|
||||
|
||||
interface ChartTooltipContentProps extends Partial<Pick<TooltipContentProps, 'active' | 'payload' | 'label'>> {
|
||||
/** Sum of all slices of a pie whose slices cover the whole: adds each value's share. */
|
||||
@@ -14,26 +16,41 @@ interface ChartTooltipContentProps extends Partial<Pick<TooltipContentProps, 'ac
|
||||
* Tooltip body for every chart: popover colours from the theme tokens, a swatch
|
||||
* per series, and numbers formatted for the chosen language. Pass it as
|
||||
* `content={<ChartTooltipContent />}`; Recharts fills in active/payload/label.
|
||||
* The same text goes to the card's live region (ChartAnnounce), so stepping
|
||||
* through a chart with the arrow keys reads each value out.
|
||||
*/
|
||||
export function ChartTooltipContent({ active, payload, label, total, labelFormat, colorOf }: ChartTooltipContentProps) {
|
||||
const fmt = useFormat()
|
||||
if (!active || !payload?.length) return null
|
||||
const announce = useContext(ChartAnnounce)
|
||||
const shown = Boolean(active && payload?.length)
|
||||
const heading = label === undefined || label === '' ? '' : labelFormat ? labelFormat(String(label)) : String(label)
|
||||
const rows = (shown ? (payload ?? []) : []).map((entry) => {
|
||||
const value = Number(entry.value)
|
||||
const number = Number.isFinite(value) ? fmt.number(value) : String(entry.value ?? '')
|
||||
const share = total && Number.isFinite(value) ? ` (${fmt.percent(value / total)})` : ''
|
||||
return { entry, text: `${number}${share}` }
|
||||
})
|
||||
const spoken = rows.length
|
||||
? [heading, ...rows.map(({ entry, text }) => `${String(entry.name ?? '')} ${text}`.trim())].filter(Boolean).join(', ')
|
||||
: ''
|
||||
useEffect(() => announce(spoken), [announce, spoken])
|
||||
|
||||
if (!shown) return null
|
||||
return (
|
||||
<div className="min-w-36 rounded-md border bg-popover px-3 py-2 text-xs text-popover-foreground shadow-md">
|
||||
{heading && <p className="mb-1.5 font-medium">{heading}</p>}
|
||||
<ul className="space-y-1">
|
||||
{payload.map((entry, i) => {
|
||||
const value = Number(entry.value)
|
||||
{rows.map(({ entry, text }, i) => {
|
||||
const color = colorOf?.(entry) ?? entry.color ?? entry.fill
|
||||
return (
|
||||
<li key={`${String(entry.name)}-${i}`} className="flex items-center gap-2">
|
||||
<span aria-hidden="true" className="size-2.5 shrink-0 rounded-[3px]" style={{ background: color }} />
|
||||
<span
|
||||
aria-hidden="true"
|
||||
className="size-2.5 shrink-0 rounded-[3px] forced-color-adjust-none"
|
||||
style={{ background: color }}
|
||||
/>
|
||||
<span className="text-muted-foreground">{entry.name}</span>
|
||||
<span className="ml-auto pl-4 font-mono font-medium tabular-nums">
|
||||
{Number.isFinite(value) ? fmt.number(value) : String(entry.value ?? '')}
|
||||
{total && Number.isFinite(value) ? ` (${fmt.percent(value / total)})` : null}
|
||||
</span>
|
||||
<span className="ml-auto pl-4 font-mono font-medium tabular-nums">{text}</span>
|
||||
</li>
|
||||
)
|
||||
})}
|
||||
|
||||
@@ -1,23 +1,30 @@
|
||||
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 { tableRows } from '@/lib/chart-table'
|
||||
import { useT } from '@/lib/i18n'
|
||||
import type { DeletedGameEntry } from '@/types/game'
|
||||
import { ChartCard } from './chart-card'
|
||||
import { 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 { PALETTE } from './palette'
|
||||
import { paletteFills } from './palette'
|
||||
|
||||
export function DeletionReasonsChart({ deleted }: { deleted: DeletedGameEntry[] }) {
|
||||
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)
|
||||
return (
|
||||
<ChartCard title={t('charts.deletionReasons.title')} description={t('charts.deletionReasons.desc')}>
|
||||
<ChartCard
|
||||
id="deletion-reasons"
|
||||
title={t('charts.deletionReasons.title')}
|
||||
description={t('charts.deletionReasons.desc')}
|
||||
table={{ label: t('deleted.col.reason'), value: t('charts.series.removed'), rows: tableRows(data, total) }}
|
||||
>
|
||||
<ResponsiveContainer width="100%" height="100%">
|
||||
<PieChart>
|
||||
<PieChart {...chartAria('deletion-reasons')}>
|
||||
<Pie
|
||||
{...SERIES_ANIMATION}
|
||||
rootTabIndex={-1}
|
||||
data={data}
|
||||
dataKey="count"
|
||||
nameKey="key"
|
||||
@@ -25,11 +32,7 @@ export function DeletionReasonsChart({ deleted }: { deleted: DeletedGameEntry[]
|
||||
outerRadius="80%"
|
||||
paddingAngle={2}
|
||||
stroke={SLICE_STROKE}
|
||||
>
|
||||
{data.map((_, i) => (
|
||||
<Cell key={i} fill={PALETTE[i % PALETTE.length]} />
|
||||
))}
|
||||
</Pie>
|
||||
/>
|
||||
<Tooltip {...TOOLTIP_BASE} content={<ChartTooltipContent total={total} />} />
|
||||
<Legend {...LEGEND_BASE} />
|
||||
</PieChart>
|
||||
|
||||
@@ -1,11 +1,12 @@
|
||||
import { useMemo } from 'react'
|
||||
import { Bar, BarChart, CartesianGrid, ResponsiveContainer, Tooltip, XAxis, YAxis } from 'recharts'
|
||||
import { deletionsByMonth } from '@/lib/analytics'
|
||||
import { tableRows } from '@/lib/chart-table'
|
||||
import { useFormat } from '@/lib/format'
|
||||
import { useT } from '@/lib/i18n'
|
||||
import type { DeletedGameEntry } from '@/types/game'
|
||||
import { ChartCard } from './chart-card'
|
||||
import { BAR_CURSOR, SERIES_ANIMATION, TOOLTIP_BASE } from './chart-theme'
|
||||
import { BAR_CURSOR, chartAria, SERIES_ANIMATION, TOOLTIP_BASE } from './chart-theme'
|
||||
import { ChartTooltipContent } from './chart-tooltip'
|
||||
import { PALETTE } from './palette'
|
||||
|
||||
@@ -14,9 +15,14 @@ export function DeletionsOverTimeChart({ deleted }: { deleted: DeletedGameEntry[
|
||||
const fmt = useFormat()
|
||||
const data = useMemo(() => deletionsByMonth(deleted), [deleted])
|
||||
return (
|
||||
<ChartCard title={t('charts.deletionsOverTime.title')} description={t('charts.deletionsOverTime.desc')}>
|
||||
<ChartCard
|
||||
id="deletions-over-time"
|
||||
title={t('charts.deletionsOverTime.title')}
|
||||
description={t('charts.deletionsOverTime.desc')}
|
||||
table={{ label: t('charts.table.month'), value: t('charts.series.removed'), rows: tableRows(data) }}
|
||||
>
|
||||
<ResponsiveContainer width="100%" height="100%">
|
||||
<BarChart data={data}>
|
||||
<BarChart {...chartAria('deletions-over-time')} data={data}>
|
||||
<CartesianGrid strokeDasharray="3 3" />
|
||||
<XAxis dataKey="key" tick={{ fontSize: 10 }} interval={0} angle={-25} textAnchor="end" height={60} />
|
||||
<YAxis allowDecimals={false} tickFormatter={fmt.number} />
|
||||
|
||||
@@ -1,9 +1,10 @@
|
||||
import { CartesianGrid, Line, LineChart, ResponsiveContainer, Tooltip, XAxis, YAxis } from 'recharts'
|
||||
import { historyRows } from '@/lib/chart-table'
|
||||
import { useFormat } from '@/lib/format'
|
||||
import { useT } from '@/lib/i18n'
|
||||
import type { CountHistoryPoint } from '@/types/game'
|
||||
import { ChartCard } from './chart-card'
|
||||
import { LINE_CURSOR, SERIES_ANIMATION, TOOLTIP_BASE } from './chart-theme'
|
||||
import { chartAria, LINE_CURSOR, SERIES_ANIMATION, TOOLTIP_BASE } from './chart-theme'
|
||||
import { ChartTooltipContent } from './chart-tooltip'
|
||||
import { PALETTE } from './palette'
|
||||
|
||||
@@ -11,14 +12,28 @@ export function GameCountChart({ history }: { history: CountHistoryPoint[] }) {
|
||||
const t = useT()
|
||||
const fmt = useFormat()
|
||||
return (
|
||||
<ChartCard title={t('charts.gameCount.title')} description={t('charts.gameCount.desc')}>
|
||||
<ChartCard
|
||||
id="game-count"
|
||||
title={t('charts.gameCount.title')}
|
||||
description={t('charts.gameCount.desc')}
|
||||
table={
|
||||
history.length
|
||||
? {
|
||||
label: t('charts.table.date'),
|
||||
value: t('charts.series.games'),
|
||||
rows: historyRows(history),
|
||||
formatKey: fmt.date,
|
||||
}
|
||||
: undefined
|
||||
}
|
||||
>
|
||||
{history.length === 0 ? (
|
||||
<p className="flex h-full items-center justify-center text-sm text-muted-foreground">
|
||||
{t('charts.gameCount.empty')}
|
||||
</p>
|
||||
) : (
|
||||
<ResponsiveContainer width="100%" height="100%">
|
||||
<LineChart data={history} margin={{ left: 4, right: 8 }}>
|
||||
<LineChart {...chartAria('game-count')} data={history} margin={{ left: 4, right: 8 }}>
|
||||
<CartesianGrid strokeDasharray="3 3" />
|
||||
<XAxis dataKey="date" tick={{ fontSize: 10 }} minTickGap={24} />
|
||||
<YAxis
|
||||
|
||||
@@ -1,11 +1,12 @@
|
||||
import { useMemo } from 'react'
|
||||
import { Bar, BarChart, CartesianGrid, ResponsiveContainer, Tooltip, XAxis, YAxis } from 'recharts'
|
||||
import { countBy, topN } from '@/lib/analytics'
|
||||
import { tableRows } from '@/lib/chart-table'
|
||||
import { useFormat } from '@/lib/format'
|
||||
import { useT } from '@/lib/i18n'
|
||||
import type { Game } from '@/types/game'
|
||||
import { ChartCard } from './chart-card'
|
||||
import { BAR_CURSOR, SERIES_ANIMATION, singleLineTick, TOOLTIP_BASE } from './chart-theme'
|
||||
import { BAR_CURSOR, chartAria, SERIES_ANIMATION, singleLineTick, TOOLTIP_BASE } from './chart-theme'
|
||||
import { ChartTooltipContent } from './chart-tooltip'
|
||||
import { PALETTE } from './palette'
|
||||
|
||||
@@ -15,9 +16,15 @@ export function GenreChart({ games }: { games: Game[] }) {
|
||||
const data = useMemo(() => topN(countBy(games, 'genre'), 15), [games])
|
||||
return (
|
||||
// Taller on phones, where the cards stack: 15 rows get room to breathe.
|
||||
<ChartCard title={t('charts.genre.title')} description={t('charts.genre.desc')} contentClassName="max-md:h-96">
|
||||
<ChartCard
|
||||
id="genre"
|
||||
title={t('charts.genre.title')}
|
||||
description={t('charts.genre.desc')}
|
||||
contentClassName="max-md:h-96"
|
||||
table={{ label: t('games.filter.genre'), value: t('charts.series.games'), rows: tableRows(data) }}
|
||||
>
|
||||
<ResponsiveContainer width="100%" height="100%">
|
||||
<BarChart data={data} layout="vertical" margin={{ left: 20 }}>
|
||||
<BarChart {...chartAria('genre')} data={data} layout="vertical" margin={{ left: 20 }}>
|
||||
<CartesianGrid horizontal={false} strokeDasharray="3 3" />
|
||||
<XAxis type="number" tickFormatter={fmt.number} />
|
||||
{/* interval 0: every label. The default drops those whose line box doesn't
|
||||
|
||||
@@ -1,12 +1,13 @@
|
||||
import { useMemo } from 'react'
|
||||
import { useMemo, type ComponentProps } from 'react'
|
||||
import { ResponsiveContainer, Tooltip, Treemap, type TooltipPayloadEntry } from 'recharts'
|
||||
import { genreTreemapData } from '@/lib/analytics'
|
||||
import { treemapRows } from '@/lib/chart-table'
|
||||
import { useT } from '@/lib/i18n'
|
||||
import type { Game } from '@/types/game'
|
||||
import { ChartCard } from './chart-card'
|
||||
import { SERIES_ANIMATION, TOOLTIP_BASE, truncateLabel } from './chart-theme'
|
||||
import { chartAria, SERIES_ANIMATION, TOOLTIP_BASE, truncateLabel } from './chart-theme'
|
||||
import { ChartTooltipContent } from './chart-tooltip'
|
||||
import { PALETTE } from './palette'
|
||||
import { PALETTE, PALETTE_LABEL } from './palette'
|
||||
|
||||
interface TreemapCellProps {
|
||||
x?: number
|
||||
@@ -41,7 +42,7 @@ function TreemapCell(props: TreemapCellProps) {
|
||||
strokeWidth={2}
|
||||
/>
|
||||
{label && height > 24 && (
|
||||
<text x={x + 6} y={y + 18} fill="var(--background)" fontSize={12} fontWeight={600}>
|
||||
<text x={x + 6} y={y + 18} fill={PALETTE_LABEL[index % PALETTE.length]} fontSize={12} fontWeight={600}>
|
||||
{label}
|
||||
</text>
|
||||
)}
|
||||
@@ -60,11 +61,25 @@ export function GenreTreemapChart({ games }: { games: Game[] }) {
|
||||
const data = useMemo(() => genreTreemapData(games, 12), [games])
|
||||
// Recharts' Treemap data prop demands an index signature; our typed nodes
|
||||
// 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 (
|
||||
<ChartCard title={t('charts.genreTreemap.title')} description={t('charts.genreTreemap.desc')}>
|
||||
// The treemap can't be stepped through with the keyboard: its table (and the Genres chart) carry the numbers.
|
||||
<ChartCard
|
||||
id="genre-treemap"
|
||||
title={t('charts.genreTreemap.title')}
|
||||
description={t('charts.genreTreemap.desc')}
|
||||
keyboard={false}
|
||||
table={{ label: t('games.filter.genre'), value: t('charts.series.games'), rows: treemapRows(data) }}
|
||||
>
|
||||
<ResponsiveContainer width="100%" height="100%">
|
||||
<Treemap {...SERIES_ANIMATION} data={treemapData} dataKey="size" nameKey="name" content={<TreemapCell />}>
|
||||
<Treemap
|
||||
{...SERIES_ANIMATION}
|
||||
{...chartAria('genre-treemap', { keys: false })}
|
||||
data={treemapData}
|
||||
dataKey="size"
|
||||
nameKey="name"
|
||||
content={<TreemapCell />}
|
||||
>
|
||||
<Tooltip {...TOOLTIP_BASE} content={<ChartTooltipContent colorOf={cellColor} />} />
|
||||
</Treemap>
|
||||
</ResponsiveContainer>
|
||||
|
||||
@@ -1,12 +1,13 @@
|
||||
import { useMemo } from 'react'
|
||||
import { Bar, BarChart, CartesianGrid, ResponsiveContainer, Tooltip, XAxis, YAxis } from 'recharts'
|
||||
import { countByArray, topN } from '@/lib/analytics'
|
||||
import { tableRows } from '@/lib/chart-table'
|
||||
import { useFormat } from '@/lib/format'
|
||||
import { useT } from '@/lib/i18n'
|
||||
import { useIsMobile } from '@/lib/use-is-mobile'
|
||||
import type { Game } from '@/types/game'
|
||||
import { ChartCard } from './chart-card'
|
||||
import { BAR_CURSOR, SERIES_ANIMATION, singleLineTick, TOOLTIP_BASE, truncateLabel } from './chart-theme'
|
||||
import { BAR_CURSOR, chartAria, SERIES_ANIMATION, singleLineTick, TOOLTIP_BASE, truncateLabel } from './chart-theme'
|
||||
import { ChartTooltipContent } from './chart-tooltip'
|
||||
import { PALETTE } from './palette'
|
||||
|
||||
@@ -17,9 +18,13 @@ export function LanguagesChart({ games }: { games: Game[] }) {
|
||||
const isMobile = useIsMobile()
|
||||
const data = useMemo(() => topN(countByArray(games, 'languages'), 10), [games])
|
||||
return (
|
||||
<ChartCard title={t('charts.languages.title')}>
|
||||
<ChartCard
|
||||
id="languages"
|
||||
title={t('charts.languages.title')}
|
||||
table={{ label: t('games.filter.lang'), value: t('charts.series.games'), rows: tableRows(data) }}
|
||||
>
|
||||
<ResponsiveContainer width="100%" height="100%">
|
||||
<BarChart data={data} layout={isMobile ? 'vertical' : 'horizontal'}>
|
||||
<BarChart {...chartAria('languages')} data={data} layout={isMobile ? 'vertical' : 'horizontal'}>
|
||||
<CartesianGrid horizontal={!isMobile} strokeDasharray="3 3" />
|
||||
{isMobile ? (
|
||||
<XAxis type="number" allowDecimals={false} tickFormatter={fmt.number} />
|
||||
|
||||
@@ -1,22 +1,29 @@
|
||||
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 { tableRows } from '@/lib/chart-table'
|
||||
import { useT } from '@/lib/i18n'
|
||||
import type { Game } from '@/types/game'
|
||||
import { ChartCard } from './chart-card'
|
||||
import { 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 { PALETTE } from './palette'
|
||||
import { paletteFills } from './palette'
|
||||
|
||||
export function MadeWithChart({ games }: { games: Game[] }) {
|
||||
const t = useT()
|
||||
const data = useMemo(() => topMadeWith(games, 8), [games])
|
||||
const data = useMemo(() => paletteFills(topMadeWith(games, 8)), [games])
|
||||
return (
|
||||
<ChartCard title={t('charts.madeWith.title')} description={t('charts.madeWith.desc')}>
|
||||
<ChartCard
|
||||
id="made-with"
|
||||
title={t('charts.madeWith.title')}
|
||||
description={t('charts.madeWith.desc')}
|
||||
table={{ label: t('games.filter.engine'), value: t('charts.series.games'), rows: tableRows(data) }}
|
||||
>
|
||||
<ResponsiveContainer width="100%" height="100%">
|
||||
<PieChart>
|
||||
<PieChart {...chartAria('made-with')}>
|
||||
<Pie
|
||||
{...SERIES_ANIMATION}
|
||||
rootTabIndex={-1}
|
||||
data={data}
|
||||
dataKey="count"
|
||||
nameKey="key"
|
||||
@@ -24,11 +31,7 @@ export function MadeWithChart({ games }: { games: Game[] }) {
|
||||
outerRadius="80%"
|
||||
paddingAngle={2}
|
||||
stroke={SLICE_STROKE}
|
||||
>
|
||||
{data.map((_, i) => (
|
||||
<Cell key={i} fill={PALETTE[i % PALETTE.length]} />
|
||||
))}
|
||||
</Pie>
|
||||
/>
|
||||
<Tooltip {...TOOLTIP_BASE} content={<ChartTooltipContent />} />
|
||||
<Legend {...LEGEND_BASE} />
|
||||
</PieChart>
|
||||
|
||||
@@ -1,28 +1,46 @@
|
||||
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 { tableRows } from '@/lib/chart-table'
|
||||
import { useT } from '@/lib/i18n'
|
||||
import type { Game } from '@/types/game'
|
||||
import { ChartCard } from './chart-card'
|
||||
import { 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 { PALETTE } from './palette'
|
||||
|
||||
export function OnlineOfflineChart({ games }: { games: Game[] }) {
|
||||
const t = useT()
|
||||
const split = useMemo(() => classifyOnline(games), [games])
|
||||
// Blue and orange: apart in lightness and for colour-blind readers (green and amber were not).
|
||||
const data = [
|
||||
{ key: t('charts.onlineOffline.online'), count: split.online },
|
||||
{ key: t('charts.onlineOffline.offline'), count: split.offline },
|
||||
{ key: t('charts.onlineOffline.online'), count: split.online, fill: PALETTE[4] },
|
||||
{ key: t('charts.onlineOffline.offline'), count: split.offline, fill: PALETTE[6] },
|
||||
]
|
||||
return (
|
||||
<ChartCard title={t('charts.onlineOffline.title')} description={t('charts.onlineOffline.desc')}>
|
||||
<ChartCard
|
||||
id="online-offline"
|
||||
title={t('charts.onlineOffline.title')}
|
||||
description={t('charts.onlineOffline.desc')}
|
||||
table={{
|
||||
label: t('charts.table.kind'),
|
||||
value: t('charts.series.games'),
|
||||
rows: tableRows(data, split.online + split.offline),
|
||||
}}
|
||||
>
|
||||
<ResponsiveContainer width="100%" height="100%">
|
||||
<PieChart>
|
||||
<Pie {...SERIES_ANIMATION} data={data} dataKey="count" nameKey="key" innerRadius="50%" outerRadius="80%" stroke={SLICE_STROKE}>
|
||||
<Cell fill={PALETTE[2]} />
|
||||
<Cell fill={PALETTE[3]} />
|
||||
</Pie>
|
||||
<PieChart {...chartAria('online-offline')}>
|
||||
<Pie
|
||||
{...SERIES_ANIMATION}
|
||||
rootTabIndex={-1}
|
||||
data={data}
|
||||
dataKey="count"
|
||||
nameKey="key"
|
||||
innerRadius="50%"
|
||||
outerRadius="80%"
|
||||
paddingAngle={2}
|
||||
stroke={SLICE_STROKE}
|
||||
/>
|
||||
<Tooltip {...TOOLTIP_BASE} content={<ChartTooltipContent total={split.online + split.offline} />} />
|
||||
<Legend {...LEGEND_BASE} />
|
||||
</PieChart>
|
||||
|
||||
@@ -1,17 +1,33 @@
|
||||
import { readableOn } from '@/lib/color'
|
||||
|
||||
// Shared chart colour palette. Kept in its own file so chart-card.tsx
|
||||
// stays a component-only module (React Fast Refresh friendly).
|
||||
// Every colour keeps 3:1 against the card in both themes (WCAG 1.4.11; the
|
||||
// green, amber, sky, orange and emerald were darkened for the light card) —
|
||||
// src/contrast.test.ts checks it.
|
||||
export const PALETTE = [
|
||||
'#7c5cff', // the site accent (--primary)
|
||||
'hsl(330 81% 60%)',
|
||||
'hsl(142 71% 45%)',
|
||||
'hsl(38 92% 50%)',
|
||||
'hsl(217 91% 60%)',
|
||||
'hsl(199 89% 48%)',
|
||||
'hsl(20 90% 55%)',
|
||||
'hsl(173 58% 39%)',
|
||||
'hsl(280 65% 60%)',
|
||||
'hsl(160 60% 45%)',
|
||||
'#7c5cff', // the brand purple (--brand)
|
||||
'#ec4699',
|
||||
'#1b9d4a',
|
||||
'#c76c05',
|
||||
'#3c83f6',
|
||||
'#0b84bc',
|
||||
'#e9560c',
|
||||
'#2a9d90',
|
||||
'#af57db',
|
||||
'#238b68',
|
||||
]
|
||||
|
||||
/** Label colour for text drawn on each palette colour (the treemap cells), 4.5:1 or better. */
|
||||
export const PALETTE_LABEL = PALETTE.map((color) => readableOn(color))
|
||||
|
||||
/** "Unknown / not disclosed" slices: a mid gray that reads on both themes' cards. */
|
||||
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,22 +1,30 @@
|
||||
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 { tableRows } from '@/lib/chart-table'
|
||||
import { useT } from '@/lib/i18n'
|
||||
import type { Game } from '@/types/game'
|
||||
import { ChartCard } from './chart-card'
|
||||
import { 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 { PALETTE } from './palette'
|
||||
import { paletteFills } from './palette'
|
||||
|
||||
export function PlatformChart({ games }: { games: Game[] }) {
|
||||
const t = useT()
|
||||
const data = useMemo(() => countByArray(games, 'platforms'), [games])
|
||||
const data = useMemo(() => paletteFills(countByArray(games, 'platforms')), [games])
|
||||
return (
|
||||
<ChartCard title={t('charts.platform.title')} description={t('charts.platform.desc')}>
|
||||
// No shares in the table: a game can count for several platforms.
|
||||
<ChartCard
|
||||
id="platform"
|
||||
title={t('charts.platform.title')}
|
||||
description={t('charts.platform.desc')}
|
||||
table={{ label: t('games.filter.platform'), value: t('charts.series.games'), rows: tableRows(data) }}
|
||||
>
|
||||
<ResponsiveContainer width="100%" height="100%">
|
||||
<PieChart>
|
||||
<PieChart {...chartAria('platform')}>
|
||||
<Pie
|
||||
{...SERIES_ANIMATION}
|
||||
rootTabIndex={-1}
|
||||
data={data}
|
||||
dataKey="count"
|
||||
nameKey="key"
|
||||
@@ -24,11 +32,7 @@ export function PlatformChart({ games }: { games: Game[] }) {
|
||||
outerRadius="80%"
|
||||
paddingAngle={2}
|
||||
stroke={SLICE_STROKE}
|
||||
>
|
||||
{data.map((_, i) => (
|
||||
<Cell key={i} fill={PALETTE[i % PALETTE.length]} />
|
||||
))}
|
||||
</Pie>
|
||||
/>
|
||||
<Tooltip {...TOOLTIP_BASE} content={<ChartTooltipContent />} />
|
||||
<Legend {...LEGEND_BASE} />
|
||||
</PieChart>
|
||||
|
||||
@@ -1,11 +1,12 @@
|
||||
import { useMemo } from 'react'
|
||||
import { Bar, BarChart, CartesianGrid, ResponsiveContainer, Tooltip, XAxis, YAxis } from 'recharts'
|
||||
import { ratingHistogram } from '@/lib/analytics'
|
||||
import { tableRows } from '@/lib/chart-table'
|
||||
import { useFormat } from '@/lib/format'
|
||||
import { useT } from '@/lib/i18n'
|
||||
import type { Game } from '@/types/game'
|
||||
import { ChartCard } from './chart-card'
|
||||
import { BAR_CURSOR, SERIES_ANIMATION, TOOLTIP_BASE } from './chart-theme'
|
||||
import { BAR_CURSOR, chartAria, SERIES_ANIMATION, TOOLTIP_BASE } from './chart-theme'
|
||||
import { ChartTooltipContent } from './chart-tooltip'
|
||||
import { PALETTE } from './palette'
|
||||
|
||||
@@ -14,9 +15,14 @@ export function RatingChart({ games }: { games: Game[] }) {
|
||||
const fmt = useFormat()
|
||||
const data = useMemo(() => ratingHistogram(games, 10), [games])
|
||||
return (
|
||||
<ChartCard title={t('charts.rating.title')} description={t('charts.rating.desc')}>
|
||||
<ChartCard
|
||||
id="rating"
|
||||
title={t('charts.rating.title')}
|
||||
description={t('charts.rating.desc')}
|
||||
table={{ label: t('games.filter.rating'), value: t('charts.series.games'), rows: tableRows(data) }}
|
||||
>
|
||||
<ResponsiveContainer width="100%" height="100%">
|
||||
<BarChart data={data}>
|
||||
<BarChart {...chartAria('rating')} data={data}>
|
||||
<CartesianGrid strokeDasharray="3 3" />
|
||||
<XAxis dataKey="key" tick={{ fontSize: 10 }} />
|
||||
<YAxis tickFormatter={fmt.number} />
|
||||
|
||||
@@ -18,15 +18,17 @@ export function RecentDeletedChart({ deleted }: { deleted: DeletedGameEntry[] })
|
||||
)
|
||||
return (
|
||||
<ChartCard
|
||||
id="recent-deleted"
|
||||
keyboard={false}
|
||||
title={t('charts.recentDeleted.title')}
|
||||
description={t('charts.recentDeleted.desc', { shown: recent.length, total: fmt.number(deleted.length) })}
|
||||
>
|
||||
<div className="h-full overflow-y-auto pr-2">
|
||||
<ul className="space-y-1.5 text-sm">
|
||||
{recent.length === 0 ? (
|
||||
<p className="text-muted-foreground">{t('charts.recentDeleted.empty')}</p>
|
||||
) : (
|
||||
recent.map((d) => {
|
||||
{recent.length === 0 ? (
|
||||
<p className="text-sm text-muted-foreground">{t('charts.recentDeleted.empty')}</p>
|
||||
) : (
|
||||
<ul className="space-y-1.5 text-sm">
|
||||
{recent.map((d) => {
|
||||
const key = reasonKey(d.reason)
|
||||
return (
|
||||
// Phones: the reason goes under the name, which would otherwise shrink to a few letters.
|
||||
@@ -44,9 +46,9 @@ export function RecentDeletedChart({ deleted }: { deleted: DeletedGameEntry[] })
|
||||
</Badge>
|
||||
</li>
|
||||
)
|
||||
})
|
||||
)}
|
||||
</ul>
|
||||
})}
|
||||
</ul>
|
||||
)}
|
||||
</div>
|
||||
</ChartCard>
|
||||
)
|
||||
|
||||
@@ -1,26 +1,36 @@
|
||||
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 { tableRows } from '@/lib/chart-table'
|
||||
import { useT } from '@/lib/i18n'
|
||||
import type { Game } from '@/types/game'
|
||||
import { ChartCard } from './chart-card'
|
||||
import { 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 { PALETTE } from './palette'
|
||||
import { paletteFills } from './palette'
|
||||
|
||||
export function StatusChart({ games }: { games: Game[] }) {
|
||||
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)
|
||||
return (
|
||||
<ChartCard title={t('charts.status.title')} description={t('charts.status.desc')}>
|
||||
<ChartCard
|
||||
id="status"
|
||||
title={t('charts.status.title')}
|
||||
description={t('charts.status.desc')}
|
||||
table={{ label: t('games.filter.status'), value: t('charts.series.games'), rows: tableRows(data, total) }}
|
||||
>
|
||||
<ResponsiveContainer width="100%" height="100%">
|
||||
<PieChart>
|
||||
<Pie {...SERIES_ANIMATION} data={data} dataKey="count" nameKey="key" outerRadius="80%" stroke={SLICE_STROKE}>
|
||||
{data.map((_, i) => (
|
||||
<Cell key={i} fill={PALETTE[i % PALETTE.length]} />
|
||||
))}
|
||||
</Pie>
|
||||
<PieChart {...chartAria('status')}>
|
||||
<Pie
|
||||
{...SERIES_ANIMATION}
|
||||
rootTabIndex={-1}
|
||||
data={data}
|
||||
dataKey="count"
|
||||
nameKey="key"
|
||||
outerRadius="80%"
|
||||
stroke={SLICE_STROKE}
|
||||
/>
|
||||
<Tooltip {...TOOLTIP_BASE} content={<ChartTooltipContent total={total} />} />
|
||||
<Legend {...LEGEND_BASE} />
|
||||
</PieChart>
|
||||
|
||||
@@ -1,11 +1,12 @@
|
||||
import { useMemo } from 'react'
|
||||
import { Bar, BarChart, CartesianGrid, ResponsiveContainer, Tooltip, XAxis, YAxis } from 'recharts'
|
||||
import { topByRatingCount } from '@/lib/analytics'
|
||||
import { tableRows } from '@/lib/chart-table'
|
||||
import { useFormat } from '@/lib/format'
|
||||
import { useT } from '@/lib/i18n'
|
||||
import type { Game } from '@/types/game'
|
||||
import { ChartCard } from './chart-card'
|
||||
import { BAR_CURSOR, SERIES_ANIMATION, TOOLTIP_BASE, truncateLabel } from './chart-theme'
|
||||
import { BAR_CURSOR, chartAria, SERIES_ANIMATION, TOOLTIP_BASE, truncateLabel } from './chart-theme'
|
||||
import { ChartTooltipContent } from './chart-tooltip'
|
||||
import { PALETTE } from './palette'
|
||||
|
||||
@@ -14,9 +15,14 @@ export function TopRatedCountChart({ games }: { games: Game[] }) {
|
||||
const fmt = useFormat()
|
||||
const data = useMemo(() => topByRatingCount(games, 10), [games])
|
||||
return (
|
||||
<ChartCard title={t('charts.topRatedCount.title')} description={t('charts.topRatedCount.desc')}>
|
||||
<ChartCard
|
||||
id="top-rated-count"
|
||||
title={t('charts.topRatedCount.title')}
|
||||
description={t('charts.topRatedCount.desc')}
|
||||
table={{ label: t('games.col.game'), value: t('charts.series.ratings'), rows: tableRows(data) }}
|
||||
>
|
||||
<ResponsiveContainer width="100%" height="100%">
|
||||
<BarChart data={data} layout="vertical" margin={{ left: 20 }}>
|
||||
<BarChart {...chartAria('top-rated-count')} data={data} layout="vertical" margin={{ left: 20 }}>
|
||||
<CartesianGrid horizontal={false} strokeDasharray="3 3" />
|
||||
<XAxis type="number" allowDecimals={false} tickFormatter={fmt.number} />
|
||||
<YAxis
|
||||
|
||||
@@ -1,5 +1,6 @@
|
||||
import { useMemo } from 'react'
|
||||
import { countByArray, topN } from '@/lib/analytics'
|
||||
import { tableRows } from '@/lib/chart-table'
|
||||
import { useT } from '@/lib/i18n'
|
||||
import type { Game } from '@/types/game'
|
||||
import { ChartCard } from './chart-card'
|
||||
@@ -8,7 +9,14 @@ export function TopTagsChart({ games }: { games: Game[] }) {
|
||||
const t = useT()
|
||||
const data = useMemo(() => topN(countByArray(games, 'tags'), 30), [games])
|
||||
return (
|
||||
<ChartCard title={t('charts.topTags.title')} description={t('charts.topTags.desc')}>
|
||||
// The counts are shown only by size here (and in a hover title): the table reads them out.
|
||||
<ChartCard
|
||||
id="top-tags"
|
||||
title={t('charts.topTags.title')}
|
||||
description={t('charts.topTags.desc')}
|
||||
keyboard={false}
|
||||
table={{ label: t('games.filter.tag'), value: t('charts.series.games'), rows: tableRows(data) }}
|
||||
>
|
||||
<div className="flex h-full flex-wrap content-start items-baseline gap-2 overflow-y-auto p-2">
|
||||
{data.map((tag) => {
|
||||
const fontSize = computeTagFontSize(tag.count, data[0]?.count ?? 1)
|
||||
|
||||
Loaded 100 of 155 files, more files were not shown because too many files have changed in this diff.
Show more
Reference in new issue
Block a user