hugo-PolyRhythmic — Hugo Starter Template

SHA-256: 364f75725560db9e84c455637cb8b420a3685d7383e0c04ef8db0a958f4053d1

2026-10-03T17:05:59.952Z

<h1 align=center>Hugo PolyRhythmic | <a href="https://polyrhythmic.xyz/" rel="nofollow">Live Demo</a></h1>

<h4 align=center>Fast | Responsive | Material Design 3</h4>

<h3 align=center>❗This theme is still very much in development. Please use with caution.</h3>

<h3 align=center>PolyRhythmic is on: 
<a href="https://themes.gohugo.io/themes/hugo-polyrhythmic/" rel="nofollow">Hugo Themes</a> | 
<a href="https://github.com/wonyoung-jang/hugo-PolyRhythmic" rel="nofollow">GitHub</a> |
<a href="https://www.producthunt.com/posts/polyrhythmic" rel="nofollow">Product Hunt</a>
</h3>

<br>

<!-- **See documentation** here: [**Wiki**](https://github.com/wonyoung-jang/hugo-PolyRhythmic/wiki) -->

<!-- **See exampleSite** source here: [**exampleSite**](https://github.com/wonyoung-jang/hugo-PolyRhythmic-demo) -->

[![Minimum Hugo Version](https://img.shields.io/static/v1?label=min-hugo-version&message=v0.132.2&color=blue&logo=hugo)](https://github.com/gohugoio/hugo/releases/tag/v0.132.2)
[![GitHub](https://img.shields.io/github/license/wonyoung-jang/hugo-PolyRhythmic)](https://github.com/wonyoung-jang/hugo-PolyRhythmic/blob/main/LICENSE)
![code-size](https://img.shields.io/github/languages/code-size/wonyoung-jang/hugo-PolyRhythmic)

<p align="center">
  <kbd>
    <img 
      src="https://raw.githubusercontent.com/wonyoung-jang/hugo-PolyRhythmic/main/images/tn.png" 
      alt="Screenshot" 
      title="Screenshot"/>
  </kbd>
</p>

<p align="center">
  <kbd>
    <img 
      src="https://raw.githubusercontent.com/wonyoung-jang/hugo-PolyRhythmic/main/images/screenshot.png" 
      alt="Screenshot" 
      title="Screenshot"/>
  </kbd>
</p>

## Key Features
  - Active menu location indicator
  - Archive support
  - **Asset management**: pipeline, fingerprint, bundle, and minify Hugo assets
  - Back-to-top button
  - Backlinks and related page suggestions
  - Code copy button
  - **Contact template**: quick contact form
  - Cover images for individual pages
  - Custom tabbed navigation
  - Debug mode for development
  - GitHub repository buttons for pages
  - Home page navigation buttons
  - Keyboard shortcuts and access keys
  - Light/dark theme toggle
  - Logseq graphs as a Single Page Application (SPA)
  - Multiple author support
  - **"Now" page table**: list of recently updated pages
  - Page navigation cards
  - Random page button
  - Responsive sticky table of contents
  - Search functionality with Fuse.js
  - SEO optimization
  - **Sitemap template**: table with Hugo-specific columns
  - Social media share buttons
  - Taxonomies and sections organization
  - **Theme customization**: control color, contrast, shape, typography, and more

## Key Differences from Material 3
  - Adjustable content text width, font size, and line height
  - Control over brand, plain, and mono typefaces
  - Direction control for tertiary color
  - Mono typeface addition
  - No use of scripting for state layers
  - Option to dim images in dark mode
  - Shape scale control

---

## Install

1. Install Hugo: [Hugo Docs's - Quick Start](https://gohugo.io/getting-started/quick-start/)
2. Create a new Hugo site
  ```bash
  # replace YourSite with your website's name
  hugo new site YourSite --format yaml
  ```
3. Add PolyRhythmic to your `YourSite/themes/` directory
- **Option 1: Clone git repository:**
  ```bash
  git clone https://github.com/wonyoung-jang/hugo-PolyRhythmic themes/PolyRhythmic --depth=1
  ```
- **Option 2: Download and unzip:**
    - Download the PolyRhythmic source and extract the zip in your `YourSite/themes/PolyRhythmic` directory
- **Option 3: Use Hugo Modules**
    - Install [Go](https://go.dev/doc/install)
    - Intialize your own hugo module:
      ```bash
      hugo mod init YOUR_GIT_REPO
      ```
    - Add PolyRhythmic in your `config.yaml` or `module.yaml`
      ```yaml
      # config.yaml
      module:
          imports:
          - path: github.com/wonyoung-jang/hugo-PolyRhythmic
      
      # module.yaml
      imports:
          - path: github.com/wonyoung-jang/hugo-PolyRhythmic
      ```
4. In your `config.yaml` add:
  ```yaml
  theme: ["PolyRhythmic"]
  ```

---

## Support

-   Star, share, and use this repository on [GitHub](https://github.com/wonyoung-jang/hugo-PolyRhythmic)
-   If you would like to sponsor me, you can through [Github Sponsors](https://github.com/sponsors/wonyoung-jang)
-   You may also donate on [Ko-Fi](https://ko-fi.com/wonyoung_jang)

---

## Thanks

-   [**Fuse.js**](https://github.com/krisk/fuse)
-   [**Material Symbols**](https://github.com/google/material-design-icons)
-   [**Material Design 3**](https://m3.material.io/)
-   [**Google Fonts**](https://fonts.google.com/)