Angular NES Trial Configuration - HeroDevs Never-Ending Support

Introduction

The HeroDevs NES team is proud to offer an integration trial for Angular NES!

This trial version is simply a repackaging of the OSS @angular/core module to demonstrate how Angular NES is a drop-in replacement for the OSS Angular we all know and love. As such it is not production ready and does not contain any fixes.

Available Trial Versions

8.2.14-trial-core
10.2.5-trial-core
11.2.14-trial-core
12.2.17-trial-core
13.4.0-trial-core
14.3.0-trial-core
15.2.10-trial-core

Minimum Requirements

Please review our Minimum Requirements to ensure a smooth installation. Then follow 3 easy steps:

Update your package.json
Create or update your .npmrc file
Install & Run!

Detailed Instructions

Update Your package.json

Substitute the @angular/core references in your package.json with the following:

package.json

{
  "dependencies": {
    "@angular/core": "npm:@neverendingsupport/angular@1.2.3-trial-core",
    // ...etc.
  },
  "overrides": {
    "@angular/core": { ".": "npm:@neverendingsupport/angular@1.2.3-trial-core" },
    // ...etc.
  }
}

Note

The version represented above (1.2.3) is a placeholder for the version you are installing

Angular Tools for Angular v9-12

If you are using Angular v9, v10, v11, or v12, include our angular-tools library in your package.json:

package.json

{
  "scripts": {
    "postinstall": "npx ngnes",
    // ...etc.
  },
  "devDependencies": {
    "@neverendingsupport/angular-tools": "1.1.3",
    // ...etc.
  }
}

The @neverendingsupport/angular-tools package has tools required for successfully installing and operating Never-Ending Support in these versions of Angular.

Note

Please be sure to include the postinstall script, which automatically will run "npx ngnes" on install. This command in made available by the @neverendingsupport/angular-tools package. If postinstall scripts are disabled, you will need to run "npx ngnes" immediately after every install and before running "ng build".

Create The .npmrc

Replace <NES_ACCESS_TOKEN> with either your access token or a valid email

.npmrc

@neverendingsupport:registry=https://registry.nes.herodevs.com/npm/pkg/
//registry.nes.herodevs.com/npm/pkg/:_authToken=<NES_ACCESS_TOKEN>

Note

Using Artifactory? See our Artifactory Instructions for setup and configuration details.

Install your dependencies

Install your dependencies, then build and run the service:

npm install
npx ng serve

And just like that, you're up and running with the Angular NES Trial!

Build Failures

If your build fails with a typing incompatibility error, this is a known issue related to the Angular Compatibility Compiler (ngcc) and initial compilation. While our angular-tools library should address this automatically upon installation, it can fail if postinstall scripts are disabled or packages are installed manually.

If you encounter this error, follow these steps:

Backup your project
Remove your project's entire node_modules/ folder:

rm -rf ./node_modules

This is required as ngcc actually edits packages in the node_modules/ folder.

Install dependencies again:

npm install

Run our tooling before building:

npx ngnes

Build and run your project:

npx ng serve

Installation Issues

If your NPM install fails, packages aren't being replaced, or you encounter other issues, please contact support@herodevs.com with:

Relevant sections of your package.json (applicable dependencies & overrides blocks)
Node.js and NPM versions (gather using node -v and npm -v)
Last 6 characters of your NES Access Token

Security Note

Please do not ever share your full NES Access Token. No one from the NES team should ever ask for an entire token, even for troubleshooting purposes

Security Note

Please do not include any sensitive or otherwise confidential information in your email.