Kayal is a Hugo theme designed to be minimal and lightweight, with markdown-ish aesthetics for personal blog sites.

🌐Demo site

Desktop	Mobile

Source for the Demo site is available in exampleSite branch.

• Clean and Responsive Design
• Light and Dark Color Modes: Automatically adjusts based on browser preferences and/or manual toggle.
• Profile Homepage
• Customizable Configuration: Easily adjust settings to personalize
• Shortcodes: Includes Callouts, Markdown and Code import from 3rd Party sites.
• KaTeX Support
• Mermaid Diagrams Support
• Client-side search powered by Fuse.js
• Cross-linking: Ability to link posts on third party sites.
• RSS Feed
• Table of Contents
• Code Copy
• Heading Anchors
• Google Analytics
• SVG Icons from FontAwesome 6
• SEO Friendly.
• Breadcrumbs
• Article Cover image
• Responsive Image optimization
• Extensibility: Includes placeholders for
  • Custom Homepage
  • Other Analytics
  • Comments
  • Custom CSS
  • Custom header
• Site hosted assets / no CDNs
• And many more...

Kayal supports several installation methods: as a git submodule, a Hugo Module, or through manual installation.

Detailed instructions on how to install Kayal can be found in Installation on the demo site. Here's a quick guide on how to install the theme as a git submodule:

1. In your Hugo site directory, run the following command:

   git submodule add -b main https://github.com/mnjm/kayal.git themes/kayal

2. Copy config files from themes/kayal/config/_default to config/_default at the root of your Hugo project. Make necessary configuration changes in these files. Refer to Configuration on the demo site for more information.

3. Remove hugo.toml if present, and build the site.

The config files included with Kayal contain all possible settings recognized by the theme. By default, many of these settings are commented out, but you can simply uncomment them to activate or modify.

Refer to Configuration on the demo site for more details.

Found a bug or have a new feature idea? Create an issue to let me know, or even better, submit a pull request directly!

While building this theme, I constantly referred to the source codes of Blowfish and Hugo-PaperMod. The idea for using markdown aesthetics came from Archie, another Hugo theme.

This theme is released under the MIT License.