Deployment
Deploy your Zer0-Mistakes Jekyll site to various hosting platforms.
Table of Contents
Deployment
Deploy your Zer0-Mistakes Jekyll site to various hosting platforms.
Hosting Options
| Platform | Pros | Cons |
|---|---|---|
| GitHub Pages | Free, automatic deploys, built-in CI | Limited plugins, whitelist only |
| Netlify | Free tier, custom headers, forms | Requires separate account |
| Vercel | Fast CDN, serverless functions | Jekyll not primary focus |
| Self-hosted | Full control | Requires server management |
Guides in This Section
- GitHub Pages — Deploy to GitHub’s free hosting
- Remote-Theme Consumer Checklist — What
remote_themedoes not deliver, and how to fill the gaps - Safe-Mode Build Overlay — Reproduce a GitHub Pages build in your own CI (clone → overlay → strip
_plugins→ strict build) - Netlify — Deploy with custom headers and redirects
- Custom Domain — Set up your own domain name
Quick Deploy
GitHub Pages (Fastest)
- Push your site to a GitHub repository
- Go to Settings → Pages
- Select your branch (usually
main) - Site deploys automatically
Netlify (Most Features)
- Connect your GitHub repository to Netlify
- Set build command:
jekyll build - Set publish directory:
_site - Deploy triggers on every push
Environment Configuration
The theme uses dual configuration for different environments:
| File | Purpose |
|---|---|
_config.yml |
Production settings |
_config_dev.yml |
Development overrides |
In production, ensure:
posthog.enabled: true(if using analytics)urlmatches your domainbaseurlis set correctly for subpaths
Next Steps
- GitHub Pages Guide — Free hosting with automatic deploys
- Netlify Guide — Advanced hosting features
- Custom Domain Setup — Use your own domain