Pages & Frontmatter

Every documentation page is an .mdx file inside the apps/docs/src/content/docs/ directory.

Content path

Files follow this structure:

apps/docs/src/content/docs/{project}/{version}/{locale}/{path}.mdx

For example:

apps/docs/src/content/docs/explainer/default/en/getting-started.mdx

• project — Top-level directory name (e.g., explainer)
• version — default for unversioned, or a version name like v1, v2
• locale — Language code (e.g., en, fr)
• path — File path that becomes the URL segments

URL pattern

The generated URL follows this pattern:

/{locale}/{project}/{path}

The default version is omitted from the URL. Versioned docs include the version:

Frontmatter schema

Every MDX file starts with a YAML frontmatter block:

---
title: My Page Title
description: A brief description of this page.
icon: book-open
order: 2
permalink: /custom-url
---

Page content starts here...

Available fields