Skip to content
This site is for v3 Alpha and is under construction. v2 is the stable release.
Wails Logo Wails Logo

Welcome to Wails

A powerful framework for building desktop applications using Go and modern web technologies.

What is Wails?

Build desktop applications that combine the power of Go with modern web technologies:

  • Native Performance: Direct in-memory Go-to-Frontend communication
  • Cross Platform: One codebase for Windows, macOS and Linux
  • Modern Stack: Use any modern web framework (React, Vue, Svelte, etc.)
  • Native APIs: Access OS-level features directly from Go
  • Developer Experience: Hot reload, native dialogs, system tray, and more
  • Small Footprint: Lightweight alternative to Electron

Prerequisites

Before you begin, ensure you have:

  • Go 1.23 or later installed
  • Latest version of npm installed (if you want to use the templates)
  • Basic knowledge of Go programming

Check our detailed prerequisites for a complete list.

Quick Start

Terminal window
# Install wails
go install github.com/wailsapp/wails/v3/cmd/wails3@latest
# Create a new project
wails init -n myproject
# Run your project
cd myproject
wails dev

Project Status

Wails v3 is currently in Alpha. While it’s stable enough for testing and development, there might be breaking changes before the final release. Your feedback and contributions are welcome!

What's New in v3?

  • Multiple Windows Support: Create and manage multiple windows in a single application
  • Improved API Design: New procedural approach for more flexibility
  • Enhanced Bindings: Sophisticated static analyzer for Go-to-Frontend communication
  • Better Build Tooling: A new build system based on Taskfile
  • New Linux Packaging: Support for deb, rpm, arch linux, and AppImage
  • New Templates: Create applications with a single command using our pre-built templates

Getting Started

Ready to build your first Wails application? Check out our installation guide to get started.

Alpha Version Notice

Please note that v3 is currently in Alpha. While we’re working hard to ensure stability, there might be breaking changes before the final release. For production use, please use Wails v2.