# kanban-board

Current release: **1.0.0** (2026-11-15)

`kanban-board` typesets Kanban project boards in LaTeX. A board consists of
named columns and task cards. Each card may carry a priority, an author, a
deadline, and a completion marker. Deadlines are classified as overdue, due
now, or upcoming, either against the compilation date or against a fixed
reference date for reproducible builds. Project-relative deadlines such as
`M2` are supported as well.

## Features

- Fixed horizontal boards with synchronized headings and column bodies, and
  page-breakable boards built on `paracol`.
- Light and dark card modes, optional background tints for individual
  cards, built-in and user-defined color palettes, and a configurable gap
  between columns.
- Calendar deadlines in US, English, German, ISO, and year-first notation
  with Gregorian validation, and project months relative to a start date.
- A three-level configuration hierarchy of package options, `\kanbansetup`,
  and board options.
- Configurable semantic labels and namespaced `tcolorbox` style hooks.

## Minimal example

```latex
\documentclass{article}
\usepackage[reference-date=2026-07-18]{kanban-board}
\begin{document}
\begin{kanban}
  \kanbantask[prio=high,author=Alice]{Backlog}{Design the API}
  \kanbantask[due=2026-07-31]{Doing}{Write the implementation}
  \kanbantask[completed]{Done}{Create the repository}
\end{kanban}
\end{document}
```

Without a `columns` option, a board uses the built-in columns `Backlog`,
`Doing`, and `Done`. Task targets are matched without regard to letter case,
and headings keep the spelling of the column list. The board option `break`
selects the page-breakable layout.

## Installation

TeX Live and MiKTeX install the package automatically once it is part of the
distribution. For a manual installation, run

```text
latex kanban-board.ins
```

and place `kanban-board.sty` in a directory searched by TeX, for example below
`TEXMFHOME/tex/latex/kanban-board`.

## Documentation

The user manual `kanban-board.pdf` describes the complete interface, the date
model, the configuration hierarchy, and the diagnostics. It is generated
from `kanban-board.dtx` with `l3build doc`. Eight standalone examples accompany
the manual. The source archive also contains the regression suite, which
runs with `l3build check`.

## Requirements

The package requires LaTeX 2020-10-01 or later and the packages `xcolor`,
`etoolbox`, `tikz`, `tcolorbox`, and `paracol`. On formats older than
2021-06-01 it additionally loads `kvoptions`. The regression suite runs with
pdfTeX, LuaTeX, and XeTeX.

## Reporting problems

Please include a minimal complete document, the relevant log output, and the
versions of LaTeX and `kanban-board`. Development takes place in the
[public repository](https://github.com/AndreasWillibaldWeber/kanban-board).
Defects and enhancement proposals belong in its
[issue tracker](https://github.com/AndreasWillibaldWeber/kanban-board/issues).
The maintainer is reached through the issue tracker.

## License

This material is subject to the LaTeX Project Public License, version 1.3c
or, at your option, any later version. It has LPPL maintenance status
`maintained`. The Current Maintainer is Andreas Willibald Weber.