DEV Community

Cover image for Build a desktop app with Wails & Vue
Lucas Neves Pereira
Lucas Neves Pereira

Posted on • Originally published at

Build a desktop app with Wails & Vue

Hi everyone!
In this post I want to show how to quickly setup a desktop app using this amazing Go library Wails.

Basically, Wails allows to write desktop softwares using web technologies like Angular, React, Vue, Svelte..

Installing Wails

Getting started with this library is quite easy, if you have all the prerequesites you just need to run a go get to install it in your local machine, if you need details this is going to add wails to the pkg directory of your GOPATH.

Go ahead and run the following command:

go get -u
Enter fullscreen mode Exit fullscreen mode

Once you've installed it you can run wails init to create a new wails application.

How Wails work

Normally, the wails init command prompt you some questions like the name of your app but also the front end tecnhologie you want to use.

I've named my app randomapp and I am choosing VueJS as a frontend framework.

Screenshot 2021-08-06 at 17.43.31

This is going to generate all the files you need to get started.

What I found very cool is the way that wails allows you to connect your backend logic to your frontend.

There is a wails function named bind that does all the work for you as you can see in their example when you open main.go.

Screenshot 2021-08-10 at 19.08.26

Here app.Bind(basic) is binding the basic function, and we can access it from the frontend.

Let's serve the application so I can show you how, for development the best way to serve this app is by open two terminal windows.

One placed in the root of the project to run the backend with the following command:

wails serve
Enter fullscreen mode Exit fullscreen mode

Screenshot 2021-08-10 at 19.14.26

And a second one placed in the frontend directory to run the frontend with the following command:

npm run serve
Enter fullscreen mode Exit fullscreen mode

Screenshot 2021-08-10 at 19.15.24

Now if we visit http://localhost:8080, we can see our application

Screenshot 2021-08-10 at 19.18.45

Good! Let's open a console in our browser to fetch that backend data by simply calling backend.basic().

Screenshot 2021-08-10 at 19.22.37

We can see that we have access to our basic function binded from the backend that returns a "Hello, World!" string.

That's basically how things work with Wails. Now let's put all of this in practice and build a random application.

Build the actual application


Starting from the backend I'll get rid of the basic bind and function. Also I'll add a resizable option set to true in wails.CreateApp config so that our window later can be, well, resizable πŸ™‚.

Screenshot 2021-08-10 at 19.29.47

So, instead of that basic function I'll create a very simple package that I will name server with a server.go file.

Screenshot 2021-08-10 at 19.31.55

There I'll create a struct and a New function to return an instance of my server struct.

Screenshot 2021-08-10 at 19.34.56

Next, I'll add to that a receiver function of Server that will just return some random data.

Screenshot 2021-08-10 at 19.35.54

Now the last step is to bind this using app.Bind in our main.go file.

Screenshot 2021-08-10 at 19.39.02

That's all we have to do for the backend data, we have kept it simple.


Let's jump now to our frontend directory that is a VueJs app with some components already in place, we have a Home and an About page.

I want to keep it simple so I'll delete the components, store and views folders. We only need the App.vue.

Make sure to remove the unnecessary html tags from App.vue and to remove the use(store) and use(router) from the create app mount function in the main.js file.

Screenshot 2021-08-10 at 19.49.43

Screenshot 2021-08-10 at 19.45.11

Okay, next let's add a button to our template with a click event binded to a fetchData.

Screenshot 2021-08-10 at 19.54.15

That fetchData method will call our backend as we did in the browser console previously. To the that we use window.backend and the we have access to our Server (because we bind it πŸ’ͺ🏻) and it's GetRandomData() function.

The result from GetRandomData will be assigned to a template variable and the work is done!

Screenshot 2021-08-10 at 20.00.56

Let's package of our code to test this out as a desktop app.

Package the final application

The final step is to simply package the application, or build the desktop app ready to use.

For that we can stop the process running in our terminal windows for development and instead run the following command in the root of our project:

wails build -p
Enter fullscreen mode Exit fullscreen mode

Screenshot 2021-08-10 at 20.05.05

Now if you go to the build directory of your project you have a .app or .exe depends on what operating system you are using.

Screenshot 2021-08-10 at 20.05.46

You just have to open it and test our application!!

*Quick Note: * I've changed the colour property in main.go to have a white background and then run wails build -p again πŸ™‚

Screenshot 2021-08-10 at 20.25.10

Screenshot 2021-08-10 at 20.25.14

Seems to work just fine πŸ‘πŸΌ


That's it for this post, you now have an idea on how you can build your next desktop application using this Golang framework.

Hope this will be helpful πŸ˜€

See you soon πŸ‘‹πŸΌ

Top comments (4)

darrylnoakes profile image
Darryl Noakes • Edited

Have you looked at Tauri? It's a Rust-based alternative to Electron. Also, it uses webviews instead of Chromium, so it's fast and small.
Similar idea to this.

I know someone who is developing a Capacitor plugin, so you can use it with Ionic, Quasar, and others, if you want.

Plus, Tauri hopes to implement mobile device support at some point, meaning you could use Tauri for every device.

vdsmartin profile image
Martin Vandersteen • Edited

Thanks for that, I've been dreaming of this for a long while ! At first I thought that's how Electron worked then I tried it and ... Yikes.. Took me 5 minutes to hook Tauri up to an existing project !!

lucasnevespereira profile image
Lucas Neves Pereira

I had no idea about Tauri but it looks very promising πŸ˜ƒ
Thank you for your comment πŸ’ͺ🏻

vineyrawat profile image
Viney Rawat

Tauri is really great tool to build desktop apps and it's available in beta.