wailsapp /wails

Create beautiful applications using Go

★ 37,118⑂ 1,935👁 161⑃ 3,248● 2,667▤ 389
GoMITCreated 2018-12-15wails.io
Download: Wails v3.1.0Wails-3.1.0 ↓3.1.02026-11-01
+4
Daily
+109
Weekly
37,118
stars
1,935
forks
161
watchers
3,248
prs
2,667
issues
389
releases

README

Build desktop applications using Go & Web Technologies.
  
  
  
    
  
  
    
  
  
    
  
  
    
  
  
    
  
  
    
  
  
    
  
  
  
    
  
  
    
  






English · 简体中文 · 日本語 ·
한국어 · Español · Português ·
Русский · Francais · Uzbek · Deutsch ·
Türkçe · Bahasa Indonesia





 Table of Contents

- Table of Contents
- Introduction
- Features
  - Roadmap
- Getting Started
- Sponsors
- FAQ
- Stargazers over time
- Contributors
- License
- Inspiration

 Introduction

The traditional method of providing web interfaces to Go programs is via a built-in web server. Wails offers a different
approach: it provides the ability to wrap both Go code and a web frontend into a single binary. Tools are provided to
make this easy for you by handling project creation, compilation and bundling. All you have to do is get creative!

 Features

- Use standard Go for the backend
- Use any frontend technology you are already familiar with to build your UI
- Quickly create rich frontends for your Go programs using pre-built templates
- Easily call Go methods from Javascript
- Auto-generated Typescript definitions for your Go structs and methods
- Native Dialogs & Menus
- Native Dark / Light mode support
- Supports modern translucency and "frosted window" effects
- Unified eventing system between Go and Javascript
- Powerful cli tool to quickly generate and build your projects
- Multiplatform
- Uses native rendering engines - _no embedded browser_!

 Roadmap

The project roadmap may be found here. New functionality and public behaviour changes use a WEP (Wails Enhancement Proposal), submitted as a draft pull request rather than a feature-request issue.

 Getting Started

Wails has two active versions:

| Version | Status | Install | Docs |
|---|---|---|---|
| v2 | Stable | go install github.com/wailsapp/wails/v2/cmd/wails@latest | v2.wails.io |
| v3.0.0 | Stable | go install github.com/wailsapp/wails/v3/cmd/[email protected] | wails.io |

Full installation instructions are available for v2 and v3.

 Sponsors

This project is supported by these kind people / companies:


 Powered By



Thanks to CodeRabbit for supporting Wails with AI code reviews.

 FAQ

- Is this an alternative to Electron?

  Depends on your requirements. It's designed to make it easy for Go programmers to make lightweight desktop
  applications or add a frontend to their existing applications. Wails does offer native elements such as menus
  and dialogs, so it could be considered a lightweight electron alternative.

- Who is this project aimed at?

  Go programmers who want to bundle an HTML/JS/CSS frontend with their applications, without resorting to creating a
  server and opening a browser to view it.

- What's with the name?

  When I saw WebView, I thought "What I really want is tooling around building a WebView app, a bit like Rails is to
  Ruby". So initially it was a play on words (Webview on Rails). It just so happened to also be a homophone of the
  English name for the Country I am

Top issues

Discussions

Latest release

Wails v3.1.0 v3.1.0 2026-11-01
Wails v3 Weekly Release - v3.1.0

 Added
- add experimental CGO-free macOS and Linux backends in PR by @taliesin-ai
- native YAML builds, portable packaging and signing in PR by @taliesin-ai

 Changed
- avoid copying discarded desktop metadata in PR by @taliesin-ai
- format content lengths without fmt in PR by @taliesin-ai
- select index roots without collecting candidates in PR by @taliesin-ai
- reuse non-seekable file copy buffers in PR by @taliesin-ai
- avoid allocating a reader for sniffing prefixes in PR by @taliesin-ai
- skip MIME sniff reads for known extensions in PR by @taliesin-ai
- 

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON