Skip to content

[docs] Document Dashboard:Frontend:DisableWebSocketCompression setting - #1820

Open
aspire-repo-bot[bot] wants to merge 1 commit into
release/17.0from
docs/pr-20633-37097299881-1-f9ff7e5835649b70
Open

aspire-repo-bot[bot] wants to merge 1 commit into
release/17.0from
docs/pr-20633-37097299881-1-f9ff7e5835649b70

Conversation

@aspire-repo-bot

Copy link
Copy Markdown
Contributor

Documents changes from microsoft/aspire#20633

@JamesNK

Target branch: Targeting release/17.0 based on the source PR milestone 17.0 (exact match on microsoft/aspire.dev).

Why this PR is needed

PR microsoft/aspire#20633 adds a new Dashboard configuration option, Dashboard:Frontend:DisableWebSocketCompression, that lets users disable Blazor WebSocket compression (useful behind reverse proxies like IIS ARR that don't support compressed WebSocket messages). The PR body includes a "User-facing usage" section showing both the environment-variable form (DASHBOARD__FRONTEND__DISABLEWEBSOCKETCOMPRESSION=true) and JSON configuration form, which triggered the pr_body_has_user_facing_section and pr_body_has_cli_flag_mention signals. This is a new, previously-undocumented Dashboard configuration key, so the public docs needed an update.

What changed

Added a row to the Frontend options table in src/frontend/src/content/docs/dashboard/configuration.mdx, matching the style of neighboring rows (PublicUrl, MaxConsoleLogCount):

Dashboard:Frontend:DisableWebSocketCompression
Default: false | Disables compression for the Blazor WebSocket connection. Set to true when a reverse proxy, such as IIS Application Request Routing (ARR), doesn't support compressed WebSocket messages. Disabling compression increases WebSocket bandwidth usage.

The identifier and default value were copied verbatim from the source diff (src/Aspire.Dashboard/Configuration/DashboardOptions.cs and src/Shared/DashboardConfigNames.cs).

Files modified

  • src/frontend/src/content/docs/dashboard/configuration.mdx (updated existing page — added one table row)

No new pages were created; this was a targeted update to the existing Dashboard configuration reference page.

Generated by PR Documentation Check for #20633 · copilot · auto · 42.9 AIC · ⌖ 11.8 AIC · ⊞ 20.3K · ◷

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 Oct 3, 2026
@aspire-repo-bot

Copy link
Copy Markdown
Contributor Author

Frontend HTML artifact ready

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

VS Code: Open PR #1820 artifacts

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

@JamesNK
James Newton-King (JamesNK) marked this pull request as ready for review October 3, 2026 05:24
Copilot AI balanced review requested due to automatic review settings October 3, 2026 05:24

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.

Copilot review overview

🔵 Needs a closer look

Source claims were verified, but rendered-page browser validation could not be completed.

Review effort: Balanced
Findings: None

What changed in this PR

Documents the new Dashboard WebSocket compression setting. Its name, default, behavior, and proxy guidance match microsoft/aspire main.

Changes:

  • Adds the setting to the frontend configuration table.
  • Notes proxy compatibility and bandwidth implications.
  • Browser validation was unavailable because playwright-cli was not installed.
File Description
src/​frontend/​src/​content/​docs/​dashboard/​configuration.mdx Documents DisableWebSocketCompression.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

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