๐ง๐ต๐ถ๐ป๐ธ ๐ถ๐ป๐๐๐ฎ๐น๐น๐ถ๐ป๐ด ๐๐ต๐ฒ ๐ฃ๐ฒ๐ด๐ฎ ๐๐ผ๐ป๐๐๐ฒ๐น๐น๐ฎ๐๐ถ๐ผ๐ป ๐ฅ๐ฒ๐ฎ๐ฐ๐ ๐ฆ๐๐ ๐ถ๐ ๐ท๐๐๐ ๐ฎ๐ฏ๐ผ๐๐ ๐ฟ๐๐ป๐ป๐ถ๐ป๐ด npm install?
It isnโt.
If you get the foundation wrong, you may spend hours debugging problems that are actually version and dependency issues.
When starting with the Pega Constellation React SDK, developers often focus on:
git clone
โ
npm install
โ
npm start
And thenโฆ
Peer dependency errors
ERESOLVE could not resolve
TypeScript errors
Missing Pega packages
ConstellationJS runtime issues
SDK and Pega version mismatches
The problem is that the SDK has a specific dependency ecosystem.
For Pega 24.2.x, the learning guide aligns the SDK to the release/24.2.11 branch and React 17.0.2.
One wrong version can create problems much later in the development journey.
For example:
Wrong SDK version
โ DX API mismatch
โ ConstellationJS runtime issues
โ Component registration problems
Wrong Node/npm combination
โ npm install failures
โ Peer dependency conflicts
โ React dependency resolution problems
The document specifically highlights that using an SDK version that doesnโt match the Pega server version can lead to runtime errors, DX API mismatches and component registration failures.
And this is where many developers lose time.
They start debugging the componentโฆ
when the real problem is the environment.
The Solution
Before writing a single custom DX component, establish the SDK foundation correctly.
For a Pega 24.2.x setup, the document recommends verifying:
Node.js 18.12.1 or 18.13.0
npm 8.19.2 or 8.19.3
Git 2.30+
React 17.0.2
React SDK release/24.2.11
Required @pega packages
Correct TypeScript configuration
Correct SDK folder structure
The SDKโs package.json includes important packages such as:
@pega/constellationjs
@pega/react-sdk-components
@pega/react-sdk-overrides
@pega/auth
and the PCore/PConnect type definitions.
One important lesson
Donโt treat the React SDK as a standalone React project.
It is part of the larger Pega Constellation architecture we discussed in Phase 2.
Your installation needs to align with:
Pega Infinity version
โ
React SDK version
โ
Node/npm versions
โ
React version
โ
Pega SDK dependencies
Get these aligned first.
Then move to authentication and running the sample application.
๐ง๐ต๐ถ๐ ๐ถ๐ ๐ผ๐ป๐ฒ ๐ผ๐ณ ๐๐ต๐ผ๐๐ฒ ๐ฃ๐ฒ๐ด๐ฎ ๐๐ผ๐ป๐๐๐ฒ๐น๐น๐ฎ๐๐ถ๐ผ๐ป ๐น๐ฒ๐ฎ๐ฟ๐ป๐ถ๐ป๐ด ๐๐๐ฒ๐ฝ๐ ๐๐ต๐ฒ๐ฟ๐ฒ ๐ด๐ฒ๐๐๐ถ๐ป๐ด ๐๐ต๐ฒ ๐ฏ๐ฎ๐๐ถ๐ฐ๐ ๐ฟ๐ถ๐ด๐ต๐ ๐๐ฎ๐๐ฒ๐ ๐ต๐ผ๐๐ฟ๐ ๐น๐ฎ๐๐ฒ๐ฟ.