Documentation

Guides for building desktop applications with Viva: the programming model, components, packaging, and what each platform supports today.

Start

Install the requirements, add Viva to a Go module, and open your first window.

Application-owned state, declared hit regions, typed events and how background work reaches the window.

Window styles, a custom title bar, several windows, asking before a window closes, and an icon in the menu bar or tray.

Pointer, keyboard, shortcuts, scrolling and focus, with a complete example you can drag, type into and scroll.

How an application-owned text.Editor connects to the platform's text system, with a working form field.

Coordinates, slicing space with rows, columns and grids, and painting rectangles, text, icons and paths.

Describe a page with rows, columns, padding and growth instead of coordinates; the flex package lays it out.

Light and dark themes, overriding tokens, control density, reduced motion and fixed-pitch fonts.

Layers, focus scopes and dismissal, with a dropdown menu that closes on an outside press and a modal dialog.

Use the catalog directly, or copy a component's Go source into your project and own it.

Clipboard, file dialogs, notifications, secrets and the rest of the operating system, and how failures are reported.