Introduction
Wicker Money is a self-hostable personal finance app, built as a thin core plus installable plugins.
The core owns identity, money movement and the app shell. Everything that
interprets money — budgets, forecasting, FIRE planning,
importers — is a plugin built against @wickermoney/plugin-sdk. A fresh
install is useful on its own. Bundled plugins ship enabled, an owner can turn
any of them off from Settings without losing its data, and they are built
against the same SDK a third-party plugin would use. Five of them (Insights,
Spending Trends, Upcoming, Forecast and Debt payoff) run in a sandboxed frame;
Budgets and Import CSV still run in the app's own page, fully trusted. There is
no install flow for third-party plugins yet; an operator can add one by hand, as
an experimental feature.
Wicker Money is pre-1.0 and has one maintainer (Jeremy). Some of what's on this site describes where a piece of self-hosting is headed rather than a polished, battle-tested path — that's called out explicitly wherever it applies. See the roadmap for what's shipped versus planned.
Where to go next
- Self-hosting — run your own instance with Docker.
- Features — recurring items and matching them to what landed, the "Until payday" widget, the balance forecast, monthly budgets with windows and account allowances, categories and rules, transfers, CSV import, the dashboard, a debt payoff plan, turning plugins on and off, owners and members, erasing your data, and how the app tells you what an action did.
- Contributing — set up a dev environment and understand how the codebase is laid out.
- API reference — endpoint reference (in progress).
License
The application (apps/*) and bundled plugins (plugins/*) are
AGPL-3.0-only.
plugin-sdk and ui-kit — the surface a plugin is built against — are
Apache-2.0, which is what makes an independently-built, non-bundled plugin
possible to license on its own terms. See
the architecture overview
for why that split exists.