# Hugo Xmin (Static site themes)

> 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 977 GitHub stars and is released under the MIT license.

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).

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/yihui/hugo-xmin |
| Built with | HTML, Hugo |
| Live demo | https://xmin.yihui.org |
| GitHub template repository | no |
| GitHub stars | 977 |
| License | MIT |
| Language | HTML |
| Official | no |
| Category | Static site themes |
| Latest release | none |
| Last commit | Jun 8, 2026 |

## Get started

### Add the theme to a Hugo site

```sh
git submodule add https://github.com/yihui/hugo-xmin.git themes/hugo-xmin
```

### Copy with degit

```sh
npx degit yihui/hugo-xmin my-site
cd my-site
```

### Or clone with git

```sh
git clone --depth 1 https://github.com/yihui/hugo-xmin.git my-site
```

Commercial use depends on the MIT license. Sources: https://docs.github.com/en/repositories/creating-and-managing-repositories/creating-a-repository-from-a-template, https://github.com/Rich-Harris/degit

## Similar templates

- [al-folio](https://appsgit.com/templates/al-folio): A beautiful, simple, clean, and responsive Jekyll theme for academics. (16,230 stars, MIT)
- [Hugo PaperMod](https://appsgit.com/templates/hugo-papermod): A fast, clean, responsive Hugo theme. (13,980 stars, MIT)
- [Minimal Mistakes](https://appsgit.com/templates/minimal-mistakes): Jekyll theme for building a personal site, blog, project documentation, or portfolio. (13,586 stars, MIT)
- [Jekyll Theme Chirpy](https://appsgit.com/templates/jekyll-theme-chirpy): A minimal, responsive, and feature-rich Jekyll theme for technical writing. (10,282 stars, MIT)
- [Just The Docs](https://appsgit.com/templates/just-the-docs): A modern, high customizable, responsive Jekyll theme for documentation with built-in search. (9,190 stars, MIT, official)
- [Huxpro site](https://appsgit.com/templates/huxpro-site): The original Jekyll blog and theme, preserved at huxpro.github.io. (7,612 stars, Apache-2.0)

---

Canonical page: https://appsgit.com/templates/hugo-xmin
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.