Files
poli0981andClaude Fable 5.2 0e0e442de5 chore: maintenance mode, Qodana analysis; 4.6.1 (#188) [skip-discuss]
The project moves to maintenance mode (stable, feature-complete): docs, templates and badges (EN + VI). Qodana analysis in CI for the TypeScript / JavaScript, Python and Rust projects, with the findings of its first reports fixed. Version 4.6.1.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
2026-11-11 21:44:32 +07:00

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.

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 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] in pyproject.toml. Run: vulture

Linting and types

  • ruff (MIT): Python linter, formatter and import sorter; flags unused imports and variables. Config: [tool.ruff] in pyproject.toml. Run: ruff check scripts tests webapp/scripts and ruff format
  • ESLint with @eslint/js, typescript-eslint, eslint-plugin-react-hooks, eslint-plugin-react-refresh and globals (all MIT): webapp linting. Config: webapp/eslint.config.js. Run: cd webapp && npm run lint
  • TypeScript 7.0 (Apache-2.0): noUnusedLocals and noUnusedParameters reject unused code at build time. Run: cd webapp && npx tsc -b. The 6.0 API (@typescript/typescript6, installed as typescript) 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, JetBrains/qodana-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
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

What each service receives is described in the Privacy Policy.

8. Keeping this list current

  • .github/dependabot.yml keeps npm, pip, GitHub Actions and Cargo dependencies up to date.
  • When you add an npm dependency, add it to the THIRD_PARTY array in webapp/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.