The Wails CLI

The Wails CLI is a command line tool that allows you to create, build and run Wails applications. There are a number of commands related to tooling, such as icon generation and asset bundling.

Commands

task

The task command is for running tasks defined in Taskfile.yml. It is a wrapper around Task.

generate

The generate command is used to generate resources and assets for your Wails project. It can be used to generate many things including:

application icons,
resource files for Windows applications
Info.plist files for macOS deployments

icon

The icon command generates icons for your project.

Flag	Type	Description	Default
`-example`	bool	Generates example icon file (appicon.png)
`-input`	string	The input image file
`-sizes`	string	The sizes to generate in .ico file (comma separated)	"256,128,64,48,32,16"
`-windowsFilename`	string	The output filename for the Windows icon	icon.ico
`-macFilename`	string	The output filename for the Mac icon bundle	icons.icns

bash

wails3 generate icon -input myicon.png -sizes "32,64,128" -windowsFilename myicon.ico -macFilename myicon.icns

This will generate icons for mac and windows and save them in the current directory as myicon.ico and myicons.icns.

syso

The syso command generates a Windows resource file (aka .syso).

bash

wails3 generate syso <options>

Flag	Type	Description	Default
`-example`	bool	Generates example manifest & info files
`-manifest`	string	The manifest file
`-info`	string	The info.json file
`-icon`	string	The icon file
`-out`	string	The output filename for the syso file	`wails.exe.syso`
`-arch`	string	The target architecture (amd64,arm64,386)	`runtime.GOOS`

If -example is provided, the command will generate example manifest and info files in the current directory and exit.

If -manifest is provided, the command will use the provided manifest file to generate the syso file.

If -info is provided, the command will use the provided info.json file to set the version information in the syso file.

NOTE: We use winres to generate the syso file. Please refer to the winres documentation for more information.

NOTE: Whilst the tool will work for 32-bit Windows, it is not supported. Please use 64-bit.

defaults

bash

wails3 generate defaults

This will generate all the default assets and resources in the current directory.

bindings

bash

wails3 generate bindings

Generates bindings and models for your bound Go methods and structs.