Files

page.tsx

layout.tsx

page.tsx

global.css

package.json

Install to your codebase

Easier customization & control.

npx @fumadocs/cli@latest add files

Usage

Wrap file components in Files, you can use it in your MDX content, or as a normal React.js component.

content.mdx

import { File, Folder, Files } from 'fumadocs-ui/components/files';

<Files>
  <Folder name="app" defaultOpen>
    <File name="layout.tsx" />
    <File name="page.tsx" />
    <File name="global.css" />
  </Folder>
  <Folder name="components">
    <File name="button.tsx" />
    <File name="tabs.tsx" />
    <File name="dialog.tsx" />
  </Folder>
  <File name="package.json" />
</Files>

File

Prop

Type

Folder

Prop

Type

Remark Plugin

You can enable remark-mdx-files for additional feature & syntax.

source.config.ts (Fumadocs MDX)

import { remarkMdxFiles } from 'fumadocs-core/mdx-plugins/remark-mdx-files';
import { defineConfig } from 'fumadocs-mdx/config';

export default defineConfig({
  mdxOptions: {
    remarkPlugins: [remarkMdxFiles],
  },
});

CodeBlock Syntax

It will convert files codeblocks into <Files /> component, like:

content.md

```files
project
├── src
│   ├── index.js
│   └── utils
│       └── helper.js
├── package.json
```

`<auto-files>`

Generate <Files /> component from glob.