@impartner/nx-angular
v2.0.0
Published
Nx plugin for building Angular-based applications for Impartner.
Downloads
6
Maintainers
Keywords
Readme
@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.
Getting Started
- If working with an existing Nx monorepo workspace:
- Install
@impartner/nx-angular
from npm. - Run the
@impartner/nx-angular:install
generator to set up some recommended workspace defaults for building Impartner applications.
- Install
- If creating a new Nx workspace from scratch:
- Invoke the
create-impartner-workspace
create package vianpx
, 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
)
- If an alternative package manager would be used in the workspace, include the
- Answer the prompts presented in the command line to finish initializing the workspace, including whether to create an initial Angular project and what kind.
- Invoke the
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.