HugoBlog

FeelIt — Hugo Blog Template

By khusika

FeelIt is a Hugo blog theme evolved from LoveIt, LeaveIt, and KeepIt, under the MIT license, offering custom header and styles, light/dark mode, multilingual support, and extended shortcodes for KaTeX, mermaid, ECharts, a music player, and more.

Open Source SiteDownload Source ZIP

Explore the design

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

1 previews
Author preview
Author-provided previewTop of page

Preview provided in the project README.

One original preview is available. Open the full image to inspect the design.

Screenshots show visual appearance; interactive behavior may differ.

Recorded 2026-09-30View source

What stands out

A quick read of the recorded project description.

01

Evolved from LoveIt, LeaveIt, and KeepIt, offering a custom header, custom CSS styles, and a redesigned homepage

02

Supports light/dark mode, responsive layout, pagination, multilingual support and i18n, with a built-in auto-expandable table of contents

03

Supports Font Awesome icons, ruby annotations, fractions, KaTeX formulas, mermaid diagrams, ECharts, Mapbox, APlayer/MetingJS music player, and Bilibili player via extended Markdown and shortcodes

04

Search can use Lunr.js or Algolia; comments can integrate Disqus, Gitalk, Valine, Facebook, Telegram, Commento, Utterances, and more

05

Analytics supports Google Analytics, Fathom, and GoatCounter; third-party libraries can be loaded via CDN

06

Released under the MIT license, with theme documentation and an online demo site provided in the repository

Template Details

FeelIt is a blog theme for Hugo, hosted on GitHub at khusika/FeelIt and released under the MIT license. It evolved from three visually similar themes—LoveIt, LeaveIt, and KeepIt—and the README explicitly lists changes relative to the original themes: custom header, custom CSS styles, a new homepage (compatible with newer Hugo versions), adjustments to colors, font sizes, margins, code previews, and other style details, a more readable dark mode, several CSS animations, an auto-expandable table of contents, and additional social links, sharing sites, and comment systems.

Functionally, the theme provides a responsive layout, light/dark mode toggle, pagination, multilingual support and i18n, image lazy loading, code highlighting with one-click copy, an image gallery, and support for Lunr.js or Algolia search. For content extensions, it supports Font Awesome icons, ruby annotations, and fractions via extended Markdown syntax, and supports KaTeX math formulas, mermaid diagrams, ECharts data visualizations, Mapbox maps, APlayer/MetingJS music player, Bilibili player, various admonitions, and custom styles and scripts via shortcodes. Comment systems can integrate Disqus, Gitalk, Valine, Facebook, Telegram, Commento, and Utterances; analytics can integrate Google Analytics, Fathom, and GoatCounter; third-party libraries support CDN.

Regarding languages, the README lists German, English, Spanish, French, Indonesian, Italian, Polish, Brazilian Portuguese, Romanian, Russian, Serbian, Vietnamese, Simplified Chinese, Hungarian, Czech, Persian, and Ukrainian, and welcomes new languages via PR.

Limitations and notes: the README states a Hugo version requirement of ^0.160.0, which should be checked against your local Hugo version before use; the theme relies on npm scripts (npm run reinstall, npm run start-production, npm run build) for installation and building, requiring a Node.js environment. The theme includes many third-party libraries and assets (such as Font Awesome, Simple Icons, KaTeX, mermaid, ECharts, Mapbox GL JS, APlayer, etc.), whose licenses and usage conditions must be verified separately; the MIT license for the code does not cover these third-party resources. Demo and documentation sites are provided by the author and can serve as references for configuration and shortcode usage.

HugoBlog

Is it right for your project?

Use Cases

  • Building a personal blog with Hugo and wanting reading features such as light/dark mode, table of contents, code highlighting, and one-click copy
  • Embedding math formulas, flowcharts, data visualization charts, or multimedia content such as music and Bilibili videos in articles
  • Needing a multilingual site with i18n support to publish content for readers in different languages
  • Wanting to integrate third-party comment systems and visit analytics, and to choose a search solution (Lunr.js or Algolia) as needed
  • Using LoveIt, LeaveIt, or KeepIt as a base and wanting to try a similar theme with adjustments to styles and homepage

