Skip to content
A Ruby on Rails app that makes it easy to donate directly to shelters by scraping their Amazon wishlists
Ruby HTML JavaScript CSS CoffeeScript
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
app Updated Items controller index action Feb 7, 2019
bin initial commit Jun 1, 2018
config Updated reset_shelters scheduler to 30 minutes Jan 31, 2019
db Add verified attribute to Shelters. Fix new user form bug. Jun 16, 2018
lib updated schduler rake file Jun 19, 2018
log initial commit Jun 1, 2018
public initial commit Jun 1, 2018
spec remove StaticHelper pending test. Jun 28, 2018
tmp initial commit Jun 1, 2018
vendor initial commit Jun 1, 2018
.gitignore update gitignore Jul 4, 2018
.rspec .rspec typo in format documentation flag Jun 1, 2018
.ruby-version Upated travis.yml ruby version Jan 26, 2019
.travis.yml Upgraded travis-ci ruby to 2.6.0 Feb 2, 2019
Gemfile Upgraded to ruby 2.6.0 Feb 2, 2019
Gemfile.lock Updated to Rails Mar 16, 2019 Updated reset_shelters scheduler to 30 minutes Jan 31, 2019
Rakefile initial commit Jun 1, 2018 initial commit Jun 1, 2018
my_app_development Update database.yml Jun 17, 2018
package.json initial commit Jun 1, 2018 Updated spec-js Jan 26, 2019
yarn.lock Added yarn.lock via rails assets:precompile Jan 26, 2019

Build Status


Shelter Gifts - An app that makes it easy to donate items of need directly to homeless shelters across the country!


Shelter Gifts makes it easy for visitors to browse a curated list of items that are needed by shelters across the country. The list of items come directly from the individual shelters; specifically from their Amazon Wishlists.

Shelters can register with the app and save a link to their Amazon Wishlist. Once they do, all of the items on their wishlist are added to the Shelter Gifts collection and made available for all visitors to see!

Visitors can browse the list of items needed on the homepage, where each item is presented with a photo, description, price and information about the shelter and their need for the item. Each item is also presented with a button for visitors to add the item directly to their Amazon cart, where they can purchase the item and have it shipped by Amazon directly to the shelter that requested it!


App link: Shelter Gifts

Shelter Gifts is currently in demonstration mode and currently has only one verified shelter, the Men's Shelter of Charlotte.

In demo mode, you can register, create a shelter and save an Amazon Wishlist URL and the items will be added to the collection and displayed on the homepage. The open registration is intended to demonstrate the functionality of the app; however, the app resets every 30 minutes to only show verified shelters and their items (the Men's Shelter of Charlotte currently).

Local Installation

To install and run the app on your local machine:

  1. Click the green Clone or download button above and click the copy to clipboard button
  2. From your terminal, run git clone [paste the link from step 1]
  3. Then run cd shelter-gifts to navigate to the shelter-gifts directory
  4. Run bundle install to install the necessary gems and dependencies
  5. Run rake db:migrate to perform the database migrations
  6. Run rails s to start a local rails server
  7. Go to localhost:3000 to view the app!


The tests for this app were written with RSpec, the faker gem (to generate fake data for the tests) and the shoulda-matchers gem (to write more readable relationship tests).

You can run the entire test specs by running rspec, or you can perform tests for a particular file by running rspec spec/folder_name/file_name.rb.

Development Approach

If you'd like to know more about my approach to developing the app, feel free to check out the article I wrote on my website and the Shelter Gifts about page.

You can’t perform that action at this time.