Wails — Build Desktop Apps with Go and Web Technologies

What it is

Wails is a framework for building desktop applications using Go for the backend and any web technology (React, Svelte, Vue) for the frontend. Unlike Electron, which bundles a full Chromium instance, Wails uses the operating system's native WebView. This produces binaries around 8MB instead of 150MB+.

Wails targets Go developers who need to build desktop GUIs without learning a native UI toolkit. If you already know Go and a web framework, Wails lets you combine both into a single distributable binary for Windows, macOS, and Linux.

How it saves time or tokens

Building a desktop app with native toolkits (Qt, GTK, Cocoa) requires learning platform-specific APIs. Wails eliminates this by letting you reuse existing web development skills for the UI while writing performance-critical logic in Go.

The Go-to-JavaScript binding system is automatic. You define Go methods, and Wails generates TypeScript bindings that your frontend can call directly. No REST API, no WebSocket plumbing, no serialization boilerplate.

How to use

1. Install the Wails CLI and scaffold a project:

go install github.com/wailsapp/wails/v2/cmd/wails@latest
wails init -n myapp -t svelte-ts
cd myapp

1. Write your Go backend logic:

type App struct {
    ctx context.Context
}

func (a *App) Greet(name string) string {
    return fmt.Sprintf("Hello %s from Go!", name)
}

1. Call Go functions from the frontend:

<script lang="ts">
import { Greet } from '../wailsjs/go/main/App';
let result = '';
async function greet() {
    result = await Greet('World');
}
</script>
<button on:click={greet}>{result || 'Click me'}</button>

1. Run in development or build for production:

wails dev      # Hot-reload dev mode
wails build    # Production binary

Example

A minimal file manager backend in Go:

func (a *App) ListFiles(dir string) ([]string, error) {
    entries, err := os.ReadDir(dir)
    if err != nil {
        return nil, err
    }
    var names []string
    for _, e := range entries {
        names = append(names, e.Name())
    }
    return names, nil
}

The frontend calls ListFiles('/home/user') and renders the result in a web-based file browser UI.

Related on TokRepo

• Coding AI tools -- developer tools for building applications
• Automation tools -- desktop and workflow automation

Common pitfalls

• WebView rendering varies across operating systems. Test your UI on all target platforms, especially Linux where WebView implementations differ between distributions.
• Wails v2 does not support mobile platforms. If you need iOS or Android targets, consider alternatives like Flutter or Tauri Mobile.
• Large file transfers between Go and JavaScript go through JSON serialization. For binary data or large datasets, consider writing results to disk and passing file paths instead.