Introduction

Publishing custom components in Pega Constellation requires installing and configuring several software tools. This guide provides a step-by-step approach to setting up the required environment efficiently.

1. Install Node.js

Node.js includes both Node and npm (Node Package Manager) executables.

• Download and install Node.js from: Node.js Download
• After installation, restart your machine.

2. Install Visual Studio Code

• Download and install Visual Studio Code from: VS Code Download
• Restart your machine after installation.

3. Configure Environment Variables

Step 1: Locate Node.js Installation Path

1. Navigate to the path where Node.js is installed.
2. Right-click on node.exe and select Open File Location.
3. Copy the file path (e.g., C:\Program Files\nodejs).

Step 2: Add Node.js Path to Environment Variables

• Search for “Edit the system environment variables” in Windows.
• Click on “Environment Variables” and select “Edit”.

• Click “New” and add the copied Node.js path.

• Click OK on all open dialogs.

Step 3: Add npm Path to Environment Variables

1. Navigate to: C:\Users\YourSystemName\AppData\Roaming.
2. If the npm folder exists, copy the file path.
3. Open “Edit Environment Variables” and add the npm path.

Run below command in VS to confirm node version.
node -v

Run below command in VS to confirm npm version.

npm -v

If the npm folder does not exist, execute the following commands in Visual Studio Code:

If you receive an error, run the following commands one by one:set-ExecutionPolicy RemoteSigned -Scope CurrentUser

Get-ExecutionPolicy

Get-ExecutionPolicy -list

Re-run npm -v to confirm installation.

4. Install Git

• Download and install Git (Version 2.30 or later) from: Git Download

• Copy the installed file path (e.g., C:\Program Files\Git\cmd).
• Add this path to “Edit Environment Variables” as done for Node.js and npm.

5. Verify Installation

Restart the command line or Visual Studio Code and execute:

node -v

npm -v

If the issue persists, restart your system and re-run the commands.

References

1. Initializing a Pega Constellation Project
2. Pega Constellation UI Gallery on GitHub