HugoPortfolioBlog

hugo-PaperMod — Hugo Portfolio Template

By adityatelange

Hugo PaperMod: a responsive blog and portfolio theme built on Hugo, with three layout modes, light and dark themes, client-side search, and multilingual support.

Open Source Site Download Source ZIP

Explore the design

Compare the page layouts and mobile experience. Open any screenshot for a closer look.

4 previews

Desktop homepage1 / 4

Visit websiteOpens in a new tab

Desktop capture

The actual desktop layout captured from the demo homepage.

All pages & views 4

Screenshots show visual appearance; interactive behavior may differ.

Recorded 2026-09-27View source

What stands out

A quick read of the recorded project description.

Three layout modes: Regular, Home-Info, and Profile, which can correspond to a blog homepage and a personal homepage respectively

Light and dark themes automatically follow browser preferences, with a manual toggle retained

Client-side search based on Fuse.js, with no additional search service required

Built-in Open Graph, Twitter Cards, and Schema.org structured data

Zero JS build dependencies, with no webpack or Node.js toolchain required

Requires Hugo v0.146.0 or later

Template Details

PaperMod is one of the better-known themes in the Hugo ecosystem, with a clear positioning: it provides a clean, responsive reading interface for blogs and lightweight portfolio sites. It is extended from hugo-paper, adding more configuration options and layout modes. The three layouts listed in the README—Regular, Home-Info, and Profile—are its main structural differences from ordinary blog themes; Profile mode is especially suited to using the homepage as a personal introduction page.

In terms of capabilities, the theme covers common needs for content sites: Hugo's built-in asset pipeline handles fingerprinting, bundling, and minification; light and dark themes can follow browser preferences automatically and can also be switched manually; multilingual support includes a language selector; search is performed client-side by Fuse.js; and SEO includes built-in Open Graph, Twitter Cards, and Schema.org structured data. At the article level, it offers cover images, automatic table of contents, multiple authors, social icons and share buttons, breadcrumbs, archives and categories, code block copy buttons, and related post recommendations. The README specifically emphasizes zero JS build dependencies, requiring no webpack or Node.js toolchain, which lowers the barrier for people who just want to write Markdown.

It is worth noting that the README only states that this is a Hugo theme and does not cover any backend, comment system, or data storage integration; these capabilities need to be verified independently. In addition, the theme requires Hugo v0.146.0 or later, so it is advisable to confirm compatibility before upgrading Hugo. Installation, feature details, and template override methods are placed in the GitHub Wiki rather than the README body, so it takes some time to read the documentation before getting started.

HugoPortfolioBlog

Is it right for your project?

Use Cases

Personal technical blogs or writing sites that need clean typography and a good reading experience
A personal introduction page or lightweight portfolio built with Profile mode
Multilingual content sites that need a language selector and category archives
Projects that want to avoid a front-end build toolchain and maintain only Markdown content

Suitable For

Developers and writers who already use Hugo or are willing to learn it
Blog projects that prefer static sites and do not rely on backend services
Content sites that need multiple authors, multiple languages, or category archives
Users who want a deeply customizable theme that can be modified through template overrides rather than by forking

Getting started & customization

Use these recorded setup notes alongside the repository instructions for your chosen version.

1
The theme requires Hugo v0.146.0 or later; confirm your local Hugo version before installation
2
Installation, updates, feature configuration, and template override instructions are concentrated in the GitHub Wiki; the README itself does not expand on them
3
The README does not mention comment systems, backend interfaces, or data storage; if these capabilities are needed, verify and integrate them yourself
4
The example site source code is located in the exampleSite branch and can be used as a configuration reference

Read repository instructions

License & source material

Usage conditions & limitations

Free to use · keep license notice

This entry covers the free MIT version in the public repository; the free scope applies to that version's code and does not mean that external services or third-party assets are free.

Must comply with when using

When using, modifying, or distributing the code, retain the original author's copyright notice and the complete MIT license.
Free use, modification, and commercial use are permitted, as is distribution of the code; distribution must still include the copyright and license notice.
The code is provided as is, without warranties; the MIT license also disclaims author and copyright-holder liability.

Additional costs & items to verify

Demo images, fonts, icons, and other third-party assets must be checked against their respective licenses; they cannot be judged solely by the code's MIT license.
External services such as domains, hosting, databases, payments, or AI may incur separate charges.

View Original Text Basis

Permission is hereby granted, free of charge
Original License Text

https://github.com/adityatelange/hugo-PaperMod/blob/master/LICENSE https://github.com/adityatelange/hugo-PaperMod/blob/master/README.md

Based on the full MIT license and the repository README · 2026-09-27. Results only cover the materials read; dependencies, images, fonts, and subsequent term changes are subject to their respective original texts.

Project checks & description sources

Template Information

Source platforms: Hugo Themes
Documentation and maintenance reference score: More documented · 100 / 100
Technologies: Hugo
Website type: Portfolio · Blog

How this score is calculated

Our heuristic uses license records (up to 30), a demo link (12), a preview (10), stars (15), recorded maintenance (15), description completeness (8), feature records (5) and classification data (5). It is not a code, security or performance test, or a Google score. A link does not establish tested functionality.

What to verify for this project

Repository update recorded: 2026-08-02
Screenshot last checked: 2026-09-27

