Preview Server — Visual Variant Picker for Avalonia

What this does

Lets the agent show the user 2–3 design alternatives as actual rendered Avalonia screens (not HTML mockups), in a browser-based side-by-side comparison gallery. The user picks one and the agent then builds the chosen design out into the real app.

Why "real Avalonia" matters: HTML mockups misrepresent how Avalonia's Skia renderer, FluentTheme, ControlThemes, acrylic, shadows and font rendering actually look. A user who approves an HTML mockup is often disappointed by the real app. Rendering the actual XAML guarantees fidelity.

When to use

Must use

• User says: "show me some options", "what would this look like", "give me a few designs", "preview", "mockup"
• Building a new screen/window where there are valid stylistic alternatives
• Choosing between theme libraries (Fluent vs Suki vs Semi vs Material)
• Big visual refactor before committing to one direction