Skip to content

[docs] Update Bun integration docs for first-party Aspire.Hosting.JavaScript support#1354

Merged
IEvangelist merged 3 commits into
release/13.5from
docs/aspire-17700-bun-appsurfacearea-df32202527c98dd9
Jul 13, 2026
Merged

[docs] Update Bun integration docs for first-party Aspire.Hosting.JavaScript support#1354
IEvangelist merged 3 commits into
release/13.5from
docs/aspire-17700-bun-appsurfacearea-df32202527c98dd9

Conversation

@IEvangelist

Copy link
Copy Markdown
Member

Supersedes #1153.

This replacement targets
elease/13.5 because the original
elease/13.4 base branch no longer exists on microsoft/aspire.dev.

Documents changes from microsoft/aspire#17700 (@aspire-repo-bot[bot])

Targeting release/13.4 based on the source PR milestone 13.4.x.

Why this PR is needed

Aspire 13.4 promotes Bun hosting to a first-party integration (BunAppResource) in the Aspire.Hosting.JavaScript package. The existing integrations/frameworks/bun-apps.mdx page still referenced the deprecated CommunityToolkit.Aspire.Hosting.Bun package. The integrations/frameworks/javascript.mdx resource-type list was also missing BunAppResource.

What changed

  • bun-apps.mdx: Removed the Community Toolkit badge and Community Toolkit package reference. Updated the install command to Aspire.Hosting.JavaScript. Added an Aside note directing readers who are on Aspire < 13.4 to the Community Toolkit and those on 13.4+ to the official package. Added TypeScript AppHost (addBunApp) examples alongside the existing C# examples. Updated "See also" links to point to Aspire.Hosting.JavaScript NuGet and the JavaScript hosting reference page.
  • javascript.mdx: Added BunAppResource (added with AddBunApp / addBunApp) to the integration's resource-type list, with a cross-link to the Bun integration page.

Files modified

  • src/frontend/src/content/docs/integrations/frameworks/bun-apps.mdx — updated
  • src/frontend/src/content/docs/integrations/frameworks/javascript.mdx — updated

Generated by PR Documentation Check for issue #17700 · ● 24.1M ·

Copilot AI review requested due to automatic review settings July 12, 2026 05:58
@IEvangelist IEvangelist added the docs-from-code Copilot initiated issue from dotnet/aspire repo label Jul 12, 2026
@IEvangelist
IEvangelist requested a review from davidfowl July 12, 2026 05:59

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

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 Aspire documentation for Bun hosting to reflect its move from the Community Toolkit package to the first-party Aspire.Hosting.JavaScript integration, and ensures the JavaScript hosting reference lists the Bun resource type.

Changes:

  • Updates the Bun integration page to reference Aspire.Hosting.JavaScript, adds an Aspire 13.4+ note, and includes TypeScript AppHost (addBunApp) examples alongside C#.
  • Updates the JavaScript hosting reference to include BunAppResource (AddBunApp / addBunApp) with a cross-link to the Bun page.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

File Description
src/frontend/src/content/docs/integrations/frameworks/bun-apps.mdx Switches Bun docs to first-party Aspire.Hosting.JavaScript, adds note about deprecation of Community Toolkit package, and adds TypeScript AppHost examples.
src/frontend/src/content/docs/integrations/frameworks/javascript.mdx Adds BunAppResource to the JavaScript hosting integration resource-type list and links to the Bun integration page.

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

Comment thread src/frontend/src/content/docs/integrations/frameworks/bun-apps.mdx Outdated
@aspire-repo-bot

Copy link
Copy Markdown
Contributor

Frontend HTML artifact ready

The latest frontend build uploaded the frontend-dist artifact for PR #1354. Use the VS Code button below to open this PR with GitHub Artifacts Explorer and browse the built HTML locally.

VS Code: Open PR #1354 artifacts

This comment updates automatically when a new frontend build artifact is uploaded.

@IEvangelist

Copy link
Copy Markdown
Member Author

⚠️ CI Failure: Forbidden word detected — "app host"

