@impartner/nx-angular

This package is an Nx plugin that offers a collection of code generators and task executors to help facilitate development of Angular-based applications for Impartner, Inc. and its platforms. This plugin may be used to help create new Nx monorepos and projects or be added to existing ones.

This plugin's code generators create and extend projects using the Impartner library packages listed below. For additional information, please consult their documentation.

• @impartner/angular-sdk
• @impartner/angular-apps
• @impartner/design
• @impartner/design-components

Getting Started

• If working with an existing Nx monorepo workspace:
  1. Install @impartner/nx-angular from npm.
  2. Run the @impartner/nx-angular:install generator to set up some recommended workspace defaults for building Impartner applications.
• If creating a new Nx workspace from scratch:
  1. Invoke the create-impartner-workspace create package via npx, which will generate a new Nx workspace using the @impartner/nx-angular:preset preset generator:
     npx create-impartner-workspace
     • If an alternative package manager would be used in the workspace, include the --packageManager argument followed by the name of the desired package manager (eg. npm, yarn, pnpm)
  2. Answer the prompts presented in the command line to finish initializing the workspace, including whether to create an initial Angular project and what kind.

Generators

@impartner/nx-angular:install

Installs core Impartner Angular SDK packages in the workspace, and optionally allows for configuration of default Prettier settings.

@impartner/nx-angular:preset

Installs core Impartner Angular SDK packages in the workspace, sets recommended default Prettier formatter settings, and offers a guided experience for creating an initial Impartner MicroFrontEnd (MFE) or Widget application using the other generators in the plugin.

@impartner/nx-angular:impartner-mfe-app

Creates a new Angular application in the workspace configured for build and deployment as an MFE on Impartner application hosts, including options for automatic configuration of i18next-based internationalization and custom application support for upload to Impartner's extensibility suite.

@impartner/nx-angular:impartner-widget-app

Creates a new Angular application in the workspace configured for build and deployment of widget web components to Impartner application hosts, including options for automatic configuration of i18next-based internationalization and and custom application support for upload to Impartner's extensibility suite.

@impartner/nx-angular:add-widget

Creates Angular components, interfaces, and constant definition values for a new Impartner widget in an existing project created with the @impartner/nx-angular:impartner-widget-app generator.

Note: Projects for custom Impartner widgets may only implement and expose one widget each.

Executors

@impartner/nx-angular:build-package

Does any additional processing (if required) of build artifacts for an Angular application or library project, and produces a new artifact ready for upload to package repositories or to Impartner's extensibility suite.