Iara is an open-source Hugo theme that turns a static site into a Medium-style publication, with article-focused typography and a responsive reading layout. It takes standard Hugo content (Markdown files, taxonomies, front matter) and renders it into a blog with pagination, author pages, and social sharing metadata. The theme is distributed on GitHub under the alexandrevicenzi/iara repository, licensed under Apache 2.0, and is built specifically for Hugo version compatibility.
What is Iara?
Iara is a feature-rich Hugo theme designed to mirror the Medium reading experience for static blogs and personal websites. It accepts Hugo content written in Markdown and outputs a full blog site with responsive design, SEO tags, and multiple content layouts. The theme is installed by cloning the repository into your Hugo project's themes folder and setting theme = "iara" in config.toml.
Key Features
- Mobile First & Responsive — The layout is built mobile-first, so it adapts cleanly from smartphones to desktop screens without a separate mobile theme.
- SEO metadata — Includes Open Graph, Schema.org (Microdata), and Twitter Card tags out of the box for better search and social sharing snippets.
- Author taxonomy — Supports multiple authors with dedicated archive pages, making it easy to organize posts by writer.
- Internationalization (i18n) — Provides multi-language support, letting you publish the same content in several languages.
- TeX math support — Renders LaTeX formulas using either KaTeX or MathJax, selectable through Hugo configuration.
- Performance touches — Lazy loading for images and built-in syntax highlighting for code blocks keeps pages light and readable.
- Third-party integrations — Simple config options for Disqus comments, Google Analytics, Google AdSense, Google Custom Search, and AddThis social sharing.
- Useful shortcodes — Includes Hugo's built-in shortcodes plus custom shortcodes for contact forms (compatible with FormSpark), alerts, and buttons.
Who should use Iara?
- Personal bloggers who want a Medium-like reading experience without being locked into the Medium platform, and who already build sites with Hugo.
- Writers publishing long-form articles needing clean typography, estimated reading time, and a distraction-free layout.
- Multi-author publications that need author pages and per-author archives to organize content from different writers.
- Hugo developers looking for a customizable, no-JavaScript-heavy theme they can modify and extend with shortcodes and partials.
What can you do with Iara?
- Create a blog: Write Markdown posts and get a paginated blog with SEO tags, social sharing, and optional Disqus comments.
- Set up a multi-language site: Use i18n to offer the same content in multiple languages, which is useful for international audiences.
- Publish math-heavy articles: Enable KaTeX or MathJax to display LaTeX formulas in posts, perfect for academic or technical writing.
- Monetize with AdSense: Add your Google AdSense ID through configuration to serve ads in the theme's layout.
How does Iara work?
Install Iara by cloning the repository into themes/iara using plain git clone or as a submodule, then specify it as the active theme in config.toml. After that, Hugo loads the theme's templates and processes your Markdown content. You configure features like comments, analytics, math rendering, and custom navigation through Hugo's site configuration file.
Pricing
The theme is free and open source under the Apache License 2.0, which permits commercial use, modification, and redistribution without restriction.
FAQ
Is Iara free?
Yes, Iara is released under the Apache License 2.0, so it is completely free to use, modify, and distribute, including in commercial projects.
How do I install Iara?
Run git clone https://github.com/alexandrevicenzi/iara.git themes/iara in your Hugo project, or add it as a git submodule. Then set theme = "iara" in your config.toml.
Does Iara support comments?
Yes, Iara integrates with Disqus. You can enable comments by adding your Disqus shortname to the theme configuration.
Does Iara support math equations?
Yes, Iara supports TeX math rendering with your choice of KaTeX or MathJax, which you can select in the configuration.
Can I use Iara for a multi-author blog?
Yes, Iara includes an author taxonomy, allowing you to assign posts to different authors and generate author archive pages automatically.