Suitable For

  • Bloggers familiar with basic Hugo concepts who can edit config and Markdown content
  • Technical writers who need to use shortcode extensions (formulas, charts, players) extensively in articles
  • Site maintainers planning a multilingual blog and integrating comments, analytics, and search
  • Developers who want to modify and distribute a theme based on the MIT license

Getting started & customization

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

  1. 1

    The README states a Hugo version requirement of ^0.160.0; check whether your local Hugo version is compatible before use

  2. 2

    The theme provides npm scripts for installing dependencies and building: npm run reinstall, npm run start-production, npm run build, requiring a Node.js environment

  3. 3

    Features such as comments, analytics, search (Algolia), and Mapbox usually require applying for service keys or configuring accounts yourself

  4. 4

    The theme includes third-party libraries and assets such as Font Awesome, KaTeX, mermaid, ECharts, and APlayer; their licenses and usage conditions must be verified separately

  5. 5

    The code is under the MIT license; when distributing or modifying, retain the original author's copyright notice and the full MIT license notice

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 mean external services or third-party assets are free.

Must comply with when using

  • You may use, modify, commercialize, and distribute this version's code for free.
  • 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 liability limitations are governed by the original license and applicable law.

Additional costs & items to verify

  • Search can use Lunr.js or Algolia; if you choose Algolia, you need to register an Algolia account and configure API keys and other external service credentials yourself.
  • The Mapbox map shortcode relies on Mapbox GL JS; using this feature requires applying for a Mapbox access token yourself and may be subject to Mapbox terms of service and usage limits.
  • Comment systems are optional integrations; if you enable Disqus, Gitalk, Valine, Facebook, Telegram, Commento, Utterances, etc., you need to register the corresponding third-party services and configure accounts or keys yourself.
  • Visit analytics are optional integrations; if you enable Google Analytics, Fathom, or GoatCounter, you need to register the respective service accounts and configure tracking identifiers yourself.
  • The theme includes third-party libraries and assets such as Font Awesome, Simple Icons, KaTeX, mermaid, ECharts, and APlayer; their licenses and usage conditions must be verified separately, and the MIT code license does not cover these third-party resources.
  • Installation and building rely on npm scripts (npm run reinstall, npm run start-production, npm run build), requiring a local Node.js environment.
  • 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 domain, hosting, database, payment, or AI may incur additional charges.
View Original Text Basis

Permission is hereby granted, free of charge

Original License Text

