About Moonwalk

(138 Words, 1 Minutes)

Moonwalk is a fast, minimal Jekyll theme built for people who want their writing to look great without fighting their tools.

Why Moonwalk?

Most Jekyll themes fall into two camps - either so bare-bones that you spend hours styling, or so bloated with features that your Lighthouse score tanks before you write a single post.

Moonwalk sits in between. You get a polished reading experience, real dark mode, and a 100/100 Lighthouse score out of the box. No JavaScript frameworks. No build tools. No npm.

Features

Everything is opt-in via _config.yml - turn on only what you need:

• Light and dark mode with system preference detection and a manual toggle
• Reading progress bar so readers know how far along they are
• Back-to-top button for long posts
• Table of contents via toc: true in your post’s front matter
• Code copy button on every code block
• Previous/next post links at the bottom of each post
• GitHub Markdown Alerts for callouts (NOTE, TIP, WARNING, etc.)
• Card layout for portfolios and project showcases
• Tag archive with clickable, filterable tags

Getting started

1. Fork this repo or click “Use this template”
2. Edit _config.yml with your name, title, and preferences
3. Push - GitHub Pages deploys it automatically

For local development, run bin/bootstrap to install dependencies, then bin/start to preview at http://127.0.0.1:4000.

Design principles

• Writing first. Typography, spacing, and contrast are tuned for long-form reading.
• No lock-in. Standard Jekyll. No plugins you can’t replace, no proprietary services required.
• Performance is a feature. Every CSS rule earns its place. The entire theme compiles to a few kilobytes.

Credits

Moonwalk started as a fork of no style, please! by Riccardo Graziosi. It has since grown into its own thing, but the spirit of simplicity remains.

Built and maintained by Abhinav Saxena.