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>
4.3 KiB
4.3 KiB
v3.4.0 – 2026-06-13 (The "Legal Consent Gate" Edition)
Feature release on top of v3.3.0 adding an explicit, up-front acceptance of the project's legal documents on both surfaces: a first-run consent gate in the app (web + desktop) and a real license-agreement page in the Windows installer. No backend, no cookies — acceptance is a single localStorage flag, versioned so it can re-prompt when the terms change, and naturally fresh in incognito/private tabs. Web app + desktop bumped 1.3.0 → 1.4.0. Repo public-facing version 3.3.0 → 3.4.0. Tag v3.4.0 is GPG-signed; companion desktop tag is desktop-v1.4.0.
⚖️ First-run consent gate (web + desktop)
- New ConsentGate.tsx — a full-screen card (styled like the error pages, eager bundle, no flash) that blocks the main UI until the user ticks a checkbox and clicks Continue. Mounted inside
AppErrorBoundary+HashRouterin main.tsx, wrapping<App/>(the<Toaster/>stays a sibling). A gate crash is still caught by the top-level boundary. - Decline path — explicit Decline button: on desktop (Tauri) it quits the app via
getCurrentWindow().close(); on web it shows a blocking "you need to accept" notice with a way back to the gate. - Persistence — new stores/consent.ts (Zustand, same pattern as
stores/gpg.ts):localStoragekeyf2p:legal_consentholding{ version, acceptedAt }. ATERMS_VERSIONconstant gates validity — bump it when the legal docs change materially and everyone is re-prompted. Incognito tabs get a fresh storage partition, so the gate re-shows there with zero extra code. No cookie is used anywhere (there is no server to read one). - Error routes pass through — the gate lets
#/error/*render even before consent, so a mid-session chunk-load 503, the Pages404.htmlredirect, or an#/error/:codedeep link still reaches the user instead of being swallowed. - Doc links — the gate's five binding documents (MIT License, EULA, Privacy Policy, Disclaimer, Terms of Use) open through the existing external-open.ts
openExternal()helper, so they work inside the Tauri webview (which blockswindow.opento external HTTPS) as well as on the web. - Shared legal list — the
LEGAL_DOCSarray (label / path / hint) was lifted out of About.tsx into a reusable lib/legal.ts (LEGAL_DOCS,CONSENT_DOCS,legalDocUrl()); About now imports it instead of holding a private copy. - New
consent.*i18n keys added to both en.json and vi.json. Long-form legal copy stays English (the doc labels come fromLEGAL_DOCS); only the gate chrome is bilingual.
🪟 Windows installer license page
- tauri.conf.json now sets
bundle.licenseFileto a new LICENSE_AGREEMENT.rtf. Tauri v2 surfaces this as a mandatory "I Agree" license page in both Windows targets built bytargets: "all"— the NSIS-setup.exe(MUI license page) and the WiX.msi(which requires RTF). The RTF is plain ASCII with no BOM to avoid the known NSIS license-encoding bug. - The installer gate (install-time, desktop-only) and the in-app gate (first-run, web + desktop, re-promptable) are intentionally both kept: the auto-updater replaces the binary without re-running the installer, so the in-app
TERMS_VERSIONmechanism is the only way to re-prompt updated installs. - Desktop window-close on decline needs the
core:window:allow-closepermission, now added to capabilities/default.json. New dependency@tauri-apps/api(official, lazy-imported only on the desktop decline path — no web-bundle bloat).
🧰 Tooling & misc
- Version bumped across the three desktop files (web/package.json, tauri.conf.json, Cargo.toml) →
1.4.0; the stale README version badge corrected3.2.7→3.4.0. - Pre-publish suite (
typecheck,knip,npm audit,vulture,pip-audit) re-run clean.