Skip to content
Wraith Box

Writing pages

Pages are Markdown (.md) or MDX (.mdx) files under packages/wraithbox-doc/src/content/docs/. The path under that directory becomes the URL, and each page needs at least a title in its frontmatter.

Add a page

Section titled “Add a page”

Create packages/wraithbox-doc/src/content/docs/guides/my-page.md:

---
title: My page
description: A short summary used for SEO and social cards.
---


Your content here.

That page is served at /guides/my-page/.

Wire it into the sidebar

Section titled “Wire it into the sidebar”

The sidebar is defined explicitly in packages/wraithbox-doc/astro.config.mjs. Add your page to a group’s items:

{
  label: 'Guides',
  items: [
    { slug: 'guides/getting-started', label: 'Getting started' },
    { slug: 'guides/my-page', label: 'My page' },
  ],
},
Section titled “Links and images”

Write internal links and image sources root-relative (/guides/my-page/, /diagram.png). The site is served from the root of its own domain (https://wraithbox.nl), so the same Markdown works in local dev and in production.

See the [getting started guide](/guides/getting-started/).


![A diagram](/diagram.png)

The landing page

Section titled “The landing page”

index.mdx uses Starlight’s splash template to render a hero and card grid instead of the usual docs layout. The landing page is not in the sidebar, which starts with your first content page.