Astro documentation theme

A calmer way
to build docs

Dahlia is a minimal, content-first documentation theme for Astro. Thoughtful by default. Focused on clarity, reading, and pace.

Read the docs View on GitHub

pnpm add @prosefly/astro-theme-dahlia

Dahlia documentation theme overview — Readable structure for long-form documentation.

Content-first layoutsThoughtful typographyAstro-native integration

The useful middle layer

Everything around your content.

Dahlia handles the structure that makes documentation feel complete, while your Astro project remains yours.

Content-first by design

Clean layouts, readable typography, and generous spacing help your content take center stage.

Simple to start

Get up and running in minutes with sensible defaults and minimal configuration.

Easy to make your own

Extend Dahlia with components, styles, and content collections built to stay adaptable.

Search that stays quiet

Add local search or another provider without letting utility compete with the page.

Light and dark modes

Give readers a comfortable reading surface with system-aware appearance controls.

Ready for more languages

Keep navigation, UI messages, routes, and metadata aligned across locales.

IntroductionOn this page

Welcome to Dahlia

A quiet surface for serious documentation.

Dahlia keeps the interface present, useful, and easy to ignore when the reader needs to focus.

Reading is the feature

Make the content feel considered.

Dahlia gives every page a clear rhythm, so guides feel welcoming and references stay easy to scan.

Readable type scale
Clear page hierarchy
A layout that recedes while you read

Configuration without ceremony

Make the theme yours in one place.

Use the config file for the decisions that shape the reading experience. Keep the rest of your project in Astro’s hands.

Accent, gray, radius, and mode
Local components stay first-class
Semantic tokens instead of tangled overrides

theme.config.jsonsemantic tokens

appearance: {
  accent: "rose",
  gray: "neutral",
  radius: "medium",
  defaultMode: "system"
}

A small setup surface

Start with a config file. Ship with confidence.

Install the theme, point it at your content, and keep extending your site through Astro’s own primitives.

theme.config.json

{
  "$schema": "https://prosefly.dev/schema/dahlia.json",
  "name": "My Docs",
  "appearance": {
    "accent": "rose",
    "defaultMode": "system",
    "radius": "medium"
  },
  "docsNav": [
    { "label": "Guides", "items": ["overview", "installation"] }
  ]
}

Install the packages

pnpm add @prosefly/astro-theme-dahlia @prosefly/astro-components

Your next docs site

Give your content
room to breathe.

Bring Dahlia into your Astro project and start with a documentation surface that knows when to stay quiet.

Read the docs

A calmer way to build docs