# spare_change
Automated microdonations app


### About Spare Change

Spare Change makes charity giving easy through seamless micro-donations.

To build Spare Change we used Ruby on Rails for the back-end, JavaScript for data visualization, Sidekiq for processing background jobs (ie. fetching daily transactions and emails), Redis as a background job queue and Sidetiq for scheduling those jobs.

Users sign up with their banking information and charity preferences.  We use Plaid and Stripe APIs to securely manage banking details and transactions. Plaid is an API for developers of financial services applications that helps them connect with user bank accounts.  Stripe is a suite of APIs that powers commerce for businesses of all sizes.

Spare Change then tracks each user's daily transactions using Plaid and calculates the difference rounded up to the nearest dollar.  All of those small differences add up to a meaningful monthly contribution (~$20 per month based on our initial user testing).

At the end of the month each user is notified of their pending contribution and given the option to abort the transaction before we charge their bank account using Stripe and send the money to the charity of the user's choosing.

## How to Run Spare Change Locally

1. Navigate to an appropriate directory on your machine

2. Clone the repo in the command line
- 'git clone https://github.com/tapley/spare_change.git'
- If forked to your repo use your clone url

3. Navigate to the spare_change directory
- 'cd spare_change'

4. Install required project gems
- 'bundle install'

5. Create database, migrate schema, seed database
- 'bin/rake db:create db:migrate db:seed'

6. Start rails server
- 'bin/rails s'

7.

8.

9.

10. Sign in test account
- Username: 'tapley'
- Password: '12345678'
Update Readme file with project description and run instructions
Update Readme file with project description and run instructions
