> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pastures.farm/llms.txt
> Use this file to discover all available pages before exploring further.

# Developer Load

> Load the Pastures extension into Rancher Manager using Developer Load.

Developer Load lets you load a locally built extension into Rancher without publishing to a Helm repository. This is the recommended method for development and evaluation.

<Info>
  Make sure you've met the [requirements](/installation/requirements) before proceeding.
</Info>

<Steps>
  <Step title="Build the extension">
    From the repository root:

    ```bash theme={null}
    yarn build-pkg pastures
    ```

    This produces a UMD bundle in `dist-pkg/pastures-0.1.0/`.
  </Step>

  <Step title="Serve the built package">
    ```bash theme={null}
    yarn serve-pkgs
    ```

    This starts a local HTTP server at `http://127.0.0.1:4500` serving the contents of `dist-pkg/`.

    <Warning>
      Keep this terminal running while you use the extension. Closing it will unload Pastures from Rancher.
    </Warning>
  </Step>

  <Step title="Open the Extensions page in Rancher">
    In your Rancher Manager UI, click the **☰** hamburger menu and select **Extensions**.
  </Step>

  <Step title="Enable Developer Load">
    On the Extensions page, click the **⋮** (three-dot) menu in the top-right corner and select **Enable Developer Load**. Confirm when prompted.

    This enables the Developer Load banner at the top of the Extensions page.
  </Step>

  <Step title="Paste the extension URL">
    In the Developer Load input field, enter:

    ```
    http://127.0.0.1:4500/pastures-0.1.0/pastures-0.1.0.umd.min.js
    ```

    Click **Load**.
  </Step>

  <Step title="Verify the extension loaded">
    The Pastures sidebar items should appear immediately:

    * Advisories, Overview, Fleet Overview, Projects, Access Control, Workloads, Operations, Harvester, Infrastructure, AI Agents, Settings
  </Step>
</Steps>

## URL format

The Developer Load URL follows this pattern:

```
http://<host>:<port>/<pkg-name>-<version>/<pkg-name>-<version>.umd.min.js
```

* **host** — `127.0.0.1` when running locally, or the IP/hostname of the machine running `yarn serve-pkgs`
* **port** — `4500` by default
* **pkg-name** — `pastures`
* **version** — matches the version in `package.json` (currently `0.1.0`)

<Tip>
  If Rancher is running in a VM or container, replace `127.0.0.1` with the host machine's IP address that is reachable from the Rancher UI browser session.
</Tip>

## Troubleshooting

| Problem                              | Solution                                                                                 |
| ------------------------------------ | ---------------------------------------------------------------------------------------- |
| "Failed to load" error               | Verify `yarn serve-pkgs` is running and the URL is reachable from your browser           |
| Extension loads but no sidebar items | Hard-refresh the Rancher UI (Cmd/Ctrl + Shift + R)                                       |
| CORS errors in console               | Ensure Rancher and the serve-pkgs host are on the same network or configure CORS headers |
| Extension not updating after rebuild | Re-run `yarn build-pkg pastures`, then reload the extension in Rancher                   |