# natui/components

> Reference the Node-free component entrypoint and its shared TypeScript types.

Canonical: https://natui.dev/docs/api/components

This entrypoint exports all 37 host components and their prop types without importing the Node process runtime.

```tsx
import { Button, Text, VStack } from 'natui/components';
```

Use it for embedded bundles and anywhere that should remain free of Node built-ins. Use the primary `natui` entrypoint for a normal Node-driven application.

## Shared types [#shared-types]

### CommonProps


| Property | Type | Required | Description |
| --- | --- | --- | --- |
| `padding` | `number \| EdgeInsets \| undefined` | No |  |
| `background` | `string \| undefined` | No |  |
| `cornerRadius` | `number \| undefined` | No |  |
| `frame` | `Frame \| undefined` | No |  |
| `opacity` | `number \| undefined` | No |  |
| `disabled` | `boolean \| undefined` | No |  |
| `hidden` | `boolean \| undefined` | No |  |
| `color` | `string \| undefined` | No | Foreground color. |
| `help` | `string \| undefined` | No | Tooltip. |
| `tag` | `string \| undefined` | No | Stable row identity for selectable containers (List/Table selection). A selectable List reports and receives selection as its rows' tags. |
| `badge` | `string \| number \| undefined` | No | Badge shown on Tab items and List rows (counts, short strings). |
| `accessibilityLabel` | `string \| undefined` | No | Assistive-tech label (VoiceOver / Narrator). |
| `accessibilityHint` | `string \| undefined` | No | Assistive-tech hint describing the result of activating the element. |
| `accessibilityIdentifier` | `string \| undefined` | No | Stable identifier for UI automation (AX identifier / AutomationId). |
| `key` | `string \| number \| undefined` | No |  |

* `Color`
* `EdgeInsets`
* `Frame`
* `CommonProps`
* `ContainerProps`
* `FontStyle`
* `PickerOption`
* `MenuItemRole`
* `MenuActionSpec`
* `MenuDividerSpec`
* `MenuItemSpec`
* `MenuSpec`
* `ToolbarItemSpec`
* `AlertButtonSpec`
* `TableColumnSpec`
* `TableRowSpec`
* `SortDescriptor`

See the [component catalog](/docs/components) for grouped usage and platform behavior.