• Stars
    star
    108
  • Rank 321,259 (Top 7 %)
  • Language
    JavaScript
  • License
    Mozilla Public Li...
  • Created over 5 years ago
  • Updated over 1 year ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

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

vly2

VLY2 test and build codecov License: MPL 2.0

COVID-19 - The platform is undergoing a major change to be able to support a wider range of volunteering activities.

This means that the code base is undergoing a rapid period of change. If you are considering using the platform in your own country please contact us about the best time to do that.

Stay Safe

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 e2e_tests 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