File Tree

A customizable file tree component for displaying hierarchical file structures in your documentation.

The File Tree component allows you to display hierarchical file structures in your documentation with collapsible folders and files.

Basic Usage

index.tsx
<Files>
  <Folder name="src">
    <File name="App.tsx" />
    <File name="index.tsx" />
    <Folder name="components">
      <File name="Button.tsx" />
      <File name="Card.tsx" />
    </Folder>
    <Folder name="pages">
      <File name="Home.tsx" />
      <File name="About.tsx" />
    </Folder>
  </Folder>
</Files>

Render As:

App.tsx
index.tsx
Button.tsx
Card.tsx
Home.tsx
About.tsx

Props

  1. Files

    The root component that wraps the entire file tree.

  2. Folder
    PropTypeRequiredDescription
    namestringYesThe name of the folder
    childrenReactNodeNoChild elements (File or Folder)
  3. File
    PropTypeRequiredDescription
    namestringYesThe name of the file

Best Practices

  1. Keep the nesting level reasonable (recommended max 3-4 levels deep)
  2. Use clear and descriptive names for files and folders
  3. Consider the user experience when displaying large file structures
  4. Use consistent naming conventions throughout your file tree

Accessibility

The File Tree component includes built-in accessibility features:

  • Keyboard navigation support
  • ARIA attributes for screen readers
  • Focus management for interactive elements
  • High contrast mode support

Last updated May 5, 2026