See online demo

Follow the official installation guide

You need the extended version

hugo new site my-site

This will create a fresh Hugo site in the folder my-site.

Clone this repo into the themes folder

cd my-site
git clone https://github.com/jmau111/hugo-theme-ava.git themes/hugo-themes-ava

You can use contents generated for the demo:

cp -a themes/hugo-theme-ava/exampleSite/. .

Feel free to change colors for both light and dark mode. See themes/hugo-theme-ava/assets/scss/_mode_light.scss or themes/hugo-theme-ava/assets/scss/_mode_dark.scss.

You can customize other CSS variables in themes/hugo-theme-ava/assets/scss/_variables.scss

You don't have to remove the one set in the theme but ensure you replace the one in the /static/ folder at the root or your project.

I've included the humans.txt file cause I care about this file. You can put your name in it or replace this entire file in your /static/ folder at the root of the project:

Copy the config.toml file into the root folder of your Hugo site, then you can modify the copy.

Run dev server:

hugo server

Then you can go to localhost:1313.

Build:

hugo

baseURL = "https://www.mysite.com/"

Ensure you use a trailing slash.

Add you google analytics ID to the config.toml

// config.toml
[params]
  ga_id="UA-XXXXXXXX-X"

You can edit and add main menu links in the config.toml under [[menu.main]]

You can set a default image in config.toml:

  [params.meta_tags]
          meta_og_image = "https://raw.githubusercontent.com/jmau111/hugo-theme-ava/main/images/default.jpeg"

You can customize per each post in the front matter:

image: "/images/mangoose.jpeg"

If you don't set anything then the theme display the default image "https://raw.githubusercontent.com/jmau111/hugo-theme-ava/main/images/default.jpeg".

A lot of stuff, including:

• i18n
• more shortcodes
• author box

But still, it's not a multi-purpose theme.

You're welcome to fork this, but keep the license MIT please.