Guide · 6 steps · 19 articles · Reviewed

Building with Aspire

Aspire describes your whole application in code, from APIs and frontends to databases and caches, then runs it locally with one command and helps you ship it. This page puts the Aspire articles we have featured into a reading order: why it exists, a first app, integrations, the dashboard, deployment, and working with AI agents. Aspire releases often, so some earlier articles show older APIs; we note this where it matters. Every link goes to the original article.

Understand what Aspire is for

The problem Aspire solves, why teams adopt it, and what it looks like to move an existing Docker Compose setup into an AppHost. Some of these predate Aspire 13, so read them for the ideas rather than exact APIs.

Build your first app with the AppHost

A complete walkthrough on Aspire 13, from the AppHost and service defaults to deployment, then a short tip on keeping containers and their data between runs.

Connect databases, frontends and other languages

Aspire 13 added first-class support for Python and JavaScript apps alongside .NET. Start with that release, then see how to write your own hosting integration and how to run a JavaScript frontend next to your .NET services.

Observe your app with the dashboard

The dashboard shows structured logs, traces and metrics once your services emit OpenTelemetry. These articles cover instrumenting your app, customizing the dashboard, and the export and history features added in recent releases.

Aspire 13.6: Your dashboard gets memory

Maddy Montaquila · Aspire BlogIssue 30

The dashboard now keeps traces, logs and resource state after you stop the AppHost (up to 10 runs, stored locally in SQLite). You can go back to the run where a bug showed up, and the new opt-in WithRepl() opens a signed-in database shell right in the dashboard.

Secure and deploy

A full backend-for-frontend security setup modeled in the AppHost, and the release that added Kubernetes and AKS deployment through Helm. The walkthrough in step 2 also covers deploying with Docker Compose.

Use Aspire with AI agents

How the Aspire CLI gives coding agents current docs, a way to run the whole app, and telemetry to check their work, plus a complete agent application that Aspire orchestrates. For the agent side, see our AI agents and MCP guide.

Step introductions are dotnetdevs.io commentary. Every article belongs to its author; see the full library for everything we have featured.