---
title: Download the UI source
description: 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.
component: pingam
version: 8.1
page_id: pingam:ui-customization:downloading-ui
canonical_url: https://docs.pingidentity.com/pingam/8.1/ui-customization/downloading-ui.html
keywords: ["Customization", "User Interface", "Source Code"]
page_aliases: ["ui-customization-guide:downloading-ui.adoc"]
---

# 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.1.0` branch:

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

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