DDS Angular Components

Angular components based on DDS style guide.

Versions

| Angular | Bootstrap | dds-angular-components | |:------:|:------:|:------:| | >=10.0.0 <12.1.0 | >=5.0.0 | v0.1.x |

Table of contents

• Features
• Installation
• Development
• Usage
• Build
• CI/CD
• Further help

Features

• [x] Button
• [x] Toggle switch
• [x] Checkbox
• [x] Radio button
• [x] Modal

Installation

@dds-packages/dds-angular-components is hosted at https://amaas-eos-mw1.cec.lab.emc.com artifactory. In order to install @dds-packages/dds-angular-components package and its dependencies custom registry should be specified in .npmrc:

strict-ssl=false
@dds-packages:registry=https://amaas-eos-mw1.cec.lab.emc.com/artifactory/api/npm/vxflexos-npm-local-mw/

Run npm install @dds-packages/dds-angular-components

Alternatively you can install directly via:

npm install @dds-packages/dds-angular-components --registry=https://amaas-eos-mw1.cec.lab.emc.com/artifactory/api/npm/vxflexos-npm-local-mw/

Available versions: https://amaas-eos-mw1.cec.lab.emc.com/artifactory/vxflexos-npm-virtual/@dds-packages/dds-angular-components/-/@dds-packages/

Development

Run ng build dds-angular-components. In order to watch code changes automatically please add --watch

You have 2 options to run the project:

Locally:
ng serve

Container:
docker build -f .\Dockerfile.dev . -t dds-packages
docker run -p 4200:4200 -i -t dds-packages

Usage

Please see Storybook --> link (TBD)

Build

Run ng build dds-angular-components to build the project locally. The build artifacts will be stored in the dist/dds-angular-components directory. Use the --prod flag for a production build.

CI/CD

During continuous development @dds-packages/dds-angular-components library built in containerized environment.

File Dockerfile is the two-stage docker file for building and publishing appropriately and used in CD pipeline at remote build machine.

Run

docker build --target=build -f projects/dds-angular-components/Dockerfile .

Publish to NPM repository requires two arguments: BUILD_NUMBER and NPM_CREDENTIALS

Build and Publish

docker build --no-cache -f projects/dds-angular-components/Dockerfile --build-arg NPM_CREDENTIALS=$(echo -n $ARTIFACTORY_CREDS | openssl base64) --build-arg BUILD_NUMBER=$BUILD_NUMBER .

Further help

To get more help please contact [email protected].