[PR #7658] [MERGED] feat(reports): scoped ErrorBoundaries for individual report routes #126745

Closed
opened 2026-06-14 06:08:20 -05:00 by GiteaMirror · 0 comments
Owner

📋 Pull Request Information

Original PR: https://github.com/actualbudget/actual/pull/7658
Author: @tmchow
Created: 4/29/2026
Status: Merged
Merged: 6/5/2026
Merged by: @MatissJanis

Base: masterHead: osc/7391-error-boundaries-reports


📝 Commits (5)

  • e8a27ba feat(reports): scoped ErrorBoundaries for individual report routes (#7391)
  • 04e2808 chore: rename release note to PR number
  • cdd30e7 refactor(reports): extract withReportBoundary helper to remove route boilerplate
  • 5877ddf refactor(reports): hoist withReportBoundary to ReportBoundary component
  • bae298c [AI] Merge origin/master into osc/7391-error-boundaries-reports

📊 Changes

2 files changed (+214 additions, -26 deletions)

View changed files

📝 packages/desktop-client/src/components/reports/ReportRouter.tsx (+208 -26)
upcoming-release-notes/7658.md (+6 -0)

📄 Description

Description

This PR adds scoped ErrorBoundary wrappers around each individual report route in ReportRouter.tsx (NetWorth, CashFlow, Spending, CustomReport, Calendar, Formula, Summary, Crossover, AgeOfMoney, BudgetAnalysis, Sankey).

Today, a render error inside any of those report views bubbles up to the top-level FatalError boundary in App.tsx and crashes the whole app to the fatal-error screen. Wrapping each route in a FeatureErrorFallback boundary contains the failure to that one report — the rest of the app keeps working.

This is the next slice of #7391's table; the prior PRs (#7382 dashboard widgets, #7437 rules, #7497 budget/account/transactions/schedules/sidebar) already handled their respective areas. The dashboard view uses Overview.tsx's per-widget boundaries so it's intentionally not wrapped here.

The pattern matches the one already used for /rules routes in FinancesApp.tsx:

<Route
  path="/net-worth"
  element={
    <ErrorBoundary FallbackComponent={FeatureErrorFallback} resetKeys={[location.pathname]}>
      <NetWorth />
    </ErrorBoundary>
  }
/>

The resetKeys={[location.pathname]} lets the boundary auto-reset when the user navigates to a different report.

Relates to #7391

Testing

Manual:

  • Temporarily threw inside one of the wrapped report components and confirmed only that report shows the FeatureErrorFallback; the sidebar, header, and account list keep rendering.
  • Navigated between reports with the boundary tripped and confirmed the boundary resets on pathname change.
  • Removed test errors, ran yarn oxlint --type-aware --quiet and yarn oxfmt --check against the changed file — clean.

Checklist

  • Release notes added (see link above)
  • No obvious regressions in affected areas
  • Self-review has been performed - I understand what each change in the code does and why it is needed

Bundle Stats

Bundle Files count Total bundle size % Changed
desktop-client 37 14.05 MB → 14.06 MB (+2.28 kB) +0.02%
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.06 MB (+2.28 kB) +0.02%
Changeset
File Δ Size
src/components/reports/ReportRouter.tsx 📈 +2.28 kB (+29.63%) 7.68 kB → 9.96 kB
View detailed bundle breakdown

Added
No assets were added

Removed
No assets were removed

Bigger

Asset File Size % Changed
static/js/ReportRouter.js 1.26 MB → 1.26 MB (+2.28 kB) +0.18%

Smaller
No assets were smaller

Unchanged

Asset File Size % Changed
static/js/index.js 1.56 MB 0%
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/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/7658 **Author:** [@tmchow](https://github.com/tmchow) **Created:** 4/29/2026 **Status:** ✅ Merged **Merged:** 6/5/2026 **Merged by:** [@MatissJanis](https://github.com/MatissJanis) **Base:** `master` ← **Head:** `osc/7391-error-boundaries-reports` --- ### 📝 Commits (5) - [`e8a27ba`](https://github.com/actualbudget/actual/commit/e8a27ba7f964060fc5e8112c6a0d0b879432df58) feat(reports): scoped ErrorBoundaries for individual report routes (#7391) - [`04e2808`](https://github.com/actualbudget/actual/commit/04e28082f1c023ca40603d5bc2fcc2e34480fcd4) chore: rename release note to PR number - [`cdd30e7`](https://github.com/actualbudget/actual/commit/cdd30e78cd5163b1e42c702015962ece9ee06987) refactor(reports): extract withReportBoundary helper to remove route boilerplate - [`5877ddf`](https://github.com/actualbudget/actual/commit/5877ddf16113cfc9d6d990fc7140773c728acf89) refactor(reports): hoist withReportBoundary to ReportBoundary component - [`bae298c`](https://github.com/actualbudget/actual/commit/bae298c334820f80aa8cdfc0d195083749feb963) [AI] Merge origin/master into osc/7391-error-boundaries-reports ### 📊 Changes **2 files changed** (+214 additions, -26 deletions) <details> <summary>View changed files</summary> 📝 `packages/desktop-client/src/components/reports/ReportRouter.tsx` (+208 -26) ➕ `upcoming-release-notes/7658.md` (+6 -0) </details> ### 📄 Description ## Description This PR adds scoped `ErrorBoundary` wrappers around each individual report route in `ReportRouter.tsx` (NetWorth, CashFlow, Spending, CustomReport, Calendar, Formula, Summary, Crossover, AgeOfMoney, BudgetAnalysis, Sankey). Today, a render error inside any of those report views bubbles up to the top-level `FatalError` boundary in `App.tsx` and crashes the whole app to the fatal-error screen. Wrapping each route in a `FeatureErrorFallback` boundary contains the failure to that one report — the rest of the app keeps working. This is the next slice of #7391's table; the prior PRs (#7382 dashboard widgets, #7437 rules, #7497 budget/account/transactions/schedules/sidebar) already handled their respective areas. The dashboard view uses `Overview.tsx`'s per-widget boundaries so it's intentionally not wrapped here. The pattern matches the one already used for `/rules` routes in `FinancesApp.tsx`: ```tsx <Route path="/net-worth" element={ <ErrorBoundary FallbackComponent={FeatureErrorFallback} resetKeys={[location.pathname]}> <NetWorth /> </ErrorBoundary> } /> ``` The `resetKeys={[location.pathname]}` lets the boundary auto-reset when the user navigates to a different report. ## Related issue(s) Relates to #7391 ## Testing Manual: - Temporarily threw inside one of the wrapped report components and confirmed only that report shows the `FeatureErrorFallback`; the sidebar, header, and account list keep rendering. - Navigated between reports with the boundary tripped and confirmed the boundary resets on `pathname` change. - Removed test errors, ran `yarn oxlint --type-aware --quiet` and `yarn oxfmt --check` against the changed file — clean. ## Checklist - [x] Release notes added (see link above) - [x] No obvious regressions in affected areas - [x] Self-review has been performed - I understand what each change in the code does and why it is needed <!--- 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.06 MB (+2.28 kB) | +0.02% 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.06 MB (+2.28 kB) | +0.02% <details> <summary>Changeset</summary> File | Δ | Size ---- | - | ---- `src/components/reports/ReportRouter.tsx` | 📈 +2.28 kB (+29.63%) | 7.68 kB → 9.96 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/ReportRouter.js | 1.26 MB → 1.26 MB (+2.28 kB) | +0.18% **Smaller** No assets were smaller **Unchanged** Asset | File Size | % Changed ----- | --------- | --------- static/js/index.js | 1.56 MB | 0% 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/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:08:20 -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#126745