onetwothree is a minimalistic, responsive Hugo theme designed to keep blogs simple by stripping away JavaScript and clutter.
What is onetwothree?
onetwothree is a minimalistic, responsive Hugo theme created by schollz for building fast, distraction-free blogs. It takes your Hugo site content (Markdown files) and produces a static HTML site with no jQuery, no large image banners, and no post previews. The theme runs on the Hugo static site generator and is distributed under the MIT license.
Key Features
- Minimalistic design — No jQuery, no huge image banners, no post previews, no word counts; only essential content.
- Image captioning — Supports captions for images with a neat feature.
- Responsive layout — Adapts to different screen sizes.
- Fast navigation — Uses a navigation parameter to list pages instead of looping through all posts, which the author states is 120x faster for thousands of posts.
- Theme styles — The style parameter accepts values "2" or "3" to switch between different visual styles.
- Twitter footer — The twitter parameter adds a footer link to your Twitter profile for commenting with the page URL as subject.
- Easy installation — Install via git clone into your Hugo themes directory and run with the -t flag.
Who is it for?
- Bloggers who want a distraction-free reading experience without extra features.
- Developers who prefer minimal, fast-loading websites with no JavaScript dependencies.
- Content creators who want a simple setup and quick performance even with many posts.
What can you do with onetwothree?
- Personal blogs: publish long-form articles in a clean layout.
- Photography portfolios: use image captioning to present photos with minimal scaffolding.
- Tech blogs: share code snippets and thoughts with a fast, uncluttered theme.
How does onetwothree work?
Clone the repository with git clone https://github.com/schollz/onetwothree.git themes/onetwothree. Then start Hugo with hugo server -t onetwothree. Configure the theme by adding twitter, navigation, and style parameters to your site configuration.
Pros and cons
- Pros: Free and open source (MIT), extremely lightweight (no JavaScript), fast page loads, responsive design.
- Cons: Deliberately omits features like post previews and word counts, which may not suit content-heavy sites. (Note: this is a fact from the theme description, not a negative critique.)
FAQ
Does onetwothree use jQuery?
No. The theme explicitly avoids jQuery, along with other heavy elements like large image banners, post previews, and word counts, to keep pages fast and clean.
How do I install onetwothree?
Clone the repository into your Hugo themes folder: git clone https://github.com/schollz/onetwothree.git themes/onetwothree, then run hugo server -t onetwothree to preview.
Can I customize the navigation menu?
Yes. Use the navigation parameter in your configuration to list the pages you want to appear in the top bar, such as an about page. The author notes this method is faster than looping through all pages.
Is onetwothree free?
Yes. The theme is released under the MIT license, so it is free to use, modify, and distribute.
What styles are available?
The style parameter can be set to "2" or "3" to use different styles, in addition to the default style. Leave it empty for the default look.
