Replace polyglot AppHost with TypeScript AppHost, fork getting started paths#556
Merged
IEvangelist merged 8 commits intorelease/13.2from Mar 19, 2026
Merged
Replace polyglot AppHost with TypeScript AppHost, fork getting started paths#556IEvangelist merged 8 commits intorelease/13.2from
IEvangelist merged 8 commits intorelease/13.2from
Conversation
…d paths - Rename polyglot-apphost/migration/troubleshooting docs to typescript-apphost-* - Add redirects from old polyglot URLs to new typescript-apphost URLs - Fork prerequisites page with C# AppHost / TypeScript AppHost pivot - TypeScript path: Node.js + Docker + VS Code (no .NET required) - C# path: .NET SDK + Docker + VS Code/VS/Rider - Add TypeScript AppHost code example to 'What is Aspire' page - Add TypeScript AppHost structure tab to AppHost explainer page - Add TypeScript variant to SimpleAppHostCode component - Remove .NET SDK requirement from CLI install page - Replace 'polyglot' with 'multi-language' across all docs - Remove polyglotSupportEnabled from config examples (on by default) - Update sidebar: Polyglot -> TypeScript AppHost - Update all cross-references and link text site-wide - Add (Preview) to TypeScript AppHost page titles Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
- Remove stale config flags from settings table and JSON example: dotnetSdkInstallationEnabled, minimumSdkCheckEnabled, orphanDetectionWithTimestampEnabled, packageSearchDiskCachingEnabled, runningInstanceDetectionEnabled, stagingChannelEnabled, polyglotSupportEnabled - Fix aspire run --debug (doesn't exist) to aspire run --log-level Debug Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
The VS Code C# extension was showing for both C# and TypeScript paths on the prerequisites page. Now only shown for C#. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Change 'type-safe C#' to 'type-safe code' since the section now shows both C# and TypeScript AppHost examples. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
davidfowl
requested review from
IEvangelist,
aaronpowell,
eerhardt,
maddymontaquila and
mitchdenny
as code owners
Add a language switcher to the interactive AppHost code builder on the landing page. TypeScript variants use Express for the API service (addNodeApp) while C# uses AddProject, matching each ecosystem's natural patterns. All 31 toggle combinations work in both languages. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
IEvangelist
reviewed
Mar 19, 2026
Member
IEvangelist
left a comment
IEvangelist
left a comment
There was a problem hiding this comment.
LGTM, just a few nits/questions.
…word - Remove .aspire/settings.json from TypeScript AppHost file tree (only aspire.config.json is needed) - Add polyglot back as an SEO keyword alongside multi-language to preserve search ranking Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
davidfowl
commented
Mar 19, 2026
Contributor
Author
davidfowl
left a comment
davidfowl
left a comment
There was a problem hiding this comment.
Addressed both review comments in c365999:
SEO keywords: Good call — added polyglot back as an SEO keyword alongside multi-language so we don't lose search ranking. Both terms are now in the keywords meta tag.
TS AppHost file tree: Fixed — removed .aspire/settings.json from the file tree. Now only shows aspire.config.json as the root config file.
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
2 participants
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.
Summary
Fork the getting started funnel into C# and TypeScript AppHost paths. A TypeScript developer can now go from zero to running an Aspire app without ever encountering .NET SDK as a prerequisite.
Changes
Path forking (the big narrative shift)
PivotSelectorwith C#/TypeScript options. TypeScript path requires only Node.js + Docker + VS Code with Aspire extension (no .NET SDK, no C# extension)typescriptvariant with three-tier architecture exampleRenames and redirects
polyglot-apphost.mdx→typescript-apphost.mdx(+ migration + troubleshooting)/app-host/polyglot-*URLs to new/app-host/typescript-apphost-*URLs(Preview)to TypeScript AppHost page titlesTerminology
polyglotSupportEnabledfrom config examples (feature is on by default)CLI accuracy fixes
aspire run --debug→aspire run --log-level Debug(the--debugflag doesn't exist)dotnetSdkInstallationEnabled,minimumSdkCheckEnabled,orphanDetectionWithTimestampEnabled,packageSearchDiskCachingEnabled,runningInstanceDetectionEnabled,stagingChannelEnabledFiles changed (34 files)
polyglot-*→typescript-apphost-*)redirects.mjs,sidebar/docs.topics.ts,astro.config.mjs,head.attrs.tsSimpleAppHostCode.astroprerequisites.mdx,install-cli.mdx,what-is-aspire.mdx,app-host.mdx,first-app.mdx,add-aspire-existing-app.mdxcli/configuration.mdx,config-settings-table.md,cli/overview.mdxaspire-13.mdx,aspire-13-1.mdx,aspire-13-2.mdxindex.mdx,resource-model.mdx,aspireats001.mdx,integrations/index.mdx,videos.mdx,thanks.mdx, localized index pages (fr/de/da/ja)Testing
aspireCLI 13.2.0 flags/app-host/polyglot-apphost/→/app-host/typescript-apphost/works