How to develop, consume, and publish an Angular library to NPM

Some more examples:37574 -> 37.

5K1222130 -> 1.

2M12414770 -> 12.

4M19121364128 -> 19.

1BSetting up the ProjectWe will be using Angular CLI as a base to our development as it’s more convenient than cloning the Angular Repo from Github.

Plus we will be benefiting from the scaffolding and auto generation of modules, components and pipes.

*Later, we will use this same project for the development of our component and pipes and will also use it as a Sandbox to test our Library.

Let’s start by installing the CLI globally and then initiating the Project.

npm install @angular/cli -gng new ng-number-formatterNow that we have a basic structure of the project, we can navigate to the project folder “ng-number-formatter” and serve the Project.

ng serve // Navigating to `localhost:4200`Initiating the Modules/Components for the LibraryNow that our most simple Angular App is up and running, let’s add our custom modules and components to format numbers in a human readable format.

ng generate module modules/ng-number-formatterng generate component modules/ng-number-formatterThis auto-generation will create the mandatory files for the development of Angular Modules.

In our case, these independent modules are meant to be isolated from each other so that we can export them as stand-alone Angular Libraries.

It’s also good practice to make each module decoupled from every other just like the concept of MicroServices.

Modules in Angular can be considered as configuration files that will help reference our components to be a part of an Angular Project.

These Modules are based on Components which actually makes our application productive and gets it up and running.

Number Formatter ModuleThis Module file is self expressive and in it we can see the declarations and exports of our library.

@NgModule({ imports: [ CommonModule ], declarations: [ NgNumberFormatterComponent ], exports: [ NgNumberFormatterComponent ]})Number Formatter TemplateNow open the ng-number-formatter.


html file within the app/modules/ng-number-formatter folder and add the required Html span Tag.

For the sake of styling, we can manipulate the content of the ng-number-formatter.


css file, but for now we will ignore that and let things stay as simple as possible.

<span>{{ngNumber}}</span>Here, the variable ngNumber is defined within the associated ng-number-formatter.


ts component.

As we will be getting the number in a string format from some parent component (in our case that would be app.


ts — we will show how these components are linked), we will format that number in into human readable format with our ng-number-formatter.



Then we will display it via the Html template to which we just added a Span Tag.

Number Formatter ComponentOpen the ng-number-formatter.


ts file within the same app/modules/ng-number-formatter folder.

You can see that there’s already basic code present for the Component.

The template which we just modified is already linked in our component.

