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

# Text UI

> A persistent on-screen help label — show a hint like [E] Open shop, then hide it.

`Bridge.TextUI` shows a small, persistent label near the top of the screen — the classic "press a key" hint. Unlike a notification, it stays up until you hide it, so it pairs naturally with proximity checks: show it when the player walks into range, hide it when they leave.

## Availability

Client only. Two calls — `Show` and `Hide`.

```lua theme={null}
Bridge.TextUI.Show(text, opts?)
Bridge.TextUI.Hide()
```

## Signature

### Bridge.TextUI.Show

<ParamField path="text" type="string" required>
  The label text, e.g. `'[E] Open shop'`.
</ParamField>

<ParamField path="opts.icon" type="string">
  An optional leading icon, tinted to the theme accent.
</ParamField>

### Bridge.TextUI.Hide

Takes no arguments. Hides the currently shown label. Safe to call when nothing is shown.

<Note>
  Text UI is a single, shared label — calling `Show` again replaces the current text rather than stacking. Always pair every `Show` with a `Hide` on the exit path.
</Note>

## Examples

<CodeGroup>
  ```lua Basic theme={null}
  Bridge.TextUI.Show('[E] Open shop')
  -- …later
  Bridge.TextUI.Hide()
  ```

  ```lua With an icon theme={null}
  Bridge.TextUI.Show('[E] Talk to the clerk', { icon = 'store' })
  ```

  ```lua Proximity pattern theme={null}
  -- Show while near a point, hide when leaving range.
  local shown = false
  CreateThread(function()
      while true do
          local near = #(GetEntityCoords(PlayerPedId()) - shopCoords) < 2.0
          if near and not shown then
              Bridge.TextUI.Show('[E] Open shop', { icon = 'store' })
              shown = true
          elseif not near and shown then
              Bridge.TextUI.Hide()
              shown = false
          end
          Wait(250)
      end
  end)
  ```
</CodeGroup>

<Tip>
  For world-anchored prompts that follow a point in 3D and expand into an option list, use [Interact](/atlas-bridge/developer/world#interact) instead — it manages proximity and focus for you. Text UI is best for simple, screen-fixed hints.
</Tip>

<Note>
  The icon honors the player's theme accent. Set `atlas:ui "ox"` (or `atlas:ui:textui "ox"`) to render the same calls through ox\_lib's textUI instead.
</Note>