Skip to content
MaterializeCSS based Hugo theme which provides out of the box best practices.
HTML CSS JavaScript
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Initial Sep 21, 2019
archetypes Initial Sep 21, 2019
assets Color themes Oct 3, 2019
exampleSite Video respects Privacy.YouTube.Disable Oct 8, 2019
i18n 404 Page not found Oct 3, 2019
images Readme, footer fix, screenshots Sep 22, 2019
layouts Video respects Privacy.YouTube.Disable Oct 8, 2019
static reworked most of the theme, added fa Sep 22, 2019
LICENSE Initial commit Sep 21, 2019 Initial Sep 21, 2019 Color themes Oct 3, 2019
theme.toml Semantic Versioning Oct 6, 2019

Materialize-BP hugo theme

MaterializeCSS based Hugo theme which provides out of the box best practices like performance and SEO readiness. Featured images will be resized automatically. This is based on the Hugo docs, hugo-best-practices, Front-End Checklist and the Front-End Performance Checklist.

Other themes by Sebastian Pech: Bootstrap-BP, Materialize-BP, Bootstrap-BP hugo startpage.

Table of contents


  • Color themes
  • SEO best practices supported (, open graph, meta information, ...)
  • Automatically resizing of images
  • One minified file per ressource only (js, css)
  • CDN font support (Google Fonts, ...)
  • Optional masonry-like mode for startpage
  • Settings for easy customization of layouts and features
  • Multiple page templates / archetypes supported
  • Icons for Social Media
  • Custom css/js
  • Multilingual and i18n support
  • ...

Install the theme

With Git installed, run the following commands inside the Hugo site folder. If Hugo has not yet been installed, read the setup guide here.

mkdir themes
cd themes
git clone

You can get a zip of the latest version of the theme from the home page and extract it to the themes folder.

Update the theme

Go to the themes folder as in the installation and run the following command.

git pull

Run example site

Go to the exampleSite folder from the theme themes/materialize-bp-hugo-theme/exampleSite and run the following command.

hugo server --themesDir ../..

Configuration and theme specific settings

Most settings should be done with hugo specific variables. There are only a few (optional) additional [params]. Use the config.toml from the exampleSite subdirectory as base.

  • startPageColumns = true will show the start page in a Masonry-like mode.
  • customDateFormat = "02.01.2006" to override the date format.
  • showListsGrouped = true to add headers for every year.
  • showPostSummary = true to only show a summary on index and lists.
  • alwaysExpandMenu = true to expand the menu on non-mobile devices otherwise the mobile button is shown on all devices. (WiP - Only in bootstrap at the moment)
  • hideReadingTime to hide reading time.

Theme colors might be changed using the main colors from Materialize color palette. Might be like one of this: red, pink, indigo lighten-2, cyan, blue, light-green, amber, ...

  • themeColor1 used by main buttons and navbar. (default=light-blue)
  • themeColor1text used by headlines. (default=light-blue-text)
  • themeColor2 used by footer. (default=orange)
  • themeColor2text used by footer and card actions. (default=orange-text text-lighten-3)

Currently the link color, pagination and blockquote color needs to be adjusted according to main.css too. Overwrite in your /assets/css/custom.css file.

Screenshots of cofigurations

startPageColumns = false

startPageColumns = false

startPageColumns = true

startPageColumns = true

Google Analytics

This theme uses the internal asynchronous template for Google Analytics tracking. You only have to provide your tracking id in your configuration file.

googleAnalytics = "UA-123-45"

Page templates / archetypes

This theme has support for the following archetypes. Based on the specified types the layout and functionality of a page is slightly changed.

  • Page (not on the startpage)
  • Post (regular post/blog pages)
  • Audio (shows spotify in the header)
  • Video (shows youtube in the header)
  • Quote (highlights a quote and the author)
  • Link (show a link with the page title) support

Provide one author to enable the support.

  name = "Sebastian Pech"

Images, Open Graph and Twitter Cards

This theme uses Hugos feature/cover name method to set the optimized feature image. The image named *feature* or *cover* is used for the posts featured image and get resized. This will also be in the Twitter Cards and Open Graph block.

The header image is automatically added if there is a file called *feature* or *cover*. The first wildcard is prefered over the second one. If there are multiple images the first one is used.

# Site Config toml
title = "My hugo site"

  description = "Text about the site"

# Post yaml
title: "{{ replace .Name "-" " " }}"
date: {{ .Date }}
publishdate: {{ now.Format "2006-01-02" }}
lastmod: {{ now.Format "2006-01-02" }}
draft: true
description: "Text about this post"
    - "tag 1"


There are two menus in the theme. main and footer. Specify the entries in the config or the header of the content.


    identifier = "about"
    # name = "About"  # Material Icons are displayed as block so use the icon only
    url = "/about/"
    weight = 10
    pre = "<i class='material-icons'>speaker_notes</i>" # Material Icons
    # pre = "<i class='fas fa-heart'></i>" # FontAwesone has more love ;-)

    identifier = "Imprint"
    name = "Imprint"
    url = "/imprint/"
    weight = 10

    identifier = "categories"
    name = "Categories"
    url = "/categories/"
    weight = 20

    identifier = "tags"
    name = "Tags"
    url = "/tags/"
    weight = 30
menu = "main"

Social Icons

Icons for Social Media. Add the block to the config.

# Sets Social Media icons to appear and link to your account. Value should be your
# username unless otherwise noted.
# Code from theme
  # Coding Communities
  github           = ""
  gitlab           = ""
  stackoverflow    = "" # User Number
  bitbucket        = ""
  jsfiddle         = ""
  codepen          = ""
  # Visual Art Communities
  deviantart       = ""
  flickr           = ""
  behance          = ""
  dribbble         = ""
  # Publishing Communities
  wordpress        = ""
  medium           = ""
  # Professional/Business Oriented Communities
  linkedin         = ""
  linkedin_company = ""
  foursquare       = ""
  xing             = ""
  slideshare       = ""
  # Social Networks
  facebook         = "spechde" #
  googleplus       = ""
  reddit           = ""
  quora            = ""
  youtube          = "/channel/UCrRRKovAoTYGIIB9T08pbHw" #
  vimeo            = ""
  whatsapp         = "" # WhatsApp Number
  instagram        = "sebastian_pech" #
  tumblr           = ""
  twitter          = "spech84"
  skype            = ""
  snapchat         = ""
  pinterest        = ""
  telegram         = ""
  # Email
  email            = ""

Custom CSS/JS

The theme provides two ways for custom css/js. The first way is writing your styles to /assets/css/custom.css and scripts to /assets/js/custom.js. This will merge and minify the styles/scripts with the theme specific files resulting in only one file for the whole website.

The second way is using the Site configuration or the post metadata to target specific files in the /assets/ folder. This will result in one import line per script/style.

    - /js/test.js
    - /css/test.css
You can’t perform that action at this time.