- docs/plan/16-toolchain-2026.md: the assessment - what each release
changes, what was measured here, the decisions, how to move each runtime
next time, and what was left.
- docs/plan/17-typescript-7.1.md: the springboard for dropping TypeScript 6
once 7.1 ships - start conditions and how to check them, the steps, the
planted-error table and the baselines to compare against.
- CLAUDE.md: "TypeScript is two packages, on purpose" and "One version of
each runtime"; the uv compile line says 3.15.
- dev_env (EN/VI), README, AUTHORS, TAURI.md, web/README, THIRD_PARTY,
DEPLOYMENT (Workers Builds' NODE_VERSION=26, the Checks paragraph),
ACKNOWLEDGEMENTs and the About page's stack list ("TypeScript 7 + 6").
- CHANGELOG: the Tooling entry.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Web app and desktop/Android 2.0.0 -> 2.0.1 (package.json and its lockfile,
Cargo.toml and Cargo.lock, tauri.conf.json - the Android versionCode is
derived from it at build time); repo public-facing version 4.0.0 -> 4.0.1.
The changelog's Unreleased section becomes v4.0.1, "The Human Check
Edition": the Turnstile check, legal diffs, Web Analytics, the no-Referer
artwork fix for the apps, and data loads held behind both first-run gates.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Legal (both reopen the consent gate for returning visitors, showing only
the changed lines - edited line-locally so that diff stays small):
- PRIVACY_POLICY: a section on the website's Turnstile check - after
acceptance, at most daily, what challenges.cloudflare.com reads (IP,
User-Agent, TLS fingerprint, page signals), that Cloudflare is processor
for the site and controller where it improves its bot detection (the
Turnstile Privacy Addendum), that the Worker forwards the token and IP
and keeps neither; the f2p:human_check storage row. "The only third
party", "the verification step" and "No fingerprinting" are corrected.
- ToS section 9: the check exists; /api/data/*, /img/* and the apps stay
excluded from both human checks.
SECURITY_SETUP:
- section 10 rewritten. It said the apps survived Hotlink Protection only
because their webview sent no Referer (untrue since WebView2 started
sending tauri.localhost), recommended switching the protection off, and
said no allowlist could express the apps' origin - a Configuration Rule
on http.referer can. Now: the per-<img> fix and its test, the rule for
2.0.0 installs, and the check, with the results measured today.
- new section 12: widget settings (hostname, Managed, pre-clearance off),
the TURNSTILE_SECRET secret and rotation, what the check is not, local
testing with Cloudflare's test keys, the optional rate-limit expression.
- the CSP block, the script-src/frame-src prose, "no form posts", the
rule budget (Configuration Rules 1/10), and two stale paths.
CLAUDE.md gains the human-check and <img> invariants and says "after
consent and the human check" where the service worker, analytics and
/welcome used to say "after consent". README, web/README, DEPLOYMENT,
ACKNOWLEDGEMENTs, SECURITY (bypassing the client-side gate is out of
scope), TAURI troubleshooting and the changelog follow. _headers and
worker/lib/http.ts: comments only - why images override Referrer-Policy,
what X-Frame-Options does and does not govern, and the public/_headers
and SITE_ORIGIN references that were stale.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- README: SvelteKit rather than React, Cloudflare rather than GitHub Pages, a
resizable self-updating desktop app, the /admin review queue, the real
workflow list, and no in-browser editing or GPG signing (removed in
September).
- web/README.md: the admin app, verified shard generations, prerendered game
pages, the service worker as it is now, and the checks CI runs.
- TAURI.md: the update feed at /api/updates/desktop (drafts are never offered),
settings surviving updates, the Android update check; the OAuth note is gone
with sign-in.
- dev_env (en, vi), CONTRIBUTING, android-support (en, vi): tests exist now,
and the web side is Svelte.
- SECURITY_SETUP: the admin shell's nonce policy, and the report-only CSP that
Cloudflare's Continuous script monitoring adds at the edge (turn it off).
- CLAUDE.md: where old /#/ links still come from and why the upgrade uses
goto; /api/activity sends CORS too.
- CHANGELOG [v4.0.0]: the admin app, verified data, a page per game, the
installable web app, the desktop updater, the new pages, and the live-site
fixes. Deploying needs D1 migration 0002.
- Code comments that still described React, GitHub Pages, hash routing or a
sign-in token.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
- minSdk 24 -> 30: OS-level install gate (INSTALL_FAILED_OLDER_SDK) drops EOL
Android 7-10 (no Google OS patches, stale WebView vs the React 19 bundle);
minSdk 30 still reaches ~87% of active devices.
- Hide the steam:// "Steam Desktop" button on the Android app / sub-768px
viewport via a new reactive useIsMobile hook; the Web button stays.
- Docs: new docs/android-support.md (+vi mirror) with requirement, rationale,
tested devices (emulator 11-16, real vivo 1907 on Android 12) and a sourced
version-share/EOL table; update TAURI.md, pc_spec.md (+vi), the
release-android.yml notes, and the README badge/links.
- Bump 1.4.3 -> 1.4.4 (repo 3.4.1 -> 3.4.2) + Cargo.lock/package-lock sync.
Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
* feat(android): scaffold Tauri 2 Android build — first working APK
Adds Android as a build target for the existing web app via Tauri 2 mobile.
A debug arm64 APK builds successfully on Windows (NDK 30 + JDK 21).
- gen/android: committed Tauri-mobile Gradle project (`tauri android init`).
Build artefacts (build/, .gradle, jniLibs *.so, keystore.properties,
tauri.properties) stay ignored via the nested .gitignore files.
- capabilities: split updater:default into a desktop-only capability
(updater.json, platforms = win/linux/macOS) so the Android ACL resolution
doesn't fail on the updater plugin that's gated out of mobile builds.
- external links: global capture-phase interceptor routes external <a>/links
through the Tauri shell on desktop + Android (the webview blocks
window.open to external HTTPS); convert the two window.open call sites
(DeviceFlowPanel, Health) to openExternal.
- npm scripts: build:mobile + tauri:android:{init,dev,build}.
- src-tauri/.gitignore: gen/ -> gen/schemas/ so gen/android is committable.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
* feat(android): native-HTTP OAuth + mobile UX polish
- OAuth Device Flow: route the two github.com/login/* endpoints (which send
no CORS headers) through @tauri-apps/plugin-http so they work inside the
Android System WebView, which — unlike desktop — enforces CORS. Falls back
to window.fetch (+ optional VITE_GH_OAUTH_PROXY) on the plain web build.
Adds the Rust tauri-plugin-http plugin + an http:default capability scoped
to github.com / api.github.com.
- Layout: apply env(safe-area-inset-*) padding — edge-to-edge is forced on
targetSdk 36 / Android 15, so the chrome must dodge the status/nav bars.
No-op on web/desktop (insets are 0).
- Command palette: openable on touch via a mobile topbar button dispatching a
custom event, since the soft keyboard can't send the Ctrl/Cmd+K chord.
Verified: typecheck, web build, and a debug arm64 APK build all pass; the
http:default ACL scope resolves on Android.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
* ci(android): release signing config + GitHub Actions release workflow
- app/build.gradle.kts: add a `release` signingConfig sourced from
gen/android/keystore.properties (gitignored). Guarded by the file's
existence, so a keyless checkout still configures and unsigned/debug builds
keep working; the release buildType signs only when the keystore is present.
- .github/workflows/release-android.yml: build a signed universal release APK
on `android-v*` tags (JDK 17, Android SDK, NDK r27, the four Rust android
targets), decoding the keystore from repo secrets into keystore.properties,
then attach the APK to a draft GitHub Release. Documents the four required
secrets (ANDROID_KEYSTORE_BASE64 / _PASSWORD / KEY_ALIAS / KEY_PASSWORD).
Verified the gradle DSL parses via a debug APK build. Signing itself is
exercised once the keystore exists (user-generated, kept out of the repo).
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
* docs(android): document the Tauri 2 Android build, signing, and CI
Extend TAURI.md (now "desktop + Android") with an Android section: SDK/NDK/JDK
prerequisites, build commands, keystore signing + backup warning, the
release-android.yml CI secrets, and notes on the desktop-only updater,
edge-to-edge safe areas, the plugin-http OAuth bridge, and the Kotlin
cross-drive incremental-compile fallback.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
The Vite 8 / Rolldown migration (#95) introduced a production regression:
every chart tab threw React error #130 ("Element type is invalid... got:
object") and failed to render — all pages/charts/* plus the Dashboard.
Root cause: EChart.tsx imported the wrapper from
`echarts-for-react/lib/core` (the CommonJS build). Under Rolldown the
CJS default-interop wraps `module.exports = class` into a namespace
object, so <ReactEChartsCore/> received an object instead of a
component. Switched to the ESM build `echarts-for-react/esm/core`, which
has a clean `export default`. echarts core / echarts-wordcloud were
already ESM, so this single import was the only offender.
Verified at runtime against the production (Rolldown) build (the step
skipped in #95): bar, pie/donut, line, treemap, heatmap and wordcloud
charts all render with zero console errors; echarts/openpgp stay lazy
async chunks (not eager-preloaded).
Also documents the glib Dependabot advisory (GHSA-wrw7-89jp-8q8g,
medium, Linux-only) as accepted: it cannot be fixed within Tauri 2.x
(webkit2gtk 2.0.2 pins glib ^0.18; Tauri 3 unreleased) and the deployed
surfaces are unaffected. Alert to be dismissed as tolerable risk.
Version: repo 3.4.0 -> 3.4.1; web + desktop 1.4.0 -> 1.4.1.
Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
* v3.2.0: SEO, Donate page, Discussion auto-post, Health bucket split, dev docs
Bundles 8 features for v3.2.0 (per the planning round):
1. SEO basics — OG / Twitter card / canonical / JSON-LD in index.html;
robots.txt + sitemap.xml in web/public; useDocumentTitle hook wired
into every page so the tab title reflects the current route +
language.
2. Auto-post a GitHub Discussion on release `published` —
.github/workflows/announce-release-discussion.yml. Uses GraphQL
`createDiscussion`, idempotent (skips if a discussion with the same
title already exists), prefers the `Announcements` category with
fallback to `General`.
3. Dev docs — docs/pc_spec.md, docs/dev_env.md, VI mirrors under
docs/i18n/vi/, web/src-tauri/TAURI.md (build prerequisites + signing
notes). AUTHORS.md gets a "Dev info" table; README.md links the new
docs.
4. Donate page (/donate) with 5 platform cards
(GitHub Sponsors / Ko-fi / BMC / Patreon / PayPal) sourced from
.github/FUNDING.yml. New nav item, EN + VI i18n keys.
5. Telegram bot user guide — new docs/telegram-bot.md pointer page
linking the external USER_GUIDE.md, bot source repo, and the
in-repo bot-ingest.yml workflow. CONTRIBUTING.md and About page get
the same link.
6. Health bucket split — separates "Online + AC + kernel unknown" from
"Online · anti-cheat unknown / none" so games with empty `anti_cheat`
no longer disappear from the report.
7. Steam Desktop direct link — game detail drawer now shows two buttons:
`steam://store/<appid>` (Steam client) and the regular
store.steampowered.com URL. Helper at web/src/lib/steam-link.ts.
8. Bi-weekly offline player leaderboard — scripts/top_offline.py +
bash/offline.sh + .github/workflows/top-offline.yml (cron 1st + 15th
of each month, plus workflow_dispatch). Output:
games/top-offline.md, top 100 single-player F2P concurrents.
Health page gets a manual trigger button.
Verification: `cd web && npm run typecheck && npm run build` — both
pass; PWA generates 17 precache entries; manifest.webmanifest emitted
by VitePWA as before.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
* fix(top-offline): make update_players_only honour offline filter
`update_players_only(games)` had a hardcoded `type_game == "online"`
filter, so passing it the full games list from top_offline.py refreshed
ZERO offline player counts and the resulting top-offline.md was sorted
on stale data (last touched by the daily update_data.py).
Extend the function with a backward-compatible `type_filter` kwarg
("online" default, plus "offline" and "all"). top_online.py keeps its
existing call shape; top_offline.py now passes type_filter="offline"
which excludes online AND empty-type rows (unclassified is not
"offline").
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
* chore(release): bump to v3.2.0 / desktop v1.2.0 + CHANGELOG
- web/package.json + lockfile: 1.1.0 → 1.2.0
- web/src-tauri/tauri.conf.json: 1.1.0 → 1.2.0
- web/src-tauri/Cargo.toml: 1.1.0 → 1.2.0
- README badge: 3.1.0 → 3.2.0
- CHANGELOG.md: new v3.2.0 entry covering all 8 features in this PR
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>