Installation

June 1, 2026 · View on GitHub

Prerequisites

  • .NET 10.0 SDK or later
  • A C# editor (Visual Studio, Rider, VS Code with C# Dev Kit)

The fastest way to start is with the Abies project templates:

# Install the templates (one-time)
dotnet new install Picea.Abies.Templates

# Create a browser (WASM) app
dotnet new abies-browser -n MyApp

# Or create a server-rendered app
dotnet new abies-server -n MyApp

cd MyApp
dotnet run

See Project Templates for all available templates and options.

Manual Installation

If you prefer to set up manually, add the appropriate NuGet package:

For Browser (WASM) Apps

dotnet add package Picea.Abies.Browser

Or in your .csproj:

<PackageReference Include="Picea.Abies.Browser" Version="2.1.*" />

For Server-Rendered Apps

dotnet add package Picea.Abies.Server.Kestrel

Or in your .csproj:

<PackageReference Include="Picea.Abies.Server.Kestrel" Version="2.1.*" />

Prefer dotnet add package ... when possible so NuGet resolves the latest compatible version for your feed configuration.

Core Library Only

If you only need the MVU core (for custom runtimes or testing):

dotnet add package Picea.Abies

Package Overview

PackageDescriptionUse Case
Picea.AbiesCore MVU library (virtual DOM, diffing, rendering)All projects
Picea.Abies.BrowserBrowser runtime (WASM host, JS interop)Client-side apps
Picea.Abies.ServerServer runtime (SSR, Session, Page, Transport)Server-rendered apps
Picea.Abies.Server.KestrelKestrel integration (WebSocket, static files)ASP.NET Core hosting
Picea.Abies.Templatesdotnet new project templatesQuick scaffolding
Picea.Abies.AnalyzersRoslyn analyzers for compile-time HTML checksDevelopment

Migration from Abies Packages

If you were using the old Abies, Abies.Browser, or Abies.Server packages, these are now metapackages that redirect to the new Picea.Abies.* packages. They continue to work but will show a deprecation notice:

# Old (deprecated, still works)
dotnet add package Abies.Browser

# New (recommended)
dotnet add package Picea.Abies.Browser

Project Configuration

Abies targets .NET 10.0 and uses the latest C# language features:

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net10.0</TargetFramework>
    <LangVersion>latest</LangVersion>
    <Nullable>enable</Nullable>
  </PropertyGroup>
</Project>

Verify Installation

dotnet build

If the build succeeds, you're ready to go. See Your First App for the next step.

Next