A Chrome + Firefox extension that syncs account balances from a self-hosted Actual Budget instance into ProjectionLab via its Plugin API.
Actual has no browser-callable API, so a small server-side bridge
(jhonderson/actual-http-api)
re-exposes it over HTTP. See deploy/ for setup.
Actual -> actual-http-api bridge -> extension -> ProjectionLab
Map each Actual account to a ProjectionLab account on the options page; the extension sums the Actual balances mapped to each PL account and writes that one total. Map by behavior, not one-to-one: group accounts the projection treats alike (e.g. all current accounts into one cash account) and split only where growth or tax treatment differs. Unmapped accounts still count toward historical net worth (bucketed coarsely by balance sign) but aren't pushed to Current Finances.
Credit cards you pay off monthly: map them to your cash account, not a debt account. ProjectionLab treats a paid-monthly card as an expense, so netting its negative balance into cash keeps net worth exact with no debt line that never pays down. Use a PL debt account only for debt you actually carry (mortgage, loan).
PL stores net-worth history as eight fixed buckets, but the Plugin API exposes an account's
type, not the bucket it resolves to. So backfilled history is bucketed only by PL account
category (savings, investment, asset, debt). The net-worth total stays exact and Current
Finances shows the full tax split (PL computes it live); only the historical tax-composition
is coarsened. A Plugin API method to classify accounts would let the extension rebuild the
full split.
Built with WXT + TypeScript.
pnpm install # deps + generated types
pnpm dev # Chrome, hot-reload (Firefox: load .output/firefox-mv3 via about:debugging)
pnpm build # package for the stores (build:firefox for the Firefox MV3 build)Releases are tag-driven. Bump version in package.json, commit, then tag it:
git tag v1.0.0 && git push origin v1.0.0The tag runs release.yml: it rejects a tag that disagrees
with package.json, builds both zips, attests their provenance, creates the GitHub Release,
and submits to both stores. Neither store accepts a version it already lists, so the version
bump is what makes a release possible; the tag only triggers it.
Independent, unofficial project. Not affiliated with, endorsed by, or sponsored by Actual Budget or ProjectionLab; both names are the property of their respective owners.