Toha is a Hugo theme for building personal portfolio and resume websites, combining a minimalist card-based design with full responsiveness and built-in multilingual support.
What is Toha?
Toha is an open-source Hugo theme focused on personal portfolios, accepting Markdown content and YAML/JSON data files as input and producing a static HTML site. It runs on Hugo, the static site generator, and is maintained under the hugo-themes GitHub organization. The theme requires Hugo extended version 0.163.0 or higher, Go 1.19 or later for Hugo modules, and Node v18 with npm 8 for its frontend asset pipeline.
Key Features
- Minimalist responsive design — A card-based layout with fully responsive pages for about, experience, and achievement sections.
- Multilingual support — Ships with 23 translations, including English, Bengali, French, Spanish, Simplified Chinese, Japanese, Korean, Russian, Arabic, Portuguese, and Dutch.
- Experience timeline — A dedicated section for presenting career history chronologically.
- Achievement gallery — A section to showcase awards, certifications, and notable accomplishments.
- Sidebar post categorization — Posts can be organized with a sidebar that lists categories for easy navigation.
- Analytics integrations — Built-in support for GoatCounter, counter.dev, Google Analytics, Matomo/Piwik, and Umami.
- Comment engine options — Works with Disqus, Valine, Utterances, and Giscus.
- Reusable shortcodes — Includes Alert, Image, Split, Vertical Space, Video, and Mermaid shortcodes for rich content.
Who is it for?
- Software developers and designers — Build a personal portfolio with an experience timeline and achievement gallery without touching site infrastructure.
- Technical bloggers — Publish Hugo Markdown posts with sidebar categorization, comment systems, and self-hosted or third-party analytics.
- Multilingual creators — Serve content in up to 23 languages using the built-in translation files and per-language content structure.
What can you do with Toha?
- Job seekers: Create a portfolio that presents work history as a timeline and highlights achievements with a gallery, ready to share via Netlify or GitHub Pages.
- Writers: Run a blog section with categorized sidebar posts, analytics, and comments powered by Giscus or Utterances.
- Open-source maintainers: Document projects in a static site with Mermaid diagrams and alerts, then deploy the same Hugo site to Netlify with one click.
How does Toha work?
The easiest setup is forking the reference repository hugo-toha/toha-example-site and editing its hugo.yaml configuration. Starting from scratch involves initializing a Hugo module with hugo mod init, adding github.com/hugo-toha/toha/v4 as a module import, running hugo mod tidy, then generating Node dependencies with hugo mod npm pack, installing them with npm install, and finally serving the site with hugo server -w.
FAQ
Is Toha free?
Yes, Toha is an open-source theme hosted on GitHub under the hugo-themes organization, and you can use it without paying any licensing fee. Pull requests and bug reports are welcome.
What are Toha's system requirements?
Toha needs Hugo extended version 0.163.0 or higher, Go 1.19 or later for Hugo module support, and Node v18 or newer with npm 8 or later for asset generation.
Which comment systems does Toha support?
Toha integrates with Disqus, Valine, Utterances, and Giscus. You enable one of these through the Hugo configuration file, and each uses its own server or GitHub-based storage for comments.
What analytics services work with Toha?
GoatCounter, counter.dev, Google Analytics, Matomo/Piwik, and Umami are all supported, so you can choose between privacy-friendly lightweight counters and full-featured analytics platforms.
Does Toha support multiple languages?
Yes, Toha includes translations for 23 languages, from English and Spanish to Japanese, Hindi, Arabic, and Hebrew. You can add more languages by following the translation guide in the documentation.
