Configuration Support & Module Organization

noreply@example.com (AG Sayyed) — Thu, 25 Sep 2025 14:30:00 +0000

Configuration Support & Module Organization

This document details how we successfully achieved modular configuration organization for HBStack without breaking Hugo’s core functionality. We solved the challenge of separating module-specific configurations while maintaining proper site rendering and avoiding unintended multilingual site creation.

🎯 The Challenge

Initially, we attempted to separate HBStack module configurations into individual files to improve maintainability:

params.blog.yaml - Blog module configuration
params.docs.yaml - Documentation module configuration
params.pwa.yaml - PWA module configuration
params.seo.yaml - SEO module configuration

Problem: Hugo interpreted these as language-specific configurations, creating separate language sites instead of module configurations, resulting in:

Setup HBStack Guide

noreply@example.com (AG Sayyed) — Sat, 12 Apr 2025 09:06:46 +0000

A comprehensive guide to setting up HBStack with Docker. This guide covers framework understanding, command execution patterns, and development workflow setup.

Understanding HBStack Framework

HBStack is a modular Hugo theme framework built on top of Hugo’s module system, Bootstrap, and other modern web technologies.

Docker vs. Non-Docker Command Execution

When working with HBStack, commands can be managed differently depending on whether you’re using Docker or not.

Standard npm Scripts (Non-Docker)

In a traditional setup without Docker, HBStack commands are defined in package.json:

HBStack on Ghafoor's Personal Blog

Configuration Support & Module Organization