Skip to content
Wails Blog

Setup

Quick Start

Section titled “Quick Start”
Terminal window
# 1. Install the Wails CLI
go install github.com/wailsapp/wails/v3/cmd/wails3@latest


# 2. Run the setup wizard
wails3 setup

The wizard opens in your browser and guides you through dependency checks, project defaults, and optional cross-platform build setup.

Then you’re ready for your first project:

Terminal window
wails3 init -n myapp -t vanilla
cd myapp && wails3 dev

What It Does

Section titled “What It Does”
  • Checks dependencies - Verifies Go, npm, and platform tooling
  • Configures defaults - Author info, bundle ID prefix, preferred templates
  • Cross-platform builds - Optional Docker setup for building from any host
  • Code signing - Optional setup for macOS, Windows, and Linux

Configuration is saved to ~/.config/wails/config.yaml and used by wails3 init.

Sub-Commands

Section titled “Sub-Commands”
Terminal window
wails3 setup signing      # Configure code signing
wails3 setup entitlements # Configure macOS entitlements

Having Issues?

Section titled “Having Issues?”
  1. Run wails3 doctor to diagnose problems
  2. Follow the manual installation steps
  3. Report the issue with your wails3 doctor output