Installation

Installation Sugam Pokharel

This guide walks you through installing the Sugo theme for Hugo.

Repository: github.com/psugam/sugo

Prerequisites

Before installing Sugo, make sure you have:

Verify installation

1

hugo version

Expected format:

1

hugo v0.146.0+extended ...

Make sure this is the Extended Hugo build.

1
2
3

git --version
node --version
npm --version

Installation methods

Option A: Git submodule (recommended)

1. Initialize git

1
2

cd your-hugo-site
git init

2. Add theme submodule

1

git submodule add https://github.com/psugam/sugo themes/sugo

3. Copy starter content/config

1
2

cp -r themes/sugo/content ./
cp -r themes/sugo/hugo.toml ./

4. Set theme name

In your root hugo.toml:

1

theme = "sugo"

5. Run locally

1
2

npm install
npm run dev

Option B: Manual download

1. Download ZIP from github.com/psugam/sugo
2. Extract it
3. Move it to themes/sugo

1

mv sugo-main your-hugo-site/themes/sugo

Then follow the same config and run steps above.

Updating the theme

Submodule update

1

git submodule update --remote --merge

Manual update

1. Download latest release/source
2. Replace themes/sugo
3. Review changes before deploy

Next steps

• Homepage
• Params and Customization
• Search