Open source and developer first

Model distributed apps in code.

Aspire is an agent-ready, code-first tool for composing, debugging, and deploying distributed applications.

var builder = DistributedApplication.CreateBuilder(args);

// This would be a rather boring AppHost ☹️...
// Toggle the options above to see what an AppHost might look like.
// For example, select "Front end" to add a frontend service.

builder.Build().Run();

var builder = DistributedApplication.CreateBuilder(args);

// Add frontend service
var frontend = builder.AddViteApp("frontend", "../frontend")
    .WithHttpEndpoint(env: "PORT");

builder.Build().Run();

var builder = DistributedApplication.CreateBuilder(args);

// Add frontend service
var frontend = builder.AddViteApp("frontend", "../frontend")
    .WithHttpEndpoint(env: "PORT");

// Add custom container
var customContainer = builder.AddContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .WithHttpEndpoint(targetPort: 8080);

builder.Build().Run();

var builder = DistributedApplication.CreateBuilder(args);

// Add database
var postgres = builder.AddPostgres("db")
    .AddDatabase("appdata");

// Add frontend service
var frontend = builder.AddViteApp("frontend", "../frontend")
    .WithHttpEndpoint(env: "PORT");

builder.Build().Run();

var builder = DistributedApplication.CreateBuilder(args);

// Add database
var postgres = builder.AddPostgres("db")
    .AddDatabase("appdata");

// Add frontend service
var frontend = builder.AddViteApp("frontend", "../frontend")
    .WithHttpEndpoint(env: "PORT");

// Add custom container
var customContainer = builder.AddContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .WithHttpEndpoint(targetPort: 8080);

builder.Build().Run();

var builder = DistributedApplication.CreateBuilder(args);

// Add API service
var api = builder.AddProject("api", "../api/ApiService.csproj");

// Add frontend service and reference the API
var frontend = builder.AddViteApp("frontend", "../frontend")
    .WithHttpEndpoint(env: "PORT")
    .WithReference(api);

builder.Build().Run();

var builder = DistributedApplication.CreateBuilder(args);

// Add API service
var api = builder.AddProject("api", "../api/ApiService.csproj");

// Add frontend service and reference the API
var frontend = builder.AddViteApp("frontend", "../frontend")
    .WithHttpEndpoint(env: "PORT")
    .WithReference(api);

// Add custom container
var customContainer = builder.AddContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .WithHttpEndpoint(targetPort: 8080);

builder.Build().Run();

var builder = DistributedApplication.CreateBuilder(args);

// Add database
var postgres = builder.AddPostgres("db")
    .AddDatabase("appdata");

// Add API service and reference the database
var api = builder.AddProject("api", "../api/ApiService.csproj")
    .WithReference(postgres);

// Add frontend service and reference the API
var frontend = builder.AddViteApp("frontend", "../frontend")
    .WithHttpEndpoint(env: "PORT")
    .WithReference(api);

builder.Build().Run();

var builder = DistributedApplication.CreateBuilder(args);

// Add database
var postgres = builder.AddPostgres("db")
    .AddDatabase("appdata");

// Add API service and reference the database
var api = builder.AddProject("api", "../api/ApiService.csproj")
    .WithReference(postgres);

// Add frontend service and reference the API
var frontend = builder.AddViteApp("frontend", "../frontend")
    .WithHttpEndpoint(env: "PORT")
    .WithReference(api);

// Add custom container
var customContainer = builder.AddContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .WithHttpEndpoint(targetPort: 8080);

builder.Build().Run();

var builder = DistributedApplication.CreateBuilder(args);

// Add database
var postgres = builder.AddPostgres("db")
    .AddDatabase("appdata");

builder.Build().Run();

var builder = DistributedApplication.CreateBuilder(args);

// Add database
var postgres = builder.AddPostgres("db")
    .AddDatabase("appdata");

// Add custom container
var customContainer = builder.AddContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .WithHttpEndpoint(targetPort: 8080);

builder.Build().Run();

var builder = DistributedApplication.CreateBuilder(args);

// Add API service
var api = builder.AddProject("api", "../api/ApiService.csproj");

