Wails + Vite + React + Tailwind CSS v4 + shadcn/ui + TypeScript

A modern Wails template featuring the latest technologies for building beautiful desktop applications.

🚀 Features

• Wails v2.11.0 - Build desktop apps using Go & Web Technologies
• React 18.3 - Modern React with hooks
• TypeScript 5.7 - Type safety and better DX
• Vite 5.4 - Lightning-fast HMR and build tool
• Tailwind CSS v4 - Latest Tailwind with new Vite plugin
• shadcn/ui - Beautiful, accessible component library
• ESLint 9 - Code quality with flat config
• Cross-platform build scripts - Easy builds for Windows, macOS, and Linux

📦 Installation

wails init -n myapp -t https://github.com/Mahcks/wails-vite-react-tailwind-shadcnui-ts
cd myapp

🛠️ Development

Run the app in development mode with hot reload:

wails dev

The frontend dev server runs on http://localhost:5173 with Vite's fast HMR.

🏗️ Building

Current Platform

wails build
# or
./scripts/build.sh

Cross-Platform Builds

# Build for all platforms
./scripts/build-all.sh

# Individual platforms
./scripts/build-windows.sh      # Windows AMD64
./scripts/build-linux.sh         # Linux AMD64
./scripts/build-macos-arm.sh     # macOS Apple Silicon
./scripts/build-macos-intel.sh   # macOS Intel
./scripts/build-macos-universal.sh  # macOS Universal Binary

Built applications will be in build/bin/

🎨 shadcn/ui Components

This template includes pre-configured shadcn/ui components:

• Button
• Input
• Label
• Card

Add more components:

npx shadcn@latest add [component-name]

Browse components at ui.shadcn.com

📁 Project Structure

.
├── app.tmpl.go              # Main application logic
├── main.tmpl.go             # Entry point
├── frontend/
│   ├── src/
│   │   ├── App.tsx          # Main React component
│   │   ├── components/ui/   # shadcn/ui components
│   │   └── lib/utils.ts     # Utility functions
│   ├── vite.config.ts       # Vite configuration
│   └── package.json         # Frontend dependencies
└── scripts/                 # Build scripts

🔧 Configuration

Project configuration is in wails.json (auto-generated on wails init).

See Wails documentation for all options.

📚 Learn More

• Wails Documentation
• React Documentation
• Vite Documentation
• Tailwind CSS Documentation
• shadcn/ui Documentation

📝 License

This template is available as open source under the terms of the MIT License.