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

⚡ 使用 shadcn/ui 和适用于桌面的默认设置来搭建 Tauri 桌面应用。

选择 Vite、Next.js、React Router、Astro 或 TanStack Start。上游 CLI 构建基础；tauri-ui 添加本地外壳和可选功能。

开始使用

bunx create-tauri-ui@latest

每个版本都包括一个演示构建，显示预期输出——可在 Releases 获取。

搭建后

cd my-app
bun run tauri dev

• 交换图标：bunx tauri icon ./app-icon.png
• 添加 shadcn 组件：bunx shadcn@latest add dialog sonner
• 添加 tauri 插件：bun run tauri add store (插件列表)
• 组件放在 src/components/ 下（debug-panel、external-link-guard、theme-provider）
• 在 src-tauri/tauri.conf.json 中调整窗口默认设置
• CLI 标志 取消选项 → packages/create-tauri-ui

🔋 包含电池

👩‍💻 桌面默认设置

• 启动时不显示闪屏（首次绘制前隐藏）
• 外部链接在系统浏览器中打开
• 没有过度滚动/橡皮筋滚动
• 桌面风格的选择行为
• 合理的默认窗口大小和位置

➕ 附加功能（可选）

• 入门仪表板 (dashboard-01)
• Rust invoke 示例
• 更小的二进制输出（在我们的测试中二进制文件减少约65%）
• GitHub Actions 发布工作流

🛠 调试面板 · Cmd / Ctrl D

• 检查应用状态、路由、窗口、跟踪的调用、运行时事件、插件日志和系统路径
• 实时主机诊断：主题和无障碍、区域设置、显示、输入、网络
• 将鼠标悬停在任意字段上可查看带有 web / tauri 来源标签的源代码片段 — 点击即可复制
• 仅限开发使用，对生产无影响 — 可停靠且记住布局

🧱 上游 UI

• 通过官方 CLI 生成的 shadcn 前端
• 无分叉，始终保持最新
• vite、next、react-router、astro、start 的适配器

为什么选择 tauri-ui

一个全新的 Tauri 应用感觉就像一个包装过的网站。窗口状态、启动闪屏、链接路由、过度滚动、本地选择：每个项目都会遇到的琐事。

tauri-ui 默认处理它们，并且保持接近上游 shadcn 和 create-tauri-app。没有分叉，也没有偏离文档。

🦾 与 AI 编码助手更配: 熟悉的 shadcn Tauri 结构，基于上游 API 构建，无自定义包装或分叉。

它是如何工作的

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

没有完整的本地模板。只是上游 CLI 上的小型资产和补丁面。

搭建后管理电池

在现有的 tauri-ui 项目中运行，可添加、更新或移除组件，而无需重新生成脚手架：

模板自动检测（不会将清单文件写入你的仓库），更新是幂等的；请先提交并查看差异。

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 — 网络和 DNS 速度测试桌面应用。

用 tauri-ui 构建了什么东西？提交一个 PR 将它添加到此列表中 —— 一行包含链接和简短描述。

📖 CLI 参考和完整选项 → packages/create-tauri-ui

许可证

麻省理工学院