Skip to content

[docs] Add Blazor hosting integration docs and Dockerfile factory API#1061

Draft
aspire-repo-bot[bot] wants to merge 1 commit into
release/13.4from
docs/blazor-dockerfile-factory-ats-v2-aece375a55135607
Draft

[docs] Add Blazor hosting integration docs and Dockerfile factory API#1061
aspire-repo-bot[bot] wants to merge 1 commit into
release/13.4from
docs/blazor-dockerfile-factory-ats-v2-aece375a55135607

Conversation

@aspire-repo-bot
Copy link
Copy Markdown
Contributor

Summary

This draft PR documents the new polyglot (TypeScript, Go, Java, Python) AppHost APIs introduced in microsoft/aspire#17420:

  1. New page: integrations/dotnet/blazor-hosting — Documents the Blazor WebAssembly hosting integration for .NET Aspire, covering AddBlazorWasmProject, AddBlazorGateway, and WithBlazorClientApp APIs with C# and TypeScript examples.

  2. Updated page: app-host/withdockerfile — Adds a new "Generate a Dockerfile with a factory function" section documenting AddDockerfileFactory and WithDockerfileFactory APIs with C# and TypeScript examples.

  3. Sidebar update: Adds a "Blazor hosting" entry to the .NET integrations section of the sidebar.

Source PR

This is a documentation draft for microsoft/aspire#17420 ("Expose Blazor gateway and Dockerfile factory APIs to ATS").

The source PR exposes the following APIs to polyglot (TypeScript/Go/Java/Python) AppHosts for the first time:

  • AddBlazorWasmProject / AddBlazorGateway / WithBlazorClientApp — Blazor WebAssembly hosting integration
  • AddDockerfileFactory / WithDockerfileFactory — Dockerfile generation via factory function

These were previously only available to C# AppHosts.

Triggered signals

  • pr_body_has_cli_flag_mention: The PR body mentions flags like tsc --noEmit in build validation steps. This is a false positive — the actual user-facing change is the new polyglot API surface documented here.

Target branch

Targeting release/13.4 (resolved from milestone "13.4" on the source PR, exact match on aspire.dev).

cc @mitchdenny

Generated by PR Documentation Check for issue #17420 · ● 101.9M ·

Document the newly polyglot-exported APIs from microsoft/aspire#17420:

- Add Blazor hosting integration page (integrations/dotnet/blazor-hosting.mdx)
  covering AddBlazorGateway, WithBlazorClientApp, and AddBlazorWasmProject
  with C# and TypeScript code examples
- Update app-host/withdockerfile.mdx to add a 'Generate a Dockerfile with a
  factory function' section covering AddDockerfileFactory / WithDockerfileFactory
  with C# and TypeScript examples
- Add Blazor hosting entry to the integrations sidebar

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 25, 2026
@aspire-repo-bot aspire-repo-bot Bot requested a review from mitchdenny May 25, 2026 02:57
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.

0 participants