Writing guides

File location

Create Markdown (.md) or MDX (.mdx) files under:

src/content/docs/dungeons/<expansion>/<duty-slug>.md

The URL path matches the folder structure. Example: dungeons/dawntrail/worqor-zormor.md → /dungeons/dawntrail/worqor-zormor/.

Frontmatter

Every page supports Starlight’s defaults plus optional fields defined in src/content.config.ts:

---
title: Dungeon Name
description: Short summary for search and social previews.
expansion: Dawntrail
dutyLevel: 97
partySize: '4'
estimatedTime: 18–22 min
---

Sidebar

Edit astro.config.mjs → starlight.sidebar to add expansion groups and dungeon links.

To auto-list every file in a folder:

{
  label: 'Dawntrail',
  items: [{ autogenerate: { directory: 'dungeons/dawntrail' } }],
},

Components

Starlight includes cards, tabs, asides, and more. Use MDX when you need components inside a page.

Images

• Put images in src/assets/ and reference them from Markdown.
• Put static files (favicons, downloads) in public/.

Build & preview

npm install
npm run dev

Production output goes to dist/ after npm run build. Serve that folder with any static file host (nginx, Caddy, etc.).