# Workspace Navigation & Global Search

Formulation provides a streamlined, fast, centralized directory for managing all culinary data across your operation.

---

## 1. Directory Workspace & Workspace Pills

The home directory (`/app/`) categorizes items into distinct workspaces using top pill badges:

- **Recipes** (Blue badge): Standalone formulas, prep recipes, and batch formulations.
- **Ingredients** (Green badge): Raw culinary ingredients, allergens, density conversions, and supplier links.
- **Recipe Books** (Purple badge): Curated collections and menus of recipes (e.g. *Dinner Menu*, *Cocktails*, *Bakery Line*).
- **Purchase Items** (Cyan badge): Commercial vendor packages, invoice pack sizes, prices, and vendor SKUs.
- **Inventory** (Teal badge): Active and past inventory count sessions with on-hand valuations.
- **Archive** (Neutral link): Soft-deleted items ready for restoration or permanent purge.

---

## 2. Global Search & Autocompletion

- **Omnibox Search**: Search across recipe titles, ingredient names, aliases, and purchase items simultaneously.
- **Type Filtering**: Narrow search results by specific entity type directly from the search dropdown filter.
- **Keyboard Navigation**:
  - <kbd>Tab</kbd> / <kbd>Arrow Down</kbd>: Highlight matching search candidates.
  - <kbd>Enter</kbd>: Open the selected recipe or ingredient detail card immediately.
  - <kbd>Escape</kbd>: Clear search and close active popups.

---

## 3. Detail Utility Bar

Every single item detail page features a fixed top utility bar containing:
- **Workspace Breadcrumbs**: Direct navigation back to the active directory workspace.
- **Global Search**: Search and jump to other items without returning to the home screen.
- **New Action Button (`+ New`)**: Quick creation modal for recipes, ingredients, recipe books, or count sessions from anywhere in the app.