Installation Theme

Install FixIt theme for your Hugo site in a few steps.

1. Configure the default theme to FixIt in hugo.toml, e.g. theme = "FixIt"
2. Install the theme by one of the following ways.

Prerequisites

Thanks to the simplicity of Hugo, Hugo may be the only dependency of this theme.

Although not required in all cases, Git, Go, Dart Sass and Node.js are commonly used when working with Hugo.

Git is required to:

• Build Hugo from source
• Use the Hugo Modules feature
• Install a theme as a Git submodule
• Access commit information from a local Git repository
• Host your site with services such as CloudCannon, Cloudflare Pages, GitHub Pages, GitLab Pages, and Netlify

Go is required to:

• Build Hugo from source
• Use the Hugo Modules feature

Dart Sass is required to transpile Sass to CSS when using the latest features of the Sass language.

Node.js is required to:

• Use the FixIt CLI
• Some Automation Tools, e.g. atomic-algolia

Please refer to the relevant documentation for installation instructions:

• Hugo (extended edition, v0.123.0 or later)
• Git
• Go
• Dart Sass (not used yet)
• Node.js (v16.0.0 or later)

Manual

You can download the latest release  .zip file of the theme and extract it in the themes directory.

To upgrade the theme by replacing the old theme with the new one.

Git Clone

In this way, just clone the FixIt theme into the themes directory.

1

git clone https://github.com/hugo-fixit/FixIt.git themes/FixIt

To upgrade the theme by pulling the latest commits from the repository.

1
2

cd themes/FixIt
git pull

Git Submodule

Initialize an empty Git repository in the current directory.

1

git init

Add FixIt to your project as a Git submodule stored in the themes directory.

1

git submodule add https://github.com/hugo-fixit/FixIt.git themes/FixIt

To use the version on the dev branch, you can use the following command:

1
2
3
4

git submodule add -b dev https://github.com/hugo-fixit/FixIt.git themes/FixIt

# Alternatively, switch the submodule branch from `master` to `dev`:
git submodule set-branch -b dev themes/FixIt

To upgrade the theme by using the following command:

1

git submodule update --remote --merge themes/FixIt

Hugo Module

The easiest way to use a Module for a theme is to import it in the config. See Use Hugo Modules.

1. Initialize the hugo module system: hugo mod init github.com/<your_user>/<your_project>

2. Import the theme:

   1 2 3

   [module] [[module.imports]] path = "github.com/hugo-fixit/FixIt"

To update or manage versions, you can use hugo mod get.

1
2
3
4
5
6
7
8

# Update all modules
hugo mod get -u
# Update all modules recursively
hugo mod get -u ./...
# Update one module
hugo mod get -u github.com/hugo-fixit/FixIt
# Get a specific version (e.g. v0.3.2, @latest, @master, @dev)
hugo mod get github.com/hugo-fixit/FixIt@v0.3.2

CLI

FixIt provides an official CLI for quickly scaffolding ambitious Hugo FixIt site skeleton. It provides two ways to quickly scaffold Hugo FixIt site based on Git Submodule or Hugo Module, and provides the ability to check the latest version of the FixIt theme. See the FixIt CLI docs for more details.

1
2

npm install -g fixit-cli
fixit create my-blog

Comparison