hosting

name	hosting
description	Build and deploy Slidev presentations

Hosting & Deployment

Build and deploy Slidev presentations.

Build for Production

slidev build

Output: dist/ folder (static SPA)

Options

slidev build --base /talks/my-talk/    # Custom base path
slidev build --out public              # Custom output dir
slidev build --download                # Include PDF
slidev build --without-notes           # Exclude notes

Multiple Presentations

slidev build slides1.md slides2.md

GitHub Pages

GitHub Actions

Create .github/workflows/deploy.yml:

name: Deploy

on:
  push:
    branches: [main]

permissions:
  contents: read
  pages: write
  id-token: write

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - uses: actions/setup-node@v4
        with:
          node-version: 'lts/*'

      - name: Install
        run: npm install

      - name: Build
        run: npm run build -- --base /${{ github.event.repository.name }}/

      - uses: actions/configure-pages@v4

      - uses: actions/upload-pages-artifact@v3
        with:
          path: dist

      - uses: actions/deploy-pages@v4

Netlify

Create netlify.toml:

[build]
  publish = 'dist'
  command = 'npm run build'

[[redirects]]
  from = '/*'
  to = '/index.html'
  status = 200

Vercel

Create vercel.json:

{
  "rewrites": [
    { "source": "/(.*)", "destination": "/index.html" }
  ]
}

Docker

Using Official Image

docker run --name slidev --rm -it \
  -v ${PWD}:/slidev \
  -p 3030:3030 \
  tangramor/slidev:latest

Custom Dockerfile

FROM tangramor/slidev:latest

COPY slides.md .
COPY public ./public

RUN npm run build

EXPOSE 80
CMD ["npx", "serve", "dist"]

Base Path

For subdirectory deployment:

# Build
slidev build --base /my-slides/

# Or in headmatter
---
base: /my-slides/
---

Router Mode

For servers without rewrite support:

---
routerMode: hash
---

URLs become: /#/1, /#/2, etc.