Skip to content

[docs] Document Python starter template migration to TypeScript AppHost (aspire-py-starter)#823

Merged
IEvangelist merged 2 commits intorelease/13.3from
docs/py-starter-typescript-apphost-13574-3872f6efd4e38d95
May 5, 2026
Merged

[docs] Document Python starter template migration to TypeScript AppHost (aspire-py-starter)#823
IEvangelist merged 2 commits intorelease/13.3from
docs/py-starter-typescript-apphost-13574-3872f6efd4e38d95

Conversation

@aspire-repo-bot
Copy link
Copy Markdown
Contributor

Documents changes from microsoft/aspire#15574

PR author: @davidfowl
Targeting: release/13.3 (based on the source PR milestone 13.3).

Why this PR is needed

PR microsoft/aspire#15574 is a breaking change (labeled as such) that migrates the aspire-py-starter template from the dotnet new template system (C# AppHost) to the Aspire CLI template system (TypeScript AppHost). Users who previously ran dotnet new aspire-py-starter now need to use aspire new aspire-py-starter. The existing documentation described the old C# AppHost structure, and there was no documentation of the new --use-redis-cache option.

What was changed

Files modified

  • src/frontend/src/content/docs/whats-new/aspire-13-3.mdx — Added a new "🐍 Python starter template migrated to TypeScript AppHost" section explaining the breaking change, the new --use-redis-cache option, and the migration guidance.

  • src/frontend/src/content/docs/get-started/aspire-sdk-templates.mdx — Updated the "Aspire Starter App with FastAPI and React" description to reflect that it now uses a TypeScript AppHost, lists the actual template files (apphost.ts, app/, frontend/) rather than the old C# project names, mentions --use-redis-cache, and notes the .NET SDK is no longer required.

  • src/frontend/src/content/docs/reference/cli/commands/aspire-new.mdx — Updated the aspire-py-starter entry in the commands table to note it uses a TypeScript AppHost, and added a new "aspire-py-starter options" subsection documenting --use-redis-cache.

All three pages were updated (none newly created).

Note: The draft PR was opened against release/13.3 because that branch exists on microsoft/aspire.dev and matches the source PR milestone.

Generated by PR Documentation Check · ● 1.2M ·

The aspire-py-starter template was migrated from dotnet new (C# AppHost)
to the Aspire CLI template system (TypeScript AppHost) in aspire#15574.

- Add 13.3 what's-new entry for the Python starter template change
- Update aspire-sdk-templates.mdx to reflect TypeScript AppHost and new
  --use-redis-cache option
- Update aspire-new.mdx commands table and add py-starter-specific options

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@aspire-repo-bot aspire-repo-bot Bot added the docs-from-code Copilot initiated issue from dotnet/aspire repo label May 5, 2026
@IEvangelist IEvangelist marked this pull request as ready for review May 5, 2026 14:09
@IEvangelist IEvangelist requested a review from davidfowl May 5, 2026 14:09
Comment thread src/frontend/src/content/docs/reference/cli/commands/aspire-new.mdx Outdated
…w.mdx

Co-authored-by: David Fowler <davidfowl@gmail.com>
@IEvangelist IEvangelist merged commit 2272a57 into release/13.3 May 5, 2026
1 check passed
@IEvangelist IEvangelist deleted the docs/py-starter-typescript-apphost-13574-3872f6efd4e38d95 branch May 5, 2026 16:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs-from-code Copilot initiated issue from dotnet/aspire repo

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants