{"id":28503198,"url":"https://github.com/zingerlittlebee/tauri-react-template","last_synced_at":"2025-07-05T12:30:51.191Z","repository":{"id":296497932,"uuid":"993586828","full_name":"ZingerLittleBee/tauri-react-template","owner":"ZingerLittleBee","description":"A modern, production-ready template for building cross-platform desktop applications with Tauri, React, and a carefully curated set of tools and libraries.","archived":false,"fork":false,"pushed_at":"2025-07-01T01:29:42.000Z","size":294,"stargazers_count":0,"open_issues_count":8,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-02T01:08:24.751Z","etag":null,"topics":["immer","shadcn-ui","taildwindcss","tauri","tauri-react","tauri-template","tauri-vite","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ZingerLittleBee.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-31T04:37:19.000Z","updated_at":"2025-06-03T15:06:28.000Z","dependencies_parsed_at":"2025-05-31T16:49:15.730Z","dependency_job_id":"ed0391e9-0f14-483e-84f7-0b7ec18955c1","html_url":"https://github.com/ZingerLittleBee/tauri-react-template","commit_stats":null,"previous_names":["zingerlittlebee/tauri-react-template"],"tags_count":0,"template":true,"template_full_name":null,"purl":"pkg:github/ZingerLittleBee/tauri-react-template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZingerLittleBee%2Ftauri-react-template","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZingerLittleBee%2Ftauri-react-template/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZingerLittleBee%2Ftauri-react-template/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZingerLittleBee%2Ftauri-react-template/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ZingerLittleBee","download_url":"https://codeload.github.com/ZingerLittleBee/tauri-react-template/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZingerLittleBee%2Ftauri-react-template/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263741597,"owners_count":23504274,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["immer","shadcn-ui","taildwindcss","tauri","tauri-react","tauri-template","tauri-vite","typescript"],"created_at":"2025-06-08T17:06:36.288Z","updated_at":"2025-07-05T12:30:51.185Z","avatar_url":"https://github.com/ZingerLittleBee.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Tauri React Template\n\n[中文文档](./README.zh-CN.md)\n\nA modern, production-ready template for building cross-platform desktop applications with Tauri, React, and a carefully curated set of tools and libraries.\n\n## ✨ Features\n\n- 🚀 **Tauri 2.0** - Build smaller, faster, and more secure desktop applications\n- ⚛️ **React 18** - Modern React with hooks and concurrent features\n- ⚡ **Vite** - Lightning fast build tool and development server\n- 🎨 **Shadcn/ui** - Beautiful and accessible UI components\n- 🐻 **Zustand** - Simple and scalable state management\n- 💾 **Tauri Store** - Persistent storage with Zustand integration\n- 🎯 **TailwindCSS 4** - Utility-first CSS framework with latest features\n- 📏 **ESLint + Prettier** - Code formatting and linting\n- 🔧 **Import Sorting** - Automatic import organization\n- 🎨 **Tailwind Linting** - TailwindCSS class sorting and validation\n- 📱 **TypeScript** - Full type safety\n\n## 🛠️ Tech Stack\n\n- **Frontend**: React 18 + TypeScript + Vite\n- **Desktop**: Tauri 2.0\n- **UI Components**: Shadcn/ui + Radix UI\n- **Styling**: TailwindCSS 4 + Lucide Icons\n- **State Management**: Zustand + Immer\n- **Persistence**: Tauri Plugin Store\n- **Code Quality**: ESLint + Prettier + TypeScript\n- **Build Tool**: Vite 6\n\n## 📦 Prerequisites\n\nBefore you begin, ensure you have the following installed:\n\n- [Node.js](https://nodejs.org/) (v18 or higher)\n- [pnpm](https://pnpm.io/) (recommended) or npm/yarn\n- [Rust](https://rustup.rs/) (latest stable)\n- [Tauri Prerequisites](https://tauri.app/v2/guides/getting-started/prerequisites)\n\n## 🚀 Quick Start\n\n1. **Clone the repository**\n   ```bash\n   git clone https://github.com/ZingerLittleBee/tauri-react-template.git\n   cd tauri-react-template\n   ```\n\n2. **Install dependencies**\n   ```bash\n   pnpm i\n   ```\n\n3. **Start development server**\n   ```bash\n   pnpm tauri dev\n   ```\n\n4. **Build for production**\n   ```bash\n   pnpm tauri build\n   ```\n\n## 📝 Available Scripts\n\n- `pnpm dev` - Start Vite development server\n- `pnpm build` - Build for production\n- `pnpm preview` - Preview production build\n- `pnpm tauri dev` - Start Tauri development mode\n- `pnpm tauri build` - Build Tauri application\n- `pnpm lint` - Run ESLint with auto-fix\n- `pnpm format` - Format code with Prettier\n\n## 🏗️ Project Structure\n\n```\ntauri-react-template/\n├── src/                    # React source code\n│   ├── components/         # React components\n│   ├── lib/               # Utility functions and configurations\n│   ├── stores/            # Zustand stores\n│   └── main.tsx           # Application entry point\n├── src-tauri/             # Tauri backend code\n│   ├── src/               # Rust source code\n│   ├── Cargo.toml         # Rust dependencies\n│   └── tauri.conf.json    # Tauri configuration\n├── public/                # Static assets\n└── package.json           # Node.js dependencies and scripts\n```\n\n## 🎨 UI Components\n\nThis template includes a pre-configured Shadcn/ui setup with:\n\n- Beautiful and accessible components\n- Dark/light theme support\n- Customizable design system\n- TailwindCSS integration\n\nTo add new components:\n```bash\npnpm dlx shadcn@latest add button\n```\n\n## 🐻 State Management\n\nZustand is configured with:\n\n- **Immer integration** for immutable updates\n- **Tauri Store persistence** for data that survives app restarts\n- **TypeScript support** for type-safe stores\n\nExample store with Immer:\n```bash\nsrc/store/immer/immer-store.ts\n```\n\nExample store with persistence:\n```typescript\nimport { create } from 'zustand'\nimport { persist } from 'zustand/middleware'\nimport { tauriStorage } from './tauri-storage'\n\ninterface AppState {\n  count: number\n  increment: () =\u003e void\n}\n\nexport const useAppStore = create\u003cAppState\u003e()(\n  persist(\n    (set) =\u003e ({\n      count: 0,\n      increment: () =\u003e set((state) =\u003e ({ count: state.count + 1 })),\n    }),\n    {\n      name: 'app-storage',\n      storage: tauriStorage,\n    }\n  )\n)\n```\n\n## 🔧 Configuration\n\n### ESLint \u0026 Prettier\n\nThe project includes a comprehensive ESLint and Prettier setup with:\n\n- React-specific rules\n- TypeScript support\n- Import sorting with `@ianvs/prettier-plugin-sort-imports`\n- TailwindCSS class sorting with `prettier-plugin-tailwindcss`\n\n### TailwindCSS 4\n\nConfigured with:\n- Latest TailwindCSS 4 features\n- Custom design tokens\n- Responsive design utilities\n- Dark mode support\n\n## 🚀 Building for Production\n\nTo create a production build:\n\n```bash\npnpm tauri build\n```\n\nThis will create platform-specific installers in the `src-tauri/target/release/bundle/` directory.\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🤝 Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## 📚 Resources\n\n- [Tauri Documentation](https://tauri.app/)\n- [React Documentation](https://react.dev/)\n- [Vite Documentation](https://vitejs.dev/)\n- [Shadcn/ui Documentation](https://ui.shadcn.com/)\n- [Zustand Documentation](https://zustand-demo.pmnd.rs/)\n- [TailwindCSS Documentation](https://tailwindcss.com/)\n\n---\n\nMade with ❤️ by [ZingerLittleBee](https://github.com/ZingerLittleBee)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzingerlittlebee%2Ftauri-react-template","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzingerlittlebee%2Ftauri-react-template","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzingerlittlebee%2Ftauri-react-template/lists"}