Deployment Guide for Netlify

Option 2: Manual Deployment

If you prefer to deploy manually without CI/CD:

  1. Build your site locally:

    quarto render
  2. Deploy the _site folder:

    • Drag and drop the _site folder to Netlify’s deploy page

    • Or use Netlify CLI:

      npm install -g netlify-cli
      netlify deploy --prod --dir=_site

Files Included for Netlify

  • netlify.toml - Netlify configuration file
  • .gitignore - Already excludes _site folder

Important Notes

  1. Remove old distill files: Delete these if they exist:

    • _site.yml (replaced by _quarto.yml)
    • Old R Markdown files (.Rmd)
    • distill-specific configuration
  2. Custom domain: If you have a custom domain, keep your DNS settings in Netlify

  3. Redirects: The netlify.toml includes a catch-all redirect for client-side routing

  4. Build time: First build may take 2-3 minutes


Troubleshooting

Build fails with “quarto: command not found”

Make sure QUARTO_VERSION environment variable is set in Netlify.

CSS/styling issues

Clear your browser cache or do a hard refresh (Ctrl+Shift+R).

404 errors

Check that publish directory is set to _site (not _site/ or docs).


Resources