builder.Build().Run();

var builder = DistributedApplication.CreateBuilder(args);

// Add API service
var api = builder.AddProject("api", "../api/ApiService.csproj");

// Add custom container
var customContainer = builder.AddContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .WithHttpEndpoint(targetPort: 8080);

builder.Build().Run();

var builder = DistributedApplication.CreateBuilder(args);

// Add database
var postgres = builder.AddPostgres("db")
    .AddDatabase("appdata");

// Add API service and reference the database
var api = builder.AddProject("api", "../api/ApiService.csproj")
    .WithReference(postgres);

builder.Build().Run();

var builder = DistributedApplication.CreateBuilder(args);

// Add database
var postgres = builder.AddPostgres("db")
    .AddDatabase("appdata");

// Add API service and reference the database
var api = builder.AddProject("api", "../api/ApiService.csproj")
    .WithReference(postgres);

// Add custom container
var customContainer = builder.AddContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .WithHttpEndpoint(targetPort: 8080);

builder.Build().Run();

var builder = DistributedApplication.CreateBuilder(args);

// Add custom container
var customContainer = builder.AddContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .WithHttpEndpoint(targetPort: 8080);

builder.Build().Run();

var builder = DistributedApplication.CreateBuilder(args);

// Add frontend service
var frontend = builder.AddViteApp("frontend", "../frontend")
    .WithHttpEndpoint(env: "PORT")
    .PublishAsDockerFile();

builder.Build().Run();

var builder = DistributedApplication.CreateBuilder(args);

// Add frontend service
var frontend = builder.AddViteApp("frontend", "../frontend")
    .WithHttpEndpoint(env: "PORT")
    .PublishAsDockerFile();

// Add custom container
var customContainer = builder.AddContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .WithHttpEndpoint(targetPort: 8080)
    .PublishAsKubernetes();

builder.Build().Run();

var builder = DistributedApplication.CreateBuilder(args);

// Add database
var postgres = builder.AddAzurePostgresFlexibleServer("db")
    .AddDatabase("appdata")
    .WithDataVolume()
    .RunAsContainer();

// Add frontend service
var frontend = builder.AddViteApp("frontend", "../frontend")
    .WithHttpEndpoint(env: "PORT")
    .PublishAsDockerFile();

builder.Build().Run();

var builder = DistributedApplication.CreateBuilder(args);

// Add database
var postgres = builder.AddAzurePostgresFlexibleServer("db")
    .AddDatabase("appdata")
    .WithDataVolume()
    .RunAsContainer();

// Add frontend service
var frontend = builder.AddViteApp("frontend", "../frontend")
    .WithHttpEndpoint(env: "PORT")
    .PublishAsDockerFile();

// Add custom container
var customContainer = builder.AddContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .WithHttpEndpoint(targetPort: 8080)
    .PublishAsKubernetes();

builder.Build().Run();

var builder = DistributedApplication.CreateBuilder(args);

// Add API service
var api = builder.AddProject("api", "../api/ApiService.csproj")
    .PublishAsAzureContainerApp();

// Add frontend service and reference the API
var frontend = builder.AddViteApp("frontend", "../frontend")
    .WithHttpEndpoint(env: "PORT")
    .WithReference(api)
    .PublishAsDockerFile();

builder.Build().Run();

var builder = DistributedApplication.CreateBuilder(args);

// Add API service
var api = builder.AddProject("api", "../api/ApiService.csproj")
    .PublishAsAzureContainerApp();

// Add frontend service and reference the API
var frontend = builder.AddViteApp("frontend", "../frontend")
    .WithHttpEndpoint(env: "PORT")
    .WithReference(api)
    .PublishAsDockerFile();

// Add custom container
var customContainer = builder.AddContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .WithHttpEndpoint(targetPort: 8080)
    .PublishAsKubernetes();

builder.Build().Run();

var builder = DistributedApplication.CreateBuilder(args);

// Add database
var postgres = builder.AddAzurePostgresFlexibleServer("db")
    .AddDatabase("appdata")
    .WithDataVolume()
    .RunAsContainer();

