Skip to content
hakula139Public

About

A clean, feature-rich theme for kiln, inspired by Hugo LoveIt

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

IgnIt

CI License: MIT WakaTime coding time for IgnIt

A theme for kiln built with Tailwind CSS and MiniJinja, inspired by Hugo LoveIt.

Highlights

Design & Navigation

  • Glassmorphism panels over a configurable background, with light and dark modes
  • Responsive layouts with image cards, archives, and a table of contents
  • Full-text search with Pagefind
  • Keyboard navigation, reduced-motion support, and print styles

Content

  • KaTeX math, Mermaid diagrams, and syntax highlighting
  • Image galleries with lightGallery
  • Twikoo comments and page views
  • Music and Bilibili embeds, link cards, and featured images

Customization & Performance

  • Site overrides for templates, design tokens, and translated strings
  • Self-hosted fonts and content-dependent script loading
  • Blurred image placeholders and fingerprinted CSS / JS assets

Documentation

Document Description
Customization Override visual tokens, templates, social icons, comments, fonts, and site icons
Parameters [params] schema reference: defaults, types, where each value is rendered
i18n Translatable string reference: keys, English defaults, override pattern

Installation

Add IgnIt to your kiln site as a Git submodule:

git submodule add https://github.com/hakula139/IgnIt.git themes/IgnIt

Then set it in your config.toml:

theme = "IgnIt"

Run kiln build or kiln serve to build your site. See kiln's processor setup for Tailwind installation requirements.

Quick Start

A minimal config.toml to get IgnIt running:

theme = "IgnIt"
title = "My Site"
language = "en"

[params.home.profile]
title = "Site Title"
subtitle = "An optional tagline"

[[menu.main]]
name = "Posts"
url = "/posts/"
icon = "fas fa-archive"
weight = 1

[[menu.social]]
name = "GitHub"
url = "https://github.com/example"
icon = "svg:github"
weight = 1
external = true

For the complete schema ([params.background], [params.comments], [params.lightgallery], [params.footer], [params.section]) and the full menu field list, see Parameters. For visual customization, social icon overrides, comment provider wiring, and other extension patterns, see Customization.

Theme Development

See kiln's assets guide for source layout and publication rules.

The example/ site references this checkout and provides a local preview:

nix develop      # Enter the development shell with kiln and formatting tools
pnpm install     # Install formatting, linting, and spell-check dependencies
pnpm dev         # Serve the example site and rebuild on changes
pnpm build       # Build the example site to example/public/

Use kiln build --root example --minify to check production compression.

See CSS customization for site overrides and page stylesheets.

For theme contributor constraints, including CSS layering and dependency updates, see AGENTS.md.

License

Copyright (c) 2026 Hakula. Licensed under the MIT License.

About

A clean, feature-rich theme for kiln, inspired by Hugo LoveIt

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages