Mail Client Search
Email search with from, has attachment, date range and label filters and saved searches.
Choose the primitives library your project already uses. Both look the same: your theme, not the variant, controls colors, shape, type and motion.
About this page
What it's for
- Email search with from, has attachment, date range and label filters and saved searches.
- Search operators such as from:, has:attachment, is:unread and label: that stay in sync with filter fields.
Includes
- Query operators
- Filter fields edit the query
- Date range filter
- Label filter
- Attachment flag
- Match highlight
- Sort by match or date
- Saved searches
Works with
- Radix UI and Base UI primitives (pick the one your project uses)
- React 19 and Tailwind CSS 4 in Next.js (App Router), Vite, React Router or TanStack Start, installed with the agentic-ui or shadcn CLI
- Your theme tokens, in light and dark mode
- 1 template or blueprint on this site use it (below)
Install
Included with Agentic UI Kit (one-time license). Install needs your license key: see pricing · connect your project.
Agentic UI CLI
agentic-ui add mail-client-searchInstalls through shadcn and adapts the component to your design tokens.
shadcn CLI
npx shadcn@4.17.0 add @agentic-ui/mail-client-searchUsed in
- Type
- Page
- Variants
- Radix UI and Base UI
- Themes
- Light and dark
- Widths
- Preview it at desktop, tablet and mobile widths above.
- Motion
- Animated, with a reduced-motion fallback
- Sample data
- Ships with sample data in
incoming.ts,people.ts,dsl.ts,seed.ts,story-ops.ts,story-clients.ts,bulk.ts; replace it with your own.
- npm packages
@tanstack/react-virtuallucide-react- Registry dependencies
form-date-range-pickerlib-primitives- Files
33 files
- components/agentic-ui/mail-client-search/screens/search.tsx
- components/agentic-ui/mail-client-search/lib/url-state.ts
- components/agentic-ui/mail-client-search/lib/store.ts
- components/agentic-ui/mail-client-search/lib/types.ts
- components/agentic-ui/mail-client-search/lib/reducer.ts
- components/agentic-ui/mail-client-search/lib/rules.ts
- components/agentic-ui/mail-client-search/lib/reduce-threads.ts
- components/agentic-ui/mail-client-search/lib/reduce-settings.ts
- components/agentic-ui/mail-client-search/lib/clock.ts
- components/agentic-ui/mail-client-search/lib/reduce-drafts.ts
- components/agentic-ui/mail-client-search/lib/selectors.ts
- components/agentic-ui/mail-client-search/lib/snooze.ts
- components/agentic-ui/mail-client-search/lib/recipients.ts
- components/agentic-ui/mail-client-search/lib/markdown.ts
- components/agentic-ui/mail-client-search/lib/compose.ts
- components/agentic-ui/mail-client-search/data/incoming.ts
- components/agentic-ui/mail-client-search/data/people.ts
- components/agentic-ui/mail-client-search/data/dsl.ts
- components/agentic-ui/mail-client-search/data/seed.ts
- components/agentic-ui/mail-client-search/data/story-ops.ts
- components/agentic-ui/mail-client-search/data/story-clients.ts
- components/agentic-ui/mail-client-search/data/bulk.ts
- components/agentic-ui/mail-client-search/lib/search.ts
- components/agentic-ui/mail-client-search/components/search/saved-searches.tsx
- components/agentic-ui/mail-client-search/components/notice.tsx
- components/agentic-ui/mail-client-search/components/common.tsx
- components/agentic-ui/mail-client-search/components/search/filters-panel.tsx
- components/agentic-ui/mail-client-search/lib/search-dates.ts
- components/agentic-ui/mail-client-search/components/inbox/thread-list.tsx
- components/agentic-ui/mail-client-search/components/inbox/thread-row.tsx
- components/agentic-ui/mail-client-search/lib/actions.ts
- components/agentic-ui/mail-client-search/components/label-chip.tsx
- components/agentic-ui/mail-client-search/components/inbox/marked.tsx
Related components
Mail Client Compose
Email composer with recipient chips and autocomplete, rich text, attachments and a signature.
Details and live previewMail Client Contacts
Address book with search, favourites and a detail pane with recent conversations.
Details and live previewMail Client Inbox
Three pane email inbox with a folder sidebar, conversation list and reading pane.
Details and live previewMail Client Settings
Email settings with accounts, signatures, labels and filter rules.
Details and live preview