# NAME

bb-ang - Extending angular cli

# SYNOPSIS

```bash
bb-ang [--help] [-v|--version]
bb-ang package-libs [--help] [projec]
bb-ang package-apps [--help] [--node-deps-scope <npm scope>] [--configuration <configuration>]
    [--dev] [--ts-config <ts config>] [--output-hashing]
    [--build-memory <mb>] [--serial-build] [--catalog-root <root path>]
    [--portal-version <version>] [--cx-version <version>] [--applications <applications>]
    [--extend-container] [projec]
bb-ang copy-assets [--help] [--dist <dist folder path>] [projec]
bb-ang combine-coverage [--help] [--dist <dist folder path>] [--reporters <reporters>] [projec]
bb-ang check-api [--help] [--lib <lib>] [--report-folder <report-folder>] [projec]
bb-ang extract-api [--help] [--lib <lib>] [--report-folder <report-folder>] [projec]
bb-ang build-apps [--help] [--configuration <configuration>] [--node-deps-scope <npm scope>]
    [--ts-config <ts config>] [--output-hashing] [--build-memory <mb>]
    [--serial-build] [--catalog-root <root path>] [--applications <applications>]
    [--portal-version <version>] [--cx-version <version>] [projec]
bb-ang create-provisioning-package [--help] [--cx-items <cx item>] [--portal-version <version>]
    [--cx-version <version>] [--applications <applications>] [projec]
```

# DESCRIPTION

The bb-ang command gives additional ability to the standard "ng" CLI for
Backbase applications and libraries.

The standard ng command doesn't provide a solution for packaging reusable Angular
libraries, and for this reason we provide the "bb-ang package-libs" command. This
command wraps the well-known "ng-packagr" command.

bb-ang also has the ability to create a provision package of your App, which can
be imported into a Backbase Experience Catalog, where you can manage your Angular
app.

# OPTIONS

| Option | Description |
| ------ | ----------- |
| -v, --version | output the version number |
| --help | Output usage information |

# COMMANDS

## NAME

bb-ang package-libs - Transpile your libraries to Angular Package Format.

## SYNOPSIS

```bash
bb-ang package-libs [--help] [projec]
```

## EXAMPLES

Run the command:

```bash
  $ bb-ang package-libs
```


## NAME

bb-ang package-apps - Build Angular apps into a Backbase Provisioning Package.

## SYNOPSIS

```bash
bb-ang package-apps [--help] [--node-deps-scope <npm scope>] [--configuration <configuration>]
    [--dev] [--ts-config <ts config>] [--output-hashing]
    [--build-memory <mb>] [--serial-build] [--catalog-root <root path>]
    [--portal-version <version>] [--cx-version <version>] [--applications <applications>]
    [--extend-container] [projec]
```

## DESCRIPTION

> :warning: **Starting from v4.3.3**, the resulting Backbase Provisioning Package doesn't include any **Feature items** of the Object Model.

## OPTIONS

