kite Home Docs GitHub
kite

CLI reference

Everything kite does, in one place.

Commands

Command Description
kite init Interactively scaffold a new site (content, themes, config, sample post)
kite new hello.md Create a post with stamped frontmatter (--draft starts it as a draft)
kite build Build with the defaultTheme from config.yaml
kite build <theme> Build with a specific theme, e.g. kite build gruvbox
kite serve Build + serve output/ at http://localhost:8000 with live reload
kite serve --port 8080 Serve on a custom port
kite serve <theme> Preview a specific theme, e.g. kite serve rose-pine
kite list-themes List themes in ./themes
kite check Check output/ for broken internal links (CI: kite build && kite check)

Theme resolution order: explicit argument → defaultTheme in config.yaml → modern-light.

Configuration

All keys in config.yaml:

Key Purpose
siteTitle <title> of the home page, RSS feed title
authorName Hero name, footer, RSS author
authorRole Hero subtitle
authorBio Hero paragraph, RSS description
defaultTheme Theme used when none is passed on the CLI
siteUrl Base URL used for absolute links in feed.xml

Output

output/
  index.html        # home page
  feed.xml          # RSS, regenerated every build
  <slug>/index.html

Point any static file server at output/ and you’re live.