Skip to main content

User Interface

Awen provides a desktop application for browsing and interacting with your Avalonia component stories. The UI is organized into a three-panel layout with a toolbar and a collapsible log panel.

Layout​

┌──────────────────────────────────────────────────────────────┐
│ Toolbar Viewport: [Responsive ▾] Theme: [◉ Light] │
├──────────┬──────────────────────────────┬────────────────────┤
│ │ │ │
│ Sidebar │ Preview Canvas │ Properties Panel │
│ │ │ │
│ ▸ Library│ ┌────────────────────┐ │ Label │
│ ▸ Group│ │ │ │ [Click Me ] │
│ Story│ │ Your Component │ │ │
│ Story│ │ │ │ Enabled │
│ │ └────────────────────┘ │ [◉ On] │
│ │ │ │
│ │ Description text... │ │
├──────────┴──────────────────────────────┴────────────────────┤
│ ▸ Log Panel (collapsible) │
└──────────────────────────────────────────────────────────────┘

Panels​

PanelPurpose
SidebarHierarchical tree of all discovered stories, with search filtering
Preview CanvasLive rendering of the selected story's control
Properties PanelInteractive editors for the selected story's properties
ToolbarViewport presets and theme toggle
Log PanelDiscovery results, errors, and hot-reload events

All panels are connected through data binding. Selecting a story in the sidebar updates the preview and properties panel simultaneously. Editing a property value in the properties panel updates the preview in real time.

Launching the UI​

Awen --dir <path-to-story-assemblies>

See CLI Usage for the full list of options.