+4
日增长
+109
周增长
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 amTop issues
#2792Display scaling on Linux18 comments · 2023-07-24#4589[v3] wails3 package failed(v3.0.0-alpha.27 + go1.25.1 + windows 11)16 comments · 2025-09-18#3212binary support14 comments · 2024-01-20#2021Disable Pinch Zoom14 comments · 2022-10-28#1997Multiple Containers in the same Window14 comments · 2022-10-20#4457`wails doctor` falsely reports `libwebkit | webkit2gtk4.0-devel` installed on Fedora 4112 comments · 2025-07-28#3301Improve Error Handling11 comments · 2024-03-08#6121[v3] macos open webinspector after beta 198 comments · 2026-09-14
Discussions
#6560Proposal: Explore GPUI/GPUIX as an Optional Cross-Platform Renderer for Wails v30 comments · 2026-11-06#6553[v3/Linux] Use one application ID across packaging, runtime and services0 comments · 2026-11-04#6542Questions and concerns about the pace of development1 comments · 2026-11-02#6527Video in your blog post not playing in iPad3 comments · 2026-10-31#6376Congratulations on the release of Wails v3! Here is Tingly-Box.1 comments · 2026-10-27#6370Congratulations on v3 GA!1 comments · 2026-10-26#6331Updating CLI in windows0 comments · 2026-10-22#6235Vectile - private, fully local RAG desktop app for Windows, macOS, and Linux. It indexes your personal knowledge into a local SQLite database and combines vector search with full-text search, letting you find information by meaning rather than exact words.0 comments · 2026-10-05
Latest release
Wails v3.1.0 v3.1.0 2026-11-01Wails 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 -