Project structure

astro.config.mjs

import { defineConfig } from 'astro/config';
import mines from '@deltaq.dev/mines';

export default defineConfig({
  integrations: [mines({ title: 'My Docs' })],
});

src/content.config.ts

import { defineCollection } from 'astro:content';
import { docsLoader, docsSchema } from '@deltaq.dev/mines/loader';

export const collections = {
  docs: defineCollection({ loader: docsLoader(), schema: docsSchema() }),
};

src/content/docs/1.getting-started/1.introduction.mdx

---
title: Introduction
---

src/content/docs/1.getting-started/2.installation.mdx

---
title: Installation
---

src/content/docs/2.guides/1.theming.mdx

---
title: Theming
---

src/styles/theme.css

:root {
  --accent: #7c3aed;
}

Ordering

Numeric prefixes set the order of folders and pages and are removed from URLs.

File	URL
`1.getting-started/1.introduction.mdx`	`/getting-started/introduction`
`2.guides/index.mdx`	`/guides`
`index.mdx`	`/`

Without a root index.mdx, / redirects to the first page.

Frontmatter

titlestringrequired

Page title, used in the sidebar, header and search results.

descriptionstring

Shown under the title and used for meta tags.

tocbooleandefault: true

Hide the table of contents with false.

related(string | { label: string; href: string })[]default: []

Links shown below the table of contents. A string is a page slug such as guides/theming, and its title is used as the label. Unknown slugs fail the build.