Skip to content
Wails Blog
Wails v3 is in ALPHA. v2 docs
Wails Logo Wails Logo

Build Desktop Apps with Go

Build beautiful, performant applications using Go and modern web technologies. One codebase. Three platforms. No browsers.*
Get Started View Tutorial

Quickstart

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


# 2. Run the setup wizard (experimental)
wails3 setup

Then you’re ready for your first project:

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

Your application is now running with hot reload and type-safe Go-to-JS bindings.

Having issues with wails3 setup? See the manual installation guide.

Your desktop app is already a mobile app

Section titled “Your desktop app is already a mobile app”
Terminal window
wails3 task ios:run      # run your existing app on iOS Simulator
wails3 task android:run  # run your existing app on Android Emulator

Zero changes to your Go code. The same main.go, the same services, the same frontend — Wails compiles it for iOS and Android automatically. Platform-specific features (haptics, native dialogs, safe areas) are there when you want them, but you don’t need them to ship.

Mobile docs →

Why Wails?

Section titled “Why Wails?”

Performance That Users Notice

  • ~15MB binaries vs Electron’s 150MB
  • ~10MB baseline memory vs 100MB+
  • <0.5s startup time vs 2-3s
  • Native rendering using OS WebView
  • No bundled browser overhead

Developer Experience

  • One Go codebase for all platforms
  • Any web framework - React, Vue, Svelte
  • Hot reload during development
  • Auto-generated bindings to easily call Go from Javascript
  • In-memory IPC. No network ports

Production Ready

  • Multiple windows with lifecycles
  • Native menus and system tray
  • Platform-native file dialogs
  • System integration and shortcuts
  • Code signing and packaging tools

Desktop & Mobile

  • Windows, macOS, Linux, iOS, Android
  • Same codebase, zero rewrites
  • Native WebView on every platform
  • No open ports, no localhost server
  • Platform features available when needed

Next Steps

Section titled “Next Steps”

Next: Build a complete application, browse examples, or check the API reference. Migrating from v2? See the upgrade guide.

Support Wails Development

Wails is free and open source, built by developers for developers. If Wails helps you build amazing applications, consider supporting its continued development.

Your sponsorship helps maintain the project, improve documentation, and develop new features that benefit the entire community.

Become a Sponsor →