HugoBlog

tinyce-hugo-theme — Hugo Blog Template

By roperzh

Tinyce is a general-purpose blog theme for Hugo that assigns a color and a Font Awesome icon to each post via the color and icon variables in front matter.

Explore the design

Compare the page layouts and mobile experience. Open any screenshot for a closer look.

1 previews
Author preview
Author-provided preview

Preview provided in the project README.

One original preview is available. Open the full image to inspect the design.

Screenshots show visual appearance; interactive behavior may differ.

Recorded 2026-10-02View source

What stands out

A quick read of the recorded project description.

01

General-purpose Hugo blog theme enabled via the theme field in config

02

Each post can specify one of six preset colors with the color variable in front matter

03

Specify a Font Awesome icon with the icon variable, omitting the fa- prefix

04

Requires a custom archetype to generate post front matter correctly

05

For Hugo v0.11 and earlier, switch to commit 08a497

06

MIT license, allowing free use, modification, commercial use, and distribution

Template Details

Tinyce is a Hugo theme published by roperzh. The repository describes it as a general-purpose theme, and it is categorized as a blog theme. Its core mechanism is to define two additional variables in each post's front matter: color, which specifies the color associated with the post and accepts red, green, blue, yellow, orange, or gray; and icon, which specifies a Font Awesome icon name without the fa- prefix—for example, write heart instead of fa-heart. The theme requires a matching custom archetype to work properly.

Installation involves cloning the repository under themes in a Hugo site directory, then setting theme = "tinyce-hugo-theme" in the config, or starting with hugo server --theme=tinyce-hugo-theme --buildDrafts --watch. The README also notes that for Hugo v0.11 and earlier, you must switch to commit 08a497 after cloning, because the latest version of the theme includes features that depend on Hugo v0.12.

The repository is MIT-licensed and may be used, modified, used commercially, and distributed for free; when distributing, the copyright notice and the full MIT license notice must be retained. The code is provided as is. Third-party assets such as demo images, fonts, and icons must be checked separately under their own licenses. The repository was last updated in 2018, and the Hugo versions and documentation links referenced in the README are from an earlier version context.

HugoBlog

Is it right for your project?

Use Cases

  • Building a personal blog with Hugo that is mainly a list of posts and post pages
  • Content sites where each post should have its own color and icon identifier
  • Reusing the theme in an older Hugo environment (v0.11 and earlier)

Suitable For

  • Users who have Hugo installed and are familiar with config and front matter syntax
  • Authors willing to manually fill in the color and icon variables for each post
  • Blog projects that need an MIT license and the ability to modify the theme source

Getting started & customization

Use these recorded setup notes alongside the repository instructions for your chosen version.

  1. 1

    First run hugo new site my-site to create a site

  2. 2

    Enter the themes directory and run git clone https://github.com/roperzh/tinyce-hugo-theme

  3. 3

    Add theme = "tinyce-hugo-theme" to the config, or add --theme=tinyce-hugo-theme when starting

  4. 4

    Configure a custom archetype for posts and fill in color and icon in front matter

  5. 5

    For Hugo v0.11 and earlier, run git checkout 08a497 in the theme directory

Read repository instructions

License & source material

Usage conditions & limitations

Free to use · keep license notice

This entry covers the free version in the public repository under the MIT license; the free scope applies to that version's code and does not mean external services or third-party assets are free.

Must comply with when using

  • The code of this version may be used, modified, used commercially, and distributed for free.
  • When distributing copies or substantial portions of the code, retain the original author's copyright notice and the full MIT license notice.
  • The code is provided as is; warranties and limitations of liability are governed by the original license and applicable law.

Additional costs & items to verify

  • Using the theme requires configuring a custom archetype for the site; otherwise post front matter cannot be generated correctly, so the theme is not ready to use out of the box.
  • Hugo v0.11 and earlier require switching to commit 08a497; the latest theme depends on Hugo v0.12 features, so older environments cannot use the current code directly.
  • The icon variable must contain a valid Font Awesome icon name without the fa- prefix; otherwise the icon will not display correctly.
  • The color variable only supports red, green, blue, yellow, orange, and gray; other color values are not accepted by the theme.
  • Demo images, fonts, icons, and other third-party assets must be checked under their own licenses and cannot be judged solely by the code's MIT license.
  • External services such as domains, hosting, databases, payments, or AI may incur separate charges.
View Original Text Basis

