tauri-plugin-widgets 0.4.3

Tauri plugin for App Widgets on Android, iOS, and macOS (WidgetKit); Windows Widgets Board (Adaptive Cards) + desktop webview; Linux desktop webview with X11 DESKTOP pin.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32

---
title: Environment variables
---

# Environment variables

| Variable | Scope | Default | Description |
|----------|-------|---------|-------------|
| `WIDGET_TRANSPORT` | Apple host | `plugins.widgets.transport` | Override: `appGroup` \| `userDefaults` \| `widgetContainer` \| `auto`. |
| `WIDGET_SIGN_IDENTITY` | macOS (`build-widget.sh`) | `APPLE_SIGNING_IDENTITY` or ad-hoc (`-`) | Signing identity for the `.appex` before bundling. |
| `WIDGET_DEBUG` | Host runtime | off in release | Set to `1` to enable the in-memory delivery journal (`getWidgetTrace`) in release builds. Debug builds always record. |
| `TAURI_WIDGET_MIN_RELOAD_SECS` | **iOS / Android** plugin host (`mobile.rs`) | Debug: `0`, Release: `900` | Minimum seconds between plugin-triggered `reloadAllTimelines()`. Use `0` to disable. **Not used on the macOS/desktop host** (`desktop.rs` has no plugin-side throttle). |
| `TAURI_DEV_HOST` | Example app dev (`vite.config.ts`) | — | Dev host used by Tauri/Vite during `tauri dev` (usually set automatically). |

Examples:

```bash
# iOS / Android release: disable plugin-side reload throttle
TAURI_WIDGET_MIN_RELOAD_SECS=0 pnpm tauri ios dev

# macOS desktop host: this env does nothing for reload (no mobile throttle).
# Stale native widgets on Mac are usually transport/nonce — not this flag.

# Force widget-container transport without editing tauri.conf.json
WIDGET_TRANSPORT=widgetContainer pnpm tauri dev

# macOS build with explicit signing identity for the .appex
WIDGET_SIGN_IDENTITY="Apple Development: you@example.com (TEAMID)" \
  pnpm tauri build
```

---