HugoPortfolioBlogCorporate Website

hugo-neso — Hugo Portfolio Template

By babeneso

hugo-neso is a Hugo theme modified from PaperMod, featuring a minimal neutral design, light/dark mode, responsive layout, Tailwind CSS, and built-in search, suitable for portfolios, blogs, and corporate websites.

Open Source SiteDownload Source ZIP

Explore the design

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

2 previews
Desktop homepage1 / 2
Desktop captureTop of page

Actual screenshot captured by the server browser.

All pages & views 2

Screenshots show visual appearance; interactive behavior may differ.

Recorded 2026-10-02View source

What stands out

A quick read of the recorded project description.

01

Modified from PaperMod, featuring a neutral, modern minimal design

02

Fibonacci-based spacing rhythm, unified icon sizes and alignment

03

Supports light/dark mode, still toggleable without JavaScript

04

Homepage offers Profile, Intro, and Fully Custom layouts

05

Built-in Fuse.js search and archive pages, includes OG Image, X Card, and JSON-LD

06

Integrates Tailwind CSS and parameterized CSS design tokens for easy style adjustments

Template Details

hugo-neso is a theme released by developer babeneso on the Hugo platform, explicitly stated to be modified from PaperMod. It targets sites that need a clean visual style and serves three use cases: portfolio, blog, and corporate website. The repository uses the MIT license, allowing free use, modification, commercial use, and distribution of the code, but third-party assets such as demo images, fonts, and icons require separate license verification.

The theme uses a Fibonacci-based spacing rhythm in typography, unifies icon sizes and alignment, and supports light/dark mode, which can still be toggled without JavaScript. The homepage offers three layouts: Profile, Intro, and Fully Custom, with built-in archive pages and Fuse.js-based search. For SEO, it includes OG Image, X Card, and JSON-LD structured data, and comes with preconfigured favicon and PWA manifest.json.

Style customization is done through Tailwind CSS and parameterized CSS design tokens. Code blocks support copy-to-clipboard and are compatible with GitHub Markdown Alert syntax. Directional icons display correctly in RTL language environments. The theme organizes files according to Hugo's new template system, and the README notes that Hugo v0.150.0 or higher is required. The demo site also serves as documentation; installation and configuration details should be based on that site's content.

HugoPortfolioBlogCorporate website

Is it right for your project?

Use Cases

  • Building a personal portfolio or resume-style homepage
  • Publishing a text-focused technical blog or writing site
  • Providing clean display and content pages for a corporate website
  • Content sites that need light/dark mode and responsive layout

Suitable For

  • Developers building static sites with Hugo
  • Content creators who prefer minimal typography and neutral visual style
  • Individuals and teams needing portfolio, blog, or corporate website templates
  • Users who want to customize based on PaperMod and accept the MIT license

Getting started & customization

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

  1. 1

    The theme requires Hugo v0.150.0 or higher

  2. 2

    The demo site also serves as documentation; installation and configuration should refer to that site

  3. 3

    The repository uses the MIT license; when distributing code copies, retain the copyright notice and license statement

  4. 4

    Third-party assets such as demo images, fonts, and icons require separate license verification

  5. 5

    External services such as domain and hosting may incur additional costs

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 applies to that version's code and does not imply that external services or third-party assets are free.

Must comply with when using

  • Free use, modification, commercial use, and distribution of this version's code are permitted.
  • When distributing copies or substantial portions of the code, retain the original author's copyright notice and the full MIT license statement.
  • The code is provided as-is; warranties and liability limitations are governed by the original license and applicable law.

Additional costs & items to verify

  • Using this theme requires Hugo v0.150.0 or higher; lower versions will not run properly.
  • The built-in search feature relies on the third-party library Fuse.js, which must be included when using search.
  • Installation and configuration instructions exist only on the demo site; full documentation requires visiting an external site.
  • Demo images, fonts, icons, and other third-party assets require separate license verification and cannot be judged solely by the code's MIT license.
  • External services such as domain, hosting, database, payment, or AI may incur additional charges.
View Original Text Basis

Permission is hereby granted, free of charge

Original License Text

This theme requires Hugo `v0.150.0` or later.

Original README

