hugo-PaperMod
A fast, clean, responsive Hugo theme.
PaperMod is a fast, clean Hugo theme for blogs and personal sites. It offers light and dark mode, three home page layouts, browser-side search, and multilingual support with zero JavaScript build dependencies.
Hugo PaperMod is a theme for Hugo. Hugo is a tool that builds a complete website out of plain text files, which people often use for blogs and personal sites because it produces pages that load quickly and do not need a database behind them. A theme decides how that site looks and behaves: its layout, colors, navigation, and built-in features. PaperMod is described as a fast, clean, and responsive theme, meaning it adjusts to fit phones, tablets, and desktops. It is based on an earlier theme called hugo-paper, with extra features and customization options added.
The README lists what the theme offers. It includes three layout modes for the home page, called Regular, Home-Info, and Profile, so you can present the site in different styles. It supports both light and dark appearances, switching automatically based on the visitor's browser setting and also offering a manual toggle. There is multilingual support with a language selector, and a search feature that runs entirely in the visitor's browser using a small library called Fuse.js.
Other features cover the things a blog usually needs. Posts can have cover images, an automatically generated table of contents from their headings, related-post suggestions, breadcrumb navigation, and archive and category pages. There is support for multiple authors, social media icons, and per-post share buttons. Code examples get syntax coloring and a one-click copy button. The theme also includes settings for search engines and social previews, such as Open Graph and Twitter Cards, out of the box.
One point the README stresses is simplicity of setup. It states there are zero JavaScript build dependencies, so you do not need extra tooling like webpack or Node.js to use it. It also reports that the theme scores near the top on a common web performance test.
The README itself is mostly a summary and a set of links. Detailed installation steps, feature explanations, a list of configuration variables, and a frequently asked questions section all live in the project's separate wiki rather than in the README. A live demo site is linked for anyone who wants to see it in action first.
Where it fits
- Launch a personal blog or portfolio with a clean, fast-loading design that works well on phones and desktops without writing any CSS.
- Add a fully working search page to a Hugo site that searches all your posts directly in the visitor's browser with no backend needed.
- Set up a multilingual site with automatic light and dark mode switching and social sharing buttons using a single Hugo theme.