Download the UI source
To customize the layout and functionality of the UI, you must download, rebuild, and deploy the UI project. The build process for the UI uses the Webpack resource bundler to manage dependencies, optimize deliverables, and package the output.
ForgeRock provides the source code for the UI as a Maven project in the am-external
repository,
accessible to ForgeRock BackStage accounts that are added to a subscription.
If you do not already have a ForgeRock BackStage account, get one from https://backstage.forgerock.com. For more information about adding your account to a subscription, refer to Getting access to product support in the ForgeRock Knowledge Base.
Follow these steps to get the UI source code:
-
Clone the
am-external
repository:URL-encode your BackStage Username if it contains special characters. For example
:
becomes%3A
and@
becomes%40
.Enter your BackStage password when prompted to do so.
-
Check out the
releases/7.3.0
branch:$ cd am-external $ git checkout releases/7.3.0
The UI project is located in the
am-external/openam-ui/openam-ui-user/
folder. -
If you do not already have them, install the following prerequisites:
For information on building the UI as part of a Maven workflow for deployment inside a WAR file, refer to How do I customize the XUI using source code in AM (All versions)? in the ForgeRock Knowledge Base.
-
Use the
yarn
command to download the dependencies to the project:$ cd openam-ui/openam-ui-user$ yarn yarn install [1/4] 🔍 Resolving packages… [2/4] 🚚 Fetching packages… [3/4] 🔗 Linking dependencies… [4/4] 📃 Building fresh packages… ✨ Done in 9.08s.
In some environments you might receive an error such as
gyp ERR! not ok
when downloading dependencies.You can safely ignore such errors as they only apply to optional components in certain environments, or you could try the
yarn install --ignore-optional
command.