Desktop Apps

┌─────────────────────────────────────────┐│           Desktop App                    ││  ┌─────────────────────────────────┐    ││  │    Native Webview Window         │    ││  │  (Chromium/WebKit)               │    ││  │  Navigates to localhost:PORT     │    ││  └──────────────┬──────────────────┘    ││                 │ HTTP                   ││  ┌──────────────▼──────────────────┐    ││  │    Go HTTP Server                │    ││  │  • Page Routes → HTML            │    ││  │  • API Routes → JSON             │    ││  │  • Static Assets                 │    ││  └─────────────────────────────────┘    │└─────────────────────────────────────────┘

//go:build desktoppackage mainimport (    "flag"    "fmt"    "net/http"    "myapp/app"    "github.com/stukennedy/irgo/desktop")func main() {    devMode := flag.Bool("dev", false, "Enable devtools")    flag.Parse()    // Create router    r := app.NewRouter()    // Set up HTTP handler with static files    mux := http.NewServeMux()    staticDir := desktop.FindStaticDir()    mux.Handle("/static/", http.StripPrefix("/static/",        http.FileServer(http.Dir(staticDir))))    mux.Handle("/", r.Handler())    // Configure desktop app    config := desktop.DefaultConfig()    config.Title = "My App"    config.Debug = *devMode    // Create and run    desktopApp := desktop.New(mux, config)    fmt.Println("Starting desktop app...")    if err := desktopApp.Run(); err != nil {        fmt.Printf("Error: %v\n", err)    }}

config := desktop.Config{    Title:     "My App",     // Window title    Width:     1024,         // Initial window width    Height:    768,          // Initial window height    Resizable: true,         // Allow window resizing    Debug:     false,        // Enable browser devtools    Port:      0,            // 0 = auto-select available port}// Or start with defaultsconfig := desktop.DefaultConfig()config.Title = "My App"config.Debug = true

# Run directly (compiles and runs)irgo run desktop# With devtools enabled (for debugging)irgo run desktop --dev

# Build for current platformirgo build desktop# Build for specific platformirgo build desktop macos     # Creates build/desktop/macos/MyApp.appirgo build desktop windows   # Creates build/desktop/windows/MyApp.exeirgo build desktop linux     # Creates build/desktop/linux/myapp

build/desktop/├── macos/│   └── MyApp.app/           # macOS application bundle│       └── Contents/│           ├── MacOS/│           │   └── myapp    # Executable│           ├── Resources/│           │   └── static/  # Static assets│           └── Info.plist   # App metadata├── windows/│   └── MyApp.exe            # Windows executable└── linux/    └── myapp                # Linux binary

import "github.com/stukennedy/irgo/desktop"// Find static files directory// Works both in dev (./static) and bundled appstaticDir := desktop.FindStaticDir()// Find bundled resources// Looks in app bundle on macOS, same dir as exe on Windows/LinuxresourcePath := desktop.FindResourcePath("config.json")

# Check CGO is enabledgo env CGO_ENABLED# Set it if neededexport CGO_ENABLED=1# Make sure you have a C compiler# macOSxcode-select --install# Linuxsudo apt install build-essential

# Install WebKit2GTKsudo apt install libwebkit2gtk-4.0-dev