Swiss Operator is a minimalist Hugo theme that applies Swiss editorial design principles to static-site blogs and technical documentation, prioritizing legibility, typographic rhythm, and grid consistency over visual decoration. It runs on Hugo 0.110.0 or later, consumes markdown content with YAML front matter, and outputs static HTML plus optional RSS feeds.
What is Swiss Operator?
Swiss Operator is an open-source Hugo theme created by carlosplanchon, released under the MIT license, and designed specifically for technical writing, engineering notes, and high-clarity personal blogs. The theme takes your markdown posts and renders them into a clean two-column layout with a bold typographic system built on Inter for body text and JetBrains Mono for dates, code, and metadata. It includes automatic dark and light mode with a localStorage-persisted toggle, category color coding, and multi-language support for English, Spanish, and French.
Key Features
- Swiss editorial aesthetic — no gradients, no hero sections; just a tight grid, deliberate whitespace, and bold typography that makes content the focal point.
- Dark and light mode — auto-detects the system preference via CSS and retains a manual toggle in localStorage so users can override it.
- Responsive layout — the 70/30 two-column grid collapses to a single column on mobile devices, keeping the reading experience consistent.
- Category color coding — map category names to hex colors in hugo.toml; the first category of each post determines the card's left-border accent color.
- Customizable accents — the default Blueprint Blue and Safety Red palette can be overridden from the theme parameters.
- Multi-language support — ships with i18n files for English, Spanish, and French; adding another language just requires a new file with the same keys.
- Font flexibility — load Inter and JetBrains Mono from Google Fonts, or set localFonts to true to serve the bundled files from assets/fonts.
- Integrations — optional Google Analytics GA4 via Hugo's built-in service, optional Remark42 comments that sync with light/dark mode, and RSS feeds enabled for home and section outputs.
- Favicon flexibility — accepts SVG, PNG, ICO, and JPEG favicon files.
Who is it for?
Swiss Operator is built for writers who need precision and clarity: technical writers documenting engineering concepts, developers publishing personal blogs, and teams maintaining internal knowledge bases. The theme's grid alignment and legibility make it particularly suitable for content-heavy sites where the text must carry its own weight. The category color system also appeals to design-conscious bloggers who want a visual hierarchy without adding images or widgets.
What can you do with Swiss Operator?
- Engineers and technical writers: publish markdown-based engineering notes and documentation, using category colors to distinguish topics such as Engineering, Aviation, or Design.
- Personal bloggers: set up a high-clarity blog with dark mode, custom accent colors, and optional cover images that display at a 4:3 ratio on post cards.
- Multilingual sites: run the same content in English, Spanish, or French by toggling the i18n files, or extend to new languages by copying the existing key structure.
How does Swiss Operator work?
Install the theme either as a Git submodule or by downloading it into themes/swiss-operator, then set theme = 'swiss-operator' in hugo.toml. For a quick start, copy the exampleSite directory into your site root and run hugo server. Each markdown post can declare a title, date, description, categories, and an optional cover image in front matter, and the theme renders them into static HTML pages with the chosen category accent.
Pricing
Swiss Operator is free and open source under the MIT license, so it can be used for personal and commercial projects without licensing fees.
FAQ
What Hugo version does Swiss Operator require?
Swiss Operator requires Hugo 0.110.0 or later. Go 1.21 or higher is only needed for installing via Hugo Modules; the Git submodule and manual installation methods do not require Go.
Does Swiss Operator support dark mode?
Yes. The theme auto-detects the system preference and includes a manual toggle that persists the user's choice in localStorage, so returning visitors keep their preference.
Can I use Swiss Operator in multiple languages?
The theme ships with English, Spanish, and French i18n strings. To add another language, create a new file in your site's i18n directory that follows the same keys as the bundled files.
Is Swiss Operator free?
Yes, Swiss Operator is distributed under the MIT license, meaning it is free to use, modify, and incorporate into projects, including commercial ones.
