A Pega Constellation story · Pega 24.2, 25.1 & 26.1
Pega
Constellation
design & workflow.
Learn to design and build any custom component for Pega, even if you have never opened Pega. Install the tools, follow one button from idea to a real screen, then build your own.
The whole workflow
Eight stages, one road.
Stage 2 of 8 · Learn
Learn
Get the ideas and the tools
Make
Create and preview on your laptop
Ship
Check it, send it, use it
Your laptop · Chapters 05-06
“What do I install?”
Run this
$npm ci- You do
- Install Git, Node.js and VS Code, fetch the project, and sign in to your Pega server.
- You end up with
- A working workshop on your own computer.
- Done when
- node -v, git --version and npm ci all work.
LearnGet the ideas and the tools
Your laptop · Chapters 05-06
“What do I install?”
Run this
$npm ci- You do
- Install Git, Node.js and VS Code, fetch the project, and sign in to your Pega server.
- You end up with
- A working workshop on your own computer.
- Done when
- node -v, git --version and npm ci all work.
MakeCreate and preview on your laptop
ShipCheck it, send it, use it
Where to begin
Start where you are.
Play
Things you can poke.
Each one opens the guide at the exact spot, so you can try it straight away.
- OverviewEight stages, one roadWalk the whole journey from idea to a live component, and press play to watch it run.Try it
- SetupToolkit installerPick Windows, macOS or Linux and get the exact commands for Git, Node and VS Code.Try it
- ConceptsOne round tripFollow a single click to Pega and back as a sequence diagram, with the message at every step.Try it
- BuildComponent studioDesign any kind of custom component and watch its starter files appear.Try it
- ReferenceParameter workbenchType what an author would type and see exactly what a data page call sends, or why it stops.Try it
- ToolingDeployment hub demoA working, simulated publish tool with the real step names and a locked-ruleset case.Try it
How this is different
Documentation lists. A story leads.
The official docs are accurate and complete, and very hard to learn from when you are new. This guide takes one small goal, a working button, and introduces each idea at the moment you need it.
No jargon without a translation
Every technical word has a plain meaning. Hover or tap the dotted words.
Things you can poke
Each chapter has something to click, drag or break. Reading is optional; playing is not.
Every step, to the very end
Setup, building, running Storybook, testing, publishing, and using it inside Pega.
The road ahead.
Show all 23 chapters
- 01The restaurant
- 02Constellation
- 03The parts of a screen
- 04Custom DX components
- 05Your workshop
- 06Signing in
- 07Scaffold
- 08Build the button
- 09Storybook
- 10Tests
- 11Build and publish
- 12Use it in Pega
- 13When it breaks
- 14Cheat sheet
- 15Build anything
- 16The Pega API
- 17Pattern catalogue
- 18The Deployment Hub
- 19The playbook
- 20Data page calls
- 21Tables, grids and search
- 22Inside the components
- 23API reference
For your AI coding agent
Teach your agent Constellation.
The guide is also packaged as a skill: short instructions an AI coding agent reads before it builds a custom component. One command puts it in any project.
Install the skill. It goes into .claude/skills if your project uses Claude Code, otherwise into .agents/skills, and AGENTS.md points your agent at it.
npx @sanjeevsaniel/pega-constellation-skills init --agents
Update later
npx @sanjeevsaniel/pega-constellation-skills update
Remove
npx @sanjeevsaniel/pega-constellation-skills remove --agents
npm i on its own only downloads the package. Run init to copy the skill. Choose the folder with --target claude or --target agents, and preview with --dry-run. Needs Node 18 or newer.
Instructions only, no Pega source code. Independent project, not affiliated with Pegasystems. On npm · On GitHub
Before you start
One story. Three Pega versions.
Pega releases new versions, and the tools that build custom components move with them. This story follows Pega 26.1, covering Pega Infinity versions 24.2, 25.1, and 26.1. Where versions behave differently you will see a small “Which Pega version?” note.
The rule of thumb: match the builder tools to the Pega server you publish to.
| Pega | DX builder tag | Builder version | cosmos-react | typedefs |
|---|---|---|---|---|
| 26.1tested on 26.1.2 | release-26.1 | 26.1.11 | 9.29.0 | 5.1.1 |
| 25.1tested on 25.1.4 | release-25.1 | 25.1.26 | 8.34.4 | 4.1.4 |
| 24.2tested on 24.2.5 | release-24.2 | 24.2.21 | 7.17.3 | 3.2.5 |
Versions come from the builder's npm release tags. “Tested on” is the exact Pega build the components in this guide were tried against. Check your own server's version before you pick tools.
Your turn
Questions and comments
Stuck on something, or have a thought? Write it here. To talk about one part, use the Comment button under that section's heading.