Hugo Future ImperfectSlim is a theme based on jpescador’s
port of HTML5 UP’s theme by the same name.
The goal of this theme is to continue the development of the original theme.
This version takes that port and modernizes it with CSS Grid and Modern
Check out the live demo
on the Hugo Theme Showcase.
Depending on how you plan to utilize the theme, there are two different ways we
recommend getting started.
If your goal is to simply use the theme on your site even if you plan to
customize the theme, and not make pull requests to this repository, you should
add the theme as a submodule to your project.
After you have extracted the files from the exampleSite directory, do the
following from within the root directory of your site:
mkdir themes // Creates a "themes" Folder
cd themes // Points to the "themes" Folder
git submodule add https://github.com/pacollins/hugo-future-imperfect-slim.git
All of the theme files will be accessible from themes/hugo-future-imperfect-slim
from within your project folder.
If you wish to customize any of the files in the theme for your personal use,
simply create a duplicate file at the project-level instead of the theme level.
This is function that is innate to Hugo based on Hugo’s lookup order
For example, if you wanted to change the About Me Page Template (<my-project>/themes/layouts/_default/about.html). You would create a new files at <my-project>/layouts/_default/about.html based on the theme file, but including your modifications
This is the proper way to adjust files for personal use in a way that does not
make your site incompatible with the theme.
When you are ready to update your site to the current version of the theme, do
git submodule update --remote --merge
If you plan on assisting with developing the theme, you will want to have your
own copy that is not a submodule. To do this, navigate to where you want to
place it and do the following:
To get started, you will want to copy exampleSite/config.toml to the root
directory of your project.
For details on the config.toml, please refer to the
If you would like static comments powered by Staticman,
you will also need to copy exampleSite/staticman.yml to the root directory of
For details on the Staticman, please refer to the
You can adapt this theme according to your preferences using your own JS or CSS
code. To do this, you can either edit the exampleSite/static/css/add-on.css or
exampleSite/static/js/add-on.js files, or you can load your own files by adding
them to the cssFiles and jsFiles parameters in config.toml.
Hugo’s Built-In Server
To see a live version of your site locally, use the following command:
Hugo will build your site and host a server locally. You can view this live at
Hugo Future Imperfect is a theme by HTML5 UP.
Julio Pescador took the code provided from them and
ported it over so that it could be used with Hugo. Patrick Collins
then took this port, broke it down and restructured it under newer Hugo functions
in addition to building it mobile-first utilizing CSS Grid. This also allowed for
the slimming of the CSS and JS files originally included to strip those features
not used in the site (hence the name, slim). During the this time, StatnMap
worked on overhauling the majority of the theme to include Multilingual
functionality - which is included here.
Since the original development had become stale and the redesign is not
directly compatible with previous versions of the original Hugo Future Imperfect,
it is now in its own repo to help aid in development and prevent confusion.