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.

Begin the story →23 short chapters · no prior knowledge needed

The whole workflow

Eight stages, one road.

LearnGet the ideas and the tools

  1. 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.

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.

1

No jargon without a translation

Every technical word has a plain meaning. Hover or tap the dotted words.

2

Things you can poke

Each chapter has something to click, drag or break. Reading is optional; playing is not.

3

Every step, to the very end

Setup, building, running Storybook, testing, publishing, and using it inside Pega.

The road ahead.

Show all 23 chapters
  1. 01The restaurant
  2. 02Constellation
  3. 03The parts of a screen
  4. 04Custom DX components
  5. 05Your workshop
  6. 06Signing in
  7. 07Scaffold
  8. 08Build the button
  9. 09Storybook
  10. 10Tests
  11. 11Build and publish
  12. 12Use it in Pega
  13. 13When it breaks
  14. 14Cheat sheet
  15. 15Build anything
  16. 16The Pega API
  17. 17Pattern catalogue
  18. 18The Deployment Hub
  19. 19The playbook
  20. 20Data page calls
  21. 21Tables, grids and search
  22. 22Inside the components
  23. 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.

Terminal

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.

PegaDX builder tagBuilder versioncosmos-reacttypedefs
26.1tested on 26.1.2release-26.126.1.119.29.05.1.1
25.1tested on 25.1.4release-25.125.1.268.34.44.1.4
24.2tested on 24.2.5release-24.224.2.217.17.33.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.

3–20 letters, digits, _ or -. Kept in this browser so you are not asked again.

0/1000

A hands-on guide by Sanjeev Kujur. Independent, and not affiliated with or endorsed by Pegasystems.

Covering Pega Infinity versions 24.2, 25.1, and 26.1 · Updated 5 Nov 2026