/vly2

The Voluntarily Platform - an open source platform for organising volunteers to do cool things

Primary LanguageJavaScriptMozilla Public License 2.0MPL-2.0

vly2

Build Status codecov License: MPL 2.0

Support education and innovation in New Zealand Schools with industry experts and volunteers in the classrooms

How to join the Voluntarily community

You don't need permission to help - its open.

This is an open source project and you are welcome to contribute at any level you feel comfortable. Find out more about the project at the Website and then...

  1. Say hello on our Slack channel - Join here
  2. Start Reading documentation
  3. Build the code - below
  4. Add yourself to the CONTRIBUTORS file, check it in and send us a pull request - see this ticket VP-82

How to build it

Voluntarily is based on the MERN (MongoDB, Express, React+Redux, Node) software stack but also uses next.js to keep things clean and simple. Everything should work out of the box. There are two choices:

  1. install NodeJS and MongoDB and run locally - See here for detailed instructions

  2. install Docker and run in a container - See here for detailed instructions

Available Commands

  1. npm run dev - starts the development server with hot reloading enabled

  2. npm run build - bundles the code

  3. npm run test - start the test runner

  4. npm run start - runs production server

  5. npm run check-coverage - generates test coverage report

  6. npm run lint - runs standard to check for lint errors ( npm run fix to fix lint errors )

  7. npm run storybook - starts the Storybook Component Library

Once you see the message:

"Voluntarily is running on port: 3122! Be Awesome!" 

then you can open your browser at http://localhost:3122.

If you see the message "Please make sure Mongodb is installed and running!" then go back and start mongod.

Press ctrl + c to exit the node application.

#######################Running BDD Tests#########################

cd systemtest
npx codeceptjs run --grep "@smoke" --plugins allure   
allure serve output

############### BDD Set Up ################################

//Refer https://codecept.io/bdd

MacOS

You may need to install selenium and webdriver brew install selenium-server-standalone brew install allure followed by selenium-server -port 4444