Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/wonyoung-jang/hugo-polyrhythmic

A (mostly) CSS implementation of Material Design 3, as a Hugo theme. Read more at https://wonyoungjang.org/hugo-polyrhythmic/
https://github.com/wonyoung-jang/hugo-polyrhythmic

css hugo hugo-theme logseq material material-design-3 material-you

Last synced: about 12 hours ago
JSON representation

A (mostly) CSS implementation of Material Design 3, as a Hugo theme. Read more at https://wonyoungjang.org/hugo-polyrhythmic/

Awesome Lists containing this project

README

        

Hugo PolyRhythmic | Live Demo

Fast | Responsive | Material Design 3

❗This theme is still very much in development. Please use with caution.

PolyRhythmic is on:
Hugo Themes |
GitHub


[![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)



Screenshot



Screenshot

## 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/)