Skip to content

v1.15.0: Clarity redesign, part 3 — Plan screens (Budget, Buckets, Debt, Investments, Forecast) - #20

Open
gitluis wants to merge 3 commits into
clarity-financesfrom
clarity-plan
Open

gitluis wants to merge 3 commits into
clarity-financesfrom
clarity-plan

Conversation

@gitluis

@gitluis gitluis commented Nov 2, 2026 •

Copy link
Copy Markdown
Owner

Stacked on #19 (clarity-finances), which stacks on #17 and #16. Merge #16, #17, #19, then this.
#18 (v1.10.5) is a separate patch on master.

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.

  • Matches the mockups: what each mockup shows is built, and what it doesn't show is dropped (lists below).
  • Working controls kept: add, edit and delete for budgets, buckets and debts; the starter budget; "My %" inputs; saved forecast scenarios. They're restyled in Clarity, mostly as side-drawer forms like the bill form from v1.14.0: Clarity redesign, part 2 — Finances screens (Overview, Transactions, Income, Spending, Bills, Transfers) #19.
  • New pieces the app didn't have: debts linked to a card in your CSVs, a saved payoff plan, budget alerts and history against the budget, savings pace, the bucket monthly need, the mix split, APY and tax on savings, and today's dollars.
  • Payoff and forecast math rewritten and checked by hand in the new test script.

What changed

Shared

  • Page layout: a .page-actions row (note + buttons) under the shell's title. Titles: Budget, Savings buckets, Debt tracker, Investing ideas, Forecast.
  • The shell hides the date-range label on these five screens (showView(), PLAN_VIEWS). None of them use the range, and Budget has its own month.
  • Charts are plain boxes colored by tokens, with role="img" and an aria-label. Meters have role="progressbar" and aria-valuenow.
  • Drawer forms: inline errors instead of alert(); Delete needs a second click instead of confirm().
  • Phones (≤600px): a table's secondary columns move to a line under its first cell, so no Plan table scrolls sideways.
  • New CSS: classes in a "PLAN SCREENS (v1.15.0)" block in index.html, and one new token, --teal-text (light and dark). No hex literals.

Budget

  • Built:
    • Month switcher (‹ October 2026 ›) with "Data through Oct 20". It opens on the latest month with data.
    • An alert per category that's over (red) or at 90–99% (amber). Exactly 100% isn't flagged, as in the mockup.
    • KPIs: budgeted, spent, left to spend, over budget.
    • Table: progress, spent, budget, left. The pencil edits the amount in place (Enter or ✓ saves, Escape cancels).
    • 6-month "Budget vs. actual" bars with a dashed budget line. Over-budget months are red; an unfinished month is lighter and marked "so far".
  • Dropped to match the mockup:
    • The three old KPI cards and the single combined banner.
    • Per-budget colors and the color picker.
    • The stacked Chart.js history.
    • The row's edit and × buttons, replaced by the inline amount edit and the drawer.
  • Kept (working controls):
    • + Add category and Use starter budget.
    • Full edit and delete in the drawer, opened by clicking the category name. The mockup's pencil only edits the amount.
  • Changed: Use starter budget used to replace your budgets with a fixed set. Now it adds a budget per category you spend on, using the average of up to 3 recent complete months, rounded up to $10. It only adds categories no budget covers. With no spending, it falls back to the old set.

Savings buckets

  • Built:
    • An inline + New bucket form (name, target, saved, months to goal) with a "That's $X a month" preview.
    • KPIs: saved, total of targets, needed each month, unassigned savings.
    • A savings-pace note: "You've moved about $488 a month into savings since May…". The number is the same as Transfers → "Saved to savings".
    • Bucket cards with icon, color, "By Jun 2027 · 7 months left", a progress bar and "Needs $X a month".
  • Dropped to match the mockup:
    • The old KPI cards and the "Your Buckets" header card.
    • The click-a-card detail drawer, emoji icons, the hex color picker and the days-left countdown.
  • Kept (working controls): an edit drawer with name, target, saved, target date, an icon (9) and a color (8), and Delete. Linked transactions moved from the old detail drawer into the edit drawer.

