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
---
title: Guide
---

# Guide

**tauri-plugin-widgets** renders home-screen and desktop widgets from one declarative JSON config across Android, iOS, macOS, Windows, and Linux.

<div class="doc-illust">

![From one JSON config to native widget surfaces](/illustrations/guide.jpg)

</div>

App code calls `setWidgetConfig` → plugin host writes shared storage → native renderers (Glance, WidgetKit, `widget.html`, Adaptive Cards) read and draw.

## What it is

- Shared **widget IR** (`WidgetConfig` / `WidgetElement`) defined in Rust, generated for TypeScript
- Platform backends that map that IR to Glance, SwiftUI, HTML, or Adaptive Cards
- Host APIs for config, key/value data, actions, diagnostics, desktop windows

## What it is not

- A visual designer
- A guarantee that every extended element looks identical everywhere — see [Core vs extended]/guide/tiers

## Path

1. [Install]/guide/install
2. [First widget]/guide/first-widget (desktop)
3. [Concepts]/guide/concepts · [Transport]/guide/transport
4. [Platform setup]/guide/setup/ when you need a native surface
5. [Elements]/elements/ · [Showcase]/showcase

Contributor docs: [Contributing](/contributing/).