71bfd29376
* Get it compiling
* Stubs in place to compile
* Semi runs
* add darwin platform for server
* Evaluation working correctly. Still WIP
* Ignore favicon for desktop
* lint
* Remove feature flag code
* More feature flag removal
* Support sending messages to the backend
* Callbacks working
* Add Center + refactor prefs
* Fix logger
* Callback hooks for MOAE
* Update packages
* ignore test builds
* Support Un/Fullscreen
* vscode stuff
* Only show window when rendered
* Get it compiling again!
* Support tons of stuff!
* Tidy up
* More refactoring
* WIP [bugged]
* Got get frame working
* fix setsize and setposition
* Add Mac Application Options
* Add HideTitleBar
* Support more mac window options
* Add Toolbar support for Mac
* Support colour
* Support runtime colour change
* Moved options to own package
* Refactored mac titlebar options
* Support hidden titlebar
* Support HiddenInset Titlebar
* Support TitleBar Default
Fixed merging defaults
* Sample titlebars
* Fix minmax app
* Min/Max size supported
* WIP: Support multiple value return
* Support OpenDialog
* Remove old dialog code
* change service bus topics for dialogs
* Revert changes to v1
* Use options struct for dialogs
* Initial support for OpenDialog
* Support selecting files+dirs
* Support multiple files in dialog
* Support all dialog properties
* Add comments
* Filter support
* Support default directory
* Support SaveDialog
* Tidy Up
* WIP: Basics of window drag
* Support window dragging
* Update tests
* Frameless is calculated for Mac
* Tidy up
* Support vibrancy and transparency for webview
Options Colour -> RGBA
* Rename vibrancy to appearance
* Add default appearance
* Refactor part 1
* Refactor Part 2
* Support Translucent Window Background
* Update runtime test
* Add IsDarkMode
Updated runtime test
* Support theme mode change event
* Misc fixes for events
* Support OnMultiple
* Small fixes to frontend events
* Add System calls to runtime
* Add system calls to js runtime
* Support System calls in Go Runtime
* Port Sync Store
* Refactor store. Add get().
* Refactor system. Add IsDarkMode state store
* Use IsDarkMode state store
* Remove generated files
* Support setting app state at startup
* Add Store to go runtime
* Update runtime to v1.0.3
* Remove unused event messages
* Debugging
* initial kitchen sink
* Fix right click crash
* Better drag support
* WIP
* Remove log package
* Add Log to Go runtime
* Add logging to kitchen sink
* Improved CodeBlock. Dark mode to store.
* Start Events. List styling moved to global scope.
* Make logger a public package
* Revert logger package
* Major logging refactor
* Make Ffenestri use logging subsystem.
* Debug refactor
* Add trace to JS runtime
* Migrate runtime to @wails
* Support Trace in kitchensink
* Support trace in go runtime
* Support log level
* Support Print in JS runtime
* Runtime v1.0.1
* Move Info message to Trace
* Support Print logging
* Updated Logger interface
* Fix number of methods in Log
* Support SetLogLevel() at runtime
Refactor of loglevel
* Made go runtime package public.
Using loglevel store to keep loglevel in sync
* Support dynamic loglevel
* Runtime refactor
* Fully refactored logging
* Better looking scrollbar
* Terminal output component
* Link component
* SetLogLevel fully supported
* Runtime defs update.
Slight System refactor
* More Logging updates
* Move preview for SetLogLevel
* Fix log level reactivity.
Misc fixes and tweaks
* logging: slight refactor
* Update logger constants to fix default values
* @wails/runtime v1.0.4
* Fix change in logging levels
* hook in windowWillClose
* refactor clilogger
* WIP Events.On
* Add Events.On
* Improved error handling?
* Disable annoying smart quotes
* update runtime definitions
* Support Emit & Once. Improved On.
* Remove old event methods
* Remove old Event methods
* Update runtime in kitchensink
* Revert Fatal on JS Error
* Tidy up events runtime
* Finish events page
* Update Browser runtime API
* Unify Browser runtime
* JS Runtime v1.0.8
* Fix browser runtime export
* Remove debug line
* Add Browser examples
* Update title
* Improved runtime.System
* Update runtime.System to make all methods
* Expose System methods in Go runtime
* Add System to kitchensink
* Huge improvement to calls: Now handles objects
* Add JS runtime Dialog
* Dialog WIP
* Js package generation (#554)
* WIP
* Generation of index.js
* Add RelativeToCwd
* Add JSDoc comments
* Convert to ES6 syntax
* Fix typo
* Initial generation of typescript declarations
* Typescript improvements
* Improved @returns jsdoc
* Improved declaration files
* Simplified output
* Rename file
* Tidy up
* Revert "Simplified output"
This reverts commit 15cdf7382b.
* Now parsing actual code
* Support Array types
* Reimagined parser
* Wrap parsing in Parser
* Rewritten module generator (TS Only)
* Final touches
* Slight refactor to improve output
* Struct comments. External struct literal binding
* Reworked project parser *working*
* remove debug info
* Refactor of parser
* remove the spew
* Better Ts support
* Better project generation logic
* Support local functions in bind()
* JS Object generation. Linting.
* Support json tags in module generation
* Updated mod files
* Support vscode file generation
* Better global.d.ts
* add ts-check to templates
* Support TS declaration files
* improved 'generate' command for module
Co-authored-by: Travis McLane <tmclane@gmail.com>
A framework for building desktop applications using Go & Web Technologies.
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!
The official docs can be found at https://wails.app.
Features
- Use standard Go libraries/frameworks 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
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.13
- 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
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.
Installation
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.
Shoulders of Giants
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.
And without these people, it wouldn't be what it is today. A huge thank you to each and every one of you!
Special Mentions:
- 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
Licensing
Special Thank You
A special thank you to JetBrains for donating licenses to us!
Please click the logo to let them know your appreciation!
