Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/fyne-io/fyne

Cross platform GUI toolkit in Go inspired by Material Design
https://github.com/fyne-io/fyne

android cross-platform fyne go golang gui hacktoberfest ios theme toolkit

Last synced: 2 days ago
JSON representation

Cross platform GUI toolkit in Go inspired by Material Design

Awesome Lists containing this project

README 

        


  Go API Reference

  Latest Release

  Join us on Slack

  


  Code Status

  Build Status

  Coverage Status




# About



[Fyne](https://fyne.io) is an easy-to-use UI toolkit and app API written in Go.

It is designed to build applications that run on desktop and mobile devices with a

single codebase.



# Prerequisites



To develop apps using Fyne you will need Go version 1.17 or later, a C compiler and your system's development tools.

If you're not sure if that's all installed or you don't know how then check out our

[Getting Started](https://fyne.io/develop/) document.



Using the standard go tools you can install Fyne's core library using:



    go get fyne.io/fyne/v2@latest



After importing a new module, run the following command before compiling the code for the first time. Avoid running it before writing code that uses the module to prevent accidental removal of dependencies:



    go mod tidy



# Widget demo



To run a showcase of the features of Fyne execute the following:



    go install fyne.io/fyne/v2/cmd/fyne_demo@latest

    fyne_demo



And you should see something like this (after you click a few buttons):





  Fyne Demo Dark Theme




Or if you are using the light theme:





  Fyne Demo Light Theme




And even running on a mobile device:





  Fyne Demo Mobile Light Theme




# Getting Started



Fyne is designed to be really easy to code with.

If you have followed the prerequisite steps above then all you need is a

Go IDE (or a text editor).



Open a new file and you're ready to write your first app!



```go

package main



import (

	"fyne.io/fyne/v2/app"

	"fyne.io/fyne/v2/container"

	"fyne.io/fyne/v2/widget"

)



func main() {

	a := app.New()

	w := a.NewWindow("Hello")



	hello := widget.NewLabel("Hello Fyne!")

	w.SetContent(container.NewVBox(

		hello,

		widget.NewButton("Hi!", func() {

			hello.SetText("Welcome :)")

		}),

	))



	w.ShowAndRun()

}

```



And you can run that simply as:



    go run main.go



> [!NOTE]  

> The first compilation of Fyne on Windows _can_ take up to 10 minutes, depending on your hardware. Subsequent builds will be fast.



It should look like this:





  

    

      Fyne Hello Dark Theme

    

      Fyne Hello Dark Theme

    

  




## Run in mobile simulation



There is a helpful mobile simulation mode that gives a hint of how your app would work on a mobile device:



    go run -tags mobile main.go



Another option is to use `fyne` command, see [Packaging for mobile](#packaging-for-mobile).



# Installing



Using `go install` will copy the executable into your go `bin` dir.

To install the application with icons etc into your operating system's standard

application location you can use the fyne utility and the "install" subcommand.



    go install fyne.io/fyne/v2/cmd/fyne@latest

    fyne install



# Packaging for mobile



To run on a mobile device it is necessary to package up the application.

To do this we can use the fyne utility "package" subcommand.

You will need to add appropriate parameters as prompted, but the basic command is shown below.

Once packaged you can install using the platform development tools or the fyne "install" subcommand.



    fyne package -os android -appID my.domain.appname

    fyne install -os android



The built Android application can run either in a real device or an Android emulator.

However, building for iOS is slightly different.

If the "-os" argument is "ios", it is build only for a real iOS device.

Specify "-os" to "iossimulator" allows the application be able to run in an iOS simulator:



    fyne package -os ios -appID my.domain.appname

    fyne package -os iossimulator -appID my.domain.appname



# Preparing a release



Using the fyne utility "release" subcommand you can package up your app for release

to app stores and market places. Make sure you have the standard build tools installed

and have followed the platform documentation for setting up accounts and signing.

Then you can execute something like the following, notice the `-os ios` parameter allows

building an iOS app from macOS computer. Other combinations work as well :)



    $ fyne release -os ios -certificate "Apple Distribution" -profile "My App Distribution" -appID "com.example.myapp"



The above command will create a '.ipa' file that can then be uploaded to the iOS App Store.



# Documentation



More documentation is available at the [Fyne developer website](https://developer.fyne.io/) or on [pkg.go.dev](https://pkg.go.dev/fyne.io/fyne/v2?tab=doc).



# Examples



You can find many example applications in the [examples repository](https://github.com/fyne-io/examples/).

Alternatively a list of applications using fyne can be found at [our website](https://apps.fyne.io/).



# Shipping the Fyne Toolkit



All Fyne apps will work without pre-installed libraries, this is one reason the apps are so portable.

However, if looking to support Fyne in a bigger way on your operating system then you can install some utilities that help to make a more complete experience.



## Additional apps



It is recommended that you install the following additional apps:



| app           | go install                          | description                                                            |

| ------------- | ----------------------------------- | ---------------------------------------------------------------------- |

| fyne_settings | `fyne.io/fyne/v2/cmd/fyne_settings` | A GUI for managing your global Fyne settings like theme and scaling    |

| apps          | `github.com/fyne-io/apps`           | A graphical installer for the Fyne apps listed at https://apps.fyne.io |



These are optional applications but can help to create a more complete desktop experience.



## FyneDesk (Linux / BSD)



To go all the way with Fyne on your desktop / laptop computer you could install [FyneDesk](https://github.com/fyshos/fynedesk) as well :)



![FyneDesk screenshopt in dark mode](https://fyshos.com/img/desktop.png)