Add JavaScript hosting integration documentation

[Copilot]

• Create a new JavaScript hosting integration documentation file at /src/frontend/src/content/docs/integrations/frameworks/javascript.mdx
• Update integration-docs.json to map Aspire.Hosting.JavaScript to the new JavaScript documentation page
• Add JavaScript integration to sidebar configuration to fix build error
• Verify the documentation follows the proper structure and format
• Address code review feedback
• Run security checks
• Validate build succeeds

Summary

Successfully created comprehensive documentation for the Aspire.Hosting.JavaScript package and resolved the build error.

Changes Made

1. Created /src/frontend/src/content/docs/integrations/frameworks/javascript.mdx

   • Comprehensive documentation for the Aspire.Hosting.JavaScript package
   • Covers AddJavaScriptApp method for orchestrating JavaScript applications
   • Documents package manager support (npm, yarn, pnpm) with intelligent defaults
   • Explains script customization and endpoint configuration
   • Includes AddNodeApp documentation for direct Node.js application execution
   • Provides production build workflow information

2. Updated /src/frontend/src/data/integration-docs.json

   • Changed mapping for Aspire.Hosting.JavaScript from /integrations/frameworks/nodejs-extensions/ to /integrations/frameworks/javascript/
   • Maintains existing mapping for CommunityToolkit.Aspire.Hosting.JavaScript.Extensions to /integrations/frameworks/nodejs-extensions/

3. Fixed Build Error

   • Added JavaScript entry to /src/frontend/config/sidebar/sidebar.topics.ts in the "Frameworks & runtimes" section
   • Placed alphabetically between "Java" and ".NET MAUI"
   • This resolves the AstroUserError: Failed to find the topic error

Resolution

The build now completes successfully. The JavaScript integration page is properly integrated into the site navigation and documentation structure.

Original prompt

Please update the integrations-docs.json and follow https://github.com/microsoft/aspire.dev/blob/main/.github/prompts/update-integrations.promt.md, be sure that the Aspire.Hosting.JavaScript package maps to a new framework doc you'll create for the JavaScript hosting intergation

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

[IEvangelist]

Hey @copilot, this is a bit busted, also what happened to screenshots?

05:20:39 ├─ /integrations/frameworks/java/index.html (+30ms)
[AstroUserError] Failed to find the topic for the integrations/frameworks/javascript page.
Hint:
Either include this page in the sidebar configuration of the desired topic using the items property, associate an unlisted page with a topic using the topic frontmatter property or the topics option, or exclude this page from any topic using the exclude option.

Learn more in the following guides:

- Unlisted pages https://starlight-sidebar-topics.netlify.app/docs/guides/unlisted-pages/
- Excluded pages https://starlight-sidebar-topics.netlify.app/docs/guides/excluded-pages/

Stack trace:
at throwPluginError (file:///home/runner/work/aspire.dev/aspire.dev/src/frontend/dist/chunks/common_Ctr6sbVV.mjs:1565:9)
at MiddlewareRunnerStep.run (file:///home/runner/work/aspire.dev/aspire.dev/src/frontend/dist/chunks/common_Ctr6sbVV.mjs:1756:27)
at MiddlewareRunner.run (file:///home/runner/work/aspire.dev/aspire.dev/src/frontend/dist/chunks/common_Ctr6sbVV.mjs:1776:28)
at file:///home/runner/work/aspire.dev/aspire.dev/src/frontend/dist/chunks/common_Ctr6sbVV.mjs:1786:9
05:20:39 ├─ /integrations/frameworks/javascript/index.html

[Copilot]

Hey @copilot, this is a bit busted, also what happened to screenshots?

05:20:39 ├─ /integrations/frameworks/java/index.html (+30ms)
...

Fixed in commit 0fe6f41. The JavaScript integration page was missing from the sidebar configuration (sidebar.topics.ts). Added it to the "Frameworks & runtimes" section between Java and .NET MAUI.

The build error is now resolved - the page successfully generates without the Failed to find the topic error.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• https://api.github.com/repos/CommunityToolkit/Aspire
  • Triggering command: /usr/local/bin/node node ./scripts/update-github-stats.js (http block)
  • Triggering command: /usr/local/bin/node node ./scripts/update-github-stats.js rgo/bin/git git log �� %aE ���� --follow it dx (http block)
  • Triggering command: /usr/local/bin/node node ./scripts/update-github-stats.js ndor/bin/git git log �� %aE ���� --follow p/bin/git /content/docs/innode git /home/node_modulrun git log �� %aE ���� --follow (http block)
• https://api.github.com/repos/dotnet/aspire
  • Triggering command: /usr/local/bin/node node ./scripts/update-github-stats.js (http block)
  • Triggering command: /usr/local/bin/node node ./scripts/update-github-stats.js rgo/bin/git git log �� %aE ���� --follow it dx (http block)
  • Triggering command: /usr/local/bin/node node ./scripts/update-github-stats.js ndor/bin/git git log �� %aE ���� --follow p/bin/git /content/docs/innode git /home/node_modulrun git log �� %aE ���� --follow (http block)
• https://api.github.com/repos/dotnet/aspire-samples
  • Triggering command: /usr/local/bin/node node ./scripts/update-github-stats.js (http block)
  • Triggering command: /usr/local/bin/node node ./scripts/update-github-stats.js rgo/bin/git git log �� %aE ���� --follow it dx (http block)
  • Triggering command: /usr/local/bin/node node ./scripts/update-github-stats.js ndor/bin/git git log �� %aE ���� --follow p/bin/git /content/docs/innode git /home/node_modulrun git log �� %aE ���� --follow (http block)
• https://api.github.com/repos/microsoft/aspire.dev
  • Triggering command: /usr/local/bin/node node ./scripts/update-github-stats.js (http block)
  • Triggering command: /usr/local/bin/node node ./scripts/update-github-stats.js rgo/bin/git git log �� %aE ���� --follow it dx (http block)
  • Triggering command: /usr/local/bin/node node ./scripts/update-github-stats.js ndor/bin/git git log �� %aE ���� --follow p/bin/git /content/docs/innode git /home/node_modulrun git log �� %aE ���� --follow (http block)
• telemetry.astro.build
  • Triggering command: /usr/local/bin/node node /home/REDACTED/work/aspire.dev/aspire.dev/src/frontend/node_modules/.bin/astro build (dns block)
  • Triggering command: /usr/local/bin/node node /home/REDACTED/work/aspire.dev/aspire.dev/src/frontend/node_modules/.bin/astro build git log �� %aE ���� --follow ules/.bin/git tegrations/databsh (dns block)
  • Triggering command: /usr/local/bin/node node /home/REDACTED/work/aspire.dev/aspire.dev/src/frontend/node_modules/.bin/astro build git log �� %aE ���� --follow e_modules/.bin/git mdx git-env lib/node-gyp-binnpm run git-env && npm run update:all && astro build git log �� %aE ���� --follow mcli/run-script/lib/node-gyp-bin/git x git e_modules/.bin/grun git (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)