Configuration

Complete reference for deck.config.ts and slide frontmatter options.

deck.config.ts

Each deck directory contains a deck.config.ts file that defines project-level settings. The defineConfig helper is imported from the DexCode source:

typescript

import { defineConfig } from "../../src/lib/deck-config";
 
export default defineConfig({
  title: "My Presentation",
 
  // Theme (required)
  theme: {
    colors: {
      primary: "#02001A",
      secondary: "#02001A",
      background: "#FFFFFF",
      text: "#1a1a1a",
    },
    fonts: {
      heading: "Inter, sans-serif",
      body: "Noto Sans JP, sans-serif",
    },
  },
 
  // Optional: Logo overlay
  logo: {
    src: "/my-logo.svg",
    position: "top-right",
  },
 
  // Optional: Copyright text
  copyright: {
    text: "© 2026 My Company",
    position: "bottom-left",
  },
 
  // Optional: Page numbers
  pageNumber: {
    position: "bottom-right",
    hideOnCover: true,
  },
 
  // Optional: Default transition
  transition: "fade",
});

Configuration Options

Slide Frontmatter

Each MDX slide file can include frontmatter to configure that slide:

mdx

---
type: cover
background: "linear-gradient(135deg, #1a1a2e, #111)"
transition: fade
notes: "Remember to mention the Q2 numbers here."
verticalAlign: center
---

Frontmatter Fields

Available Slide Types

Type	Description
`content`	Standard single-column slide (default)
`cover`	Full-bleed cover slide with centered content
`section`	Section divider slide
`comparison`	Side-by-side comparison layout
`stats`	Statistics and metrics display
`timeline`	Timeline visualization
`image-left`	Image on left, text on right
`image-right`	Text on left, image on right
`image-full`	Full-bleed image slide
`quote`	Quotation slide
`agenda`	Agenda/table of contents slide
`ending`	Thank you / closing slide