Hugo PaperMod
A fast, clean, responsive Hugo theme.
**A fast, clean, and responsive theme for [Hugo](https://gohugo.io/).** The project is written primarily in HTML, distributed under the MIT License license, first published in 2020. It has gained significant community traction with 13,679 stars and 3,401 forks on GitHub. Key topics include: blog, blog-theme, clean, fast, feature-rich.
Latest release: v8.0— Release v8.0 🎈
November 3, 2024View Changelog →
Hugo PaperMod
A fast, clean, and responsive theme for Hugo.
<table> <tbody> <tr> <td>Live Demo</td> <td><a href="https://adityatelange.github.io/hugo-PaperMod/">adityatelange.github.io/hugo-PaperMod</a></td> </tr> <tr> <td>Documentation 📚</td> <td><a href="https://github.com/adityatelange/hugo-PaperMod/wiki">Github Wiki</a></td> </tr> <tr> <td>Example Site Source</td> <td><a href="https://github.com/adityatelange/hugo-PaperMod/tree/exampleSite">exampleSite branch</a></td> </tr> <tr> <td><a href="https://www.star-history.com/adityatelange/hugo-papermod"><img src="https://api.star-history.com/badge?repo=adityatelange/hugo-PaperMod&theme=dark" alt="Star History Rank" /></a></td> <td><a href="https://ko-fi.com/H2H229ZWH"><img src="https://ko-fi.com/img/githubbutton_sm.svg" alt="ko-fi" /></a></td> </tr> </tbody> </table> <p align="center"> <img src="https://user-images.githubusercontent.com/21258296/114303440-bfc0ae80-9aeb-11eb-8cfa-48a4bb385a6d.png" alt="Mockup image" title="Mockup"/> </p>Based on hugo-paper, with additional features and customization options.
Features 💥
☄️ Fast | ☁️ Fluent | 🌙 Smooth | 📱 Responsive
- Asset pipeline -- Hugo's built-in asset generator with fingerprinting, bundling, and minification.
- Three layout modes -- Regular, Home-Info, and Profile.
- Light and dark themes -- Automatic switching based on browser preference, plus a manual toggle.
- Multilingual support -- Includes a built-in language selector.
- Search -- Client-side search powered by Fuse.js.
- SEO optimized -- Open Graph, Twitter Cards, and Schema.org structured data out of the box.
- Cover images -- Per-post cover images with responsive image support.
- Table of contents -- Auto-generated from heading structure.
- Multiple authors -- Native support for multi-author sites.
- Social icons and share buttons -- Configurable social links and per-post sharing.
- Breadcrumb navigation
- Post archives and taxonomies
- Code block copy buttons -- One-click copying with Chroma syntax highlighting.
- Related post suggestions
- Zero JS build dependencies -- No webpack, Node.js, or other tooling required.
| Topic | Description |
|---|---|
| Installation guide | Detailed installation and update instructions |
| Features wiki page | In-depth explanations of all features |
| FAQ wiki | Common questions and configuration walkthroughs |
| Icons wiki | Documentation for social icons and share icons |
| Variables wiki | List of all available template variables |
| Overiding templates | Guide to customizing templates without forking |
| Releases | Detailed history of releases |
Performance ☄️
PaperMod consistently scores near-perfect results on Pagespeed Insights.
<img width="481" height="116" alt="image" src="https://github.com/user-attachments/assets/497d831b-d143-4a46-bc11-b1d7f8ef4a83" />Support 🫶
- Star this repository to show your support.
- Share PaperMod with others who might find it useful.
- Sponsor the project on GitHub Sponsors or Ko-Fi.
Special Thanks 🌟
- Highlight.js
- Fuse.js
- Feather Icons
- Simple Icons
- All contributors and supporters
Stargazers 📈
Contributors
Showing top 12 contributors by commit count.
This article is auto-generated from adityatelange/hugo-PaperMod via the GitHub API.Last fetched: 6/18/2026