**Search** supported by [Lunr.js](https://lunrjs.com/) or [algolia](https://www.algolia.com/)

Original README

**Mapbox** shortcode supported by [Mapbox GL JS](https://docs.mapbox.com/mapbox-gl-js)

Original README

**Disqus** comment system supported by [Disqus](https://disqus.com)

Original README

**[Google Analytics](https://analytics.google.com/analytics)** supported

Original README

Thanks to the authors of following resources included in the theme:

Original README

* Install required packages ```bash npm run reinstall ```

Original README
https://github.com/khusika/FeelIt/blob/main/LICENSEhttps://github.com/khusika/FeelIt/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 · 91 / 100
Technologies
Hugo
Website type
Blog
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
2026-06-25
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: 868731c7f7480c55a103067f9c026f86e0a8aa5daae272987e389826eeacbd47

2026-10-01T13:38:52.394Z

Source file / repository
# FeelIt Theme | Hugo [![Netlify Status](https://api.netlify.com/api/v1/badges/6c8cd9a1-4916-4705-b286-dce0930b9217/deploy-status)](https://app.netlify.com/sites/hugofeelit/deploys)


[![GitHub release (latest by date)](https://img.shields.io/github/v/release/khusika/FeelIt?style=flat-square)](https://github.com/khusika/FeelIt/releases)
[![Hugo](https://img.shields.io/badge/Hugo-%5E0.160.0-ff4088?style=flat-square&logo=hugo)](https://gohugo.io/)
[![License](https://img.shields.io/github/license/khusika/FeelIt?style=flat-square)](https://github.com/khusika/FeelIt/blob/main/LICENSE)

> **FeelIt** is a **clean**, **elegant** but **advanced** blog theme for [Hugo](https://gohugo.io/).

It is based on the original [LoveIt Theme](https://github.com/dillonzq/LoveIt), [LeaveIt Theme](https://github.com/liuzc/LeaveIt) and [KeepIt Theme](https://github.com/Fastbyte01/KeepIt).

Since the three themes have a similar look, if you have questions about their differences,
read [Why choose FeelIt](#why-choose-feelit) so that you can choose the one that works best for you.

![Hugo Theme FeelIt](https://github.com/khusika/FeelIt/raw/main/images/screenshot.png)

## Demo Site

To see this theme in action, here is a live [demo site](https://feelit.khusika.id/) which is rendered with **FeelIt** theme.

## Why choose FeelIt

Compared to the original LoveIt theme, LeaveIt theme and the KeepIt theme. The FeelIt theme has the following modifications.

* Custom **Header**
* Custom **CSS Style**
* A new **home page**, compatible with the latest version of Hugo
* A lot of **style detail adjustments,** including color, font size, margins, code preview style
* More readable **dark mode**
* Some beautiful **CSS animations**
* Easy-to-use and self-expanding **table of contents**
* More **social links**, **share sites** and **comment system**
* **Search** supported by [Lunr.js](https://lunrjs.com/) or [algolia](https://www.algolia.com/)
* **Copy code** to clipboard with one click
* Extended Markdown syntax for **[Font Awesome](https://fontawesome.com/) icons**
* Extended Markdown syntax for **ruby annotation**
* Extended Markdown syntax for **fraction**
* **Mathematical formula** supported by [KaTeX](https://katex.org/)
* **Diagram syntax** shortcode supported by [mermaid](https://github.com/knsv/mermaid)
* **Interactive data visualization** shortcode supported by [ECharts](https://echarts.apache.org/)
* **Mapbox** shortcode supported by [Mapbox GL JS](https://docs.mapbox.com/mapbox-gl-js)
* Embedded **music player** supported by [APlayer](https://github.com/MoePlayer/APlayer) and [MetingJS](https://github.com/metowolf/MetingJS)
* **Bilibili** player supported
* Kinds of **admonitions** shortcode supported
* Custom style shortcodes supported
* **CDN** for all third-party libraries supported
* ...

In short,
if you prefer the design language and freedom of the FeelIt theme,
if you want to use the extended Font Awesome icons conveniently,
if you want to embed mathematical formulas, flowcharts, music or Bilibili videos in your posts,
the FeelIt theme may be more suitable for you.

I hope you will FeelIt ❤️!

## Features

### Performance and SEO

* Optimized for **performance**: 99/100 on mobile and 100/100 on desktop in [Google PageSpeed Insights](https://developers.google.com/speed/pagespeed/insights)
* Optimized SEO performance with a correct **SEO SCHEMA** based on JSON-LD
* **[Google Analytics](https://analytics.google.com/analytics)** supported
* **[Fathom Analytics](https://usefathom.com/)** supported
* **[GoatCounter Analytics](https://www.goatcounter.com/)** supported
* Search engine **verification** supported (Google, Bind, Yandex and Baidu)
* **CDN** for third-party libraries supported
* Automatically converted images with **Lazy Load** by [lazysizes](https://github.com/aFarkas/lazysizes)

### Appearance and Layout

* **Responsive** layout
* **Light/Dark** mode
* Globally consistent **design language**
* **Pagination** supported
* Easy-to-use and self-expanding **table of contents**
* **Multilanguage** supported and i18n ready
* Beautiful **CSS animation**

### Social and Comment Systems

* **Gravatar** supported by [Gravatar](https://gravatar.com)
* Local **Avatar** supported
* Up to **64** social links supported
* Up to **28** share sites supported
* **Disqus** comment system supported by [Disqus](https://disqus.com)
* **Gitalk** comment system supported by [Gitalk](https://github.com/gitalk/gitalk)
* **Valine** comment system supported by [Valine](https://valine.js.org/)
* **Facebook comments** system supported by [Facebook](https://developers.facebook.com/docs/plugins/comments/)
* **Telegram comments** system supported by [Telegram Comments](https://comments.app/)
* **Commento** comment system supported by [Commento](https://commento.io/)
* **Utterances** comment system supported by [Utterances](https://utteranc.es/)

### Extended Features

* **Search** supported by [Lunr.js](https://lunrjs.com/) or [algolia](https://www.algolia.com/)
* **Twemoji** supported
* Automatically **highlighting** code
* **Copy code** to clipboard with one click
* **Images gallery** supported by [lightgallery.js](https://github.com/sachinchoolur/lightgallery.js)
* Extended Markdown syntax for **[Font Awesome](https://fontawesome.com/) icons**
* Extended Markdown syntax for **ruby annotation**
* Extended Markdown syntax for **fraction**
* **Mathematical formula** supported by [KaTeX](https://katex.org/)
* **Diagrams** shortcode supported by [mermaid](https://github.com/knsv/mermaid)
* **Interactive data visualization** shortcode supported by [ECharts](https://echarts.apache.org/)
* **Mapbox** shortcode supported by [Mapbox GL JS](https://docs.mapbox.com/mapbox-gl-js)
* **Music player** shortcode supported by [APlayer](https://github.com/MoePlayer/APlayer) and [MetingJS](https://github.com/metowolf/MetingJS)
* **Bilibili player** shortcode
* Kinds of **admonitions** shortcode
* **Custom style** shortcode
* **Custom script** shortcode
* **Animated typing** supported by [TypeIt](https://typeitjs.com/)
* **Cookie consent banner** supported by [cookieconsent](https://github.com/osano/cookieconsent)
* ...

## Documentation

* ### [Theme Documentation - Basics](https://feelit.khusika.id/theme-documentation-basics/)

* ### [Theme Documentation - Content](https://feelit.khusika.id/theme-documentation-content/)

* ### [Theme Documentation - Built in Shortcodes](https://feelit.khusika.id/theme-documentation-built-in-shortcodes/)

* ### [Theme Documentation - Extended Shortcodes](https://feelit.khusika.id/theme-documentation-extended-shortcodes/)

* ### [Basic Markdown Syntax](https://feelit.khusika.id/basic-markdown-syntax/)

* ### [Emoji Support](https://feelit.khusika.id/emoji-support/)

## Getting Started

* Install required packages
```bash
npm run reinstall
```

* Debug theme documentation
```bash
npm run start-production
```

* Build theme documentation
```bash
npm run build
```

## Multilingual and i18n

FeelIt supports the following languages:

* German
* English
* Spanish
* French
* Indonesian
* Italian
* Polish
* Brazilian Portuguese
* Romanian
* Russian
* Serbian
* Vietnamese
* Simplified Chinese
* Hungarian
* Czech
* Persian
* Ukrainian
* [Contribute with a new language](https://github.com/khusika/FeelIt/pulls)

[Languages Compatibility](https://feelit.khusika.id/theme-documentation-basics/#language-compatibility)

## Questions, ideas, bugs, pull requests

All feedback is welcome! Head over to the [issue tracker](https://github.com/khusika/FeelIt/issues).

## License

FeelIt is licensed under the **MIT** license. Check the [LICENSE file](https://github.com/khusika/FeelIt/blob/main/LICENSE) for details.

Thanks to the authors of following resources included in the theme:

* [modern-normalize](https://github.com/sindresorhus/modern-normalize)
* [Font Awesome](https://fontawesome.com/)
* [Simple Icons](https://github.com/simple-icons/simple-icons)
* [Animate.css](https://daneden.github.io/animate.css/)
* [autocomplete.js](https://github.com/algolia/autocomplete.js)
* [Lunr.js](https://lunrjs.com/)
* [algoliasearch](https://github.com/algolia/algoliasearch-client-javascript)
* [lazysizes](https://github.com/aFarkas/lazysizes)
* [object-fit-images](https://github.com/fregante/object-fit-images)
* [Twemoji](https://github.com/twitter/twemoji)
* [lightgallery.js](https://github.com/sachinchoolur/lightgallery.js)
* [clipboard.js](https://github.com/zenorocha/clipboard.js)
* [Sharer.js](https://github.com/ellisonleao/sharer.js)
* [TypeIt](https://typeitjs.com/)
* [KaTeX](https://katex.org/)
* [mermaid](https://github.com/knsv/mermaid)
* [ECharts](https://echarts.apache.org/)
* [Mapbox GL JS](https://docs.mapbox.com/mapbox-gl-js)
* [APlayer](https://github.com/MoePlayer/APlayer)
* [MetingJS](https://github.com/metowolf/MetingJS)
* [Gitalk](https://github.com/gitalk/gitalk)
* [Valine](https://valine.js.org/)
* [cookieconsent](https://github.com/osano/cookieconsent)

## Author

[Khusika](https://khusika.id) and [all contributors](https://github.com/khusika/FeelIt/graphs/contributors)

Thanks! ❤️
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