// Add API service and reference the database
var api = builder.AddProject("api", "../api/ApiService.csproj")
    .WithReference(postgres)
    .WaitFor(postgres)
    .PublishAsAzureContainerApp();

// Add frontend service and reference the API
var frontend = builder.AddViteApp("frontend", "../frontend")
    .WithHttpEndpoint(env: "PORT")
    .WithReference(api)
    .PublishAsDockerFile();

builder.Build().Run();

var builder = DistributedApplication.CreateBuilder(args);

// Add database
var postgres = builder.AddAzurePostgresFlexibleServer("db")
    .AddDatabase("appdata")
    .WithDataVolume()
    .RunAsContainer();

// Add API service and reference the database
var api = builder.AddProject("api", "../api/ApiService.csproj")
    .WithReference(postgres)
    .WaitFor(postgres)
    .PublishAsAzureContainerApp();

// Add frontend service and reference the API
var frontend = builder.AddViteApp("frontend", "../frontend")
    .WithHttpEndpoint(env: "PORT")
    .WithReference(api)
    .PublishAsDockerFile();

// Add custom container
var customContainer = builder.AddContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .WithHttpEndpoint(targetPort: 8080)
    .PublishAsKubernetes();

builder.Build().Run();

var builder = DistributedApplication.CreateBuilder(args);

// Add database
var postgres = builder.AddAzurePostgresFlexibleServer("db")
    .AddDatabase("appdata")
    .WithDataVolume()
    .RunAsContainer();

builder.Build().Run();

var builder = DistributedApplication.CreateBuilder(args);

// Add database
var postgres = builder.AddAzurePostgresFlexibleServer("db")
    .AddDatabase("appdata")
    .WithDataVolume()
    .RunAsContainer();

// Add custom container
var customContainer = builder.AddContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .WithHttpEndpoint(targetPort: 8080)
    .PublishAsKubernetes();

builder.Build().Run();

var builder = DistributedApplication.CreateBuilder(args);

// Add API service
var api = builder.AddProject("api", "../api/ApiService.csproj")
    .PublishAsAzureContainerApp();

builder.Build().Run();

var builder = DistributedApplication.CreateBuilder(args);

// Add API service
var api = builder.AddProject("api", "../api/ApiService.csproj")
    .PublishAsAzureContainerApp();

// Add custom container
var customContainer = builder.AddContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .WithHttpEndpoint(targetPort: 8080)
    .PublishAsKubernetes();

builder.Build().Run();

var builder = DistributedApplication.CreateBuilder(args);

// Add database
var postgres = builder.AddAzurePostgresFlexibleServer("db")
    .AddDatabase("appdata")
    .WithDataVolume()
    .RunAsContainer();

// Add API service and reference the database
var api = builder.AddProject("api", "../api/ApiService.csproj")
    .WithReference(postgres)
    .WaitFor(postgres)
    .PublishAsAzureContainerApp();

builder.Build().Run();

var builder = DistributedApplication.CreateBuilder(args);

// Add database
var postgres = builder.AddAzurePostgresFlexibleServer("db")
    .AddDatabase("appdata")
    .WithDataVolume()
    .RunAsContainer();

// Add API service and reference the database
var api = builder.AddProject("api", "../api/ApiService.csproj")
    .WithReference(postgres)
    .WaitFor(postgres)
    .PublishAsAzureContainerApp();

// Add custom container
var customContainer = builder.AddContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .WithHttpEndpoint(targetPort: 8080)
    .PublishAsKubernetes();

builder.Build().Run();

var builder = DistributedApplication.CreateBuilder(args);

// Add custom container
var customContainer = builder.AddContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .WithHttpEndpoint(targetPort: 8080)
    .PublishAsKubernetes();

builder.Build().Run();

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// This would be a rather boring AppHost ☹️...
// Toggle the options above to see what an AppHost might look like.
// For example, select "Front end" to add a frontend service.

await builder.build().run();

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add Vite frontend
const frontend = await builder
    .addViteApp("frontend", "./frontend")
    .withHttpEndpoint({ env: "PORT" });

