Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -37,10 +37,12 @@ A recent version of [Visual Studio Code](https://code.visualstudio.com/) and the

1. Open an existing Aspire project in VS Code, or create one with **Aspire: New Aspire project** from the Command Palette (<Kbd windows='Ctrl+Shift+P' mac='Cmd+Shift+P' />).
1. Run **Aspire: Configure launch.json file** to set up the debug configuration.
1. Press <Kbd windows='F5' /> to start debugging your Aspire app.
1. Press <Kbd windows='F5' /> to start debugging your Aspire app. The extension discovers the AppHost, starts the app, attaches supported debuggers, and opens the dashboard.

</Steps>

*Open a repo, let the extension find the AppHost, press <Kbd windows='F5' />, then use the Aspire view and dashboard while the app runs.*

<ThemeImage
dark={createProject}
light={createProjectLight}
Expand Down Expand Up @@ -158,6 +160,10 @@ Finally, you can specify `env` and `args` to set environment variables and comma
For more information, see [Aspire publishing and deployment overview](/deployment/deploy-with-aspire/).
</LearnMore>

## Dashboard from VS Code

By default, the dashboard opens automatically when the AppHost starts. You can also open it from the Aspire view if you closed the browser tab and want it back.

## Language coverage

The extension detects each resource's language and attaches the right debugger:
Expand Down
8 changes: 8 additions & 0 deletions src/frontend/src/content/docs/get-started/first-app.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -27,6 +27,10 @@ import javascriptDashboardDark from '@assets/get-started/javascript-aspire-dashb
<Pivot id="csharp">
This quickstart uses the starter template that generates a C# AppHost. You'll create the solution, review the generated AppHost, and run it locally with Aspire.

:::tip[Prefer VS Code?]
Install the [Aspire VS Code extension](/get-started/aspire-vscode-extension/) if you want the same path in the editor: create or open the app, run **Aspire: Configure launch.json file**, then press <Kbd windows="F5" mac="F5" /> to start the AppHost and open the dashboard.
:::

This starter template uses modern C#:

- [Minimal APIs](https://learn.microsoft.com/aspnet/core/fundamentals/minimal-apis) for lightweight HTTP APIs
Expand All @@ -48,6 +52,10 @@ architecture-beta
<Pivot id="typescript">
This quickstart uses the JavaScript starter template, which generates a TypeScript AppHost in `apphost.mts`. You'll create the solution, review the generated TypeScript AppHost, and run it locally with Aspire.

:::tip[Prefer VS Code?]
Install the [Aspire VS Code extension](/get-started/aspire-vscode-extension/) if you want the same path in the editor: create or open the app, run **Aspire: Configure launch.json file**, then press <Kbd windows="F5" mac="F5" /> to start the AppHost and open the dashboard.
:::

This starter template combines a modern JavaScript stack:

- [Express](https://expressjs.com/) for building APIs with Node.js
Expand Down
8 changes: 8 additions & 0 deletions src/frontend/src/content/docs/get-started/install-cli.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,14 @@ import {

Aspire provides a command-line interface (CLI) tool to help you create and manage Aspire-based apps. The CLI streamlines your development workflow with an interactive-first experience. This guide shows you how to install the Aspire CLI on your system. You can install the CLI with the install script, .NET global tool, or npm. Use the install script for the fastest setup, or choose the package manager that matches your AppHost language.

:::tip[Using VS Code?]
The [Aspire VS Code extension](/get-started/aspire-vscode-extension/) can install the CLI for you. From the Command Palette, run:

```text title="Command Palette"
> Aspire: Install Aspire CLI (stable)
```
:::
Comment thread
IEvangelist marked this conversation as resolved.

<LearnMore>
Before installing the Aspire CLI, ensure you have the [required
prerequisites](/get-started/prerequisites/) set up.
Expand Down
6 changes: 6 additions & 0 deletions src/frontend/src/content/docs/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -211,6 +211,12 @@ Get started with Aspire by installing the CLI, then dive into the Docs to learn
title="Explore docs"
description="Learn how to model, run, and deploy apps with Aspire."
/>
<LinkCard
icon="rocket"
href="/get-started/aspire-vscode-extension/"
title="Use VS Code"
description="Install the Aspire extension and run AppHosts from the editor."
/>
<LinkCard
icon="open-book"
href="/get-started/faq/"
Expand Down
Loading