[whats-new] Expand 13.3 release notes by joperezr · Pull Request #838 · microsoft/aspire.dev

joperezr · 2026-05-05T19:48:01Z

Expands the Aspire 13.3 What's New page with comprehensive coverage of new features, bug fixes, and breaking changes from the 13.3 release.

Summary

Preserves the four existing hand-written sections verbatim (Front Door, Network Security Perimeter, Container tunnel, Python starter), reorganized under thematic h2 umbrellas where appropriate.
Adds coverage for all major 13.3 features identified in the 13.3 changelog wiki, including AKS system node pools, K8s ingress, Java polyglot (experimental), AKS telemetry, browser logs, EF Core migrations, ExcludeReferenceEndpoint, Subscribe* lifecycle helpers, the dashboard/CLI rebuild resource command, ATS-first API design, and more.
Adds a Breaking changes table and migration guidance.
Includes a trimmed Bug fixes section focused on user-visible items.

Validation

The draft was iteratively reviewed by three independent review agents (Opus 4.7, Opus 4.6, Sonnet 4.6) using the 13.3 changelog wiki as source of truth. All consensus blockers across both review rounds have been addressed, including:

Verified every API mentioned against microsoft/aspire source on release/13.3 (WithSystemNodePool, HttpCommandResultMode.Auto, K8s WithIngressClass/WithHostname/WithRoute, AddEFMigrations + RunDatabaseUpdateOnStart, ExcludeReferenceEndpoint, SubscribeBeforeStart/SubscribeAfterResourcesCreated, Java polyglot feature flag).
Removed several fabricated APIs that earlier drafts had hallucinated.
Restored the Python starter section verbatim from release/13.3.

- Refresh intro paragraph instead of reusing 13.2 copy - Trim and refocus the highlights bullet list on the biggest features - Drop the .NET 10 SDK requirement note (CLI bundles its own .NET) - Fix upgrade commands (aspire update --self for CLI, aspire update for projects) - Revert sidebar maxHeadingLevel to 2 (single-level On this page menu) - Remove the Security fixes section (no security-related fixes in 13.3) Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

- Drop 'one of the largest releases yet' framing - Remove EF Core migration management section and its breaking-change row (not fully tested) - Add 'and much more...' to the highlights list - Add Browser log capture, JavaScript publish methods (preview), and aspire init (preview) to highlights - Mark all AKS, Kubernetes, JavaScript publish, and aspire init mentions as preview Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

…amples Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

….NET Core dev cert Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

The Tabs syncKey attribute appears to prevent rendering in this Starlight version when used directly (it works only via the OsAwareTabs wrapper which adds a manual sync script). Match 13.2's plain <Tabs> pattern. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

The TS tabs weren't rendering because Starlight requires an `id` attribute on each TabItem when `syncKey` is set. Match the verified-working pattern from get-started/what-is-aspire.mdx: `syncKey='aspire-lang'` plus `id='csharp'` / `id='typescript'` on each TabItem. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Adds TypeScript AppHost equivalents to 5 samples that were previously C#-only: Azure Front Door, Network Security Perimeter, AKS environment, Privileged Docker Compose service, and WithBrowserLogs. All 5 APIs are exposed via [AspireExport] so they're available in the TypeScript SDK. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

@danegsta

Apply suggestions from @danegsta clarifying that the DCP certificate behavior is Windows-specific and the default is an ephemeral cert. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

- Correct DCP developer cert env var name to ASPIRE_DCP_USE_DEVELOPER_CERTIFICATE. - Standalone dashboard --dashboard-url/--api-key live on `aspire agent mcp` and `aspire otel` subcommands (not `aspire run`); rewrite section and example to match the actual workflow. - Clarify that AzurePromptAgentResource still exists; only its original shape was replaced by AddPromptAgent. - Note that the CLI has always shipped as a dotnet tool; 13.3 makes it a NativeAOT dotnet tool using new .NET 10 support. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

…s-new-13-3-update # Conflicts: # src/frontend/src/content/docs/whats-new/aspire-13-3.mdx

The brief CLI enhancements bullet only mentioned aspire publish and aspire deploy, but --list-steps is also available on aspire destroy and aspire do. Expand the bullet to name all four pipeline commands and mention that the listing includes each step's dependencies and tags. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

mitchdenny · 2026-05-06T00:59:09Z

Pushed a minor commit (81b5f25) that expands the --list-steps bullet under Pipeline tooling to name all four pipeline commands (aspire publish, aspire deploy, aspire destroy, aspire do) and mention that the listing shows dependencies and tags. The flag was added on PipelineCommandBase, so it's available on every pipeline command — see microsoft/aspire#16085 and the matching reference docs in #801. Happy to revert or reword if you'd prefer a different framing — feel free to fold or drop the commit. Context: #837 (item #2).

IEvangelist · 2026-05-06T02:02:32Z


