Skip to content

chore(deps): upgrade Tauri - #1412

Merged
ocavue merged 6 commits into
masterfrom
chore/upgrade-tauri
Oct 2, 2026
Merged

ocavue merged 6 commits into
masterfrom
chore/upgrade-tauri

Conversation

@ocavuebot

@ocavuebot ocavuebot commented Oct 2, 2026 •

Copy link
Copy Markdown
Collaborator

Summary

Upgrade Tauri core, CLI, and related official plugins to the latest stable versions that are at least 24 hours old (aligned with this repo’s Renovate minimumReleaseAge: 1 days for grouped npm deps). Skipped Tauri 3.0 alphas and any release published within the last 24 hours.

pnpm-workspace.yaml is unchanged.

Version selection

Resolved against crates.io / npm registry publish times as of ~2026-10-02 03:20 UTC. Cutoff: published ≤ 2026-10-01 03:20 UTC. Prereleases (alpha/rc) were excluded.

Upgrades

Core (Rust)

Crate Before After Release / changelog
tauri 2.12.0 2.12.1 tauri-v2.12.1
tauri-build 2.7.0 2.7.1 tauri-build-v2.7.1
tauri-plugin 2.7.0 2.7.1 tauri-plugin-v2.7.1

What changed (from release notes):

  • tauri 2.12.0 → 2.12.1: Bug fix — macos-private-api / macOSPrivateAPI is no longer required to use transparency or fullscreen on macOS (#16166). Also bumps internal deps (tauri-utils/runtime/runtime-wry/build/macros).
  • tauri-build 2.7.0 → 2.7.1: Bug fix — correctly copy WebView2Loader.dll for Windows GNU targets when using Cargo’s new nightly build-directory layout (#16164).
  • tauri-plugin 2.7.0 → 2.7.1: Bug fix — skip Android/iOS project setup in Builder::build / try_build on docs.rs (read-only mounts) so plugins with native mobile projects can build docs for mobile targets (#16186).

Official plugins (Rust)

Crate Before After Release / changelog
tauri-plugin-opener 2.6.0 2.7.0 opener-v2.7.0
tauri-plugin-dialog 2.8.0 2.8.1 dialog-v2.8.1
tauri-plugin-updater 2.13.0 2.13.1 updater-v2.13.1
tauri-plugin-deep-link 2.5.0 2.6.1 deep-link-v2.6.0 · deep-link-v2.6.1
tauri-plugin-single-instance 2.5.0 2.5.2 single-instance-v2.5.1 · single-instance-v2.5.2

Unchanged (already latest eligible stable): tauri-plugin-http 2.8.0, tauri-plugin-process 2.4.0, tauri-plugin-window-state 2.5.0, tauri-plugin-iap 0.9.1 (newer 0.10.0-rc.* only).

What changed (from release notes):

  • tauri-plugin-opener 2.6.0 → 2.7.0: Updated Windows deps (windows → 0.62). Public Error::Win32Error wraps windows::core::Error (#3480).
  • tauri-plugin-dialog 2.8.0 → 2.8.1: Fix docs.rs Android build — build script detects docs.rs via DOCS_RS (569ee82).
  • tauri-plugin-updater 2.13.0 → 2.13.1: Updated windows-sys to 0.61 (#3480); bumped dirs to v7 (#3573); bumped infer to 0.22 (#3501).
  • tauri-plugin-deep-link 2.5.0 → 2.6.1: 2.6.0 updated Windows registry/result crates (#3480); 2.6.1 same docs.rs Android build-script fix as dialog.
  • tauri-plugin-single-instance 2.5.0 → 2.5.2: 2.5.1 updated windows-sys to 0.61 and deep-link to 2.6.0; 2.5.2 upgrades deep-link dependency to 2.6.1.

npm (@tauri-apps/*)

Package Before After Release / changelog
@tauri-apps/api ^2.12.0 ^2.12.1 @tauri-apps/api-v2.12.1
@tauri-apps/cli ^2.12.0 ^2.12.1 tauri-cli-v2.12.1
@tauri-apps/plugin-deep-link ^2.5.0 ^2.6.1 deep-link-js-v2.6.1
@tauri-apps/plugin-dialog ^2.8.0 ^2.8.1 dialog-js-v2.8.1
@tauri-apps/plugin-http ^2.7.0 ^2.8.0 http-js-v2.8.0
@tauri-apps/plugin-opener ^2.6.0 ^2.7.0 opener-js-v2.7.0
@tauri-apps/plugin-updater ^2.13.0 ^2.13.1 updater-js-v2.13.1

Unchanged: @tauri-apps/plugin-process ^2.4.0 (already latest eligible).

What changed (from release notes):

  • @tauri-apps/api 2.12.0 → 2.12.1: Same macOS transparency/fullscreen private-API fix as core (#16166).
  • @tauri-apps/cli 2.12.0 → 2.12.1: Enhancement — ignore src-tauri in tauri plugin init example template (#16165).
  • Plugin JS packages: Version bumps mirror the Rust plugin releases above. @tauri-apps/plugin-http 2.8.0 is a re-release of the 2.7.0 JS package to align with the Rust crate major/minor (#3656).

Files touched

  • Cargo.toml (workspace tauri / tauri-plugin)
  • apps/desktop/src-tauri/Cargo.toml
  • apps/desktop/package.json
  • Cargo.lock, pnpm-lock.yaml

Verification

  • pnpm typecheck — pass
  • pnpm lint — pass
  • pnpm build — pass
  • Cargo lock regenerated with cargo update for the bumped crates (MSRV note: these crates require Rust 1.90+; CI uses dtolnay/rust-toolchain stable)

Summary by CodeRabbit

  • Updates
    • Updated the desktop app’s underlying platform components to newer versions. No changes to app features are noted.
  • Documentation
    • Added guidance for maintaining dependencies, including version selection, local validation, and pull request requirements.

Bump Tauri core/CLI and official plugins (Rust + npm) to the newest
stable versions published at least 24 hours ago. Leave
pnpm-workspace.yaml untouched.
@coderabbitai

coderabbitai Bot commented Oct 2, 2026 •

Copy link
Copy Markdown

Review in Change Stack →

Navigate logical layers of code changes, visualize relationships, and explore their blast radius.

Note

Currently processing new changes in this PR. This may take a few minutes, please wait...

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Advanced

Run ID: 2462d5e1-e100-40e6-861e-b59fc06710d9

📥 Commits

Reviewing files that changed from the base of the PR and between 0c4d098 and 2fc8085.

⛔ Files ignored due to path filters (2)
  • Cargo.lock is excluded by !**/*.lock
  • pnpm-lock.yaml is excluded by !**/pnpm-lock.yaml
📒 Files selected for processing (6)
  • CONTRIBUTING.md
  • Cargo.toml
  • apps/desktop/package.json
  • apps/desktop/src-tauri/Cargo.toml
  • apps/desktop/src-tauri/src/web_fetch.rs
  • docs/contributing/upgrading-dependencies.md
 _____________________________________________________________________
< This is 'temporary' in the same way legacy systems are 'temporary'. >
 ---------------------------------------------------------------------
  \
   \   (\__/)
       (•ㅅ•)
       /   づ
✨ Finishing Touches
📝 Generate docstrings
  • Commit to this branch
  • Create a new PR
🧪 Generate unit tests (beta)
  • Commit to this branch
  • Create a new PR
  • Autopilot · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Autopilot is currently an internal CodeRabbit preview.


Comment @coderabbitai help to get the list of available commands.

Rust stable renamed AtomicUsize::fetch_update to try_update; clippy
with -D warnings fails the Tauri upgrade CI on this call site.
@ocavuebot ocavuebot changed the title chore(deps): upgrade Tauri and plugins to latest age-gated releases chore(deps): upgrade Tauri Oct 2, 2026
@ocavuebot

ocavuebot commented Oct 2, 2026 •

Copy link
Copy Markdown
Collaborator Author

Canonical guide: docs/contributing/upgrading-dependencies.md (also linked from CONTRIBUTING.md). Prefer that file over this comment; the comment below is retained as a short checklist mirror.

Bot reference: dependency upgrade playbook (Tauri / Node+Rust monorepo)

This comment is lasting documentation for other bots doing dep upgrades on team-reflect/reflect-open. Follow it end-to-end.

Hard rules

  1. min-release-age ≥ 24 hours — only take versions whose registry publish/release time is at least 24h before now. Skip prereleases (alpha/beta/rc) unless the task explicitly allows them. Align with Renovate’s minimumReleaseAge: "1 days" for grouped npm deps (renovate.json → github>ocavue/config-renovate).
  2. Edit source manifests, not only lockfiles — bump pins in package.json, Cargo.toml / workspace [workspace.dependencies], etc., then regenerate locks (pnpm-lock.yaml, Cargo.lock).
  3. Never change pnpm-workspace.yaml — verify with git diff -- pnpm-workspace.yaml (must be empty) before commit.
  4. No fork — push the branch directly to team-reflect/reflect-open (gh as a bot with push+maintain).
  5. Draft PR only for automated dep bumps: gh pr create --draft.
  6. PR title format — chore(deps): update XXXX (or chore(deps): upgrade Tauri for a Tauri stack bump). Keep it short; CI enforces conventional commits via the PR title.
  7. Local Node and Rust build + lint must pass before opening / treating the PR as ready. Then watch CI until green; fix and push until all-green passes.
  8. Work under /workspace/reflect-open (or a fresh clone), branch from latest origin/master (do not build on a stale detached HEAD).

Find what to upgrade

git fetch origin master
git checkout -B chore/upgrade-<name> origin/master

# JS / npm (@tauri-apps/* etc.)
git grep -nE '@tauri-apps|tauri' -- '**/package.json' 'package.json'

# Rust crates
git grep -nE 'tauri' -- '**/Cargo.toml' 'Cargo.toml'

Resolve latest eligible versions from npm + crates.io (User-Agent required for crates.io API). Prefer matching majors across Tauri core and plugins (stay on Tauri 2.x until a deliberate 3.x migration).

Commands — Node (pnpm)

packageManager is pinned in root package.json (currently pnpm@11.27.1). Prefer pnpm everywhere.

corepack enable
pnpm install                          # regenerate pnpm-lock.yaml after package.json edits
pnpm typecheck
pnpm lint                             # oxfmt + oxlint + eslint
pnpm build                            # turbo build (desktop vite, etc.)
# optional targeted tests:
# pnpm test --run path/to/relevant.test.ts

Commands — Rust (cargo)

CI rust-lint = cargo fmt --all -- --check + cargo clippy --workspace --all-targets -- -D warnings.
CI rust-test = cargo test --workspace.
Tauri crates currently need Rust ≥ 1.90 (use rustup stable). On Linux, install WebKit/GTK deps like .github/actions/setup-rust, and stage the CLI sidecar before compiling the desktop crate:

# toolchain
rustup component add rustfmt clippy

# Linux system deps (same set as CI setup-rust)
sudo apt-get install -y \
  libwebkit2gtk-4.1-dev libayatana-appindicator3-dev librsvg2-dev \
  libxdo-dev libssl-dev build-essential curl wget file patchelf

# after Cargo.toml bumps:
cargo update -p <crate> ...           # or cargo update for the bumped packages
node apps/desktop/scripts/build-sidecar.mjs

cargo fmt --all -- --check
cargo clippy --workspace --all-targets -- -D warnings
cargo build --workspace
# optional: cargo test --workspace

Gotcha: newer Rust stable may deprecate std APIs (e.g. AtomicUsize::fetch_update → try_update). Clippy with -D warnings fails the job; rename/fix in the same PR when the upgrade surfaces it.

Gotcha: first-party plugins under plugins/tauri-plugin-* use tauri = { workspace = true } — bumping workspace tauri / tauri-plugin is enough for those path crates.

Apply bumps consistently

For Tauri stack upgrades, bump both ecosystems in lockstep where versions exist:

Layer Examples
Workspace Rust root Cargo.toml → tauri, tauri-plugin
App Rust apps/desktop/src-tauri/Cargo.toml → tauri-build, tauri-plugin-*
App npm apps/desktop/package.json → @tauri-apps/api, @tauri-apps/cli, @tauri-apps/plugin-*

Leave packages already at the latest eligible stable unchanged (note that in the PR body). Do not take Tauri 3 alphas unless asked.

PR description requirements (detailed)

For each upgraded package/crate, include:

  • before → after version
  • real changelog / GitHub Release URL (crates: tauri-apps/tauri or tauri-apps/plugins-workspace tags; npm: matching *-js-v* / @tauri-apps/api-v* tags)
  • short summary of what that upgrade changed, taken from the release notes — do not invent

Also state: age-gate cutoff used, that pnpm-workspace.yaml is unchanged, and local verification commands that passed.

Open the draft PR + watch CI

git add Cargo.toml Cargo.lock apps/desktop/package.json apps/desktop/src-tauri/Cargo.toml pnpm-lock.yaml
# NEVER stage pnpm-workspace.yaml
git diff -- pnpm-workspace.yaml   # must be empty

git commit -m "chore(deps): upgrade Tauri"
git push -u origin HEAD

gh pr create --draft --base master --title "chore(deps): upgrade Tauri" --body-file ./pr-body.md

# watch until green
gh pr checks <n> --watch
# if red: fetch failing job logs, fix, push, re-watch
gh run view <run_id> --job <job_id> --log-failed

Required CI signal: workflow job all-green (and the underlying node-lint, node-test, rust-lint, rust-test, apple-lint, title check). Draft PRs still run CI.

Checklist before “done”

  • Source manifests + locks updated; pnpm-workspace.yaml untouched
  • Versions age-gated (≥24h) and stable
  • Local: pnpm typecheck && pnpm lint && pnpm build
  • Local: cargo fmt --check, cargo clippy -D warnings, cargo build --workspace
  • Draft PR on team-reflect/reflect-open (no fork)
  • Title = chore(deps): … short form
  • PR body has per-package before→after + changelog URLs + note summaries
  • CI green (all-green)

Document the age gate, manifest-vs-lock rules, Tauri alignment, local
Node+Rust checks, and draft PR expectations used on the Tauri upgrade.
Keep only the hard requirements bots must follow; drop redundant
checklists and long command examples.
Drop no-fork and CLI examples; allow workspace age-gate overrides; shorten
the CONTRIBUTING blurb.
Document that dep bumps must run pnpm dedupe, and apply it on this
branch (lockfile drops one duplicate package).
@ocavue
ocavue marked this pull request as ready for review October 2, 2026 04:35
@ocavue
ocavue added this pull request to the merge queue Oct 2, 2026
Merged via the queue into master with commit 47c4f7b Oct 2, 2026
14 of 15 checks passed
@ocavue
ocavue deleted the chore/upgrade-tauri branch October 2, 2026 04:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants