Congo is designed to be a simple, lightweight theme for Hugo. It's built using Tailwind CSS with a clean and minimalist design that prioritises to your content.
- Built with Tailwind CSS JIT for minified stylesheets without any excess code
- Fully responsive layout
- Multiple colour schemes (or fully customise your own)
- Dark mode (forced on/off or auto-switching with user toggle)
- Highly customisable configuration
- Multiple homepage layouts
- Flexible with any content types, taxonomies and menus
- Ability to link to posts on third-party websites
- Diagrams and visualisations using Mermaid
- Charts using Chart.js
- Mathematical notation using KaTeX
- SVG icons from FontAwesome 5
- Heading anchors, Buttons, Badges and more
- HTML and Emoji support in articles
- SEO friendly with links for sharing to social media
- RSS feeds
- Fathom Analytics and Google Analytics support
- Favicons support
- Comments support
- Advanced customisation using simple Tailwind colour definitions and styles
- Fully documented
- Regular updates with fixes and new features
Congo supports several installation methods - as a Hugo Module (easiest), a git submodule, or as a completely manual install.
Detailed instructions for each method can be found in the Installation docs. You should consult the documentation for the simplest setup experience. Below is a quick start guide using Hugo modules if you're already confident installing Hugo themes.
Quick start using Hugo
Note: Ensure you have Go and Hugo installed, and that you have created a new Hugo project before proceeding.
From your project directory, initialise Hugo Modules:
hugo mod init github.com/<username>/<repo-name>
config/_default/module.tomland add the following:
[[imports]] path = "github.com/jpanther/congo"
Start your server using
hugo serverand the theme will be downloaded automatically.
In the root folder of your website, delete the
config.tomlfile that was generated by Hugo. Copy the
*.tomlconfig files from the theme into your
Note: Do not overwrite the
module.tomlfile you created above!
You will find these theme config files in the Hugo cache directory, or download a copy from GitHub.
Follow the Getting Started instructions to configure your website.
Installing theme updates
As new releases are posted, you can update the theme using Hugo. Simply run
hugo mod get -u from your project directory and the theme will automatically update to the latest release.
Detailed update instructions are available in the docs.
Congo is expected to evolve over time. I intend to keep adding features and making changes as required.
Feel free to get in touch with any issues or suggestions for new features you'd like to see.
🐛Bug reports & issues: Use GitHub Issues 💡Ideas for new features: Open a discussion on GitHub Discussions 🙋♀️General questions: Head to GitHub Discussions
If you're able to fix a bug or implement a new feature, I welcome PRs for this purpose. Learn more in the contributing guidelines.