Skip to content
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


Kakyll is a static site generator similar to Hakyll (Haskell) or Jekyll (Ruby) except in Kotlin.

The primary webiste for Kakyll is Kakyll's homesite is also built with Kakyll.


brew install

Getting Started

First we tell Kakyll to create a new site.

kakyll new my_site

Next, navigate into the newly created site.

cd my_site

This will have pre-generate a sample blog and a pre-configured default blog structure. The blog structure and configuration are explained below.

kakyll build
kakyll serve (also performs build)
kakyll deploy

Blog Structure

├── templates
|   └── default.hbs
|   ├── footer.hbs
|   └── header.hbs
|   └── post.hbs
├── posts
|   ├──
|   └──
|   ├── css
|   |   └── style.css
|   ├── js
|   |   └── scripts.js
|   ├── images
|   |   └── my_logo.png
├── index.hbs
├── about.hbs
├── tags.hbs
└── config.yml

Upon building your site, all contents will be copied to _site

Create A New Post

Via the new post command you can programmatically create a new post. The new post will be generated where ever the post directory is configured. (default: posts/)


kakyll new post "name of post.markdown"
kakyll new post name of
kakyll new post

The files are generated in the configured posts directory, file names are normalized, and the current date is automatically prepended.


  • Spaces are coerced to dashes (-).
  • Quotes are optional.
  • .md/.markdown extension is required.
  • The current date is automatically prepended to the post file name.


TODO explanation/table

Sample default config.yml file

title: My Blog Title
description: My Blog is about random stuff like lorem ipsum and programming. I hope you enjoy.
base_url: http://localhost:8080 # The base url to your blog. e.g.
template_engine: handlebars
deploy: rsync -avz ....         # command to execut to deploy contents in _site/*
encoding: UTF-8                 # encoding of files, defaults to UTF-8
date_format: yyyy-dd-MM         # format for date to use in post pages
posts:                          # configuration for your blog's posts
    directory: posts            # directory where your posts are located
    template: post.hbs          # optional template for posts
    - index.html
    - about.html
    - tags.html
    template: index.html
    - name: assets

Template Engine

Currently the only supported template engine is Handlebars

Markdown Engine

Kakyll used FlexMark as it's primary markdown renderer. Other options are still being considered. This will also become configurable.

Styling Your Blog

By default the blog is themed using Bootstrap based of some examples from this blog post. The author, Vijaya Anand, put together an immense and detailed post explaining how to use Bootstrap to create a nice and clean blog template.

The current default template for a post.


Static Site Generator in Kotlin



No releases published


No packages published
You can’t perform that action at this time.