await builder.build().run();

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add Vite frontend
const frontend = await builder
    .addViteApp("frontend", "./frontend")
    .withHttpEndpoint({ env: "PORT" });

// Add custom container
const customContainer = await builder
    .addContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .withHttpEndpoint({ targetPort: 8080 });

await builder.build().run();

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add database
const postgres = await builder
    .addPostgres("db")
    .addDatabase("appdata");

// Add Vite frontend
const frontend = await builder
    .addViteApp("frontend", "./frontend")
    .withHttpEndpoint({ env: "PORT" });

await builder.build().run();

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add database
const postgres = await builder
    .addPostgres("db")
    .addDatabase("appdata");

// Add Vite frontend
const frontend = await builder
    .addViteApp("frontend", "./frontend")
    .withHttpEndpoint({ env: "PORT" });

// Add custom container
const customContainer = await builder
    .addContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .withHttpEndpoint({ targetPort: 8080 });

await builder.build().run();

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add Express API
const api = await builder
    .addNodeApp("api", "./api", "src/index.ts")
    .withHttpEndpoint({ env: "PORT" });

// Add Vite frontend and reference the API
const frontend = await builder
    .addViteApp("frontend", "./frontend")
    .withHttpEndpoint({ env: "PORT" })
    .withReference(api);

await builder.build().run();

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add Express API
const api = await builder
    .addNodeApp("api", "./api", "src/index.ts")
    .withHttpEndpoint({ env: "PORT" });

// Add Vite frontend and reference the API
const frontend = await builder
    .addViteApp("frontend", "./frontend")
    .withHttpEndpoint({ env: "PORT" })
    .withReference(api);

// Add custom container
const customContainer = await builder
    .addContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .withHttpEndpoint({ targetPort: 8080 });

await builder.build().run();

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add database
const postgres = await builder
    .addPostgres("db")
    .addDatabase("appdata");

// Add Express API and reference the database
const api = await builder
    .addNodeApp("api", "./api", "src/index.ts")
    .withHttpEndpoint({ env: "PORT" })
    .withReference(postgres);

// Add Vite frontend and reference the API
const frontend = await builder
    .addViteApp("frontend", "./frontend")
    .withHttpEndpoint({ env: "PORT" })
    .withReference(api);

await builder.build().run();

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add database
const postgres = await builder
    .addPostgres("db")
    .addDatabase("appdata");

// Add Express API and reference the database
const api = await builder
    .addNodeApp("api", "./api", "src/index.ts")
    .withHttpEndpoint({ env: "PORT" })
    .withReference(postgres);

// Add Vite frontend and reference the API
const frontend = await builder
    .addViteApp("frontend", "./frontend")
    .withHttpEndpoint({ env: "PORT" })
    .withReference(api);

// Add custom container
const customContainer = await builder
    .addContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .withHttpEndpoint({ targetPort: 8080 });

await builder.build().run();

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add database
const postgres = await builder
    .addPostgres("db")
    .addDatabase("appdata");

await builder.build().run();

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add database
const postgres = await builder
    .addPostgres("db")
    .addDatabase("appdata");

// Add custom container
const customContainer = await builder
    .addContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .withHttpEndpoint({ targetPort: 8080 });

await builder.build().run();

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add Express API
const api = await builder
    .addNodeApp("api", "./api", "src/index.ts")
    .withHttpEndpoint({ env: "PORT" });

await builder.build().run();

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add Express API
const api = await builder
    .addNodeApp("api", "./api", "src/index.ts")
    .withHttpEndpoint({ env: "PORT" });

// Add custom container
const customContainer = await builder
    .addContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .withHttpEndpoint({ targetPort: 8080 });

await builder.build().run();

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add database
const postgres = await builder
    .addPostgres("db")
    .addDatabase("appdata");

// Add Express API and reference the database
const api = await builder
    .addNodeApp("api", "./api", "src/index.ts")
    .withHttpEndpoint({ env: "PORT" })
    .withReference(postgres);

await builder.build().run();

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add database
const postgres = await builder
    .addPostgres("db")
    .addDatabase("appdata");

