Accessibility pass for the website and the apps (WCAG 2.2 AA target) and the accessibility statement: root ACCESSIBILITY.md + docs/i18n/vi/ACCESSIBILITY.md, the accessibility issue form, a default PR template; focus management, the '/' shortcut switch, chart names and data tables, contrast tokens with a CI check, Windows contrast themes; a docs sync of verified mismatches; version 4.6.0 with the two deps sweeps since 4.5.0 (#176, #182). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
11 KiB
Third-party components
Last updated: 2026-11-09
Applies from: the release of version 4.0.0.
The website https://freeitchgames.win, its Worker, the desktop and Android apps and the data pipeline are
built on open-source software. This file lists the direct dependencies and the licenses they are published
under. Each component keeps its own license; the project's licenses (NOTICE.md) do not
change them.
- Versions are the ranges declared in
webapp/package.json,webapp/src-tauri/Cargo.toml,requirements.txtandrequirements-dev.txt. Exact versions, including dependencies of dependencies, are pinned inwebapp/package-lock.json(npm) andwebapp/src-tauri/Cargo.lock(Rust); Python dependencies are resolved at install time (npm ls,cargo treeandpip listshow the full trees). - The runtime libraries are also listed on the About page, which reads
the
THIRD_PARTYarray inwebapp/src/lib/about.ts.
1. Website and apps (shipped in the browser bundle)
These libraries are bundled into the public website and the desktop / Android apps, which reuse the
website's code. The /admin app uses a subset of them (React, React Router, TanStack Query and some of the
shared UI components).
| Component | Version | Used for | License |
|---|---|---|---|
React (react, react-dom) |
19.3 | UI framework | MIT |
React Router (react-router) |
8.5 | Routing | MIT |
| Zustand | 5.0 | Preference and theme stores | MIT |
TanStack Query (@tanstack/react-query, react-query-persist-client) |
5.106 | Data fetching and the local catalog cache | MIT |
| idb-keyval | 6.3 | IndexedDB storage for the compressed catalog cache | Apache-2.0 |
| fflate | 0.8 | Decompressing the catalog where the browser has no Compression Streams (older Safari / iOS) | MIT |
| Recharts | 3.10 | Charts | MIT |
Radix UI primitives (@radix-ui/react-checkbox, -dialog, -label, -popover, -separator, -slot, -switch, -tabs) |
1.x / 2.x | Accessible UI building blocks | MIT |
| shadcn/ui | pattern | Component patterns copied into webapp/src/components/ui/ |
MIT |
| lucide-react | 1.69 | Icons | ISC |
| class-variance-authority | 0.7 | Component variants | Apache-2.0 |
| clsx | 2.1 | Class-name helper | MIT |
| tailwind-merge | 3.7 | Class-name merging | MIT |
Tailwind CSS (tailwindcss, @tailwindcss/vite) and tw-animate-css |
4.3 / 1.4 | Generate the site's CSS at build time | MIT |
Geist and Geist Mono (@fontsource-variable/geist, @fontsource-variable/geist-mono) |
5.3 | The site's typefaces | OFL-1.1 (fonts), MIT (Fontsource packaging) |
@tauri-apps/api |
2.12 | App-only bridge to the native shell | Apache-2.0 OR MIT |
@tauri-apps/plugin-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.
The Geist fonts are bundled into the site and served from it (never from a font CDN), so pages make no requests to third-party font services. The fonts are licensed under the SIL Open Font License 1.1.
2. Worker (server code on Cloudflare)
| Component | Version | Used for | License |
|---|---|---|---|
| jose | 6.2 | Verifying Cloudflare Access tokens and signing the GitHub App token | MIT |
The Worker runs on Cloudflare's Workers runtime and uses Cloudflare services (R2, D1, Images, Rate
Limiting, Access). Two scripts come from Cloudflare instead of the site's own bundle: the Web Analytics
beacon (static.cloudflareinsights.com) and, on the verification page and the Suggest page, the
Turnstile widget (challenges.cloudflare.com). These are Cloudflare services under Cloudflare's own terms, not open-source
components. Section 7 lists every service the project uses.
3. Desktop and Android apps (Rust crates)
| Crate | Version | Used for | License |
|---|---|---|---|
tauri, tauri-build |
2 | App shell and build helper | Apache-2.0 OR MIT |
| tauri-plugin-opener | 2 | Opening links in the system browser | Apache-2.0 OR MIT |
| tauri-plugin-single-instance | 2 | Desktop only: focuses the running window instead of starting a second copy | Apache-2.0 OR MIT |
| serde, serde_json | 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.
4. Data pipeline (Python 3.15)
| Package | Version | Used for | License |
|---|---|---|---|
| requests | 2.34+ | HTTP requests to public itch.io pages | Apache-2.0 |
| beautifulsoup4 | 4.15+ | Parsing itch.io pages | MIT |
| urllib3 | 2.8+ | Retry policy of the scraper's HTTP session | MIT |
These pull in certifi (MPL-2.0), charset-normalizer (MIT), idna (BSD-3-Clause) and soupsieve
(MIT).
5. Development and test tooling (never shipped)
These tools never end up in a build, but they keep the code honest.
Dead-code detection
- knip (ISC) finds unused files, exports and dependencies in the webapp and the
Worker. Config:
webapp/knip.json. Run:cd webapp && npm run knip - vulture (MIT) finds dead code (unused functions, classes,
attributes) in the Python pipeline. Config:
[tool.vulture]inpyproject.toml. Run:vulture
Linting and types
- ruff (MIT): Python linter, formatter and import sorter; flags
unused imports and variables. Config:
[tool.ruff]inpyproject.toml. Run:ruff check scripts tests webapp/scriptsandruff format - ESLint with
@eslint/js, typescript-eslint,eslint-plugin-react-hooks,eslint-plugin-react-refreshandglobals(all MIT): webapp linting. Config:webapp/eslint.config.js. Run:cd webapp && npm run lint - TypeScript 7.0 (Apache-2.0):
noUnusedLocalsandnoUnusedParametersreject unused code at build time. Run:cd webapp && npx tsc -b. The 6.0 API (@typescript/typescript6, installed astypescript) stays for typescript-eslint, which needs it
Build, test and deploy
| Tool | Used for | License |
|---|---|---|
Vite 8 and @vitejs/plugin-react |
Bundling the site, the admin app and the apps' front end | MIT |
| Vitest 5 | Tests (npm test) |
MIT |
@vitest/coverage-v8 5 |
Test coverage for SonarQube Cloud (npm run test:coverage) |
MIT |
| Wrangler 4 | Local Worker dev, D1 migrations, deploys | MIT OR Apache-2.0 |
@tauri-apps/cli 2 |
Building the desktop and Android apps | Apache-2.0 OR MIT |
@types/node, @types/react, @types/react-dom |
Type definitions | MIT |
| pytest | Python tests (network blocked) | MIT |
| pytest-cov and coverage.py | Python test coverage for SonarQube Cloud (pytest --cov) |
MIT; Apache-2.0 |
| Pillow | webapp/scripts/gen_assets.py, which generates the icons and the social preview image |
MIT-CMU |
6. GitHub Actions
The workflows in .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
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.
7. Services (not software the project distributes)
| Service | What it does for the project |
|---|---|
| Cloudflare | DNS, CDN, WAF, TLS; Workers and static assets (the website); R2 (resized cover images); D1 (the review queue); Images (resizing); Turnstile (the verification page and the Suggest page); Web Analytics (cookieless, aggregate); Workers Logs; Access (admin login); Rate Limiting |
| 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 |
| 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 |
What each service receives is described in the Privacy Policy.
8. Keeping this list current
.github/dependabot.ymlkeeps npm, pip, GitHub Actions and Cargo dependencies up to date.- When you add an npm dependency, add it to the
THIRD_PARTYarray inwebapp/src/lib/about.ts(so the About page lists it) and to this file. The house rules are in CONTRIBUTING.md. - Adding a new dev tool? Drop it here too, so the next person (or AI buddy) knows what is keeping an eye on the code.