Goo 0.27.3

Goo

A retained UI framework for G#, rendered directly with Vulkan.

Goo applications describe UI as ordinary G# objects. Goo retains mounted state, rebuilds only dirty Cell boundaries, lays out with Yoga, and renders through Vulkan 1.3.

Quick start

Install the .NET 10 SDK and meet the platform requirements, then:

dotnet new install Goo.Templates@0.27.3
dotnet tool install --global Goo.DevTools
dotnet new goo -n HelloGoo
cd HelloGoo
goo dev

The template restores the G# compiler from NuGet automatically. The generated counter runs with hot reload. A separate SDL or HarfBuzz installation is not required.

Custom <GooShaderEffect> source needs the shader tools.

Example

package CounterApp

import Goo

class Counter : Cell {
    private var count int32

    override func Build() Blob -> Container{
        Width: Percent(100),
        Height: Percent(100),
        Padding: 24,
        Gap: 12,
        BackgroundColor: Color.Rgb(24, 31, 43),
        Text{Content: "Count: $count", FontSize: 24, Color: Color.White},
        Button{
            Padding: 10,
            BorderRadius: 10,
            BackgroundColor: Color.Rgb(74, 125, 255),
            OnClick: () -> {
                count++
            },
            Text{Content: "Add one", Color: Color.White},
        },
    }
}

func Main() {
    Window.ConfigureApplication("Goo starter", "1.0.0", "com.example.goostarter")
    Window{Title: "Goo starter", Width: 360, Height: 220, Root: Counter{}}.Run()
}

Cell owns local state. Event handlers invalidate their owning Cell automatically, so changing count rebuilds only this component.

Platforms

Goo ships runtime assets for Windows x64, Linux x64, macOS arm64, Android ARM64, and Android x64. The renderer requires the Vulkan 1.3 feature set used by Goo.

• Windows x64 is tested on Windows 11 with current vendor Vulkan drivers. The minimum supported Windows version is not yet established.
• Linux x64 requires Linux 6.6 or newer, glibc 2.27 or newer, a native Wayland 1.18 or newer session, and a TrueType or OpenType sans-serif font. X11 and XWayland are not supported.
• macOS arm64 requires macOS 14 or newer on Apple silicon. Goo bundles MoltenVK 1.4.2 and selects installed Apple system fonts without requiring a Vulkan SDK.
• Android requires Android 13 (API 33) or newer and a Vulkan 1.3 device with identity presentation support. Add the Goo.Android adapter to host the same Window and Cell application in an Android activity or native view.

Further reading

• API documentation
• Android integration
• DevTools
• Shader effects
• Testing and verification
• Contributing and source builds
• Release notes