Skip to content
appsgit

Hugo Xmin

Hugo Xmin is a free, open-source static site theme built with HTML and Hugo. EXtremely Minimal Hugo theme: about 140 lines of code in total, including HTML and CSS (with no dependencies). It has 980 GitHub stars and is released under the MIT license.

github.com/yihui/hugo-xmin (opens in a new tab)

Data as of from the GitHub API; description from the project's repository. Report an error

View on GitHub (opens in a new tab)Live demo (opens in a new tab)

Get started

Copy the files into a new folder with degit (no git history), or clone the repository with git.

Add the theme to an existing Hugo site
git submodule add https://github.com/yihui/hugo-xmin.git themes/hugo-xmin
Copy with degit
npx degit yihui/hugo-xmin my-site
cd my-site
Or clone with git
git clone --depth 1 https://github.com/yihui/hugo-xmin.git my-site

Sources: GitHub docs on template repositories, degit.

About Hugo Xmin

XMin is a Hugo theme written by Yihui Xie in about four hours: half an hour was spent on the Hugo templates, and 3.5 hours were spent on styling. The main motivation for writing this theme was to provide a really minimal example to beginners of Hugo templates. This XMin theme contains about 140 lines of code in total, including the code in HTML templates and CSS (also counting empty lines).

Built with

  • HTML
  • Hugo
GitHub preview card for yihui/hugo-xmin
GitHub social preview of yihui/hugo-xmin. Open the live demo for the real design.

Similar templates

More static site themes

All static site themes

FAQ

Hugo Xmin FAQ

Still curious? Email info@appsgit.com.

How do I use Hugo Xmin?

Copy the files into a new folder with npx degit yihui/hugo-xmin my-site (no git history), or fork the repository on GitHub. Then follow the README for the install and dev commands.

Can I use Hugo Xmin for commercial projects?

Yes. Hugo Xmin is released under the MIT license, a permissive license that allows commercial use as long as you keep the copyright and license notice. Third-party assets bundled with it (images, fonts, icons) may have their own terms.

Is Hugo Xmin maintained?

The repository's most recent commit was on Jun 8, 2026. appsgit only lists templates from repositories with a commit in the last six months.