public
Description: A web-based personal finance manager with a focus on non-OCD budgeting and avoiding credit card debt
Homepage: http://wiki.github.com/jamis/bucketwise
Clone URL: git://github.com/jamis/bucketwise.git
Click here to lend your support to: bucketwise and make a donation at www.pledgie.com !
jamis (author)
Mon May 25 21:04:55 -0700 2009
commit  379777136d2f50563b2242439b640d881754b3cf
tree    ed80efc47ca96646510179b4b88879c44d21653b
parent  1186f62e002b8bafadb5412adfdf44ff9583ab05
name age message
file .gitignore Mon Mar 16 08:01:31 -0700 2009 Add rake task for populating database with samp... [jamis]
file CHANGELOG.rdoc Mon May 25 21:04:55 -0700 2009 update changelog [jamis]
file Capfile Sat Mar 07 20:12:15 -0800 2009 rails as cached external [jamis]
file LICENSE Sun Apr 19 21:35:23 -0700 2009 Put it all into the public domain [jamis]
file README.rdoc Sun Apr 19 23:07:57 -0700 2009 duh, public domain, thanks, not MIT. [jamis]
file Rakefile Mon May 12 20:10:38 -0700 2008 initial commit [jamis]
file TODO Mon May 25 20:57:44 -0700 2009 update changelog Also, I'm not 100% satisfied ... [jamis]
directory app/ Mon May 25 21:03:49 -0700 2009 Fix for jamis/bucketwise#17 (truncation errors) [cmaggard]
directory config/ Mon May 18 07:15:15 -0700 2009 Making "BucketWise" page title link to the root... [KieranP]
directory db/ Mon May 25 20:49:49 -0700 2009 Adding credit card limit field so that current ... [KieranP]
directory doc/ Sat May 09 21:46:31 -0700 2009 "recall" prior events for easy entry of similar... [jamis]
directory lib/ Thu May 14 19:46:24 -0700 2009 version bump [jamis]
directory public/ Mon May 25 20:49:56 -0700 2009 bugfix: when upgrading and the limit was nil, e... [KieranP]
directory script/ Sun Mar 22 22:25:08 -0700 2009 process scripts are in a plugin now [jamis]
directory test/ Mon May 25 21:03:49 -0700 2009 Fix for jamis/bucketwise#17 (truncation errors) [cmaggard]
directory vendor/ Sun Apr 12 15:36:09 -0700 2009 use safe_mass_assignment plugin [jamis]
README.rdoc

BucketWise

DESCRIPTION:

BucketWise is a web application (written in Ruby on Rails) for managing your personal finances. It features an emphasis on budgeting (using a version of the envelope system) and avoiding debt. BucketWise is highly opinionated: it was written for one man’s specific needs, and as an experiment, and while it is working very well for that one man, there is no guarantee it will do what you want. (See FEATURES, below).

FEATURES:

  • Multiple users
  • Track multiple accounts
  • Accounts may be partitioned into "buckets", as a means of budgeting and saving money
  • Earmark funds for each credit-card purchase to avoid overspending

Things it intentionally does not do:

  • It does NOT automatically pull your transactions from your bank account, and in all likelihood, never will.
  • It does NOT intelligently learn from your purchases and try to guess how to categorize them, and in all likelihood, never will.
  • It does NOT provide a social forum for you to share thoughts with other users, and DEFINITELY never will.

REQUIREMENTS:

Essentially, all you need is Ruby, Rake, and version 2.3 of the Ruby on Rails framework. To run locally, it is recommended you also have sqlite3 installed, as well as the sqlite3-ruby bindings. It’s also easiest if you have Capistrano 2.5.x installed.

INSTALL:

Installation is about as convenient as it is for any other Ruby on Rails application. It goes something like this (and please excuse the gratuitous hand-waving):

  • Get a server on which to install it
  • Install all the software it needs
  • Configure the database
  • Deploy the application

To get started quickly, you can just run it locally. Setting that up goes something like this:

  • "cap local externals:setup" to load up the dependencies that BucketWise needs. (You’ll need to have git installed for this to work.)
  • "rake db:schema:load" to prepare the database
  • "rake user:create" to create your first user, and note the user-id
  • "rake subscription:create USER_ID=<id>" to create your first "subscription" (a container for your financial account data).
  • "script/server", and then go to localhost:3000/ to log in and get started!

If you want to use Capistrano to deploy BucketWise to a server of your own, you can simply create a file at ~/.bucketwise/Capfile, which should contain your custom deployment instructions. If that file exists, BucketWise’s own config/deploy.rb will load it automatically.

LICENSE:

This software is hereby placed in the public domain.

  - Jamis Buck (author), April 2009