Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
41 changes: 41 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,47 @@ Format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).

---

## [1.13.0] — 2026-11-01

### App shell — Clarity redesign, part 1 (shell and visual system)
- **One-row app bar replaces the sidebar.** Left to right: FinLens · Overview · Transactions · **Plan ▾** · Trends · AI Analysis, then the sync badge, the date and account pickers and the Settings gear.
- **Plan menu:** Budget, Buckets, Debt, Investments and Forecast, each with a one-line description. Plan stays underlined on all five screens, and the menu marks the one you're on.
- **Closing menus:** a click outside, Escape (focus goes back to the button) or picking an item closes them.
- **Date range and accounts are icon buttons with popovers.** They replace the two dropdowns in the old top bar.
- **Dot on the icon:** shows when the range isn't the default (This month), or when not every account is included. The tooltip names the current choice.
- **Accounts can be combined:** pick any mix with checkboxes. The last checked account can't be unchecked. `inAccount()` already supported several accounts.
- **Custom range** opens From / To fields inside the popover.
- **Sync badge — "Synced" / "Not synced".** Green while `finlens-state.json` in the connected folder is up to date. Amber when no folder is connected, access lapsed, or the last save failed. The tooltip says which (`updateSyncBadge()` in `views-data.js`).
- **Click:** reconnects when access lapsed (the click allows the permission prompt). Otherwise it opens Settings → Import.
- **Only a stored folder handle counts as connected** (`State._folderLinked`). A folder chosen with the Safari/Firefox file picker has a name but nothing is ever written back to it, so it stays "Not synced".
- **Phone and narrow windows:** below 1000px the nav moves into a **☰ menu**, grouped like the desktop (Plan section, then Trends, AI Analysis and Settings). Below 720px the gear moves into the menu too. The old sidebar turned into a horizontal strip.
- **Page title row:** each screen opens with its title and the active range, which the old top bar used to show. The version string moved to a small footer.

### Theme
- **Light only for now.** The dark theme is taken out: the ◐ button in the top bar and the Light/Dark choice in Settings are gone, and so are the dark color tokens. It will come back in its own PR, redesigned for Clarity.
- **If you used Dark,** the app now opens in Light. `State.theme` is still saved and loaded, so the stored key doesn't change, but nothing reads it.

### Visual system
- **Clarity tokens (CLAUDE.md §6).** Indigo accent, Inter type, white cards with 16px corners and no shadow, and quieter borders. Status colors come in soft/strong pairs.
- **Contrast:** every text token reaches 4.5:1 on every surface. `--text-3` is `#5d6a7e` (the mockup's `#64748b` is 4.44:1 on the page background).
- **Old token names still work.** `--teal`, `--amber`, `--red`, `--blue` and `--purple` are aliases, so existing inline styles keep working. The sidebar tokens are removed.
- **Components restyled:** buttons, pills, chips, tables, inputs, progress bars, callouts, drawer, heatmap and calendar.
- **Callouts** are tinted boxes instead of the left-border gradient.
- **Chips** use soft tints of their hue.
- **Negative amounts** use the body text color; positives stay green.
- **Charts read their colors from the tokens.** `chartColor()` and `cssVar()` in `ui.js` read the tokens when a chart draws: income indigo, spending amber, savings teal, debt red, card orange, neutral gray. Grid lines and labels come from the tokens too. The transfer-flow SVG and sparklines use the same colors.
- **Settings tabs** are plain-text tabs with an underline. The emoji labels are gone, and so are the emojis on the Reconnect and Data & Reset buttons.
- **Investing Ideas:** the AI prompt card uses the accent tint instead of a fixed dark gradient.

### Not in this release
- **Screen layouts are unchanged.** Rebuilding individual screens to match the Clarity mockups (Overview, Bills, Budget, Debt, Forecast and so on) comes in follow-up PRs.

### Docs
- **README** — navigation instructions; the dark mode instructions are removed.
- **CLAUDE.md** — §6 tokens and components; §9 chart color and app bar helpers (the theme helpers are removed); §12 app bar navigation replaces the sidebar and its emoji rule; §17 version location; §20 Data & Reset name, and the `finlens_navCollapsed` key is no longer written.

---

## [1.12.0] — 2026-11-01

### All views
Expand Down
124 changes: 69 additions & 55 deletions CLAUDE.md

Large diffs are not rendered by default.

10 changes: 4 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

> A zero-install, browser-native finance dashboard. Drop in your bank CSVs, get instant clarity on your money.

**Version:** v1.12.0  ·  **Stack:** Vanilla JS, HTML, CSS  ·  **Install:** None
**Version:** v1.13.0  ·  **Stack:** Vanilla JS, HTML, CSS  ·  **Install:** None

---

Expand Down Expand Up @@ -52,7 +52,7 @@ FinLens auto-detects which file is which based on filename and column headers. C

**3. Explore**

Use the sidebar to navigate between views. The date range picker in the top bar applies to most views. The account filter lets you focus on a single account.
Use the top bar to move between views: Overview, Transactions, **Plan** (a menu with Budget, Buckets, Debt, Investments and Forecast), Trends and AI Analysis. On a phone or a narrow window they're in the **☰** menu. The calendar icon sets the date range for most views, and the bank icon picks which accounts to include. The **Synced** badge shows whether your changes are being saved to your folder.

---

Expand Down Expand Up @@ -223,7 +223,7 @@ FinLens/
├── views-forecast.js ← Forecast Savings + Forecast Investments
├── views-ai.js ← AI Analysis (Claude integration)
├── views-data.js ← Database section: Import, Accounts, Categories, Import Logs
├── views-settings.js ← Settings shell + General tab (theme, API key)
├── views-settings.js ← Settings shell + General tab (display, API key)
├── views-cleanup.js ← Settings → Data & Reset (clean up data, start over)
├── views-db.js ← DB Inspector, DB Schema diagram, Changelog views
├── views-eval.js ← AI Eval: grounding eval for AI Analysis (developer view)
Expand All @@ -249,8 +249,6 @@ FinLens/
- **Disconnect the folder.**
- **Start over from scratch:** type `RESET` to erase everything and reload. Your backup file is either kept as `finlens-state-backup-DDMMYYYY.json` or deleted, your choice. Your CSV files are never touched.

**Dark mode** — click the **◐** button in the top-right corner of the topbar.

**Exporting** — the Transactions tab has an **Export CSV** button for the currently filtered view. AI responses can be saved as Markdown from the AI Analysis tab.

---
Expand All @@ -261,4 +259,4 @@ See [CHANGELOG.md](CHANGELOG.md) for the full release history.

---

*FinLens v1.12.0 — Built for one person's finances, designed to be useful for anyone's.*
*FinLens v1.13.0 — Built for one person's finances, designed to be useful for anyone's.*
Loading