Skip to content

The open alternative to Salesforce, designed for AI.

7.3 KB
Raw Blame
---
title: Components
sidebarTitle: Overview
description: Shared design presets and reusable app building blocks composed from Twenty UI primitives.
---

import { PageBanner } from "/snippets/page-banner.mdx"

## Overview

Components combine [primitives](/ui/primitives/overview) into recurring design presets and reusable app building blocks. Like primitives, they receive data and callbacks from your application.

Use the matching family import shown below. The aggregate `twenty-ui/components` entry also remains available. The code editor has its own entry point, `twenty-ui/components/code-editor`, because it requires Monaco. See [Getting started](/ui/getting-started) for installation and theme setup.

## Input

Import from `twenty-ui/components/input`.

| Component                                                       | Purpose                                                               |
| --------------------------------------------------------------- | --------------------------------------------------------------------- |
| [MainButton](/ui/components/input/main-button)                  | Prominent actions with a solid surface, elevation, and semibold text. |
| [LightButton](/ui/components/input/light-button)                | Lightweight actions with standard or subtle emphasis.                 |
| [IconButton](/ui/components/input/icon-button)                  | Square or round icon actions built on Button.                         |
| [LightIconButton](/ui/components/input/light-icon-button)       | Lightweight icon actions with standard or subtle emphasis.            |
| [ReactionButton](/ui/components/input/reaction-button)          | Emoji reactions with a count and controlled pressed state.            |
| [PhoneCountryPicker](/ui/components/input/phone-country-picker) | Searchable country flags and calling-code selection.                  |
| [NumberStepper](/ui/components/input/number-stepper)            | Compact numeric input with optional step buttons.                     |
| [SearchInput](/ui/components/input/search-input)                | Search text and optional filter controls.                             |
| [CountrySelect](/ui/components/input/country-select)            | Searchable country choices, flags, and an explicit empty selection.   |
| [CurrencyPicker](/ui/components/input/currency-picker)          | Searchable currency choices with explicit formatting.                 |
| [ImageInput](/ui/components/input/image-input)                  | Image selection and preview with caller-owned uploads.                |
| [SegmentedControl](/ui/components/input/segmented-control)      | Compact radio choice with joined text or icon options.                |

## Navigation

Import from `twenty-ui/components/navigation`.

| Component                                                    | Purpose                                                            |
| ------------------------------------------------------------ | ------------------------------------------------------------------ |
| [ListItemButton](/ui/components/navigation/list-item-button) | Native action buttons with list row styling.                       |
| [Dropdown](/ui/components/navigation/dropdown)               | Action menus, searchable pickers, and form panels.                 |
| [TabButton](/ui/components/navigation/tab-button)            | Route links and adjacent actions with the same appearance as tabs. |

## Data display

Import from `twenty-ui/components/data-display`.

| Component                                                      | Purpose                                                         |
| -------------------------------------------------------------- | --------------------------------------------------------------- |
| [DetailsRow](/ui/components/data-display/details-row)          | Aligned labels, wrapping values, and optional actions.          |
| [MetricRow](/ui/components/data-display/metric-row)            | Labels and formatted values with optional determinate progress. |
| [AvatarGroup](/ui/components/data-display/avatar-group)        | Overlapping avatars and overflow counts.                        |
| [CommandBlock](/ui/components/data-display/command-block)      | Command text with an optional copy action.                      |
| [JsonTree](/ui/components/data-display/json-tree)              | Expandable JSON values and named entries.                       |
| [StackIcon](/ui/components/data-display/stack-icon)            | Icons with a smaller item stacked on the bottom-right corner.   |
| [TintedIconTile](/ui/components/data-display/tinted-icon-tile) | Icons on theme-colored tiles.                                   |

## Feedback

Import from `twenty-ui/components/feedback`.

| Component                                                                            | Purpose                                           |
| ------------------------------------------------------------------------------------ | ------------------------------------------------- |
| [Toast](/ui/components/feedback/toast)                                               | Notifications, queue management, and dismissal.   |
| [Callout](/ui/components/feedback/callout)                                           | Semantic messages with actions and dismissal.     |
| [InlineBanner](/ui/components/feedback/inline-banner)                                | Compact banners with optional actions.            |
| [ToastProvider and Toaster](/ui/components/feedback/toast#application-notifications) | Notification stores, queue limits, and rendering. |

## Layout

Import from `twenty-ui/components/layout`.

| Component                                                              | Purpose                                                           |
| ---------------------------------------------------------------------- | ----------------------------------------------------------------- |
| [Section](/ui/components/layout/section)                               | Related content with a heading, description, and optional action. |
| [AnimatedIconCrossfade](/ui/components/layout/animated-icon-crossfade) | State-driven icon transitions.                                    |
| [OverflowingList](/ui/components/layout/overflowing-list)              | Fit visible items and collect the overflow.                       |

## Settings

Import from `twenty-ui/components/settings`.

| Component                                           | Purpose                                    |
| --------------------------------------------------- | ------------------------------------------ |
| [SettingsRow](/ui/components/settings/settings-row) | Labeled switches for settings and filters. |

## Code editor

Import from `twenty-ui/components/code-editor`.

| Component                                            | Purpose                                                             |
| ---------------------------------------------------- | ------------------------------------------------------------------- |
| [CodeEditor](/ui/components/code-editor/code-editor) | Code editing with Monaco, an optional header, and the Twenty theme. |

Routing, record formatting, product placeholders, and application state belong to the host application. Shared components expose data, callback, and render props for those integrations.

<PageBanner illustration="section-ui-components" />