Fumadocs
Comparison Criteria

Docs Directory Placement

Fumadocs MDX accepts a configurable content directory while index files define directory routes.

Result

The content source is configured explicitly:

source.config.ts
export const docs = defineDocs({
  dir: 'content/docs',
});

It could point to another project-relative directory. Fumadocs is also able to adapt other content sources through its Loader API, so docs/ is a convention, not a required repository root.

Route convention

Fumadocs derives slugs from file paths. criteria/index.mdx maps to the criteria/ directory route; ordinary basenames become leaf slugs. This sample uses explicit index.mdx files and does not rely on a special README.md alias.

On this page