Quarto + Netlify Deployment Setup

Set up a Quarto project for Netlify deployment with RevealJS presentation support.

When to use

• When deploying a Quarto project to Netlify
• When setting up RevealJS presentations with Quarto
• When configuring automated builds for Quarto sites
• When you need the proven netlify.toml configuration for Quarto

Instructions

_quarto.yml Configuration

project:
  type: default
  output-dir: _site # Keep root clean, output to _site/
  render:
    - index.qmd

format:
  revealjs:
    output-file: slides.html
    theme: [default, custom.scss]
    slide-number: true
    # Add plugins as needed

netlify.toml (Proven Pattern)

[build]
  command = """
    curl -LO https://quarto.org/download/latest/quarto-linux-amd64.deb && \
    dpkg -x quarto-linux-amd64.deb . && \
    export PATH=$PWD/opt/quarto/bin:$PATH && \
    quarto render
  """
  publish = "_site"

[[redirects]]
  from = "/"
  to = "/slides.html"
  status = 302

Key points:

• Use .deb package with dpkg -x extraction (not tar.gz)
• Extract to current dir . (not a subfolder)
• Path is $PWD/opt/quarto/bin (not nested)
• Just quarto render (uses _quarto.yml automatically)

.gitignore

# Quarto output
/.quarto/
/_site/

# Node modules
node_modules/

# OS/Editor
.DS_Store
*.swp

Makefile

.PHONY: all render preview clean

render:
	quarto render index.qmd

preview:
	quarto preview index.qmd

clean:
	rm -rf _site .quarto

RevealJS Extensions

Copy _extensions/ folder for plugins:

• simplemenu - Navigation menu bar
• reveal-auto-agenda - Auto-generated agenda
• code-fullscreen - Expand code to fullscreen
• codefocus - Progressive line highlighting

Deployment Steps

1. gh repo create [name] --public --source=. --remote=origin
2. git push -u origin main
3. Netlify: Import from GitHub, auto-detects netlify.toml
4. Deploy triggers on push to main