@Component({ selector: 'ng-number-formatter', inputs: ['ngNumber'], templateUrl: '.



html', styleUrls: ['.



css']})Here, selector: 'ng-number-formatter' is a custom tag which we, as the consumer of our library, will be needing to reference our Component.

Then inputs: ['ngNumber'] is with the two contexts.

In our “ng-number-formatter component” (the callee) it’s treated as a variable that will accept the incoming number string.

On the other hand in the “app.


ts” (the caller), it will be treated as a property to our selector which will send the value.

Then templateUrl: '.



html' and styleUrls: '.



css' are the ones linking the template.

Update the file with the required logic for the number conversion.

Next our template doesn’t need to be in a separate file.

So we can remove that and directly embed it to our component as template: '<span>{{ngNumber}}</span>'.

The following Gist shows the complete contents of our component.

Compare the changes which you made and then we will proceed to the next steps.

Consuming the Angular Component LibraryTo consume any Angular Library, first you need to get referenced within the Module and then the usage of its selector ng-number-formatter (as mentioned in our component’s selector tab) in the template.

There’s only one difference when consuming a third party library in a project and when used as a sandbox.


Since our library is not yet published and listed in the NPM Directory, we need its full path to reference within the Module.

import { NgNumberFormatterModule } from '.



And when our library gets published and listed in the NPM Directory, it will be with a much simpler reference link.

Like this:import { NgNumberFormatterModule } from 'ng-number-formatter';And here’s our custom Tag to consume our brand new library:<ng-number-formatter [ngNumber]="12414770"></ng-number-formatter>// Resulting number into the Format much more convenient "1.

2M"Packaging and Publishing it to the NPMNow that we have our independent Module developed and tested within the Sandbox project, we are good to go.

First of all, the good part is that this Module is so simple and minimal in nature that it doesn’t have any other dependencies.

Second, it’s good that our module is totally isolated and is easily plugged to the our component in the sandbox which makes it ready to be separately packaged and published.

The next step is to make it open to the world so others can download and use it to format numbers in their Angular Applications.

To get started with the packaging and publishing of our Number Formatting Module, we need a Packager that will transform this Module into a Library identifiable as an NPM Package.

For that we choose “ng-packagr” which Transpiles your libraries to Angular Package Format.

It is an NPM Package built as a wrapper over “Roll-Up” which is a module bundler that compiles code into Libraries and Applications.

Now let’s continue with our development process by installing our packager within the context of our Sandbox Project.

We will be saving it as a dev-dependency as we only need to compile our module as a Library identifiable to NPMjs.


npm install ng-packagr –save-devThe next step is to add two files manually in our project directory, namely ng-package.

json and public_api.



json is to configure ng-packgr and point out the public_api.

ts file to get ready for the packaging.

Here’s the content:{ "$schema": ".



json", "lib": { "entryFile": "public_api.

ts" }}public_api.

ts is the file that will be composed of one single line exporting the recently developed Angular Module.

export * from '.


module'Once the two files are created, we will register the ng-packagr command in the package.

json file of our Application Project and will also toggle the property "private": false for the NPM Directory.

Go ahead and update your files so that we can continue for the publication.

"scripts": { "ng": "ng", "start": "ng serve", "build": "ng build", "test": "ng test", "lint": "ng lint", "e2e": "ng e2e", "packagr": "ng-packagr -p ng-package.

json"},"private": falseNow that ng-packagr is registered as a command, we can continue packing our module as a package recognizable for NPM Directory.

This compiles our TypeScript-based Module into executable JavaScript in the dist folder.

Next we navigate to the dist folder and run the final packaging as a standalone component library.

npm run packagrcd distnpm packThat’s all on your local machine — now is the time to make it public.

For that we need an account on https://www.



Go ahead and signup and then we will run the last two commands for our Library to be publicly available ????.

Login to NPM via Terminal / Command Line Tool:npm loginPublish to NPM:npm publishViollllàaaaaaaaaaaaaaaaaaaaaaaaa!!!ng-number-formatterAngular Number Formatter — formats the number into human readable format when in Thousands, Millions and Billions.



comYour package is up and available just like this one of mine.

 :)How others will consume your Library within their ProjectThis will happen the same way as in our app.


ts file of our Sandbox Project, but in fact it’s a bit simpler.

We only need the simplest module referencing directly with the name.

The following three steps need to be executed one after another: Installation, Importing the Module, using the Selector.

// Installationnpm install ng-number-formatter –save// Importing the Moduleimport { BrowserModule } from '@angular/platform-browser';import { NgModule } from '@angular/core';import { AppComponent } from '.


component';import { NgNumberFormatterModule } from 'ng-number-formatter';@NgModule({ declarations: [ AppComponent ], imports: [ BrowserModule, NgNumberFormatterModule ], providers: [], bootstrap: [AppComponent]})export class AppModule { }// Selector<ng-number-formatter [ngNumber]="1222130"></ng-number-formatter>For more, find the “ng-number-formatter” Package in the NPM Directory!ng-number-formatterAngular Number Formatter — formats the number into human readable format when in Thousands, Millions and Billions.



comAnd the code with in the “Sandbox Project” on Github!DynamicRemo/ng-number-formatterng-number-formatter — Angular Number Formatter Librarygithub.

comAngular Pipes, and when to use them as an alternativeNow that we’ve got all that done, let’s move on to the second part of the article.

First we’ll consider the need for Pipes in Angular Applications, and then we will convert the NG Number Formatter Library into a Number Formatter Pipe.

The | symbol near the Enter Key on the KeyboardWhat is a pipe?.Pipe is a simple representation “ | ” within the template of any Module in the Angular Application.

Pipes are usually dedicated to perform simple tasks: the most common of them all is the formatting of timestamps or Unix version Date into human readable Date as Day/Month/Year format.

Such as the following:1533679976 into 08/07/20181533679976 into Tue, 07 Aug 2018The way this is done is inside the HTML Tag.

For example:<span> {{ 1533679976 | date }} </span>The separator “ | ” will force Angular to interpret the inner html of the Span Tag before rendering it to the screen.

Pipes are preferred over Modules in certain scenarios because of the cost of JavaScript.

This cost is in regards to memory size, download time, latency, time to render elements and time taken before the interactivity of the page starts.

These are just a few things to be considered when you have a JavaScript intensive Web Application / Website.

Third-Party Libraries can be heavy, loaded with dozens of other dependencies (like libraries based on other libraries) which can pull your application down.

This can affect your Google search rankings as well, as time taken to page-load is still one of the major metrics for calculating your Search Index on Google Search.

In the context of the Ng-Number-Formatter Library, the library is already compressed and is in its minimal form available without any external dependencies.

Therefore, if you have an alternative Pipe for this, it would also be almost of the same size on the disk.

You can go to your Project folder in which you have consumed npm install ng-number-formatter –save and check that the total size of the library with in the node_modules folder is around 70 KB including the sandbox testing environment.

Before starting the actual tutorial for the Angular Number Formatter Pipe, I would like to note that you should know your dependencies well, before choosing any third party add-on or plug-in.

Then, when integrating them into your project, you can plan accordingly.

NPM Package with lots of dependent Packages is kind of a burden.

 ImageAngular Number Formatter PipeAs of now, we all know the flow of an Angular Application.

Thus, this last part is just a skim over the topic as a Cheat Sheet with the Terminal Commands and minimum required Code for the Angular-Number-Formatter-Pipe!We’ll get started with the scaffolding command for the generation of Pipes, then we will register and import our newly generated Pipe to the Parent Component.

Finally, we’ll use it in our Template.

 *as of here… implementation is expressive enough.

Cheers!// Generating Pipeng generate pipe pipes/angular-number-formatter// Importing into Moduleimport { BrowserModule } from '@angular/platform-browser';import { NgModule } from '@angular/core';import { AppComponent } from '.


component';import { AngularNumberFormatterPipe } from '.


pipe';@NgModule({ declarations: [ AppComponent, AngularNumberFormatterPipe ], imports: [ BrowserModule ], providers: [], bootstrap: [AppComponent]})export class AppModule { }and finally using the Number Formatter Pipe in the Template:<span> {{ 1533679976 | angularNumberFormatter }} </span>That’s all for this article!.I hope this helps and lets you publish dozens of Libraries and tons of pipes for the community.

You can find me @ok_ansari.

Cheers, Omer Kalim Ansari.

. More details

Leave a Reply