A package to build progressive web apps with Go programming language and WebAssembly.

Overview

go-app

Circle CI Go build Go Report Card GitHub release pkg.go.dev docs Twitter URL

go-app is a package to build progressive web apps (PWA) with Go programming language and WebAssembly.

It uses a declarative syntax that allows creating and dealing with HTML elements only by using Go, and without writing any HTML markup.

The package also provides an http.handler ready to serve all the required resources to run Go-based progressive web apps.

Documentation

go-app documentation

Sneak peek

Install

go-app requirements:

go mod init
go get -u github.com/maxence-charriere/go-app/v7/pkg/app

Declarative syntax

go-app uses a declarative syntax so you can write component-based UI elements just by using the Go programming language.

package main

import "github.com/maxence-charriere/go-app/v7/pkg/app"

type hello struct {
    app.Compo
    name string
}

func (h *hello) Render() app.UI {
    return app.Div().Body(
        app.Main().Body(
            app.H1().Body(
                app.Text("Hello, "),
                app.If(h.name != "",
                    app.Text(h.name),
                ).Else(
                    app.Text("World"),
                ),
            ),
            app.Input().
                Value(h.name).
                Placeholder("What is your name?").
                AutoFocus(true).
                OnChange(h.OnInputChange),
        ),
    )
}

func (h *hello) OnInputChange(ctx app.Context, e app.Event) {
    h.name = ctx.JSSrc.Get("value").String()
    h.Update()
}

func main() {
    app.Route("/", &hello{})
    app.Route("/hello", &hello{})
    app.Run()
}

The app is built with the Go build tool by specifying WebAssembly as architecture and javascript as operating system:

GOARCH=wasm GOOS=js go build -o app.wasm

Note that the build output is named app.wasm because the HTTP handler expects the wasm app to be named that way in order to serve its content.

HTTP handler

Once the wasm app is built, the next step is to serve it.

This package provides an http.Handler implementation ready to serve a PWA and all the required resources to make it work in a web browser.

The handler can be used to create either a web server or a cloud function (AWS Lambda, Google Cloud function or Azure function).

package main

import (
    "net/http"

    "github.com/maxence-charriere/go-app/v7/pkg/app"
)

func main() {
    h := &app.Handler{
        Title:  "Hello Demo",
        Author: "Maxence Charriere",
    }

    if err := http.ListenAndServe(":7777", h); err != nil {
        panic(err)
    }
}

The server is built as a standard Go program:

go build

Once the server and the wasm app built, app.wasm must be moved in the web directory, located by the side of the server binary. The web directory is where to put static resources, such as the wasm app, styles, scripts, or images.

The directory should look like as the following:

.                   # Directory root
├── hello           # Server binary
├── main.go         # Server source code
└── web             # Directory for static resources
    └── app.wasm    # Wasm binary

Then launch the hello server and open the web browser to see the result.

Demo code and live demo are available on the following links:

Contributors

Code Contributors

This project exists thanks to all the people who contribute. [Contribute].

Financial Contributors

Become a financial contributor and help us sustain go-app development. [Contribute]

Individuals

Organizations

Support this project with your organization. Your logo will show up here with a link to your website. [Contribute]

