Repository navigation
Conversation
Overview, Transactions (All / Payments) and the pill screens Income, Spending, Bills and Transfers rebuilt to match the Clarity mockups. Every number is computed from State; none come from the mockups. - Shared: page-actions row under the shell title, filter pills on all five screens (Income/Spending/Bills/Transfers stay registered views; the app bar keeps Transactions underlined via TX_VIEWS), KPI tiles, panels, and inline-SVG/box charts colored by theme tokens with aria descriptions. - Overview: net worth with 1M/3M/All trend and change since last month, latest month with savings rate and 6-month average, account cards with sparklines / card utilization, 6-month cash flow with net, upcoming bills, largest card purchases. - Transactions: KPIs, Payments pill shows card payments (incl. the card side of autopay transfers), Sort menu, numbered pager, new drawer (Card payment type, extra categories kept), grouped transaction rules. - Income, Spending, Bills, Transfers: rebuilt per mockup, incl. spotted charges with Confirm/Dismiss/Undo, month calendar, bills with pays-from / last paid / next due, transfer flow diagram, keyword edits that re-run detection. - Bills gain optional account / subscription / recurringKey fields inside State.bills; Clear bills also clears confirmed/dismissed spotted charges. - New aggregation helpers; detectRecurring/detectRecurringDeposits output and the AI summary unchanged. Drawer gets a title row, scrim, pinned footer and focus return. 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
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.14.0 line and added the v1.10.3-v1.10.5 history. Versions stay 1.14.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
Draft
5 tasks
…-finances Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_013Z8iBUZo6LRYpLthSp2PRi # Conflicts: # CLAUDE.md # README.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 2 of the Clarity redesign: the Finances screens. Overview, Transactions (All and Payments, the edit drawer, transaction rules) and the screens behind its filter pills (Income, Spending, Bills, Transfers) now follow their mockups section by section. Every number is computed from
State; nothing is copied from the mockups.State.bills. Data & Reset → Clear bills now also clears which spotted charges you confirmed or dismissed.detectRecurring()/detectRecurringDeposits()output are unchanged (compared before and after on the samples).What changed
Shared (
index.html,ui.js,views-main.js).page-actionsrow under the title. The mockups' subtitles ("Transfers and card payments excluded", "Recurring charges, due dates…") are that note.txPillFilter).income,spending,bills,transfers), the same views as before. Each setstxPillFilterto its pill. The Transactions view treats anything other than all/payments as All, so the app bar link always lands on the list.TX_VIEWSkeeps Transactions underlined on all five (aria-current="true"on the pill screens,"page"on the list).--track,--accent-dim,--card-soft,--card-border(light and dark).[hidden]now always hides.svgLineChart(),sparkSvg(),dailyHeatmapHtml(),.bars). Their colors come from CSS classes that read the tokens, so no hex literals and no Chart.js. Each hasrole="img"and a description.openDrawer(html, { title, footer }). The Budget, Bucket and Debt forms still work: their leading<h3>becomes the title.Overview
Transactions (All · Payments)
isCardPayment()). Before,detectTransfers()turned those into transfers, so the pill was empty on the samples.Income
recurringDepositsDetail()). All deposits: 6, then Show all.Spending
aria-pressed) that fills a drill-down panel; "Open in Transactions" opens the list filtered to that category. Daily heatmap for the period with Less/More legend. Monthly trend line with the highest month labelled and a hollow unfinished month, plus a note on which category pushed that month up. Top merchants with category and visits.Bills
billNextDue()); last paid comes from the transactions (billLastPaid()).saveBill()always pushed); the new edit button needed it to save in place.Transfers
Stored data (§4.1, §20)
account(pays from),subscriptionandrecurringKey(the spotted charge it was confirmed from). They live insideState.bills, sofinlens-state.json, IndexedDBapp_state, JSON export and Clear bills / Start over already cover them.recurringConfirmedmap; Undo deletes the key.recurringConfirmed(PLAN_ALSOinviews-cleanup.js), so a cleared bill's suggestion doesn't stay "Added to bills". The Data & Reset row says so.Helpers (
aggregation.js,ui.js)balanceAt(),dataSpan(),monthlyFlow(),isCardPayment(),transferPairs(),recurringDepositsDetail(),BILL_FREQSand the bill helpers,fmtSigned(),fmtShort(),acctName(),undoDismissRecurring(),addBill().detectRecurring()anddetectRecurringDeposits()userecurringKey()/depositKey().confirmRecurring(r)takes the detected charge;showBillForm(i)/saveBill(i)edit in place.renderHeatmap(),renderUpcomingCal(),renderTransferFlow(),drawSpark(), and the old calendar / heatmap CSS.Docs and versions
index.htmlfooter, README badge and footer,views-settings.jsDisplay card.Calls I made (please check)
detectRecurring()'s existing confidence (95% for every sample charge).Not verified
finlens-state.jsonitself. They're insidebills, which was already in the saved list, and they survive a reload through IndexedDB.pointer: coarse). Not checked on a real phone.Noticed, not changed (separate fixes):
importJsonFile()savesrecurringConfirmedandcategoryRuleswithlsSet()under those names, but they're stored asrecurringandcatRules, so after a reload the imported values are gone.periodEndBalance()ignores a starting balance (_initial) for All time but includes it for other ranges. The setting has no input in Settings today.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".
Headless Chromium (Playwright) against
samples/(257 transactions). The sandbox can't reach the CDNs, so the harness served the same pinned versions from npm (Chart.js 4.4.1, PapaParse 5.4.1, Day.js 1.11.10, marked 15.0.12, DOMPurify 3.4.17) and Inter from@fontsource. The marked and DOMPurify files match the SRI hashes inindex.html, so the integrity checks ran.test-finances.js: 126/126 passed. Expected values are computed in the page from State and the helpers, not hard-coded (except the sample's 257 rows, checked against the CSV line count).role="img"a description.finlens_*keys.test-clarity.js(shell checks from v1.13.0: Clarity redesign, part 1 — one-row app bar, theme in Settings, Clarity visual system #17): 54/54 passed, unchanged.boot.js: 257 transactions, 24 views in light and dark, 0 errors.race.js: 6–8 errors per run, allrenderImportLoginviews-data.js, the Import Logs bug that v1.10.5: fix Import Logs throwing when the view is left before it loads #18 fixes. With v1.10.5: fix Import Logs throwing when the view is left before it loads #18'sviews-data.jschange applied to a scratch copy of this branch: 0 errors. I didn't bundle that fix here (§0).buildFinancialSummary()for All time, This month and Last 3 months, plusdetectRecurring(),detectRecurringDeposits(),byMonth(),byCategory(), balances and every transaction's type and categories, are identical before and after.Manual QA steps
Setup
git checkout clarity-finances.samples/checking_sample.csv,savings_sample.csvandcredit_card_sample.csvinto a scratch folder, e.g.Desktop\finlens-test. This PR saves bills, edits and rules, and test 9 clears bills, 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.1. Overview
Main Checkingand press Enter.Expected:
2. Filter pills and the app bar
Expected:
3. Transactions list, drawer and bulk edit
NETFLIXin the search box.500.Expected:
transactions.csvdownloads with 257 data rows.4. Payments
Expected:
Before this fix: the Payments pill was empty on the samples, because the autopay pair was turned into transfers.
5. Transaction rules
SPOTIFYin When description contains, choose Subscription in Flag as, and press Enter.Expected:
6. Income and Spending
Expected:
7. Bills: confirm, dismiss, undo, add, edit, delete
Car insurance, Amount120, Due day25, Repeats Monthly, Pays from Bank Checking (or your renamed name). Click Save bill.130and click Save bill.Expected:
Before this fix: editing a bill and saving added a second copy.
8. Transfers and keywords
zellein Add keyword and press Enter.Expected:
9. Persistence and Clear bills
finlens-test\finlens-state.jsonin Notepad and search forrecurringKey.Expected:
"account","subscription"and"recurringKey"fields.10. Regression: dark theme and an empty period
Expected:
Please check before merging
Generated by Claude Code
Generated by Claude Code