gui/pkg/display/README.md
Virgil 78a2a33ed2
Some checks failed
Security Scan / security (push) Failing after 28s
Test / test (push) Successful in 1m19s
refactor(ax): clarify default and named window creation
Co-Authored-By: Virgil <virgil@lethean.io>
2026-03-31 07:43:28 +00:00

866 B

Display

pkg/display is the Core GUI display service. It owns window orchestration, layouts, menus, system tray state, dialogs, notifications, and the IPC bridge to the frontend.

Working Locally

  1. Run the backend tests:
    go test ./pkg/display/...
    
  2. Run the full workspace tests when you touch IPC contracts:
    go test ./...
    
  3. Build the Angular frontend:
    cd ui
    npm install
    npm run build
    

Declarative Windows

Windows are created from a window.Window spec instead of a fluent option chain.

Use OpenWindow(window.Window{}) for the default app window, or CreateWindow(window.Window{Name: "editor", Title: "Editor", URL: "/#/editor"}) when you need a named window and the returned WindowInfo.

The same spec shape is used by layout restore, tiling, snapping, and workflow presets.