Mail Client Settings
Email settings with accounts, signatures, labels and filter rules.
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 settings with accounts, signatures, labels and filter rules.
- Mail preferences with a keyboard shortcuts reference, density and undo time.
Includes
- Connected accounts
- Add account flow
- Reconnect account
- Default sender
- Signatures
- Labels with colours
- Filter rules
- Rule run now
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-settingsInstalls through shadcn and adapts the component to your design tokens.
shadcn CLI
npx shadcn@4.17.0 add @agentic-ui/mail-client-settingsUsed 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
lucide-react- Registry dependencies
lib-primitivesutil-shortcuts-overlay- Files
37 files
- components/agentic-ui/mail-client-settings/screens/settings.tsx
- components/agentic-ui/mail-client-settings/components/settings/signatures-panel.tsx
- components/agentic-ui/mail-client-settings/lib/types.ts
- components/agentic-ui/mail-client-settings/lib/store.ts
- components/agentic-ui/mail-client-settings/lib/reducer.ts
- components/agentic-ui/mail-client-settings/lib/rules.ts
- components/agentic-ui/mail-client-settings/lib/reduce-threads.ts
- components/agentic-ui/mail-client-settings/lib/reduce-settings.ts
- components/agentic-ui/mail-client-settings/lib/clock.ts
- components/agentic-ui/mail-client-settings/lib/reduce-drafts.ts
- components/agentic-ui/mail-client-settings/lib/selectors.ts
- components/agentic-ui/mail-client-settings/lib/snooze.ts
- components/agentic-ui/mail-client-settings/lib/recipients.ts
- components/agentic-ui/mail-client-settings/lib/markdown.ts
- components/agentic-ui/mail-client-settings/lib/compose.ts
- components/agentic-ui/mail-client-settings/data/incoming.ts
- components/agentic-ui/mail-client-settings/data/people.ts
- components/agentic-ui/mail-client-settings/data/dsl.ts
- components/agentic-ui/mail-client-settings/data/seed.ts
- components/agentic-ui/mail-client-settings/data/story-ops.ts
- components/agentic-ui/mail-client-settings/data/story-clients.ts
- components/agentic-ui/mail-client-settings/data/bulk.ts
- components/agentic-ui/mail-client-settings/components/settings/panel.tsx
- components/agentic-ui/mail-client-settings/components/notice.tsx
- components/agentic-ui/mail-client-settings/components/confirm-dialog.tsx
- components/agentic-ui/mail-client-settings/components/common.tsx
- components/agentic-ui/mail-client-settings/components/settings/shortcuts-panel.tsx
- components/agentic-ui/mail-client-settings/lib/shortcut-defs.ts
- components/agentic-ui/mail-client-settings/components/settings/sections.ts
- components/agentic-ui/mail-client-settings/components/settings/labels-panel.tsx
- components/agentic-ui/mail-client-settings/components/label-chip.tsx
- components/agentic-ui/mail-client-settings/components/settings/general-panel.tsx
- components/agentic-ui/mail-client-settings/components/settings/filters-panel.tsx
- components/agentic-ui/mail-client-settings/components/settings/rule-dialog.tsx
- components/agentic-ui/mail-client-settings/components/settings/accounts-panel.tsx
- components/agentic-ui/mail-client-settings/components/settings/add-account-dialog.tsx
- components/agentic-ui/mail-client-settings/lib/accounts.ts
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 Search
Email search with from, has attachment, date range and label filters and saved searches.
Details and live preview