List — dir/ui
Display items with optional icons, descriptions, metadata, and actions.
# List
Display items with optional icons, descriptions, metadata, and actions.
## Install
```sh
npx shadcn@4.21.0 add lr-run/dir-ui/list#v0.1.2
```
[Registry item with source and dependencies](https://github.com/lr-run/dir-ui/blob/v0.1.2/registry.json)
Requires React 19, Tailwind CSS 4 and shadcn initialized with Base UI. Registry target placeholders resolve through components.json: @ui, @components, @hooks and @lib. Imports below use the conventional @/ prefix for illustration; the CLI rewrites them to your configured aliases. Shared components are installed once through registryDependencies. Theme CSS is imported by the UI modules. Existing files are never forcibly overwritten; review CLI conflicts before accepting changes. No Dir runtime is required.
## List
```tsx
import { List } from '@/components/ui/list.tsx'
```
| Prop | Type | Default / required | Notes |
| --- | --- | --- | --- |
| children | ReactNode | — | |
| empty | ReactNode | No items yet. | Pass null children for an empty collection. |
| ...props | ComponentProps<"ul"> | — | |