Dashboard Overview

Launching the Dashboard

Start the dashboard from your workspace root:

pnpm dev

This command:

1. Scans the presentations/ directory and generates presentation metadata
2. Starts an API server to manage presentation dev servers
3. Launches the dashboard UI in your browser

The dashboard automatically detects all presentations in your workspace and displays them in a grid layout.

Dashboard Interface

The dashboard UI provides a visual way to manage your presentations.

Header

The header displays the Supaslidev title and a New Presentation button. Click this button to create a new presentation directly from the interface.

Search and Filter

A search input lets you filter presentations by title. As you type, the grid updates to show only matching presentations.

Presentation Cards

Each presentation appears as a card displaying:

• Thumbnail: A preview image if the presentation has a background configured
• Title: The presentation name from its frontmatter
• Description: Optional description from the presentation's metadata
• Theme badge: Shows which Slidev theme the presentation uses
• Duration badge: Displays the estimated presentation duration if configured
• Status indicator: A green dot appears when the dev server is running
• Present/Stop button: Starts or stops the presentation's dev server

Interacting with Presentations

Starting a presentation: Click the Present button on a card. The dashboard starts a Slidev dev server and opens the presentation in a new browser tab.

Stopping a server: When a presentation is running, the button changes to Stop. Click it to shut down that presentation's dev server.

Opening a running presentation: Click anywhere on a card with a running server to open the presentation in a new tab.

CLI Commands

The dashboard package also provides CLI commands for scriptable workflows.

pnpm dev

Starts the interactive dashboard UI.

pnpm dev

This is the default command. Running pnpm dev without arguments launches the full dashboard interface.

pnpm present <name>

Starts a Slidev dev server for a specific presentation without the dashboard UI.

pnpm present my-talk

Use this when you want to work on a single presentation and don't need the full dashboard interface.

pnpm new [name]

Creates a new presentation in the workspace.

pnpm new quarterly-review

This command:

1. Validates the name (lowercase alphanumeric with hyphens only)
2. Checks that a presentation with that name doesn't already exist
3. Runs pnpm create slidev in the presentations directory
4. Sets up the new presentation with catalog dependencies

If you omit the name, the command launches Slidev's interactive setup wizard.

pnpm new

pnpm export <name>

Exports a presentation to PDF.

pnpm export my-talk

By default, the PDF is saved to dist/<name>.pdf in your workspace root.

Specify a custom output path with the --output flag:

pnpm export my-talk --output ./exports/presentation.pdf

pnpm deploy

Builds all presentations and the dashboard into a unified static site.

pnpm deploy

This command:

1. Builds every presentation using slidev build
2. Generates a presentations.json catalog
3. Builds the Nuxt dashboard in static mode
4. Assembles a unified output directory with the dashboard and all presentations

The output directory contains everything needed to deploy:

deploy/
├── index.html              # Dashboard entry point
├── presentations.json      # Presentation catalog
├── presentations/
│   ├── my-talk/            # Built presentation files
│   └── other-talk/
├── vercel.json             # Vercel rewrite rules
├── netlify.toml            # Netlify redirect rules
└── package.json            # Minimal package with serve script

Specify a custom output directory or base path:

pnpm deploy --output ./release
pnpm deploy --base /slides/

After running the command, deploy with your preferred platform:

# Vercel
cd deploy && vercel

# Netlify
cd deploy && netlify deploy --prod

Command Summary

Next Steps

Learn about getting started with quick start or explore export and deploy options for hosting your slides.