Documentation — Blazor Power Tools

Quick Links

Getting Started

Install, configure, and render your first component.

Component Demos

Live interactive demos with code examples for all components.

Theme Building

Visual theme builder and CSS custom properties guide.

Component Reference

Pick a component from the left to see its parameters, event callbacks, and related configuration — generated directly from the XML doc comments in the source.

Architecture Overview

Blazor Power Tools is built as a layered component library targeting .NET 10. It supports all three Blazor hosting models: Interactive Server, WebAssembly, and hybrid rendering.

┌─────────────────────────────────────────────┐
│  Your Blazor Application                    │
│  (Server, WASM, or Hybrid)                  │
└──────────────────┬──────────────────────────┘
                   │
┌──────────────────▼──────────────────────────┐
│  Bpt.Components                             │
│  Main component library                     │
│  - Controls (forms, inputs, selectors)      │
│  - Images & Animation (WebGL, canvas)       │
│  - Tools (terminal, monitor, theme builder) │
└──────────────────┬──────────────────────────┘
                   │
┌──────────────────▼──────────────────────────┐
│  Bpt.Services                               │
│  JavaScript interop layer                   │
│  - IJavascriptService                       │
│  - DOM operations, file handling            │
│  - Media capture                            │
└──────────────────┬──────────────────────────┘
                   │
┌──────────────────▼──────────────────────────┐
│  Bpt.Components.Common                      │
│  - BptRootComponent (root wrapper + state)  │
│  - BptRootComponentBase (base class)        │
└─────────────────────────────────────────────┘

Key Interfaces

IJavascriptService

The primary JS interop interface. Handles DOM operations, file downloads, clipboard access, media capture, and browser API calls. Injected automatically when you register BPT services.

BptRootComponent

Root wrapper component that cascades global application state through the component tree. Provides license validation, rendering mode detection, culture settings, and shared configuration that all BPT components can access.

Rendering Modes

BPT components work across all Blazor rendering modes:

Mode	How It Works	Best For
Interactive Server	Components run on the server; UI updates via SignalR	Internal tools, admin panels, sensitive data
WebAssembly	Components run in the browser via .NET WASM runtime	Public-facing apps, offline-capable scenarios
Hybrid (Auto)	Server-rendered initially, switches to WASM after download	Best of both — fast first load, full client capability

Note Some components (BptTerminalClient, BptServerMonitor) require a server connection and are best suited for Interactive Server or Hybrid modes.

Globalization & Localization

BPT components respect .NET's CultureInfo for date/time formatting, number formatting, and text direction. The library includes built-in support for en-GB and nb-NO cultures, with easy extension for additional locales.

The BptLanguage component provides a culture selector dropdown that automatically updates the application culture and persists the user's choice.