The Check forbidden words CI check is failing because the PR contains the phrase "app host" (with a space), which is not allowed:

Forbidden phrase (/\bapp host\b/): Use "AppHost" instead of "app host".

This failure is due to content introduced by this PR. Please update all occurrences of "app host" to "AppHost" in the changed files.

cc @davidfowl

@IEvangelist

Copy link
Copy Markdown
Member Author

CI has been retriggered multiple times and is still failing on the current PR head. This looks likely to be caused by changes in this PR rather than transient infra flakiness.

@IEvangelist

Copy link
Copy Markdown
Member Author

CI Failure: Forbidden Word

The Forbidden Words check is failing due to a linting rule violation in \src/frontend/src/content/docs/integrations/frameworks/bun-apps.mdx\ (line 35):

\Add a Bun application to your app host using the \AddBunApp\ / \�ddBunApp\ extension method:\

The phrase *\�pp host* (lowercase, two words) is forbidden — it must be written as *\AppHost* (PascalCase).

Please update line 35 to use \AppHost\ instead of \�pp host\ to fix this CI failure.

@IEvangelist

Copy link
Copy Markdown
Member Author

CI has already been retriggered multiple times (latest attempt: 4) and is still failing on Check forbidden words. This appears to be caused by the current PR changes rather than a transient runner issue, so this PR likely needs an update before another rerun.

@IEvangelist
IEvangelist requested a review from joperezr July 12, 2026 12:01
@IEvangelist

Copy link
Copy Markdown
Member Author

CI has been retriggered several times and is still failing due to changes in this PR. This likely needs PR-content fixes before CI will pass consistently.

@IEvangelist

Copy link
Copy Markdown
Member Author

[docs-from-code-ci-note]
CI has been re-run multiple times and is still failing. This appears likely related to the current PR changes; we should fix the failing checks in this PR.

@IEvangelist

Copy link
Copy Markdown
Member Author

[docs-from-code-retry-note] CI has been retriggered multiple times and is still failing for this PR revision. This likely indicates a PR-content issue rather than a transient runner failure, so the PR changes should be adjusted to resolve the failing checks.

@IEvangelist

Copy link
Copy Markdown
Member Author

[docs-from-code automation] repeated CI reruns
We retriggered failed checks multiple times (latest attempt: 13). The failures still appear tied to this PR's current changes, so this PR likely needs code/docs fixes before CI can pass consistently.

@IEvangelist

Copy link
Copy Markdown
Member Author

[docs-from-code-automation] repeated CI failure note posted

CI has been retriggered multiple times for this PR and the failures continue on the same changeset. This likely needs a PR-side fix rather than another rerun.

@IEvangelist

Copy link
Copy Markdown
Member Author

We've retriggered CI multiple times (latest run attempt: 17), and it's still failing in Forbidden Words (Check forbidden words). The repeated failure is in the forbidden-words content check, which is typically caused by wording in this PR.

Could someone update this PR to address the failing check directly?

@IEvangelist

Copy link
Copy Markdown
Member Author

CI has been retriggered multiple times and appears to be failing due to changes in this PR. Please review the failing jobs and address the PR changes causing the failures.

@IEvangelist

Copy link
Copy Markdown
Member Author

CI has been retriggered multiple times and is still failing on this PR. This likely requires changes in the PR content rather than another rerun.

@IEvangelist

Copy link
Copy Markdown
Member Author

We've retriggered CI multiple times on this PR, and failures have persisted. This appears to be caused by the current PR changes rather than a transient CI issue, so this PR likely needs an update to resolve the failing checks.

Comment thread src/frontend/src/content/docs/integrations/frameworks/bun-apps.mdx Outdated
@IEvangelist
IEvangelist enabled auto-merge (squash) July 13, 2026 12:45
@IEvangelist
IEvangelist merged commit 06b2cad into release/13.5 Jul 13, 2026
10 checks passed
@IEvangelist
IEvangelist deleted the docs/aspire-17700-bun-appsurfacearea-df32202527c98dd9 branch July 13, 2026 13: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.

2 participants