Skip to content

Latest commit

 

History

History
53 lines (40 loc) · 3.21 KB

README.md

File metadata and controls

53 lines (40 loc) · 3.21 KB

RE-volv

This application allows RE-volv to crowdfund donations to community solar projects in order to promote renewable energy and help save the planet. Learn more about Blueprint's work with RE-volv on our blog.

Staging URL: http://revolv-stage.herokuapp.com/

Codeship

Who We Are

bp Cal Blueprint is a student-run UC Berkeley organization devoted to matching the skills of its members to our desire to see social good enacted in our community. Each semester, teams of 4-5 students work closely with a non-profit to bring technological solutions to the problems they face every day.

Contributing

All of Blueprint's work is open source and we welcome contributions. If you would like to contribute to work on this project, please open an issue and we'll work to get your environment set up.

Task tracking and priority

All task tracking is done via the github issues page, and every issue will be triaged when it's opened. Please use Zenhub to view issue pipelines. For non-chrome users, each issue is tagged with a priority of 1, 2, 3, 4, or 5, with 1 being highest priority. In general, higher priority issues should always be worked on first.

Installation

You can choose to use vagrant or not. Note that in either case, you will need to acquire Paypal and Amazon API keys from one of the maintainers, or the app will not work locally.

If not using vagrant, first install PostgreSQL and set up a database and user with the credentials in the DATABASES setting from revolv/settings.py. Then:

$ pre-commit install
$ npm install -g grunt-cli
$ npm install -g bower
$ npm install
$ bower install
$ grunt sass
$ pip install -r requirements.txt
$ python manage.py migrate
$ python manage.py runserver
$ python manage.py seed

If using vagrant:

  1. Install Virtualbox
  2. Install vagrant
  3. vagrant up --provision
  4. python vmanage.py migrate
  5. python vmanage.py runserver
  6. python vmanage.py seed

Development

  1. Running grunt watch will start a process which will watch for changes to specific SCSS files (defined in Gruntfile) and will autocompile them to CSS.
  2. You can use the vmanage.py script to run manage.py commands on the running vagrant machine without having to vagrant ssh in. For example: python vmanage.py runserver, python vmanage.py migrate, python vmanage.py makemigrations --empty, etc.
  3. You can run manage.py seed to seed the database, and you can run manage.py seed --clear to clear the seeded data (useful for when something goes wrong and you want to regenerate all the seed data from scratch). You can also run manage.py seed revolvuserprofile to seed specific data (replace revolvuserprofile with any of the strings from revolv/base/management/commands/seed.py).