A demo link is listed. Check it with your own content and viewport sizes; its presence does not confirm that forms, authentication or payments work.

The catalog identifies Hugo as the primary stack. Check the actual dependency manifest and lockfile for versions and hosting requirements. These notes use recorded metadata, not a code audit or a deployment test.

Repository file check

Checked: 2026-09-30 · File inspection only; dependencies have not been installed or tested.

README.mdpackage.json: not retrieved at repository root (HTTP 404)

Use a selection guide →

How this description was prepared

AI-assisted description based on catalog records and repository material. Repository authors are not automatically the reviewers of this description.

Review declaration: Codex（本次来源核对） · 2026-09-27

Inspect the recorded source material

SHA-256: 0105111c445643038678b0427b1de3569716333ceebaa6dd36085a87145dc1c8

2026-09-27T12:06:41.222Z

Source file / repository

# Hugo PaperMod

**A fast, clean, and responsive theme for [Hugo](https://gohugo.io/).**

[![hugo-papermod](https://img.shields.io/badge/Hugo--Themes-@PaperMod-blue)](https://themes.gohugo.io/themes/hugo-papermod/)
[![Minimum Hugo Version](https://img.shields.io/static/v1?label=Hugo&message=v0.146.0%2B&color=blue&logo=hugo)](https://github.com/gohugoio/hugo/releases/tag/v0.146.0)
[![Discord](https://img.shields.io/discord/971046860317921340?label=Discord&logo=discord)](https://discord.gg/ahpmTvhVmp)

> Based on [hugo-paper](https://github.com/nanxiaobei/hugo-paper/tree/4330c8b12aa48bfdecbcad6ad66145f679a430b3), with additional features and customization options.

<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&amp;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>

---

## Features 💥

`☄️ Fast | ☁️ Fluent | 🌙 Smooth | 📱 Responsive`

- **Asset pipeline** -- Hugo's built-in asset generator with fingerprinting, bundling, and minification.
- **Three layout modes** -- [Regular](https://github.com/adityatelange/hugo-PaperMod/wiki/Features#regular-mode-default-mode), [Home-Info](https://github.com/adityatelange/hugo-PaperMod/wiki/Features#home-info-mode), and [Profile](https://github.com/adityatelange/hugo-PaperMod/wiki/Features#profile-mode).
- **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](https://github.com/adityatelange/hugo-PaperMod/wiki/Installation)**        | Detailed installation and update instructions   |
| **[Features wiki page](https://github.com/adityatelange/hugo-PaperMod/wiki/Features)**            | In-depth explanations of all features           |
| **[FAQ wiki](https://github.com/adityatelange/hugo-PaperMod/wiki/FAQs)**                          | Common questions and configuration walkthroughs |
| **[Icons wiki](https://github.com/adityatelange/hugo-PaperMod/wiki/Icons)**                       | Documentation for social icons and share icons  |
| **[Variables wiki](https://github.com/adityatelange/hugo-PaperMod/wiki/Variables)**               | List of all available template variables        |
| **[Overiding templates](https://github.com/adityatelange/hugo-PaperMod/wiki/Template_Overrides)** | Guide to customizing templates without forking  |
| **[Releases](https://github.com/adityatelange/hugo-PaperMod/releases)**                           | Detailed history of releases                    |

---

## Performance ☄️

PaperMod consistently scores near-perfect results on [Pagespeed Insights](https://pagespeed.web.dev/report?url=https://adityatelange.github.io/hugo-PaperMod/).

<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](https://github.com/sponsors/adityatelange) or [Ko-Fi](https://ko-fi.com/adityatelange).

---

## Special Thanks 🌟

- [Highlight.js](https://github.com/highlightjs/highlight.js)
- [Fuse.js](https://github.com/krisk/fuse)
- [Feather Icons](https://github.com/feathericons/feather)
- [Simple Icons](https://github.com/simple-icons/simple-icons)
- All contributors and supporters

Report a correction

Explore similar templates

Compare previews and descriptions within the same stack and category.

LoveIt

LoveIt is a clean, elegant, and feature-rich Hugo blog theme derived from LeaveIt and KeepIt, MIT-licensed. It offers light/dark modes, responsive layout, multilingual support, and search via Lunr.js or Algolia.

Hugo · Blog

hugo-coder

hugo-coder is a minimalist Hugo blog theme maintained by luizdepra under the MIT license. It provides a clean, text-focused blog appearance, configuration documentation in the docs directory, and a complete exampleSite with hugo.toml.

Hugo · Blog

blowfish

Blowfish is a Hugo personal website and blog theme built with Tailwind CSS 4, focused on lightness, simplicity, and content-first presentation.

Hugo · Blog

hugo-paper

hugo-paper is a simple, clean, and customizable Hugo blog theme configured through config.toml or hugo.toml.

Hugo · Blog

hextra

Hextra is a Hugo theme for documentation and blog sites, built on Hugo and Tailwind CSS with design referencing Nextra.

Hugo · Documentation

Congo

Congo is a minimal Hugo content theme built on Tailwind CSS 3.0, designed for blogs, portfolios, and lightweight content sites. It offers multiple homepage layouts, customizable dark mode, multilingual support including RTL, and built-in client-side search, Mermaid, Chart.js, and KaTeX.

Hugo · Blog