// Add Express API and reference the database
const api = await builder
    .addNodeApp("api", "./api", "src/index.ts")
    .withHttpEndpoint({ env: "PORT" })
    .withReference(postgres);

// Add custom container
const customContainer = await builder
    .addContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .withHttpEndpoint({ targetPort: 8080 });

await builder.build().run();

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add custom container
const customContainer = await builder
    .addContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .withHttpEndpoint({ targetPort: 8080 });

await builder.build().run();

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add Vite frontend
const frontend = await builder
    .addViteApp("frontend", "./frontend")
    .withHttpEndpoint({ env: "PORT" })
    .publishAsDockerFile();

await builder.build().run();

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add Vite frontend
const frontend = await builder
    .addViteApp("frontend", "./frontend")
    .withHttpEndpoint({ env: "PORT" })
    .publishAsDockerFile();

// Add custom container
const customContainer = await builder
    .addContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .withHttpEndpoint({ targetPort: 8080 })
    .publishAsKubernetes();

await builder.build().run();

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add database
const postgres = await builder
    .addAzurePostgresFlexibleServer("db")
    .addDatabase("appdata")
    .withDataVolume()
    .runAsContainer();

// Add Vite frontend
const frontend = await builder
    .addViteApp("frontend", "./frontend")
    .withHttpEndpoint({ env: "PORT" })
    .publishAsDockerFile();

await builder.build().run();

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add database
const postgres = await builder
    .addAzurePostgresFlexibleServer("db")
    .addDatabase("appdata")
    .withDataVolume()
    .runAsContainer();

// Add Vite frontend
const frontend = await builder
    .addViteApp("frontend", "./frontend")
    .withHttpEndpoint({ env: "PORT" })
    .publishAsDockerFile();

// Add custom container
const customContainer = await builder
    .addContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .withHttpEndpoint({ targetPort: 8080 })
    .publishAsKubernetes();

await builder.build().run();

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add Express API
const api = await builder
    .addNodeApp("api", "./api", "src/index.ts")
    .withHttpEndpoint({ env: "PORT" })
    .publishAsAzureContainerApp();

// Add Vite frontend and reference the API
const frontend = await builder
    .addViteApp("frontend", "./frontend")
    .withHttpEndpoint({ env: "PORT" })
    .withReference(api)
    .publishAsDockerFile();

await builder.build().run();

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add Express API
const api = await builder
    .addNodeApp("api", "./api", "src/index.ts")
    .withHttpEndpoint({ env: "PORT" })
    .publishAsAzureContainerApp();

// Add Vite frontend and reference the API
const frontend = await builder
    .addViteApp("frontend", "./frontend")
    .withHttpEndpoint({ env: "PORT" })
    .withReference(api)
    .publishAsDockerFile();

// Add custom container
const customContainer = await builder
    .addContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .withHttpEndpoint({ targetPort: 8080 })
    .publishAsKubernetes();

await builder.build().run();

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add database
const postgres = await builder
    .addAzurePostgresFlexibleServer("db")
    .addDatabase("appdata")
    .withDataVolume()
    .runAsContainer();

// Add Express API and reference the database
const api = await builder
    .addNodeApp("api", "./api", "src/index.ts")
    .withHttpEndpoint({ env: "PORT" })
    .withReference(postgres)
    .waitFor(postgres)
    .publishAsAzureContainerApp();

// Add Vite frontend and reference the API
const frontend = await builder
    .addViteApp("frontend", "./frontend")
    .withHttpEndpoint({ env: "PORT" })
    .withReference(api)
    .publishAsDockerFile();

await builder.build().run();

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add database
const postgres = await builder
    .addAzurePostgresFlexibleServer("db")
    .addDatabase("appdata")
    .withDataVolume()
    .runAsContainer();

// Add Express API and reference the database
const api = await builder
    .addNodeApp("api", "./api", "src/index.ts")
    .withHttpEndpoint({ env: "PORT" })
    .withReference(postgres)
    .waitFor(postgres)
    .publishAsAzureContainerApp();

