Adds Nightwatch to an existing Angular CLI project

Usage no npm install needed!

<script type="module">
  import nightwatchSchematics from 'https://cdn.skypack.dev/@nightwatch/schematics';


Nightwatch Schematics

Node CI npm package

Fast and easy installation of Nightwatch into your projects

Framework & Language Supported: Angular | React | Vue | Typescript

Nightwatch.js Schematic Logo

This project is a Schematics implementation that allows you to easily integrate Nightwatch into your Angular, React, Vue, Typescript projects.

This Schematic will:

๐Ÿ—๏ธ Install Nightwatch, and it's dependencies
โš™๏ธ Add NPM scripts for running Nightwatch tests
๐Ÿ“ฆ Scaffold base Nightwatch config and test files
โ“ Prompt for removal of Protractor files and configuration


โœจ Demo

Nightwatch Schematics Demo

๐Ÿš€ Usage

Run as one command in an Angular CLI app directory. Note this will add the schematic as a dependency to your project.

ng add @nightwatch/schematics

One can provide following options: | Option | Description | |-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | noBuilder | This will skip the builder addition, leaving the angular.json file unmodified and requiring you to run Nightwatch from the command line or through your IDE. Include --noBuilder in your ng add command. |

With the custom builder installed, you can run Nightwatch with the following commands:

ng e2e
ng run {your-project-name}:nightwatch-run

These two commands do the same thing. They will run nightwatch e2e tests.

Once Nightwatch is added to your project, all Nightwatch CLI options will be available when triggering e2e tests. E.g.: --verbose, --retries etc.


๐Ÿšง Currently, React is not fully supported, but we are working on it.

One can still add Nightwatch to the React projects, please follow Nightwatch get started guide.


Vue Cli have plugin @vue/cli-plugin-e2e-nightwatch which can be used to install Nightwatch in Vue projects.


โœจ Demo

Nightwatch Schematics Demo

๐Ÿš€ Usage

Install Schematics CLI globally

npm install -g @angular-devkit/schematics-cli

Install Nightwatch-schematics in your project

npm install @nightwatch/schematics

Run following command to install Nightwatch in your project:

schematics @nightwatch/schematics:ng-add

Once Nightwatch is added to your project, all Nightwatch CLI options will be available when triggering e2e tests. E.g.: --verbose, --retries etc. One can update e2e:test to include cli options.

๐Ÿ› Issues

Issues with this schematic can filed here

If you want to contribute (or have contributed in the past), feel free to add yourself to the list of contributors in the package.json before you open a PR!


How do I update @nightwatch/schematics package?

This command will update nightwatch schematic package

npm update @nightwatch/schematics

Where can I ask for help and report bugs?

The best way to ask for help and to report bugs is to open an issue.

Gitter is another option.

I created new angular project, how do I remove Protractor and install Nightwatch?

It's very simple, you just have to run ng add @nightwatch/schematics command, and it will prompt you to remove Protractor from angular project.

How do I run on another browser that was initially selected in angular app?

All you have to do is install the relevant drivers, and replace env value (Check the column names in the table below) env-name in angular.json. The config in angular.json will look like this.

  "nightwatch-run": {
    "builder": "@nightwatch/schematics:nightwatch",
    "options": {
      "devServerTarget": "angularapp:serve",
      "tsConfig": "../nightwatch/tsconfig.e2e.json",
      "config": "./nightwatch.conf.js",
      "env": "<env-name>"
    "configurations": {
      "production": {
        "devServerTarget": "angularapp:serve:production"
  "e2e": {
    "builder": "@nightwatch/schematics:nightwatch",
    "options": {
      "devServerTarget": "angularapp:serve",
      "tsConfig": "../nightwatch/tsconfig.e2e.json",
      "config": "./nightwatch.conf.js",
      "env": "<env-name>"
    "configurations": {
      "production": {
        "devServerTarget": "angularapp:serve:production"

How do I run on another browser that was initially selected in typescript project?

In package.json, you will find e2e:test in the scripts, and change env value. To change the value, You can refer below table

  "e2e:test": "./node_modules/.bin/tsc -p ./nightwatch/tsconfig.e2e.json && ./node_modules/.bin/nightwatch --env '<env-name>' --config './nightwatch.conf.js"

How to run e2e tests using npm?

Projects command
Angular App npm run e2e
Typescript Project npm run e2e:test


Drivers available to install

Name driver command
chrome chromedriver npm install chromedriver --save-dev
firefox geckodriver npm install geckodriver --save-dev
selenium-server selenium-server npm install selenium-server --save-dev

๐Ÿ‘ฉ๐Ÿฝโ€๐Ÿ’ป Development

Getting Started

๐Ÿ› ๏ธ Node.js and npm are required for the scripts. Make sure it's installed on your machine.

โฌ‡๏ธ Install the dependencies for the schematic and the sandbox application

npm i && cd sandbox && npm i && cd ..

๐Ÿ–‡ Link the schematic in the sandbox to run locally

npm run link:sandbox

๐Ÿƒ Run the schematic

npm run build:clean:launch

๐Ÿงช E2E Testing

Execute the schematic against the sandbox. It will add Nightwatch config, tests, and custom builder, then run e2e tests in the sandbox.

npm run test

๐Ÿงช Unit Testing

Run the unit tests using Jasmine as a runner and test framework

npm run build:test
npm run test:unit

โ™ป๏ธ Reset the Sandbox

Running the schematic locally performs file system changes. The sandbox is version-controlled so that viewing a diff of the changes is trivial. After the schematic has run locally, reset the sandbox with the following.

npm run clean

These projects: @briebug/cypress-schematic, schuchard/prettier-schematic helped us in development of this project. Thank you!