Picea.Abies.Templates 2.2.0

Picea Abies Templates

Templates for creating MVU-style web applications with the Abies framework.

Installation

dotnet new install Picea.Abies.Templates::1.0.*-*

Available Templates

Usage

Create a new Abies application

# Create a new WASM app with the counter example
dotnet new abies-browser -n MyApp

# Create a new server-rendered app with the counter example
dotnet new abies-server -n MyApp

# Create an empty WASM app
dotnet new abies-browser-empty -n MyApp

Run the application

# Browser templates (abies-browser / abies-browser-empty)
cd MyApp
dotnet run --project MyApp.Host

# Server template (abies-server)
cd MyApp
dotnet run

For browser templates, if you run directly from MyApp.Host, build the app project first so the host can serve the generated AppBundle:

cd MyApp/MyApp.Host
dotnet build ../MyApp.csproj
dotnet run

Then open your browser to the URL shown in the terminal (typically https://localhost:7xxx).

Render Modes

Abies supports four render modes. These templates cover the two interactive modes:

Both templates use the same Program interface — application code is identical across render modes. Only the hosting entry point differs.

Template Options

abies-browser / abies-server

What's Included

abies-browser

• Counter example demonstrating the MVU pattern (increment, decrement, reset)
• WebAssembly configuration with trimming for Release builds
• index.html with Abies design system CSS
• References Picea.Abies.Browser package

abies-server

• Counter example demonstrating the MVU pattern (increment, decrement, reset)
• ASP.NET Core server with WebSocket support
• Server-side rendering with binary DOM patches
• Abies design system CSS
• References Picea.Abies.Server.Kestrel package

Debugger Defaults (Important)

Browser runtime templates (abies-browser, abies-browser-empty) show the debugger panel by default in Debug builds.

To force-disable it explicitly before Runtime.Run(...):

#if DEBUG
Picea.Abies.Debugger.DebuggerConfiguration.ConfigureDebugger(
    new Picea.Abies.Debugger.DebuggerOptions { Enabled = false });
#endif

Release builds can keep this behind #if DEBUG to avoid shipping debug UI setup code.

Server template (abies-server) enables the browser debugger panel by default in local debug startup.

Hide panel options:

• URL query: ?abies-debugger=off
• Meta tag: <meta name="abies-debugger" content="off">
• Global config: window.__abiesDebugger = { enabled: false }

To disable server-side debugger runtime in Debug startup, set ABIES_DEBUG_UI=0.

In Release builds, debugger panel assets are absent. Use server logs, browser DevTools, and OpenTelemetry traces.

Out-of-Box Quality Expectations

A fresh template project should work without manual fixes:

• dotnet run starts the app.
• dotnet build succeeds.
• dotnet publish -c Release succeeds.

If any of these fail for newly generated projects, treat it as a template quality regression.

Learn More

• Abies Documentation
• Render Mode Selection Guide
• Routing Guide

License

Apache 2.0