Build desktop applications using Go & Web Technologies.

Internationalization

English | 简体中文

Table of Contents

Click me to Open/Close the directory listing

• 1. Internationalization
• 2. Table of Contents
• 3. Introduction
  • 3.1 Official Website
• 4. Features
• 5. Sponsors
• 6. Installation
  • 6.1 MacOS
  • 6.2 Linux
    • 6.2.1 Debian/Ubuntu
    • 6.2.2 Arch Linux / ArchLabs / Ctlos Linux
    • 6.2.3 Centos
    • 6.2.4 Fedora
    • 6.2.5 VoidLinux & VoidLinux-musl
    • 6.2.6 Gentoo
  • 6.3 Windows
• 7. Usage
  • 7.1 Next Steps
• 8. FAQ
• 9. Contributors
• 10. Special Mentions
• 12. Special Thanks

Introductions

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!

---

PLEASE NOTE: As we are approaching the v2 release, we are not accepting any new feature requests or bug reports for v1. If you have a critical issue, please open a ticket and state why it is critical.

---

Version 2

Wails v2 has been released in Beta for all 3 platforms. Check out the new website if you are interested in trying it out.

Legacy v1 Website

The legacy v1 docs can be found at https://wails.app.

Features

• Use standard Go for the backend
• Use any frontend technology to build your UI
• Quickly create Vue, Vuetify or React frontends for your Go programs
• Expose Go methods/functions to the frontend via a single bind command
• Uses native rendering engines - no embedded browser
• Shared events system
• Native file dialogs
• Powerful cli tool
• Multiplatform

Sponsors

This project is supported by these kind people / companies:

Installation

Wails uses cgo to bind to the native rendering engines so a number of platform dependent libraries are needed as well as an installation of Go. The basic requirements are:

• Go 1.16
• npm

MacOS

Make sure you have the xcode command line tools installed. This can be done by running:

xcode-select --install

Linux

Debian/Ubuntu

sudo apt install libgtk-3-dev libwebkit2gtk-4.0-dev

Debian: 8, 9, 10

Ubuntu: 16.04, 18.04, 19.04

Also succesfully tested on: Zorin 15, Parrot 4.7, Linuxmint 19, Elementary 5, Kali, Neon, Pop!_OS

Arch Linux / ArchLabs / Ctlos Linux

sudo pacman -S webkit2gtk gtk3

Also succesfully test on: Manjaro & ArcoLinux

Centos

sudo yum install webkitgtk3-devel gtk3-devel

CentOS 6, 7

Fedora

sudo yum install webkit2gtk3-devel gtk3-devel

Fedora 29, 30

VoidLinux & VoidLinux-musl

xbps-install gtk+3-devel webkit2gtk-devel

Gentoo

sudo emerge gtk+:3 webkit-gtk

Windows

Windows requires gcc and related tooling. The recommended download is from http://tdm-gcc.tdragon.net/download. Once this is installed, you are good to go.

Usage

Ensure Go modules are enabled: GO111MODULE=on and go/bin is in your PATH variable.

Installation is as simple as running the following command:

go get -u github.com/wailsapp/wails/cmd/wails

Next Steps

It is recommended at this stage to read the comprehensive documentation at https://wails.app.

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. Whilst Wails does not currently offer hooks into native elements such as menus, this may change in the future.

• 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 from. So it stuck.

Contributors

Special Mentions

Without the following people, this project would never have existed:

• Dustin Krysak - His support and feedback has been immense. More patience than you can throw a stick at (Not long now Dustin!).
• Serge Zaitsev - Creator of Webview which Wails uses for the windowing.
• Byron - At times, Byron has single handedly kept this project alive. Without his incredible input, we never would have got to v1.

This project was mainly coded to the following albums:

• Manic Street Preachers - Resistance Is Futile
• Manic Street Preachers - This Is My Truth, Tell Me Yours
• The Midnight - Endless Summer
• Gary Newman - Savage (Songs from a Broken World)
• Steve Vai - Passion & Warfare
• Ben Howard - Every Kingdom
• Ben Howard - Noonday Dream
• Adwaith - Melyn
• Gwidaith Hen Fran - Cedors Hen Wrach
• Metallica - Metallica
• Bloc Party - Silent Alarm
• Maxthor - Another World
• Alun Tan Lan - Y Distawrwydd

Special Thanks

A huge thanks to Pace for sponsoring the project and helping the efforts to get Wails ported to Apple Silicon!

If you are looking for a Project Management tool that's powerful but quick and easy to use, check them out!

A special thank you to JetBrains for donating licenses to us!

Please click the logo to let them know your appreciation!