changelog/v<major>/<major>.<minor>.x/<version>.md for each of the 42 releases from v1.0.0 to v4.7.1, and changelog/beta/ for pre-releases (none has been published; its README says how one would be filed). CHANGELOG.md becomes the index: what the layout is, [Unreleased] exactly as it was, and a table per major version (version, date, edition) that links each file. Each file is its section, copied byte for byte except that its heading is the file's H1 (so the sub-headings move up one level, outside code fences), relative links gain ../../../ so they name the same repository paths, and the --- separators between sections are gone. Checked by reversing all three changes on every file and comparing with the original section: 40 of 40 equal. Two releases had no section: v1.0.0 (its GitHub release notes, which the changelog pointed to as "Initial stable") and v1.1.3 (its tag message). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
6.1 KiB
6.1 KiB
v3.0.0 – 2026-05-07 (The "It Has a Website Now" Edition)
The repo is no longer just a list. It is a list + a React/Vite web app + a Tauri desktop app, all reading the same Python-pipeline-maintained data.
🌐 Web app — web/ + GitHub Pages
Built across phases 1 → 7. Live at https://poli0981.github.io/free-steam-games-list/.
- Phase 1 — read-only browse: virtualised 1.2k-row TanStack table, faceted filters, Fuse.js fuzzy search, 4 ECharts MVP charts (KPI, top-online, genre treemap, platform donut), GitHub Pages deploy via
actions/deploy-pages. - Phase 2 — PAT-based GitHub auth, single-record edit drawer for the 8 manual fields, diff viewer, single + bulk Steam-link queue into
scripts/temp_info.jsonl, conflict-retry, sonner toasts. - Phase 3 — client-side OpenPGP signing via Git Data API: switched all writes from Contents API to
commitFile(getHead → createBlob → createTree → buildCommitContent → openpgp.sign → createCommit → updateRef). Settings panel with passphrase unlock + lock indicator. Earlier claim that PATs auto-sign was wrong — Contents API commits land Unverified. - Phase 4 — fixed GPG salt-notation incompatibility (
config.nonDeterministicSignaturesViaNotation: false) so OpenPGP.js v6 signatures parse on GitHub. Bulk edit + bulk delete in one signed multi-shard commit. 8 remaining charts (tags wordcloud, AC stacked, languages heatmap, release-year histogram, catalog-growth cumulative line, reviews histogram, online player tiers pie, DRM/DLC bars). Health page with workflow_dispatch buttons. ⌘K command palette (cmdk). - Phase 4.1 — GPG signature payload fix: dropped trailing
\nafter the commit message so our signed bytes matchverification.payloadbyte-for-byte. Verified viagh api .../commits/{sha}.commit.verification.reason → valid. - Phase 5 — PWA (installable, offline shell + last-known data via Workbox), GPG identity override (multi-UID picker), GPG idle auto-lock 5/15/30/60 min, Activity feed page (
/activity) with Verified-status badges + Me/Bots/All filters. - Phase 6 — curated enums (
ANTI_CHEAT_ENUM,GENRE_ENUM) + dropdowns, JSON-editor toggle in the edit drawer (full-record replace), manual-field overrides on Add (single + bulk JSON mode propagatesgenre/type_game/anti_cheat/notes/safestraight intotemp_info.jsonl), GamesTable pagination 50/100/200/500/all + hidden scrollbar + per-row validation badge, per-game permalinks/games/:appidwith friendly 404 drawer, verify-after-commit polling (toast updates withverification.reasononce GitHub confirms), CSV/JSON export of the filtered subset, About page (repo + dev info fromusername.txt+ 3rd-party stack + issue templates), topbar GPG quick-unlock popover, owner-gate (useIsOwner+OWNER_LOGIN) hides edit/add/delete UI from non-owners. - Phase 6.1 — Edit Always Failing fix: Contents API caps
contentat 1 MB;data/data_001.jsonlis 1.49 MB so the read came back empty and every edit threw "Record not found". NewgetRepoFileText()helper falls back to the/git/blobs/{sha}endpoint for oversize files. - Phase 6.2 — stale-after-edit fix: bumped
data/index.json.last_updatedin every shard-modifying commit AND switched the SW cache toNetworkFirst(raw.github CDN is Fastly-cached for 5 min). Plus optimistic-update helpers (optimisticEdit/Replace/BulkEdit/BulkDelete) write straight to TanStack + IndexedDB so the editor sees their own change instantly without waiting for the CDN. - Phase 7 — date-column sort fix (
parseReleaseDate), hamburger mobile nav (Sheet drawer, auto-close on route change), About expansion (Heads-up caveats + AI disclosure + legal links + per-third-party SPDX licence badges), legal docs rewritten (DISCLAIMER + EULA + ToS + PRIVACY) with the four caveats fromnotes.txt(genre best-effort, English-only, test-data leakage, unsigned-commit dev artefacts), refreshedbug_report.yml, workflow Node 20 → 24 + actions versions bumped.
🌍 i18n — vi / en (Phase 8, this release)
react-i18next+i18next-browser-languagedetector. Resource filessrc/i18n/locales/{en,vi}.json.- Auto-detect from
navigator.languageon first load; persistent override via Settings → Language. - Sidebar nav, Topbar, Settings, Dashboard, Top Online, common buttons, common toast strings translated. Long-form legal copy stays English by design (legal review hard to mirror exactly across two languages).
🖥️ Desktop app — Tauri 2 (Phase 8, this release)
web/src-tauri/Rust scaffold targeting Tauri 2. Singlemainwindow, fixed 1400 × 900, no resize, no maximise, dark theme, centred at startup.tauri-plugin-shellfor opening external links to Steam / GitHub from the embedded UI.- New
release-desktop.ymlworkflow: matrixubuntu-latest/windows-latest/macos-latest, Apple Silicon + Intel universal binaries,tauri-apps/tauri-action. Triggered bydesktop-v*tags or manual workflow run. Each run creates a draft GitHub Release with.msi/.dmg/.AppImage/.debassets. npm run tauri:devandnpm run tauri:buildfromweb/for local builds.
📦 Versioning
- Repo version badge 2.1.0 → 3.0.0.
web/package.json0.1.0 → 1.0.0 (web app considered first-stable).web/src-tauri/Cargo.tomlandtauri.conf.jsonship at1.0.0.
📝 Docs (this release)
README.md— rewrite: web app + desktop sections, updated Quick Links table, new architecture diagram, refreshed contribute paths, refreshed docs index.CHANGELOG.md— this entry consolidating phases 1 → 8.docs/ACKNOWLEDGEMENTs.md— refreshed with phase-by-phase AI assistance breakdown (Grok v1; Claude for v2 + the entire web/desktop layer + this changelog).web/README.md— phase 8 status appended.
🛠️ Pipelines unchanged
- All 9 v2.x Python pipeline workflows (update-json, generate-tables, top-online, update-reviews, dead-link-check, purge-unhealthy, ingest-new, ingest-from-issue, refetch-all) keep their schedules and behaviour. Two new workflows added:
deploy-pages.yml(Phase 1) andrelease-desktop.yml(Phase 8).