SDK-R v23.1.11 is only compatible with Pega Infinity '23 and is related to the release/23.1.11 branch of the React SDK repository.
Note: From SDK-R v23.1.11 onwards, the main branch will be the development branch for future versions or the latest version of Infinity.
The SDK-R v23.1.11 release upgrades the React version to React 17. This release allows React SDK users to to take advantage of the latest SDK enhancements and fixes. For more information, see What's New in SDK-R 23.1.11.
This React SDK updates page provides details about all of the React SDK releases.
The SDK-R v23.1.10 release is only compatible with Pega Infinity '23. This release is related to the release/23.1.10 branch of the React SDK repository.
(If you currently are using the React SDK with Pega Infinity 8.8, update your SDK to
the SDK-R v8.8.20 - release/8.8.20 branch.)
The SDK-R v23.1.10 and v8.8.20 releases allow React SDK users to to take advantage of the latest SDK enhancements and fixes. For more information, see What's New in SDK-R 23.1.10 and SDK-R 8.8.20.
- Added the use of TypeScript typedefs (from @pega/pcore-pconnect-typedefs) to SDK components. For more information, see Using type definitions
- Additional functionality including RichTextEditor and Dynamic Tabs components and many-to-many data reference support
- Updated Constellation Design System support to Cosmos 4 (for custom Constellation components).
- Enhanced security including token storage and item obfuscation support.
- Bug fixes.
- Full set of merged PRs can be found in the react-sdk-components GitHub repo list of merged PRs. This release includes all PRs since (and including) #166 and #230.
For more information about the react-sdk-components and react-sdk-overrides packages, and enhancements and bug fixes in the packages, click here.
IMPORTANT: Please follow the guidelines documented here if you are upgrading from a previous version of React SDK: Upgrading the SDK
If you want to continue using the previous release you can checkout release/8.8.10
The React SDK combined with Pega's client orchestration APIs provides a guided iterative development workflow experience that accelerates integrating Pega’s Constellation DX API with an alternative (non-Pega) UI. Integrating an alternative design system is achieved using DX Components.
A DX component contains logic and presentation tags to merge the alternate design system with Pega’s client orchestration APIs.
The alternative design system used in the React SDK is Material UI. For more information about Constellation SDKs, see the Constellation SDKs documentation.
A summary of the latest updates to the @pega/react-sdk-components and @pega/react-sdk-overrides used by the React SDK can be found in react-sdk-components KeyReleaseUpdates.md.
This version of the React SDK assumes that you have access to a Pega Infinity server (23.1.0+) running an application that is configured to run using the Constellation UI service. (If you need to use Infinity 8.8.x, please use the release/8.8.20 branch instead of the release/23.1.11 branch.)
The MediaCo sample application is already configured as a Constellation application and can be found in the React SDK download associated with this repo which is available at https://community.pega.com/marketplace/components/react-sdk. The OAuth 2.0 Client Registration records associated with the MediaCo application are available in the same React SDK download. For more information about the MediaCo sample application, see MediaCo sample application.
The React SDK has been tested with:
- node 18.12.1/18.13.0
- npm 8.19.2/8.19.3 - note: at this time, do not use npm 9
Future updates to the SDK will support more recent LTS versions of node as Constellation supports them.
Before installing and running the SDK code, refer to Downloading the Constellation SDK files for steps to prepare your Infinity server and node environment so you can proceed with the steps in the next section.
The following procedures provide an overview of installing Constellation SDKs and running the application. For more information, see Installing and configuring Constellation SDKs.
You can find more details on how to integrate the latest React SDK into your development workflow and also instructions on the new using the new DX Component Builder for SDK features.
For more information, see Development.
If you are facing any issues, please see Troubleshooting Constellation SDKs.
This project is licensed under the terms of the Apache 2 license.
You can see the full license here or directly on apache.org.
We welcome contributions to the React SDK project.
Refer to our guidelines for contributors if you are interested in contributing to the project.
- KeyReleaseUpdates.md: A summary of the latest updates to the @pega/react-sdk-components and
@pega/react-sdk-overrides used by the React SDK can be found in the
react-sdk-components package's KeyReleaseUpdates.md.
- To see if there are updates in the @pega/react-sdk-components and @pega/react-sdk-overrides packages published in a newer version than is currently installed, you can check the package's main GitHub repo's KeyReleaseUpdates.md.
- Material UI
- Constellation SDKs Documentation
- Troubleshooting Constellation SDKs
- MediaCo sample application
![@dependabot[bot]](https://avatars.githubusercontent.com/in/29110?s=64&v=4){kind=small}