tauri-shadcn-vite-project/README.md

🚀 Tauri + React + shadcn/ui Template

一个生产就绪的桌面应用模板，集成了现代前端技术栈和最佳实践。

✨ 特性

• 🎯 Tauri 2.0 - 使用 Rust 构建跨平台桌面应用
• ⚛️ React 19 - 最新的 React 版本，支持现代特性
• 🎨 shadcn/ui - 美观、可访问的 UI 组件库
• 🎨 Tailwind CSS 4.0 - 实用优先的 CSS 框架
• 📝 TypeScript - 完整的类型安全支持
• 🔧 ESLint - 代码质量检查和格式化
• 📱 响应式设计 - 支持多种屏幕尺寸
• 🌙 深色模式 - 内置主题切换支持

🏗️ 项目结构

tauri-app/
├── src/                    # React 前端源码
│   ├── components/         # UI 组件
│   │   └── ui/            # shadcn/ui 组件
│   ├── lib/               # 工具函数和配置
│   ├── App.tsx            # 主应用组件
│   └── index.css          # 全局样式
├── src-tauri/             # Rust 后端源码
│   ├── src/               # Rust 源代码
│   └── Cargo.toml         # Rust 依赖配置
├── components.json         # shadcn/ui 配置
├── package.json            # Node.js 依赖
└── README.md              # 项目文档

🚀 快速开始

前置要求

• Node.js (推荐 18+)
• pnpm (包管理器)
• Rust (Tauri 后端)

安装依赖

pnpm install

开发模式

pnpm tauri dev

构建应用

pnpm tauri build

🎨 使用 shadcn/ui 组件

添加新组件

npx shadcn@latest add [component-name]

可用组件

• button - 按钮组件
• card - 卡片组件
• input - 输入框组件
• dialog - 对话框组件
• dropdown-menu - 下拉菜单
• form - 表单组件
• table - 表格组件

🔧 配置说明

TypeScript 配置

项目使用 TypeScript 5.8+，支持：

• 路径别名 (@/*)
• 严格类型检查
• 现代 ES 特性

Tailwind CSS 配置

• 使用 Tailwind CSS 4.0
• 支持 CSS 变量和主题
• 响应式设计工具

ESLint 配置

• React Hooks 规则
• TypeScript 支持
• 代码质量检查

📱 桌面应用特性

Tauri 命令

在 src-tauri/src/lib.rs 中定义 Rust 函数：

#[tauri::command]
fn greet(name: &str) -> String {
    format!("Hello, {}!", name)
}

在前端调用：

import { invoke } from '@tauri-apps/api/core';

const message = await invoke('greet', { name: 'World' });

平台支持

• ✅ Windows
• ✅ macOS
• ✅ Linux
• ✅ Android (实验性)

🎯 开发指南

添加新页面

1. 在 src/ 目录创建新组件
2. 使用 shadcn/ui 组件构建界面
3. 在路由中添加新页面

自定义主题

修改 src/index.css 中的 CSS 变量：

:root {
  --background: oklch(1 0 0);
  --foreground: oklch(0.145 0 0);
  /* 更多变量... */
}

添加新依赖

pnpm add [package-name]

🚀 部署

构建生产版本

pnpm tauri build

发布到应用商店

• Windows: Microsoft Store
• macOS: Mac App Store
• Linux: AppImage, Snap, Flatpak

🤝 贡献

欢迎提交 Issue 和 Pull Request！

📄 许可证

MIT License

🙏 致谢

• Tauri - 跨平台桌面应用框架
• shadcn/ui - 美观的 UI 组件
• Tailwind CSS - 实用优先的 CSS 框架
• React - 用户界面库

---

🎉 开始构建你的下一个桌面应用吧！