README.md

May 20, 2026 · View on GitHub

Pipboy.Avalonia

A Pip-Boy inspired theme library for Avalonia UI.

Sharp corners, monochromatic phosphor palette, retro terminal aesthetic — drop it in as your sole application theme and every standard control gets the Vault-Tec treatment.

Built with Claude Code NuGet Live Demo

▶ Try the live WASM demo — runs entirely in the browser, no install needed.


Screenshots

Desktop overview

Color switching


Packages

PackageDescription
Pipboy.AvaloniaCore Pip-Boy theme and base controls for Avalonia
Pipboy.Avalonia.FxAdvanced animated controls and visual effects
Install Core Package
dotnet add package Pipboy.Avalonia
Install FX Package
dotnet add package Pipboy.Avalonia.Fx

Quick Start

1. Apply the theme in App.axaml

<Application xmlns="https://github.com/avaloniaui"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             xmlns:pipboy="https://github.com/NeverMorewd/Pipboy.Avalonia"
             x:Class="MyApp.App">
  <Application.Styles>
    <pipboy:PipboyTheme />
  </Application.Styles>
</Application>

2. (Optional) Set the primary color

// Before the window is shown, or at any time at runtime
PipboyThemeManager.Instance.SetPrimaryColor(Color.Parse("#FFA500")); // Amber

The default color is phosphor green. Subscribe to ThemeColorChanged to react to color updates.


Design Tokens

All tokens are available as {DynamicResource} in XAML and update automatically when the primary color changes.

Brushes

Resource KeyDescription
PipboyPrimaryBrushPrimary brand color
PipboyPrimaryLightBrushLighter variant (+0.25 lightness)
PipboyPrimaryDarkBrushDarker variant (−0.25 lightness)
PipboyBackgroundBrushWindow / deepest background
PipboySurfaceBrushDefault control surface
PipboySurfaceHighBrushElevated / prominent surface
PipboyTextBrushPrimary text
PipboyTextDimBrushSecondary / label text
PipboyBorderBrushDefault control border
PipboyBorderFocusBrushFocused control border
PipboyHoverBrushHover state background
PipboyPressedBrushPressed state background
PipboySelectionBrushSelected item background
PipboyFocusBrushFocus ring color
PipboyDisabledBrushDisabled foreground
PipboyErrorBrushError severity
PipboyWarningBrushWarning severity
PipboySuccessBrushSuccess severity

Colors (raw Color values)

Resource KeyDescription
PipboyPrimaryColorRaw Color of the primary
PipboyBackgroundColorRaw Color of the background
PipboyTextColorRaw Color of the text

Typography

Resource KeyValue
PipboyFontFamilyConsolas, Courier New, monospace
PipboyFontSizeXSmall10
PipboyFontSizeSmall11
PipboyFontSize13
PipboyFontSizeLarge16

License

MIT

Credits