Ledger
Income, expenses and transfers with splits, tags, attachments and recurring schedules. CSV in, CSV out.
Look closely at your money: where it is, and where it went.
Every account, card, bill and budget in one shared ledger, on a server you own.
masdan
Tagalog, verb. From masid, careful observation.
- 1To observe closely.
- 2To look at something carefully, with full attention.
All of it, in one place.
Bank apps, card statements, a spreadsheet, a drawer of receipts. Masdan puts every account, card, bill, budget and goal into one ledger the household shares, so the whole picture is one screen away.
Net worth, 48 months of sample data, dithered from the series itselffig. 2
Built around one shared ledger.
Whoever is in the household, one person or five, records into the same books. Balances, budgets and reports are derived from it, never typed in twice.
Accounts
Assets and liabilities in any currency. Beautifully designed credit cards, with statements and net-worth history.
Planning
Category budgets, savings goals, card reminders and a bill calendar any calendar app can subscribe to.
Reports
Cash flow, spending by category or tag, savings rate and budget performance, all read from the ledger.
Assistance
Optional. Quick entry from free text, receipt photos or Telegram, AI categorization and Ask Masdan. AI spend is capped daily, per household and per person.
Just you, or the whole household
On your own
Sign up and you have a household of one. Every feature works for a single person, and nobody else ever has to join.
Together
Invite a partner or family with a link and give each one a role: owner, admin, member or viewer.
Self-hosted
Postgres is the system of record. Redis and S3-compatible storage are optional, and the whole stack runs from one Docker Compose file.
Every movement, written once.
Income, expenses and transfers land in one ordered ledger, on the household's own calendar day.
A
CSV import
Bring in a bank's CSV export. Rows already imported are skipped, so a re-run never doubles the books.
B
Recurring
A schedule posts the rent, the gym or the card payment on a daily, weekly or monthly rhythm.
C
Splits and tags
Split one receipt across categories. Tags sit beside categories, so “Family” can cut across all of them.
Beautifully designed cards.
Assets on one side, liabilities on the other, and the balance sheet that falls out of them, month after month.
Card designs
Pick a design from a catalog grouped by country. The list shows a card, not a grey rectangle.
Statements
Each statement keeps its period, balance, minimum due and due date, and puts the payment on the bill calendar.
Currencies
Every account keeps its own currency. Net worth converts them into the household's.
AI, only if you want it.
Every feature works without an AI provider. Connect one and you can type, snap or ask instead of filling in forms.
ask masdan
create the following income categories for me:
1. Freelance
2. Business
3. Gigs
I’ll add three income categories. Nothing is saved until you confirm.
Proposed changes
- FreelanceIncome category
- BusinessIncome category
- GigsIncome category
Confirm changesCancel proposal
Saved. Three income categories added.
how much have i spent on dining this month and are we still within budget?
Yes, with room to spare. Dining is at ₱6,247.50 of its ₱9,000.00 September budget, with 11 days left.
- Spent
- ₱6,247.50
- Budget
- ₱9,000.00
- Left
- ₱2,752.50
- MesaSep 12₱2,180.00
- ManamSep 6₱1,435.00
- JollibeeSep 17₱412.00
- Dining
- Sep 1 to 19
- September budget
dinner at jollibee 400 metrobank mc
Recorded.
Jollibee
Dining, Metrobank Mastercard, today
−₱400.00
The same sentence works from Telegram, and so does a photo of the receipt.
No AI provider configured
AI is off. Nothing changes.
Categories, budgets and entries all have their own screens, and nothing leaves your server.
- You confirm every change
- Ask Masdan proposes changes and saves nothing until you confirm them.
- Capped daily
- Token spend is limited each day, per household and per person.
- Your provider
- Requests go through your own Cloudflare AI Gateway, to the model you pick.
Your server. Your Postgres.
Four commands from a clone to a running household, on one machine with Docker. Or skip the clone and run the published images.
Read the self-hosting guideshell~/Masdan
git clone https://github.com/Klu-Digital/Masdan.git && cd Masdanpnpm install && pnpm secrets:setupdocker compose up -d --wait postgres && pnpm db:deploypnpm docker:up# then open http://localhost:2600# the first account you create becomes the admin- Required
- PostgresThe system of record: the ledger, sessions and the job queue.
- Optional
- RedisCache and shared rate limits. Without it, both fall back to each process.
- S3 storageReceipts and attachments, on any S3-compatible bucket.
- AI providerQuick entry, receipts, categorization and Ask Masdan, capped daily per household and per person.
- TelegramChat entry from your phone.
Questions, answered.
About running Masdan and helping it grow.
Do I need to host it myself?
Yes. Masdan runs on your own infrastructure. The repository includes instructions for getting started with Docker. You manage updates and backups for your instance.
Self-hosting guideCan I use it on my own?
Yes. Signing up gives you a household of one, and every feature works without anyone else. Invite others later, or never.
Will Masdan become a paid product?
I have no plans to monetize Masdan. It’s an open-source project, not a subscription business. Running your own instance may still involve hosting costs.
Will there be a mobile app?
No native mobile app is planned. Masdan is a web app you access through your browser.
Does it connect directly to my bank?
No. You can record transactions yourself or import your bank’s CSV export into the ledger.
Do I need AI to use Masdan?
No. AI features are optional. You can track your finances without configuring an AI provider. If you enable them, relevant data is sent to your chosen provider, whose usage may involve costs.
Can I suggest a feature?
Absolutely. Tell me what you’re trying to do in a GitHub issue. We can discuss it and, if you’d like, work on it together.
Open an issue on GitHubKeep the whole household in view.
On your own machine, under the MIT License. Read it, run it, change it.