Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Appearance settings

Document Aspire 13.3 WithEnvironment unification and compatibility shim mappings#1162

Draft
Copilot wants to merge 2 commits into
mainmicrosoft/aspire.dev:mainfrom
copilot/document-13-3-withenvironment-api-unificationmicrosoft/aspire.dev:copilot/document-13-3-withenvironment-api-unificationCopy head branch name to clipboard
Draft

Document Aspire 13.3 WithEnvironment unification and compatibility shim mappings#1162
Copilot wants to merge 2 commits into
mainmicrosoft/aspire.dev:mainfrom
copilot/document-13-3-withenvironment-api-unificationmicrosoft/aspire.dev:copilot/document-13-3-withenvironment-api-unificationCopy head branch name to clipboard

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Jun 2, 2026

Aspire 13.3 unified previously divergent polyglot withEnvironment APIs into a single withEnvironment(name, value) shape while retaining compatibility shims for older call sites. This PR updates AppHost docs and 13.3 release notes to reflect the unified signature, shim mappings, and migration direction.

  • AppHost docs: unified API + migration guidance

    • Updated app-host/executable-resources.mdx with a dedicated Aspire 13.3 section covering:
      • unified withEnvironment(name, value) usage
      • supported value kinds
      • compatibility shim mappings
      • incremental migration guidance for existing code
  • 13.3 changelog: explicit unification entry + before/after

    • Expanded whats-new/aspire-13-3.mdx with:
      • a top-level App model/AppHost note for WithEnvironment unification and shims
      • a concrete before/after comparison
      • explicit shim-to-unified mapping
// Before (older helpers)
await api.withEnvironmentEndpoint('SERVICE_URL', cache.primaryEndpoint);
await api.withEnvironmentParameter('API_KEY', apiKeyParam);
await api.withEnvironmentConnectionString('DB', database);

// After (unified API)
await api.withEnvironment('SERVICE_URL', cache.primaryEndpoint);
await api.withEnvironment('API_KEY', apiKeyParam);
await api.withEnvironment('DB', database);

Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com>
Copilot AI changed the title [WIP] Document 13.3 WithEnvironment API unification and compatibility shims Document Aspire 13.3 WithEnvironment unification and compatibility shim mappings Jun 2, 2026
Copilot AI requested a review from IEvangelist June 2, 2026 02:58
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.

Document 13.3 WithEnvironment API unification and compatibility shims

2 participants

Morty Proxy This is a proxified and sanitized view of the page, visit original site.