Caution
This project is 100% written by AI. I've done practically zero manual changes. I am not a programmer by trade, but have dabbled in various languages over the years. This gives me high-level awareness on coding practices, but I AM NOT SKILLED IN THE LANGUAGES USED IN THIS PRODUCT. I have spent months prompting Claude Code for features, updates, fixes and tweaks. I have taken steps to ensure this is secure as it can be, given the constraints. I've performed numerous security audits (both AI-prompted and 3rd party) and have implemented best-practice security measures as much as I can (including 2FA and OIDC support). Every build must pass NPM audits and security scans before publishing. However, I can't personally guarantee the security of this code. YOU HAVE BEEN WARNED.
A comprehensive personal finance management application built with NestJS and Next.js. Designed as a replacement for Microsoft Money and Intuit Quicken. 100% built using farm-fresh, free-range Claude Code.
The personal finance ecosystem is flooded with personal finance platforms. I've tried many of them, but every single one of them had deal-breakers I couldn't work with. I finally decided to try my hand at creating my own platform that met all my criteria by using "vibe-coding", which is a dirty word in the self-hosting community. I just wanted to see what was possible with the current state of AI. It turned out to be more successful than I ever could have imagined, which is why I'm making this available for others.
I've been a rabid user of Microsoft Money since 1995, when I had my first real job outside of university doing tech support for Microsoft. I started using it to keep track of my finances and to help get myself out of credit card debt. It allowed me to keep track of every aspect of my finances: chequing accounts, credit cards, loans, mortgages, investments, and more. Being software of the 90's, it didn't have much in the way of automation, especially for non-US customers. This forced me to meticulously enter every single transaction manually into Microsoft Money.
This "feature" helped me truly understand the state of my finances. I knew where every single penny went. Nothing was ever a surprise. I could forecast my finances out a year or more with precision. I've kept that going for more than THIRTY YEARS. Yes, even though Microsoft Money hasn't had a new version since 2010, I still use it. Everything from 1995 to today is stored in Microsoft Money. I can tell you my detailed financial picture going back to 1995. It certainly isn't perfect. I can only run it on one machine. There's no mobile app or anything of the sort. When I go on a trip or something, it can take hours after I return to enter and categorize my data. I've been increasingly wanting a true replacement for Microsoft Money.
My perfect product to replace MS Money needed the following features:
- Must support all types of banking and investment types, including:
- Chequing
- Savings
- Credit Cards
- Loans
- Mortgages
- Line of Credit
- Brokerage accounts
- Asset accounts
- Must support importing from QIF (the export format used by MS Money and Quicken)
- Must be self-hostable via containerization
- Must support multiple currencies
- Must support pulling currency exchange rates and stock prices on a regular basis
- Must support PostgreSQL for the backend tables
- Must have a usable mobile app or web interface
Since I couldn't find anything out there to meet that criteria, I decided to create Monize! After weeks of vibe-coding and testing, I finally was able to migrate ALL of 30+ years of Microsoft Money data into Monize with no errors or discrepancies. Microsoft Money has finally been retired!
Monize is running in my Kubernetes cluster.
Highlights of the recent releases. Every version has full notes in docs/release-notes/, and the app shows a What's New digest after each update.
| Version | Highlights |
|---|---|
| 1.21 | Crypto wallet accounts and cryptocurrencies with eight decimal places. The user guide in a side panel inside the app, searchable with ?. A redesigned dashboard you arrange in place, with a net worth hero. Command palette (Ctrl/Cmd+K) and a mobile tab bar. Bills with a Custom frequency, estimated amounts and mortgage fees. Prices from a web page, US Treasury securities, time-weighted returns and market index comparison. Reports convert past amounts at the exchange rate of their own date |
| 1.20 | Warranties (Tools > Warranties) with reminders and claims. Shared Expenses for trips and households. Payroll Deductions with yearly caps (Tools > Taxes). SimpleFIN bank sync. Convert a transaction into a transfer and back. Return of Capital. Microsoft Money 97-99 import. The user guide moved to monize.net/docs. A UI consistency pass and security and financial-math audits |
| 1.19 | Government bonds valued from their terms of issue, starting with Polish retail treasury bonds. Email receipts read brokerage trade confirmations and join buy-now-pay-later purchases to their repayments. Advanced transaction search. Hideable table columns and account-wide default views. Cash Flow Forecast dashboard widget, with overdue bills counted. OFX re-imports skip rows already imported. Exchange rates from the ECB via Frankfurter |
| 1.18 | Bank sync through Open Banking (Enable Banking). Email receipts: order confirmations read from a mailbox and matched to transactions. Mortgage types: annuity, Canadian fixed, linear and interest-only. A bank debit settles a loan installment directly. Rules can split a row or convert it to a transfer. Cash Flow Sankey report |
| 1.17 | Calendar view for transactions and investments, with day notes. Transaction rules (Tools > Rules) and an AI review inbox. Sort the register by any column. London Stock Exchange and Deutsche Börse price sources. Automatic backups copied off the machine (S3 and email). Several backend replicas with CLUSTER_MODE=multi |
| 1.16 | Notifications: a type-by-channel matrix, browser push with no third party, UnifiedPush, balance thresholds. Scan paper documents into attachments and preview them in the app. Share files into Monize. Phone layout: tables become cards, swipe between views. Payee address, phone and email, with optional lookup. Numbers in your own convention |
| 1.15 | An investment account is shown as one account. Brokerage CSV import. Compare securities against the market. Account Balances at any date. Category detail page. Cash flow forecast over several accounts. Partial dates and remembered row density |
| 1.14 | Microsoft Money full-file import (.mny). Joint accounts and transfers between two people. Security and payee detail pages. Your own asset-class allocation. GEM strategy report. Automatic backups for each user |
| 1.13 | Foreign-currency transactions and a fee breakdown. Transaction attachments. Guided tours and the What's New digest. Fixed-payment loan plans. Default categories that match your country |
| 1.12 | Loan and mortgage detail page with an overpayment simulator. A dashboard you can customize, with new widgets. A detail page for every account type. KEY:VALUE tags. Geographic look-through for ETFs and funds |
| 1.11 | The interface translated into the languages listed under Multi-Language Support, and regional English. Fifteen colour themes. Financial institutions. Auto-merge duplicate payees. AI Assistant changes that wait for your approval. Attachments in the AI chat |
- Eleven account types: Chequing, Savings, Credit Card, Loan, Mortgage, Line of Credit, Investment, Cash, Asset, Crypto and Other
- Crypto wallets: a Crypto account holds one coin and works like a chequing account (transactions, transfers, bills, imports and rules), with amounts kept to eight decimal places and network fees recorded as a split line
- A detail page for each account type: balance history, recurring charges (turn one into a scheduled bill with one click) and a 90-day balance forecast for bank accounts; the statement cycle, interest and fees and a payoff calculator for credit cards; value, appreciation and an equity panel against the financing loan for assets
- Financial institutions: group your accounts by bank or brokerage, with the institution's logo
- An investment account is shown as one account (the brokerage and its cash), with a reconciliation status on investment transactions
- Support for multiple currencies per account
- Track balances, credit limits, and interest rates
- Exclude an account from net worth
- Credit card statement dates: configurable due date and settlement date (billing cycle closing date). After you reconcile a card, Monize offers to schedule the payment
- Favourite accounts on dashboard with credit card date indicators
- Account reconciliation: edit, sort and group while you reconcile, an optional lock on reconciled transactions, and highlighted overdue unreconciled transactions. The statement ending balance is pre-filled, and the Accounts page shows when each account was last reconciled and how many rows are unreconciled
- Export an account to CSV or QIF
- Full transaction tracking with categories and payees
- Split transaction support for complex transactions
- Table or Calendar view of the register. Each day shows its transactions and, if you choose, the day's balance or its change. Day notes go on one day or across several
- Sort the register by any column; the running balance is shown in date order
- Search from the header on every page, with amounts and dates typed your own way (
1 234,56,02.07.2026) - Advanced search syntax:
#10for cheque 10,payee:costco -cat:gas,amount:50..100,date:2026-03andhas:warranty, with a line that shows how your search was read - Hide the columns you don't need on the register, the holdings table and the brokerage register, and save default views (density, shown columns, chart folding) for every account
- Convert a transaction into a transfer, or a transfer back into a transaction, keeping its attachments, tags and history
- Transfers between currencies, including a transfer line inside a split, name each currency and fill in the received amount from that day's rate
- Date fields take partial dates (
9-14,4/1/26, month names), and "Create & New" enters many transactions in a row - Foreign-currency transactions: enter the amount you were charged, see and edit the rate, and see what foreign-currency fees cost you per account
- Transfers, one-off and scheduled, can carry a category, so they show in category reports without counting as income or expenses
- Attachments for receipts, invoices and statements, stored in the database, on disk or in S3. Scan a paper document with the phone camera (page detection runs in your browser) and preview images and PDFs in the app. An attachment column and filter find the transactions that have no receipt
- Transaction reconciliation and clearing
- Bulk update and bulk delete operations with filter-based selection
- Undo and redo your recent changes from the action history panel
- Payees with auto-categorization rules, aliases with wildcard patterns, and merge capability, plus Auto-Merge for duplicates. Apply a payee's default category to its past transactions
- Payee brand icons and category icons that subcategories inherit
- A page for each payee (statistics, recurrence, seasonality, address, phone and email) and for each category (subcategories, top payees, seasonality). Payee details can be looked up through Google Places or your AI provider, and are shown for confirmation before they are saved
- Multi-currency transactions with automatic exchange rate tracking
- Import from CSV (including brokerage exports), OFX/QFX, and QIF (Quicken, including Quicken for Mac .qmtf transfer files, and Microsoft Money) with smart column auto-matching and categories nested to any depth. Drag files onto the Import page; OFX re-imports skip rows already imported, and a CSV row with a date or amount that can't be read is listed with its line number instead of being dropped
- Microsoft Money full-file import (Money 97 and later): read a
.mnyfile directly -- accounts, transfers, splits, investments, price history, exchange rates and scheduled bills -- and reconcile every balance against the file afterwards (guide) - KMyMoney full-file import: read a
.kmyor.xmlfile directly -- accounts, the full category tree, transfers, splits, investments, price history, exchange rates and schedules -- and reconcile every balance and holding against figures computed from the file afterwards (guide) - Quicken full-file import: import all accounts, categories, and tags from a single QIF export
- Bank sync (Settings -> Bank sync): import booked transactions from your bank through Open Banking (Enable Banking) or SimpleFIN Bridge, with a preview before the first import, your
importrules applied, and a daily or on-demand sync - Email receipts (Settings -> Email receipts): Monize reads order confirmations from a dedicated mailbox (Google, Microsoft 365 or IMAP), matches each one to the transaction that paid for it, and proposes a description, a payee and a split by line item for your approval. Built-in parsers for Amazon, Allegro, PayU and Google Play, a parser editor, and parsers drafted by AI. Brokerage trade confirmations become buys, sells, dividends and reinvestments, and buy-now-pay-later purchases are split into their items when the repayment arrives
- Warranties (Tools > Warranties): what you bought, when its warranty ends (or that it never does), the receipt, manual and photos, serial and model numbers, and the claims you made. Add one from a transaction in the register, get a reminder 30 and 7 days before it ends and on the day, see what is expiring on a dashboard widget, and import or export the Warracker CSV format
- Shared Expenses (Tools > Shared Expenses): split the costs of a trip, a shared flat or a club with other people, in any currency, and see the fewest repayments that settle the group. Nobody needs a Monize account, and nothing touches your own balances or reports
- Payroll Deductions (Tools > Taxes): a yearly maximum on a deduction line of your paycheque (a pension or employment-insurance contribution, for example). Each paycheque is capped to the room left, the cash flow forecast shows the capped amounts ahead of time, and a report covers every year
- Data reset: wipe financial data and re-import without losing your user account or settings
- Share into the app: with Monize installed as a PWA (Android and desktop Chromium), share a receipt photo, a PDF or a statement export (CSV, OFX, QFX, QIF) to it from another app and land on a review screen that offers to attach it to a new transaction, open the import wizard or send it to the AI Assistant. Nothing is imported or attached until you choose it, and shared files are kept on the device for an hour
- Transaction rules (Tools > Rules): when a transaction is created or imported and it matches your conditions (account, payee, category, text, amount, day of month, tags and more), add or remove tags, set the category, payee or description, or queue it for an AI review. A visual editor, a test on existing transactions before you save, a run on existing transactions with undo, and a history of every change a rule made
- More rule actions: split a row into parts with amounts read from its text, convert it to a transfer, or settle a loan installment. A date condition, and an active window outside which a rule never applies
- An AI review inbox for the transactions a rule queued and for the email receipt proposals
- Transaction tags with colours and icons for flexible cross-category labelling
- KEY:VALUE tags (for example
trip:Lisbon): filter by key, and break Income vs Expenses and Cash Flow down by tag key - Tags on securities too, with the portfolio charted by tag key
- Track stocks, bonds, ETFs, mutual funds, options, GICs and cryptocurrency
- Exchange-aware symbol resolution for North American, European and Asian markets (NYSE, NASDAQ, AMEX, ARCA, BATS, TSX, TSX-V, CSE, NEO, LSE, XETRA, Frankfurt, Euronext Paris, Amsterdam, Milan, Stockholm, Tokyo, HKEX, Shanghai, Shenzhen, ASX, Korea, Taiwan, Singapore, BSE and NSE)
- Daily price updates from Yahoo Finance, MSN, the London Stock Exchange and Deutsche Börse, or from a table on a web page you name for quotes they don't carry. Price updates can be turned off for a single security
- Government bonds valued from their terms of issue rather than a market price: Polish retail treasury bonds and US Treasury bills, notes, bonds, TIPS and FRNs, with accrued interest, suggested redemptions and maturity notifications
- A page for each security: position, price chart, documents and news
- Per-security transaction history with a running share balance
- Portfolio value and performance charts from intraday and month-to-date up to ten years, all time or a custom date range, with a breakdown by security
- Calendar view of the investment register
- Investment transactions: buy, sell, dividend, interest, reinvestment, capital gains, splits, share additions and removals, CD and bond redemptions, return of capital (lowers the cost basis instead of counting as income), and transfers between accounts that keep the cost basis
- Scheduled investment transactions
- Asset-class and country allocation, with look-through for ETFs and funds
- Compare securities with each other and against market indexes
- Time-weighted return chart for the whole portfolio, each account or each security, with market indexes such as the S&P 500 drawn alongside
- Manual price management: add, edit, and delete individual price entries
- Price backfill from transaction history (uses buy/sell prices when market data unavailable)
- Portfolio tracking with real-time valuations
- A page for each loan and mortgage: a loan schedule with the real interest of each payment, interest-rate history (rate changes are detected from your payments), and overpayments recognised the way your bank applies them
- Past Impact: what the overpayments you made have already saved
- Overpayment simulator: shorten the term or lower the installment, saved scenarios, a goal seek (work backwards from a payoff date), a fixed monthly payment plan and a chart that compares scenarios. Exports to CSV, PNG and PDF
- Mortgage types: Annuity (Level Payment), Canadian Fixed Rate, Linear (Constant Principal) and Interest Only. Monize can suggest the type from two or three installments on a statement, or from the installments you already posted. A rate-fixed term for every mortgage
- Settlement from bank debits: an imported monthly debit is split into principal and interest, booked against the loan, and marks the scheduled installment as paid, so no duplicate transaction is created
- Mortgage fees: insurance, taxes or other fees on a mortgage payment, as a fixed amount or a percentage of the balance, each with its own category and its own line on the scheduled payment
- All payment frequencies, and Canadian semi-annual compounding
- Loan Amortization Schedule, Loan Overpayment Simulator and Debt Payoff Timeline reports
- 44 currencies with built-in symbol and formatting metadata (USD, CAD, EUR, GBP, JPY, CHF, AUD, CNY and more), created on demand rather than pre-seeded
- Daily exchange rate updates from Frankfurter's central-bank rates (with Yahoo Finance as the fallback), a rate history for each currency, and a Fill gaps button for missing dates
- Cryptocurrencies alongside fiat currencies, priced from a Yahoo pair such as
BTC-EURand refreshed on weekends too - Automatic currency conversion for reporting: reports, budgets and cost basis convert each amount at the rate for its own date, and name the currency when a rate is missing
- Per-account currency settings
- Full user interface translation, including server-generated messages and emails
- Available languages (22 locales): English (with US, Canadian and UK variants), German (Deutsch), Spanish (Español), French (Français), Hindi (हिन्दी), Indonesian (Bahasa Indonesia), Italian (Italiano), Japanese (日本語), Korean (한국어), Dutch (Nederlands), Polish (Polski), Portuguese (Português), Brazilian Portuguese (Português do Brasil), Russian (Русский), Turkish (Türkçe), Ukrainian (Українська), Vietnamese (Tiếng Việt), Simplified Chinese (简体中文) and Traditional Chinese (繁體中文)
- Language can be chosen on the sign-in and registration screens and in Settings -> Preferences
- Default categories in your language, matched to your country on the first run
- Numbers follow your own convention, on screen and in the fields you type into (for example a decimal comma, or Indian lakh grouping)
- Recurring bills, deposits and transfers with 13 fixed frequencies: once, daily, weekly, every two weeks, every four weeks, twice a month, monthly, every two months, quarterly, every four months, twice a year, yearly and every two years
- A Custom frequency: chosen weekdays, days of the month (including the last day) or dates of the year, every 1-12 weeks, months or years
- Zero-amount reminders for bills that change every time, or estimated amounts worked out from your payment history to that payee, allowing for seasonal patterns
- Automatic transaction entry option
- Skip and override individual occurrences
- Scheduled transactions in another currency
- Bills calendar, filters, and a cash flow forecast over one or more accounts
- Bill payment history tracking
- 26 widgets that you can add, remove, drag and resize in place on the dashboard, and configure (time range, accounts, chart type), among them Favourite Accounts and Securities, Upcoming Bills (a list or a small calendar), Cash Flow Forecast, Top Movers (gainers or losers, by amount or percent), Portfolio Value, Assets vs Liabilities, Credit Utilization, Warranties expiring soon, Favourite Reports and daily Trivia facts about your finances
- A hero at the top with your net worth or portfolio value and its chart
- Each widget title opens its full report
- Fifteen colour themes for the whole app, each with a light and a dark variant (Settings -> Preferences)
- Built-in Reports -- 48 across ten categories (spending, income, net worth, tax, debt, investment, insights, maintenance, budget, bills), all server-side aggregated. A sample:
- Spending by Category / Payee
- Income by Source
- Monthly Spending Trend
- Monthly & Yearly Breakdown
- Income vs Expenses
- Cash Flow
- Cash Flow Sankey (where income went: spending, savings, debt and what was left)
- Year over Year Comparison
- Weekend vs Weekday Spending
- Spending Anomalies
- Tax Summary
- Payroll Deductions
- Recurring Expenses Tracker
- Account Balances (at any date, with that day's prices and exchange rates)
- Credit Utilization
- Foreign Currency Transaction Fees
- Security Performance
- Budget vs Actual
- Bill Payment History
- Uncategorized Transactions
- Duplicate Transaction Finder
- Net Worth Over Time: Historical net worth tracking with monthly snapshots
- Custom Reports: Build your own reports with flexible filters
- Custom Investment Reports: 40 columns in the style of Microsoft Money's portfolio views, as of any date, grouped by account, security or currency, in the native or the base currency
- Monte Carlo Simulation for retirement planning, with a comparison of scenarios
- GEM Strategy (Global Equities Momentum)
- Refunds reduce the category they are filed under
- Visual charts (pie, bar, line, area), and export to PDF and CSV
- Create and manage budgets with per-category allocations; a wizard suggests amounts from your spending history
- Track spending against budget targets
- Budget period snapshots and historical tracking
- Budget alerts for threshold notifications
- A notification bell with severity and Financial / System filters
- A preferences grid: each notification type against each channel (email report, email alert, browser push, UnifiedPush), with a cooldown for each type
- Browser push signed with your instance's own keys, with no Firebase or other third party, and UnifiedPush through a distributor you run yourself (ntfy, NextPush)
- Bill reminders, budget alerts, account balance thresholds, daily investment value movements and GEM strategy signals
- System alerts for administrators: a failed backup, a provider outage, failing SMTP, a weak
JWT_SECRET - Reminders that repeat until you stop them, also from the push notification itself
- Natural language queries about your finances ("How much did I spend on dining last month?", "What are my top expense categories?")
- Multi-provider support: Anthropic (Claude), OpenAI (GPT), Ollama (local models), Ollama Cloud, and any OpenAI-compatible endpoint, or your own AI subscription through the MCP relay
- Real-time streaming responses via Server-Sent Events
- 28 tools: transactions, accounts, categories, payees, tags, portfolio, capital gains, upcoming bills, budget status, period comparison, reports, transaction rules, warranties, bond series, a calculator that converts currencies, and charts
- Answers from the user guide: "how do I..." questions are answered from the guide, citing the sections used
- Changes on request: the assistant can add, change or delete transactions (up to 25 in one request), split them, record investment trades, manage payees, securities and rules, set a fund's allocation and attach a receipt to a transaction. Nothing is written until you approve it
- Attachments and a chat bubble: attach images, PDFs and CSV files to a question, and open the chat from any page
- Spending Insights: AI analysis of your spending patterns and anomalies
- Per-user provider configuration with encrypted API key storage (AES-256-GCM)
- Usage tracking with per-request token and cost analytics
- Provider fallback chain with priority-based ordering
- Connection testing to verify provider setup before use
- Suggested queries for quick exploration of your financial data
- MCP (Model Context Protocol) server for integration with AI-powered tools, with a one-click connector through OAuth 2.1 or a personal access token. MCP clients can make the same changes, each confirmed by you, within a daily write limit
- No financial data is sent to AI providers beyond what is needed to answer the specific query
- Password-protected (encrypted) backups that you download and restore
- Automatic backups for each user, encrypted with your own backup password, with a list to download or restore from; administrators set the schedule and the retention
- Backups include the attachment files, and restore across attachment storage types
- Copies of the automatic backups off the machine, switched on in your settings: to S3 (append-only, the deployment's bucket or your own) and/or by email. Only encrypted backups are copied off the machine
- A Support Backup: an anonymised copy of your data to attach to a bug report (details)
- Shared access for delegates, with permissions for each section
- Joint accounts, and transfers between two people's accounts. Investment, loan, mortgage and asset accounts are read-only for the other person
- Emergency access: if your account is untouched for a set period (14 days by default), your trusted contacts receive a one-time link, after daily reminder emails to you. You can leave them an encrypted private message. Needs email on the server
- Install Monize as a PWA on a phone or a desktop
- A layout built for the phone: nearly forty tables become cards, the register and the reports catalogue fit the width, and donut charts show their total in the centre
- A horizontal swipe moves between views; on the register it turns the page
- A bottom tab bar on phones and tablets, with three tabs you choose, a + button that adds whatever the page is about, and More
- Sorting chips on the register, and a full-screen notification panel
- Scan receipts with the camera, and share files from other apps into Monize
- A command palette (Ctrl/Cmd+K) that searches accounts, payees, categories, bills, securities, reports, pages, settings, transactions and the guide in one box
- The user guide inside the app: a side panel from the ? on each page, screenshots in your current theme, offline, and Learn more links on tooltips, empty screens and error messages that open the exact section
- Guided tours of the main features, and a What's New digest after each update
- Docker Compose files for development, production, demo and several replicas, and a Helm chart for Kubernetes
- A Windows installer for a single PC, with its own PostgreSQL, tray icon and automatic updates: no Docker needed (Monize for Windows)
- Several backend replicas with
CLUSTER_MODE=multi, with PostgreSQL only and no Redis - Attachment storage in the database, on disk or in S3 (
ATTACHMENT_STORAGE_PROVIDER); existing attachments are copied across when you switch - The automatic backup store on disk or in S3 (
BACKUP_STORAGE_PROVIDER) - Optional PostgreSQL row-level security (
RLS_MODE, off by default) - Admin -> Users shows the backup and attachment storage of each user; Admin -> Notifications switches on browser push
- An "update available" banner for administrators (
UPDATE_CHECK_ENABLED) - Every setting is described in
.env.example
- OIDC (OpenID Connect) authentication (Authentik, Authelia, Pocket-ID, etc.)
- Local credential authentication with bcrypt hashing
- Email verification at registration
- New passwords checked against known breaches (Have I Been Pwned)
- JWT-based session management with httpOnly cookies
- "Remember Me" option with configurable extended session duration (default 30 days)
- TOTP two-factor authentication with trusted device support
- Personal access tokens (PAT) for API and MCP access
- Admin user management with role-based access (admin/user); administrators can create users with an invite link, a set password or a one-time generated password
- Password reset by an emailed link; an administrator can also issue a temporary password
- Forced password change and forced 2FA policies
- Rate limiting and request throttling
- Helmet security headers (with
DISABLE_HTTPS_HEADERSoption for plain HTTP deployments) - CORS protection
- Demo mode with sample data and daily resets (try it)
Every screenshot comes from the built-in demo data (Try It with Demo Data), in the dark theme. Click a picture to open it at full size.
![]() Transaction rules (Tools > Rules) |
![]() Rule editor: IF conditions, THEN actions, and a test |
![]() Tags with colours and icons, including KEY:VALUE tags |
![]() Break down by tag key in Income vs Expenses |
![]() Security page: position, price chart and allocation |
![]() Investments calendar: daily value and change |
![]() Monte Carlo Simulation with saved scenarios |
![]() Net Worth Over Time |
![]() Notifications: each type against each channel |
![]() Colour themes: the dashboard in the "msmoney" palette |
![]() Dashboard |
![]() Transactions as cards |
![]() Calendar |
![]() Navigation drawer |
![]() Investments |
![]() Mortgage |
![]() Bills & Deposits |
![]() Report |
![]() Budget |
![]() Budget wizard |
- Framework: NestJS (Node.js/TypeScript)
- Database: PostgreSQL 16+ (developed and tested in CI against PG18, the version production runs; 16 and 17 are no longer tested)
- Authentication: Passport.js (Local & OIDC strategies)
- API Documentation: Swagger/OpenAPI (development only)
- ORM: TypeORM
- Validation: class-validator & class-transformer
- Framework: Next.js 16 (React 19/TypeScript)
- Styling: Tailwind CSS
- State Management: Zustand
- Charts: Recharts
- Forms: React Hook Form
- HTTP Client: Axios
- Date Handling: date-fns
- Runtime: Node.js 24
- Containerization: Docker & Docker Compose
- Orchestration: Kubernetes-ready (Helm charts included)
- Output: Next.js standalone build for minimal container size
monize/
├── backend/ # NestJS backend application
│ ├── src/
│ │ ├── auth/ # Authentication (Local, OIDC, 2FA, trusted devices, PAT)
│ │ ├── users/ # User management & preferences
│ │ ├── admin/ # Admin user management (roles, status, password and 2FA reset)
│ │ ├── accounts/ # Account management
│ │ ├── transactions/ # Transaction management
│ │ ├── categories/ # Category management (hierarchical)
│ │ ├── payees/ # Payee management
│ │ ├── currencies/ # Currency & exchange rates
│ │ ├── securities/ # Stock/security management & portfolio
│ │ ├── scheduled-transactions/ # Recurring payments
│ │ ├── budgets/ # Budget planner & tracking
│ │ ├── notifications/ # Email notifications (SMTP)
│ │ ├── net-worth/ # Net worth calculations
│ │ ├── built-in-reports/ # Server-side report aggregation
│ │ ├── reports/ # User-defined custom reports
│ │ ├── ai/ # AI assistant (providers, query engine, usage tracking)
│ │ ├── mcp/ # Model Context Protocol server
│ │ ├── tags/ # Transaction tags
│ │ ├── transaction-rules/ # Transaction rules (Tools > Rules)
│ │ ├── institutions/ # Financial institutions
│ │ ├── attachments/ # Transaction attachments (database, disk or S3)
│ │ ├── calendar/ # Calendar day notes
│ │ ├── backup/ # Backups, automatic and off-machine
│ │ ├── push/ # Browser push and UnifiedPush
│ │ ├── delegation/ # Shared access for delegates
│ │ ├── emergency-access/ # Emergency access for trusted contacts
│ │ ├── import/ # QIF, CSV, OFX/QFX, Microsoft Money (.mny) and KMyMoney (.kmy) file import
│ │ ├── database/ # Seeders, including the demo data (demo-seed-data/)
│ │ ├── health/ # Health check endpoints
│ │ └── main.ts # Application entry point
│ └── Dockerfile
├── frontend/ # Next.js frontend application
│ ├── src/
│ │ ├── app/ # Next.js App Router pages
│ │ ├── components/ # React components
│ │ ├── contexts/ # React contexts
│ │ ├── lib/ # API clients and utilities
│ │ ├── hooks/ # Custom React hooks
│ │ ├── store/ # Zustand state stores
│ │ └── types/ # TypeScript type definitions
│ └── Dockerfile
├── database/
│ ├── schema.sql # Complete PostgreSQL schema
│ └── migrations/ # Incremental schema migrations
├── docs/ # Contracts, guides, release notes and README images
├── e2e/ # End-to-end tests, and the README screenshot capture (readme/)
├── helm/ # Helm charts for Kubernetes
├── docker-compose.dev.yml # Development environment
├── docker-compose.prod.yml # Production environment
├── docker-compose.demo.yml # Demo environment
├── docker-compose.e2e.yml # End-to-end test environment
├── docker-compose.ha.yml # Multi-replica example (CLUSTER_MODE=multi)
├── docker-compose.zap.yml # ZAP security-scan environment
├── .env.example # Environment variables template
└── README.md
- Docker and Docker Compose
- Node.js 24 (for local development -- matches the container images)
- PostgreSQL 16+ (if running without Docker)
- Clone the repository:
git clone git@github.com:kenlasko/monize.git
cd monize- Copy environment variables:
cp .env.example .env-
Edit
.envand configure.JWT_SECRETandENCRYPTION_KEYship empty, and the backend will not start until both are filled in:POSTGRES_PASSWORD- secure database passwordJWT_SECRET- generate withopenssl rand -base64 32ENCRYPTION_KEY- generate withopenssl rand -hex 32PUBLIC_APP_URL- your public frontend URLDISABLE_HTTPS_HEADERS=true- required whenever Monize is reached over plainhttp://, as in thehttp://localhost:3001address below (see Plain HTTP)- OIDC settings (optional) for SSO authentication
-
Start the application:
docker compose -f docker-compose.dev.yml up -dThe -f is required: every stack in this repository is an explicit target
(see the tree above) and there is no default Compose file to fall back on.
- Access the application:
- Frontend: http://localhost:3001
- Backend API: http://localhost:3000
DISABLE_HTTPS_HEADERS is required whenever Monize is reached over plain
http://, including the default http://localhost:3001. It defaults to true
in docker-compose.dev.yml but to false in docker-compose.prod.yml and
docker-compose.ha.yml, so for those stacks add it to .env:
DISABLE_HTTPS_HEADERS=trueWithout it, Monize sends HSTS and COOP headers and Secure cookies that only
work over HTTPS: the app shows an "HTTPS Required" banner, and when it is reached
by anything other than localhost the browser will not keep the sign-in
cookies, so signing in fails. Remove the setting once Monize is served over
HTTPS.
Running Monize behind a reverse proxy that serves HTTPS, such as Traefik, is recommended, but setting one up is outside the scope of this documentation.
docker-compose.demo.yml turns on demo mode on top of the production stack.
With the .env from steps 2 and 3:
docker compose -f docker-compose.prod.yml -f docker-compose.demo.yml up -dOn its first start the backend seeds a demo account (demo@monize.com /
Demo123!) with twelve months of data: 15 accounts at five institutions, 36
payees, about 450 transactions with splits and transfers, 10 scheduled
transactions, 8 securities with price history and 4 custom reports. Demo mode
turns off registration, fills in the sign-in form and resets the data every
day at 4:00 AM UTC. The seed is in backend/src/database/demo-seed-data/.
The screenshots in this README are made from that data by a Playwright script,
which also adds tags, transaction rules, a budget, loans and other showcase data
through the API. To make them again, see
e2e/readme/README.md.
- Install backend dependencies:
cd backend
npm install- Set up PostgreSQL database:
createdb monize
psql monize < ../database/schema.sql- Create
backend/.env:
DATABASE_HOST=localhost
DATABASE_PORT=5432
DATABASE_NAME=monize
DATABASE_USER=your_user
DATABASE_PASSWORD=your_password
JWT_SECRET= # required: openssl rand -base64 32
ENCRYPTION_KEY= # required: openssl rand -hex 32
PUBLIC_APP_URL=http://localhost:3001- Start the backend:
npm run start:dev- In a new terminal, set up frontend:
cd frontend
npm install
cp ../.env.example .env.local # Update INTERNAL_API_URL if needed
npm run dev| Variable | Description | Example |
|---|---|---|
POSTGRES_DB |
Database name | monize |
POSTGRES_USER |
Database user | monize_user |
POSTGRES_PASSWORD |
Database password | secure-password |
JWT_SECRET |
JWT signing key (min 32 random chars; the server will not start without it). A published placeholder or typed pattern still starts but is reported to administrators. Changing it later stops authenticator (2FA) codes from working: see Changing JWT_SECRET | openssl rand -base64 32 |
ENCRYPTION_KEY |
Encrypts AI provider keys, emergency-access credentials, each user's backup key and the Web Push and OIDC signing keys (min 32 chars; the server will not start without it). Keep it safe and keep it unchanged -- losing it makes every stored secret unreadable. Formerly AI_ENCRYPTION_KEY, which is still accepted |
openssl rand -hex 32 |
PUBLIC_APP_URL |
Public frontend URL | https://money.example.com |
| Variable | Description | Default |
|---|---|---|
INTERNAL_API_URL |
Backend URL for server-side calls | http://localhost:3000 |
CORS_ORIGIN |
Additional CORS origin | - |
LOCAL_AUTH_ENABLED |
Enable local auth | true |
REGISTRATION_ENABLED |
Allow new user registration | true |
FORCE_2FA |
Require 2FA for all local users | false |
AUTH_BRAND_PANEL |
Show the brand panel with a sample-data screenshot beside the sign-in screens (false hides the panel) |
true |
OIDC_ISSUER_URL |
OIDC provider URL | - |
OIDC_CLIENT_ID |
OIDC client ID | - |
OIDC_CLIENT_SECRET |
OIDC client secret | - |
OIDC_CALLBACK_URL |
OIDC callback URL | - |
OIDC_ALLOW_PASSWORD_LOGIN |
true lets SSO accounts that have a local password sign in with it (IdP-down fallback); SSO logins keep the app TOTP. Enable app 2FA on those accounts |
false |
SMTP_HOST |
SMTP server host | - |
SMTP_PORT |
SMTP server port | 587 |
SMTP_SECURE |
Force implicit TLS on a port other than 465. Port 465 already selects it, and this cannot switch it off | false |
SMTP_USER |
SMTP username | - |
SMTP_PASSWORD |
SMTP password | - |
EMAIL_FROM |
Email sender address | - |
AI_DEFAULT_PROVIDER |
System-level default AI provider (the centrally managed AI) | - |
AI_DEFAULT_MODEL |
Default model for the provider | - |
AI_DEFAULT_API_KEY |
System-wide AI API key | - |
AI_DEFAULT_BASE_URL |
Base URL for Ollama or compatible endpoints | - |
AI_PRIVATE_BASE_URL_ALLOWLIST |
Comma-separated host or host:port private addresses a non-admin user's Ollama or OpenAI-compatible provider may use. Without an entry, only an admin can point a provider at a private or local address |
- |
AI_QUERY_MAX_ITERATIONS |
Analysis steps per AI Assistant question, centrally managed provider only | 10 |
AI_QUERY_MAX_TOOL_CALLS |
Data lookups per question, centrally managed provider only | 20 |
AI_QUERY_TIMEOUT_MINUTES |
Wall-clock minutes per question, centrally managed provider only | 20 |
AI_QUERY_MAX_INPUT_TOKENS |
Cumulative input tokens per question, centrally managed provider only | 200000 |
AI_QUERY_MAX_TOOL_RESULT_CHARS |
Characters kept from one tool result, centrally managed provider only | 50000 |
JWT_EXPIRATION |
JWT token expiration time | 15m |
REMEMBER_ME_DAYS |
Duration for "Remember Me" sessions (days) | 30 |
DISABLE_HTTPS_HEADERS |
Disable HSTS and COOP headers and the Secure cookie flag. Required (true) when Monize is reached over plain HTTP (see Plain HTTP) |
false |
DEMO_MODE |
Enable demo mode with sample data | false |
BACKUP_CONTAINER_DIR |
Container folder automatic backups are written to (each user gets a <ab>/<cd>/<user-id>/ folder underneath it) |
/data/backups |
BACKUP_HOST_DIR |
Host folder mapped to BACKUP_CONTAINER_DIR by docker-compose |
./monize/backups |
ATTACHMENT_CONTAINER_DIR |
Container folder local attachments are written to (was ATTACHMENT_LOCAL_DIR) |
/data/attachments |
ATTACHMENT_HOST_DIR |
Host folder mapped to ATTACHMENT_CONTAINER_DIR by docker-compose |
./monize/attachments |
The AI_DEFAULT_* and AI_QUERY_* variables configure the centrally managed
AI -- the provider used for any user who has not configured one of their own.
A user who adds their own provider in Settings -> AI owns its settings
completely, per-provider query limits included, and the environment does not
reach them.
- Create
.envfrom the example and set production values:
cp .env.example .env
# Edit .env: set NODE_ENV=production, strong passwords, your domain, etc.
# Serving over plain http://? Also set DISABLE_HTTPS_HEADERS=true (see Plain HTTP)- Build and start:
docker compose -f docker-compose.prod.yml up -dThe application is Kubernetes-ready with:
- Health endpoints:
/api/v1/health/liveand/api/v1/health/ready - Standalone Next.js build for minimal image size
- Environment-based configuration
Example environment for K8s:
# Frontend pod
- name: INTERNAL_API_URL
value: "http://backend-svc:3000"
- name: PUBLIC_APP_URL
value: "https://money.example.com"
# Backend pod
- name: PUBLIC_APP_URL
value: "https://money.example.com"For one Windows 10/11 x64 PC there is an installer with everything inside: the frontend, the backend and PostgreSQL 18 run as one app with a tray icon, installed for the current Windows account without administrator rights.
- Download:
Monize-Setup-<version>.exefrom the latest release. A beta built frommainis the one prerelease named "Windows beta". Until SignPath Foundation issues its certificate, the installer is signed with a test certificate Windows does not trust, so SmartScreen asks for confirmation. See the code signing policy. - Reachable from that PC only. Everything binds
127.0.0.1: no phone, no other computer, no email (there are no SMTP settings), no OIDC. The Windows guide lists everything this rules out. - Data lives in
%LOCALAPPDATA%\Monize(pgdata,attachments,backups,logs,config.json); the tray's "Move data folder..." moves it. The secrets inconfig.jsonare generated on first start and encrypted for the Windows account. - Backups: save the recovery key from the tray ("Export recovery
key..."), keep in-app backups off the PC (they restore anywhere), and
for a full copy of the instance use
desktop/scripts/Backup-Monize.ps1, which restores under the same Windows account only. The guide's Backups and Disaster Recovery explains which copy restores where. - Building it yourself:
desktop/README.md.
Swagger UI is available at /api/docs in development mode only (disabled in production for security).
POST /api/v1/auth/register- Register with local credentialsPOST /api/v1/auth/login- Login with local credentialsPOST /api/v1/auth/2fa/verify- Verify TOTP 2FA codePOST /api/v1/auth/2fa/setup- Set up 2FAPOST /api/v1/auth/2fa/reset- Reset (replace) your own 2FA with your password and an authenticator or backup code, also underFORCE_2FAGET /api/v1/auth/2fa/trusted-devices- List trusted devicesGET /api/v1/auth/oidc- Initiate OIDC authenticationGET /api/v1/accounts- List accountsGET /api/v1/transactions- List transactionsGET /api/v1/portfolio/summary- Investment portfolio summaryGET /api/v1/portfolio/top-movers- Daily top moversGET /api/v1/admin/users- Admin: list all usersPOST /api/v1/admin/users/:id/reset-2fa- Admin: reset a user's two-factor authentication and sign them outPOST /api/v1/ai/query- Natural language financial queryPOST /api/v1/ai/query/stream- Streaming financial query (SSE)GET /api/v1/ai/configs- List AI provider configurationsPOST /api/v1/ai/configs- Add AI providerPOST /api/v1/ai/configs/:id/test- Test AI provider connectionGET /api/v1/ai/usage- AI usage summaryGET /api/v1/ai/status- AI feature availabilityGET /api/v1/built-in-reports/*- Pre-aggregated reportsPOST /api/v1/mcp- MCP (Model Context Protocol) endpoint, serving revision 2026-07-28 and the 2025-era revisionsGET /api/v1/auth/tokens- List personal access tokensPOST /api/v1/auth/tokens- Create personal access tokenGET /api/v1/health/live- Liveness probeGET /api/v1/health/ready- Readiness probe
Main tables:
- users / user_preferences: User accounts and settings
- trusted_devices: 2FA trusted browser tokens
- refresh_tokens: JWT refresh token rotation
- personal_access_tokens: API tokens for MCP and programmatic access
- accounts: Financial accounts (bank, credit, investment)
- transactions / transaction_splits: Financial transactions
- categories: Hierarchical transaction categories
- payees: Payees with default category auto-assignment
- currencies / exchange_rates: Currency definitions and historical rates
- scheduled_transactions / scheduled_transaction_overrides: Recurring payments
- securities / security_prices / holdings: Stocks, price history, and positions
- investment_transactions: Buy/sell/dividend transactions
- budgets / budget_categories / budget_periods: Budget planner and tracking
- monthly_account_balances: Net worth snapshots
- custom_reports: User-defined report configurations
- ai_provider_configs: Per-user AI provider settings (encrypted API keys)
- ai_usage_logs: AI query usage tracking (tokens, duration, provider)
- ai_insights: AI-generated spending insights and anomaly detection
- dashboard_trivia: The daily trivia sentences beside the dashboard greeting
- Swagger/OpenAPI is disabled in production
- JWT tokens stored in httpOnly cookies with refresh token rotation
- TOTP 2FA with trusted device tokens (SHA256-hashed, httpOnly cookies)
- Personal access tokens for API/MCP integration
- Rate limiting enabled on authentication endpoints
- Admin role required for user management operations
- Always use HTTPS in production
- Generate strong JWT secrets (
openssl rand -base64 32)
Free code signing provided by SignPath.io, certificate by SignPath Foundation.
- What is signed:
Monize.exeand the installer,Monize-Setup-<version>.exe, of Monize for Windows. They are built from this repository by its GitHub Actions workflow and signed there through SignPath; nothing built anywhere else is signed. Third-party files in the installer, such as Electron's and PostgreSQL's, keep their own publishers' signatures or none. - Until SignPath Foundation issues the certificate, builds are signed with a test certificate that Windows does not trust.
- Committers and reviewers: kenlasko.
Changes from anyone else reach
mainonly through a pull request that a committer has reviewed. - Approvers: kenlasko. Every request to sign with the SignPath Foundation certificate waits for an approver.
- Privacy: PRIVACY.md lists every service Monize contacts, when, and what it sends.
AGPL-3.0 License - See LICENSE file for details.










































