Files
Panama/user/agents/skills/slidev/references/core-headmatter.md
T
Gabriel Brown 89761a7da3 Keep the personal half of the desktop in one place, and ask before installing it
Agent instructions, skills, SSH host aliases and expansion triggers are worth
having identical on every machine one person owns, and belong in none of the
shared configuration. They live in user/ now, with a manifest saying where each
piece goes and a link-user stage that puts it there.

That stage does nothing unless the machine said yes. Somebody who clones Panama
to try the desktop keeps their own ~/.claude/CLAUDE.md exactly where it was;
the question names the destinations and defaults to no. Anything displaced goes
to config/old rather than being deleted.

~/.claude/CLAUDE.md and ~/.codex/AGENTS.md were byte-identical copies of one
file, which is the drift this exists to prevent.

Also adds the vitals toggles for the battery and Claude usage readouts, which
had preferences and no way to reach them.
2026-08-22 08:54:43 -04:00

3.1 KiB

name, description
name description
headmatter Deck-wide configuration options in the first frontmatter block

Headmatter Configuration

Deck-wide configuration options in the first frontmatter block.

Theme & Appearance

---
theme: default              # Theme package or path
colorSchema: auto           # 'auto' | 'light' | 'dark'
favicon: /favicon.ico       # Favicon URL
aspectRatio: 16/9           # Slide aspect ratio
canvasWidth: 980            # Canvas width in px
---

Fonts

---
fonts:
  sans: Roboto
  serif: Roboto Slab
  mono: Fira Code
  provider: google          # 'google' | 'none'
---

Code & Highlighting

---
highlighter: shiki          # Code highlighter
lineNumbers: false          # Show line numbers
monaco: true                # Enable Monaco editor ('true' | 'dev' | 'build')
twoslash: true              # Enable TwoSlash
monacoTypesSource: local    # 'local' | 'cdn' | 'none'
---

Features

---
drawings:
  enabled: true             # Enable drawing mode
  persist: false            # Save drawings
  presenterOnly: false      # Only presenter can draw
  syncAll: true             # Sync across instances
record: dev                 # Enable recording
selectable: true            # Text selection
contextMenu: true           # Right-click menu
wakeLock: true              # Prevent screen sleep
---

Export & Build

---
download: false             # PDF download button
exportFilename: slides      # Export filename
export:
  format: pdf
  timeout: 30000
  withClicks: false
  withToc: false
---

Info & SEO

---
title: My Presentation
titleTemplate: '%s - Slidev'
author: Your Name
keywords: slidev, presentation
info: |
  ## About
  Presentation description
---

SEO Meta Tags

---
seoMeta:
  ogTitle: Presentation Title
  ogDescription: Description
  ogImage: https://example.com/og.png
  ogUrl: https://example.com
  twitterCard: summary_large_image
  twitterTitle: Title
  twitterDescription: Description
  twitterImage: https://example.com/twitter.png
---

Addons & Themes

---
theme: seriph
addons:
  - excalidraw
  - '@slidev/plugin-notes'
---

Theme Configuration

---
themeConfig:
  primary: '#5d8392'
  # Theme-specific options
---

Defaults

Set default frontmatter for all slides:

---
defaults:
  layout: default
  transition: fade
---

HTML Attributes

---
htmlAttrs:
  dir: ltr
  lang: en
---

Presenter & Browser

---
presenter: true             # 'true' | 'dev' | 'build'
browserExporter: dev        # 'true' | 'dev' | 'build'
routerMode: history         # 'history' | 'hash'
---

Remote Assets

---
remoteAssets: false         # Download remote assets locally
plantUmlServer: https://www.plantuml.com/plantuml
---

Full Template

---
theme: default
title: Presentation Title
author: Your Name
highlighter: shiki
lineNumbers: true
transition: slide-left
aspectRatio: 16/9
canvasWidth: 980
fonts:
  sans: Roboto
  mono: Fira Code
drawings:
  enabled: true
  persist: true
download: true
---