Onepress is a simple, clean, and responsive Hugo theme for bloggers, with optional sidebar widgets, tag support, Disqus comments, and built-in SEO integration.
What is Onepress?
Onepress is a theme for the Hugo static site generator. It turns Markdown blog posts into a static website with a clean, responsive layout. The theme is authored by Jeremiah Succeed and released under the Apache 2.0 license. Configuration is managed through a config.toml file, where you set your site title, analytics code, Disqus shortname, social links, and feature toggles.
Key Features
- Responsive design — the layout adapts to desktop, tablet, and mobile screens without extra configuration.
- Tags taxonomy — built-in tag support via Hugo's
[taxonomies]section, so posts can be grouped by topic. - Optional sidebar widgets — set
widgetsto true to enable the sidebar, then editlayouts/partials/widgets.htmlto add custom widget sections like ads, affiliate banners, or calls to action. - Disqus comments — enable by filling in
disqusShortnamein the config; leaving it empty disables comments entirely. - Syntax highlighting — uses Highlight.js, controlled by the
highlightJSparameter. - SEO-friendly output — includes OpenGraph and Twitter Cards integration, plus optional Google Analytics tracking.
- Social sharing — adds Twitter and Facebook share buttons to posts; an optional author card can be displayed beneath each post.
- Custom CSS — toggle
customCSSto true and add inline styles inlayouts/partials/css.html, avoiding an extra HTTP request. - Font Awesome icons — the theme bundles Font Awesome for icons in the sidebar and social links.
Who is it for?
- Bloggers who want a straightforward, lightweight theme without JavaScript-heavy page builders.
- Hugo developers who want a starting point they can extend with custom widgets, partials, and CSS.
- Content publishers who need SEO basics, RSS, and social sharing built into a static site.
Use Cases
- Personal bloggers: write posts in Markdown and publish a static blog with tags, comments via Disqus, and social share buttons.
- Developer portfolios: use the optional author box, custom CSS, and Font Awesome icons to build a minimal personal site.
- Content sites: enable RSS and Google Analytics to reach subscribers and track audience, while keeping page loads fast with a static site.
How Does Onepress Work?
Install the theme by cloning https://github.com/ijsucceed/onepress.git into your Hugo site's themes folder, or add it as a git submodule for easy updates. Then set theme = "onepress" in config.toml and create posts with hugo new post/post-title.md. You can toggle widgets, comments, analytics, and syntax highlighting through the config parameters before building the site with hugo.
Pricing
Onepress is free and open source, released under the Apache 2.0 license. There are no paid tiers or premium features mentioned by the author.
FAQ
Is Onepress free?
Yes, Onepress is free to use and modify. It is released under the Apache 2.0 license, which permits commercial and personal use.
How do I install Onepress?
You can clone the repository into your Hugo themes directory or add it as a git submodule with git submodule add https://github.com/ijsucceed/onepress.git themes/onepress, then run git submodule update --init --recursive --remote.
Does Onepress support code syntax highlighting?
Yes. Syntax highlighting is handled by Highlight.js and can be enabled or disabled using the highlightJS parameter in config.toml.
Can I add my own sidebar content?
Yes. Set widgets = true, then edit layouts/partials/widgets.html to add or reorder widget sections. Widgets can contain any HTML, such as ads, affiliate links, or calls to action.