Comments
  • Example crashing right away after go build or go run

    Example crashing right away after go build or go run

    I tried to just go build the example project then execute the binary, but it crashes right after it starts. The weird thing is if I use macpack to build it then it doesn't crash. I'm guessing the app wrapper provides data where the raw build does not.

    Go ENV

    GOARCH="amd64"
    GOBIN=""
    GOEXE=""
    GOHOSTARCH="amd64"
    GOHOSTOS="darwin"
    GOOS="darwin"
    GOPATH="/Users/euforic/go"
    GORACE=""
    GOROOT="/usr/local/Cellar/go/1.7.5/libexec"
    GOTOOLDIR="/usr/local/Cellar/go/1.7.5/libexec/pkg/tool/darwin_amd64"
    CC="clang"
    GOGCCFLAGS="-fPIC -m64 -pthread -fno-caret-diagnostics -Qunused-arguments -fmessage-length=0 -fdebug-prefix-map=/var/folders/3x/0rnfwj_x1jz2p0gzh_gg7_600000gn/T/go-build912724629=/tmp/go-build -gno-record-gcc-switches -fno-common"
    CXX="clang++"
    CGO_ENABLED="1"
    

    Crash Output

    INFO  2017/01/30 14:00:47 driver.go:31: driver *mac.Driver is loaded
    INFO  2017/01/30 14:00:47 component.go:62: main.Hello has been registered under the tag Hello
    INFO  2017/01/30 14:00:47 component.go:62: main.AppMainMenu has been registered under the tag AppMainMenu
    INFO  2017/01/30 14:00:47 component.go:62: main.WindowMenu has been registered under the tag WindowMenu
    fatal error: unexpected signal during runtime execution
    [signal SIGSEGV: segmentation violation code=0x1 addr=0x0 pc=0x7fffb3c24b52]
    
    runtime stack:
    runtime.throw(0x41a1554, 0x2a)
    	/usr/local/Cellar/go/1.7.5/libexec/src/runtime/panic.go:566 +0x95
    runtime.sigpanic()
    	/usr/local/Cellar/go/1.7.5/libexec/src/runtime/sigpanic_unix.go:12 +0x2cc
    
    goroutine 1 [syscall, locked to thread]:
    runtime.cgocall(0x4141160, 0xc42004df20, 0x0)
    	/usr/local/Cellar/go/1.7.5/libexec/src/runtime/cgocall.go:131 +0x110 fp=0xc42004def0 sp=0xc42004deb0
    github.com/murlokswarm/mac._Cfunc_Driver_Run()
    	??:0 +0x41 fp=0xc42004df20 sp=0xc42004def0
    github.com/murlokswarm/mac.(*Driver).Run(0xc420010280)
    	/Users/euforic/go/src/github.com/murlokswarm/mac/driver.go:56 +0x14 fp=0xc42004df28 sp=0xc42004df20
    github.com/murlokswarm/app.Run()
    	/Users/euforic/go/src/github.com/murlokswarm/app/app.go:43 +0x35 fp=0xc42004df40 sp=0xc42004df28
    main.main()
    	/Users/euforic/go/src/github.com/blevein/play/examples/mac/hello/main.go:31 +0x30 fp=0xc42004df48 sp=0xc42004df40
    runtime.main()
    	/usr/local/Cellar/go/1.7.5/libexec/src/runtime/proc.go:183 +0x1f4 fp=0xc42004dfa0 sp=0xc42004df48
    runtime.goexit()
    	/usr/local/Cellar/go/1.7.5/libexec/src/runtime/asm_amd64.s:2086 +0x1 fp=0xc42004dfa8 sp=0xc42004dfa0
    
    goroutine 17 [syscall, locked to thread]:
    runtime.goexit()
    	/usr/local/Cellar/go/1.7.5/libexec/src/runtime/asm_amd64.s:2086 +0x1
    
    goroutine 5 [chan receive]:
    github.com/murlokswarm/app.startUIScheduler()
    	/Users/euforic/go/src/github.com/murlokswarm/app/ui.go:11 +0x51
    created by github.com/murlokswarm/app.init.1
    	/Users/euforic/go/src/github.com/murlokswarm/app/ui.go:17 +0x35
    
    opened by euforic 77
  • v9 Testing/Feedback

    v9 Testing/Feedback

    Hello there,

    I know it is pretty close to the v8 release but I had been working on a new version that removes the need to call Compo.Update() to update what is displayed on the screen.

    Unfortunately, it brings some API changes and since some of you are using this package, I wanted to share that work with you and get some feedback before releasing the new version.

    Install

    go get -u -v github.com/maxence-charriere/go-app/v9@3653b5c
    

    Then replace your imports in your code

    What changed

    • No need to call Update anymore!
    • Compo.Defer() has been removed. Now all Dispatch()/Defer() are done from Context.Dispatch(func(Context))
    • Context.Dispatch(func()) is now Context.Dispatch(func(Context)), and UI elements are always checked before launching Component lifecycle event or HTML event handlers
    • Context has now a Defer(func(Context)) method that launches the given function after a component has been updated. It can be handy to perform action after the display is complete, like scrolling to a given location
    • Context has now an After() function that launches a function on the UI goroutine after the given time without blocking the UI
    • There is a new Component lifecycle event: OnUpdate(Context): it is launched only when a component gets updated by a parent, and should replace a scenario where a Compo.Defer() call was called in a Render() app.UI method
    • Context is now an interface. Fields are now methods:
      • Src => Src()
      • JSSrc => JSSrc()
      • AppUpdateAvailable => AppUpdateAvailable()
      • Page => Page()
    • Context has now a Context.Emit(func()) method that launches the given function and notifies parents to update their state. This should be used when implementing your own event handlers in your components, in order to properly update parent components that set a function to the event handler
    • Context has now method to encrypt and decrypt data
      • Encrypt(v interface{}) ([]byte, error)
      • Decrypt(crypted []byte, v interface{}) error
    • Context has now a method that returns device id: DeviceID() string
    • [EXPERIMENTAL] Changed the API for Stack()

    API design decisions

    • This release focuses mainly on getting the usage of the package more reactive
    • The API is designed to make unrecommended things difficult. A good example would be calling a Context.Dispatch() inside a Render() method
    • With the exception of Handler and JS-related things, everything that you might need is now available from Context. Still thinking about whether I should move Compo.ResizeContent() and Compo.ValueTo in Context though

    Please let me know what you think and where it makes things difficult to solve your problem. I will try to help you solve those and/or iterate to make things better.

    @pojntfx @beanpole135 @ZackaryWelch @mar1n3r0

    Thanks

    help wanted working on it 
    opened by maxence-charriere 41
  • Next: Windows

    Next: Windows

    Hello, some stuff are happening here. I'm writing changes that will bring better support for multi-platform dev. Would like to know what is the next driver you would like to be implement.

    opened by maxence-charriere 39
  • Recaptcha

    Recaptcha

    Hello. anyone know about getting recaptcha to properly work?

    I have it setup to prompt user with a captcha after they click register like so: https://streamable.com/4if31l

    However whenever the captcha submits the form it completely ignores my form submission handler:

    func (c *register) OnCaptchaComplete(ctx app.Context, e app.Event) {
    	e.PreventDefault()
    	print("Captcha complete")
    }
    

    here is the snippet for the element

    app.Div().Class("flex justify-center").Body(
    	app.Form().
    	ID("register-captcha-form").
    	OnSubmit(c.OnCaptchaComplete, nil).
    	Body(
    	&components.Captcha{Callback: "registerCaptchaCB"}),
    	),
    ),
    

    Is there a way to easily prevent the captcha from submitting normally and passing in the response and properly send to my handler with the recaptcha response so I can use the data to build a request to the api?

    I know I can just read the query value for the g-recaptcha-response but is there anyway I can prevent recaptcha from submitting a post / get request to the form action?

    opened by ItsVoltz 31
  • Support for push manager

    Support for push manager

    It would be nice to add subscription bootstrap into page.js (https://github.com/maxence-charriere/app/blob/c5fc1cb2b7861d05ca80284f2e38b1b7c46a69b7/internal/http/page.js)

    And callbacks to goapp.js

    opened by bgokden 28
  • How to make wasm reactive?

    How to make wasm reactive?

    The way Go treats wasm as an application means it runs and exits. This is quite limiting compared to modern JS frameworks with their reactive APIs which allow real-time reactivity on external changes. Is this even possible with the current state of things? Maybe keeping dedicated channels open infinite? This would allow all kind of things from state management stores to webhooks to websockets etc.

    Go takes a different approach, Go treats this as an application, meaning that you start a Go runtime, it runs, then exits and you can’t interact with it. This, coincidentally, is the error message that you’re seeing, our Go application has completed and cleaned up.

    To me this feels more closer to the .NET Console Application than it does to a web application. A web application doesn’t really end, at least, not in the same manner as a process.

    And this leads us to a problem, if we want to be able to call stuff, but the runtime want to shut down, what do we do?

    https://www.aaron-powell.com/posts/2019-02-06-golang-wasm-3-interacting-with-js-from-go/

    Here is an example:

    I would like to connect the app to an external state management store and make it re-render on state changes. By the time the state changed the runtime has exited, hence unless there is a channel open to keep it alive it can't react to external events after exit.

    opened by mar1n3r0 27
  • Custom Handler

    Custom Handler

    It would be nice if app made it easier to work with a custom Handler. For cases like #501 , I could implement my own handler and have fine grained control.

    opened by andrewrynhard 24
  • TypeError: WebAssembly: Response has unsupported MIME type 'text/plain; charset=utf-8' expected 'application/wasm'

    TypeError: WebAssembly: Response has unsupported MIME type 'text/plain; charset=utf-8' expected 'application/wasm'

    Getting this error

    TypeError: WebAssembly: Response has unsupported MIME type 'text/plain; charset=utf-8' expected 'application/wasm'
    
    package ui
    
    import "github.com/maxence-charriere/go-app/v9/pkg/app"
    
    type Home struct {
    	app.Compo
    }
    
    func (h *Home) Render() app.UI {
    	return app.Html().Body(
    		app.Head().Body(
    			app.Meta().Name("charset").Content("utf-8"),
    		),
    		app.Body().Body(
    			app.H1().Text("Hello World"),
    		),
    	)
    
    }
    
    package cmd
    
    import (
    	"net/http"
    
    	"mypackagepath/ui"
    	"github.com/maxence-charriere/go-app/v9/pkg/app"
    	"github.com/spf13/cobra"
    )
    
    // uiCmd represents the ui command
    var uiCmd = &cobra.Command{
    	Use:   "ui",
    	Short: "",
    	RunE: func(cmd *cobra.Command, args []string) error {
    		app.Route("/", new(ui.Home))
    		app.RunWhenOnBrowser()
    		http.Handle("/", &app.Handler{
    			Author:       "A name",
    			Description:  "domain.tld is an URL shortener service",
    			LoadingLabel: "Yo! Wait up, it's loading...",
    			Name:         "Some Name",
    			Title:        "domain.tld - shorturl service",
    			Version:      "1",
    		})
    
    		return http.ListenAndServe(":7890", nil)
    	},
    }
    
    func init() {
    	rootCmd.AddCommand(uiCmd)
    }
    
    opened by idc77 22
  • State management

    State management

    Looking for some broad feedback here.

    I have explored further the idea of implementing component composition also known as slots as described here: https://github.com/maxence-charriere/go-app/issues/434.

    While it definitely works in terms of simply compiling the HTML string the complexity it introduced in maintaining state between the root component and children components brought some questions up.

    The simplicity of using Go structs as state management pattern is very appealing but at the same time easily shows its limitations once the app goes beyond the scope of one page - one component structure. Surely with this pattern we can communicate between pages with HTML5 API storage solutions as long as there is no sensitive data. But as long as we outgrow this pattern in-memory state management becomes inevitable.

    This was an issue which most of JS frontend frameworks faced in their early stages and it evolved in to separate global state management modules and tools like Vuex for example.

    Global state management solves all those problems when scaling from small to enterprise-like apps but comes at a cost with it's own caveats and extra stuff to think about and handle.

    What are your thoughts on this ?

    Do you think this will become a hot topic in the near future as the project evolves or it's beyond the scope of current usage requirements ?

    Do you see the same pattern applied or a different technique Go can make use of to make it possible to scale apps ?

    opened by mar1n3r0 22
  • Implements custom elements with xml namespaces (for SVG)

    Implements custom elements with xml namespaces (for SVG)

    I added namespaces to elements and added a method to create custom tags. The reason is, that I wrote an auto converter that can translate HTML to go-app declarative syntax. While experimenting with it, I found that SVG support was missing. But adding all of the SVG seems to be a lot of work. After making a simple variant for custom elements I realized that this will not work for SVG because those elements need to be in a special namespace. So I added namespace support.

    I think my implementation is quite nice. I added a test and documentation with an example of the usage:

    func SVG(w, h int) app.HTMLCustom {
    	return app.Custom("svg", false, app.SVG).
    		Attr("width", w).Attr("height", h)
    }
    
    func Circle(cx, cy, r int, stroke string, width int, fill string) app.HTMLCustom {
    	return app.Custom("circle", false, app.SVG).
    		Attr("cx", cx).
    		Attr("cy", cy).
    		Attr("r", r).
    		Attr("stroke", stroke).
    		Attr("stroke-width", width).
    		Attr("fill", fill)
    }
    
    func (c *Dynamic) Render() app.UI {
    	return SVG(100, 100).Body(
    		Circle(50, 50, 40, "black", 3, "red"),
    		app.Text("Sorry, your browser does not support inline SVG"),
    	)
    }
    

    Of course, it adds the "xmlns" field to every element. But I think this is better than having another interface for SVG.

    I am contemplating if there should be an "xmlns" method instead which sets the namespace for every element. That may be a better solution than adding the namespace to the Custom() method. Maybe I try that too and push a commit that uses this later on.

    EDIT: There is another implementation using an XMLNS() method on the elements instead of the many parameters to Custom(). See below!

    opened by oderwat 21
  • v9.6.0

    v9.6.0

    Summary

    • Go requirement bumped to Go v1.18
    • Custom elements (Elem and ElemSelfClosing)
    • Prevent component update
    • Engine optimization that ensure a component update is done once per frame cycle
    • Customizable app-worker.js template
    • Some documentation tweak

    Fixes

    • fix #753
    opened by maxence-charriere 20
  • fix: remove infinite loop in replaceRoot

    fix: remove infinite loop in replaceRoot

    Hi @maxence-charriere

    I ran into infinite loop when tried implementing something like this:

    package main
    
    import (
    	"log"
    	"net/http"
    
    	"github.com/maxence-charriere/go-app/v9/pkg/app"
    )
    
    type compo struct {
    	app.Compo
    }
    
    func (c *compo) Render() app.UI {
    	return app.Div().Body(new(compoA))
    }
    
    type compoA struct {
    	app.Compo
    	isLoading bool
    }
    
    func (c *compoA) OnNav(app.Context) {
    	c.isLoading = true
    }
    
    func (c *compoA) Render() app.UI {
    	b := new(compoB)
    	b.IsLoading = c.isLoading
    	return b
    }
    
    type compoB struct {
    	app.Compo
    	IsLoading bool
    }
    
    func (c *compoB) Render() app.UI {
    	return app.If(c.IsLoading, app.Div().Text("is loading")).Else(app.A().Text("is not loading"))
    }
    
    func main() {
    	app.Route("/", new(compo))
    
    	app.RunWhenOnBrowser()
    
    	http.Handle("/", &app.Handler{
    		Name:        "Hello",
    		Description: "An Hello World! example",
    	})
    
    	if err := http.ListenAndServe(":8000", nil); err != nil {
    		log.Fatal(err)
    	}
    }
    
    opened by TcMits 0
  • Documentation issue in go-app page

    Documentation issue in go-app page

    How do I compose a web page?

    Say I want to have a menu, some element in the html body and an html footer.

    I can't seem to wrap my head around composing components together to form a webpage.

    return app.Head().Body(&Menu{}).Div().Body(app.H1().Text("Welcome"))

    If a component can only render independent of other components, how do we put them together?

    tx

    opened by ricardoespsanto 4
  • Component level action trigger global level handler

    Component level action trigger global level handler

    The actionDemo component is used for action handler test only.
    The problem is that both comp1 and comp2 value are changed when the "Inc" button of comp1 is clicked.

    package comp
    
    import (
    	"fmt"
    	"github.com/maxence-charriere/go-app/v9/pkg/app"
    )
    
    type (
    	actionDemo struct {
    		app.Compo
    	}
    
    	actionCompo struct {
    		app.Compo
    		FName string
    		value int
    	}
    )
    
    func (this *actionDemo) Render() app.UI {
    	return app.Div().
    		Body(
    			&actionCompo{
    				FName: "comp1",
    			},
    			&actionCompo{
    				FName: "comp2",
    			},
    		)
    }
    
    func (this *actionCompo) OnMount(ctx app.Context) {
    	ctx.Handle("value", func(context app.Context, action app.Action) {
    		this.value += action.Value.(int)
    	})
    }
    func (this *actionCompo) Render() app.UI {
    	return app.Div().
    		Body(
    			app.Span().Body(
    				app.Text(this.FName),
    				app.Text(": "),
    				app.Text(fmt.Sprintf("%d", this.value)),
    				app.Button().
    					Text("Inc").
    					OnClick(func(ctx app.Context, e app.Event) {
    						ctx.NewActionWithValue("value", 1)
    					}),
    				app.Button().
    					Text("Des").
    					OnClick(func(ctx app.Context, e app.Event) {
    						ctx.NewActionWithValue("value", -1)
    					}),
    			))
    }
    
    opened by gepengscu 11
  • Sanity check:  go-app as a generic decentralized app framework

    Sanity check: go-app as a generic decentralized app framework

    Hi All and Maxence,

    I'm thinking of using go-app as a layer in a decentralized app. By "decentralized app" I mean browser-side persistence, lateral communications between browsers, and so on -- more details below. I see that @oderwat and @mlctrez are apparently already playing with similar ideas: #789.

    Is this a reasonable use of go-app, given current capabilities and roadmap? As far as I can tell so far, the answer to this is "yes". But I have an entire group of people who will be following along and working with me on this effort, and so am checking in here first before we commit several weeks to a POC.

    Background

    I host a working group developing a collaboration platform for other groups and teams. This effort is a spinout from the Nation of Makers community, though not exclusive to nor an official effort of that organization; standard disclaimers apply. So far it's just me and a handful of other folks having weekly video calls to think this through.

    The platform is to be open-source, written in Go, though as I mention in a reddit post, I'm not finding many existing examples of Web3-style apps in Go -- most apps in this space appear to still be javascript, with a little Rust. My guess is that Go/WASM is still too new; the payload size may be a contributing factor.

    I believe go-app might be a good fit for filling this gap.

    Proposal

    If we were to use go-app, we would work with @maxence-charriere and everyone else here to discover and work out any issues that might be lurking with using go-app as a generic-enough framework for decentralized apps, including support of the wishlist items below. Go-app already supports most of this, or at least doesn't get in the way.

    Wishlist

    By "Web3-style" I don't mean necessarily defi-related. I do mean the following items, adapted from another reddit post:

    • decentralized to the extent that the app can be served from e.g. github pages and run client-side in WASM, likely using IndexedDB for persistence.
    • able to communicate with other nodes through multiple protocols e.g. websocket, webrtc, nats, etc.
    • able to run the same code "headless" in server-side nodes to provide additional persistence and relays between firewalled clients
    • SEO-friendly enough that googlers can find content rendered on server nodes
    • interoperable with a few javascript libraries (e.g. the tiptap editor)
      • likely a micro-frontend architecture style, with comms via the DOM
    • be future-proofed enough that we don't need to deal with breaking changes in the framework
      • go-app does appear to be using semver -- do I have that right? Have there been any hiccups with breaking changes at non-major release points?

    Thanks All,

    Steve

    opened by stevegt 14
  • Feature request - cross origin setting for manifest link

    Feature request - cross origin setting for manifest link

    I have a use case where I would like to include credentials ( in my case cookies ) in the manifest request.

    See the gotchas section on this link https://web.dev/add-manifest/#link-manifest

    I've tested this small change locally and it resolves the issue.

    image

    I can submit a PR with the changes but would like some advice:

    • How to configure the setting on and off? Environment variable, app.Handler field, or other?
    • Are there other links ( icon, apple-touch-icon ) that would also need to be considered?
    • Have I missed an obvious way to achieve this without code changes?
    opened by mlctrez 5
Releases(v9.6.7)
  • v9.6.7(Oct 18, 2022)

  • v9.6.4(Aug 29, 2022)

    Summary

    • Loader label is not forced to be lowercase anymore
    • Proxy resources are now fetched from HTTP when TLS is set in a http.Handler. Thanks @oderwat
    Source code(tar.gz)
    Source code(zip)
  • v9.6.3(Aug 22, 2022)

  • v9.6.2(Aug 22, 2022)

  • v9.6.1(Aug 22, 2022)

    Summary

    • Go requirement bumped to Go v1.18
    • Custom elements (Elem and ElemSelfClosing)
    • Prevent component update
    • Engine optimization that ensure a component update is done once per frame cycle
    • Wasm progress
    • Customizable app-worker.js template
    • Documentation tweaks

    Thanks

    • @oderwat
    Source code(tar.gz)
    Source code(zip)
  • v9.5.1(May 10, 2022)

  • v9.5.0(May 10, 2022)

  • v9.4.1(Mar 26, 2022)

  • v9.3.0(Dec 27, 2021)

  • v9.2.1(Nov 8, 2021)

  • v9.2.0(Nov 3, 2021)

  • v9.1.2(Oct 25, 2021)

  • v9.1.1(Oct 18, 2021)

  • v9.0.0(Sep 22, 2021)

  • v8.0.4(Jun 20, 2021)

  • v8.0.3(Jun 20, 2021)

  • v8.0.2(Apr 20, 2021)

  • v8.0.1(Mar 30, 2021)

  • v8.0.0(Mar 25, 2021)

  • v7.3.0(Feb 19, 2021)

    A scope can be added to event handler in order to trigger event handler updates.

    In a scenario where we want to remove a element from a list, a solution is to create an EventHandler which got the element id set outside. The event handler returned will always have the same addr, which prevent the package to define that an update should be done on the given element.

    To solve this, a scope has been added to the methods that set EventHandler. Here is the an example:

    type issue499Data struct {
    	ID    int
    	Value string
    }
    
    type issue499 struct {
    	app.Compo
    
    	data []issue499Data
    }
    
    func newIssue499Data() *issue499 {
    	return &issue499{}
    }
    
    func (c *issue499) OnMount(app.Context) {
    	c.data = []issue499Data{
    		{11, "one"},
    		{22, "two"},
    		{33, "three"},
    		{44, "four"},
    		{55, "five"},
    		{66, "six"},
    		{77, "sever"},
    		{88, "eight"},
    		{99, "nine"},
    	}
    	c.Update()
    }
    
    func (c *issue499) Render() app.UI {
    	return app.Div().Body(
    		app.H1().Text("Issue 499"),
    		app.Div().
    			Body(
    				app.Range(c.data).Slice(func(i int) app.UI {
    					d := c.data[i]
    					return app.Button().
    						ID(fmt.Sprintf("elem-%v", d.ID)).
    						OnClick(c.newListener(d.ID), d.ID). // HERE the element ID is added in order to trigger the handler update since the func pointer returned by newListener is always the same.
    						Text(d.Value)
    				}),
    			),
    	)
    }
    
    func (c *issue499) newListener(id int) app.EventHandler {
    	return func(app.Context, app.Event) {
    		for i, d := range c.data {
    			if id == d.ID {
    				c.data = append(c.data[:i], c.data[i+1:]...)
    				c.Update()
    				return
    			}
    		}
    	}
    }
    
    Source code(tar.gz)
    Source code(zip)
  • v7.2.0(Jan 8, 2021)

    Hello there,

    This release brings a way to be notified that that app window size changed within components. It can be done by implementing the Resizer interface:

    type myCompo struct{
        app.Compo
    }
    
    func (c *myCompo) OnAppResize(ctx app.Context) {
        // Handle app resizing.
    }
    

    It can be quite a handful when building layout components. Shell and Flow has been refactored and now uses this mechanism.

    Source code(tar.gz)
    Source code(zip)
  • v7.1.2(Jan 5, 2021)

  • v7.1.1(Jan 5, 2021)

    Hello, Small patch today:

    • Fixed a bug that prevented _bank navigation for paths within the app host
    • Context now have a variable that reports whether the app has been updated in the background
    Source code(tar.gz)
    Source code(zip)
  • v7.1.0(Jan 4, 2021)

    Hello there,

    This version introduces the Updater interface. It allows a component to be notified that the app has been updated.

    This will allow notifying your users that the app has been updated and modifications are available by reloading the page.

    Check the Lifecycle article in the doc to see how to use it.

    Source code(tar.gz)
    Source code(zip)
  • v7.0.7(Dec 29, 2020)

  • v7.0.6(Nov 26, 2020)

    Hello there. Big update today since this release introduces a dogfooded documentation for the package:

    go-app documentation

    Next to this here are the fixes:

    • Iframe attributes have been added
    • Fixed crash when using Javascript function New and Call with interface{}
    • manifest.json has been renamed manifest.webmanifest in order to follow Google PWA guidelines

    This release also introduces some experimental widgets that are layout related:

    Those widgets are used in the documentation introduced above. Since they are experimental, their API may change.

    Source code(tar.gz)
    Source code(zip)
  • v7.0.5(Aug 25, 2020)

    Hello,

    This version provides the following changes:

    • Fixed a bug where boolean attributes were not updated
    • Min() and Max() HTML element functions now take an interface{} argument rather than string
    Source code(tar.gz)
    Source code(zip)
  • v7.0.4(Aug 12, 2020)

    Hello,

    Here is a small release that brings the following:

    • The handler now proxy an ads.txt file that is located at the root of the static files directory. This allows complying with AdSense requirements.
    • app.Input().Step(v int) has been changed to app.Input().Step(v float64) since step can be a decimal value.
    Source code(tar.gz)
    Source code(zip)
  • v7.0.3(Jul 11, 2020)

    Hello,

    Here is v7.0.3 which introduces the following changes:

    • Fixed bug that did not remove event handlers when components were dismounted
    • Refactored how scripts are loaded in the Handler by using defer attribute
    • Added Iframe missing attributes
    • Generated GitHub pages are now installable with Chrome
    # How to update:
    go get -u github.com/maxence-charriere/go-app/v7
    
    Source code(tar.gz)
    Source code(zip)
  • v7.0.2(Jun 28, 2020)

    Hello there, I'm thrilled to release version 7 of go-app.

    This version is focused on internal improvements that improve code quality and maintainability. Unfortunately, those improvements bring a few small changes in the API, which is why there is a version bump.

    What is new?

    • Context that is bound to a UI element lifecycle. The context can be used with functions that accept context.Context. Contexts are canceled when the UI element they are bound with is dismounted. It is passed in Mounter and Navigator interfaces, and event handlers.

    • TestMatch: testing api to unit test specific UI element:

      tree := app.Div().Body(
          app.H2().Body(
              app.Text("foo"),
          ),
          app.P().Body(
              app.Text("bar"),
          ),
      )
      
      // Testing root:
      err := app.TestMatch(tree, app.TestUIDescriptor{
          Path:     TestPath(),
          Expected: app.Div(),
      })
      // OK => err == nil
      
      // Testing h2:
      err := app.TestMatch(tree, app.TestUIDescriptor{
          Path:     TestPath(0),
          Expected: app.H3(),
      })
      // KO => err != nil because we ask h2 to match with h3
      
      // Testing text from p:
      err = app.TestMatch(tree, app.TestUIDescriptor{
          Path:     TestPath(1, 0),
          Expected: app.Text("bar"),
      })
      // OK => err == nil
      
    • Support for aria HTML element property: Fix #419

      app.Div().
          Aria("foo", "bar").
          Text("foobar")
      
    • A default logger can be set

    • go-app PWA can now be deployed a GitHub Page with the help of GenerateStaticWebsite function:

      package main
      
      import (
      	  "fmt"
      
      	  "github.com/maxence-charriere/go-app/v7/pkg/app"
      )
      
      func main() {
      	  err := app.GenerateStaticWebsite("DST_DIR", &app.Handler{
      		  Name:      "Github Pages Hello",
      		  Title:     "Github Pages Hello",
      		  Resources: app.GitHubPages("goapp-github-pages"),
      	  })
      
      	  if err != nil {
      		  fmt.Println(err)
      		  return
      	  }
      
      	  fmt.Println("static website generated")
      }
      

      It generates files that can directly be dropped into a GitHub repository to serve the PWA. See live example: https://maxence-charriere.github.io/goapp-github-pages/

    • Support for robots.txt: A robots file is now served by the Handler when /web/robots.txt exists

    • Internal code refactored to be more maintainable

    • Serving static resources can now be customized by implementing the ResourceProvider interface

    How to migrate from v6 to v7

    go-app v7 mainly introduced internal improvements. Despite trying to keep the API the same as v6, those changes resulted in API minor modifications that break compatibility.

    Here is a guide on how to adapt v6 code to make it work with v7.

    Imports

    Go import instructions using v6:

    import (
        "github.com/maxence-charriere/go-app/v6/pkg/app"
    )
    

    must be changed to v7:

    import (
        "github.com/maxence-charriere/go-app/v7/pkg/app"
    )
    
    

    http.Handler

    • RootDir field has been removed. Handler now uses the Resources field to define where app resources and static resources are located. This has a default value that is retro compatible with local static resources. If static resources are located on a remote bucket, use the following:

      app.Handler{
          Resources: app.RemoteBucket("BUCKET_URL"),
      }
      
    • UseMinimalDefaultStyles field has been removed. go-app now use CSS styles that only apply to the loading screen and context menus. The former default styles have been removed since they could conflict with some CSS frameworks.

    Component interfaces

    Some interfaces to deals with the lifecycle of components have been modified to take a context as the first argument. Component with methods that satisfies the following interfaces must be updated:

    • Mounter: OnMount() become OnMount(ctx app.Context)
    • Navigator: OnNav(u *url.URL) become OnNav(ctx app.Context u *url.URL)

    Event handlers

    EventHandler function signature has been also modified to take a context as the first argument:

    • func(src app.Value, e app.Event) become func(ctx app.Context, e app.Event)

    • Source is now accessed from the context:

      // Event handler that retrieve input value when onchange is fired:
      func (c *myCompo) OnChange(ctx app.Context, e app.Event) {
          v := ctx.JSSrc().Get("value")
      }
      
    Source code(tar.gz)
    Source code(zip)
Owner
Maxence Charriere
Maxence Charriere
UIKit - A declarative, reactive GUI toolkit for build cross platform apps with web technology with single codebase

UIKit - A declarative, reactive GUI toolkit for build cross platform apps with web technology with single codebase

zhuah 106 Apr 18, 2022
Build cross platform GUI apps with GO and HTML/JS/CSS (powered by Electron)

Thanks to go-astilectron build cross platform GUI apps with GO and HTML/JS/CSS. It is the official GO bindings of astilectron and is powered by Electr

Quentin Renard 4.6k Jan 9, 2023
Build cross platform GUI apps with GO and HTML/JS/CSS (powered by nwjs)

gowd Build cross platform GUI apps with GO and HTML/JS/CSS (powered by nwjs) How to use this library: Download and install nwjs Install this library g

Danny 388 Dec 11, 2022
Build cross-platform modern desktop apps in Go + HTML5

Lorca A very small library to build modern HTML5 desktop apps in Go. It uses Chrome browser as a UI layer. Unlike Electron it doesn't bundle Chrome in

Serge Zaitsev 7.6k Jan 6, 2023
Create desktop apps using Go and Web Technologies.

Build desktop applications using Go & Web Technologies. The traditional method of providing web interfaces to Go programs is via a built-in web server

Wails 13.4k Dec 29, 2022
Qt binding for Go (Golang) with support for Windows / macOS / Linux / FreeBSD / Android / iOS / Sailfish OS / Raspberry Pi / AsteroidOS / Ubuntu Touch / JavaScript / WebAssembly

Introduction Qt is a free and open-source widget toolkit for creating graphical user interfaces as well as cross-platform applications that run on var

null 9.6k Jan 2, 2023
A Windows GUI toolkit for the Go Programming Language

About Walk Walk is a "Windows Application Library Kit" for the Go Programming Language. Its primarily useful for Desktop GUI development, but there is

Alexander Neumann 6.3k Dec 30, 2022
Common library for Go GUI apps on Windows

winc Common library for Go GUI apps on Windows. It is for Windows OS only. This makes library smaller than some other UI libraries for Go.

Tad Vizbaras 142 Dec 12, 2022
An example desktop system tray application that can launch HTML5 windows. Go source with a build process for Windows, Mac and Linux.

ExampleTrayGUI An example cross-platform (Mac, Windows, Linux) system tray application that can launch HTML5 windows, developed in Go including functi

Grant Moore 51 Dec 3, 2022
An example desktop system tray application that can launch HTML5 windows. Go source with a build process for Windows, Mac and Linux.

ExampleTrayGUI An example cross-platform (Mac, Windows, Linux) system tray application that can launch HTML5 windows, developed in Go including functi

Grant Moore 51 Dec 3, 2022
An example desktop system tray application that can launch HTML5 windows. Go source with a build process for Windows, Mac and Linux.

An example cross-platform (Mac, Windows, Linux) system tray application that can launch HTML5 windows, developed in Go including functional build process. This repository is intended as a quick reference to help others start similar projects using the referenced libraries and will not be actively maintained.

Grant Moore 51 Dec 3, 2022
An example desktop system tray application that can launch HTML5 windows. Go source with a build process for Windows, Mac and Linux.

ExampleTrayGUI An example cross-platform (Mac, Windows, Linux) system tray application that can launch HTML5 windows, developed in Go including functi

Owen Moore 51 Dec 3, 2022
Wmi - One hot Go WMI package. Package wmi provides an interface to WMI. (Windows Management Instrumentation)

wmi Package wmi provides an interface to WMI. (Windows Management Instrumentation) Install go get -v github.com/moonchant12/wmi Import import "github.

MoonChant 2 Apr 22, 2022
Go Web UI Toolkit - Public Releases and Development

Welcome! Gowut (Go Web UI Toolkit) is a full-featured, easy to use, platform independent Web UI Toolkit written in pure Go, no platform dependent nati

András Belicza 283 Dec 5, 2022
QML support for the Go language

QML support for the Go language Documentation The introductory documentation as well as the detailed API documentation is available at gopkg.in/qml.v1

null 2k Dec 19, 2022
Pglet - Web UI framework for backend developers

Pglet - Web UI framework for backend developers

Web UI framework for backend developers 585 Nov 15, 2022
Pacz - Arch Linux package searcher with fzf-like UI

pacz pacz is an Arch Linux fuzzy searcher with fzf-like UI. This repository is s

sheepla 2 Apr 3, 2022
Flutter on Windows, MacOS and Linux - based on Flutter Embedding, Go and GLFW.

go-flutter - A package that brings Flutter to the desktop Purpose Flutter allows you to build beautiful native apps on iOS and Android from a single c

null 5.5k Jan 9, 2023
Slice and dice your TMUX windows and panes

Chaakoo is a wrapper over TMUX that can create sessions, windows and panes from a grid based layout. The idea here is inspired by the CSS grid template areas.

Pallav Jha 85 Nov 1, 2022