Skip to content

The Billion Oyster Project Digital Platform captures oyster restoration data and supports restoration education with curriculum and tools for research.

License

Notifications You must be signed in to change notification settings

BillionOysterProject/Digital-Platform

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Billion Oyster Project Digital Platform

The Billion Oyster Project is an ecosystem restoration and education project designed to restore one billion live oysters to New York Harbor. Our BOP Schools and Community Science program seeks to increase the skills, content knowledge, and confidence of underrepresented groups in STEM fields through hands on, authentic restoration and research activities. Schools, organizations, businesses, and community scientists each get a waterfront Oyster Research Station, a small waterfront cage filled with oysters, which they use to collect data on oyster growth and mortality, local biodiversity, and water quality. The BOP Digital Platform is the online dashboard for our program. Through the Platform, students and teachers enter and publish data, develop field research projects, and create the STEM curriculum that links keystone species restoration in New York Harbor to teaching and learning in New York City Schools.

For a quick scroll-through of the platform's features, check out the BOP Digital Platform Quick Guide. For more detailed documentation, the BOP Digital Platform User Guide lives here.

In light of our goals, we're strongly committed to making the Billion Oyster Project Digital Platform an inclusive, welcoming open source community. Before contributing to the project, please read our Code of Conduct and our Contributing Guide.

This project is based off the MEAN.js stack

Before starting, have the following installed on your system

  • Node.js - Download and Install Node.js or use the packages within brew or macports.

  • MongoDB - Follow the tutorial here - Install mongoDB

  • git - Get git from here.

  • java - Download and install or use the package within brew (brew cask install java)

  • ruby - Download and install or use the package within brew (brew install ruby)

  • sass - gem install sass

  • using npm version - 3.6.0

  • using node version - 5.6.0

Getting Started

Install globals and build.

# You can use nvm to install any Node.js (or io.js) version you require.
nvm install 4.3.0

npm install -g grunt-cli

npm install -g gulp

npm install -g bower

npm install

bower install

To generate a new scaffold

npm install -g yo

npm install -g generator-meanjs

To load data

cd scripts/mongo-load

./load-data-into-mongo.sh

Once you have cloned down this project, run:

cd Digital-Platform

npm install

#make sure mongo is running

grunt

open the browser to -  http://localhost:8081

To run the Protractor tests:

npm install -g protractor

#in one terminal

webdriver-manager update

webdriver-manager start #this is the only command you'll need to start the server once it's installed

#in a separate terminal
grunt test:e2e