Debt tracker

  • Built:
    • KPIs: total, minimums and their share of take-home pay, APR weighted by balance, card utilization.
    • Debts table: APR of 20% and up shows in red, plus a credit-limit usage bar.
    • Payoff plan: an extra-payment slider ($0–$1,500, steps of $25) and three cards: Avalanche, Snowball and Minimums only.
      • Each card shows when you'd be debt-free and the interest you'd pay. "Least interest" marks the cheaper of Avalanche and Snowball.
      • A summary line, balance bars for the chosen plan, the payoff order with dates, and the first 6 months.
  • New: debts linked to a card in your CSVs. The drawer's Balance from select picks a card account. The debt's balance then follows the card's imported balance, and its limit is the card account's credit limit (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.
  • Dropped to match the mockup:
    • The Type and Due columns. Both are still in the drawer.
    • The strategy toggle and the extra-payment number box.
    • The Months to Debt-Free / Total Interest / Focus Order cards and the 24-month table.
  • Kept (working controls): add, edit and delete in the drawer. All the old fields are kept, including type, limit and due day.

Investing ideas

  • Built:
    • My mix: "100% assigned" or "N% of 100%", a stacked bar, each fund's share, the stocks / bonds / real estate split, and Project this mix in Forecast →.
    • 9 funds with risk, preset % and My % inputs. VOO and AVUV were added.
    • 6 stocks to read about (AAPL, MSFT, BRK.B, JNJ, PG, COST), with no inputs.
    • Clear my % and Use the balanced preset.
    • The "not financial advice" note, as worded in the mockup.
  • Dropped to match the mockup:
    • The surplus, emergency-fund and investable-cash cards, and the personalized allocation.
    • The recommended portfolio table and both doughnut charts.
    • The rationale, category and suggested-% columns.
    • The stock table with % inputs. GOOGL, AMZN and NVDA are no longer listed.
    • The portfolio summary and the Ask Claude card.
  • Kept: State.investAlloc as it was. A stock % saved before still counts in the mix.

Forecast

  • Built:
    • Savings / Investments tabs: role="tablist", role="tab" with aria-selected, a role="tabpanel", and arrow keys move between them.
    • Savings: checking, savings, debt, saved each month, APY, tax on interest, 1–30 years. It shows projected savings, what's left after today's debt and interest earned, with stacked yearly bars.
    • Saved scenarios · N of 10: save, load by clicking the name, delete with ×.
    • Investments: start amount, monthly addition, 1–40 years, presets 5 / 8 / 11 % or a custom rate, today's dollars on or off, inflation. Bars and a year-by-year table.
  • Dropped to match the mockup:
    • The old savings simulator: separate checking, savings and debt lines; income, expense, transfer, extra debt payment and debt APR inputs; a 3–36 month horizon; one-off events; Run Simulation; the month-by-month table.
    • The Load scenario menu and the prompt() for a name. Scenarios are now named "Scenario N".
    • The investment forecast's line chart, summary sentence and gains column.
  • Kept (working controls):
    • Saved scenarios. Scenarios from the old simulator still list as their monthly net with no interest, marked "from an earlier version".
    • A small Reset button that goes back to your account balances. The mockup doesn't show it, but without it a loaded scenario can only be undone with a reload.

New stored data

What Where it lives Saved to Cleared by
State.debtPlan { strategy, extra } (new top-level key) core.js lsGet('debtPlan') localStorage, IndexedDB app_state (DB.loadAll() map, _migrateSync list), finlens-state.json (saveStateToFile() list), JSON export/import Data & Reset → Clear debts (PLAN_ALSO), Start over
bucket icon (key) and hue inside State.buckets with buckets Clear buckets, Start over
debt account inside State.debts with debts Clear debts, Start over
scenario { name, kind:'savings', inputs } inside State.scenarios with scenarios Clear forecast scenarios (new row), Start over
  • Data & Reset: also gets an Investment mix row; investAlloc was only cleared by Start over before.
  • Docs: CLAUDE.md §4.1 and §20 are updated.

Formulas and assumptions (each one is also stated on screen or in a footnote)

  • Budget spent:
    • What's counted: charges (amount < 0, not transfers) in any of the budget's categories, each counted in full (budgetSpent()). This is the same rule as before.
    • Budget history: the sum over budgets, against the current total budget.
  • Bucket monthly need: what's left ÷ calendar months to the target date (at least 1 while the date is ahead) (bucketPlan()). For example, Nov → Jun is 7 months.
  • Savings pace: paired transfers into savings accounts, minus paired transfers out of them, ÷ months of data (savingsPace()). This is the same formula as Transfers → "Saved to savings".
  • Payoff (payoffPlan()): each month:
    1. Interest is added at balance × APR ÷ 12.
    2. Every minimum is paid.
    3. Under Avalanche (highest APR first) or Snowball (smallest balance first), the extra plus the minimums of debts already paid off go to one debt at a time, re-ordered every month.
    • Minimums only pays just each debt's own minimum, with no rollover.
    • The simulation stops at 600 months and says "Not within 50 years".
    • The summary compares the chosen plan with paying only the minimums. The mockup's wording ("an extra $X makes you debt-free … sooner") would credit the rollover to the extra payment.
    • The old simulatePayoff() is kept unchanged but no longer used.
  • Growth (growthByYear()):
    • The monthly rate is (1 + yearly)^(1/12) − 1, so 12 months compound to exactly the yearly rate. Deposits land at the end of each month.
    • Savings use APY × (1 − tax).
    • Today's dollars = value ÷ (1 + inflation)^years.
    • Behaviour change: the old investment forecast used yearly ÷ 12, which turns 8% into 8.30% a year, so its numbers drop slightly.
  • Debt KPIs:
    • Average APR is weighted by balance.
    • Take-home pay = income ÷ months of data (as on Bills).
    • Utilization = card balances ÷ limits, counting only cards with a limit.
  • Defaults:
    • Savings: APY 4.0% and tax 22% (the mockup's example inputs); you can change both.
    • Saved each month starts from the savings pace, rounded to $10.
    • The investment forecast keeps the old defaults: $1,000 start, half of the average monthly surplus, 20 years, 2.5% inflation.

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, deleteBucket and deleteDebt no longer call confirm(). SUGGESTED_BUDGETS lost its hex colors.
  • AI summary: debts now report 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 key debtBalance() reads, and has no debts.
  • Trends is untouched: its code is byte-identical to clarity-finances.

Not verified

  • A real connected folder: finlens-state.json writing and reading was tested with a stubbed handle in headless Chromium, not in Edge or Chrome with a real folder.
  • Safari and Firefox: not run.
  • Real devices and screen readers: no physical phone or touch device (390px was emulated in Chromium), and no screen reader. Accessibility was checked through DOM roles and names only.
  • Contrast of the new pieces: --teal-text was 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.
  • Your real data: old-format buckets (emoji or hex) and old scenarios were tested with synthetic records only.
  • Layouts with many debts or buckets (10+).
  • AI Eval: not re-run. The summary it measures is unchanged on the samples.
  • Real card interest: payoff uses APR ÷ 12 monthly with fixed minimums. Card issuers accrue daily and lower minimums as the balance falls, so real payoff dates and interest will differ somewhat. The screen says so.
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 used NODE_PATH=$(npm root -g) node <script> /home/claude/finlens out-plan.

Script Result
test-clarity.js (shell) 54/54
test-finances.js (#19 screens) 126/126, unchanged
test-plan.js (new) 127/127
boot.js (every view, light + dark) 257 transactions, 24 views, 0 errors
race.js 7–8 errors per run, all renderImportLog → views-data.js:215 (the Import Logs race fixed by #18). None from the Plan screens.

test-plan.js covers:

  • Shell: each Plan screen opens from the Plan menu with one H1 and the range label hidden.
  • Budget:
    • The starter budget's limits are recomputed in the test from Jul–Sep transactions.
    • Each row's spent / budget / left / progress is recomputed from October's transactions.
    • KPIs, alerts (including "exactly 100% isn't flagged"), the 6-month history and the month switcher.
    • Inline edit: Enter, Escape and ✓.
    • Add, edit and delete in the drawer, including validation.
  • Buckets:
    • Form preview and validation, the record's fields, card text and progress values, and the KPIs.
    • The pace equals the Transfers screen's number.
    • The edit drawer's icon and color; delete; an old-shape bucket.
  • Debt:
    • Linking the card from the empty state; adding, editing and deleting manual debts; KPIs.
    • Avalanche, snowball and minimums-only debt-free months, interest and payoff order, checked against a separate simulation written in the test.
    • Month-1 interest and payment worked out by hand.
    • The engine against the annuity formula ($1,000 at 12% with $100 a month → 11 months, $58.98 interest).
    • The never-paid-off cap; the slider (including keyboard); plan selection saved; the AI summary line for a linked debt.
  • Investments: the preset values and split, the live mix and saving, an old stock %, the link to Forecast, and Clear.
  • Forecast:
    • Savings and investment results checked against the closed form FV = S·(1+R)^n + M·((1+R)^n − 1)/r, including after changing inputs. By hand: $10,000 at 5% for a year → $10,500, and $10,400 with 20% tax.
    • Presets and custom rate, the today's-dollars toggle, and scenarios: save, load, delete, and the old format.
    • Arrow keys on the tabs.
  • Accessibility sweep: named buttons, labelled fields, described charts and meters.
  • State file: 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.
  • Reload:
    • Everything survives a reload.
    • debtPlan comes back from IndexedDB after its localStorage copy is deleted.
  • Export includes debtPlan.
  • Data & Reset:
    • Clear debts also resets debtPlan.
    • The new scenario and investment-mix rows clear their data; Clear buckets works.
    • Start over removes it all.
  • Empty plans in light and dark, and with no data at all.
  • Phone at 390px: no page scroll and no Plan table that needs a sideways scroll.

AI summary diff:

  • snap-helpers.js output on the samples (summary for 3 ranges, detectRecurring, byMonth, byCategory, balances, types) is identical before and after.
  • The summary with two manual debts, a budget and an old bucket is identical to 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:

  • A category at exactly 100% was flagged.
  • The over-budget month label wasn't red.
  • Debt names weren't bold.
  • Phone tables scrolled sideways.
  • The edit column on phones overflowed by 2px.
  • The read-only linked balance didn't look read-only.
Manual QA steps

Setup

  1. Run git checkout clarity-plan.
  2. Copy samples/checking_sample.csv, savings_sample.csv and credit_card_sample.csv into 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.
  3. Use an Edge InPrivate window (Ctrl+Shift+N), so your real FinLens data in your normal profile is not touched.
  4. Open index.html from disk. Press F12 and keep the Console tab open.
  5. Click the gear → Import → 📁 Pick a Folder → 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

  1. Click Plan → Budget.
  2. Look at the title row.
  3. Click Use starter budget.
  4. Click ‹ (previous month) twice, then › twice.
  5. Click › once more.

Expected:

  • The title is Budget. The date-range label next to it is hidden (also on the other four Plan screens).
  • The switcher opens on October 2026 with "Data through Oct 20" (not on November).
  • Before step 3: "No budget yet. Use starter budget fills one in…".
  • After step 3: one row per category you spend on (Housing, Groceries, etc.), with limits rounded to $10. Use starter budget is now disabled, with a tooltip "Every category you spend on already has a budget".
  • KPIs: Budgeted, Spent, Left to spend, Over budget.
  • Any category over its limit gets a red alert; 90–99% gets an amber one.
  • The Budget vs. actual, month by month panel shows 6 bars and a dashed budget line. October is lighter and labelled "Oct · so far" only if its data is incomplete.
  • November shows "No transactions this month yet", and › is disabled there.

2. Budget: inline edit and the drawer

  1. Go back to October 2026.
  2. Click the pencil on the Groceries row. Type 1 and press Enter.
  3. Click the pencil again, type 999, and press Escape.
  4. Click the pencil, type 400, and click ✓.
  5. Click the category name Groceries.
  6. Clear Name and click Save budget.
  7. Type Food, tick a second category under Counts spending in, and click Save budget.
  8. Click + Add category. Without ticking any category, click Save budget.
  9. Tick one category (the name fills in) and click Save budget.
  10. Open that new budget by its name. Click Delete, then Click again to delete.

Expected:

  • Step 2: the budget becomes $1.00, the row turns red, and a "Groceries is $X over budget." alert appears.
  • Step 3: Escape leaves the amount at $1.00.
  • Step 4: $400.00 is saved.
  • Step 6: an inline red message "Give the budget a name." (no browser pop-up).
  • Step 7: the row is renamed Food and its Spent includes both categories.
  • Step 8: "Pick at least one category."
  • Step 10: the first click only changes the label; the second deletes.

3. Savings buckets

  1. Click Plan → Buckets. Read the page note.
  2. Click + New bucket.
  3. Type Name Emergency fund, Target 6000, Saved so far 1000, Months to goal 10.
  4. Change Months to goal to 5.
  5. Click Create bucket.
  6. Add a second one: Trip, Target 2000, Saved 0, Months 7.
  7. Click the pencil on Trip. Pick the Plane icon and the Pink color, change the target date, and click Save bucket.

Expected:

  • The note says "Split Bank Savings into goals, each with a target and a date".
  • The preview reads "That's $500.00 a month." at 10 months, then $1,000.00 at 5 months.
  • Emergency fund gets a shield icon automatically; its card says "By <month 5 months from today> · 5 months left" (e.g. By Apr 2027 if today is in November 2026), 17% saved, and "Needs $1,000.00 a month".
  • KPIs: Saved in buckets $1,000.00, Total of targets, Needed each month, Unassigned savings (Bank Savings balance minus $1,000).
  • A note "You've moved about $X a month into savings since May…". That $X matches Transactions → Transfers pill → Saved to savings ("About $X a month").
  • The edit drawer has Icon and Color pickers and a Linked transactions · 0 section. The card shows the plane and pink after saving.

4. Debt tracker: link a card, KPIs, payoff plan

  1. Click Plan → Debt.
  2. Click Add Bank Credit Card (credit_card_sample).
  3. In the drawer, check Balance from and the Balance ($) field. Enter APR 24.99, Minimum payment 35, Credit limit 5000. Click Save debt.
  4. Click + Add debt. Leave Balance from on I'll enter it. Name Auto loan, Type Auto loan, Balance 8000, APR 6.5, Minimum 250. Click Save debt.
  5. Drag the Extra each month slider to $200. Then click it and press the Right arrow twice.
  6. Click the Snowball card, then Avalanche.
  7. Click Overview and look at the card's account card.

Expected:

  • With no debts, the screen offers the Add Bank Credit Card (credit_card_sample) button.
  • In the drawer, Balance from is the card "(your CSV)", and the Balance field is read-only with a note that it comes from the card.
  • The card row says "Credit card · from your CSV". Its APR shows in red (20% and up); Auto loan's 6.50% does not.
  • KPIs: Total debt, Minimum payments $285.00/mo with a share of take-home pay, Average APR (weighted by balance), Card utilization "X% of $5,000".
  • Payoff plan shows three cards: Avalanche, Snowball, Minimums only, each with Debt-free month and Interest paid. One has Least interest.
  • At $200 extra, a summary says "An extra $200 a month with avalanche makes you debt-free … sooner than paying only the minimums, and saves $X in interest." Arrow keys move the slider by $25.
  • Picking a plan card changes Total balance · , the Payoff order and First 6 months.
  • On Overview, the card now shows "X% of $5,000 limit" (the limit is shared).

5. Investing ideas

  1. Click Plan → Investments.
  2. Click Use the balanced preset.
  3. Change My % for VTI from 40 to 30.
  4. Click Project this mix in Forecast →.
  5. Go back to Investments and click Clear my %.

Expected:

  • The "not financial advice" note is at the top. 9 funds (including VOO and AVUV) and 6 stocks to read about (AAPL, MSFT, BRK.B, JNJ, PG, COST), with no inputs on stocks.
  • After the preset: 100% assigned, a stacked bar, and Stocks 70% / Bonds 25% / Real estate 5%.
  • After step 3: the pill reads 90% of 100% and the bar updates as you type.
  • The link opens Forecast on the Investments tab.
  • Clear empties the mix: "Nothing assigned yet…".

6. Forecast: Savings, scenarios and Investments

  1. Click Plan → Forecast. The Savings tab is selected.
  2. Read Your numbers.
  3. Set Checking to 10000, Savings to 0, Saved each month to 0, Interest (APY %) to 5, Tax on interest (%) to 0, and drag Years to 1.
  4. Set Tax on interest (%) to 20.
  5. Click Save this scenario. Change Years to 5 and click Save this scenario again.
  6. Click Scenario 1 to load it. Click × on Scenario 2.
  7. Click Reset.
  8. Press the Right arrow key while the Savings tab has focus.
  9. On Investments: Starting amount 1000, Added each month 0, Years 1, click Moderate.
  10. Click Custom and type 7. Untick Show in today's dollars.

Expected:

  • Defaults: Checking and Savings from your balances, APY 4%, tax 22%, 10 years. Saved each month is the savings pace from test 3, rounded to $10.
  • Step 3: Projected savings $10,500. Step 4: $10,400.
  • The footnote explains the after-tax rate, e.g. "5% less 20% tax is 4.00% a year".
  • "Saved scenarios · 2 of 10" lists Scenario 1 and Scenario 2 with their final amounts. Loading fills the form. × deletes.
  • Reset goes back to your account balances.
  • The Right arrow moves to the Investments tab.
  • At 8% for 1 year on $1,000: Projected value $1,080 (exactly 8%, not $1,083).
  • Custom shows a Custom return (%) field. Unticking hides the "In today's dollars" bars; the stats and the Year by year table still show today's dollars.

Before this fix: the old investment forecast used 8% ÷ 12 monthly, which compounds to 8.30% a year.

7. Persistence

  1. Make sure you have the budgets, two buckets, two debts, a $200 extra on Avalanche, a mix and one scenario (redo steps from tests 1–6 if you cleared them).
  2. Wait 10 seconds. Press F5.
  3. Visit each Plan screen.
  4. Open finlens-test\finlens-state.json in Notepad. Search for debtPlan, "account", "hue" and "kind": "savings".
  5. In DevTools open Application → Local Storage → file://, right-click finlens_debtPlan and choose Delete. Press F5 and open Debt.

Expected:

  • Everything is still there after F5, including the slider at $200 and the chosen plan.
  • The state file has "debtPlan": { "strategy": "avalanche", "extra": 200 }, the card debt's "account", each bucket's "icon" and "hue", and the scenario with "kind": "savings".
  • After deleting the localStorage copy, the slider still shows $200 (restored from finlens-state.json or IndexedDB, not lost).

8. Data & Reset rows

  1. Click the gear → Data & Reset. Read Your plans & history.
  2. On Debts, click Clear, then Click again to confirm.
  3. Clear Forecast scenarios and Investment mix the same way.
  4. Visit Debt, Forecast and Investments.

Expected:

  • The list has new rows Forecast scenarios and Investment mix. The Debts row says "Also resets the payoff plan (strategy and extra payment)."
  • Debt shows its empty state again. If you add a debt, the slider starts at $0 on Avalanche.
  • Forecast shows "No saved scenarios yet…". Investments shows "Nothing assigned yet…".

9. Regression: empty plans, dark theme, other screens

  1. Gear → General → Dark. Visit all five Plan screens.
  2. Visit Overview, Transactions and Trends.
  3. Gear → Data & Reset → Start over (type RESET, click Start over, then OK). Visit all five Plan screens with no data.

Expected:

Please check before merging

  • The judgment calls look right to you:
    • The range label is hidden on Plan screens.
    • Budget opens on the latest month with data, not the calendar month.
    • The starter budget now merges in budgets built from your spending.
    • The category name opens the full budget drawer.
    • Debts can be linked to a card, and the card limit is shared with the Overview and Settings.
    • APR of 20% and up shows in red.
  • The payoff summary wording, which compares with "paying only the minimums", and the added one-line assumption footnotes (Debt, Forecast).
  • The 8% → 8.30% change: the investment forecast's numbers drop slightly with exact compounding.
  • The savings defaults (APY 4%, tax 22%), taken from the mockup's example inputs.
  • "Project this mix in Forecast" only opens the Investments tab. It doesn't choose a return from the mix.
  • "Show in today's dollars" only toggles the chart series. The stats and table always show today's dollars.
  • The extras not in the mockups: the Forecast Reset button and the linked-transactions list in the bucket drawer.
  • Scenarios are auto-named "Scenario N" (there's no rename).
  • GOOGL, AMZN and NVDA are no longer listed; COST, VOO and AVUV are new.
  • Try it with your own data: an existing budget, a bucket and a debt from v1.14.0 should still show and edit correctly.
  • Bug found, not fixed (pre-existing, belongs in its own PR): transaction links to a budget, bucket or debt are stored by index (txOverrides[id].link.idx). Deleting an item shifts the later ones, so their links point at the wrong item.
  • Manual QA passed in Edge/Chrome with a real folder

Generated by Claude Code


Generated by Claude Code

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
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
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
…-plan

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013Z8iBUZo6LRYpLthSp2PRi

# Conflicts:
#	CLAUDE.md
#	index.html

gitluis commented Nov 4, 2026

Copy link
Copy Markdown
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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request redesign Part of the Clarity redesign

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants