Visual style inspired by Material Design v3, built with Tailwind CSS
pehtheme-hugo — Hugo Starter Template
By fauzanmy
Pehtheme Hugo is a Hugo theme inspired by Material Design v3 and built with Tailwind CSS, released under the MIT license, offering featured posts on the homepage, a two-column blog layout, and a sidebar.
Explore the design
Compare the page layouts and mobile experience. Open any screenshot for a closer look.
Actual screenshot captured by the server browser.
All pages & views 3
Screenshots show visual appearance; interactive behavior may differ.
What stands out
A quick read of the recorded project description.
Homepage can display featured posts tagged with feature
Blog uses a two-column layout, with a sidebar containing a recent posts list and an ad slot
No JavaScript framework dependency; only vanilla JS is used for the toggle button
Uses semantic HTML and provides a horizontal menu and a content tag list
MIT license, allowing free use, modification, commercial use, and distribution
Template Details
Pehtheme Hugo is an open-source theme for the Hugo static site generator, with a visual style referencing Material Design v3 and its styling layer written in Tailwind CSS. The repository is released under the MIT license; the code may be used, modified, used commercially, and distributed for free, provided the copyright and license notice are retained when distributing.
The theme is oriented toward blog scenarios: the homepage can display featured posts tagged with feature, and it provides a horizontal menu and a content tag list. Blog posts use a two-column layout, and the sidebar includes a recent posts list and an ad slot. The theme does not depend on a JavaScript framework, using only vanilla JS for the toggle button, and emphasizes semantic HTML.
For usage, the theme is integrated by cloning the repository and copying the assets, content, and hugo.toml from exampleSite into the project root. To customize Tailwind styles, you also need to copy the Node.js-related configuration files and install dependencies. Configuration options cover summary length, Google Analytics, Disqus comments, and pagination count.
Limitations to note: the images in the demo come from Unsplash and Pixabay, and the icons come from Bootstrap Icons. These third-party assets must be checked against their respective licenses and cannot be judged solely by the code's MIT license. External services such as domains and hosting may incur separate charges.
Is it right for your project?
Use Cases
- Building a personal blog centered on post lists and article reading
- Needing a Hugo site with a sidebar recent posts list and an ad slot
- Projects that want to customize theme styles with Tailwind CSS
- Blogs that need to integrate Google Analytics or Disqus comments
Suitable For
- Developers building static blogs with Hugo
- Front-end users who want to adjust theme styles based on Tailwind CSS
- Teams needing a theme that can be freely modified and used commercially under the MIT license
Getting started & customization
Use these recorded setup notes alongside the repository instructions for your chosen version.
- 1
First install Hugo and create a new site, then clone the pehtheme-hugo repository
- 2
Copy the assets, content, and hugo.toml under exampleSite to the project root, then run hugo server
- 3
To customize styles, copy package.json, postcss.config.js, tailwind.config.js, and input.css, and run npm install
- 4
Configure summaryLength, Google Analytics, Disqus, and pagination count in hugo.toml
- 5
The demo images and icons are third-party assets; check their respective licenses before use
License & source material
Usage conditions & limitations
Free to use · keep license noticeThis entry covers the free version under the MIT license in the public repository; the free scope is the code of this version and does not mean that 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 for free.
- When distributing copies or substantial portions of the code, retain the original author's copyright notice and the complete 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
- Enabling Google Analytics requires providing your own GA-4 measurement ID; this is an external service and may involve an account and costs.
- Enabling Disqus comments requires providing your own shortname; this is a third-party external service and may involve an account and costs.
- The demo images come from Unsplash and Pixabay, and the icons come from Bootstrap Icons. These third-party assets must be checked against their respective licenses and cannot be judged solely by the code's MIT license.
- Demo images, fonts, icons, and other third-party assets must be checked against their respective licenses and 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
[services.googleAnalytics] id = 'G-MEASUREMENT_ID' # (Your GA-4 analytics code)
Original README
[services.disqus] shortname = 'shortname' # (Your Disqus shortname)
Original README
https://github.com/fauzanmy/pehtheme-hugo/blob/main/LICENSEhttps://github.com/fauzanmy/pehtheme-hugo/blob/main/README.mdImage credits used in the live preview:
Original README
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
- Hugo Themes
- Documentation and maintenance reference score
- More documented · 85 / 100
- Technologies
- Hugo
- Website type
- Starter
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-06-28
- 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: f4e992acd3b2f07a451b18646a0e29f0b95ddb80306be63b851bc509b166c90b
2026-10-02T22:54:46.673Z
Source file / repository# Pehtheme Hugo
Pehtheme Hugo is an open-source Hugo theme inspired by [Material Design v3](https://m3.material.io/), lovingly crafted using Tailwind CSS.

## Live Demo
Check out the live demo: [Pehtheme Hugo Live Demo](https://pehtheme-hugo.netlify.app/)
## Performance Testing
To assess the performance of your website using Pehtheme Hugo, utilize the PageSpeed Insights tool. Click the button below to run a PageSpeed Insights test:
[PageSpeed Insights Test](https://pagespeed.web.dev/analysis/https-pehtheme-hugo-netlify-app/7gv9zedw83?form_factor=mobile)
## Features
- Built with Tailwind CSS
- Featured posts displayed on the homepage (To showcase featured posts on the homepage, the Hugo theme uses `feature` tags data)
- Horizontal menus, content tags list
- No JavaScript dependencies
- Vanilla JS toggle button
- Two-column blog layout
- Sidebar with a list of recent posts
- Semantic HTML
- Sidebar Ads box
## Installation
To get started with Pehtheme Hugo, follow these steps:
1. Install Hugo and create a new site. For detailed instructions, refer to [Hugo's Quick Start Guide](https://gohugo.io/getting-started/quick-start/).
2. Add Pehtheme Hugo to your project:
```bash
$ git clone https://github.com/fauzanmy/pehtheme-hugo.git
```
3. Simply copy the following 2 folders and 1 content from the `exampleSite` directory to the root of your project:
```bash
exampleSite/
├── assets/
├── content/
└── hugo.toml
```
4. Start Hugo:
```bash
hugo server
```
## Configuration
You can configure the following settings for your Hugo project
by adding or modifying these lines in your config file `hugo.toml`:
summaryLength = 20 # (approximately 160 characters for 20 words)
[services]
[services.googleAnalytics]
id = 'G-MEASUREMENT_ID' # (Your GA-4 analytics code)
[services.disqus]
shortname = 'shortname' # (Your Disqus shortname)
[pagination]
pagerSize = 10 # (Set the desired number of home posts per page)
## Custom Theme
1. Ensure you have NodeJS installed on your desktop.
2. Copy the Node.js configuration files from the `exampleSite` directory to the root of your Hugo project:
```bash
exampleSite/
├── package.json
├── postcss.config.js
└── tailwind.config.js
```
3. Additionally, copy the `exampleSite/input.css` file to the `assets/input.css` directory of your Hugo project.
4. Run the following command to install necessary dependencies:
```bash
npm install
```
5. Customize the theme with Tailwind CSS using the following command:
```bash
npm run dev
```
6. To build the website, execute the command:
```bash
npm run build
```
## License
Pehtheme Hugo is MIT Licensed. For more details, see the [LICENSE](https://github.com/fauzanmy/pehtheme-hugo/blob/main/LICENSE) file.
## Logo Icon
Egg fried icon source: [Bootstrap Icons - Egg Fried](https://icons.getbootstrap.com/icons/egg-fried/)
## Photo Credits
Image credits used in the live preview:
```
Images resource:
- https://unsplash.com/photos/Smeer5L0tXM
- https://unsplash.com/photos/2q6C5zDJOsg
- https://unsplash.com/photos/UNd3lRKhwSw
- https://unsplash.com/photos/Ed2AELHKYBw
- https://unsplash.com/photos/rTZW4f02zY8
- https://unsplash.com/photos/OtXJhYjbKeg
- https://unsplash.com/photos/ZPP-zP8HYG0
- https://unsplash.com/photos/ydGRmobx5jA
- https://pixabay.com/vectors/email-newsletter-email-marketing-3249062/
```Explore similar templates
Compare previews and descriptions within the same stack and category.

hugo-xmin
hugo-xmin is an extremely minimal Hugo theme written by Yihui Xie for template beginners. HTML and CSS total about 140 lines, with no external dependencies, and it uses the MIT license.
Hugo · Starter

hugo-theme-gallery
A Hugo Extended photo gallery theme that organizes images with Page Bundles, automatically generating album lists and gallery pages with a Justified layout and PhotoSwipe lightbox.
Hugo · Starter

reveal-hugo
reveal-hugo is a Hugo theme that converts Markdown content into Reveal.js-based HTML presentations. It supports slide separation with `---`, shortcodes for fragments, slides, sections, notes, Markdown, and MathJax, and organizes content as root or section presentations with order controlled by weight.
Hugo · Starter

anatole
Anatole is a minimalistic two-column Hugo theme ported from farbox-theme-Anatole, featuring dark mode, multilingual and RTL support, and optional portfolio, comments, analytics, KaTeX, and Mermaid integrations. It suits personal blogs, portfolios, or documentation sites built with Hugo.
Hugo · Starter

hugo-theme-diary
A Hugo diary-style theme ported from the Hexo theme Journal, with a grid homepage for essays and daily notes. It supports six languages, dark mode, table-of-contents scroll positioning, reading time, code highlighting, and configurable sidebar, fonts, and colors.
Hugo · Starter

risotto
risotto is a minimalist, responsive Hugo theme inspired by terminal ricing aesthetics. It uses semantic HTML and pure CSS with no JavaScript, and its layout relies on CSS Grid for native responsiveness without manual breakpoints.
Hugo · Starter
