# Org & Environment Switcher block

> Developer platform top navbar with breadcrumb org, project and environment switchers

Header for dev tools and PaaS dashboards: breadcrumb of organization, project and color-dotted environment switchers, docs and settings menus, Upgrade button, avatar menu with light/dark/system theme toggle. shadcn Breadcrumb, DropdownMenu, Avatar.

- Type: Pro block
- Category: [Navbar](https://web.dev.reui.io/blocks/application/navbar.md)
- Page: https://web.dev.reui.io/blocks/application/navbar/navbar-3
- MCP: `get_block("navbar-3")`
- Built with: Avatar, Breadcrumb, Button, Dropdown Menu, Separator
- Installs with a ReUI Pro or Ultimate license; setup: https://web.dev.reui.io/docs/license-setup

## Best for

Three chained switchers for organization, project and environment, each environment marked by a colored dot, beside an Upgrade button

## Agent notes

- `WORKSPACES`, `PROJECTS` and `ENVIRONMENTS` are sample lists, and each switcher only keeps its pick in local `active` state
- The Upgrade `Button` and the Documentation, API Reference, Notifications and Appearance items in `NavbarStatus` have no handler
- Each environment dot is the `color` class set in `ENVIRONMENTS`, so give a new environment its own `color`

## When not to use

- A sidebar rail that holds the workspace switcher and the nested navigation: use [Icon Rail Dashboard](https://web.dev.reui.io/blocks/application/app-shell/app-shell-1.md) (`get_block("app-shell-1")`)
- A design system header with centered section tabs and a version badge: use [Design System Manager](https://web.dev.reui.io/blocks/application/navbar/navbar-11.md) (`get_block("navbar-11")`)

## Third-party libraries

- next-themes: [API reference](https://github.com/pacocoursey/next-themes#api), [docs](https://github.com/pacocoursey/next-themes)

## Install

```bash
npx shadcn@latest add @reui/navbar-3
```

## About Navbar blocks

### When to use

- The top bar of a signed in product, with a breadcrumb or switchers, search, alerts, avatars or a user menu
- An editor toolbar with a back or close button, the page name and its run, publish or submit action
- A marketing site header with mega menu panels of linked pages and a Get Started button

### When not to use

- A whole product layout with a side rail, a header and the content area together: use the [App Shell blocks](https://web.dev.reui.io/blocks/application/app-shell.md)
- A keyboard palette that lists, groups and filters results as you type: use [Command](https://web.dev.reui.io/components/command.md) (`get_component("command")`)
- The account settings page a user menu opens, with team, billing and API key forms: use the [Profile blocks](https://web.dev.reui.io/blocks/application/profile.md)

### Agent notes

- `Navbar` takes no props, so every label, person and option it shows is fixed in the block; lift them into props to reuse it
- No button, link or menu item routes or calls an API; add an `onClick` or a real `href` where each one should go
- Each page.tsx adds only demo padding or dashed placeholder boxes around `Navbar`, none of which belongs in your layout

Every ReUI item has a twin like this one; the index is https://web.dev.reui.io/llms.txt. Agents with the ReUI MCP (https://web.dev.reui.io/docs/mcp) get the same guidance from the getters named above.
