Moonwalk is a fast and minimalistic Hugo blog theme ported from the original moonwalk theme by abhinavs, designed to help you launch a clean, data-driven personal blog or portfolio with minimal configuration. You can see a live demo at https://arkhamcookie.github.io/moonwalk-hugo.
What is moonwalk?
Moonwalk is a Hugo theme that gives you a simple, responsive blog layout with automatic light/dark mode and configurable sections. It takes Hugo content and data files as input and produces a static site that can be deployed on GitHub Pages. The theme is maintained by ArkhamCookie on GitHub, who created this port of the original theme.
Key Features
- Light/dark theme — Automatically switches based on your browser's theme preference, with an optional manual theme-switch button.
- Data-driven content — Configure your site's content and layout through data files in the data/ directory instead of hardcoding everything in templates.
- Configurable sections — Show or hide sections of the layout through data/config.toml, so you control exactly what appears.
- Three list layouts — Choose between vertical, horizontal, or card lists for presenting posts or links on your pages.
- Responsive and mobile friendly — The layout adapts to any screen size out of the box.
- Easy to extend — Built as a Hugo port with plain templates, so customizing or adding features is straightforward.
- GitHub Pages compatible — Publish directly to GitHub Pages with no extra build configuration.
Who is it for?
- Personal bloggers who want a fast, minimal blog without the overhead of a full-featured theme.
- Developers who prefer data-driven Hugo themes and want to manage their site's content in TOML data files.
- Portfolio owners looking for a clean layout to showcase projects using card lists and light/dark mode.
- Open-source contributors who want a small, maintainable Hugo theme that is easy to fork and customize.
What can you do with moonwalk?
- Bloggers: set up a blog with automatic dark mode and responsive layouts in minutes.
- Portfolio owners: display projects using card lists and horizontal lists for a minimal, professional look.
- Documentation maintainers: use the configurable sections to present curated links and content without writing much template code.
How does moonwalk work?
Content is organized as standard Hugo markdown files, while site configuration lives in config.toml and data files. You toggle sections via data/config.toml, and the theme renders your posts and lists accordingly. Because it's data-driven, you can change the look and content without editing the theme's templates directly.
FAQ
Does moonwalk support dark mode?
Yes, moonwalk automatically switches between light and dark themes based on your browser's theme setting, and you can also toggle the theme manually with a button on the page.
Is moonwalk compatible with GitHub Pages?
Yes, the theme is fully compatible with GitHub Pages, so you can deploy your Hugo site to GitHub Pages without extra configuration.
How do I configure sections in moonwalk?
Sections are configured through data/config.toml. You can show or hide sections by editing the file, and content is managed in data files.
Is moonwalk free to use?
Moonwalk is open source on GitHub, meaning you can download, modify, and use it freely. The source code is available under the repository.