| Option | Description |
| ------ | ----------- |
| --node-deps-scope &lt;npm scope&gt; | Models from the node_modules in this NPM scope will be included in the package |
| --configuration &lt;configuration&gt; | Use the specified configuration (default: "production") |
| --dev | Package app for development (overrides --configuration).This option is deprecated. It doesn't make sense to package your application for development. |
| --ts-config &lt;ts config&gt; | Use a specified ts-config file for the build |
| --output-hashing | Enable output hashing for cache busting of built js/css |
| --build-memory &lt;mb&gt; | Amount of memory to allocate to node for running "ng build" (MB set via node's --max_old_space_size) |
| --serial-build | Build apps in serial instead of parallel to reduce CPU and memory footprint |
| --catalog-root &lt;root path&gt; | Static resources path root (default: "$(staticResourcesRoot)/static/items") |
| --portal-version &lt;version&gt; | Version of CX being used |
| --cx-version &lt;version&gt; | Alias for portal-version |
| --applications &lt;applications&gt; | Comma separated list of applications to be built |
| --extend-container | Add ability to extend application template and model |
| --help | Output usage information |

## EXAMPLES

Run the command:

```bash
  $ bb-ang package-apps
```


## NAME

bb-ang copy-assets - Command to find and copy all the assets to the build directory

## SYNOPSIS

```bash
bb-ang copy-assets [--help] [--dist <dist folder path>] [projec]
```

## OPTIONS

| Option | Description |
| ------ | ----------- |
| --dist &lt;dist folder path&gt; | Use a specified folder for items while serving |
| --help | Output usage information |

## EXAMPLES

Run the command:

```bash
  $ bb-ang copy-assets
```


## NAME

bb-ang combine-coverage - Combine all coverage reports generated by ng test into a single report

## SYNOPSIS

```bash
bb-ang combine-coverage [--help] [--dist <dist folder path>] [--reporters <reporters>] [projec]
```

## DESCRIPTION

This command will find all applications and libraries from the angular.json in
the [project root], that have a "test" architect with the "codeCoverage" option
set to true.

The reports that are already generated *must* include a *json* report. The *json*
report should be found in the coverage directory and be named *coverage-final.json*.

The coverage directory **is assumed** to be called *coverage*, and be in the
*root* of the application/library (as specified in the angular.json).

Check your karma.conf.js to ensure:
 1. The *json* report is being created
 2. The report is generated in the %library root%/coverage/


## OPTIONS

| Option | Description |
| ------ | ----------- |
| --dist &lt;dist folder path&gt; | Output coverage to the given directory (default to coverage) |
| --reporters [reporters] | Comma separated list of coverage reporters. Possible values: text-summary,html,lcov. |
| --help | Output usage information |

## EXAMPLES

Run the command:

```bash
  $ bb-ang combine-coverage
```

Change the output dir:

```bash
  $ bb-ang combine-coverage --dist my-coverage
```


## NAME

bb-ang check-api - Ensure public APIs are not accidentally broken.

## SYNOPSIS

```bash
bb-ang check-api [--help] [--lib <lib>] [--report-folder <report-folder>] [projec]
```

## OPTIONS

| Option | Description |
| ------ | ----------- |
| --lib &lt;lib&gt; | Only extract the API for this library. |
| --report-folder &lt;report-folder&gt; | where we can check library API. |
| --help | Output usage information |

## EXAMPLES

Run the command:

```bash
  $ bb-ang check-api
```

specify library to be check:

```bash
  $ bb-ang check-api --lib my-library
```

where we can check library API:

```bash
  $ bb-ang check-api --report-folder ./apis
```


## NAME

bb-ang extract-api - Extract public APIs from your libraries and generate a report.

## SYNOPSIS

```bash
bb-ang extract-api [--help] [--lib <lib>] [--report-folder <report-folder>] [projec]
```

## OPTIONS

| Option | Description |
| ------ | ----------- |
| --lib &lt;lib&gt; | Only extract the API for this library. |
| --report-folder &lt;report-folder&gt; | The place to extract library API. |
| --help | Output usage information |

## EXAMPLES

Run the command:

```bash
  $ bb-ang extract-api
```

specify library to be extract:

```bash
  $ bb-ang check-api --lib my-library
```

specify the place to extract library API.:

```bash
  $ bb-ang extract-api --report-folder ./apis
```


## NAME

bb-ang build-apps - Build Angular apps.

## SYNOPSIS

```bash
bb-ang build-apps [--help] [--configuration <configuration>] [--node-deps-scope <npm scope>]
    [--ts-config <ts config>] [--output-hashing] [--build-memory <mb>]
    [--serial-build] [--catalog-root <root path>] [--applications <applications>]
    [--portal-version <version>] [--cx-version <version>] [projec]
```

## DESCRIPTION

> :warning: **Starting from v4.3.3**, the resulting Backbase Provisioning Package doesn't include any **Feature items** of the Object Model.

## OPTIONS

| Option | Description |
| ------ | ----------- |
| --configuration &lt;configuration&gt; | Use the specified configuration (default: "production") |
| --node-deps-scope &lt;npm scope&gt; | Models from the node_modules in this NPM scope will be included in the build |
| --ts-config &lt;ts config&gt; | Use a specified ts-config file for the build |
| --output-hashing | Enable output hashing for cache busting of built js/css |
| --build-memory &lt;mb&gt; | Amount of memory to allocate to node for running "ng build" (MB set via node's --max_old_space_size) |
| --serial-build | Build apps in serial instead of parallel to reduce CPU and memory footprint |
| --catalog-root &lt;root path&gt; | Static resources path root (default: "$(staticResourcesRoot)/static/items") |
| --applications &lt;applications&gt; | Comma separated list of applications to be built |
| --portal-version &lt;version&gt; | Version of CX being used |
| --cx-version &lt;version&gt; | Alias for portal-version |
| --help | Output usage information |

## EXAMPLES

Run the command:

```bash
  $ bb-ang build-apps
```


## NAME

bb-ang create-provisioning-package - package Angular apps into a Backbase Provisioning Package.

## SYNOPSIS

```bash
bb-ang create-provisioning-package [--help] [--cx-items <cx item>] [--portal-version <version>]
    [--cx-version <version>] [--applications <applications>] [projec]
```

## OPTIONS

| Option | Description |
| ------ | ----------- |
| --cx-items &lt;cx item&gt; | Comma separated list of directories, models from this directories will be included in the package |
| --portal-version &lt;version&gt; | Version of CX being used |
| --cx-version &lt;version&gt; | Alias for portal-version |
| --applications &lt;applications&gt; | Comma separated list of applications to be packaged |
| --help | Output usage information |

## EXAMPLES

Run the command:

```bash
  $ bb-ang package-apps
```


# ENVIRONMENT VARIABLES

Set the amount of log output
```bash
LOG_LEVEL=silly|verbose|info|warn|error
```

Set whether or not to use colors in output
```bash
COLOR=false|true
```