meowmeowbeenz-api

http://github.com/neilgupta/meowmeowbeenz-api

MeowMeowBeenz let's you say how much you like, who you like, when you like, all from a standard non-Boost Mobile phone!

This project provides a restful API for powering the meowmeowbeenz mobile app.

Demo

You can test out a demo of the API and read the docs at http://meowmeowbeenz.herokuapp.com

This is running on Heroku's free tier, so it will be slow. Do NOT use this for development. Once you've tested the API out, you should clone this project and run it locally (see Getting Started).

Progress

So far, this api handles signing up, logging in, rating, and searching users.

TODO

The following features still need to be added:

Send push notifications to mobile devices when they are given meowmeowbeenz or when their meowmeowbeenz level changes. I am thinking of using Amazon SNS (with j7w1 gem) for push notifications.
Add news feed functionality (see discussions on r/meowmeowbeenz)

If there are any features that should be added to this list, create a new issue.

Getting Started

Make sure you have Ruby 2 and Postgres 9 installed (ruby -v && postgres --version)
Clone this repo (git clone git@github.com:neilgupta/meowmeowbeenz-api.git)
Copy config/database.yml.sample, enter your db username and password, and save as config/database.yml
Copy env.sample, fill out config variables, and save as .env
Run the following commands:

bundle install
rake db:create
rake db:migrate
foreman start -p 3000

Access the documentation at http://localhost:3000/docs and the API at http://localhost:3000/

Contributing

Fork it
Create your feature branch (git checkout -b my-new-feature)
Commit your changes (git commit -am 'Add some feature')
Push to the branch (git push origin my-new-feature)
Make sure all tests pass (rake test)
Create new Pull Request

Credits

The idea comes from NBC's Community Season 5, Episode 8: "App Development and Condiments"

It is a brilliant episode, check it out!

Author

Neil Gupta http://metamorphium.com

neilgupta/meowmeowbeenz-api