Export & Deploy

PDF Export

Export any presentation to a PDF file using the CLI:

pnpm supaslidev export my-presentation

The PDF is saved to dist/my-presentation.pdf by default.

Custom Output Path

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

pnpm supaslidev export my-presentation --output ./exports/quarterly-review.pdf

The output directory is created automatically if it doesn't exist.

Export from Dashboard

You can also export presentations through the dashboard UI:

1. Click the export button on any presentation card
2. The PDF opens in a new browser tab when complete

Deployment

Build all presentations and the dashboard into a unified static site:

pnpm supaslidev deploy

This command:

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

Output Location

The deployment package is created at deploy/ by default. Specify a custom location with the --output flag:

pnpm supaslidev deploy --output ./release

Set a custom base path for hosting under a subdirectory:

pnpm supaslidev deploy --base /slides/

Deployment Package Contents

deploy/
├── index.html              # Dashboard entry point
├── presentations.json      # Presentation catalog
├── presentations/
│   ├── quarterly-review/   # Built presentation (HTML, CSS, JS)
│   ├── product-launch/
│   └── team-onboarding/
├── vercel.json             # Vercel rewrite rules
├── netlify.toml            # Netlify redirect rules
└── package.json            # Minimal package with serve script

Deploy to Vercel

Deploy the package using the Vercel CLI:

cd deploy && vercel

Or push the deployment folder to Git and import the repository in the Vercel dashboard.

Deploy to Netlify

Deploy using the Netlify CLI:

cd deploy && netlify deploy --prod

Alternatively, connect your Git repository in the Netlify dashboard and configure the publish directory as deploy.

Preview Locally

Test the built site before deploying:

cd deploy && npx serve .

Output Locations Summary

Deploy Mode

When the dashboard is deployed as a static site (via pnpm deploy), it runs in deploy mode. In this mode:

• The dashboard reads presentation data from a static presentations.json file instead of the API
• Clicking a presentation opens the built static version directly
• Dev server controls (start/stop), export, and edit buttons are disabled and show a "Dev Mode Only" toast when clicked

Deploy mode is activated automatically when the site is built with pnpm deploy — no manual configuration is needed.

Advanced Export Options

Supaslidev uses Slidev's export and build commands under the hood. For advanced configuration options like custom formats, page ranges, or build settings, see the Slidev Export Documentation.

Next Steps