Hugo Assembly is a Hugo port of the Assembly theme by Templated.co, delivering a two-column, fixed-width layout with a dark color scheme for static websites built on Hugo.
What is Hugo Assembly?
Hugo Assembly is a theme for the Hugo static site generator, converted from the Assembly design by Templated.co by @salsysd. It takes your site's Markdown content and renders it into a two-column, fixed-width page with a dark color palette. The theme follows the standard Hugo theme structure, so you place it in your themes directory and reference it by name in your configuration.
Key Features
- Two-column layout — A fixed-width design with a dark color scheme, true to the original Templated.co Assembly template.
- Hugo-native — Built for Hugo, using the standard layouts, partials, and configuration model; no JavaScript build step required.
- Example site configuration — The repository includes an exampleSite folder with a config.toml that you can copy to your project root to get started quickly.
- Simple installation — Install by cloning the repository into your themes folder and setting the theme name in the config or via the hugo server command.
- CC BY 3.0 licensing — The theme is based on Templated.co's work and is shared under a Creative Commons Attribution 3.0 license, so attribution is required.
- Changelog maintained — The project includes a changelog that records fixes, including one for the Hugo theme build script.
Who is it for?
Hugo users who want a simple, dark, two-column site for personal blogs or portfolios. Static-site developers looking for a clean starting point with a classic layout. Designers who appreciate the original Templated.co aesthetic and want to use it within Hugo's workflow.
What can you do with Hugo Assembly?
- Personal bloggers: Set up a two-column blog with a dark theme by copying the example config and adding Markdown posts.
- Portfolio creators: Showcase projects or work in a fixed-width layout that works well for galleries or project lists.
- Hugo learners: Study a small theme implementation to understand how Hugo templates, partials, and configuration fit together.
How does Hugo Assembly work?
After cloning the repository into your Hugo site's themes directory, copy the config.toml from exampleSite to your site root, add theme = "hugo-assembly" to the file, and run hugo server. The theme then renders your content in the two-column fixed-width layout, with the dark color scheme applied globally.
