Search

The search package adds a global application search to Lattice: a command-menu interface backed by search providers the application registers with the #[AsSearchProvider] attribute. Providers are picked up by Lattice’s discovery, results are grouped by category, and an optional SearchHistoryRecorder binding surfaces recent selections.

Installation

composer require lattice-php/search

That is the whole integration: the package ships its React renderer as source, and the lattice() Vite plugin compiles it into your app’s bundle via virtual:lattice/plugins (see Component packages). The PHP classes are picked up by Lattice’s discovery and TypeScript generation automatically. No-build apps use the precompiled module the package also ships: run php artisan lattice:assets after installation.

Note

There is no npm package — Composer is the only install.

The search dialog

SearchBox::make() renders a trigger button that opens the search dialog (also reachable via ⌘K/Ctrl+K). The dialog opens compact — just the input, plus recent selections when a SearchHistoryRecorder is bound — and expands into the three-pane layout (categories, results, preview) once a query is typed. Inside a collapsed sidebar the trigger shrinks to an icon-only button; the keyboard shortcut keeps working.

Pass your own ->schema([...]) of SearchInput, SearchResults, SearchCategories, SearchRecent, and SearchPreview components to replace the default composition entirely.

From your own React code

The same pieces are props-based clients exported from @lattice-php/search, so an app can mount the trigger outside a Lattice page or compose its own palette:

import { SearchBox, SearchInput, SearchResults } from "@lattice-php/search";

<SearchBox endpoint="/lattice/search" placeholder="Find anything" shortcut>
  <SearchInput />
  <SearchResults />
</SearchBox>;

SearchBox opens the palette through the nearest ModalProvider; the slot components read the active search from SearchProvider, which SearchPalette mounts around its children.

Translations

The component’s strings ship with inline English defaults. With laravel-i18next enabled, the plugin’s search namespace is loaded automatically and serves the bundled en/de translations (override them like any Laravel package translation — see Internationalization).

Bundle size

The breakdown below measures the package’s built plugin — React and the framework runtime are external, so this is exactly what the search package adds on top of an app that already ships Lattice. It is regenerated on every docs build.

5.6 KB gzipped · 19.0 KB raw JavaScript

Dependency	Raw	Gzip	Share
@lattice-php/search	15.1 KB	4.9 KB	88.3%
Bundler runtime	3.9 KB	0.6 KB	11.7%

Emitted JavaScript files

File	Raw	Gzip
plugin.js	19.0 KB	5.6 KB

Open the full interactive treemap ↗ · Generated by Sonda 0.14.0 on Sat, 22 Aug 2026 17:50:38 GMT.