Permission is hereby granted, free of charge

Original License Text

Tinyce needs a custom archetype in order to work properly

Original README

If you are using Hugo v0.11 or below, please read

Original README

a valid font-awesome icon name, without the `fa-` prefix

Original README

valid colors are: `red`, `green`, `blue`, `yellow`, `orange` and `gray`

Original README
https://github.com/roperzh/tinyce-hugo-theme/blob/master/LICENSE.mdhttps://github.com/roperzh/tinyce-hugo-theme/blob/master/README.md

Compiled by DeepSeek based on repository license and README ·2026-10-02. Results only cover the materials read; dependencies, images, fonts, and subsequent term changes are subject to their respective original texts.

Project checks & description sources

Template Information

Source platforms
GitHub
Documentation and maintenance reference score
Partly documented · 56 / 100
Technologies
Hugo
Website type
Blog
How this score is calculated

Our heuristic uses license records (up to 30), a demo link (12), a preview (10), stars (15), recorded maintenance (15), description completeness (8), feature records (5) and classification data (5). It is not a code, security or performance test, or a Google score. A link does not establish tested functionality.

What to verify for this project

Repository update recorded
2018-04-26
Screenshot last checked
2026-10-02

No demo link is recorded. Use the repository instructions to evaluate the project locally; the screenshot alone cannot establish interactive behavior.

The catalog identifies Hugo as the primary stack. Check the actual dependency manifest and lockfile for versions and hosting requirements. These notes use recorded metadata, not a code audit or a deployment test.

Use a selection guide →

How this description was prepared

AI-assisted description based on catalog records and repository material. Repository authors are not automatically the reviewers of this description.

Automatically checked against source and license rules; no manual editorial review.

Inspect the recorded source material

SHA-256: 6a1e2f3741987639f96df88f182f998801b44234df76007fe0d2e87fc5b67034

2026-10-02T10:16:37.409Z

Source file / repository
Tinyce
===

Tinyce is a general-purpose [Hugo](http://hugo.spf13.com) theme.

![screenshot - 08092014 - 07 02 07 pm](https://cloud.githubusercontent.com/assets/4419992/3867787/120f0158-2011-11e4-9f50-0ccfa162cdd2.png)

You can check the live version [here](http://roperzh.github.io/tinyce-hugo-theme/).

Getting started
===

Once you have Hugo up and running, you must:

Create a Hugo project:

```bash
$ hugo new site my-site
```

And then install tinyce:

```bash
$ cd themes
$ git clone https://github.com/roperzh/tinyce-hugo-theme
```

*If you are using Hugo v0.11 or below, please read [this](https://github.com/roperzh/tinyce-hugo-theme/#usage-with-hugo-v011-and-below)*

Now you can set tinyce as the default theme for your site by adding this line
in the `config` file:

```toml
theme = "tinyce-hugo-theme"
```

Or you can start the server with:

```bash
hugo server --theme=tinyce-hugo-theme --buildDrafts --watch
```

Setting Variables
===

Tinyce needs a custom archetype in order to work properly, behind the covers
you will only need to define two new variables in the front matter section of
your contents.

- **color** : the color associated with the post, valid colors are: `red`,
`green`, `blue`, `yellow`, `orange` and `gray`.

- **icon** : a valid font-awesome icon name, without the `fa-` prefix. For example,
instead of `fa-heart`, you only need to put `heart`. [here](http://fortawesome.github.io/Font-Awesome/cheatsheet/)
is a cheatsheet of valid icons.

***Example***

```toml
+++
Categories = ["Development", "GoLang"]
Description = "My short description"
Tags = ["Development", "golang"]
color = "green"
icon = "heart"
title = "Go is cool"
date = 2014-08-09T05:04:40Z
+++

```

Usage with Hugo v0.11 and below
===

The latest version of the theme includes some features bundled with Hugo v0.12,
if you are using an old version, please install tinyce like this:

```bash
$ cd themes
$ git clone https://github.com/roperzh/tinyce-hugo-theme
$ cd tinyce-hugo-theme
$ git checkout 08a497
```

That's it!

Contributing
===

1. Fork it

2. Create your feature branch (`git checkout -b my-new-feature`)

3. Commit your changes (`git commit -am 'Add some feature'`)

4. Push to the branch (`git push origin my-new-feature`)

5. Create new Pull Request
Report a correction

Explore similar templates

Compare previews and descriptions within the same stack and category.