英文原文正文为项目原始 README（英文），本站后续会翻译为中文，当前仅剔除图片与无关章节并统一排版。

⚡ Scaffold Tauri desktop apps with shadcn/ui and desktop-ready defaults.

Choose Vite, Next.js, React Router, Astro, or TanStack Start. Upstream CLIs build the foundation; tauri-ui adds the native shell and optional batteries.

开始使用

bunx create-tauri-ui@latest

Each release includes a demo build showing the expected output — available in Releases.

搭建后

cd my-app
bun run tauri dev

• swap icons: bunx tauri icon ./app-icon.png
• add shadcn components: bunx shadcn@latest add dialog sonner
• add tauri plugins: bun run tauri add store (plugin list)
• batteries live in src/components/ (debug-panel, external-link-guard, theme-provider)
• tweak window defaults in src-tauri/tauri.conf.json
• CLI flags + opt-outs → packages/create-tauri-ui

🔋 包含电池

👩‍💻 Desktop defaults

• no startup flash (hidden until first paint)
• external links open in system browser
• no overscroll / rubber-band scrolling
• desktop-style selection behavior
• sensible default window size and position

➕ Extras (optional)

• starter dashboard (dashboard-01)
• Rust invoke example
• smaller binary output (~65% smaller binary in our test)
• GitHub Actions release workflow

🛠 Debug Panel  ·  Cmd / Ctrl + D

• inspects app state, route, window, tracked invokes, runtime events, plugin logs, and system paths
• live host diagnostics: theme & a11y, locale, display, input, network
• hover any field for the source snippet with a web / tauri origin chip — click to copy
• dev-only, zero production impact — dockable and remembers its layout

🧱 Upstream UI

• shadcn frontend generated via official CLI
• no forks, always up to date
• adapters for vite, next, react-router, astro, start

为什么选择 tauri-ui

A fresh Tauri app feels like a wrapped website. Window state, startup flash, link routing, overscroll, native selection: chores you hit on every project.

tauri-ui handles them by default and stays close to upstream shadcn and create-tauri-app. Nothing forks, nothing drifts from the docs.

🦾 Better with AI coding agents: familiar shadcn + Tauri structure, built on upstream APIs without custom wrappers or forks.

它是如何工作的

cli prompts
  → official shadcn/ui init
  → official create-tauri-app setup
  → combine frontend + native shell
  → apply desktop-ready defaults
  → add optional batteries

No full local templates. Just a small asset and patch surface on top of the upstream CLIs.

搭建后管理电池

Run inside an existing tauri-ui project to add, update, or remove batteries without re-scaffolding:

Template auto-detected (no manifest file written to your repo), updates are idempotent; commit first and review the diff.

bunx create-tauri-ui@latest list                  # show install status
bunx create-tauri-ui@latest update debug-panel    # pull the latest template
bunx create-tauri-ui@latest add workflow          # add the release workflow later
bunx create-tauri-ui@latest remove workflow

🧑‍🍳 使用 tauri-ui 构建

• speedbox — internet and DNS speed test desktop app.

Built something with tauri-ui? Open a PR adding it to this list — one line with a link and a short description.

📖 CLI reference and full options → packages/create-tauri-ui

许可证

MIT