Built‑in search (powered by [Fuse.js](https://github.com/krisk/fuse)).

Original README

The [demo site](https://babeneso.github.io/hugo-neso/) also serves as documentation, please visit it to learn more.

Original README
https://github.com/babeneso/hugo-neso/blob/main/LICENSEhttps://github.com/babeneso/hugo-neso/blob/main/README.md

Compiled by DeepSeek based on repository license and README ·2026-10-02. 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 · 92 / 100
Technologies
Hugo
Website type
Portfolio · Blog · Corporate Website
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-10-14
Screenshot last checked
2026-10-02

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: cb6f9e21de8fb3271fa025ecf57b1563595e1832483633b853a691a421bf0cab

2026-10-02T10:20:14.689Z

Source file / repository
# Hugo Neso Theme

Clean and modern — fully responsive with light/dark mode, Tailwind built in for easy customization, and solid SEO.

**[View the demo site](https://babeneso.github.io/hugo-neso/)**

> This theme is derived from “[PaperMod](https://github.com/adityatelange/hugo-PaperMod)” with modifications. Special thanks to the original author, please visit the repo and give it a star.

<picture>
    <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/babeneso/hugo-neso/master/images/screenshot-dark.png">
    <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/babeneso/hugo-neso/master/images/screenshot-light.png">
    <img alt="Screenshot" src="https://raw.githubusercontent.com/babeneso/hugo-neso/master/images/screenshot.png">
</picture>

(The preview above supports light and dark modes, try adjusting your display settings to see it switch!)

Neso is a carefully crafted Hugo theme that delivers a refined experience in a minimal aesthetic. It's lightweight and fast, fully responsive, supports light/dark mode, and offers easy theming via built‑in Tailwind and parameterized CSS; thoughtful SEO defaults help your content get discovered.


## Highlights

- Neutral, modern, minimal design.  
- Fibonacci‑based spacing rhythm for natural, pleasing typography.  
- Consistent icon sizing and precise alignment throughout.  
- Fully responsive design with elegant main‑menu transitions.  
- Light/dark mode, with graceful behavior even without JavaScript.  
- Direction‑aware icons render correctly in RTL locales.  
- Thoughtful accessibility support.  
- Readable, polished code blocks with copy‑to‑clipboard.  
- Supports GitHub Markdown [Alert](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-syntax#alerts) syntax.  
- Three home layouts: Profile, Intro, and Fully Custom.  
- Tailwind CSS 4 integration with a refined Typography (Prose) setup.  
- Parameterized CSS design tokens for easy customization.  
- OG Image, X Card, and JSON‑LD structured data.  
- Prewired favicon and PWA `manifest.json`, just drop in your icons.  
- Built‑in search (powered by [Fuse.js](https://github.com/krisk/fuse)).  
- Archives page included.  
- Organized to match Hugo’s [new template system](https://gohugo.io/templates/new-templatesystem-overview/).

![Responsive design preview](https://raw.githubusercontent.com/babeneso/hugo-neso/master/images/screenshot-mobile.png)

![Responsive design preview](https://raw.githubusercontent.com/babeneso/hugo-neso/master/images/screenshot-2-mobile.png)


## Installation & Usage

The [demo site](https://babeneso.github.io/hugo-neso/) also serves as documentation, please visit it to learn more.

> [!NOTE]  
> This theme requires Hugo `v0.150.0` or later.


## Support

I’m not a professional software developer; if you could give the project a star, it would mean a lot to me. 🫰


---

# Chinese


簡潔、現代 – 具備 RWD 與明／暗色模式，整合 Tailwind 易於客製，並有穩健的 SEO 表現。

**[瀏覽 Demo 站](https://babeneso.github.io/hugo-neso/zh-tw/)**

> 此佈景主題基於「[PaperMod](https://github.com/adityatelange/hugo-PaperMod)」修改製作而成，特別感謝原作者，請務必前往該 Repo 給予星星。

<picture>
    <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/babeneso/hugo-neso/master/images/screenshot-dark.png">
    <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/babeneso/hugo-neso/master/images/screenshot-light.png">
    <img alt="Screenshot" src="https://raw.githubusercontent.com/babeneso/hugo-neso/master/images/screenshot.png">
</picture>

(上面預覽圖支援深 / 淺色模式，調整你的顯示器設定看看！)

Neso 是精心設計的 Hugo 佈景主題，以極簡風格呈現細膩的網站體驗。輕量快速，具備 RWD、深淺色模式，透過內建的 Tailwind 與參數化 CSS 輕鬆調整風格；並有完善的 SEO 設定，讓你的內容更容易被看見。


## 亮點功能

- 中性、現代、簡約的設計。
- 基於費氏數列的排版間距，內容韻律美觀自然。
- 各處 icon 視覺大小一致，皆完美對齊。
- 完整的響應式設計、精美的主選單轉場動畫。
- 支援淺 / 深色模式，即使無 JavaScript 也可正常作用。
- 所有與方向相關的 icon 在 RTL 環境皆能正確地指向。
- 細膩的 accessibility 支援。
- 閱讀體驗極佳的程式碼展示區塊，包含複製功能。
- 可使用 GitHub Markdown [Alert](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#alerts) 語法。
- 三種首頁排版可選：個人頁面模式、簡介模式、全自訂模式。
- 整合 Tailwind CSS 4 與經過改良的 Typography plugin (Prose)。
- 參數化的 CSS 設定，易於客製化。
- OG Image、X Card，與 JSON-LD 結構化資料。
- 已設定完成的 Favicon 與 PWA `manifest.json`，你只需要放置圖片。
- 具備搜尋功能 (感謝 [Fuse.js](https://github.com/krisk/fuse))
- 具備文章彙整頁面。
- 符合[新版的 template system](https://gohugo.io/templates/new-templatesystem-overview/) 檔案整理方式。

![佈景主題在行動裝置的預覽畫面](https://raw.githubusercontent.com/babeneso/hugo-neso/master/images/screenshot-mobile.png)

![佈景主題在行動裝置的預覽畫面](https://raw.githubusercontent.com/babeneso/hugo-neso/master/images/screenshot-2-mobile.png)

## 安裝與使用

[Demo 網站](https://babeneso.github.io/hugo-neso/zh-tw/)同時作為說明文件，請前往進一步了解使用方式。

> [!NOTE]  
> 此佈景主題需要 Hugo `v0.150.0` 或之後的版本


## 贊助與支持

我並非專業的軟體開發者，如果你能給我一顆星星對我會是非常大的鼓勵 🫰
Report a correction

Explore similar templates

Compare previews and descriptions within the same stack and category.

hugo-PaperMod

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

LoveIt

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

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

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

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

Hugo · Blog

hextra

hextra

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

Hugo · Documentation