boundary/website/content/docs/developing/ui.mdx

---
layout: docs
page_title: Develop the UI
description: >-
    Learn how to develop the Boundary user interface locally for testing. Use dev mode to run a local fork of the UI without building it into the binary.
---

⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️
> [!IMPORTANT]  
> **Documentation Update:** Product documentation previously located in `/website` has moved to the [`hashicorp/web-unified-docs`](https://github.com/hashicorp/web-unified-docs) repository, where all product documentation is now centralized. Please make contributions directly to `web-unified-docs`, since changes to `/website` in this repository will not appear on developer.hashicorp.com.
⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️

# Develop the Boundary user interface

For detailed instructions and the most up-to-date information on developing the
Boundary admin UI, please consult [the project README on GitHub](https://github.com/hashicorp/boundary-ui).

## Run a local fork of the UI locally in dev mode

If you're developing the Boundary UI locally you can point a dev mode server at a
local checkout of the repo without building it into the binary. We call this
directory a passthrough directory, and you can enable it using an env var while in
conjunction with running Boundary in dev mode:

```bash
BOUNDARY_DEV_UI_PASSTHROUGH_DIR=../boundary-ui/ui/admin/dist boundary dev
```