// Add Vite frontend and reference the API
const frontend = await builder
    .addViteApp("frontend", "./frontend")
    .withHttpEndpoint({ env: "PORT" })
    .withReference(api)
    .publishAsDockerFile();

// Add custom container
const customContainer = await builder
    .addContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .withHttpEndpoint({ targetPort: 8080 })
    .publishAsKubernetes();

await builder.build().run();

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add database
const postgres = await builder
    .addAzurePostgresFlexibleServer("db")
    .addDatabase("appdata")
    .withDataVolume()
    .runAsContainer();

await builder.build().run();

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add database
const postgres = await builder
    .addAzurePostgresFlexibleServer("db")
    .addDatabase("appdata")
    .withDataVolume()
    .runAsContainer();

// Add custom container
const customContainer = await builder
    .addContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .withHttpEndpoint({ targetPort: 8080 })
    .publishAsKubernetes();

await builder.build().run();

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add Express API
const api = await builder
    .addNodeApp("api", "./api", "src/index.ts")
    .withHttpEndpoint({ env: "PORT" })
    .publishAsAzureContainerApp();

await builder.build().run();

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add Express API
const api = await builder
    .addNodeApp("api", "./api", "src/index.ts")
    .withHttpEndpoint({ env: "PORT" })
    .publishAsAzureContainerApp();

// Add custom container
const customContainer = await builder
    .addContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .withHttpEndpoint({ targetPort: 8080 })
    .publishAsKubernetes();

await builder.build().run();

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add database
const postgres = await builder
    .addAzurePostgresFlexibleServer("db")
    .addDatabase("appdata")
    .withDataVolume()
    .runAsContainer();

// Add Express API and reference the database
const api = await builder
    .addNodeApp("api", "./api", "src/index.ts")
    .withHttpEndpoint({ env: "PORT" })
    .withReference(postgres)
    .waitFor(postgres)
    .publishAsAzureContainerApp();

await builder.build().run();

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add database
const postgres = await builder
    .addAzurePostgresFlexibleServer("db")
    .addDatabase("appdata")
    .withDataVolume()
    .runAsContainer();

// Add Express API and reference the database
const api = await builder
    .addNodeApp("api", "./api", "src/index.ts")
    .withHttpEndpoint({ env: "PORT" })
    .withReference(postgres)
    .waitFor(postgres)
    .publishAsAzureContainerApp();

// Add custom container
const customContainer = await builder
    .addContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .withHttpEndpoint({ targetPort: 8080 })
    .publishAsKubernetes();

await builder.build().run();

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add custom container
const customContainer = await builder
    .addContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .withHttpEndpoint({ targetPort: 8080 })
    .publishAsKubernetes();

await builder.build().run();

Typing animation

01 Polyglot by design

Bring every service into one model.

Use the language and framework that fit each service. Aspire brings the whole stack into one model and one workflow.

Explore application resources

02 Agent-ready

Give AI the full application context.

Aspire supplies live context from your application model, running resources, and telemetry.

AppHost
Services + dependencies
Runtime
Resources + health
Telemetry
Logs + traces + errors

Set up Aspire for your agent

GitHub Copilot
Claude
OpenAI

One connection. Full application context.

Works with any AI tool.

03 One application model

From repository to running system.

The AppHost is the source of truth for how the application fits together across development, diagnostics, and deployment.

$ aspire run
Preparing Aspire server...
AppHost:apphost.mts
Dashboard:https://localhost:17178/login?t=b3f9c1e0
Logs:~/.aspire/cli/logs/apphost-2f8c.log
Press CTRL+C to stop the AppHost and exit.

Running aspire run turns the AppHost application model into a live resource topology, then exposes every healthy resource in the Aspire dashboard.

import { createBuilder } from "./.aspire/modules/aspire.mjs";

const builder = await createBuilder();
const postgres = await builder
    .addPostgres("postgres")
    .addDatabase("catalogdb");
const cache = await builder.addRedis("basketcache");

const catalog = await builder
    .addNodeApp("catalogservice", "./catalog", "src/index.ts")
    .withReference(postgres);

await builder.addViteApp("frontend", "./frontend")
    .withReference(catalog)
    .withReference(cache);

