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.
3.1 KiB
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
---