adityatelange

hugo-PaperMod: Build Fast, Responsive Hugo Sites

Hugo PaperMod is a fast, clean, responsive theme for the Hugo static site generator. It gives blogs and portfolios configurable layouts, multilingual support, search, and built-in SEO without requiring JavaScript build tooling.

Stars
14k
Forks
3.4k
Stars, last 30 days
+44
Last commit
7 days ago
Contributors
100+

Our take

Activeregular commits

Health score

48/100

How it is scored
Activity
35
Community
71
Issues
41
Pull requests
43

+44 stars in the last 30 days

  • More contributors than 78% of the projects we track
  • Slower to close issues than 84% of the projects we track

PaperMod is an actively maintained, feature-rich Hugo theme with recent commits, though its release history is less current than its commit activity.

Good fit if

  • You are building a blog or portfolio with Hugo and want the theme's built-in layouts and publishing features.
  • You want multilingual support, client-side search, and SEO metadata without adding a JavaScript build toolchain.
  • You value recent repository activity and a large contributor base; contributions are not measured as concentrated around one person.

Look elsewhere if

  • Your site is not built with Hugo, or you need a theme designed for a different platform.
  • Your adoption process requires a release within the past year; the repository has recent commits, but no release in that period.
  • You need a project with a short issue-resolution history; reported issue handling has a median closure time of 78 days.
All health signals
Last commit2026-10-25 (7 days ago)
Commits, last 90 days13
Releases, last 12 months0 (latest v8.0, 2024-11-03)
Contributors100+ (top contributor: 67% of commits)
Issues closed, last 90 days6 (typically closed in 78 days)
Pull requests merged, last 90 days1
Project age6 years

Checked on 2026-11-02 with the GitHub API.

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

14,046

Forks

3,427

Change since Nov 17, 2026: +2 stars·-2 forks

Overview

Hugo PaperMod is a fast, clean, responsive theme built for Hugo, the static site generator. It helps people create blogs and portfolio sites with configurable layouts and common publishing features, without adding a separate JavaScript build toolchain.

Based on the hugo-paper theme, PaperMod adds further features and customization options. It supports regular, home-info, and profile layouts, as well as multilingual sites and light or dark appearance settings. The project provides a live demo, an example site, and detailed documentation in its wiki.

Key Features

  • Three homepage layout modes: regular, home-info, and profile.
  • Light and dark themes, with automatic browser-preference detection and a manual toggle.
  • Multilingual support with a language selector.
  • Client-side search powered by Fuse.js.
  • SEO metadata including Open Graph, Twitter Cards, and Schema.org structured data.
  • Publishing tools including cover images, tables of contents, archives, taxonomies, and related-post suggestions.
  • Social links, share buttons, breadcrumbs, and multiple-author support.
  • Hugo asset processing with fingerprinting, bundling, and minification, with no JavaScript build dependencies.

Use Cases

  • Hugo bloggers who want a responsive theme with search, archives, and post-level features ready to configure.
  • Portfolio owners who want a profile-style homepage rather than a conventional post list.
  • Multilingual publishers who need a theme with a built-in language selector.
  • Hugo site maintainers who want to customize templates through documented overrides instead of maintaining a fork.

What you need

Detected in the repository

  • Go 1.16 or newer (from go.mod)
  • Automated checks on GitHub Actions

License in plain words

MITpermissive

  • Commercial use: yes
  • Modify and redistribute: yes
  • You must keep: the copyright and license notice
  • Share your changes: no

A summary, not legal advice: the LICENSE file is what applies.

Getting Started

Follow the installation guide to add and configure the theme. The example site source provides a working configuration; see the README for project links and feature documentation.

Alternatives

  • hextra: Hextra is another Hugo theme, oriented toward documentation sites as well as blogs, while PaperMod focuses on blogs and portfolios.
ProjectLanguageLicenseStarsStatus
hugo-PaperModHTMLMIT14kActive
hextraHTMLMIT2.4kActive

Considerations

The README specifies Hugo v0.158.0 or later, while repository metadata lists Go 1.16 as a runtime requirement. The project reports no tests, so teams that require an established automated test suite should account for that. It has continued commit activity, but has not published a release in over a year; its measured median issue closure time is also relatively long. Review the installation and configuration documentation to confirm the theme fits your Hugo setup.

Found this useful?

Share it with someone who would like hugo-PaperMod.

Comparisons