app.brmodeloweb.com

Web application for database modeling and teaching

Released under the Apache License 2.0

Dependencies

To run this application you'll need:

• EditorConfig
• Node.js (Strongly recommended to install it via nvm or n)
• Yarn
• MongoDB Community Edition (Check installation guides)

Running application

1. Install dependencies: yarn install
2. Duplicate .env.example and rename it to .env
3. Make sure you have MongoDB running (To know more: MacOS, Windows, CentOS, Ubuntu or Debian)
4. Start frontend: yarn start:frontend
5. Start server: yarn start:dev
6. Access it: http://localhost:9000/

Running with docker-compose

Note: Docker setup is still a work in progress and does not offer a good developer experience. For now we recommend you to run the project locally following the instructions listed above. If you still want to use docker, here's how:

1. Make sure you have Docker Desktop running
2. Start docker: docker-compose up or docker-compose up -d
3. Access it: http://localhost:9000/
4. Once your done, finish docker: docker-compose down

Tests

Setup tests

1. Duplicate cypress.env.example.json and rename it to cypress.env.json
2. Update cypress.env.json with valid user credentials (Username and password)

[!WARNING] The data from the accound you set in cypress.env.json will be wiped out after the tests run. So, don't use your real account here!

E2E tests

To run E2E tests you have two options:

1. Run headless mode in your terminal window: yarn test:cy
2. Run interactive mode: yarn cy:open

Unit Tests

To run the unit tests you have two options:

• yarn test to run all the tests and collect the coverage report. Or;
• Execute in a watch mode by running yarn test:watch

Production environments

• Stable: https://app.brmodeloweb.com
• Staging: https://brmodelo-stage.herokuapp.com

Contributors ✨

Thanks goes to these wonderful people (emoji key):

This project follows the all-contributors specification. Contributions of any kind welcome!