# Data File Tree

IDE style file tree for an agent workspace with modified, added and deleted badges.

- id: `data-file-tree`
- Page: https://agentic-ui-kit.com/components/data-file-tree
- Live preview: https://agentic-ui-kit.com/live/component/data-file-tree?piece=data-file-tree

## Install

```bash
agentic-ui add data-file-tree
npx shadcn@4.17.0 add @agentic-ui/data-file-tree
```

## Metadata

- **Level:** block
- **Category:** block
- **Installable in:** Radix UI (registry variant new-york), Base UI (registry variant base-vega)
- **Capabilities:** file-type-icons, change-badges, modified-added-deleted, folder-change-dots, context-menu, inline-rename, new-file-folder, delete-with-undo, wai-aria-tree, reduced-motion, dark-mode
- **Intents:** navigate, create-edit, track-status, explore-detail
- **Suits domains:** devtools, ai-agents, ai-workspace, file-storage, saas
- **Interaction:** keyboard-focus, context-menu, inline-edit, expand-collapse
- **Screen role:** management
- **Density:** comfortable
- **Dark mode:** yes
- **Use it for:** IDE style file tree for an agent workspace with modified, added and deleted badges, file explorer sidebar with file type icons, rename, new file and delete in a context menu, show which files an AI coding agent changed in a repo as a folder tree, code workspace explorer with keyboard navigation F2 rename and delete undo
- **Avoid when:** a drive or cloud storage browser with thumbnails, sizes and sharing (use the file-storage templates), a generic hierarchy that is not files (use data-tree-view), reading file contents: pair it with a code viewer, it only lists paths
- **Preserve when adapting:** flat-path-model, badge-text-for-screen-readers, undo-on-delete
- **Replace when adapting:** entries, statuses, expanded-paths, persistence
- **Adaptation effort:** low
- **Coupling:** low
- **Quality breakdown:** visual 9/10, responsive 9/10, accessibility 9/10, code 9/10
- **Uses primitives:** button
- **npm dependencies:** lucide-react
- **npm dependencies (registry):** lucide-react@0.577.0
- **Registry dependencies:** lib-primitives
