wails

README

Build desktop applications using Go & Web Technologies.

English · 简体中文 · 日本語 · 한국어

Table of Contents

• Table of Contents
• Introduction
• Features
  • Roadmap
• Getting Started
• Sponsors
• FAQ
• 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. Please consult this before open up an enhancement request.

Getting Started

The installation instructions are on the official website.

Sponsors

This project is supported by these kind people / companies:

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

Stargazers over time

Contributors

The contributors list is getting too big for the readme! All the amazing people who have contributed to this project have their own page here.

License

Inspiration

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

Documentation

Index

• Variables
• type App
  • func CreateApp(optionalConfig ...*AppConfig) *App
  • func (a *App) Bind(object interface{})
  • func (a *App) Run() error
• type AppConfig
  • func (a *AppConfig) GetCSS() string
  • func (a *AppConfig) GetColour() string
  • func (a *AppConfig) GetDisableInspector() bool
  • func (a *AppConfig) GetHTML() string
  • func (a *AppConfig) GetHeight() int
  • func (a *AppConfig) GetJS() string
  • func (a *AppConfig) GetMaxHeight() int
  • func (a *AppConfig) GetMaxWidth() int
  • func (a *AppConfig) GetMinHeight() int
  • func (a *AppConfig) GetMinWidth() int
  • func (a *AppConfig) GetResizable() bool
  • func (a *AppConfig) GetTitle() string
  • func (a *AppConfig) GetWidth() int
• type CustomLogger
• type Runtime
• type Store

Variables

var BuildMode = cmd.BuildModeProd

BuildMode indicates what mode we are in

Types

type App

type App struct {
	// contains filtered or unexported fields
}

App defines the main application struct

func CreateApp

func CreateApp(optionalConfig ...*AppConfig) *App

CreateApp creates the application window with the given configuration If none given, the defaults are used

func (*App) Bind

func (a *App) Bind(object interface{})

Bind allows the user to bind the given object with the application

func (*App) Run

func (a *App) Run() error

Run the app

type AppConfig

type AppConfig struct {
	// The width and height of your application in pixels
	Width, Height int

	// The title to put in the title bar
	Title string

	// The HTML your app should use. If you leave it blank, a default will be used:
	// <!DOCTYPE html><html lang="en"><head><meta charset="utf-8"><meta http-equiv="IE=edge" content="IE=edge"></head><body><div id="app"></div><script type="text/javascript"></script></body></html>
	HTML string

	// The Javascript your app should use. Normally this should be generated by a bundler.
	JS string

	// The CSS your app should use. Normally this should be generated by a bundler.
	CSS string

	// The colour of your window. Can take "#fff", "rgb(255,255,255)", "rgba(255,255,255,1)" formats
	Colour string

	// Indicates whether your app should be resizable
	Resizable bool

	// Minimum width of a resizable window. If set, MinHeight should also be set.
	MinWidth int

	// Minimum height of a resizable window. If set, MinWidth should also be set.
	MinHeight int

	// Maximum width of a resizable window. If set, MaxHeight should also be set.
	MaxWidth int

	// Maximum height of a resizable window. If set, MaxWidth should also be set.
	MaxHeight int

	// Indicated if the devtools should be disabled
	DisableInspector bool
}

AppConfig is the configuration structure used when creating a Wails App object

func (*AppConfig) GetCSS

func (a *AppConfig) GetCSS() string

GetCSS returns the user CSS

func (*AppConfig) GetColour

func (a *AppConfig) GetColour() string

GetColour returns the colour

func (*AppConfig) GetDisableInspector

func (a *AppConfig) GetDisableInspector() bool

GetDisableInspector returns true if the inspector should be disabled

func (*AppConfig) GetHTML

func (a *AppConfig) GetHTML() string

GetHTML returns the default HTML

func (*AppConfig) GetHeight

func (a *AppConfig) GetHeight() int

GetHeight returns the desired height

func (*AppConfig) GetJS

func (a *AppConfig) GetJS() string

GetJS returns the user Javascript

func (*AppConfig) GetMaxHeight

func (a *AppConfig) GetMaxHeight() int

GetMaxHeight returns the maximum height of the window

func (*AppConfig) GetMaxWidth

func (a *AppConfig) GetMaxWidth() int

GetMaxWidth returns the maximum width of the window

func (*AppConfig) GetMinHeight

func (a *AppConfig) GetMinHeight() int

GetMinHeight returns the minimum height of the window

func (*AppConfig) GetMinWidth

func (a *AppConfig) GetMinWidth() int

GetMinWidth returns the minimum width of the window

func (*AppConfig) GetResizable

func (a *AppConfig) GetResizable() bool

GetResizable returns true if the window should be resizable

func (*AppConfig) GetTitle

func (a *AppConfig) GetTitle() string

GetTitle returns the desired window title

func (*AppConfig) GetWidth

func (a *AppConfig) GetWidth() int

GetWidth returns the desired width

type CustomLogger

type CustomLogger = logger.CustomLogger

CustomLogger is a specialised logger

type Runtime

type Runtime = wailsruntime.Runtime

Runtime is the Go Runtime struct

type Store

type Store = wailsruntime.Store

Store is a state store used for syncing with the front end