New here? See CONTRIBUTING.md for the contribution workflow, branch naming, commit message conventions, and PR guidelines before diving in.
The project relies on Node Js.
We use vue.js as a frontend framework and PrimeVue for the UI components.
To launch the application, follow these steps:
- Clone the repository to your local machine:
git clone https://github.com/MetaConfigurator/meta-configurator.git
- Navigate into web application folder:
cd meta-configurator/meta_configurator - Install the necessary dependencies:
npm install
- Launch the application:
npm run dev
When you push your changes to the repository, one of the Github workflows automatically performs a linting check, as well as an automated formatting. To run the linting or formatting by yourself, type:
npm run lint
npm run prettierTo avoid/fix merge conflicts due to the automated formatting, you can do either:
- Call
npm run prettierlocally before you push. - Or before you push a second time, first pull the new formatting changes.
- Or
rebaseand simply overwrite all formatting changes of the remote with your current code. The formatting will anyways be executed again.
For detailed testing descriptions, see the testing documentation
In short, run unit tests and end-to-end tests the following way:
npm run test
npm run test:e2e