HugoPortfolioBlogDocumentation

r-hugo-theme — Hugo Portfolio Template

By rafalkaron

r-hugo-theme is a Hugo theme for portfolios, documentation libraries, or blogs, offering a responsive layout, light/dark mode toggle, and automatically generated site navigation.

Open Source Site Download Source ZIP

Explore the design

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

3 previews

Desktop homepage1 / 3

Visit websiteOpens in a new tab

Desktop captureTop of page

Actual screenshot captured by the server browser.

All pages & views 3

Screenshots show visual appearance; interactive behavior may differ.

Recorded 2026-10-01View source

What stands out

A quick read of the recorded project description.

Responsive layouts covering desktop, tablet, mobile, and print

Provides a light/dark mode toggle

Automatically generates section navigation, page navigation, breadcrumbs, previous/next links, and keyword-based related links

Footer contact information is customizable

Blog supports categories, tags, and estimated reading time

Includes both single-language and multilingual example site directories

Template Details

r-hugo-theme is a Hugo theme published by rafalkaron, described in the repository as a simple theme suitable for a portfolio, documentation library, or blog. The theme provides responsive layouts for desktop, tablet, mobile, and print, along with a toggle that controls light and dark modes. For navigation, the theme automatically generates section navigation (within this section), page navigation (within this page), breadcrumbs, previous and next page links, and keyword-based related links. The contact information in the footer can be modified. Blog capabilities include categories, tags, and estimated reading time. The repository includes example-site and example-site-multilingual example directories; their files and folders can be copied to the site root as a starting point. The theme is MIT licensed, and the demo site is at rafalkaron.github.io. The README does not list the versions of the frameworks it depends on, nor does it state performance or production readiness.

HugoPortfolioBlogDocumentation

Is it right for your project?

Use Cases

Building a personal portfolio site
Creating a documentation library and organizing content with automatically generated section and page navigation
Running a blog with categories and tags
Content sites that need a light/dark mode toggle and print styles

Suitable For

Developers building static sites with Hugo
Personal sites that need one of three purposes: portfolio, documentation, or blog
Sites that want navigation generated automatically by the theme to reduce manual maintenance
Projects that need a single-language or multilingual example as a starting point

Getting started & customization

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

1
Git and Hugo must be installed first
2
Run hugo new site {site_name} to create a site and enter that directory
3
Run git init to initialize the repository
4
Add the theme as a git submodule; the address given in the README is https://rafalkaron.github.io/r-hugo-theme
5
Move the files and folders from example-site or example-site-multilingual to the site root, then run hugo server to preview at http://localhost:1313/

Read repository instructions

License & source material

Usage conditions & limitations

Free to use · keep license notice

This entry covers the free version under the MIT license in the public repository; the free scope is the code of that version and does not mean external services or third-party assets are free.

Must comply with when using

The code of this version may be used, modified, used commercially, and distributed free of charge.
When distributing copies or substantial portions of the code, retain the original author's copyright notice and the full MIT license notice.
The code is provided as is; warranties and limitations of liability are governed by the original license and applicable law.

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/rafalkaron/r-hugo-theme/blob/main/LICENSE https://github.com/rafalkaron/r-hugo-theme/blob/main/README.md

Compiled by DeepSeek based on repository license and README ·2026-10-01. 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: GitHub
Documentation and maintenance reference score: More documented · 88 / 100
Technologies: Hugo
Website type: Portfolio · Blog · Documentation

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: 2025-11-03
Screenshot last checked: 2026-10-01

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.

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.

Automatically checked against source and license rules; no manual editorial review.

Inspect the recorded source material

SHA-256: 783cfcbb36b139820ed156c39e4ba2df95d53a8674b42180aff25679476f8eda

2026-10-01T01:00:35.377Z

Source file / repository

# r-hugo-theme

A simple Hugo theme suitable for a portfolio, documentation library, or blog. See [r-hugo-theme-demo](https://rafalkaron.github.io/r-hugo-theme-demo).  

<img width="920" alt="r-hugo-theme-desktop-light" src="https://user-images.githubusercontent.com/45826759/175793931-f7810c7e-1ce9-438c-98f7-ee9c9a75536b.png">  

<img width="320" alt="r-hugo-theme-mobile-dark" src="https://user-images.githubusercontent.com/45826759/175793933-db7448a7-fd96-474c-8073-c05a09d6b7db.png"><img width="320" alt="r-hugo-theme-mobile-light" src="https://user-images.githubusercontent.com/45826759/175793934-9d00a991-8e40-4c5d-8149-540c93b462cf.png">

## Key features

* Responsive layout for desktops, tablets, mobile, and print
* A switch that controls light and dark modes
* Extensive, automatically generated site navigation that includes:
  * Section navigation (in this section)
  * Page navigation (on this page)
  * Breadcrumbs
  * Links to next and previous pages
  * Related links based on keywords
* Easily customizable contact info in the footer
* Blogging capabilities:
  * Categories
  * Tags
  * Estimated reading time

## Quick start

Set up a simple website that uses r-hug-theme with sample content.

### Prerequisites

* [Install Git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git)
* [Install Hugo](https://gohugo.io/getting-started/quick-start/#step-1-install-hugo)

### Procedure

3. In the terminal, create a new site by entering `hugo new site {site_name}`  
**Where:** `{site_name}` is the name of the site that you want to create.
4. Enter the Hugo site directory by entering `cd {site_name}`
5. Initialize a Git repository by entering `git init`
6. Add the theme by entering `git submodule add https://rafalkaron.github.io/r-hugo-theme`
7. Move the files and folders from the `example-site` or `example-site-multilingual` directory into the root folder of your site.
8. Run a local Hugo webserver by entering `hugo server`

### Postrequisites

* Preview your website by opening [http://localhost:1313/](http://localhost:1313/)

## Theme customization

You can further customize the site by editing the `config.yaml` file. For more information, see the [Hugo documentation](https://gohugo.io/documentation/).

Report a correction

Explore similar templates

Compare previews and descriptions within the same stack and category.

hugo-PaperMod

A fast, clean, responsive Hugo theme for blogs and lightweight portfolios, with three layout modes (Regular, Home-Info, Profile), automatic and manual light/dark themes, Fuse.js client-side search, multilingual support, and built-in Open Graph, Twitter Cards, and Schema.org data.

Hugo · Portfolio

hugo-book

Hugo Book is a Hugo documentation theme that aims to make documentation sites as simple as a plain book. It emphasizes clean, lightweight, mobile-friendly, and zero initial configuration, and comes with an example site that doubles as documentation.

Hugo · Documentation

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

docsy

Docsy is a Hugo theme for technical documentation sites, governed by the Linux Foundation and licensed under Apache-2.0. It provides simple navigation and site structure for open source project and product documentation.

Hugo · Documentation

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