Merged
Conversation
Document Aspire watch behavior for AppHost changes, resource-specific restart and rebuild workflows, and IDE-managed hot reload/debugging boundaries. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Contributor
There was a problem hiding this comment.
Pull request overview
Adds a dedicated documentation page describing how Aspire “watch” relates to AppHost changes, resource-specific dev loops, and IDE-managed Hot Reload/debugging, and links this guidance from relevant CLI reference and FAQ pages.
Changes:
- Adds a new
/app-host/hot-reload-and-watch/page explaining recommended watch/restart workflows for AppHost vs individual resources (includingfeatures.defaultWatchEnabledandaspire resourcecommands). - Updates
aspire runandaspire startcommand reference docs with a “Hot Reload and watch behavior” section linking to the new guidance. - Adds an FAQ entry and a sidebar link for discoverability.
Show a summary per file
| File | Description |
|---|---|
| src/frontend/src/content/docs/reference/cli/commands/aspire-start.mdx | Documents default vs opt-in watch behavior for aspire start and links to the new guidance page. |
| src/frontend/src/content/docs/reference/cli/commands/aspire-run.mdx | Documents default vs opt-in watch behavior for aspire run and links to the new guidance page. |
| src/frontend/src/content/docs/get-started/faq.mdx | Adds an FAQ entry summarizing Aspire watch scope and links to the new guidance page. |
| src/frontend/src/content/docs/app-host/hot-reload-and-watch.mdx | New AppHost page detailing Aspire watch boundaries, resource workflows, and IDE hot reload/debugging behavior. |
| src/frontend/config/sidebar/docs.topics.ts | Adds the new page to the AppHost sidebar topics. |
Copilot's findings
Tip
Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
- Files reviewed: 5/5 changed files
- Comments generated: 0
IEvangelist
approved these changes
May 8, 2026
Document current dotnet watch behavior for Aspire AppHosts and .NET project resources, including restart behavior and known quirks requiring explicit restart or rebuild commands. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Rename the project resources tab to C# projects and tighten the dotnet watch wording around C# project behavior. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Lead the C# projects section with dotnet watch support for C# AppHosts and move current experience quirks into an Important note. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Tighten the C# projects section so dotnet watch support and defaultWatchEnabled behavior are not repeated. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
davidfowl
added a commit
that referenced
this pull request
May 8, 2026
* chore: Update integration data and GitHub stats (5/7/26) (#882) Co-authored-by: aspire-repo-bot[bot] <268009190+aspire-repo-bot[bot]@users.noreply.github.com> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Use pnpm instead of npm in check-data-files.mjs (#881) The repository is configured as a pnpm workspace (pnpm-workspace.yaml, pnpm-lock.yaml, packageManager: pnpm@10.30.1), but check-data-files.mjs hardcoded `npm run update:all`. Running npm inside a pnpm workspace ignores pnpm-lock.yaml, creates an unnecessary package-lock.json, and can corrupt or destabilize the local development environment. Fixes #872 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * chore: Update integration data and GitHub stats (5/8/26) (#890) Co-authored-by: aspire-repo-bot[bot] <268009190+aspire-repo-bot[bot]@users.noreply.github.com> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Add Hot Reload and watch guidance (#887) * Add Hot Reload and watch guidance Document Aspire watch behavior for AppHost changes, resource-specific restart and rebuild workflows, and IDE-managed hot reload/debugging boundaries. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Clarify dotnet watch AppHost behavior Document current dotnet watch behavior for Aspire AppHosts and .NET project resources, including restart behavior and known quirks requiring explicit restart or rebuild commands. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Clarify C# projects watch guidance Rename the project resources tab to C# projects and tighten the dotnet watch wording around C# project behavior. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Refine C# dotnet watch guidance Lead the C# projects section with dotnet watch support for C# AppHosts and move current experience quirks into an Important note. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Reduce C# watch guidance repetition Tighten the C# projects section so dotnet watch support and defaultWatchEnabled behavior are not repeated. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --------- Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Update standalone dashboard docs for Aspire CLI (#886) * Update standalone dashboard docs Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Centralize standalone dashboard prerequisites Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Restore dashboard landing quick start Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Address dashboard quick start feedback Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Fix terminal tabs regression test source Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Fix standalone dashboard telemetry limits link Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Show both dashboard quick start options Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Address standalone dashboard review feedback Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --------- Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --------- Co-authored-by: aspire-repo-bot[bot] <268009190+aspire-repo-bot[bot]@users.noreply.github.com> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Co-authored-by: David Pine <david.pine@microsoft.com>
Copilot AI
pushed a commit
that referenced
this pull request
May 9, 2026
* chore: Update integration data and GitHub stats (5/7/26) (#882) Co-authored-by: aspire-repo-bot[bot] <268009190+aspire-repo-bot[bot]@users.noreply.github.com> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Use pnpm instead of npm in check-data-files.mjs (#881) The repository is configured as a pnpm workspace (pnpm-workspace.yaml, pnpm-lock.yaml, packageManager: pnpm@10.30.1), but check-data-files.mjs hardcoded `npm run update:all`. Running npm inside a pnpm workspace ignores pnpm-lock.yaml, creates an unnecessary package-lock.json, and can corrupt or destabilize the local development environment. Fixes #872 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * chore: Update integration data and GitHub stats (5/8/26) (#890) Co-authored-by: aspire-repo-bot[bot] <268009190+aspire-repo-bot[bot]@users.noreply.github.com> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Add Hot Reload and watch guidance (#887) * Add Hot Reload and watch guidance Document Aspire watch behavior for AppHost changes, resource-specific restart and rebuild workflows, and IDE-managed hot reload/debugging boundaries. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Clarify dotnet watch AppHost behavior Document current dotnet watch behavior for Aspire AppHosts and .NET project resources, including restart behavior and known quirks requiring explicit restart or rebuild commands. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Clarify C# projects watch guidance Rename the project resources tab to C# projects and tighten the dotnet watch wording around C# project behavior. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Refine C# dotnet watch guidance Lead the C# projects section with dotnet watch support for C# AppHosts and move current experience quirks into an Important note. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Reduce C# watch guidance repetition Tighten the C# projects section so dotnet watch support and defaultWatchEnabled behavior are not repeated. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --------- Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Update standalone dashboard docs for Aspire CLI (#886) * Update standalone dashboard docs Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Centralize standalone dashboard prerequisites Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Restore dashboard landing quick start Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Address dashboard quick start feedback Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Fix terminal tabs regression test source Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Fix standalone dashboard telemetry limits link Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Show both dashboard quick start options Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Address standalone dashboard review feedback Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --------- Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --------- Co-authored-by: aspire-repo-bot[bot] <268009190+aspire-repo-bot[bot]@users.noreply.github.com> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Co-authored-by: David Pine <david.pine@microsoft.com> Co-authored-by: JamesNK <303201+JamesNK@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Customers have asked how Hot Reload should work with
aspire run,aspire start, and Aspire-managed resources. This PR adds a dedicated AppHost page that explains the current recommended workflow and the boundary between Aspire watch behavior, resource-specific development loops, and IDE-managed hot reload/debugging.Summary
/app-host/hot-reload-and-watch/with guidance for C# and TypeScript AppHosts usingfeatures.defaultWatchEnabled.aspire resource <resource-name> stop|start|rebuildor dashboard actions.aspire run/aspire startcommand reference pages.Validation
aspire config list --allshowsdefaultWatchEnabledandaspire config set features.defaultWatchEnabled trueworks.pnpm --dir .\src\frontend run lint.pnpm --dir .\src\frontend run test:unit:docs.