General-purpose Hugo blog theme enabled via the theme field in config
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.
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.
What stands out
A quick read of the recorded project description.
Each post can specify one of six preset colors with the color variable in front matter
Specify a Font Awesome icon with the icon variable, omitting the fa- prefix
Requires a custom archetype to generate post front matter correctly
For Hugo v0.11 and earlier, switch to commit 08a497
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.
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
First run hugo new site my-site to create a site
- 2
Enter the themes directory and run git clone https://github.com/roperzh/tinyce-hugo-theme
- 3
Add theme = "tinyce-hugo-theme" to the config, or add --theme=tinyce-hugo-theme when starting
- 4
Configure a custom archetype for posts and fill in color and icon in front matter
- 5
For Hugo v0.11 and earlier, run git checkout 08a497 in the theme directory
License & source material
Usage conditions & limitations
Free to use · keep license noticeThis 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
https://github.com/roperzh/tinyce-hugo-theme/blob/master/LICENSE.mdhttps://github.com/roperzh/tinyce-hugo-theme/blob/master/README.mdvalid colors are: `red`, `green`, `blue`, `yellow`, `orange` and `gray`
Original README
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 / repositoryTinyce === Tinyce is a general-purpose [Hugo](http://hugo.spf13.com) theme.  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
Explore similar templates
Compare previews and descriptions within the same stack and category.

hugo-PaperMod
A fast, clean, responsive Hugo theme for blogs and lightweight portfolios, with three layout modes (Regular, Home-Info, Profile), automatic and manual light/dark themes, Fuse.js client-side search, multilingual support, and built-in Open Graph, Twitter Cards, and Schema.org data.
Hugo · Portfolio

LoveIt
LoveIt is a clean, elegant, and feature-rich Hugo blog theme derived from LeaveIt and KeepIt, MIT-licensed. It offers light/dark modes, responsive layout, multilingual support, and search via Lunr.js or Algolia.
Hugo · Blog

hugo-coder
hugo-coder is a minimalist Hugo blog theme maintained by luizdepra under the MIT license. It provides a clean, text-focused blog appearance, configuration documentation in the docs directory, and a complete exampleSite with hugo.toml.
Hugo · Blog

blowfish
Blowfish is a Hugo personal website and blog theme built with Tailwind CSS 4, focused on lightness, simplicity, and content-first presentation.
Hugo · Blog

hugo-paper
hugo-paper is a simple, clean, and customizable Hugo blog theme configured through config.toml or hugo.toml.
Hugo · Blog

hextra
Hextra is a Hugo theme for documentation and blog sites, built on Hugo and Tailwind CSS with design referencing Nextra.
Hugo · Documentation
