Atoll.Hosting.Aspire
0.15.0
dotnet add package Atoll.Hosting.Aspire --version 0.15.0
NuGet\Install-Package Atoll.Hosting.Aspire -Version 0.15.0
<PackageReference Include="Atoll.Hosting.Aspire" Version="0.15.0" />
<PackageVersion Include="Atoll.Hosting.Aspire" Version="0.15.0" />
<PackageReference Include="Atoll.Hosting.Aspire" />
paket add Atoll.Hosting.Aspire --version 0.15.0
#r "nuget: Atoll.Hosting.Aspire, 0.15.0"
#:package Atoll.Hosting.Aspire@0.15.0
#addin nuget:?package=Atoll.Hosting.Aspire&version=0.15.0
#tool nuget:?package=Atoll.Hosting.Aspire&version=0.15.0
Atoll.Hosting.Aspire
.NET Aspire hosting integration for Atoll — the .NET-native Astro-inspired static site framework.
Adds AddAtollSite() to your AppHost, launching the atoll dev server as a managed Aspire resource with HTTP endpoint and readiness health check support.
Installation
dotnet add package Atoll.Hosting.Aspire
Usage
In your Aspire AppHost Program.cs:
var site = builder.AddAtollSite("my-site", "../MySite");
With options:
var site = builder.AddAtollSite("my-site", "../MySite")
.WithWriteDist(); // write rendered output to dist/ after each rebuild cycle
WithWriteDist()
When enabled, the dev server writes all rendered pages and static assets to the dist/ directory after each rebuild. Useful when another resource (e.g. a static file server or an ASP.NET Core app) needs to serve the site from disk during development.
Aspire Dashboard Readiness
The package registers an HTTP health check against the /__health endpoint on the Atoll dev server. The Aspire dashboard shows the resource as Starting until the dev server is listening and healthy, then transitions to Running.
The /__health endpoint is a lightweight GET route built into atoll dev — it returns 200 OK with no body overhead.
API
| Method | Description |
|---|---|
AddAtollSite(name, siteDirectory) |
Adds the Atoll dev server as an Aspire resource. Runs atoll dev on port 4321 by default. |
WithWriteDist() |
Appends --write-dist to the dev server command. |
Requirements
- .NET Aspire 13.6 or later
- .NET 10 or .NET 11 SDK
atollCLI tool installed globally:dotnet tool install -g Atoll.Cli
More Information
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. net11.0 is compatible. |
-
net10.0
- Aspire.Hosting (>= 13.6.5)
-
net11.0
- Aspire.Hosting (>= 13.6.5)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 0.15.0 | 39 | 11/12/2026 |
| 0.14.0 | 45 | 11/12/2026 |
| 0.13.1 | 645 | 10/19/2026 |
| 0.13.0 | 2,702 | 9/25/2026 |
| 0.12.7 | 108 | 9/25/2026 |
| 0.12.6 | 306 | 9/7/2026 |
| 0.12.5 | 170 | 9/4/2026 |
| 0.12.4 | 197 | 9/2/2026 |
| 0.12.3 | 556 | 9/1/2026 |
| 0.12.2 | 107 | 9/1/2026 |
| 0.12.1 | 151 | 8/31/2026 |
| 0.12.0 | 386 | 7/5/2026 |
| 0.11.2 | 386 | 7/4/2026 |
| 0.11.1 | 154 | 6/18/2026 |
| 0.11.0 | 183 | 6/7/2026 |
| 0.10.7 | 489 | 4/20/2026 |
| 0.10.6 | 162 | 4/19/2026 |
| 0.10.5 | 170 | 4/19/2026 |
| 0.10.4 | 123 | 4/18/2026 |
| 0.10.3 | 120 | 4/18/2026 |