v0.2.4

Kitfly v0.2.4

Release date: 2026-03-08

What's new

Kitfly v0.2.4 adds the planning-visuals plugin with Gantt charts for timeline visualization. Unlike Mermaid's gantt (which breaks in slide viewports), Kitfly's :::gantt widget uses max-depth filtering to let the same dataset drive both summary and detail views.

Gantt charts (planning-visuals plugin)

Render wave-based rollout plans, product roadmaps, or project timelines:

:::gantt
label: "Q2-Q4 Roadmap"
time-unit: month
time-start: "2026-04"
time-end: "2026-12"
max-depth: 1
today: "2026-06"
tracks:
  - label: "Phase 1 — Foundation"
    depth: 1
    start: "2026-04"
    end: "2026-06"
    status: complete
  - label: "Phase 2 — Core Features"
    depth: 1
    start: "2026-07"
    end: "2026-09"
    status: active
  - label: "Phase 3 — Scale"
    depth: 1
    start: "2026-10"
    end: "2026-12"
    status: planned
milestones:
  - label: "Beta Launch"
    date: "2026-06"
  - label: "Public Release"
    date: "2026-09"
markers:
  - label: "Investor Review"
    date: "2026-08"
    color: "#e11d48"
:::

Key features:

• Dual time units: week (ISO weeks, YYYY-Www) or month (YYYY-MM) — business audiences think in months, ops teams need week precision
• Hierarchical depth: max-depth: 1 shows waves only, max-depth: 2 adds clients/items — same YAML, different views
• Status colors: planned (muted), active (accent), complete (green), blocked (amber)
• Milestones: Diamond markers for point-in-time events
• Custom markers: Highlight key dates with color: for visual emphasis
• Overflow handling: max-tracks: 8 truncates with "+N more" — deterministic, no runtime measurement
• Today marker: Vertical dashed line when today: is set

Works in both docs and slides modes from day one.

Embedded CLI documentation

Access curated documentation directly from the compiled binary — no internet or repo clone required:

kitfly docs list              # List available topics with titles
kitfly docs show <slug>       # Output raw markdown to stdout
kitfly docs show ref/config | less  # Pipe to your favorite pager

Build-time codegen reads docs/embed-manifest.yaml (include/exclude globs), strips frontmatter, and bakes content into the binary. Missing slugs suggest similar matches.

Why Kitfly Gantt vs. Mermaid

Mermaid's gantt produces SVGs that break in fixed-aspect slide viewports when you have 5+ waves and 20+ items. Kitfly's solution: level-of-detail control.

# Same data, summary view
max-depth: 1  # Wave-level bars only — for exec slides

# Same data, detail view
max-depth: 2  # Waves + client-level items — for planning reviews

This solves the density problem without maintaining two files or switching tools.

Plugin usage

Add to kitfly.plugins.yaml:

plugins:
  - planning-visuals

The plugin loads in both docs and slides modes (no modes: restriction).

Breaking changes

None. New plugin — opt-in only.

Notes for upgraders

• To use gantt charts: add planning-visuals to your plugin list
• See content/reference/gantt-widget.md for complete authoring reference
• Validators check date formats, ranges, and track ordering at build time

Full changelog

See CHANGELOG.md for the complete list.