scaffold-architecture

What problem does it solve?

Provides a strict, repeatable rule set and scaffolding guidance to eliminate inconsistent frontend infrastructure, reduce architectural drift, and ensure testable, maintainable Blazor feature areas.

Core Features & Use Cases

• Hexagonal architecture templates for separating UI.Domain, UI.Infrastructure, and UI.Blazor layers so presentation logic remains pure C# and infrastructure concerns implement ports.
• Presenter-first rules and DI conventions that mandate scoped presenters, IDisposable patterns, InvokeAsync usage, and field presenters for validated inputs to keep UI logic testable.
• Gateway and UI Kit encapsulation that enforces immutable DTOs for ports, HTTP gateway implementations, Radzen wrappers confined to a Kit, and centralized error translation for typed frontend exceptions.
• Testing and tooling guidance recommending bUnit/xUnit for presenter tests, Playwright for end-to-end only when necessary, and data-testid selectors to stabilize test suites.

Quick Start

Scaffold a new frontend feature area following the hexagonal Blazor rules: create UI.Domain Presenters and Ports, UI.Infrastructure Gateways, UI.Blazor Pages and Components with Kit wrappers, register presenters as scoped services, and add presenter tests using bUnit.