desktop

Documentation

Overview

Package desktop contains the Wails desktop application wrapper for Pando. It renders the Pando web UI inside a native WebView window instead of opening an external browser. The desktop binary is compiled separately and embedded into the main pando binary via go:embed in embed_binary.go.

Index

• Variables
• func Launch(embedBin []byte, pandoURL string, simpleMode bool) error
• type App
  • func NewApp(pandoURL string, startSimple bool) *App
  • func (a *App) GetPandoURL() string
  • func (a *App) IsSimpleMode() bool
  • func (a *App) OnDomReady(ctx context.Context)
  • func (a *App) SetWindowFocused(focused bool)
  • func (a *App) Shutdown(ctx context.Context)
  • func (a *App) Startup(ctx context.Context)
  • func (a *App) ToggleWindow()

Variables

var DesktopBinary []byte

DesktopBinary is the embedded pre-compiled pando-desktop binary for non-macOS builds. Populated by running `make desktop-embed`.

var DesktopBundle embed.FS

Functions

func Launch

func Launch(embedBin []byte, pandoURL string, simpleMode bool) error

Launch extracts the embedded desktop binary to a temp dir (if needed) and executes it with the given pandoURL. It blocks until the desktop window exits.

The embedBin parameter is the raw bytes of the compiled pando-desktop binary produced by `make desktop-embed`. If nil or empty, Launch returns an error.

Types

type App

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

App holds the Wails desktop application state.

func NewApp

func NewApp(pandoURL string, startSimple bool) *App

NewApp creates a new desktop App that wraps the given Pando URL in a WebView.

func (*App) GetPandoURL

func (a *App) GetPandoURL() string

GetPandoURL returns the configured Pando URL. Exposed as Wails binding.

func (*App) IsSimpleMode

func (a *App) IsSimpleMode() bool

IsSimpleMode returns whether simple mode is active. Exposed as Wails binding.

func (*App) OnDomReady

func (a *App) OnDomReady(ctx context.Context)

OnDomReady is called by Wails when the DOM is ready. We navigate the webview to the Pando URL.

func (*App) SetWindowFocused

func (a *App) SetWindowFocused(focused bool)

SetWindowFocused is called from JavaScript when the window gains or loses focus. This controls whether OS notifications are shown. Exposed as Wails binding.

func (*App) Shutdown

func (a *App) Shutdown(ctx context.Context)

Shutdown is called by Wails when the application is closing.

func (*App) Startup

func (a *App) Startup(ctx context.Context)

Startup is called by Wails when the application starts.

func (*App) ToggleWindow

func (a *App) ToggleWindow()

ToggleWindow shows the window if hidden, hides it if visible. Exposed as Wails binding.