README

About

This is the official Wails React-TS template.

You can configure the project by editing wails.json. More information about the project settings can be found here: https://wails.io/docs/reference/project-config

Live Development

To run in live development mode, run wails dev in the project directory. This will run a Vite development server that will provide very fast hot reload of your frontend changes. If you want to develop in a browser and have access to your Go methods, there is also a dev server that runs on http://localhost:34115. Connect to this in your browser, and you can call your Go code from devtools.

Building

Development Build

wails3 task build

This creates a development build with console output enabled (useful for debugging).

Production Build (No Console Window)

wails3 task build PRODUCTION=true

This builds with production flags that:

• Hide the console window (-H windowsgui)
• Strip debug symbols for smaller binary (-w -s)
• Remove file paths from binary (-trimpath)

Creating an Installer

To create an NSIS installer (requires NSIS to be installed):

wails3 task package

Output

The compiled executable will be located at: bin/psocompanion.exe

Build Flags Reference

Flag	Purpose
-H windowsgui	Hides the console window (Windows GUI-only app)
-w	Omits DWARF debugging info (smaller binary)
-s	Omits symbol table (smaller binary)
-trimpath	Removes file system paths from the binary
-tags production	Enables production build tags

CI/CD Pipeline

Use wails3 task build PRODUCTION=true in your pipeline. This automatically:

1. Installs frontend dependencies
2. Builds the frontend with production optimizations
3. Generates Go bindings
4. Compiles the Go binary with production flags