hugo-PaperMod

GitHub

A fast, clean, responsive Hugo theme.

AI Prompts & Endpoints
CodeWiki Knowledge Base

Repository: adityatelange/hugo-PaperMod


Stars: 13372

README.md

Hugo PaperMod

A fast, clean, and responsive theme for Hugo.

![hugo-papermod](https://themes.gohugo.io/themes/hugo-papermod/)
![Minimum Hugo Version](https://github.com/gohugoio/hugo/releases/tag/v0.146.0)
![Discord](https://discord.gg/ahpmTvhVmp)

Based on hugo-paper, with additional features and customization options.

| Resource | Link |
| ------------------- | --------------------------------------------------------------------------------------- |
| Live Demo | adityatelange.github.io/hugo-PaperMod |
| Documentation 📚 | Wiki |
| Example Site Source | exampleSite branch |

<p align="center">
<kbd><img src="https://user-images.githubusercontent.com/21258296/114303440-bfc0ae80-9aeb-11eb-8cfa-48a4bb385a6d.png" alt="Mockup image" title="Mockup"/></kbd>
</p>

---

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 📈

![Stargazers over time](https://starchart.cc/adityatelange/hugo-PaperMod)