Licenses - Code stays MIT (LICENSE: 2025-2026 poli0981 (SkullMute)). The catalog data (data_game/LICENSE.md) and the documentation are CC BY 4.0 (full legal code in LICENSES/CC-BY-4.0.txt); creators' descriptions, cover images, names and trademarks are excluded. NOTICE.md: license map and non-affiliation with itch.io. Policies (English + Vietnamese mirrors, dated 2026-09-18, applying from 4.0.0) - Terms of Use now cover the website and the public data, with the content-removal / copyright process, prohibited uses (bulk scraping, /img abuse, /admin and ingest access, Suggest spam), 18+ opt-in and Vietnamese law with the consumer-rights reservation. - Privacy Policy rewritten for Cloudflare as processor: exact browser storage, cookies, Turnstile, D1 retention (Suggest notes 180 days, idempotency 7 days), rights under Law No. 91/2025/QH15 and the GDPR. - EULA covers only the desktop and Android apps (also the installer RTF). - Disclaimer, Security Policy (private reporting, scope, safe harbor) and Code of Conduct (Contributor Covenant 2.1) rewritten; PAT, GPG and Telegram-bot material removed. Docs and templates - README / CONTRIBUTING (EN + VI), webapp/README, TAURI.md, dev_env (EN + VI), THIRD_PARTY, ACKNOWLEDGEMENTS; new docs/operations.md (Cloudflare + GitHub setup, v4 release order, routine tasks). - CLAUDE.md rewritten for the v4 architecture; CHANGELOG [4.0.0]. - Issue templates: config.yml (Suggest page + private security reports), "Add games" points to /suggest, "Remove a game" gained a rights-holder section; PR templates updated; CODEOWNERS. - Dependabot npm version updates resume with the v4 merge (limit 5). Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
9.7 KiB
Third-party components
Last updated: 2026-09-18
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) and resolved at build time for Rust and Python (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.4 | Routing | MIT |
| Zustand | 5.0 | Preference and theme stores | MIT |
TanStack Query (@tanstack/react-query, react-query-persist-client, query-async-storage-persister) |
5.103 | Data fetching and the local catalog cache | MIT |
TanStack Table (@tanstack/react-table) |
8.21 | The games table | MIT |
TanStack Virtual (@tanstack/react-virtual) |
3.14 | Virtualized long lists | MIT |
| idb-keyval | 6.3 | IndexedDB storage for the catalog cache | Apache-2.0 |
| Recharts | 3.10 | Charts | MIT |
Radix UI primitives (@radix-ui/react-checkbox, -dialog, -label, -popover, -select, -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.47 | Icons | ISC |
| sonner | 2.0 | Toast notifications | MIT |
| 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 | see package.json |
Generates the site's CSS at build time | MIT |
@tauri-apps/api |
2.11 | App-only bridge to the native shell | Apache-2.0 OR MIT |
@tauri-apps/plugin-opener |
2.5 | 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 site uses the operating system's own fonts; no web fonts are bundled or downloaded.
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 Suggest page only, 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.14)
| 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 |
These pull in urllib3 (MIT), 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 6.0 (Apache-2.0):
noUnusedLocalsandnoUnusedParametersreject unused code at build time. Run:cd webapp && npx tsc -b
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 |
PostCSS, Autoprefixer, tailwindcss-animate |
CSS pipeline | MIT |
| Vitest 5 | Tests (npm test) |
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 |
| 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 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 (Suggest page); Web Analytics (cookieless, aggregate); Workers Logs; Access (admin login); Rate Limiting; Email Routing (the project's contact addresses) |
| GitHub | Code, catalog data, issues and discussions, Actions (the pipeline), release downloads |
| 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.