Welcome — your site is live!
GitHub Pages built this page from just three files in your repository. The layout, styles, and this entire onboarding screen are served by the remote theme.
Use the wizard below to generate a personalised
_config.yml, drop it into your repo, and your site
will look like your site instead of this welcome page.
-
_config.ymlrequired -
Gemfilerequired -
index.mdrequired -
pages/optional -
assets/optional
The 3-file starter
The only files you need in your repository for GitHub Pages to
render a full site through the bamr87/zer0-mistakes
remote theme.
The minimum viable configuration:
# _config.yml
title: "My Site"
description: "A site rendered by the zer0-mistakes remote theme."
url: ""
baseurl: ""
# Pull layouts/includes/assets from the published theme
remote_theme: bamr87/zer0-mistakes
# GitHub Pages whitelisted plugins
plugins:
- jekyll-remote-theme
- jekyll-feed
- jekyll-sitemap
- jekyll-seo-tag
# Hide this welcome screen once you're configured
site_configured: trueUse the wizard below to generate a richer file with collections, analytics, and social links.
Required when building locally; GitHub Pages installs these for you in CI.
# Gemfile
source "https://rubygems.org"
gem "github-pages", group: :jekyll_plugins
gem "jekyll-remote-theme"
gem "webrick", "~> 1.7"
While the site is unconfigured, layout: welcome
shows this onboarding screen. Once you set
site_configured: true in _config.yml,
the same file renders your own home-page content.
---
layout: welcome
title: Home
---
# Welcome to my site
Replace this with your own content. The setup wizard
will disappear automatically once `site_configured: true`
is set in `_config.yml`.bundle install && bundle exec jekyll serve
(or docker compose up if you have a
docker-compose.yml). Browse to
http://localhost:4000/.
Site Setup Wizard
Fill in the form to generate a personalised _config.yml.
Download it and replace the one in your project root.
Site Identity
my-site).URLs & Deployment
https://USERNAME.github.io/repo-name for project pages.false for local development.Content Collections
Toggle which content collections to enable.
Analytics & Integrations
Review Your Configuration
This is the _config.yml that will be generated. Review it, then download or copy.
Loading…
_config.yml in your project root with the downloaded file, then restart your dev server.
Next steps
Add content
Create a pages/ folder with collections like
_posts/, _docs/, or
_about/. Enable them in _config.yml.
Customise styles
Drop an assets/css/user-overrides.css file in
your repo to override theme styles without forking.
Source & issues
File issues, submit PRs, or fork the theme on GitHub. Contributions welcome.
Repository