Repository navigation
Conversation
Budget, Savings buckets, Debt tracker, Investing ideas and Forecast rebuilt to match the Clarity mockups. Every number is computed from State; none come from the mockups. - Budget: month switcher with "Data through", per-category alerts, KPIs, table with inline amount edit and a drawer for name/categories/delete, 6-month budget-vs-actual bars. "Use starter budget" now builds budgets from your spending and only adds categories no budget covers. - Buckets: inline New bucket form with a monthly preview, KPIs, savings pace (same number as Transfers), cards with icon/color, months left and monthly need; edit drawer with icon and color choices and linked transactions. - Debt: KPIs, debts table, debts can take balance and limit from a credit card in the CSVs (debt.account), payoff plan with an extra-payment slider and avalanche / snowball / minimums-only cards, summary, balance bars, payoff order, first 6 months. New payoffPlan() rolls freed minimums forward; simulatePayoff() kept unchanged. - Investments: My mix (stacked bar, split, link to Forecast), 9 funds with My % inputs, 6 stocks to read about, "not financial advice" note. - Forecast: real tabs; Savings with APY and tax and saved scenarios (old scenarios still list); Investments with presets and today's dollars. Monthly rate is (1 + yearly)^(1/12) - 1 (was yearly / 12). - New stored data: State.debtPlan (localStorage, IndexedDB, state file, export/import; Clear debts resets it; Start over erases it). Bucket icon/hue, debt account and the new scenario shape live in their records. Data & Reset gains Forecast scenarios and Investment mix rows. - Shell hides the date-range label on Plan screens. AI summary reports a linked debt's card balance; unchanged otherwise (diffed on the samples). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_013Z8iBXzUjiQbYziDZ8CZft
This was referenced Nov 2, 2026
v1.16.2: Fix Rebuild from your folder clearing everything when the folder has no CSV it can read
#25
Open
Open
gitluis
pushed a commit
that referenced
this pull request
Nov 2, 2026
…ty redesign (#16-#21) Brings the Clarity redesign (#16 -> #17 -> #19 -> #20 -> #21, v1.12.0 to v1.16.0) into #10 so the Settings -> Database tab can be rebuilt on it. Conflicts in CHANGELOG.md, CLAUDE.md, README.md, index.html and js/views-settings.js were resolved by taking the redesign's version of each file. #10's changes to them (the 1.11.0 entry and version strings, the Database tab in SETTINGS_TABS, the unregistered-tab guard, README tips, CLAUDE.md notes) are rebuilt on the new design in the next commit. js/views-db.js merged cleanly: the redesign's file plus #10's db-tools view and DB Inspector re-read fix. Both are restyled next. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_013Z8iBXzUjiQbYziDZ8CZft
Open
33 tasks
Carries master's v1.10.3-v1.10.5 up the stack: declined answers (#14), literal single "~" (#15) and the Import Logs race fix (#18). One conflict: CLAUDE.md's "Last updated" line. Kept this branch's 1.15.0 line and added the v1.10.3-v1.10.5 history. Versions stay 1.15.0; the CHANGELOG merged cleanly. renderImportLog() keeps #18's guards. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_013Z8iBXzUjiQbYziDZ8CZft
This was referenced Nov 2, 2026
Open
Open
This was referenced Nov 2, 2026
…-plan Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_013Z8iBUZo6LRYpLthSp2PRi # Conflicts: # CLAUDE.md # index.html
Owner
Author
|
Dark theme taken out of the stack (Luis, 2026-11-04). #17 is light only for now: no ◐ toggle, no Light / Dark / Match system setting, no dark tokens. It comes back later in its own PR. #17's change was merged forward into this branch (no force push).
🤖 Generated with Claude Code https://claude.ai/code/session_013Z8iBUZo6LRYpLthSp2PRi Generated by Claude Code |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Part 3 of the Clarity redesign: the five screens under Plan (Budget, Buckets, Debt, Investments, Forecast) now match their mockups. Every number comes from your transactions and plans; none are copied from the mockups. Version v1.15.0.
What changed
Shared
.page-actionsrow (note + buttons) under the shell's title. Titles: Budget, Savings buckets, Debt tracker, Investing ideas, Forecast.showView(),PLAN_VIEWS). None of them use the range, and Budget has its own month.role="img"and anaria-label. Meters haverole="progressbar"andaria-valuenow.alert(); Delete needs a second click instead ofconfirm().index.html, and one new token,--teal-text(light and dark). No hex literals.Budget
Savings buckets
Debt tracker
manualBalances[id+'_limit'], shared with the Overview and Settings). The row says "Credit card · from your CSV". With no debts, the screen offers one-click "Add " buttons.Investing ideas
State.investAllocas it was. A stock % saved before still counts in the mix.Forecast
role="tablist",role="tab"witharia-selected, arole="tabpanel", and arrow keys move between them.prompt()for a name. Scenarios are now named "Scenario N".New stored data
State.debtPlan{ strategy, extra }(new top-level key)core.jslsGet('debtPlan')app_state(DB.loadAll()map,_migrateSynclist),finlens-state.json(saveStateToFile()list), JSON export/importPLAN_ALSO), Start overicon(key) andhueState.bucketsaccountState.debts{ name, kind:'savings', inputs }State.scenariosinvestAllocwas only cleared by Start over before.Formulas and assumptions (each one is also stated on screen or in a footnote)
budgetSpent()). This is the same rule as before.bucketPlan()). For example, Nov → Jun is 7 months.savingsPace()). This is the same formula as Transfers → "Saved to savings".payoffPlan()): each month:simulatePayoff()is kept unchanged but no longer used.growthByYear()):Other code changes
aggregation.js:budgetSpent,starterBudgetList,bucketPlan,savingsPace,debtLinked/debtIsCard/debtBalance/debtLimit,payoffPlan,monthlyRateFromYearly,growthByYear.ui.js: new drawer forms and plan helpers.deleteBudget,deleteBucketanddeleteDebtno longer callconfirm().SUGGESTED_BUDGETSlost its hex colors.debtBalance(d). For a debt linked to a card that's the card's current balance; for other debts it's unchanged (diffed, see below). The AI Eval sandbox already includes every keydebtBalance()reads, and has no debts.clarity-finances.Not verified
finlens-state.jsonwriting and reading was tested with a stubbed handle in headless Chromium, not in Edge or Chrome with a real folder.--teal-textwas worked out by hand (about 5.0:1 or better on every light surface), not measured with a tool. Text on the pressed plan card and preset (on--accent-soft) wasn't measured either.Automated checks: earlier run, not re-run · commit not recorded
Moved unchanged from this PR's "Test results" comment on 2026-11-04; not re-run, so not in the new table format. Originally a description section titled "How it was tested".
The Playwright harness serves the pinned CDN files from npm. marked and DOMPurify load with their SRI hashes as written in
index.html, so the files match. Inter comes from @fontsource. All runs usedNODE_PATH=$(npm root -g) node <script> /home/claude/finlens out-plan.test-clarity.js(shell)test-finances.js(#19 screens)test-plan.js(new)boot.js(every view, light + dark)race.jsrenderImportLog→views-data.js:215(the Import Logs race fixed by #18). None from the Plan screens.test-plan.jscovers:debtPlan, the debt link, bucket icon and hue, scenarios and the mix are written and read back, and the API key is not written. This used a stubbed folder handle.debtPlancomes back from IndexedDB after its localStorage copy is deleted.debtPlan.debtPlan.AI summary diff:
snap-helpers.jsoutput on the samples (summary for 3 ranges,detectRecurring,byMonth,byCategory, balances, types) is identical before and after.clarity-finances.Screenshots: light and dark at 1280px and phone at 390px, for every screen with plan data and empty, plus the drawers, the inline budget edit and the New bucket form. I looked at them and compared them with the mockups. Fixes made after looking:
Manual QA steps
Setup
git checkout clarity-plan.samples/checking_sample.csv,savings_sample.csvandcredit_card_sample.csvinto a scratch folder, e.g.Desktop\finlens-test. This PR saves new plan data and test 8 clears it, so never use your real folder.index.htmlfrom disk. Press F12 and keep the Console tab open.finlens-test, and allow edit access. The Data Source card says ✓ 257 transactions loaded.The samples run May 1 – Oct 20, 2026.
1. Budget: starter budget, month switcher, alerts
Expected:
2. Budget: inline edit and the drawer
1and press Enter.999, and press Escape.400, and click ✓.Food, tick a second category under Counts spending in, and click Save budget.Expected:
3. Savings buckets
Emergency fund, Target6000, Saved so far1000, Months to goal10.5.Trip, Target2000, Saved0, Months7.Expected:
4. Debt tracker: link a card, KPIs, payoff plan
24.99, Minimum payment35, Credit limit5000. Click Save debt.Auto loan, Type Auto loan, Balance8000, APR6.5, Minimum250. Click Save debt.Expected:
5. Investing ideas
30.Expected:
6. Forecast: Savings, scenarios and Investments
10000, Savings to0, Saved each month to0, Interest (APY %) to5, Tax on interest (%) to0, and drag Years to 1.20.1000, Added each month0, Years 1, click Moderate.7. Untick Show in today's dollars.Expected:
Before this fix: the old investment forecast used 8% ÷ 12 monthly, which compounds to 8.30% a year.
7. Persistence
finlens-test\finlens-state.jsonin Notepad. Search fordebtPlan,"account","hue"and"kind": "savings".file://, right-clickfinlens_debtPlanand choose Delete. Press F5 and open Debt.Expected:
"debtPlan": { "strategy": "avalanche", "extra": 200 }, the card debt's"account", each bucket's"icon"and"hue", and the scenario with"kind": "savings".finlens-state.jsonor IndexedDB, not lost).8. Data & Reset rows
Expected:
9. Regression: empty plans, dark theme, other screens
RESET, click Start over, then OK). Visit all five Plan screens with no data.Expected:
Please check before merging
txOverrides[id].link.idx). Deleting an item shifts the later ones, so their links point at the wrong item.Generated by Claude Code
Generated by Claude Code