Ping SDKs

Step 1. Install the widget

You can add the Ping (ForgeRock) Login Widget to your app by using Node Package Manager (npm), or you can download it from GitHub and build it yourself, adding results to your project directly.

Install the Ping (ForgeRock) Login Widget with npm

The easiest way to add the Ping (ForgeRock) Login Widget to your project.

Build a customized Ping (ForgeRock) Login Widget

If you want to customize the themes included in the Ping (ForgeRock) Login Widget, you need to download the Ping (ForgeRock) Web Login Framework source, make your modifications, and build a customized package.

Install the Ping (ForgeRock) Login Widget with npm

Add the Ping (ForgeRock) Login Widget to your project using npm as follows:

npm install @forgerock/login-widget

Next, you can Step 2. Configure the CSS.

Build a customized Ping (ForgeRock) Login Widget

The following steps show how to download the Ping (ForgeRock) Web Login Framework and build the Ping (ForgeRock) Login Widget:

  1. Download the Ping (ForgeRock) Web Login Framework from the Git repository:

    git clone https://github.com/ForgeRock/forgerock-web-login-framework.git

  2. In a terminal window, navigate to the root of the Ping (ForgeRock) Web Login Framework:

    cd forgerock-web-login-framework

  3. Run npm to download and install the required packages and modules:

    npm install

  4. Build the Ping (ForgeRock) Login Widget with npm:

    npm run build:widget

  5. Copy the built package/ directory into your app project

  6. Import the Widget component into your app:

    import Widget from '../path/to/package/index.js';

    The exact syntax for importing the widget into your app varies depending on the technologies your app uses.

Next

Next, you can Step 2. Configure the CSS.