README.md



Installing the frontend via command line

Clone the repo: git clone https://scm.cms.hu-berlin.de/callidus/machina-callida.git

Move to the newly created folder: cd machina-callida/mc_frontend

Install NodeJS: https://nodejs.org/

Run npm install

Run npm install -g @angular/cli (you may need sudo). Optional: Install the Ionic CLI for additional command-line utilities: npm i -g @ionic/cli.
Check that the Angular command line interface is installed by running ng --version. It should print the version of the Angular CLI.
Run npm start.
If you already ran npm install and the CLI still complains about missing dependencies, install them one by one using npm install DEPENDENCY_NAME.
Open http://localhost:8100 in your browser.


Production Build
To build the application for production environments, use: ionic cordova build browser --prod --release --max-old-space-size=4096 and serve the content of the platforms/browser/www folder, e.g. with Nginx.

Development
To add new pages to the application, use: ionic generate page PAGE_NAME.
To add new WEBP images to the assets, use cwep (https://developers.google.com/speed/webp/docs/cwebp): cwebp [options] input_file -o output_file.webp

Configuration

Backend URL
To change the URL for the backend, use the ionic.config.json file (proxies > proxyUrl). By default, the system assumes that backend and frontend are installed on the same machine.

Frontend URL
Use the --host 0.0.0.0 --disable-host-check flag for ng serve if you want to use it in a production environment with an Nginx server using proxy_pass.

Other
For all other kinds of configuration, use src/configMC.ts.

Testing
To test the application and check the code coverage, run npm run test-ci.
To write new tests or debug existing ones, use npm run test-debug.