diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index f29b61e..cc0641c 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -1,55 +1,12 @@
-# Contributing To OpenLedger
+# Contributing to OpenLedger
-Thanks for considering a contribution. OpenLedger is intentionally small, calm, and privacy-first. Changes should make the app more trustworthy, understandable, and maintainable without turning it into a bank-connected growth product.
+Please see [docs/Contributing.md](docs/Contributing.md) for the full contributing guide.
-## Local Setup
+## Quick Links
-```bash
-git clone https://github.com/sparshsam/openledger.git
-cd openledger
-npm install
-npm run dev
-```
+- [Development Setup](docs/Development.md)
+- [Architecture](docs/Architecture.md)
+- [Deployment](docs/Deployment.md)
+- [Testing](docs/Testing.md)
-Open `http://localhost:3000`.
-
-## Required Checks
-
-Run these before opening a pull request:
-
-```bash
-npm run lint
-npm run typecheck
-npm run build
-```
-
-For UI changes, also check:
-
-- Desktop around `1440x1000`
-- Mobile around `390x900`
-- CSV import preview
-- Manual transaction form
-- Account management
-- JSON export/import
-
-## Product Principles
-
-- No bank login unless it is optional and clearly separated from local mode.
-- No shame language, gamification, or manipulative finance copy.
-- Prefer clear data ownership over convenience.
-- Keep privacy limitations explicit.
-- Keep the interface quiet and legible.
-
-## Pull Requests
-
-Please include:
-
-- What changed
-- Why it changed
-- Validation performed
-- Screenshots for visual changes
-- Known limitations or follow-up work
-
-## License
-
-By contributing, you agree that your contributions are provided under the project's AGPL-3.0-or-later license.
+By contributing, you agree that your contributions will be licensed under AGPLv3.
diff --git a/README.md b/README.md
index fc470d8..d61aee7 100644
--- a/README.md
+++ b/README.md
@@ -1,109 +1,183 @@
-# OpenLedger
+
+
+
+
+
+
OpenLedger
+
+ A private, local-first personal finance ledger.
+
+ No bank connections, no dashboards, no noise. Your financial data stays on your device.
+
+
+
-**A private, local-first personal finance ledger. No bank connections, no dashboards, no noise.**
+
+
+
-[](https://ledger.kovina.org)
-[](https://github.com/sparshsam/openledger/actions/workflows/ci.yml)
-[](LICENSE)
-[](https://nextjs.org)
-[](https://www.typescriptlang.org)
+
-OpenLedger is a calm, local-first finance tool for everyday budgeting and records. It runs entirely in the browser — your financial data stays on your device unless you choose to back it up.
+
-## Quick Links
+
-| Link | Description |
-| --- | --- |
-| [Live app](https://ledger.kovina.org) | Production deployment on Vercel |
-| [Architecture docs](docs/architecture.md) | Data model, auth, and sync architecture |
-| [Security policy](SECURITY.md) | Reporting guidance and current limitations |
-| [Contributing](CONTRIBUTING.md) | Local setup and contribution expectations |
-| [Changelog](CHANGELOG.md) | Notable project changes |
-| [License](LICENSE) | AGPL-3.0-or-later |
+---
+
+## Gallery
+
+
+
+
+
+
+
+
+
+
+---
+
+## Why OpenLedger
+
+Most finance tools want to connect to your bank, analyze your spending, and sell you insights. OpenLedger does none of that.
+
+**It's a ledger — not a dashboard.** Enter transactions manually. Track accounts, budgets, and goals. Your data lives in your browser. Cloud backup is optional and opt-in. No analytics, no telemetry, no third-party data collection. No bank credentials or Plaid connections.
+
+
+
+---
## Features
-- **Accounts** — Create checking, credit, savings, and loan accounts. Every transaction belongs to an account.
-- **Transactions** — Manual entry with edit, duplicate, delete. Search, filter by date/account/category/type, sortable columns.
-- **CSV Import** — Import bank statement CSV/TSV files with column mapping, preview, duplicate detection, and account selection.
-- **Budgets** — Monthly spending plans with progress tracking and over-budget warnings.
-- **Goals** — Savings milestones with target amounts, progress tracking, and contribution support.
-- **Recurring Entries** — Schedule-based recurring transaction engine with upcoming entry preview.
-- **Receipt Capture** — Photo upload from camera or gallery, stored in Supabase Storage.
-- **Cloud Sync** — Signed-in users can manually back up and restore their ledger to Supabase.
-- **Search** — Global search across all transactions with Quick Jump keyboard navigation.
-- **Guest Mode** — Full local functionality without signing in. No account required.
-- **MCP Server** — AI agents (Claude Code, Cursor, etc.) can read/write your data via the Model Context Protocol.
-- **PWA** — Installable as a standalone app with service worker caching.
-
-## Tech Stack
-
-| Layer | Technology |
-|-------|-----------|
-| Framework | Next.js 16 (App Router) |
-| Language | TypeScript 5 |
-| Styling | Tailwind CSS 4 + custom CSS |
-| State | React hooks + `localStorage` persistence |
-| Auth | Supabase Auth (Google OAuth) |
-| Cloud | Supabase Postgres (Elora project, `openledger_` prefix) |
-| Crash Reporting | Sentry (optional) |
-| Hosting | Vercel → [ledger.kovina.org](https://ledger.kovina.org) |
-| License | AGPL-3.0-or-later |
-
-## Screenshots
-
-| Ledger dashboard | Transactions view |
+
+
+| | |
|---|---|
-|  |  |
+| **Accounts** — Checking, credit, savings, loan. Every transaction belongs to an account. | **Transactions** — Manual entry, edit, duplicate, delete. Search, filter, sort. |
+| **CSV Import** — Bank statement CSV/TSV import with column mapping, preview, dedup. | **Budgets** — Monthly spending plans with progress tracking and over-budget warnings. |
+| **Goals** — Savings milestones with target amounts and progress tracking. | **Recurring Entries** — Schedule-based recurring transaction engine with preview. |
+| **Receipt Capture** — Photo upload from camera or gallery to Supabase Storage. | **Guest Mode** — Full local functionality without signing in. No account required. |
+| **Cloud Sync** — Manual backup and restore to Supabase (opt-in). | **Search** — Global search with Quick Jump keyboard navigation. |
+| **MCP Server** — AI agents can read/write your data via Model Context Protocol. | **PWA** — Installable as a standalone app with offline caching. |
+
+
+
+
+
+---
+
+## Designed For
+
+**People who want a calm, honest view of their finances — no algorithms, no upsells.**
+
+- **Budget-conscious individuals** tracking everyday spending against monthly plans
+- **Freelancers** keeping simple income/expense records
+- **Anyone tired of apps that try to sell them something while they check their balance
+
+
-## Privacy
+---
-OpenLedger is **local-first by design**:
+## Design Philosophy
-- All data stays in your browser's `localStorage` by default.
-- CSV parsing happens locally — no data is uploaded to a server.
-- Cloud backup is **opt-in** — only triggered manually by signed-in users.
-- No analytics, no telemetry, no third-party data collection.
-- No bank credentials or Plaid connections.
+> _"A calm finance tool — quiet, capable, private."_
-> **Important:** `localStorage` is convenient but not encrypted secure storage. Export JSON backups regularly and store them somewhere you control.
+No dashboards. No charts begging for attention. No push notifications. Local-first by design — your data lives in your browser unless you choose to back it up. Clean typography, generous spacing, dark-mode first. Every screen has one job.
-## Local Development
+
-```bash
-git clone https://github.com/sparshsam/openledger.git
-cd openledger
-npm install
-npm run dev
-```
+---
-Open [http://localhost:3000](http://localhost:3000). The app works fully without any environment variables.
+## Built With
-### Optional: Supabase auth + cloud backup
+
+
+
+
+
+
+
+
+
-Copy `.env.example` to `.env.local` and uncomment the Supabase variables to enable Google sign-in and cloud backup.
+
-## Deployment
+---
-Deploys automatically from `main` to Vercel:
+## Version Journey
-```bash
-npx vercel --prod
-```
+| Version | Date | Highlights |
+|---------|------|------------|
+| **v0.11.0** | 2026-06 | Receipt capture, cloud sync, MCP server |
+| **v0.10.0** | 2026-05 | Goals, recurring entries, CSV import engine |
+| **v0.9.0** | 2026-05 | Budgets, search with Quick Jump |
+| **v0.8.0** | 2026-04 | Guest mode, PWA readiness |
+| **v0.7.0** | 2026-04 | Transaction search, filters, sortable columns |
+| **v0.6.0** | 2026-03 | Multi-account support, CSV import |
+| **v0.5.0** | 2026-03 | Accounts, transaction CRUD |
+| **v0.4.0** | 2026-02 | IndexedDB persistence, local-first architecture |
+| **v0.3.0** | 2026-02 | TypeScript migration, Tailwind CSS |
+| **v0.2.0** | 2026-01 | Basic ledger UI, manual entry |
+| **v0.1.0** | 2026-01 | Initial prototype |
-Required environment variables for production:
-- `NEXT_PUBLIC_SUPABASE_URL` — Supabase project URL
-- `NEXT_PUBLIC_SUPABASE_ANON_KEY` — Public anon key
-- `SUPABASE_SERVICE_ROLE_KEY` — For MCP token auth (server-only)
+[Full Changelog](CHANGELOG.md)
-## What's Next
+
-See [ROADMAP.md](ROADMAP.md) for planned work. Current release is **v0.9.11** — Release Readiness.
+---
## License
-AGPL-3.0-or-later. See [LICENSE](LICENSE).
+AGPL-3.0-or-later — see [LICENSE](LICENSE)
+
+Built by [@sparshsam](https://github.com/sparshsam)
+
+
+
+---
+
+## Part of the Open Collection
+
+
+
+
+
+
+ OpenPalette
+ A color studio for designers
+ Repo ·
+ Web
+
+
+
+ OpenSend
+ Free file sharing, no account needed
+ Repo ·
+ Web
+
+
+
+ OpenSprout
+ Plant care records
+ Repo ·
+ Web
+
+ 
+
+ 
+ 
+
