{"id":15204254,"url":"https://github.com/mnjm/kayal","last_synced_at":"2026-05-10T13:29:33.873Z","repository":{"id":249234108,"uuid":"830790440","full_name":"mnjm/kayal","owner":"mnjm","description":"Minimal and lightweight Hugo theme with markdown-ish aesthetics","archived":false,"fork":false,"pushed_at":"2024-10-03T04:56:14.000Z","size":5505,"stargazers_count":15,"open_issues_count":1,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-10-12T22:22:35.165Z","etag":null,"topics":["dark-mode","hugo","hugo-theme","lightweight","responsive"],"latest_commit_sha":null,"homepage":"https://mnjm.github.io/kayal/","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mnjm.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-07-19T02:25:36.000Z","updated_at":"2024-10-12T22:20:13.000Z","dependencies_parsed_at":"2024-08-16T06:47:03.034Z","dependency_job_id":"23b0756f-250a-4b60-964b-65e6d0b8ae90","html_url":"https://github.com/mnjm/kayal","commit_stats":{"total_commits":139,"total_committers":3,"mean_commits":"46.333333333333336","dds":"0.014388489208633115","last_synced_commit":"7a1367d3e7ee27eb88cf419d6724c39f3c9a4e8f"},"previous_names":["mnjm/kayal"],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mnjm%2Fkayal","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mnjm%2Fkayal/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mnjm%2Fkayal/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mnjm%2Fkayal/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mnjm","download_url":"https://codeload.github.com/mnjm/kayal/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238777775,"owners_count":19528813,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dark-mode","hugo","hugo-theme","lightweight","responsive"],"created_at":"2024-09-28T05:40:48.964Z","updated_at":"2025-10-29T05:31:35.553Z","avatar_url":"https://github.com/mnjm.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Kayal\n\nKayal is a Hugo theme designed to be minimal and lightweight, with markdown-ish aesthetics for personal blog sites.\n\n\u003cp styles=\"font-size: 2em; font-weight:bold;\" align=\"center\"\u003e🌐\u003ca href=\"https://mnjm.github.io/kayal/\"\u003eDemo site\u003c/a\u003e\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://github.com/mnjm/kayal/actions/workflows/main.yaml/badge.svg\" alt=\"Demo Site GH Pages\"\u003e\n\u003cimg src=\"https://img.shields.io/github/license/mnjm/kayal\" alt=\"GitHub License\"\u003e\n\u003cimg src=\"https://img.shields.io/github/languages/code-size/mnjm/kayal\" alt=\"GitHub code size in bytes\"\u003e\n\u003ca href=\"https://themes.gohugo.io/themes/kayal/\"\u003e\u003cimg src=\"https://img.shields.io/badge/Hugo--Themes-@Kayal-blue\" alt=\"Kayal\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n| Desktop | Mobile |\n| ---- | ---- |\n|![Desktop](https://github.com/mnjm/kayal/blob/main/images/tn.png?raw=true)|![Mobile](https://github.com/mnjm/kayal/blob/main/images/mobile.png?raw=true)|\n\nSource for the Demo site is available in [exampleSite](https://github.com/mnjm/kayal/tree/exampleSite) branch.\n\n## Features\n- Clean and Responsive Design\n- Light and Dark Color Modes: Automatically adjusts based on browser preferences and/or manual toggle.\n- Profile Homepage\n- Customizable Configuration: Easily adjust settings to personalize\n- Shortcodes: Includes Callouts, Markdown and Code import from 3rd Party sites.\n- KaTeX Support\n- Mermaid Diagrams Support\n- Client-side search powered by [Fuse.js](https://www.fusejs.io/)\n- Cross-linking: Ability to link posts on third party sites.\n- RSS Feed\n- Table of Contents\n- Code Copy\n- Heading Anchors\n- Google Analytics\n- SVG Icons from FontAwesome 6\n- SEO Friendly.\n- Breadcrumbs\n- Article Cover image\n- Responsive Image optimization\n- Extensibility: Includes placeholders for\n    - Custom Homepage\n    - Other Analytics\n    - Comments\n    - Custom CSS\n    - Custom header\n- Site hosted assets / no CDNs\n- And many more...\n\n## Installation\nKayal supports several installation methods: as a git submodule, a Hugo Module, or through manual installation.\n\nDetailed instructions on how to install Kayal can be found in [Installation](https://mnjm.github.io/kayal/docs/getting-started/) on the demo site. Here's a quick guide on how to install the theme as a git submodule:\n\n1. In your Hugo site directory, run the following command:\n\n    ```bash\n    git submodule add -b main https://github.com/mnjm/kayal.git themes/kayal\n    ```\n\n2. 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](https://mnjm.github.io/kayal/docs/configuration/) on the demo site for more information.\n3. Remove `hugo.toml` if present, and build the site.\n\n## Configuration\n\nThe 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.\n\nRefer to [Configuration](https://mnjm.github.io/kayal/docs/configuration/) on the demo site for more details.\n\n## Contribution\nFound a bug or have a new feature idea? Create an issue to let me know, or even better, submit a pull request directly!\n\n## Addendum\nWhile building this theme, I constantly referred to the source codes of [Blowfish](https://github.com/nunocoracao/blowfish) and [Hugo-PaperMod](https://github.com/adityatelange/hugo-PaperMod). The idea for using markdown aesthetics came from [Archie](https://github.com/mnjm/archie), another Hugo theme.\n\n## License\nThis theme is released under the [MIT License](./LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmnjm%2Fkayal","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmnjm%2Fkayal","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmnjm%2Fkayal/lists"}