# microsoft/aspire architecture

> Architecture diagram of the GitHub repository microsoft/aspire, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/microsoft/aspire
- Repository: https://github.com/microsoft/aspire

## Overview

Aspire is a multi-language, code-first toolchain for defining distributed applications, running them locally, observing them, and carrying their definitions into deployment. The principal workflow starts with a developer defining services and dependencies in an AppHost; the CLI runs the application, while the dashboard provides observability. The same model can be published through deployment pipelines and provider integrations. The repository also includes a VS Code extension for AppHost development and lifecycle operations. Several subsystem links below reflect README-level capabilities; unsampled implementation details are not inferred.

Main entry points: [`src/Aspire.Hosting/ApplicationModel/Resource.cs`](https://github.com/microsoft/aspire/blob/main/src/Aspire.Hosting/ApplicationModel/Resource.cs) (AppHost SDK), [`src/Aspire.Hosting/Pipelines/PipelineStepContext.cs`](https://github.com/microsoft/aspire/blob/main/src/Aspire.Hosting/Pipelines/PipelineStepContext.cs) (Pipeline step context), [`extension/src/extension.ts`](https://github.com/microsoft/aspire/blob/main/extension/src/extension.ts) (VS Code extension), [`src/Aspire.Cli/Commands/PipelineCommandBase.cs`](https://github.com/microsoft/aspire/blob/main/src/Aspire.Cli/Commands/PipelineCommandBase.cs) (Aspire CLI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Developer entry points"]
  node_cli["Aspire CLI"]
end

subgraph group_model["Application definition"]
  node_apphost["AppHost SDK<br/>[Resource.cs]"]
  node_resource["Resource model<br/>[IResource.cs]"]
end

subgraph group_runtime["Local runtime and observability"]
  node_execution["Execution context"]
  node_dashboard["Dashboard"]
  node_dcp["DCP services<br/>[AspireDcpServer.ts]"]
end

subgraph group_deploy["Deployment"]
  node_pipelinecontext["Pipeline context<br/>[PipelineContext.cs]"]
  node_stepcontext["Pipeline step context"]
  node_reporting["Deployment reporting<br/>[ReportingStep.cs]"]
  node_helm["Helm deployment"]
  node_aks["AKS deployment"]
  node_radius["Radius deployment"]
end

subgraph group_extensions["Editor and integrations"]
  node_azurestorage["Azure Storage integration"]
  node_vscode["VS Code extension<br/>[extension.ts]"]
  node_apphostdata["AppHost CLI data"]
  node_debugger["Debug sessions"]
end

node_developer(("Developer"))

node_developer -->|"defines services"| node_apphost
node_apphost -->|"models resources"| node_resource
node_developer -->|"runs application"| node_cli
node_cli -.->|"runs locally"| node_execution
node_cli -.->|"starts publishing"| node_pipelinecontext
node_pipelinecontext -->|"provides context"| node_stepcontext
node_stepcontext -->|"exposes reporting"| node_reporting
node_stepcontext -.->|"deployment context"| node_helm
node_stepcontext -.->|"deployment context"| node_aks
node_stepcontext -.->|"deployment context"| node_radius
node_apphost -.->|"enables observability"| node_dashboard
node_apphost -.->|"publishes model"| node_helm
node_apphost -.->|"publishes model"| node_aks
node_apphost -.->|"publishes model"| node_radius
node_apphost -->|"configures resources"| node_azurestorage
node_developer -.->|"uses editor tools"| node_vscode
node_vscode -.->|"reads AppHost data"| node_apphostdata
node_vscode -.->|"starts debug sessions"| node_debugger
node_vscode -.->|"uses lifecycle services"| node_dcp

click node_cli "https://github.com/microsoft/aspire/blob/main/src/Aspire.Cli/Commands/PipelineCommandBase.cs"
click node_apphost "https://github.com/microsoft/aspire/blob/main/src/Aspire.Hosting/ApplicationModel/Resource.cs"
click node_resource "https://github.com/microsoft/aspire/blob/main/src/Aspire.Hosting/ApplicationModel/IResource.cs"
click node_execution "https://github.com/microsoft/aspire/blob/main/src/Aspire.Hosting/DistributedApplicationExecutionContext.cs"
click node_pipelinecontext "https://github.com/microsoft/aspire/blob/main/src/Aspire.Hosting/Pipelines/PipelineContext.cs"
click node_stepcontext "https://github.com/microsoft/aspire/blob/main/src/Aspire.Hosting/Pipelines/PipelineStepContext.cs"
click node_reporting "https://github.com/microsoft/aspire/blob/main/src/Aspire.Hosting/Pipelines/ReportingStep.cs"
click node_helm "https://github.com/microsoft/aspire/blob/main/src/Aspire.Hosting.Kubernetes/Deployment/HelmDeploymentEngine.cs"
click node_aks "https://github.com/microsoft/aspire/blob/main/src/Aspire.Hosting.Azure.Kubernetes/AzureKubernetesEnvironmentResource.AksPipeline.cs"
click node_radius "https://github.com/microsoft/aspire/blob/main/src/Aspire.Hosting.Radius/Publishing/RadiusDeploymentPipelineStep.cs"
click node_azurestorage "https://github.com/microsoft/aspire/blob/main/src/Aspire.Hosting.Azure.Storage/AzureStorageExtensions.cs"
click node_dashboard "https://github.com/microsoft/aspire/blob/main/src/Aspire.Dashboard/Model/BrowserStorage/SessionBrowserStorage.cs"
click node_vscode "https://github.com/microsoft/aspire/blob/main/extension/src/extension.ts"
click node_apphostdata "https://github.com/microsoft/aspire/blob/main/extension/src/data/AppHostDataRepository.ts"
click node_debugger "https://github.com/microsoft/aspire/blob/main/extension/src/debugger/AspireDebugSession.ts"
click node_dcp "https://github.com/microsoft/aspire/blob/main/extension/src/dcp/AspireDcpServer.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli toneBlue
class node_apphost,node_resource toneAmber
class node_execution,node_dashboard,node_dcp toneMint
class node_pipelinecontext,node_stepcontext,node_reporting,node_helm,node_aks,node_radius toneRose
class node_azurestorage,node_vscode,node_apphostdata,node_debugger,node_developer toneIndigo
```

## Components

### Developer entry points

- [Aspire CLI](https://github.com/microsoft/aspire/blob/main/src/Aspire.Cli/Commands/PipelineCommandBase.cs): `src/Aspire.Cli/Commands/PipelineCommandBase.cs`

### Application definition

- [AppHost SDK](https://github.com/microsoft/aspire/blob/main/src/Aspire.Hosting/ApplicationModel/Resource.cs): `src/Aspire.Hosting/ApplicationModel/Resource.cs`
- [Resource model](https://github.com/microsoft/aspire/blob/main/src/Aspire.Hosting/ApplicationModel/IResource.cs): `src/Aspire.Hosting/ApplicationModel/IResource.cs`

### Local runtime and observability

- [Execution context](https://github.com/microsoft/aspire/blob/main/src/Aspire.Hosting/DistributedApplicationExecutionContext.cs): `src/Aspire.Hosting/DistributedApplicationExecutionContext.cs`
- [Dashboard](https://github.com/microsoft/aspire/blob/main/src/Aspire.Dashboard/Model/BrowserStorage/SessionBrowserStorage.cs): `src/Aspire.Dashboard/Model/BrowserStorage/SessionBrowserStorage.cs`
- [DCP services](https://github.com/microsoft/aspire/blob/main/extension/src/dcp/AspireDcpServer.ts): `extension/src/dcp/AspireDcpServer.ts`

### Deployment

- [Pipeline context](https://github.com/microsoft/aspire/blob/main/src/Aspire.Hosting/Pipelines/PipelineContext.cs): `src/Aspire.Hosting/Pipelines/PipelineContext.cs`
- [Pipeline step context](https://github.com/microsoft/aspire/blob/main/src/Aspire.Hosting/Pipelines/PipelineStepContext.cs): `src/Aspire.Hosting/Pipelines/PipelineStepContext.cs`
- [Deployment reporting](https://github.com/microsoft/aspire/blob/main/src/Aspire.Hosting/Pipelines/ReportingStep.cs): `src/Aspire.Hosting/Pipelines/ReportingStep.cs`
- [Helm deployment](https://github.com/microsoft/aspire/blob/main/src/Aspire.Hosting.Kubernetes/Deployment/HelmDeploymentEngine.cs): `src/Aspire.Hosting.Kubernetes/Deployment/HelmDeploymentEngine.cs`
- [AKS deployment](https://github.com/microsoft/aspire/blob/main/src/Aspire.Hosting.Azure.Kubernetes/AzureKubernetesEnvironmentResource.AksPipeline.cs): `src/Aspire.Hosting.Azure.Kubernetes/AzureKubernetesEnvironmentResource.AksPipeline.cs`
- [Radius deployment](https://github.com/microsoft/aspire/blob/main/src/Aspire.Hosting.Radius/Publishing/RadiusDeploymentPipelineStep.cs): `src/Aspire.Hosting.Radius/Publishing/RadiusDeploymentPipelineStep.cs`

### Editor and integrations

- [Azure Storage integration](https://github.com/microsoft/aspire/blob/main/src/Aspire.Hosting.Azure.Storage/AzureStorageExtensions.cs): `src/Aspire.Hosting.Azure.Storage/AzureStorageExtensions.cs`
- [VS Code extension](https://github.com/microsoft/aspire/blob/main/extension/src/extension.ts): `extension/src/extension.ts`
- [AppHost CLI data](https://github.com/microsoft/aspire/blob/main/extension/src/data/AppHostDataRepository.ts): `extension/src/data/AppHostDataRepository.ts`
- [Debug sessions](https://github.com/microsoft/aspire/blob/main/extension/src/debugger/AspireDebugSession.ts): `extension/src/debugger/AspireDebugSession.ts`

### Other components

- **Developer**

## Connections

- Developer → AppHost SDK: defines services (evidence: `README.md`)
- AppHost SDK → Resource model: models resources (evidence: `src/Aspire.Hosting/ApplicationModel/Resource.cs`)
- Developer → Aspire CLI: runs application (evidence: `README.md`)
- Aspire CLI → Execution context: runs locally
- Aspire CLI → Pipeline context: starts publishing
- Pipeline context → Pipeline step context: provides context (evidence: `src/Aspire.Hosting/Pipelines/PipelineStepContext.cs`)
- Pipeline step context → Deployment reporting: exposes reporting (evidence: `src/Aspire.Hosting/Pipelines/PipelineStepContext.cs`)
- Pipeline step context → Helm deployment: deployment context (evidence: `src/Aspire.Hosting.Kubernetes/Deployment/HelmDeploymentEngine.cs`)
- Pipeline step context → AKS deployment: deployment context (evidence: `src/Aspire.Hosting.Azure.Kubernetes/AzureKubernetesEnvironmentResource.AksPipeline.cs`)
- Pipeline step context → Radius deployment: deployment context (evidence: `src/Aspire.Hosting.Radius/Publishing/RadiusDeploymentPipelineStep.cs`)
- AppHost SDK → Dashboard: enables observability (evidence: `README.md`)
- AppHost SDK → Helm deployment: publishes model (evidence: `README.md`)
- AppHost SDK → AKS deployment: publishes model (evidence: `README.md`)
- AppHost SDK → Radius deployment: publishes model (evidence: `README.md`)
- AppHost SDK → Azure Storage integration: configures resources (evidence: `src/Aspire.Hosting.Azure.Storage/AzureStorageExtensions.cs`)
- Developer → VS Code extension: uses editor tools
- VS Code extension → AppHost CLI data: reads AppHost data
- VS Code extension → Debug sessions: starts debug sessions
- VS Code extension → DCP services: uses lifecycle services
