cic-staff-client/README.md

CICADA

An angular admin web client for managing users and transactions in the CIC network.

This project was generated with Angular CLI version 10.2.0.

Node 17 Specific Dev Env

In package.json:dependencies -> "cic-client-meta": "file:./tmp/cic-client-meta-0.0.7-alpha.6.tgz", in package.json:scripts -> "start:dev": "export NODE_OPTIONS=--openssl-legacy-provider; ng serve -c dev",

Angular CLI

Run npm install -g @angular/cli to install the angular CLI.

Development server

Run ng serve for a local server, npm run start:dev for a dev server and npm run start:prod for a prod server..

Navigate to http://localhost:4200/. The app will automatically reload if you change any of the source files.

Code scaffolding

Run ng generate component component-name to generate a new component. You can also use ng generate directive|pipe|service|class|guard|interface|enum|module.

Lazy-loading feature modules

Run ng generate module module-name --route module-name --module app.module to generate a new module on route /module-name in the app module.

Build

Run ng build to build the project using local configurations. The build artifacts will be stored in the dist/ directory.

Use the npm run build:dev script for a development build and the npm run build:prod script for a production build.

PWA

The app supports Progressive Web App capabilities.

Run npm run start:pwa to run the project in PWA mode. PWA mode works using production configurations.

Running unit tests

Run ng test to execute the unit tests via Karma.

Running end-to-end tests

Run ng e2e to execute the end-to-end tests via Protractor.

Environment variables

Default environment variables are located in the src/environments/ directory. Custom environment variables are contained in the .env file. See .env.example for a template.

Custom environment variables are set via the set-env.ts file. Once loaded they will be populated in the directory src/environments/. It contains environment variables for development on environment.dev.ts and production on environment.prod.ts.

Code formatting

The system has automated code formatting using Prettier and TsLint. To view the styling rules set, check out .prettierrc and tslint.json.

Run npm run format:lint To perform formatting and linting of the codebase.

Further help

To get more help on the Angular CLI use ng help or go check out the Angular CLI Overview and Command Reference page.