Contribute
CloudBank is an open-source labour of love. Code, translations, bug reports and ideas are all welcome.
Run it from source
A Go backend embedding a React SPA. Requires Go 1.25+, Node 22+ and Docker for the container build.
# Backend (Go 1.25+)
cd server
go run ./cmd/cloudbank # serves on :8080
# Frontend (Node 22+, separate terminal)
cd web
npm install
npm run dev # Vite dev server, proxies /api → :8080
Common tasks are wrapped in the Makefile: make gen / lint / test / build / docker.
Conventions
One issue → one branch → one PR. Money is int64 minor units; dates are civil strings; SQL via sqlc.
Good first issues
Looking for a place to start? Browse the beginner-friendly issues.
Report a bug
Found something off? Open an issue with steps to reproduce.
Request a feature
Have an idea (or a HomeBank feature you miss)? Let us know.
Translations
The UI ships English & Italian — help add or improve a language.
Star & share
The quickest way to help: star the repo and tell a fellow HomeBank user.
By contributing you agree your work is licensed under the AGPL-3.0. Please don't paste code from HomeBank or other GPL sources — CloudBank is a clean-room reimplementation.