Zer0-Mistakes Quickstart Guides
Pick the fastest path to a live Zer0-Mistakes site — a three-file remote-theme starter, the fork-and-deploy GitHub Pages workflow, or a step-by-step series.
Table of Contents
Quickstart Guides
This hub points you at the fastest route from zero to a published Zer0-Mistakes site. Every guide below is self-contained — start with the one that matches how much you want to own.
Choose your path
| Guide | Best for | Time |
|---|---|---|
| Bare-Minimum Remote-Theme Starter | Trying the theme with the fewest files (_config.yml, Gemfile, index.md) |
~5 min |
| Fork & Deploy to GitHub Pages | A real site you own and customize, deployed on GitHub Pages | ~15 min |
What you need first
All paths assume you have:
- A GitHub account.
- Git installed locally (or you can work entirely in the GitHub web UI for the remote-theme path).
- Optionally Docker for the recommended local development loop.
If you have never built a Jekyll site before, the Getting Started overview covers installing those tools first.
Two ways to consume the theme
There are two supported models, and the guides above cover both:
- Remote theme — your repository keeps only your content and
configuration, and pulls layouts/includes/styles from
bamr87/zer0-mistakesat build time. Lowest maintenance; start with the Bare-Minimum Starter. - Fork — you copy the whole theme into your repository so you can edit layouts and styles directly. Most control; follow Fork & Deploy.
Next steps
- New to the theme’s structure? Read the Getting Started overview.
- Ready to publish? Every path ends at the Deploy to GitHub Pages reference.
- Want to customize the look? See the Theme Guide.