Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
215 commits
Select commit Hold shift + click to select a range
de1b49c
Merge commit 'ea3e9fb4e2789f0154ae280cd5d69c71aef35d72' into release/…
github-actions[bot] Sep 30, 2026
fe88b20
docs: document terminal scrollbar, palette, and dock tab reordering
aspire-repo-bot[bot] Oct 1, 2026
a78fa06
Merge commit 'f5b99e4068b8268f72e244a210687b358b7393a4' into release/…
github-actions[bot] Oct 1, 2026
45a8d46
Merge commit 'b065af54e0a85f9182e11a8800d62079af93fa7e' into release/…
github-actions[bot] Oct 1, 2026
74f3492
Merge commit '7d7477aaf78e1337bce0084d192622a9c20f4e03' into release/…
github-actions[bot] Oct 1, 2026
5700ca8
Merge commit '96fb149d07ad81c41979417619d059ab873afbdd' into release/…
github-actions[bot] Oct 2, 2026
a8d3601
Merge commit 'b25d9726a1fd87916a1b9c6af1ef11ab84aff25a' into release/…
github-actions[bot] Oct 2, 2026
38ee34b
Merge commit '35d54c13c7034c3412abb168cd04dda496dc0e48' into release/…
github-actions[bot] Oct 5, 2026
d3e22fd
Merge commit '8ebddb74d1af0b2fb3e7031ed9702c28a9dbff02' into release/…
github-actions[bot] Oct 5, 2026
f480211
Merge commit '7ba803554639f18484cf4edbc6c762fc0f276468' into release/…
github-actions[bot] Oct 5, 2026
c977a67
Merge commit '75e3568f1af2c2f5e6a9d114fe4dd953f991c306' into release/…
github-actions[bot] Oct 5, 2026
1bfb4d3
Merge commit '673b17b0cceb4b265f5f514fd8de3a0f10fc2659' into release/…
github-actions[bot] Oct 5, 2026
e31fda9
Merge commit 'b591436f2873a411c02b7d5891abc927e97a4ae3' into release/…
github-actions[bot] Oct 6, 2026
bd22589
docs: document Mermaid resource graph export (CLI and dashboard)
aspire-repo-bot[bot] Oct 6, 2026
3e6c5d9
Merge commit '95583eb13cfee1db86ed9574b42c147d57d85b68' into release/…
github-actions[bot] Oct 6, 2026
849e828
Merge commit 'a097c7e70fb77602627e43e1a01ba2c862e9bd0f' into release/…
github-actions[bot] Oct 6, 2026
18b5fd8
Add Aspire brand assets to the community docs (#1831)
IEvangelist Oct 7, 2026
7d37083
Merge commit 'd0da0bb0d75219668ef0685d0e451bc394eccc0d' into release/…
github-actions[bot] Oct 7, 2026
3f09caf
Refine brand pages and fix social previews (#1837)
IEvangelist Oct 7, 2026
35b8ab6
Merge commit '747709bfdc4a6b371010bf9c4065677b5a8e28d4' into release/…
github-actions[bot] Oct 7, 2026
1a446e5
Merge commit '6f96d2381b5549847395a3fd2c5aa9055273786b' into release/…
github-actions[bot] Oct 7, 2026
44a1021
[docs] Remove stale Aspire.RabbitMQ.Client.v6 / Aspire.MongoDB.Driver…
aspire-repo-bot[bot] Oct 8, 2026
2056663
Merge commit '1a61517655b4fd7811ef63fb5913f6fb623d9d6a' into release/…
github-actions[bot] Oct 9, 2026
831b8a1
Improve release navigation and brand-kit downloads (#1860)
IEvangelist Oct 10, 2026
bd5e7ff
Merge commit 'ce6d2424abb1414a581837605d8c793cfc869fb2' into release/…
github-actions[bot] Oct 12, 2026
bf78285
Merge commit '32f2d1c895952771c0d58924ef8c9115a37b3a0a' into release/…
github-actions[bot] Oct 12, 2026
ddaaa83
[docs] Document Mermaid export description in dashboard resource grap…
aspire-repo-bot[bot] Oct 12, 2026
a1cc402
Merge commit 'c1e2e160c74deb62576d5cb360131b03b55b2bea' into release/…
github-actions[bot] Oct 13, 2026
1a3d0d9
Merge commit '73158d1929860ac896485d12ad0d5d8cd5991b57' into release/…
github-actions[bot] Oct 13, 2026
c2a7f24
Resolve release sync conflicts for release/17.0 (#1886)
aspire-repo-bot[bot] Oct 14, 2026
4cb4b3e
Correct outdated DCP binary architecture documentation (#1893)
danegsta Oct 15, 2026
76c496a
[docs] Document dashboard telemetry opt-out for Docker Compose and Ku…
aspire-repo-bot[bot] Oct 15, 2026
1080319
[docs] Document dashboard startup telemetry (#1867)
aspire-repo-bot[bot] Oct 16, 2026
cef0f70
[docs] Recognize WSLc in aspire doctor container runtime docs (#1898)
aspire-repo-bot[bot] Oct 16, 2026
0b1ccbb
docs: document disconnected terminal recovery actions
aspire-repo-bot[bot] Oct 17, 2026
a458f69
Document WSLc support for Windows local development (#1903)
danegsta Oct 19, 2026
f5df0f7
Update terminal docs for instance-ID replica selection
aspire-repo-bot[bot] Oct 19, 2026
5c48cfb
Show 100 API results per page and add a data-driven support page card…
IEvangelist Oct 20, 2026
2a4036a
Document container registry images in published Kubernetes charts
aspire-repo-bot[bot] Oct 21, 2026
9b239d9
Add Go API reference (#1917)
IEvangelist Oct 22, 2026
09d9aa3
Document Go support in aspire docs api (#1923)
IEvangelist Oct 22, 2026
b40962d
Document the Go AppHost: getting started, conventions and CLI referen…
IEvangelist Oct 22, 2026
5b5f90b
Update aspire add docs: Kubernetes integrations are stable
aspire-repo-bot[bot] Oct 26, 2026
e0c306b
Document withTerminal callback in TypeScript AppHosts
aspire-repo-bot[bot] Oct 27, 2026
db346f9
[docs] Document VS Code Azure Functions Node debugging (#1889)
aspire-repo-bot[bot] Oct 27, 2026
74882eb
Document PVC configuration callbacks
aspire-repo-bot[bot] Oct 28, 2026
c3c2354
[docs] Update StorageMinimumTlsVersion.Tls1_2 to Tls12 for Azure.Prov…
aspire-repo-bot[bot] Oct 30, 2026
2d31c0f
[docs] Document aspire ps --output snapshot mode (#1910)
aspire-repo-bot[bot] Oct 30, 2026
79dbf55
Document DOTNET_CLI_TELEMETRY_OPTOUT for project resources
aspire-repo-bot[bot] Oct 30, 2026
3fef392
[docs] Document ASPIRE009 setup output (#1943)
aspire-repo-bot[bot] Nov 2, 2026
b44fbc1
Update Aspire.Hosting.Dotnet stability notes for 17.0
aspire-repo-bot[bot] Nov 3, 2026
450a6af
Document existing AKS clusters
aspire-repo-bot[bot] Nov 3, 2026
f533664
Document malformed secrets diagnostics
aspire-repo-bot[bot] Nov 4, 2026
9c7467e
Document template picker sources and displayName
aspire-repo-bot[bot] Nov 5, 2026
b698973
Fix API prerender payload duplication across languages (#2053)
IEvangelist Nov 5, 2026
9e6c9b0
A couple of small style clarifications.
alistairmatthews Nov 5, 2026
0b415c4
Integrated feedback from @copilot.
alistairmatthews Nov 5, 2026
4b1998a
[docs] Clarify dotnet-inspect requires a C# AppHost in aspire agent i…
aspire-repo-bot[bot] Nov 5, 2026
bee8759
Document structured Kubernetes manifest field values
aspire-repo-bot[bot] Nov 6, 2026
cf4602b
[docs] Document Azure API Management hosting integration (#2083)
eerhardt Nov 10, 2026
4e39df9
Document Go starter React frontend
aspire-repo-bot[bot] Nov 10, 2026
40b8f94
[docs] Document pipeline output drift detection for Aspire 17.0 (#2082)
eerhardt Nov 10, 2026
8eebbfa
[docs] Document Azure Front Door Private Link for Container Apps and …
eerhardt Nov 11, 2026
e1b2b38
Document the Microsoft Entra ID integration for Aspire 17.0 (#2086)
eerhardt Nov 11, 2026
aa493db
Document Entra ID security considerations from release review (#2111)
eerhardt Nov 11, 2026
dee378f
Recapture dashboard images from the latest dashboard UX
IEvangelist Nov 11, 2026
9f2c58f
Merge main into release/17.0
eerhardt Nov 11, 2026
1d81f00
Recapture dashboard images with message bars dismissed, realistic dem…
IEvangelist Nov 11, 2026
8c8217d
Document new dashboard UX in explore: filters, grouping, sidebar, sel…
IEvangelist Nov 11, 2026
6dc9e1c
Recapture remaining dashboard images (actions, notifications, span de…
IEvangelist Nov 11, 2026
ca6a67f
Update src/frontend/src/content/docs/integrations/frameworks/dotnet/d…
alistairmatthews Nov 11, 2026
d90a3c1
Update src/frontend/src/content/docs/integrations/frameworks/dotnet/d…
alistairmatthews Nov 11, 2026
7719146
[docs] Document configurable agent plugins and skill sources (#2032)
aspire-repo-bot[bot] Nov 11, 2026
06c7a86
Update homepage carousel test for 2560x1600 dashboard captures
IEvangelist Nov 11, 2026
e2a63b2
Merge main into release/17.0 (#2117)
IEvangelist Nov 11, 2026
54f6115
Recapture wrong-theme dashboard images with verified theme
IEvangelist Nov 11, 2026
598f5c3
Recapture help, settings and recordings dialogs in the correct theme
IEvangelist Nov 11, 2026
e215cf3
Capture landing resources table and trace detail at full size
IEvangelist Nov 11, 2026
530b780
Capture landing resources table (dark) at full size
IEvangelist Nov 11, 2026
d7f8d79
Document IDE launch behavior for AddDotnetProject
aspire-repo-bot[bot] Nov 11, 2026
79123b6
Recapture dashboard images: rich traces, collapsed sidebar, dismissed…
IEvangelist Nov 12, 2026
39bc22a
Fix notification, logs error, metrics filter captures; add grayed sid…
IEvangelist Nov 12, 2026
b29d16e
Recapture structured logs error images from inventoryservice
IEvangelist Nov 12, 2026
569d21a
Recapture structured-logs-filtered as the Add filter flyout
IEvangelist Nov 12, 2026
7334bec
Normalize dashboard image names: dark is the default, only light gets…
IEvangelist Nov 12, 2026
8d6141c
Merge commit 'e0fd84886484752a7c7c1d68a3134d6e9745e550' into release/…
github-actions[bot] Nov 12, 2026
c07c251
[docs] Document 17.0 dashboard image for generated deployments (#1909)
aspire-repo-bot[bot] Nov 12, 2026
4b09031
[docs] Document default hosting packages for aspire init (#2052)
aspire-repo-bot[bot] Nov 12, 2026
c00bd2a
[docs] Document Git diagnostics and timeouts for aspire new (#2116)
aspire-repo-bot[bot] Nov 12, 2026
9a541ce
Merge commit 'dee0fddbebb2316300115cb36069b166c8afc3e9' into release/…
github-actions[bot] Nov 12, 2026
b81bc9d
[docs] Document WithBindMount idempotency and conflicting mount targe…
aspire-repo-bot[bot] Nov 12, 2026
dfe14d6
[docs] Document aspire tray commands and Linux tray support (#2067)
aspire-repo-bot[bot] Nov 12, 2026
072eb00
Reframe metrics-view-filtered so chart and filters both show
IEvangelist Nov 12, 2026
5012977
Document settings table, resource list density, and overview summary …
IEvangelist Nov 12, 2026
9b563c6
Document resource overview panels toggle
IEvangelist Nov 12, 2026
9808f74
Add Aspire Outage slides to landing dashboard carousel
IEvangelist Nov 12, 2026
890f5d2
Recapture Build your first app dashboard screenshots with the latest …
IEvangelist Nov 12, 2026
843912f
Recapture unresolved parameters dashboard screenshot
IEvangelist Nov 12, 2026
e6e85eb
Recapture health checks dashboard screenshot
IEvangelist Nov 12, 2026
bdc3835
Merge commit 'ba5dc9e54a019866118162a9777c6d575c785d07' into release/…
github-actions[bot] Nov 12, 2026
30b7a41
Merge commit '069fe7bcf0ec431c771fa89c11d9a3ca1cab2421' into release/…
github-actions[bot] Nov 12, 2026
729366f
Document Aspire 17.0 breaking changes (#2134)
eerhardt Nov 12, 2026
2b48dec
Add Go AppHost alongside C# and TypeScript across landing page, compo…
IEvangelist Nov 13, 2026
b30d031
[docs] Document aspire update --config-source behavior (#2139)
aspire-repo-bot[bot] Nov 13, 2026
b132a5e
[docs] Document dashboard self-telemetry OTLP service name (#1821)
aspire-repo-bot[bot] Nov 13, 2026
9f0fd72
[docs] Document aspire new --use-config-source and Git fetch notice (…
aspire-repo-bot[bot] Nov 13, 2026
f1d3583
[docs] Add SQL highlighting to dashboard text visualizer docs (#1842)
aspire-repo-bot[bot] Nov 13, 2026
cb8e496
[docs] Document Dashboard:Frontend:DisableWebSocketCompression settin…
aspire-repo-bot[bot] Nov 13, 2026
6ed43bc
[docs] Dashboard footer counts and pause indicator (#2125)
aspire-repo-bot[bot] Nov 13, 2026
cff498f
[docs] Document dashboard telemetry attribute renaming and new enrich…
aspire-repo-bot[bot] Nov 13, 2026
0cc3e83
[docs] Document simplified expanded resource grid actions (#2128)
aspire-repo-bot[bot] Nov 13, 2026
234d7e1
[docs] Document array-aware aspire config set (#2026)
aspire-repo-bot[bot] Nov 13, 2026
05b6e09
[docs] Describe telemetry setup empty-state guidance on monitoring pa…
aspire-repo-bot[bot] Nov 13, 2026
81e2050
Merge release/17.0 into recapture-dashboard-images
IEvangelist Nov 13, 2026
ae9981f
Recapture dashboard images (main dashboard UX) (#2113)
IEvangelist Nov 13, 2026
37dd35b
Add dashboard-screenshots skill (#2112)
IEvangelist Nov 13, 2026
26227a3
[docs] Document idle polling behavior in VS Code extension (#2096)
aspire-repo-bot[bot] Nov 13, 2026
65e8678
[docs] Clarify Aspire Outage game is only in the new dashboard (#2144)
aspire-repo-bot[bot] Nov 13, 2026
8e4aa65
[docs] Document dev tunnel readiness and reconciliation improvements …
aspire-repo-bot[bot] Nov 13, 2026
b9107f0
Label the aspire tray commands as Preview (#2145)
sebastienros Nov 13, 2026
1bce59d
[docs] Document aspire destroy rejecting unknown arguments (#1975)
aspire-repo-bot[bot] Nov 13, 2026
09b401e
[docs] Document FoundryModel.Nvidia provider family (#2055)
aspire-repo-bot[bot] Nov 13, 2026
9f70616
[docs] Lower minimum Helm version to 4.0.0 (#2012)
aspire-repo-bot[bot] Nov 13, 2026
c2bf880
[docs] Document "Open resource source" action in VS Code extension (#…
aspire-repo-bot[bot] Nov 13, 2026
74bc014
[docs] Document ASPIRE013 and scope ASPIRE010 to non-C# AppHosts (#2071)
aspire-repo-bot[bot] Nov 13, 2026
dab475c
Fix release/17.0 CI: aspire destroy unknown-option sample (#2149)
sebastienros Nov 13, 2026
e768b17
[docs] Document browser-stored dashboard tags, order and metric pins …
aspire-repo-bot[bot] Nov 13, 2026
2399bf1
[docs] Document modernized dashboard experience (#1985)
aspire-repo-bot[bot] Nov 13, 2026
6365967
[docs] Document Go AppHost checks in aspire doctor (#1966)
aspire-repo-bot[bot] Nov 13, 2026
161faac
[docs] Document godoc comments in generated Go SDK (#1981)
aspire-repo-bot[bot] Nov 13, 2026
c269b53
[docs] Document resource type display names (#2065)
aspire-repo-bot[bot] Nov 13, 2026
1898531
[docs] Document Bicep parameter expressions for enum-valued SKU prope…
aspire-repo-bot[bot] Nov 13, 2026
9615d4d
Document WithDisplayOrder and consolidate dashboard explore fixes (#2…
aspire-repo-bot[bot] Nov 13, 2026
31db64a
[docs] Document Mongo Express direct connection for single-member rep…
aspire-repo-bot[bot] Nov 14, 2026
3452dec
[docs] Document Go AppHost debugging in the VS Code extension (#1982)
aspire-repo-bot[bot] Nov 14, 2026
3d22625
Reframe IDE launch section around developer-facing capabilities and l…
karolz-ms Nov 14, 2026
036a68a
[docs] Aspire.Hosting.Dotnet is stable in Aspire 17.0 (#2039)
karolz-ms Nov 14, 2026
42f7ccb
Align Go starter walkthrough with React frontend setup
karolz-ms Nov 14, 2026
742ea91
[docs] Document DOTNET_CLI_TELEMETRY_OPTOUT for project resources (#2…
karolz-ms Nov 14, 2026
8a01f84
Merge remote-tracking branch 'origin/release/17.0' into docs/pr-21874…
karolz-ms Nov 14, 2026
7d56943
[docs] Document Go starter React frontend and optional Redis (#2106)
karolz-ms Nov 14, 2026
ce10cec
[docs] Document IDE launch behavior for AddDotnetProject (#2122)
karolz-ms Nov 14, 2026
acaeb93
Bring Go deployment verification and AppHost samples up to date (#2148)
IEvangelist Nov 14, 2026
7c9b07b
Merge commit '5b0461795e8f32e71d4c0822163d034441a8c6b6' into release/…
github-actions[bot] Nov 14, 2026
230d75a
Merge commit '63a219cba4885fe230522777aef20eb875c284ee' into release/…
github-actions[bot] Nov 15, 2026
681cdfe
Merge commit 'c1ec59987f2deb629c297ab13f589b2875484a6e' into release/…
github-actions[bot] Nov 15, 2026
30e1484
Add verified Aspire 17 release-note sections
mitchdenny Nov 15, 2026
a7c4a3e
Merge commit '7c85827587dd240b750ee87e0de60f2dcd7fc7cb' into release/…
github-actions[bot] Nov 15, 2026
cf162b7
Fix Go quickstart highlight alignment and API links (#2164)
IEvangelist Nov 15, 2026
2adb709
Document custom CLI sources and link Entra ID guide
mitchdenny Nov 15, 2026
6847506
Show TestShop in the Aspire 17 dashboard
mitchdenny Nov 15, 2026
eebeb3d
Expand the TestShop dashboard tour with live telemetry
mitchdenny Nov 15, 2026
f708754
Lead custom CLI examples with repository templates
mitchdenny Nov 16, 2026
e35f335
Wrap init-source command across two lines
mitchdenny Nov 16, 2026
b8a93e6
Correct init-source refs and core Deno documentation link
mitchdenny Nov 16, 2026
f1276a2
[docs] Document optional parameters and programmatic value setting (#…
aspire-repo-bot[bot] Nov 16, 2026
40a3e01
Add verified Aspire 17.0 highlights without changing curated sections…
mitchdenny Nov 16, 2026
eb172f1
Merge commit '480aad166cb8939023bf48de81969d4d4955ab55' into release/…
github-actions[bot] Nov 16, 2026
08483e6
[docs] Document ResourceUrlAnnotation.DisplayOrder (#1806)
aspire-repo-bot[bot] Nov 16, 2026
a882699
[docs] Add CLI installation source telemetry data point (#1807)
aspire-repo-bot[bot] Nov 16, 2026
b307312
Add docs for ASPIREAZURE004-007 diagnostics (#2138)
eerhardt Nov 16, 2026
522d880
docs: consolidate 17.0 retired experimental diagnostics
maddymontaquila Nov 16, 2026
95f80c2
docs: address review feedback and split AddCSharpApp migration guidance
maddymontaquila Nov 16, 2026
689aa8c
[docs] Document aspire secret set --envvar and interactive input (#2059)
aspire-repo-bot[bot] Nov 16, 2026
2cbbb65
docs: remove redundant retirement badges
maddymontaquila Nov 16, 2026
04de3cc
[docs] Document existing Dockerfile entrypoint handling for Go and Py…
aspire-repo-bot[bot] Nov 16, 2026
4d1b51d
[docs] Update MongoDB container image tag to 9.0 (#1931)
aspire-repo-bot[bot] Nov 16, 2026
c2f0fde
[docs] Update SQL Server REPL docs for direct sqlcmd invocation and w…
aspire-repo-bot[bot] Nov 16, 2026
b6caefb
[docs] Dashboard resource table is now the home page (#2141)
aspire-repo-bot[bot] Nov 16, 2026
c1702a2
[docs] Document dashboard Overview layouts after Cards removal (#2056)
aspire-repo-bot[bot] Nov 16, 2026
71fe831
Consolidate 17.0 retired experimental diagnostics docs (#2176)
maddymontaquila Nov 16, 2026
9e9f421
[docs] Update dashboard resources page docs for simplified dashboard …
aspire-repo-bot[bot] Nov 16, 2026
0b98605
Document VS Code extension language model tools added in 17.0 (#2150)
ellahathaway Nov 16, 2026
0cb4f0c
Merge commit 'c47e92a61d71ad0a281cdd2c23f91ccbccbccd1b' into release/…
github-actions[bot] Nov 16, 2026
83ccf8c
[docs] Kubernetes hosting packages are now stable (aspire add) (#1947)
mitchdenny Nov 17, 2026
0b88e9a
[docs] Document structured Kubernetes manifest field values (#2072)
mitchdenny Nov 17, 2026
4f42cf2
Consolidate template source CLI docs into aspire new picker PR
mitchdenny Nov 17, 2026
206f89d
[docs] Document configured templates in aspire new picker (#2057)
mitchdenny Nov 17, 2026
a523db0
Consolidate AKS infrastructure and node pool documentation
mitchdenny Nov 17, 2026
25d8ff8
Use AddDotnetProject in AKS documentation examples
mitchdenny Nov 17, 2026
33a4c98
[docs] Document container registry images in published Kubernetes cha…
mitchdenny Nov 17, 2026
707e134
[docs] Consolidate AKS cluster, registry, identity, and node pool gui…
mitchdenny Nov 17, 2026
3755a97
docs: add prerelease (staging) testing walkthrough to upgrade guide (…
maddymontaquila Nov 17, 2026
a9d463a
Document Azure Web PubSub emulator usage (#2185)
sebastienros Nov 17, 2026
7f66ba0
Fix terminal configuration guidance for Aspire 17
mitchdenny Nov 17, 2026
c8ee024
Clarify terminal replica discovery
mitchdenny Nov 17, 2026
681f88e
docs: clarify disconnected terminal recovery
mitchdenny Nov 17, 2026
9b5033b
docs: clarify terminal navigation and metadata
mitchdenny Nov 17, 2026
6b78b0d
Merge commit '1379c1e689935c97d99a99c5f208eb7ee5e3f9d8' into release/…
github-actions[bot] Nov 17, 2026
04a36d9
Fill gaps in What's new in Aspire 17.0 (#2177)
IEvangelist Nov 17, 2026
18a36d5
Remove obsolete terminal diagnostic note
mitchdenny Nov 17, 2026
e4ad537
[docs] Document aspire doctor local skill files warning (#2063)
aspire-repo-bot[bot] Nov 17, 2026
dd0c4d9
[docs] Go module helpers certificate trust defaults (#2143)
aspire-repo-bot[bot] Nov 17, 2026
36b1790
Update Aspire skills docs to match microsoft/aspire-skills (#2165)
IEvangelist Nov 17, 2026
c555a13
docs: Migrate to AddDotnetProject/DotnetProjectResource and remove As…
maddymontaquila Nov 17, 2026
214c013
Fill remaining Aspire 17.0 doc gaps and add 17.0 dashboard captures (…
IEvangelist Nov 17, 2026
8ecf1a7
docs: remove obsolete terminal host configuration (#1835)
aspire-repo-bot[bot] Nov 17, 2026
bde8afb
[docs] Document withTerminal configuration callback for TypeScript Ap…
mitchdenny Nov 17, 2026
db69909
[docs] Document Hex1b terminal upgrade: scrollbar marks, palette, doc…
mitchdenny Nov 17, 2026
05457d4
[docs] Document disconnected terminal output recovery (#1904)
mitchdenny Nov 17, 2026
7ed8ae1
[docs] Update terminal docs for instance-ID replica selection (#1913)
mitchdenny Nov 17, 2026
bc0c23d
Use public PersistentVolumeClaim type in WithConfiguration signature
mitchdenny Nov 17, 2026
c88797f
Merge release/17.0 and consolidate Mermaid export documentation
mitchdenny Nov 17, 2026
8202b16
[docs] Document Kubernetes PVC configuration callbacks (withConfigura…
mitchdenny Nov 17, 2026
4b5a267
docs: place Mermaid export with graph view
mitchdenny Nov 17, 2026
a032626
[docs] Document Mermaid resource graph export in dashboard and CLI (#…
mitchdenny Nov 17, 2026
50b8746
Merge release/17.0 and preserve secrets diagnostics guidance
mitchdenny Nov 17, 2026
468fdff
Direct malformed secrets repairs to the diagnostic file
mitchdenny Nov 17, 2026
88f4d95
[docs] Document malformed secrets diagnostics and side-effect-free se…
mitchdenny Nov 17, 2026
f1935fe
Merge commit 'f8085d872ff3f3fa2cc9b80abc3c5fd47b8fe2f7' into release/…
github-actions[bot] Nov 17, 2026
c95a180
Consolidate docs-from-code updates for Aspire 17.0 (#2189)
IEvangelist Nov 17, 2026
612fa61
[docs] Document TypeScript/JavaScript Azure Functions app support (#1…
aspire-repo-bot[bot] Nov 17, 2026
c35a790
[docs] Document --remove-skill-copies for aspire agent init (#2146)
aspire-repo-bot[bot] Nov 17, 2026
259ba89
Document ASPIRE014 diagnostic
aspire-repo-bot[bot] Nov 7, 2026
f88b9ab
Move ASPIRE014 to Warnings sidebar group; note 17.1 in SDK docs
maddymontaquila Nov 17, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
139 changes: 139 additions & 0 deletions .agents/skills/dashboard-screenshots/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,139 @@
---
name: dashboard-screenshots
description: One-shot recapture of Aspire dashboard screenshots for aspire.dev. Builds the dashboard from microsoft/aspire, runs a demo AppHost, drives playwright-cli to discover the existing images and capture each one in both themes, adds red callouts, and verifies framing and theme pairs. Use when the dashboard UX changed and the images under src/frontend/src/assets/dashboard need refreshing.
---

# Dashboard screenshots

Regenerates dashboard images in place (same file names) so MDX needs no changes except for fixes reported by the verify step.

## Run it

```powershell
cd .agents\skills\dashboard-screenshots
bun install
bun scripts/run.ts
```

Prerequisites: git, bun, node, Edge, and `@playwright/cli` installed globally (`npm i -g @playwright/cli`). The script clones microsoft/aspire into `%TEMP%\aspire-dashboard-shots`, builds the demo AppHost in `demo\`, starts it, captures, verifies, writes a report, and tears everything down.

Flags:

| Flag | Meaning |
| --- | --- |
| `--branch <name>` | aspire branch to build. Default `main`: release branches may show an older dashboard UX. Confirm visually (e.g. the resources table has no left "Select all" pane). |
| `--only <id[,id]>` | capture only these shot ids |
| `--attach` | reuse an already running dashboard at http://localhost:17170 |
| `--keep` | do not tear down the dashboard or browser |
| `--inventory` | only write `inventory.csv` of existing images (size, theme, name) |

## Discovery and recipes (no committed manifest)

Every run starts with a discovery phase: it inventories `src/frontend/src/assets/dashboard`, scans the docs for who embeds each image, joins the images with the capture recipes in `scripts/recipes.ts`, and writes an ephemeral `shots.json` to the work dir (`%TEMP%\aspire-dashboard-shots\w`). The file is deleted when the run ends (kept only with `--keep`) and must never be committed. Discovery reports **UNMAPPED** images (exist, no recipe), **NEW** shots (recipe, no image yet) and **UNREFERENCED** images (no doc embeds them); resolve each before capturing. Add or fix recipes in `scripts/recipes.ts`, which holds only how to capture, not which images exist.

Viewport 1280x800 at 2x, padding 16. Each shot has `id`, `out.dark`/`out.light`, `route`, optional `steps`, `callout`, `height`, `clip`, `autoCrop`, `keepAlerts`.

Step types: `click` (text), `clickSel`, `hover`, `hoverSel`, `fill`, `press`, `wait`, `closeDialog`, `js` (raw playwright code with `page` in scope). `{{Theme}}` inside any step is replaced with `Dark` or `Light` for the current capture, so a single recipe can pick an explicit theme. Shot options: `also` (extra file names for the same capture), `thumb` (resized copy), `legacyLight` (skip the `-light` naming check when docs already use a different light filename).

Runner behaviour: the cached clone is refreshed to the tip of `--branch` on every run; `--only a,b` matches each comma-separated id as a substring; failed attempts never reuse stale PNGs; `--keep` leaves the AppHost and the `shots` browser session open; cleanup only closes the `shots` session, never other playwright-cli sessions.

## UX audit (do this BEFORE capturing)

Recapturing is not enough: the UX may have gained surfaces the docs never showed (e.g. the Help dialog now has Documentation / Keyboard shortcuts / AI agents tabs; Settings gained new options). Run the audit against the live dashboard and treat it as the source of truth for what the docs should cover:

1. `bun scripts/audit-ux.ts` writes `ux-audit.json` / `ux-audit.md` to the work dir: main tabs, header buttons, and for the Help, Settings and Recordings dialogs every tab plus its headings, switches, selects and buttons.
2. Compare against the previous release (run the audit on the old dashboard or read the old images) and list **new, removed and renamed** UI: tabs, dialog tabs, settings, toolbar buttons, graph controls.
3. For every new surface add a recipe to `scripts/recipes.ts` (one per dialog tab, one per new settings section, both themes) and a `ThemeImage` in the docs.
4. For every changed or replaced image, open the MDX that embeds it (`grep` for the filename) and re-read the surrounding prose, alt text and step lists. Fix anything that no longer matches the UI (button names, tab order, menu paths, removed features). Record each fix in the PR body under "UX changes".
5. Settings and Help are drawers/dialogs; audit tabs via `fluent-drawer-body` and `[role=tab]`/`fluent-tab`. Scroll long Settings content and capture each section.

## Rules

- **Themes**: capture every shot once per theme. Naming is `<page>-<context>.png` for dark (the default, never a `-dark` suffix) and `<page>-<context>-light.png` for light only. Docs must use `<ThemeImage dark={x} light={xLight} alt="..." />` from `@components/ThemeImage.astro`; verify flags pages that reference only one theme. Fix those in MDX.
- **Alerts**: before each capture the script dismisses banners, toasts, welcome and update messages (`.dashboard-message-bar-dismiss`). Bars can arrive late or reappear after steps, so a final dismiss pass (plus a CSS hide of the message-bar provider) runs immediately before callouts and the screenshot. Always scan contact sheets (`sheet.ts`) for leftover bars, and sidebar drag/resize applies only to Graph and telemetry pages. Set `keepAlerts: true` only when the alert is the subject. The Notifications panel is not closed by Escape; use a fresh navigation.
- **Callouts**: red (`#e8212e`, ~3px) rectangles around the selector in `callout`, matching old images that had them.
- **Framing**: avoid large blank areas. Use `autoCrop` (not a small `height`) to trim trailing blank space, `clip` for regions. Keep resolution consistent.
- **Graph view**: Settings > Overview layout > Graph, close dialog, click the Overview tab.
- Row action buttons only appear on hover; hover first.

## Windows playwright-cli quirks

- Invoke `node <npm root -g>\@playwright\cli\playwright-cli.js -s=<session> run-code "<js>"`.
- Screenshot paths must be absolute with forward slashes.
- Use `--browser=msedge`. No ffmpeg, so GIFs cannot be regenerated; report them as skipped.

## Review phase (mandatory, after capturing, before committing)

Scripted checks (`verify()`) are not enough. Look at every image and judge it:

1. Build contact sheets (`bun scripts/sheet.ts <out.png> <paths>`) and view each shot next to its original (`git show origin/release/17.0:<path>`).
2. For each, answer: Does it show the same UI the docs' alt text and surrounding prose describe (right page, dialog, menu, state)? Is it the right theme for its filename? Are all message bars dismissed? Is it framed well (no big blank areas, not squashed, similar size to the original)? Should the sidebar be collapsed to give the content room (for example traces and landing console)?
3. Adjust the manifest (steps, route, callouts, `autoCrop`, collapse step) and recapture only the failing ids with `--attach --keep --only`.
4. Repeat until every image passes. Record anything you could not make right in the report.

Review checklist per image: same subject as the original and the docs' alt text (compare against `git show origin/release/17.0:<path>`); sidebar collapsed (`"collapseSidebar": true` or an explicit collapse step) unless the sidebar is the subject; no message bars or toasts; filters, menus and selections visible when the doc describes them; content rich enough (no trivial one-span traces or empty tables); no large blank areas; correct theme; `landing/*` exactly 2560x1600.

## Rich demo telemetry

The demo AppHost's `inventoryservice` exposes `/orders/{id}` with nested redis, postgres and rabbitmq spans, and the web traffic generator calls it regularly. Trace shots must open one of those traces (click the traces-list row `inventoryservice (6)`, then select a span via a `js` step using `getByText(...).locator('visible=true')`), not the default 2-span `/weatherforecast` trace. Wait about a minute after demo start for telemetry to accumulate.

Capture-script lessons: reset `localStorage` only after navigating to the dashboard origin and before setting the theme cookie (otherwise `SecurityError` or a theme mismatch); fluent text fields cannot be `fill`ed, click then type; `--only` takes comma-separated id substrings and "trace" also matches `landing-trace-detail`, `traces-*` and `trace-view-*`.

## Report

The run prints captured/failed counts and lists unreproducible or skipped images (old UX concepts, terminals, Copilot/MCP dialogs, GIFs). Review captured images visually before committing. Never run `bun run build`; `git restore` any `.starlight-icons` churn.

## Known selectors and gotchas

- Console log "Download logs" lives in the log pane's settings (sliders) menu: `fluent-button.toolbar-button[aria-label='Settings']` (last). There is no toolbar Download button.
- Row actions: hover the row, then force-click `[aria-label='Actions for <name>']`; pick items with `getByRole('menuitem',{name})` and `click({force:true})`. Notifications bell is `getByRole('button',{name:'Notifications'})`.
- Resource sidebar: drag `.resource-pane-resizer`; collapse via "Collapse resource list", then use `.resource-picker-button` (Filter box, All resources, Ctrl+click multi-select, Shift+click range).
- Aspire Outage: `[aria-label='Play Aspire Outage']`; modes `.resource-graph-game-button` (Normal) / `.resource-graph-game-hardcore` (Hard); Esc exits.
- A final dismiss pass runs before every capture; message bars can reappear, so never capture without it.
- Error badge counts grow over time; recapture soon after startup.

## Not captured by this manifest

- Needs replicas (`console-logs-with-replicas`, `telemetry-resource-filter`): add `WithReplicas(2)` to the demo temporarily.
- Needs other setups: login, terminals, copilot, mcp-dialog, standalone, dashboard-run-selector, `trace-view-filter-advanced`, `trace-page-from-exemplars`, `project-graphs`, `settings-manage-telemetry`.
- Not dashboard captures: architecture diagrams, `.excalidraw` files, GIFs.

## Dashboard images outside `assets/dashboard` (manual, starter-based)

These are captured ad hoc against real starters, not the demo AppHost:

- `assets/get-started/{csharp,javascript}-aspire-dashboard(-light).png`: `aspire new aspire-starter` / `aspire-ts-starter` with `--non-interactive --use-config-source false`, then `aspire run --non-interactive` (run it in the background; it blocks). Capture `/resources` at 1100x300 (C#) or 1100x400 (JS), 2x, message bars hidden.
- `assets/fundamentals/dashboard-unresolved-parameters-message(-light).png`: add `addParameter("api-key", { secret: true })` with no value; 1000x520 @2x, hide the feedback bar with `.dashboard-message-bar.intent-info{display:none!important}`.
- `assets/fundamentals/health-checks-dashboard-status(-light).png`: add `.withHttpHealthCheck({ path: "/health" })`, select the resource, clip 1100x345 so the Status card shows Health state.
- Still old UI and unrefreshed: `whats-new/dashboard-update-notification` (needs a newer-version "Update now" bar), `integrations/custom-integrations/*` (need the MailDev/MailKit sample apps), `integrations/efcore/dashboard-post-migration-*`. Version-specific `whats-new/aspire-9.x` images stay historical.

## Theme gotcha

The dashboard persists its theme in the `currentTheme` cookie (`Dark`/`Light`), which `localStorage.clear()` does not reset. `run.ts` clears cookies and sets the cookie per shot, and treats a capture as failed unless `documentElement.dataset.theme` matches the requested theme. After a run, scan mean luminance: `-light` files should be bright, all others dark.


## Do not shrink the viewport

Never set a small per-shot `height` (under ~700): the dashboard footer and layout collapse and the capture shows cut-off content. Use `autoCrop` (trims trailing blank space) or `clip` (element crop). `verify` flags any non-clip image under half the viewport height; open every flagged image and check it shows the intended UI.

## Intent lessons from review

- Quote comma lists: `--only "a,b"` (unquoted PowerShell splits it and captures nothing).
- `js` steps run in Playwright, not the page; use `page.evaluate` for DOM access.
- Notifications only appear after an action: trigger Rebuild on `webfrontend` (wait ~15s) before opening the bell or View response.
- Error logs and traces come from `apiservice` (`/forecast/unavailable`), not `webfrontend`.
- Metrics filters: use `webfrontend` > `Microsoft.AspNetCore.Hosting` > `http.server.request.duration`, and open a filter that exists (`http.response.status_code`).
- `sidebar-grayed-resources` shows dimmed resources that have no data for the current page.
- **Metrics instrument detail:** never `scrollIntoViewIfNeeded` (it scrolls the chart out of view) and do not collapse the sidebar (a wide chart leaves a blank band above Filters). Load the instrument by URL (`?meter=...&instrument=...&duration=5`), use `height: 1000` so chart + Filters + open filter menu all fit.
- **Structured logs:** errors come from `inventoryservice`; `traceId` is a URL param; row menus use `td.log-row-error fluent-button[aria-label='Actions']`; the Add filter flyout is `.filter-dialog-form`.

## Process lessons (apply on every run)

- **Judge by intent, not file existence.** Several early "successful" captures showed the wrong UI (e.g. the Add filter flyout in place of health status, empty notification flyouts). For every image, read the doc that embeds it, open the old image, and compare what it was meant to show.
- **Find every consumer before renaming.** Search `src/frontend/src` for each asset name (en and `ja` docs, `DashboardCarousel.astro`) and update imports in the same commit. Naming: bare name = dark, `-light` = light, never `-dark`.
- **Audit the whole site, not just `assets/dashboard`.** Grep all of `src/frontend/src/assets` for dashboard captures (get-started, fundamentals, integrations, whats-new) and the landing carousel; see the manual section above.
- **Add new UI to docs and carousel in the same pass.** New dashboard features (density, overview panels, metrics filters, show-empty-panels toggle) need doc prose plus shots; landing images are 2560x1600 so never `autoCrop` them.
- **Keep PRs split:** skill and manifest on one branch, generated images and MDX on another; push manifest changes first, then move the PNGs.
- **Match the product version.** Record which dashboard build was used (demo AppHost on release/17.0 vs. the installed CLI's bundled dashboard) in the PR body.
- **CI quirks:** frontend build ~9 min, E2E 10-20 min; rerun only failed jobs for flakes. Never run a local site build.
- **Tooling quirks:** `aspire run` blocks (start it hidden/background); `run-code` screenshot paths must be inline forward-slash absolute paths; the `view` tool needs a copy to a fresh temp name; the playwright session can die, so re-running `--only` reopens it.
Loading
Loading