[PR #6620] Add Notes to Monthly Budget Cell #6632

Open
opened 2026-02-28 21:30:54 -06:00 by GiteaMirror · 0 comments
Owner

Original Pull Request: https://github.com/actualbudget/actual/pull/6620

State: open
Merged: No


Add Notes to Monthly Budget Cell

Overview

I'd like to be able to add notes to individual monthly budget cells.
It would help remember why a given budget was allocated on a given month.
At the moment I'm working around it by adding entries with dates in the category note.

This pull request introduces the ability for users to add, view, and manage notes directly on individual budget cells within the envelope budgeting interface of Actual Budget. The goal is to enhance contextual annotation for monthly budgeting categories.

image image image

Key Changes

  • UI Enhancement:

    • Integrated a NotesButton component into each category/month cell in the budget grid, providing a clear entry point for accessing and editing cell-specific notes.
    • Applied visual adjustments to maintain alignment, spacing, and consistency with the existing budget table UI.
    • Also added support for the mobile version, reusing the UI pattern used for the category notes
  • Component Updates:

    • EnvelopeBudgetComponents.tsx, TrackingBudgetComponents.tsx added support for notes in non-editing states of budget category rows.
      • Modified flexbox styles and borders in relevant containers to accommodate the note icon without disrupting layout.
      • Updated popover and menu logic to relax restrictions and ensure notes can be independently accessed beside other cell actions.
    • mobile/budget/BudgetCell.tsx, EnvelopeBudgetMenuModal.tsx, TrackingBudgetMenuModal.tsx
      • Added mobile support
  • Supporting Infrastructure:

    • Extended type definitions and bindings as needed to propagate note state and actions through the relevant React components.

QA & Testing

  • Tested on both light and dark themes
  • Tested in mobile and desktop mode
  • Interacted with various category/month combinations, ensuring stable behavior in both editing and non-editing states
  • Verified keyboard navigation and accessibility
  • No breaking changes to API or data structures

Bundle Stats

Bundle Files count Total bundle size % Changed
desktop-client 27 14.85 MB → 14.86 MB (+7.64 kB) +0.05%
loot-core 1 5.82 MB 0%
api 1 4.43 MB 0%
View detailed bundle stats

desktop-client

Total

Files count Total bundle size % Changed
27 14.85 MB → 14.86 MB (+7.64 kB) +0.05%
Changeset
File Δ Size
src/components/modals/TrackingBudgetMenuModal.tsx 📈 +2.91 kB (+81.01%) 3.59 kB → 6.5 kB
src/components/modals/EnvelopeBudgetMenuModal.tsx 📈 +2.91 kB (+80.96%) 3.59 kB → 6.5 kB
src/components/mobile/budget/BudgetCell.tsx 📈 +768 B (+14.42%) 5.2 kB → 5.95 kB
src/components/budget/tracking/TrackingBudgetComponents.tsx 📈 +576 B (+2.88%) 19.53 kB → 20.1 kB
src/components/budget/envelope/EnvelopeBudgetComponents.tsx 📈 +528 B (+1.71%) 30.15 kB → 30.66 kB
View detailed bundle breakdown

Added
No assets were added

Removed
No assets were removed

Bigger

Asset File Size % Changed
static/js/index.js 9.54 MB → 9.54 MB (+6.89 kB) +0.07%
static/js/narrow.js 637.68 kB → 638.43 kB (+768 B) +0.12%

Smaller
No assets were smaller

Unchanged

Asset File Size % Changed
static/js/indexeddb-main-thread-worker-e59fee74.js 12.94 kB 0%
static/js/workbox-window.prod.es5.js 5.64 kB 0%
static/js/ca.js 188.15 kB 0%
static/js/da.js 106.35 kB 0%
static/js/de.js 180.07 kB 0%
static/js/en-GB.js 7.18 kB 0%
static/js/en.js 170.37 kB 0%
static/js/es.js 174.55 kB 0%
static/js/fr.js 179.6 kB 0%
static/js/it.js 171.16 kB 0%
static/js/nb-NO.js 156.96 kB 0%
static/js/nl.js 106.37 kB 0%
static/js/pl.js 88.37 kB 0%
static/js/pt-BR.js 154.22 kB 0%
static/js/th.js 181.87 kB 0%
static/js/uk.js 214.74 kB 0%
static/js/resize-observer.js 18.37 kB 0%
static/js/BackgroundImage.js 120.54 kB 0%
static/js/ReportRouter.js 1.16 MB 0%
static/js/TransactionList.js 106.22 kB 0%
static/js/wide.js 164.15 kB 0%
static/js/AppliedFilters.js 9.71 kB 0%
static/js/usePayeeRuleCounts.js 10.04 kB 0%
static/js/useTransactionBatchActions.js 13.23 kB 0%
static/js/FormulaEditor.js 1.04 MB 0%

loot-core

Total

Files count Total bundle size % Changed
1 5.82 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.BwrdDDMW.js 5.82 MB 0%

api

Total

Files count Total bundle size % Changed
1 4.43 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
bundle.api.js 4.43 MB 0%
**Original Pull Request:** https://github.com/actualbudget/actual/pull/6620 **State:** open **Merged:** No --- # Add Notes to Monthly Budget Cell ## Overview I'd like to be able to add notes to individual monthly budget cells. It would help remember why a given budget was allocated on a given month. At the moment I'm working around it by adding entries with dates in the category note. This pull request introduces the ability for users to add, view, and manage notes directly on individual budget cells within the envelope budgeting interface of Actual Budget. The goal is to enhance contextual annotation for monthly budgeting categories. <img width="1192" height="262" alt="image" src="https://github.com/user-attachments/assets/32507734-5ab2-486b-a3d9-c8474438e5c1" /> <img width="482" height="323" alt="image" src="https://github.com/user-attachments/assets/65576cfa-7740-4ae5-a89a-2947e5eb9972" /> <img height="300" alt="image" src="https://github.com/user-attachments/assets/e33691b9-ba59-4e2b-bd90-0e923bf4ab40" /> ## Key Changes - __UI Enhancement:__ - Integrated a `NotesButton` component into each category/month cell in the budget grid, providing a clear entry point for accessing and editing cell-specific notes. - Applied visual adjustments to maintain alignment, spacing, and consistency with the existing budget table UI. - Also added support for the mobile version, reusing the UI pattern used for the category notes - __Component Updates:__ - `EnvelopeBudgetComponents.tsx`, `TrackingBudgetComponents.tsx` added support for notes in non-editing states of budget category rows. - Modified flexbox styles and borders in relevant containers to accommodate the note icon without disrupting layout. - Updated popover and menu logic to relax restrictions and ensure notes can be independently accessed beside other cell actions. - `mobile/budget/BudgetCell.tsx`, `EnvelopeBudgetMenuModal.tsx`, `TrackingBudgetMenuModal.tsx` - Added mobile support - __Supporting Infrastructure:__ - Extended type definitions and bindings as needed to propagate note state and actions through the relevant React components. ## QA & Testing - Tested on both light and dark themes - Tested in mobile and desktop mode - Interacted with various category/month combinations, ensuring stable behavior in both editing and non-editing states - Verified keyboard navigation and accessibility - No breaking changes to API or data structures <!--- actual-bot-sections ---> <hr /> <!--- bundlestats-action-comment key:combined start ---> ### Bundle Stats Bundle | Files count | Total bundle size | % Changed ------ | ----------- | ----------------- | --------- desktop-client | 27 | 14.85 MB → 14.86 MB (+7.64 kB) | +0.05% loot-core | 1 | 5.82 MB | 0% api | 1 | 4.43 MB | 0% <details> <summary>View detailed bundle stats</summary> #### desktop-client **Total** Files count | Total bundle size | % Changed ----------- | ----------------- | --------- 27 | 14.85 MB → 14.86 MB (+7.64 kB) | +0.05% <details> <summary>Changeset</summary> File | Δ | Size ---- | - | ---- `src/components/modals/TrackingBudgetMenuModal.tsx` | 📈 +2.91 kB (+81.01%) | 3.59 kB → 6.5 kB `src/components/modals/EnvelopeBudgetMenuModal.tsx` | 📈 +2.91 kB (+80.96%) | 3.59 kB → 6.5 kB `src/components/mobile/budget/BudgetCell.tsx` | 📈 +768 B (+14.42%) | 5.2 kB → 5.95 kB `src/components/budget/tracking/TrackingBudgetComponents.tsx` | 📈 +576 B (+2.88%) | 19.53 kB → 20.1 kB `src/components/budget/envelope/EnvelopeBudgetComponents.tsx` | 📈 +528 B (+1.71%) | 30.15 kB → 30.66 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 | 9.54 MB → 9.54 MB (+6.89 kB) | +0.07% static/js/narrow.js | 637.68 kB → 638.43 kB (+768 B) | +0.12% **Smaller** No assets were smaller **Unchanged** Asset | File Size | % Changed ----- | --------- | --------- static/js/indexeddb-main-thread-worker-e59fee74.js | 12.94 kB | 0% static/js/workbox-window.prod.es5.js | 5.64 kB | 0% static/js/ca.js | 188.15 kB | 0% static/js/da.js | 106.35 kB | 0% static/js/de.js | 180.07 kB | 0% static/js/en-GB.js | 7.18 kB | 0% static/js/en.js | 170.37 kB | 0% static/js/es.js | 174.55 kB | 0% static/js/fr.js | 179.6 kB | 0% static/js/it.js | 171.16 kB | 0% static/js/nb-NO.js | 156.96 kB | 0% static/js/nl.js | 106.37 kB | 0% static/js/pl.js | 88.37 kB | 0% static/js/pt-BR.js | 154.22 kB | 0% static/js/th.js | 181.87 kB | 0% static/js/uk.js | 214.74 kB | 0% static/js/resize-observer.js | 18.37 kB | 0% static/js/BackgroundImage.js | 120.54 kB | 0% static/js/ReportRouter.js | 1.16 MB | 0% static/js/TransactionList.js | 106.22 kB | 0% static/js/wide.js | 164.15 kB | 0% static/js/AppliedFilters.js | 9.71 kB | 0% static/js/usePayeeRuleCounts.js | 10.04 kB | 0% static/js/useTransactionBatchActions.js | 13.23 kB | 0% static/js/FormulaEditor.js | 1.04 MB | 0% </div> </details> --- #### loot-core **Total** Files count | Total bundle size | % Changed ----------- | ----------------- | --------- 1 | 5.82 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.BwrdDDMW.js | 5.82 MB | 0% </div> </details> --- #### api **Total** Files count | Total bundle size | % Changed ----------- | ----------------- | --------- 1 | 4.43 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 ----- | --------- | --------- bundle.api.js | 4.43 MB | 0% </div> </details> </details> <!--- bundlestats-action-comment key:combined end --->
GiteaMirror added the pull-request label 2026-02-28 21:30:54 -06:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: github-starred/actual#6632