4.0.5 • Published 11 months ago

eios-library v4.0.5

Weekly downloads
-
License
-
Repository
-
Last release
11 months ago

EIOS Common Library - v.1.2.0

TODO: Update

The component library of EIOS Angular Frontend Applications.

EIOS-Common Library is a component library for EIOS Portal frontend Applications made with the Angular Framework. It allows integrating shared components with native Angular code using HTML/CSS/Typescript for all Angular Frontend Projects, according with EIOS Design Standards. This library was generated with Angular CLI version 15.2.0.

Package code GitHub Repository
https://github.com/WorldHealthOrganization/eios-common-ui-library

The Library Code Project was also used to create a playground application in which you can check the Common-Library components implementation in a real Angular environment. The Library Components implementations is in src -> app folder.

Playground Application Base-Layer

In addition the Angular Playground Application implents also:

  • DRY Structure: according with Angular development best practices the Angular Playground Application was splitted between Core Module, Shared Module and Features Modules, loaded in lazymode.
  • NGRX Redux Pattern with DevTools for a "forRoot Store" to store the critical EIOS data in a frontend structure. The "For Root Store" contain: AuthData, CurrentUser ad RouterStore. Each data structure is supplied by the related store components (Actions, Effects, Reducers, Services and Interfaces).
  • Microsoft Authentication Library for Angular: MSAL for Angular enables Angular web applications to authenticate users using Azure AD work and school accounts (AAD), Microsoft personal accounts (MSA) and social identity providers like Facebook, Google, LinkedIn, Microsoft accounts, etc. through Azure AD B2C service.
  • Auth Module: in the Features folder is provided the "Auth Module" that deal with the Azure Identity Provider the user authentication using the Angular MSAL library.

Library Peer Dependencies

Ngneat-Transloco

npm install @ngneat/transloco@4.2.2 https://ngneat.github.io/transloco/ https://www.npmjs.com/package/@ngneat/transloco

Further References

MSAL - Microsoft Authentication Library for Angular

https://learn.microsoft.com/en-us/azure/active-directory/develop/tutorial-v2-angular-auth-code https://github.com/AzureAD/microsoft-authentication-library-for-js/tree/dev/lib/msal-angular https://www.npmjs.com/package/@azure/msal-angular

Running Application

ng build eios-common --watch npm start