vly2
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...
- Say hello on our Slack channel - Join here
- Start Reading documentation
- Build the code - below
- 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:
-
install NodeJS and MongoDB and run locally - See here for detailed instructions
-
install Docker and run in a container - See here for detailed instructions
Available Commands
-
npm run dev
- starts the development server with hot reloading enabled -
npm run build
- bundles the code -
npm run test
- start the test runner -
npm run start
- runs production server -
npm run check-coverage
- generates test coverage report -
npm run lint
- runs standard to check for lint errors ( npm run fix to fix lint errors ) -
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