ReadME

The dERP Frontend is a web-based user interface that allows users to interact with the dERP platform and its components. This user interface is built using Angular CLI version 13.3.9.

Development Environment Setup

To set up the development environment for the dERP Frontend, you need to follow these steps:

1. Install NodeJS (currently using version 16.14.2)

2. Run npm i to install project dependencies

3. Edit your hosts file to include the following:

   • 127.0.0.1 sandbox.test-portal.com

   • 127.0.0.1 lsi.test-portal.com

4. Run npm run dev:lsi to spin up the development server

5. Navigate to http://lsi.test-portal.com:4200/ in your web browser. The application will automatically reload if you change any of the source files.

Code Formatting

To ensure that the codebase is consistent, it is important to follow a specific code formatting style. The dERP Frontend uses Prettier to format code. You can run npm run prettier:write to format the codebase repo-wide. Additionally, you can use npm run lint to check for any linting errors.

Development Resources

To assist in development, the following resources are available:

Material Icons List: https://www.angularjswiki.com/angular/angular-material-icons-list-mat-icon-list/

This resource provides a list of icons that can be used in the application, along with the corresponding icon key that can be used to include the icon in the application. The format for including an icon is <mat-icon{icon-key}><mat-icon>.

Build

To build the project, run ng build. The build artifacts will be stored in the dist/ directory.

Running Tests

To execute unit tests, run ng test via Karma.

To execute end-to-end tests, run ng e2e. Note: To use this command, you need to first add a package that implements end-to-end testing capabilities.