Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Showcase theme for Hugo

Latest Release Showcase hugo theme Hugo generator

Showcase is a minimal, single page theme for Hugo


Preview Dark


  • Auto-generated menu
  • Responsive content
  • Filtering content
  • Social links
  • Custom menu
  • Darkmode

Get the theme

Run from the root of your Hugo site:

git clone themes/showcase

Alternatively, you can include this repository as a git submodule. This makes it easier to update this theme if you have your Hugo site in git as well:

git submodule add themes/showcase

Preview the theme with example content

Showcase theme ships with an fully configured example site. For a quick preview:

Copy the package.json file from themes/showcase folder to your hugo website root folder, and run npm install.

cd themes/showcase/exampleSite/
hugo serve --themesDir ../..

Then visit http://localhost:1313/ in your browser to view the example site.

Configuring theme to a hugo website

  1. Copy package.json and package-lock.json to the root folder of your the website
  2. Run npm install to install required packages for theme
  3. Run npm i -g postcss-cli to use PostCSS with Hugo build
  4. Set theme = 'showcase' in config.toml
  5. Run npm start to start your local server

Make sure to commit the above changes to your repository.

When deploying to services like Netlify or Vercel, use the following command for building your site:

npm i && hugo -D --gc

Migrating to v1.3.0

Minimum Hugo Version: 0.69.0

  • Copy the package.json file from themes/showcase folder to your hugo website root folder, and run npm install.

Add content

The following explains how to add content to your Hugo site. You can find sample content in the exampleSite/ folder.


├── ...
├── projects       # Section Name
│   ├── project1   # Project 1
│   ├── project2   # Project 2
│   └── _index     # (optional) Customize section name &
│                  # default image for section contents
└── ...

Configure your site

From exampleSite/, copy config.toml to the root folder of your Hugo site and change the fields as you like. Helpful comments are provided.


Menu in Showcase theme is auto-generated from the sections inside your content folder.

Exclude Sections from Menu

It is possible to exclude sections from the auto-generated list. In order to exclude a section, create an file in that section and set the property private to true. Refer example index file.

Custom Menu

You can also add a custom menu item using the config.toml and disable auto-generated sections if not required. Refer config in exampleSite

Dark mode

In order to enable darkmode toggle in your side, set the params.darkMode property to true in your config.toml.

Google Analytics

Set googleAnalytics in config.toml to activate Hugo's internal Google Analytics template.

Used By


If you have a question, please open an issue for help and to help those who come after you. The more information you can provide, the better!


Contributions are welcome. For major changes, please open an issue first to discuss what you would like to change.


Licensed under MIT


Madhu Akula