Top Related Projects
A fast, clean, responsive Hugo theme.
A minimalist blog theme for hugo.
Ananke: A theme for Hugo Sites
A simple, retro theme for Hugo
Quick Overview
Hugo-theme-stack is a modern, responsive, and feature-rich theme for the Hugo static site generator. It offers a clean and customizable design, perfect for personal blogs, portfolios, and content-focused websites. The theme emphasizes readability and user experience while providing a range of built-in features and customization options.
Pros
- Responsive design that works well on various devices and screen sizes
- Built-in dark mode support for improved readability in low-light conditions
- Extensive customization options through configuration files and custom CSS
- Integration with popular services like Google Analytics, Disqus, and social media platforms
Cons
- Steeper learning curve for users new to Hugo or static site generators
- Limited built-in color scheme options, requiring custom CSS for significant color changes
- Some features may require additional setup or configuration
- Potential performance impact with heavy use of JavaScript-based features
Getting Started
To use the Hugo-theme-stack theme, follow these steps:
- Install Hugo on your system (https://gohugo.io/getting-started/installing/)
- Create a new Hugo site:
hugo new site my-site cd my-site
- Add the theme as a submodule:
git init git submodule add https://github.com/CaiJimmy/hugo-theme-stack.git themes/hugo-theme-stack
- Copy the example site content:
cp -r themes/hugo-theme-stack/exampleSite/* .
- Update the
config.yaml
file with your site details - Start the Hugo server:
hugo server
Your site should now be running locally with the Hugo-theme-stack theme. Customize the content and configuration as needed for your specific use case.
Competitor Comparisons
A fast, clean, responsive Hugo theme.
Pros of PaperMod
- Lightweight and fast-loading theme with minimal dependencies
- Extensive customization options through configuration files
- Built-in search functionality without external services
Cons of PaperMod
- Less visually striking design compared to Stack's modern layout
- Fewer built-in widgets and social media integrations
- Limited support for image galleries and multimedia content
Code Comparison
PaperMod (config.yml):
params:
homeInfoParams:
Title: "Welcome to my blog"
Content: "This is a simple blog using Hugo PaperMod theme"
socialIcons:
- name: "github"
url: "https://github.com/username"
Stack (config.yaml):
params:
sidebar:
emoji: 🍥
subtitle: "A clean, elegant Hugo theme"
avatar:
enabled: true
local: true
src: "img/avatar.png"
The code snippets demonstrate the different approaches to configuration. PaperMod uses a simpler structure for basic site information and social icons, while Stack offers more detailed customization options for the sidebar, including emoji and avatar settings.
A minimalist blog theme for hugo.
Pros of hugo-coder
- Minimalist design, focusing on clean and simple layouts
- Extensive customization options through configuration files
- Multilingual support out of the box
Cons of hugo-coder
- Less visually striking compared to hugo-theme-stack's modern design
- Fewer built-in features for content organization and presentation
- Limited social media integration options
Code Comparison
hugo-coder:
<nav class="navigation">
{{ range .Site.Menus.main }}
<a href="{{ .URL }}">{{ .Name }}</a>
{{ end }}
</nav>
hugo-theme-stack:
<nav class="menu">
{{ range .Site.Menus.main }}
<li class="menu-item">
<a href="{{ .URL }}" title="{{ .Title }}">{{ .Name }}</a>
</li>
{{ end }}
</nav>
Both themes use similar Hugo templating for navigation, but hugo-theme-stack includes additional semantic markup and title attributes for improved accessibility and SEO.
hugo-coder is ideal for developers and writers who prefer a minimalist approach, while hugo-theme-stack offers a more feature-rich and visually appealing option for content-heavy websites and blogs.
Ananke: A theme for Hugo Sites
Pros of Ananke
- Simpler and more lightweight, making it easier to customize and maintain
- Better documentation with detailed setup instructions and configuration options
- More language translations available out-of-the-box
Cons of Ananke
- Less feature-rich compared to Stack, with fewer built-in components and layouts
- Not as visually striking or modern in design as Stack
- Limited social media integration options
Code Comparison
Stack uses a more modular approach for layout components:
{{ define "main" }}
<main class="main">
{{ partial "article-list.html" . }}
</main>
{{ partial "sidebar.html" . }}
{{ end }}
Ananke uses a simpler, more traditional layout structure:
{{ define "main" }}
<article class="cf ph3 ph5-l pv3 pv4-l f4 tc-l center measure-wide lh-copy mid-gray">
{{ .Content }}
</article>
{{/* Define a section to pull recent posts from. For Hugo 0.20 this will default to the section with the most number of pages. */}}
{{ $mainSections := .Site.Params.mainSections | default (slice "post") }}
{{/* Create a variable with that section to use in multiple places. */}}
{{ $section := where .Site.RegularPages "Section" "in" $mainSections }}
{{/* Check to see if the section is defined for ranging through it */}}
{{ $section_count := len $section }}
{{ if ge $section_count 1 }}
{{/* Derive the section name */}}
{{ $section_name := index (.Site.Params.mainSections) 0 }}
<div class="pa3 pa4-ns w-100 w-70-ns center">
{{/* Use $section_name to get the section title. Use "with" to only show it if it exists */}}
{{ with .Site.GetPage "section" $section_name }}
<h1 class="flex-none">
{{ $.Param "recent_copy" | default (i18n "recentTitle" .) }}
</h1>
{{ end }}
{{ $n_posts := $.Param "recent_posts_number" | default 3 }}
<section class="w-100 mw8">
{{/* Range through the first $n_posts items of the section */}}
{{ range (first $n_posts $section) }}
<div class="relative w-100 mb4">
{{ partial "summary-with-image.html" . }}
</div>
{{ end }}
</section>
{{ if ge $section_count (add $n_posts 1) }}
<section class="w-100">
<h1 class="f3">{{ i18n "more" }}</h1>
{{/* Now, range through the next four after the initial $n_posts items. Nest the requirements, "after" then "first" on the outside */}}
{{ range (first 4 (after $n_posts $section)) }}
<h2 class="f5 fw4 mb4 dib mr3">
<a href="{{ .Permalink }}" class="link black dim">
{{ .Title }}
</a>
</h2>
{{ end }}
{{/* As above, Use $section_name to get the section title, and URL. Use "with" to only show it if it exists */}}
{{ with .Site.GetPage "section" $section_name }}
<a href="{{ .Permalink }}" class="link db f6 pa2 br3 bg-mid-gray white dim w4 tc">{{ i18n "allTitle" . }}</a>
{{ end }}
</section>
{{ end }}
</div>
{{ end }}
{{ end }}
A simple, retro theme for Hugo
Pros of hugo-theme-terminal
- Minimalist design with a focus on content and readability
- Customizable color schemes and easy theming options
- Lightweight and fast-loading, ideal for text-heavy blogs
Cons of hugo-theme-terminal
- Limited built-in features compared to hugo-theme-stack
- Less visually appealing for image-heavy or portfolio-style websites
- Fewer layout options and content organization possibilities
Code Comparison
hugo-theme-terminal:
<header class="header">
<div class="header__inner">
<div class="header__logo">
{{ partial "logo.html" . }}
</div>
{{ partial "menu.html" . }}
</div>
</header>
hugo-theme-stack:
<header class="site-header">
{{ partial "header/site-name.html" . }}
{{ partial "header/menu.html" . }}
{{ partial "header/social-menu.html" . }}
{{ partial "header/colorscheme-toggle.html" . }}
</header>
The code comparison shows that hugo-theme-stack has a more modular structure with separate partials for different header elements, while hugo-theme-terminal has a simpler, more compact header structure. This reflects the overall design philosophy of each theme, with hugo-theme-stack offering more features and customization options, and hugo-theme-terminal focusing on simplicity and minimalism.
Convert
designs to code with AI
Introducing Visual Copilot: A new AI model to turn Figma designs to high quality code using your components.
Try Visual CopilotREADME
Hugo Theme Stack

Card-style Hugo theme designed for bloggers.
Quickstart
Use this template: CaiJimmy/hugo-theme-stack-starter
Demo
- Starter template demo: demo.stack.jimmycai.com
- Dev build: dev.stack.jimmycai.com
Documentation
Visit stack.jimmycai.com
Copyright
Licensed under the GNU General Public License v3.0
Please do not remove the "Theme Stack designed by Jimmy" text and link.
If you want to port this theme to another blogging platform, please let me knowð.
Top Related Projects
A fast, clean, responsive Hugo theme.
A minimalist blog theme for hugo.
Ananke: A theme for Hugo Sites
A simple, retro theme for Hugo
Convert
designs to code with AI
Introducing Visual Copilot: A new AI model to turn Figma designs to high quality code using your components.
Try Visual Copilot