Installation

Get a documentation site running in under five minutes. You need Node.js 20 or later and a terminal.

Quick start

Clone the template with degit, install dependencies, and start the dev server.

npx degit codejumbo/dustavez my-docs
cd my-docs
npm install
npm run dev

pnpm dlx degit codejumbo/dustavez my-docs
cd my-docs
pnpm install
pnpm run dev

npx degit codejumbo/dustavez my-docs
cd my-docs
yarn install
yarn dev

bunx degit codejumbo/dustavez my-docs
cd my-docs
bun install
bun run dev

Open localhost:4321 in your browser. Every edit to an .mdx file hot-reloads instantly.

Interactive setup

After cloning, run npm run setup to customize the site name, accent color, and optionally clear the sample content.

Manual setup

If you prefer more control, you can set up Dustavez step by step.

Clone and install

Clone the template and install dependencies.

npx degit codejumbo/dustavez my-docs
cd my-docs
npm install

Configure the site

Edit astro.config.ts in the project root. This controls Expressive Code themes and Astro integrations. Customize your site’s colors and typography through src/styles/tokens.css.

Add content

Create .mdx files inside content/docs/. Each file needs frontmatter with title, description, section, and order. The folder structure maps directly to sidebar navigation.

Note

Dustavez ships with carefully chosen defaults for colors and typography, so you can skip theming entirely and still get a polished result.

What you get

After cloning, your project looks like this. Content lives in content/docs/, styling tokens in src/styles/, and everything else is standard Astro.

my-docs/
  astro.config.ts          # Astro config + Expressive Code theme
  src/
    content.config.ts      # Content collection schema
    styles/
      tokens.css           # Design tokens (colors, spacing)
    components/
      mdx/                 # Custom MDX components
    lib/
      navigation.ts        # Sidebar + section ordering
    layouts/
      DocsLayout.astro     # Three-column docs layout
    pages/
      index.astro          # Landing page
      [...slug].astro      # Doc page renderer
  content/
    docs/
      getting-started/
        introduction.mdx   # Your documentation pages
        installation.mdx
      authoring/
        markdown-and-mdx.mdx
  public/
    fonts/                 # Self-hosted WOFF2 fonts
    favicon.svg
  package.json

Every .mdx file in content/docs/ becomes a page. Section groups are defined by the section field in frontmatter, and display order is controlled by SECTION_ORDER in src/lib/navigation.ts.

Next steps

Your site is running. From here:

Markdown & MDX →

Learn how to write content and use components inside your pages.

Colors & typography →

Customize the look and feel to match your brand.

Code blocks →

Syntax highlighting, line highlights, filenames, and copy buttons.

Deploy →

Ship to Vercel, Cloudflare Pages, or any static host.

Last updated: April 4, 2026

Edit this page on GitHub

← Previous

Introduction

Project structure