---
title: Download the UI source
description: Download the PingAM End User UI source code from GitHub to customize the user interface layout and functionality
component: pingam
version: 8
page_id: pingam:ui-customization:downloading-ui
canonical_url: https://docs.pingidentity.com/pingam/8.1/ui-customization/downloading-ui.html
llms_txt: https://docs.pingidentity.com/pingam/llms.txt
docs_for_agents: https://developer.pingidentity.com/build-with-ai/docs-for-agents.md
revdate: 2026-06-01T14:34:20Z
keywords: ["Customization", "User Interface", "Source Code"]
page_aliases: ["ui-customization-guide:downloading-ui.adoc"]
superseded_by: https://docs.pingidentity.com/pingam/8.1/ui-customization/downloading-ui.html
---

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

Ping Identity provides the source code for the UI as a Maven project in the [am-external](https://github.com/ForgeRock/am-external) public GitHub repository.

Follow these steps to get the UI source code:

1. Clone the `am-external` repository:

   ```bash
   $ git clone https://github.com/ForgeRock/am-external.git
   ```

2. Check out the `releases/8.0.2` branch:

   ```bash
   $ cd am-external
   $ git checkout releases/8.0.2
   ```

   The End User UI project is in the `am-external/openam-ui` folder.

3. If you don't already have them, install the following prerequisites:

   * [Yarn](https://yarnpkg.com).

   * [Node.js](https://nodejs.org/en) (12.x.x).

   |   |                                                                                                                                                                                                                                                                              |
   | - | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
   |   | You can find information on building the UI as part of a Maven workflow for deployment inside a `.war` file in [How do I customize the XUI using source code in PingAM?](https://support.pingidentity.com/s/article/How-do-I-customize-the-XUI-using-source-code-in-PingAM). |

4. Use the `yarn` command to download the dependencies to the project:

   ```bash
   $ cd openam-ui/openam-ui-user
   $ 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 ignore such errors as they apply only to optional components in certain environments. You can also use the `yarn install --ignore-optional` command to suppress these errors. |