A personal finance tool designed to help balance and reconcile your accounts.
What is olubalance?
Having accumulated a considerable amount of debt a few years ago, and in need for a better way of tracking my family finances than using a spreadsheet, I decided to look into building my own solution. I had dabbled in Ruby on Rails briefly before and enjoyed it so took this opportunity to really dive in and build a full featured application. olubalance is constantly growing and I hope if you find it you'll enjoy it as much as I have enjoyed building it!
olubalance is meant to be used as an online checkbook register (remember when people used to "balance their checkbooks"?). The idea is that you enter transactions as you spend or earn and know exactly how much is in your account at any given time.
If you rely on online banking, you can sometimes be surprised when pending transactions post, or that check you wrote 3 weeks ago and forgot about until it's too late. By using olubalance to track your finances, you can mitigate these surprises and stay on track! There is even a feature to mark transactions as pending so that you can keep an eye on those transactions in your regular online banking account. In olubalance, pending transactions are reflected in your account balance (unlike online banking)... yay!
One other fantastic feature is the ability to attach receipts to your transactions. From a mobile device, it's as easy as snapping a photo of your receipt when you create a transaction and it will be saved where it needs to be for future reference. Attachments can be either image files or PDF files (for online bill payments). This is a great way to keep record of where your money goes in case you ever need proof of it in the future.
olubalance cannot and will not ever connect to your bank account. This is unlike other financial tools that "sync" your transactions from your online banking account. With olubalance, you will be the only party to add or remove transactions within the app.
Transaction Details (with Receipt)
Building / Contributing
Basic instructions for building olubalance on your local system
- Ruby 2.6.4
- Rails 220.127.116.11
- PostgreSQL 12
- Your own Amazon S3 Storage Credentials (or change the config to use local storage)
Once dependencies have been met:
- Create Postgres User, set a password
- Save the file
- Set the configuration values in
application.ymlas you wish
rails db:seedif you wish to seed the database with sample data.
- Boot up your rails server (
rails s), and browse to
localhost:3000in a web browser!
Looking for Help?
Feel free to file an issue on the project and I'll do my best to accomodate! :)