Step 1. Install the widget
You can add the 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 ForgeRock Login Widget with npm
-
The easiest way to add the ForgeRock Login Widget to your project.
- Build a customized ForgeRock Login Widget
-
If you want to customize the themes included in the {login_widget_name, you need to download the ForgeRock Web Login Framework source, make your modifications, and build a customized package.
Install the ForgeRock Login Widget with npm
Add the 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 ForgeRock Login Widget
The following steps show how to download the ForgeRock Web Login Framework and build the ForgeRock Login Widget:
-
Download the ForgeRock Web Login Framework from the Git repository:
git clone https://github.com/ForgeRock/forgerock-web-login-framework.git -
In a terminal window, navigate to the root of the ForgeRock Web Login Framework:
cd forgerock-web-login-framework -
Run
npmto download and install the required packages and modules:npm install -
Build the ForgeRock Login Widget with
npm:npm run build:widget -
Copy the built
package/directory into your app project -
Import the
Widgetcomponent 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.