-Each `WithOrigin` call provisions its own Front Door endpoint, origin group, origin, and route, so every backend is independently routable through its own `*.azurefd.net` hostname. The integration provisions Front Door in the Standard SKU by default; use `ConfigureInfrastructure` to customize the Front Door, for example to change SKUs, attach a Web Application Firewall (WAF) policy, enable caching, and more.
+</TabItem>
+<TabItem id='typescript' label='TypeScript AppHost'>


Suggested change

<TabItem id='typescript' label='TypeScript AppHost'>

<TabItem id='typescript' label='apphost.ts'>

IEvangelist · 2026-05-06T02:02:44Z

 Aspire 13.3 adds a new hosting integration for [Azure Front Door](https://learn.microsoft.com/azure/frontdoor/), Microsoft's global edge network for fast, secure, and highly available web apps. Add a Front Door profile in front of your backends with `AddAzureFrontDoor` and attach origins with `WithOrigin`:

+<Tabs syncKey='aspire-lang'>
+<TabItem id='csharp' label='C# AppHost'>


Suggested change

<TabItem id='csharp' label='C# AppHost'>

<TabItem id='csharp' label='AppHost.cs'>

JamesNK · 2026-05-06T02:27:10Z

+  CLI](/get-started/install-cli/).
+</LearnMore>
+
+## ☁️ Azure improvements


Do we want to lead with Azure?

From a perception standpoint, I think core features to app host, CLI, dashboard would be better to start with.

JamesNK · 2026-05-06T05:32:03Z

Made lots of changes.

More hype. Notification center + screenshots. More detail around command results.

joperezr and others added 6 commits May 5, 2026 12:47

[whats-new] Expand 13.3 release notes

907a064

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

[whats-new] Add first-time install Aside, code comments, TypeScript tabs

f89b7db

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

[whats-new] Add install-from-scratch, OS-aware tunnel tabs, more TS s…

578fcf9

…amples Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

[whats-new] Refer to 'trusted development certificate' instead of ASP…

2159722

….NET Core dev cert Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

danegsta reviewed May 5, 2026

View reviewed changes

Comment thread src/frontend/src/content/docs/whats-new/aspire-13-3.mdx Outdated

danegsta reviewed May 5, 2026

View reviewed changes

Comment thread src/frontend/src/content/docs/whats-new/aspire-13-3.mdx Outdated

radical mentioned this pull request May 5, 2026

[docs] Document installing the Aspire CLI as a .NET tool #839

Closed

joperezr and others added 4 commits May 5, 2026 13:42

[whats-new] Apply review feedback for DCP certificate section

bee35d9

Apply suggestions from @danegsta clarifying that the DCP certificate behavior is Windows-specific and the default is an ephemeral cert. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

radical mentioned this pull request May 5, 2026

[docs] Document installing the Aspire CLI as a NativeAOT .NET tool #842

Open

joperezr marked this pull request as ready for review May 5, 2026 22:14

joperezr requested a review from IEvangelist as a code owner May 5, 2026 22:14

joperezr and others added 2 commits May 5, 2026 15:18

Merge remote-tracking branch 'origin/release/13.3' into joperezr/what…

76a14e1

…s-new-13-3-update # Conflicts: # src/frontend/src/content/docs/whats-new/aspire-13-3.mdx

mitchdenny mentioned this pull request May 6, 2026

[docs] Add --list-steps sample output to aspire do and pipelines pages #847

Merged

IEvangelist reviewed May 6, 2026

View reviewed changes

JamesNK reviewed May 6, 2026

View reviewed changes

JamesNK added 2 commits May 6, 2026 13:24

Make 13.3 what's-new page more engaging and restructure sections

5419a2e

Add notification center screenshots to 13.3 what's-new page

874617b

Update intro wording

d389693

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

[whats-new] Expand 13.3 release notes#838

[whats-new] Expand 13.3 release notes#838
joperezr wants to merge 16 commits intorelease/13.3from
joperezr/whats-new-13-3-update

joperezr commented May 5, 2026

Uh oh!

Uh oh!

Uh oh!

mitchdenny commented May 6, 2026

Uh oh!

IEvangelist May 6, 2026

Uh oh!

IEvangelist May 6, 2026

Uh oh!

Uh oh!

JamesNK May 6, 2026

Uh oh!

Uh oh!

JamesNK commented May 6, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

	<TabItem id='typescript' label='TypeScript AppHost'>
	<TabItem id='typescript' label='apphost.ts'>

	<TabItem id='csharp' label='C# AppHost'>
	<TabItem id='csharp' label='AppHost.cs'>

Conversation

joperezr commented May 5, 2026

Summary

Validation

Related

Uh oh!

Uh oh!

Uh oh!

mitchdenny commented May 6, 2026

Uh oh!

IEvangelist May 6, 2026

Choose a reason for hiding this comment

Uh oh!

IEvangelist May 6, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

JamesNK May 6, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

JamesNK commented May 6, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants