Skip to content

Update TypeScript AppHost GA docs#1057

Open
sebastienros wants to merge 3 commits into
release/13.4from
sebastienros/sebros-typescript-ga-docs
Open

Update TypeScript AppHost GA docs#1057
sebastienros wants to merge 3 commits into
release/13.4from
sebastienros/sebros-typescript-ga-docs

Conversation

@sebastienros
Copy link
Copy Markdown
Contributor

@sebastienros sebastienros commented May 23, 2026

TypeScript AppHosts are GA in the current docs, so the public guidance needs to describe the supported setup path and generated SDK location consistently.

Summary

  • Expands aspire add and aspire restore CLI docs to explain how TypeScript AppHosts update aspire.config.json and regenerate the SDK.
  • Keeps the current docs aligned with the updated apphost.mts and ./.aspire/modules/aspire.mjs generated SDK path from release/13.4.
  • Clarifies brownfield TypeScript AppHost setup with supported AppHost-root package managers while preserving the existing Node.js 22.x/24.x LTS prerequisite wording.
  • Updates FAQ links away from old TypeScript preview release-note anchors and keeps old release notes unchanged.
  • Updates Twoslash virtual module wiring so current docs and historical snippets both compile.

Related to microsoft/aspire#17043.

Validation

  • pnpm --dir ./src/frontend run test:unit:docs
  • pnpm --dir ./src/frontend run test:unit:twoslash-blocks
  • NODE_OPTIONS=--max-old-space-size=8192 pnpm --dir ./src/frontend run build:skip-search

Copilot AI review requested due to automatic review settings May 23, 2026 18:49
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the documentation site’s TypeScript AppHost guidance to reflect the GA-recommended SDK location and to clarify how CLI commands (aspire add, aspire restore) affect TypeScript AppHosts, while keeping historical release-note snippets compiling via updated twoslash virtual file wiring.

Changes:

  • Switched current TypeScript AppHost examples/docs from ./.modules/aspire.js to ./.aspire/.modules/aspire.js across English + Japanese content.
  • Expanded CLI reference docs to describe TypeScript AppHost behavior for aspire add and aspire restore, and broadened --apphost option wording to include file-based AppHosts.
  • Updated twoslash configuration to mount the SDK types under both .aspire/.modules/aspire.ts (current docs) and .modules/aspire.ts (historical release notes).

Reviewed changes

Copilot reviewed 142 out of 143 changed files in this pull request and generated no comments.

