[PR #8095] [CLOSED] [WIP] [AI] feat(titlebar): add persistent degraded environment indicator #127036

Closed
opened 2026-06-14 06:33:11 -05:00 by GiteaMirror · 0 comments
Owner

📋 Pull Request Information

Original PR: https://github.com/actualbudget/actual/pull/8095
Author: @okxint
Created: 6/5/2026
Status: Closed

Base: masterHead: feat/degraded-env-indicator


📝 Commits (3)

  • 60b6021 [AI] feat(titlebar): add persistent degraded environment indicator
  • 625fb00 [AI] fix: use Link component instead of raw anchor in DegradedEnvIndicator
  • 78af1fa [autofix.ci] apply automated fixes

📊 Changes

2 files changed (+46 additions, -0 deletions)

View changed files

📝 packages/desktop-client/src/components/Titlebar.tsx (+40 -0)
upcoming-release-notes/7747.md (+6 -0)

📄 Description

Summary

Addresses #7747.

When SharedArrayBuffer is unavailable and the user has bypassed the initial warning (SharedArrayBufferOverride in localStorage), Actual silently runs in a degraded state with no persistent indication. This makes it easy for users to forget they're in an unsupported environment — which can lead to unexpected data loss or sync failures.

This PR adds a DegradedEnvIndicator component to the Titlebar that:

  • Only renders when both conditions are met: typeof SharedArrayBuffer === 'undefined' AND SharedArrayBufferOverride is set in localStorage
  • Shows a warning icon (SvgAlertTriangle) in theme.warningText color, positioned between the privacy button and sync button
  • Displays a tooltip on hover with a plain-language explanation (no mention of SharedArrayBuffer) and a link to the troubleshooting docs

The tooltip wording follows the maintainers' guidance in the issue:

"Actual is running in a degraded state. Your server may not be using HTTPS or may be missing required security headers. Data loss or sync issues may occur."

Testing

  1. Open Actual in a browser without HTTPS (e.g. over plain HTTP without COOP/COEP headers)
  2. When shown the SharedArrayBuffer warning, click "Override" to proceed
  3. Confirm a warning triangle appears in the titlebar
  4. Hover over the icon — confirm the tooltip explains the degraded state with a link to docs
  5. On a properly configured HTTPS server (or in Electron), confirm the indicator does not appear

Bundle Stats

Bundle Files count Total bundle size % Changed
desktop-client 37 14.05 MB → 14.05 MB (+1.64 kB) +0.01%
loot-core 1 5.28 MB 0%
api 2 3.86 MB 0%
cli 1 7.97 MB 0%
crdt 1 11.12 kB 0%
View detailed bundle stats

desktop-client

Total

Files count Total bundle size % Changed
37 14.05 MB → 14.05 MB (+1.64 kB) +0.01%
Changeset
File Δ Size
src/components/Titlebar.tsx 📈 +1.64 kB (+13.77%) 11.93 kB → 13.58 kB
View detailed bundle breakdown

Added
No assets were added

Removed
No assets were removed

Bigger

Asset File Size % Changed
static/js/index.js 1.56 MB → 1.56 MB (+1.64 kB) +0.10%

Smaller
No assets were smaller

Unchanged

Asset File Size % Changed
static/js/BackgroundImage.js 121.09 kB 0%
static/js/FormulaEditor.js 962.55 kB 0%
static/js/ManageRules.js 46.6 kB 0%
static/js/PayeeRuleCountLabel.js 7.33 kB 0%
static/js/ReportRouter.js 1.26 MB 0%
static/js/ScheduleEditForm.js 146.44 kB 0%
static/js/SchedulesTable.js 202.7 kB 0%
static/js/TransactionEdit.js 90.63 kB 0%
static/js/TransactionList.js 85.81 kB 0%
static/js/Value.js 5.08 MB 0%
static/js/_baseIsEqual.js 98.38 kB 0%
static/js/ca.js 186.26 kB 0%
static/js/client.js 451.37 kB 0%
static/js/da.js 100.8 kB 0%
static/js/de.js 170.65 kB 0%
static/js/en-GB.js 9.25 kB 0%
static/js/en.js 200.02 kB 0%
static/js/es.js 178.21 kB 0%
static/js/extends.js 508.06 kB 0%
static/js/fr.js 178.06 kB 0%
static/js/indexeddb-main-thread-worker-e59fee74.js 13.46 kB 0%
static/js/it.js 164.53 kB 0%
static/js/narrow.js 364.2 kB 0%
static/js/nb-NO.js 147.72 kB 0%
static/js/nl.js 106.82 kB 0%
static/js/pt-BR.js 187.97 kB 0%
static/js/resize-observer.js 18.06 kB 0%
static/js/th.js 174.31 kB 0%
static/js/theme.js 31.88 kB 0%
static/js/toString.js 705.14 kB 0%
static/js/uk.js 208.65 kB 0%
static/js/useFormatList.js 2.52 kB 0%
static/js/useTransactionBatchActions.js 9.71 kB 0%
static/js/wide.js 298.88 kB 0%
static/js/workbox-window.prod.es5.js 7.33 kB 0%
static/js/zh-Hans.js 116.84 kB 0%

loot-core

Total

Files count Total bundle size % Changed
1 5.28 MB 0%
View detailed bundle breakdown

Added
No assets were added

Removed
No assets were removed

Bigger
No assets were bigger

Smaller
No assets were smaller

Unchanged

Asset File Size % Changed
kcab.worker.BkkH_8jr.js 5.28 MB 0%

api

Total

Files count Total bundle size % Changed
2 3.86 MB 0%
View detailed bundle breakdown

Added
No assets were added

Removed
No assets were removed

Bigger
No assets were bigger

Smaller
No assets were smaller

Unchanged

Asset File Size % Changed
index.js 3.86 MB 0%
models.js 0 B 0%

cli

Total

Files count Total bundle size % Changed
1 7.97 MB 0%
View detailed bundle breakdown

Added
No assets were added

Removed
No assets were removed

Bigger
No assets were bigger

Smaller
No assets were smaller

Unchanged

Asset File Size % Changed
cli.js 7.97 MB 0%

crdt

Total

Files count Total bundle size % Changed
1 11.12 kB 0%
View detailed bundle breakdown

Added
No assets were added

Removed
No assets were removed

Bigger
No assets were bigger

Smaller
No assets were smaller

Unchanged

Asset File Size % Changed
index.js 11.12 kB 0%

🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.

## 📋 Pull Request Information **Original PR:** https://github.com/actualbudget/actual/pull/8095 **Author:** [@okxint](https://github.com/okxint) **Created:** 6/5/2026 **Status:** ❌ Closed **Base:** `master` ← **Head:** `feat/degraded-env-indicator` --- ### 📝 Commits (3) - [`60b6021`](https://github.com/actualbudget/actual/commit/60b6021cb0b9cd390100156b849d751fe0aa56cb) [AI] feat(titlebar): add persistent degraded environment indicator - [`625fb00`](https://github.com/actualbudget/actual/commit/625fb00f53fa38bce5fafa545c4ef38cfc27e514) [AI] fix: use Link component instead of raw anchor in DegradedEnvIndicator - [`78af1fa`](https://github.com/actualbudget/actual/commit/78af1fa685476efcaff73320d33348e5b040d820) [autofix.ci] apply automated fixes ### 📊 Changes **2 files changed** (+46 additions, -0 deletions) <details> <summary>View changed files</summary> 📝 `packages/desktop-client/src/components/Titlebar.tsx` (+40 -0) ➕ `upcoming-release-notes/7747.md` (+6 -0) </details> ### 📄 Description ## Summary Addresses #7747. When `SharedArrayBuffer` is unavailable **and** the user has bypassed the initial warning (`SharedArrayBufferOverride` in localStorage), Actual silently runs in a degraded state with no persistent indication. This makes it easy for users to forget they're in an unsupported environment — which can lead to unexpected data loss or sync failures. This PR adds a `DegradedEnvIndicator` component to the Titlebar that: - **Only renders** when both conditions are met: `typeof SharedArrayBuffer === 'undefined'` AND `SharedArrayBufferOverride` is set in localStorage - Shows a **warning icon** (`SvgAlertTriangle`) in `theme.warningText` color, positioned between the privacy button and sync button - Displays a **tooltip on hover** with a plain-language explanation (no mention of `SharedArrayBuffer`) and a link to the troubleshooting docs The tooltip wording follows the maintainers' guidance in the issue: > *"Actual is running in a degraded state. Your server may not be using HTTPS or may be missing required security headers. Data loss or sync issues may occur."* ## Testing 1. Open Actual in a browser without HTTPS (e.g. over plain HTTP without COOP/COEP headers) 2. When shown the SharedArrayBuffer warning, click "Override" to proceed 3. Confirm a warning triangle appears in the titlebar 4. Hover over the icon — confirm the tooltip explains the degraded state with a link to docs 5. On a properly configured HTTPS server (or in Electron), confirm the indicator does **not** appear <!--- actual-bot-sections ---> <hr /> <!--- bundlestats-action-comment key:combined start ---> ### Bundle Stats Bundle | Files count | Total bundle size | % Changed ------ | ----------- | ----------------- | --------- desktop-client | 37 | 14.05 MB → 14.05 MB (+1.64 kB) | +0.01% loot-core | 1 | 5.28 MB | 0% api | 2 | 3.86 MB | 0% cli | 1 | 7.97 MB | 0% crdt | 1 | 11.12 kB | 0% <details> <summary>View detailed bundle stats</summary> #### desktop-client **Total** Files count | Total bundle size | % Changed ----------- | ----------------- | --------- 37 | 14.05 MB → 14.05 MB (+1.64 kB) | +0.01% <details> <summary>Changeset</summary> File | Δ | Size ---- | - | ---- `src/components/Titlebar.tsx` | 📈 +1.64 kB (+13.77%) | 11.93 kB → 13.58 kB </details> <details> <summary>View detailed bundle breakdown</summary> <div> **Added** No assets were added **Removed** No assets were removed **Bigger** Asset | File Size | % Changed ----- | --------- | --------- static/js/index.js | 1.56 MB → 1.56 MB (+1.64 kB) | +0.10% **Smaller** No assets were smaller **Unchanged** Asset | File Size | % Changed ----- | --------- | --------- static/js/BackgroundImage.js | 121.09 kB | 0% static/js/FormulaEditor.js | 962.55 kB | 0% static/js/ManageRules.js | 46.6 kB | 0% static/js/PayeeRuleCountLabel.js | 7.33 kB | 0% static/js/ReportRouter.js | 1.26 MB | 0% static/js/ScheduleEditForm.js | 146.44 kB | 0% static/js/SchedulesTable.js | 202.7 kB | 0% static/js/TransactionEdit.js | 90.63 kB | 0% static/js/TransactionList.js | 85.81 kB | 0% static/js/Value.js | 5.08 MB | 0% static/js/_baseIsEqual.js | 98.38 kB | 0% static/js/ca.js | 186.26 kB | 0% static/js/client.js | 451.37 kB | 0% static/js/da.js | 100.8 kB | 0% static/js/de.js | 170.65 kB | 0% static/js/en-GB.js | 9.25 kB | 0% static/js/en.js | 200.02 kB | 0% static/js/es.js | 178.21 kB | 0% static/js/extends.js | 508.06 kB | 0% static/js/fr.js | 178.06 kB | 0% static/js/indexeddb-main-thread-worker-e59fee74.js | 13.46 kB | 0% static/js/it.js | 164.53 kB | 0% static/js/narrow.js | 364.2 kB | 0% static/js/nb-NO.js | 147.72 kB | 0% static/js/nl.js | 106.82 kB | 0% static/js/pt-BR.js | 187.97 kB | 0% static/js/resize-observer.js | 18.06 kB | 0% static/js/th.js | 174.31 kB | 0% static/js/theme.js | 31.88 kB | 0% static/js/toString.js | 705.14 kB | 0% static/js/uk.js | 208.65 kB | 0% static/js/useFormatList.js | 2.52 kB | 0% static/js/useTransactionBatchActions.js | 9.71 kB | 0% static/js/wide.js | 298.88 kB | 0% static/js/workbox-window.prod.es5.js | 7.33 kB | 0% static/js/zh-Hans.js | 116.84 kB | 0% </div> </details> --- #### loot-core **Total** Files count | Total bundle size | % Changed ----------- | ----------------- | --------- 1 | 5.28 MB | 0% <details> <summary>View detailed bundle breakdown</summary> <div> **Added** No assets were added **Removed** No assets were removed **Bigger** No assets were bigger **Smaller** No assets were smaller **Unchanged** Asset | File Size | % Changed ----- | --------- | --------- kcab.worker.BkkH_8jr.js | 5.28 MB | 0% </div> </details> --- #### api **Total** Files count | Total bundle size | % Changed ----------- | ----------------- | --------- 2 | 3.86 MB | 0% <details> <summary>View detailed bundle breakdown</summary> <div> **Added** No assets were added **Removed** No assets were removed **Bigger** No assets were bigger **Smaller** No assets were smaller **Unchanged** Asset | File Size | % Changed ----- | --------- | --------- index.js | 3.86 MB | 0% models.js | 0 B | 0% </div> </details> --- #### cli **Total** Files count | Total bundle size | % Changed ----------- | ----------------- | --------- 1 | 7.97 MB | 0% <details> <summary>View detailed bundle breakdown</summary> <div> **Added** No assets were added **Removed** No assets were removed **Bigger** No assets were bigger **Smaller** No assets were smaller **Unchanged** Asset | File Size | % Changed ----- | --------- | --------- cli.js | 7.97 MB | 0% </div> </details> --- #### crdt **Total** Files count | Total bundle size | % Changed ----------- | ----------------- | --------- 1 | 11.12 kB | 0% <details> <summary>View detailed bundle breakdown</summary> <div> **Added** No assets were added **Removed** No assets were removed **Bigger** No assets were bigger **Smaller** No assets were smaller **Unchanged** Asset | File Size | % Changed ----- | --------- | --------- index.js | 11.12 kB | 0% </div> </details> </details> <!--- bundlestats-action-comment key:combined end ---> --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>
GiteaMirror added the pull-request label 2026-06-14 06:33:11 -05:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: github-starred/actual#127036