Skip to content
Wails Blog

Building Applications

Wails v3 uses Task as its build system. The wails3 build and wails3 package commands are convenient wrappers around Task.

Building

Section titled “Building”

Build for the current platform:

Terminal window
wails3 build

Build for a specific platform:

Terminal window
wails3 build GOOS=windows
wails3 build GOOS=darwin
wails3 build GOOS=linux


# With architecture
wails3 build GOOS=darwin GOARCH=arm64


# Environment variable style works too
GOOS=windows wails3 build

Output goes to the bin/ directory.

Development

Section titled “Development”

Run your application with hot reload:

Terminal window
wails3 dev

This starts a file watcher that rebuilds and restarts your app on changes. The frontend dev server runs on port 9245 by default.

Terminal window
# Custom port
wails3 dev -port 3000


# Enable HTTPS
wails3 dev -s

Packaging

Section titled “Packaging”

Package your app for distribution:

Terminal window
wails3 package
wails3 package GOOS=windows
wails3 package GOOS=darwin
wails3 package GOOS=linux

This creates platform-specific packages:

Custom Build Tags

Section titled “Custom Build Tags”

Pass custom Go build tags with the -tags flag:

Terminal window
# Build with experimental GTK4 support on Linux
wails3 build -tags gtk4


# Build in server mode (no GUI, CGO-free)
wails3 build -tags server


# Combine multiple tags
wails3 build -tags gtk4,customtag

Tags are forwarded as EXTRA_TAGS to the underlying Taskfile. See Server Build and Linux Packaging - GTK4 for details.

Using Task Directly

Section titled “Using Task Directly”

For more control, use Task directly:

Terminal window
# List available tasks
wails3 task --list


# Verbose output
wails3 task build -v


# Dry run
wails3 task --dry


# Force rebuild
wails3 task build -f


# Pass variables
wails3 task darwin:build ARCH=amd64

Platform-specific tasks like linux:create:deb or darwin:build:universal are only available through Task.

Generating Assets

Section titled “Generating Assets”

Regenerate icons or update build configuration:

Terminal window
wails3 generate icons -input build/appicon.png
wails3 update build-assets -name "MyApp" -config build/config.yml -dir build