---
title: "File Tree"
description: "Explore project structure with file-type icons, collapsible folders, and keyboard navigation."
canonical_url: "https://indocio.igrislabs.com/components/file-tree"
---

> Index of every page on this site: [llms.txt](https://indocio.igrislabs.com/llms.txt)

## Usage

<file-tree :items="[{"name":"app","children":[{"name":"app.config.ts"},{"name":"components","children":[{"name":"docs","children":[{"name":"DocsFooter.vue"}]}]}]},{"name":"content","children":[{"name":"index.yml"},{"name":"introduction.md"}]},{"name":"nuxt.config.ts"}]" label="Your documentation app">



</file-tree>

```md
::file-tree
---

label: Project structure
items:

- name: app
  children:
  - name: app.config.ts
- name: nuxt.config.ts

---

::
```

Each item requires a non-empty `name`. An item with `children` is an expandable folder. `label` defaults to `Project structure`. Trees support up to 20 folder levels.

## Interaction

Folders start expanded. Click a folder row or its chevron to collapse or expand it. Files and folders at the same depth share a label column; file icons reflect the filename extension.

The tree uses the IPEX Tree component and follows its control sizing, focus, hover, and touch-target recipes. Filename labels use monospace, and long names show their full text on hover.

<table>
<thead>
  <tr>
    <th>
      Key
    </th>
    
    <th>
      Action
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      Up / Down
    </td>
    
    <td>
      Move between visible entries
    </td>
  </tr>
  
  <tr>
    <td>
      Right
    </td>
    
    <td>
      Expand a folder or move into its children
    </td>
  </tr>
  
  <tr>
    <td>
      Left
    </td>
    
    <td>
      Collapse a folder or move to its parent
    </td>
  </tr>
  
  <tr>
    <td>
      Home / End
    </td>
    
    <td>
      Move to the first or last visible entry
    </td>
  </tr>
  
  <tr>
    <td>
      Type a name
    </td>
    
    <td>
      Focus a matching entry
    </td>
  </tr>
</tbody>
</table>

For selectable source files with code panels, use [Code Tree](https://indocio.igrislabs.com/components/code-tree).

## Sitemap

See the full [sitemap](https://indocio.igrislabs.com/sitemap.md) for all pages.
