tauri-scaffold

Scaffold a Tauri + React App

Generate a production-ready Tauri + React desktop application with best practices baked in.

What Gets Created

my-app/
├── src/                      # React frontend
│   ├── ui/
│   │   ├── components/       # React components
│   │   ├── hooks/            # Custom hooks
│   │   └── providers/        # Context providers
│   ├── core/                 # Business logic
│   │   ├── api/              # TanStack Query queries/mutations
│   │   └── db/               # Database access layer
│   ├── App.tsx
│   └── main.tsx
├── src-tauri/                # Rust backend
│   └── src/
│       ├── lib.rs            # Tauri setup
│       ├── commands.rs       # Tauri commands
│       └── migrations.rs     # SQLite migrations
├── package.json
├── tsconfig.json
├── tailwind.config.js
└── vite.config.ts

Stack Included

• Tauri 2.x - Native desktop shell
• React 18 - UI framework
• TypeScript - Strict mode enabled
• TanStack Query - Server state management
• SQLite - Local database (via tauri-plugin-sql)
• Tailwind CSS - Styling
• Radix UI - Accessible components
• Vite - Build tool

Instructions

Step 1: Get App Details

Ask the user for:

1. App name (kebab-case, e.g., my-cool-app)
2. App display name (e.g., "My Cool App")
3. Bundle identifier (e.g., com.yourname.mycoolapp)
4. Whether to include AI provider patterns (optional)

Step 2: Create the Project

Run the scaffold script:

uv run /path/to/plugin/scripts/scaffold.py \
  --name "app-name" \
  --display-name "App Display Name" \
  --bundle-id "com.example.appname" \
  --output-dir "./app-name"

If --with-ai flag was provided, add:

  --with-ai

Step 3: Initialize the Project

After scaffolding:

cd app-name
pnpm install

Step 4: Run Development Server

pnpm tauri dev

Step 5: Guide Next Steps

Tell the user:

1. Database: Add tables in src-tauri/src/migrations.rs
2. API Layer: Create queries in src/core/api/
3. Components: Build UI in src/ui/components/
4. Tauri Commands: Add Rust commands in src-tauri/src/commands.rs

Point them to /tauri-react-starter:guide for architecture deep-dive.

Example

User: Create a new Tauri app for a note-taking application