diff --git a/src/frontend/src/content/docs/get-started/aspire-vscode-extension.mdx b/src/frontend/src/content/docs/get-started/aspire-vscode-extension.mdx index bf3d9a597..4561b748c 100644 --- a/src/frontend/src/content/docs/get-started/aspire-vscode-extension.mdx +++ b/src/frontend/src/content/docs/get-started/aspire-vscode-extension.mdx @@ -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 (). 1. Run **Aspire: Configure launch.json file** to set up the debug configuration. -1. Press to start debugging your Aspire app. +1. Press to start debugging your Aspire app. The extension discovers the AppHost, starts the app, attaches supported debuggers, and opens the dashboard. +*Open a repo, let the extension find the AppHost, press , then use the Aspire view and dashboard while the app runs.* + +## 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: diff --git a/src/frontend/src/content/docs/get-started/first-app.mdx b/src/frontend/src/content/docs/get-started/first-app.mdx index 7151dcf39..5f01854fe 100644 --- a/src/frontend/src/content/docs/get-started/first-app.mdx +++ b/src/frontend/src/content/docs/get-started/first-app.mdx @@ -27,6 +27,10 @@ import javascriptDashboardDark from '@assets/get-started/javascript-aspire-dashb 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 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 @@ -48,6 +52,10 @@ architecture-beta 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 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 diff --git a/src/frontend/src/content/docs/get-started/install-cli.mdx b/src/frontend/src/content/docs/get-started/install-cli.mdx index 376a74b6d..b220ceee8 100644 --- a/src/frontend/src/content/docs/get-started/install-cli.mdx +++ b/src/frontend/src/content/docs/get-started/install-cli.mdx @@ -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) +``` +::: + Before installing the Aspire CLI, ensure you have the [required prerequisites](/get-started/prerequisites/) set up. diff --git a/src/frontend/src/content/docs/index.mdx b/src/frontend/src/content/docs/index.mdx index 16caccce8..ae592928b 100644 --- a/src/frontend/src/content/docs/index.mdx +++ b/src/frontend/src/content/docs/index.mdx @@ -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." /> +