uBlogger is a Hugo blog theme built for creating fast, elegant, and feature-rich static websites; it is a fork of the LoveIt theme created by uPagge and designed with readers in mind.
What is uBlogger?
uBlogger is a clean and advanced blog theme for the Hugo static site generator, developed by uPagge and based on the LoveIt theme. It takes Markdown content and Hugo configuration as input and produces a fully static website with a responsive layout, custom home page, pagination, table of contents, and light/dark modes. The theme requires Hugo version ^0.62.0 or later, is free under the MIT license, and ships with a live demo site and documentation hosted on Netlify.
Key Features
- Performance and SEO — Reports 99/100 on mobile and 100/100 on desktop in Google PageSpeed Insights, includes JSON-LD schema, and supports Google Analytics, Fathom Analytics, Yandex.Metrica, and search engine verification for Google, Bing, Yandex, and Baidu.
- Appearance and layout — Fully responsive layout with light/dark mode, custom header CSS, pagination, self-expanding table of contents, animations, and 12 i18n languages including English, Simplified Chinese, French, Polish, Brazilian Portuguese, Italian, Spanish, German, Serbian, Russian, Romanian, and Vietnamese.
- Social and comment systems — Connect up to 64 social links, 28 share sites, and choose from eight comment systems: Remark42, Disqus, Gitalk, Valine, Facebook Comments, Telegram Comments, Commento, and Utterances.
- Search — Client-side search powered by Lunr.js or Algolia, with autocomplete.js bundled.
- Extended Markdown syntax — Add Font Awesome icons, ruby annotations, fractions, and KaTeX mathematical formulas directly in posts.
- Rich shortcodes — Embed mermaid diagrams, ECharts interactive visualizations, Mapbox GL JS maps, APlayer and MetingJS music players, Bilibili videos, and multiple admonition callouts.
- Convenience tools — One-click copy-to-clipboard, automatic code highlighting, Twemoji emoji, lazy-loaded images via lazysizes, dynamic smooth scroll, and a cookie consent banner via cookieconsent.
- Third-party CDN support — All JavaScript and CSS libraries can be loaded from a CDN of your choice instead of self-hosted files.
Who is it for?
- Personal bloggers who want a polished static site with built-in SEO, search, and social links without assembling a framework themselves.
- Technical writers and developers who need to render mathematics, flowcharts, maps, music, and Chinese video embeds (Bilibili) inside their posts using shortcodes.
- Multilingual content teams that publish in multiple languages, since the theme is i18n-ready with translations for 12 languages.
- Performance-focused site owners who want high PageSpeed scores and support for multiple analytics providers like Google Analytics, Fathom Analytics, and Yandex.Metrica.
What can you do with uBlogger?
- Launch a personal blog — Set up a responsive blog with a custom home page, dark mode, pagination, and comments, then deploy it to Netlify just like the official demo site.
- Enrich posts with interactive content — Drop KaTeX formulas, mermaid flowcharts, ECharts charts, Mapbox maps, APlayer music players, or Bilibili videos directly into Markdown.
- Add community features — Enable any of eight comment systems such as Disqus, Gitalk, Utterances, or Telegram Comments, and display up to 28 share sites for social sharing.
- Optimize for search discovery — Use the built-in JSON-LD schema, verify the site with Google, Bing, Yandex, and Baidu, and add Lunr.js or Algolia search for readers.
How does uBlogger work?
uBlogger works as a standard Hugo theme: you place it inside your Hugo site's themes directory and configure it through the site's config file. The repository includes an exampleSite that can be previewed by running hugo server --source=exampleSite. Once configured, Hugo builds the static output from your Markdown content, shortcodes, and theme parameters.
Alternatives
- LoveIt — the original theme uBlogger is forked from; it has a similar look but lacks uBlogger's custom header, updated home page, and additional shortcodes.
- KeepIt — another Hugo theme with a comparable design that is mentioned in uBlogger's own comparison of similar-looking themes.
FAQ
Is uBlogger free?
Yes, uBlogger is open source and released under the MIT license, so you can use, modify, and redistribute it freely for personal or commercial projects.
What Hugo version do I need for uBlogger?
The theme badge specifies support for Hugo ^0.62.0 or later. That means you need Hugo 0.62.0 or a newer release to build a site with uBlogger.
uBlogger integrates eight comment systems: Remark42, Disqus, Gitalk, Valine, Facebook Comments, Telegram Comments, Commento, and Utterances. The project author specifically recommends Remark42.
Does uBlogger support search?
Yes, uBlogger includes client-side search using either Lunr.js or Algolia. You can choose which engine to enable in the theme configuration, and autocomplete.js is included for the search box.
What languages are available?
uBlogger comes with i18n translations for 12 languages: English, Simplified Chinese, French, Polish, Brazilian Portuguese, Italian, Spanish, German, Serbian, Russian, Romanian, and Vietnamese, and the project accepts pull requests to add more.