await builder.build().run();

var builder = DistributedApplication.CreateBuilder(args);

var postgres = builder.AddPostgres("postgres")
    .AddDatabase("catalogdb");
var cache = builder.AddRedis("basketcache");

var catalog = builder
    .AddProject<Projects.CatalogService>("catalogservice")
    .WithReference(postgres);

builder.AddProject<Projects.Frontend>("frontend")
    .WithReference(catalog)
    .WithReference(cache);

builder.Build().Run();

Frontendfrontend

Servicecatalogservice

Databasepostgres

Cachebasketcache

postgresdocker.io/library/postgres:18.3tcp://localhost:5432

basketcachedocker.io/library/redis:8.6tcp://localhost:6379

catalogserviceAspireShop.CatalogService.csprojhttps://localhost:7099

frontendAspireShop.Frontend.csprojhttps://localhost:7188

01
Model the app in code
Define services, containers, data stores, references, and configuration in a readable AppHost.
Explore the AppHost
02
Run the whole system
Start every dependency together, with service discovery, local endpoints, and dev-time configuration already connected.
Learn about aspire run
03
Observe from the first request
Use built-in OpenTelemetry to move from a resource to its logs, traces, metrics, and health without extra setup.
Explore the dashboard
04
Deploy with the same application model
Create deployment artifacts for cloud services, containers, Kubernetes, or the infrastructure path your team already uses.
Explore deployment options

04 Local first, production ready

One model. Every environment.

Development, testing, and deployment stay connected to one application topology without forcing the architecture to drift.

Fast feedback

Run everything locally.

Start projects, containers, and data services together. Aspire wires local endpoints, configuration, and service discovery from the AppHost.

aspire run4 resources healthy

05 Observability included

See the whole application.

Follow requests across resources, logs, traces, metrics, and health from one developer dashboard.

Explore the Aspire dashboard

Aspire dashboard resource graph showing the AspireShop services, databases, and caches connected as healthy nodes.

Aspire dashboard resources table listing every running project, container, and executable with state, endpoints, and actions.

Aspire dashboard console logs streaming interleaved, color-coded output from every resource in real time.

Aspire dashboard structured logs view with a filterable, searchable grid of OpenTelemetry log records.

Aspire dashboard traces list showing distributed traces with per-resource span counts and durations.

Aspire dashboard trace detail waterfall for an add-to-cart request across the frontend, basket service, and cache, with span attributes.

Aspire dashboard metrics view charting HTTP server request duration percentiles for the frontend with dimension filters.

06 Extensible by default

Use the services you already trust.

Add databases, caches, messaging, cloud resources, and community integrations through the same fluent application model.

Browse every integration

07 Developer momentum

Keep teams moving forward.

Aspire shortens onboarding, clarifies distributed behavior, and keeps the local loop productive as systems grow.

Aspire lets developers be developers again.

Steven PriceSoftware Engineering Manager, Iceland Foods

I had someone start on a Monday morning and they were contributing code by lunch.

Russ HardingVP Engineering, EQengineered

I was surprised by how quickly Aspire got me from idea to running services.

Milan JovanovićEducator & Content Creator, MJ Tech

I've never wanted to commit to a Microsoft technology this much.

Nk54 (Reddit User)

Hit F5 to begin. Skip the setup boss fight and ship code faster.

Craig TaylorPrincipal Architect, Xbox Live

Aspire was easy to integrate with our existing container orchestration.

Sean KilleenVP Innovation, SCT Software

OpenTelemetry out-of-the-box in the Aspire dashboard is a game changer for observability!

Dan ClarkeDeveloper & Podcaster, Everstack

Join the Aspire community

08 Start with your stack

Start building with less friction.

Install the Aspire CLI, start with an existing repository or a new one, and bring every resource into one development loop.

Install Aspire Build your first app View on GitHub

Model distributed apps in code.

The AppHost defines how your resources connect.

Bring every service into one model.

Give AI the full application context.

AppHost

Runtime

Telemetry

From repository to running system.

Model the app in code

Run the whole system

Observe from the first request

Deploy with the same application model