Show a summary per file
File Description
src/frontend/src/data/twoslash/aspire.d.ts Updates twoslash type bundle comment to match the new import path used by docs.
src/frontend/src/content/docs/reference/cli/includes/option-project.md Clarifies --apphost accepts file-based AppHosts (TS/C#) and C# project-based AppHosts.
src/frontend/src/content/docs/reference/cli/commands/aspire-restore.mdx Adds TypeScript AppHost-specific restore behavior and an example using apphost.ts.
src/frontend/src/content/docs/reference/cli/commands/aspire-init.mdx Updates TypeScript AppHost scaffolded SDK folder path to .aspire/.modules/.
src/frontend/src/content/docs/reference/cli/commands/aspire-add.mdx Documents how aspire add persists changes for project/file-based C# and TypeScript AppHosts + TS example.
src/frontend/src/content/docs/ja/get-started/what-is-aspire.mdx Updates TypeScript import to ./.aspire/.modules/aspire.js.
src/frontend/src/content/docs/ja/get-started/troubleshooting.mdx Updates troubleshooting guidance to reference .aspire/.modules/.
src/frontend/src/content/docs/ja/get-started/resource-mcp-servers.mdx Updates TypeScript imports to the new .aspire/.modules path.
src/frontend/src/content/docs/ja/get-started/faq.mdx Updates links to the GA TypeScript AppHost page and removes reliance on preview release-notes anchors.
src/frontend/src/content/docs/ja/get-started/deploy-first-app.mdx Updates TypeScript imports to the new .aspire/.modules path.
src/frontend/src/content/docs/ja/get-started/aspire-mcp-server.mdx Updates TypeScript imports to the new .aspire/.modules path.
src/frontend/src/content/docs/ja/get-started/app-host.mdx Updates FileTree to show .aspire/.modules/ layout.
src/frontend/src/content/docs/ja/get-started/add-aspire-existing-app.mdx Updates TypeScript imports and FileTree to .aspire/.modules/ and related prose.
src/frontend/src/content/docs/ja/fundamentals/http-commands.mdx Updates TypeScript imports to the new .aspire/.modules path.
src/frontend/src/content/docs/ja/fundamentals/custom-resource-commands.mdx Updates TypeScript imports to the new .aspire/.modules path.
src/frontend/src/content/docs/ja/extensibility/multi-language-integration-authoring.mdx Updates TypeScript imports (including custom module imports) to .aspire/.modules.
src/frontend/src/content/docs/ja/app-host/withdockerfile.mdx Updates TypeScript imports (and type imports) to .aspire/.modules.
src/frontend/src/content/docs/ja/app-host/typescript-apphost.mdx Updates FileTree + sections to .aspire/.modules and aligns examples to new import path.
src/frontend/src/content/docs/ja/app-host/persistent-containers.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/ja/app-host/migrate-from-docker-compose.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/ja/app-host/executable-resources.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/ja/app-host/eventing.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/ja/app-host/container-registry.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/ja/app-host/container-files.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/ja/app-host/certificate-configuration.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/security/keycloak.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/reverse-proxies/yarp.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/overview.mdx Updates TypeScript import to .aspire/.modules.
src/frontend/src/content/docs/integrations/observability/seq/seq-host.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/messaging/rabbitmq/rabbitmq-host.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/messaging/nats/nats-host.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/messaging/apache-kafka/apache-kafka-host.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/frameworks/python.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/frameworks/orleans.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/frameworks/nodejs-extensions.mdx Updates note to point at .aspire/.modules/aspire.ts for missing TS bindings.
src/frontend/src/content/docs/integrations/frameworks/javascript.mdx Updates TypeScript imports across examples to .aspire/.modules.
src/frontend/src/content/docs/integrations/frameworks/go/go-host.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/dotnet/project-resources.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/dotnet/dotnet-tool-resources.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/dotnet/csharp-file-based-apps.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/devtools/dev-tunnels.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/devtools/browser-logs.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/databases/surrealdb/surrealdb-host.mdx Updates note to reference .aspire/.modules/aspire.ts for missing TS support.
src/frontend/src/content/docs/integrations/databases/sql-server/sql-server-host.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/databases/qdrant/qdrant-host.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/databases/postgres/postgres-host.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/databases/mysql/mysql-host.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/databases/mongodb/mongodb-host.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/databases/milvus/milvus-host.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/databases/kurrentdb/kurrentdb-host.mdx Updates note to reference .aspire/.modules/aspire.ts for missing TS support.
src/frontend/src/content/docs/integrations/databases/efcore/azure-sql/azure-sql-host.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/databases/efcore/azure-cosmos-db/azure-cosmos-db-host.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/compute/kubernetes.mdx Updates TypeScript import to .aspire/.modules.
src/frontend/src/content/docs/integrations/compute/docker.mdx Updates TypeScript imports (and type imports) to .aspire/.modules.
src/frontend/src/content/docs/integrations/cloud/azure/user-assigned-identity.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/cloud/azure/role-assignments.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/cloud/azure/overview.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/cloud/azure/local-provisioning.mdx Updates TypeScript import to .aspire/.modules.
src/frontend/src/content/docs/integrations/cloud/azure/customize-resources.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/cloud/azure/configure-container-apps.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/cloud/azure/azure-web-pubsub/azure-web-pubsub-host.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/cloud/azure/azure-virtual-network.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/cloud/azure/azure-storage-tables/azure-storage-tables-host.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/cloud/azure/azure-storage-queues/azure-storage-queues-host.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/cloud/azure/azure-storage-datalake.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/cloud/azure/azure-storage-blobs/azure-storage-blobs-host.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/cloud/azure/azure-sql-database/azure-sql-database-host.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/cloud/azure/azure-signalr/azure-signalr-host.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/cloud/azure/azure-service-bus/azure-service-bus-host.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/cloud/azure/azure-postgresql/azure-postgresql-host.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/cloud/azure/azure-openai/azure-openai-host.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/cloud/azure/azure-log-analytics.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/cloud/azure/azure-key-vault/azure-key-vault-host.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/cloud/azure/azure-functions/azure-functions-host.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/cloud/azure/azure-front-door.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/cloud/azure/azure-event-hubs/azure-event-hubs-host.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/cloud/azure/azure-data-explorer.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/cloud/azure/azure-cosmos-db/azure-cosmos-db-host.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/cloud/azure/azure-container-registry/azure-container-registry-host.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/cloud/azure/azure-container-registry/azure-container-registry-get-started.mdx Updates TypeScript import to .aspire/.modules.
src/frontend/src/content/docs/integrations/cloud/azure/azure-cache-redis/azure-cache-redis-host.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/cloud/azure/azure-application-insights.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/cloud/azure/azure-app-service/azure-app-service-host.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/cloud/azure/azure-app-configuration/azure-app-configuration-host.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/cloud/azure/azure-ai-search/azure-ai-search-host.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/cloud/azure/azure-ai-inference/azure-ai-inference-host.mdx Updates TypeScript import to .aspire/.modules.
src/frontend/src/content/docs/integrations/cloud/azure/azure-ai-foundry/azure-ai-foundry-host.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/cloud/azure/aks/index.mdx Updates TypeScript import to .aspire/.modules.
src/frontend/src/content/docs/integrations/cloud/azure/ai-compatibility-matrix.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/caching/valkey/valkey-host.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/caching/redis/redis-host.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/caching/redis-output/redis-output-host.mdx Updates TypeScript import to .aspire/.modules.
src/frontend/src/content/docs/integrations/caching/redis-distributed/redis-distributed-host.mdx Updates TypeScript import to .aspire/.modules.
src/frontend/src/content/docs/integrations/caching/garnet/garnet-host.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/ai/openai/openai-host.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/integrations/ai/ollama/ollama-host.mdx Updates TypeScript imports and notes to .aspire/.modules.
src/frontend/src/content/docs/integrations/ai/github-models/github-models-host.mdx Updates TypeScript imports and note reference to .aspire/.modules.
src/frontend/src/content/docs/get-started/what-is-aspire.mdx Updates TypeScript import to .aspire/.modules.
src/frontend/src/content/docs/get-started/troubleshooting.mdx Updates troubleshooting guidance to reference .aspire/.modules.
src/frontend/src/content/docs/get-started/resource-mcp-servers.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/get-started/first-app.mdx Updates TypeScript import to .aspire/.modules.
src/frontend/src/content/docs/get-started/faq.mdx Updates TypeScript AppHost links to the GA project structure page.
src/frontend/src/content/docs/get-started/deploy-first-app.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/get-started/aspire-mcp-server.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/get-started/app-host.mdx Updates FileTree to show .aspire/.modules/ layout.
src/frontend/src/content/docs/get-started/add-aspire-existing-app.mdx Updates prerequisites, prose, FileTree, and TypeScript imports for .aspire/.modules + package-manager guidance.
src/frontend/src/content/docs/fundamentals/service-discovery.mdx Updates TypeScript import to .aspire/.modules.
src/frontend/src/content/docs/fundamentals/persist-data-volumes.mdx Updates TypeScript import to .aspire/.modules.
src/frontend/src/content/docs/fundamentals/networking-overview.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/fundamentals/http-commands.mdx Updates TypeScript import to .aspire/.modules.
src/frontend/src/content/docs/fundamentals/health-checks.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/fundamentals/external-parameters.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/fundamentals/custom-resource-commands.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/fundamentals/container-networking.mdx Updates TypeScript import to .aspire/.modules.
src/frontend/src/content/docs/extensibility/multi-language-integration-authoring.mdx Updates TypeScript imports (including custom module import) to .aspire/.modules.
src/frontend/src/content/docs/diagnostics/aspiredockerfilebuilder001.mdx Updates TypeScript imports (and type imports) to .aspire/.modules.
src/frontend/src/content/docs/deployment/kubernetes/kubernetes.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/deployment/kubernetes/aks.mdx Updates TypeScript import to .aspire/.modules.
src/frontend/src/content/docs/deployment/kubernetes.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/deployment/javascript-apps.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/deployment/environments.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/deployment/docker-compose.mdx Updates TypeScript imports (and type imports) to .aspire/.modules.
src/frontend/src/content/docs/deployment/deploy-with-aspire.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/deployment/azure/container-apps.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/deployment/azure/azure-security-best-practices.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/deployment/azure/azure-developer-cli.mdx Updates TypeScript import to .aspire/.modules.
src/frontend/src/content/docs/deployment/azure/app-service.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/deployment/app-lifecycle.mdx Updates TypeScript import to .aspire/.modules.
src/frontend/src/content/docs/community/contributor-guide.mdx Updates TypeScript import to .aspire/.modules.
src/frontend/src/content/docs/architecture/resource-hierarchies.mdx Updates TypeScript import to .aspire/.modules.
src/frontend/src/content/docs/architecture/multi-language-architecture.mdx Updates architecture diagram + narrative to .aspire/.modules.
src/frontend/src/content/docs/app-host/withdockerfile.mdx Updates TypeScript imports (and type imports) to .aspire/.modules.
src/frontend/src/content/docs/app-host/typescript-apphost.mdx Updates TypeScript AppHost structure, adds “add/restore” guidance + unsupported scenarios, and aligns imports to .aspire/.modules.
src/frontend/src/content/docs/app-host/persistent-containers.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/app-host/migrate-from-docker-compose.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/app-host/executable-resources.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/app-host/eventing.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/app-host/container-registry.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/app-host/container-files.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/content/docs/app-host/certificate-configuration.mdx Updates TypeScript imports to .aspire/.modules.
src/frontend/src/components/SimpleAppHostCode.shared.ts Updates shared TypeScript snippets to import from .aspire/.modules.
src/frontend/scripts/generate-twoslash-types.ts Keeps generated twoslash header comment aligned with the new import path.
src/frontend/config/twoslash.config.mjs Updates twoslash VFS mappings to support both new (.aspire/.modules) and historical (.modules) import paths.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Document TypeScript AppHost GA support boundaries, CLI restore/add behavior, and the generated .aspire/.modules SDK path across current docs.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@sebastienros sebastienros force-pushed the sebastienros/sebros-typescript-ga-docs branch from 5f8996d to e837288 Compare May 23, 2026 19:00
@sebastienros sebastienros marked this pull request as draft May 23, 2026 20:00
sebastienros and others added 2 commits May 23, 2026 14:35
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@sebastienros sebastienros marked this pull request as ready for review May 23, 2026 21:42
**`--apphost <apphost>`**

The path to the Aspire AppHost project file.
The path to the Aspire AppHost file or project file, such as `apphost.ts`, `apphost.cs`, or an AppHost `.csproj`.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Minor: the example lists apphost.ts, but everywhere else in this PR (and the TypeScript AppHost docs) the canonical filename is apphost.mts. Suggest aligning to apphost.mts so users don't get a different extension here than aspire init actually produces.

Suggested change
The path to the Aspire AppHost file or project file, such as `apphost.ts`, `apphost.cs`, or an AppHost `.csproj`.
The path to the Aspire AppHost file or project file, such as `apphost.mts`, `apphost.cs`, or an AppHost `.csproj`.

**いいえ。** .NET は Aspire で特に強力な体験を提供しますが、アプリ モデルは 1 つのフレームワークやランタイムに限定されません。Aspire は複数スタックにまたがるサービス調整を目的に設計されており、TypeScript の AppHost によって既存の JavaScript / TypeScript アプリにも自然に適合します。

詳しくはこちら: [TypeScript AppHost サポート](/ja/whats-new/aspire-13-2/#-typescript-apphost-のサポート-プレビュー)
詳しくはこちら: [TypeScript AppHost サポート](/ja/app-host/typescript-apphost/)
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The link target was updated from the 13.2 preview "what's new" anchor to the GA project-structure page, but the visible label still says "TypeScript AppHost サポート" (Support). The English FAQ was updated to "TypeScript AppHost project structure" — consider updating the Japanese label to match, e.g. [TypeScript AppHost プロジェクト構成](/ja/app-host/typescript-apphost/). Same on line 72.

? {
'.aspire/modules/aspire.mts': source,
// Keep historical snippets compiling if they import the old generated path.
'.modules/aspire.ts': source,
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The comment frames this alias as backward-compat for "historical snippets," but the only place in the repo that still imports from ./.modules/aspire.js is src/frontend/src/components/AppHostBuilder.astro — the live interactive AppHost builder, with ~30 snippet variants. Everywhere else (this PR's typescript-apphost.mdx, add-aspire-existing-app.mdx, SimpleAppHostCode.shared.ts, data/twoslash/aspire.d.ts, the doc-writer skill) uses the GA path ./.aspire/modules/aspire.mjs.

Net effect: users who copy a snippet out of the interactive builder get an import path that doesn't match what aspire init actually generates, so the file won't resolve in their project.

Recommendation: migrate AppHostBuilder.astro to emit ./.aspire/modules/aspire.mjs across all snippet variants and drop this alias. If that's out of scope for this PR, please reword the comment to make the temporary nature explicit, e.g. // Temporary: AppHostBuilder.astro still imports from the pre-GA path; remove this alias once it's migrated to .aspire/modules/aspire.mjs.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants