HUGO
News Docs Themes Community GitHub

Hugo Bear Blog

A Hugo theme based on »Bear Blog«. Free, no-nonsense, super-fast blogging. »Bear Blog« now includes a dark color scheme to support dark mode!

License
MIT
GitHub Stars
1065
Last Updated
2025-03-18

Hugo ʕ•ᴥ•ʔ Bear Blog CI

🧸 A Hugo-theme based on Bear Blog.

Free, no-nonsense, super-fast blogging.

Demo

For a current & working demo of this theme, please check out https://janraasch.github.io/hugo-bearblog/ 🎯.

Screenshots

⬜️ Light

⬛️ Dark

When the user’s browser is running »dark mode«, the dark color scheme will be used automatically. The default is the light/white color scheme. Check out the style.html-file for the implementation.

Installation

If you already have a Hugo site on your machine, you can simply add this theme via

git submodule add https://github.com/janraasch/hugo-bearblog.git themes/hugo-bearblog

Then, adjust the hugo.toml as detailed below.

For more information, read the official setup guide of Hugo.

Adjust configuration / hugo.toml

Please check out the hugo.toml included in the exampleSite of this theme.

Content & structure

Starting fresh

If you are starting fresh, simply copy over the contents of the exampleSite-directory included in this theme to your source directory. That should give you a good idea about how things work, and then you can go on from there to make the site your own.

Adding / editing content

Index-Page

The contents of the index-page may be changed by editing your content/_index.md-file.

Page

You can add a new page via running

hugo new my-new-page.md

Blog-Post

You can add a new blog-post via running

hugo new blog/my-new-post.md

Adding your branding / colors / css

Add a custom_head.html-file to your layouts/partials-directory. In there you may add a <style>-tag, or you may add a <link>-tag referencing your own custom.css (in case you prefer to have a separate .css-file). Check out the style.html-file to find out which CSS-styles are applied by default.

Remixes 🎭

The community has created some interesting variations of Hugo ʕ•ᴥ•ʔ Bear Blog. While the main theme stays true to the minimal Bear Blog philosophy, these remixes experiment with additional features:

  • Hugo ʕ•ᴥ•ʔ Bear Blog ✨ Neo - Features Chinese documentation and an innovative “Toast” upvote system.

  • ᕦʕ •ᴥ•ʔᕤ Bear Cub - A multilingual variant with experimental features like automatic social card generation.

Note: These are independent forks maintained by their respective creators.

Contributing & Community 🤝

Interested in contributing to Hugo ʕ•ᴥ•ʔ Bear Blog? Thanks for your interest!

  • Check out our Contributing Guidelines for code contributions and bug reports
  • Share your story if you’re using the theme - we’d love to see what you’ve built!
  • Have questions? You can find help in our GitHub issues or the Hugo Discourse

We aim to keep this theme as simple and fast as the original Bear Blog, while making it a friendly space for everyone to contribute and share their experiences.

Development

Run the exampleSite locally via

hugo server --source ./exampleSite --themesDir ../..

Special Thanks 🎁

A special thank you goes out to Herman, for creating the original ʕ•ᴥ•ʔ Bear Blog.

License

MIT License © Jan Raasch