# Breadcrumbs for Webiny Admin Design source: Figma "Webiny UI" — Header bar node `2047-22464` (https://www.figma.com/design/4XsQ9YFfV1xVbLEvmJ3JDX/Webiny-UI?node-id=2047-22464&m=dev). A breadcrumb trail in the admin header bar: `home › ancestor › … › current`. Ancestors are navigable; the current (last) item is not. ## Architecture — React Config API (not DI) Breadcrumbs are **pure presentation**, so they compose through the same React Config API as `AdminConfig.Menu` / `Dashboard.Widget` — **not** dependency injection. (An earlier DI `Breadcrumb` abstraction was built and removed: DI is overkill for presentation and, being root-resolved + synchronous, couldn't produce dynamic labels — folder path, model name, `page.title` — which was the whole wall. Feedback from Pavel confirmed the Config API is the right fit.) - **`AdminConfig.Breadcrumb`** (`packages/app-admin/src/config/AdminConfig/Breadcrumbs.tsx`) — a config component mirroring `Widget.tsx`. Each mounted `` appends an item to the `breadcrumbs` array property. `to` is `string | { route, params }`. - **`useAdminConfig().breadcrumbs`** — the assembled trail, in mount order. Added to the `AdminConfig` interface + `useAdminConfig()` return. - **Header** (`packages/app-admin-ui/src/Breadcrumbs/Breadcrumbs.tsx`) — reads `useAdminConfig().breadcrumbs`, prepends the home entry (→ `/`), resolves `to` via the router (`RouterPresenter.getLink` for `Route`s), marks the last item current, and renders the DS primitive. Re-renders as views mount/unmount their ``s. Mounted in `Layout.tsx`, `HeaderBar` `start` slot. - **DS primitive** (`packages/admin-ui/src/Breadcrumbs/Breadcrumbs.tsx`) — presentational `Breadcrumbs` (Figma node 2047-22464) + `createHomeBreadcrumbItem` + Storybook story. ## Usage Static trail — declare at the route (or anywhere in the view), no view logic needed: ```tsx ``` Dynamic trail — a plain `observer` component that renders a `` per item from live view state: ```tsx ; { folderPath.map(f => ( )); } ``` The header always prepends home and marks the last mounted item as current (non-clickable). ## Adoptions Every Route-based admin page now declares its trail. Two shapes: **Static** — `` at the route (no view logic): Mailer, Audit Logs, GraphQL/SDK Playground, Workflows, Access Management (Roles/Teams/API Keys), Users/Account, Webhooks, Background Tasks, AI Power-Ups, Website Builder Redirects, CMS Models/Model Groups, CMS & WB workflow editors. **Dynamic** — an `observer` component inside the scoped view that emits a `` per item from live state: - **File Manager** — `FileManagerBreadcrumbs.tsx`, folder path. Page mode only (`!overlayConfig`). - **CMS entries** — `ContentEntriesBreadcrumbs.tsx` → `Headless CMS › › ` (model name + folder path from the scoped presenter). Static route crumbs removed. - **Website Builder pages** — `WbPagesBreadcrumbs.tsx` → `Website Builder › Pages › `. Static route crumbs removed. Navigation flows through route params (`folderId`, `modelId`) + `RouteParamsSync`. ## Status - Config plumbing, header, DS primitive: done. All packages typecheck; lint + format clean. - DI `Breadcrumb` abstraction + presenter + every per-module `*Breadcrumb.ts`/feature: **removed**. ## Still open - Editors (CMS model, WB page) are full-screen — no shared header, skip. - Overflow (`…`) shortcut for deep trails. - Automated tests. ## Notes - The `Cms/ContentEntries/WorkflowStateList` and `WebsiteBuilder/Pages/WorkflowStateList` routes in `routes.ts` are **dead** — no `Route` element / `getLink` references them, so there's no mounted page to add crumbs to. "Content reviews" renders inside the entries / pages list views (which already carry their trails).