Skip to docs content

Documentation

Everything you need to know about using Kbn. From basic setup to advanced features.

Getting Started

Kbn is a personal kanban board that runs entirely in your browser. No account, no server, no setup. Your data is stored in localStorage and never leaves your device.

  1. Open the board — you'll see a "Welcome" project with sample tasks
  2. Click the + button in the top tab bar to create a new project
  3. Add columns (To Do, In Progress, Done — or your own names)
  4. Click + on any column or press N to create a task
  5. Drag tasks between columns, edit them, add tags and priorities

That's it. No configuration required. Everything else is optional power features documented below.

Projects & Boards

Kbn organizes work into projects, each containing one or more boards. Think of a project as a repo and boards as different views (e.g. "Frontend", "Backend", "DevOps").

Projects

Create a project with the + button in the top tab bar or via the command palette. Projects appear as tabs — click to switch, drag to reorder. Right-click (or click the ••• menu) to rename or delete.

Press number keys 1 through 9 to switch between projects by position.

Boards

Each project starts with a "Main" board. Add more boards from the project's dropdown menu or the command palette. When a project has multiple boards, a secondary tab bar appears below the project tabs.

Boards are independent — each has its own set of columns and tasks.

Columns

Columns represent workflow stages. Each board can have multiple columns with custom names and colors.

Creating Columns

Click Add Column in the command palette or use the column menu. Choose a name and pick a color from the 8 available accent colors.

WIP Limits

Set a Work-In-Progress limit on any column via its dropdown menu. When the task count exceeds the limit, the column header turns red with a pulsing warning icon. This is a visual reminder — it doesn't block adding tasks.

New columns inherit your default WIP limit from Settings → Defaults.

Column Actions

  • Rename — click the column menu → Rename
  • Change color — column menu → Change color
  • Move position — column menu → Move position, or drag the column
  • Focus mode — column menu → Focus column (dims all other columns)
  • Present mode — column menu → Present column (full-screen view)
  • Delete — column menu → Delete (removes all tasks in the column)

Tasks

Tasks are the core unit of work in Kbn. Each task has content (written in any of 18 languages), optional tags, priorities, due dates, and dependencies.

Creating Tasks

  • Click the + button on any column header
  • Press N to create a task in the first column
  • Press A to open Quick Add (natural language syntax)
  • Use the command palette → New task

New tasks inherit the default language and default priority from your settings.

Editing Tasks

Click any card to open the task editor, or focus a card with vim keys and press E. The editor is a slide-over panel with:

  • Monaco code editor (VS Code) with syntax highlighting
  • Language selector (18 languages)
  • Tag picker
  • Blocker/dependency picker
  • Due date picker
  • Priority selector
  • Time tracking controls
  • Markdown preview toggle

Task Actions

  • Move — drag cards between columns
  • Copy as markdownC on focused card
  • Copy git branch nameB on focused card
  • Archive — soft-delete via command palette or editor
  • DeleteD on focused card (with confirmation)

Card Previews

Task cards on the board show a rich preview: markdown headings, checkboxes, bold text, inline code, and clickable URLs. Code blocks show the language badge. Tags, priority, due date, and blocker indicators are visible at a glance.

Code Editor

Every task includes a full Monaco editor — the same editor that powers VS Code. It loads lazily (a plain textarea shows instantly while it loads).

Supported Languages

plaintextmarkdownjavascripttypescriptpythonrustgojavacc++c#htmlcssjsonyamlsqlshelldockerfile

Markdown Preview

When a task uses the markdown language, a preview toggle appears in the editor. Switch between editing raw markdown and seeing the rendered output.

Keyboard Shortcuts

Kbn is designed for keyboard-first usage. Press ? anywhere to see the full shortcuts dialog.

Navigation

Move downJ
Move upK
Move left (previous column)H
Move right (next column)L
Switch project by position1-9
Dismiss / clear focusEsc

Actions

New taskN
Quick addA
Edit focused taskE
Delete focused taskD
Copy task as markdownC
Copy git branch nameB
Focus columnF
Recent activityR
Focus search/
Show shortcuts help?

System

Command paletteK
UndoZ
RedoZ

Custom Keybindings

On Base and Pro tiers, you can rebind any shortcut. Open the shortcuts dialog (?), click any key, and press your new binding. Press Escape to cancel. Click "Reset all" to restore defaults.

On the Free tier, keybindings are view-only — you can see them but not change them.

Command Palette

Press K to open the command palette — even while typing in an input. It provides instant access to every action in Kbn.

Available Commands

  • Create, rename, delete projects
  • Create boards, switch between boards
  • Add columns
  • Create, search, archive, delete tasks
  • Copy task as markdown
  • Undo / Redo
  • Change layout, background, swim lanes
  • Toggle swim lanes, tags, dark mode
  • Toggle archived tasks
  • Present any column full-screen
  • Export / import data
  • View recent activity
  • Navigate to homepage

Navigation

The palette supports sub-pages. When you select a category (e.g. "Switch project"), it drills into a sub-page. Press Backspace on an empty search to go back.

Quick Add

Press A to open the Quick Add bar. Type a task description using natural syntax:

Fix login bug #urgent @In Progress

#tag — adds a tag  |  @column — targets a column

If no @column is specified, the task goes to the first column. Tags are case-insensitive and matched against the available tag list.

Time Tracking

Kbn has a built-in timer for every task. Start it from the task editor and it appears as a floating widget in the bottom-left corner.

Stopwatch Mode

The default mode tracks elapsed time continuously. When you stop the timer, the tracked time is saved to the task. Accumulated time shows in the task editor.

Pomodoro Mode

Toggle Pomodoro mode for timed focus/break cycles. The default is 25 minutes focus, 5 minutes break. When a phase ends, the timer auto-advances and sends a browser notification (if permitted).

Completed focus sessions are counted per task as "pomodoro count."

Custom Durations

On Base and Pro tiers, customize focus and break durations in Settings → Timer. On the Free tier, durations are fixed at 25/5 minutes.

Tags & Priorities

Tags

Kbn provides 6 built-in tags: Urgent, In Progress, To Do Later, End of Day, Blocked, and Review. Add tags in the task editor.

Tag limits depend on your plan: Free allows 5 per task, Base allows 10, Pro is unlimited.

Priorities

Four priority levels: Urgent, High, Normal, and Low. Set in the task editor. The priority indicator shows as a colored dot on the card.

Set a default priority in Settings → Appearance → Board & Cards so new tasks inherit it automatically.

Dependencies

Tasks can be marked as "blocked by" other tasks. When a task has unresolved blockers, it shows a red blocker bar on the card indicating what it's waiting on.

Add blockers in the task editor using the dependency picker. You can search through tasks in the current board.

Dependency limits: Free allows 3 per task, Base allows 10, Pro is unlimited. When a blocking task is deleted, the dependency is automatically cleaned up.

Due Dates

Set a due date on any task from the editor. Cards show a due date badge that changes color based on urgency:

  • Red — overdue
  • Amber — due today or tomorrow
  • Gray — due later

Kbn sends browser notifications when tasks are due (if notification permission is granted).

Focus & Present Mode

Focus Mode

Navigate to a column with vim keys and press F to enter focus mode. All other columns are dimmed, letting you concentrate on one workflow stage. Press F again or Esc to exit.

Present Mode

Full-screen any column or task. Access it from the column dropdown menu, the command palette, or the task editor. Present mode is designed for standups, demos, and pair programming sessions.

When presenting a column, you can click into individual tasks and return to the column view with Esc.

Swim Lanes

Group tasks within columns by tag or priority. Enable swim lanes in Settings or via the command palette → Swim lanes.

  • None — flat list (default)
  • By Tag — groups tasks by their first tag
  • By Priority — groups tasks by priority level

Each lane has a header with the group label, color dot, and task count. Click the lane header to collapse/expand it.

Customization

Open Settings from the gear icon in the top-right corner. Settings are organized into three tabs: Appearance, Features, and Account.

Layout

  • Standard — 320px columns, scrollable
  • Wide — 400px columns, more room for content
  • Fill — columns stretch to fill the screen evenly

Feature Toggles

Found under the Features tab. Only Due Dates is enabled by default — enable Time Tracking, Dependencies, or Priorities when you need them. Data is always preserved — disabling a feature only hides its UI.

  • Time Tracking — stopwatch, pomodoro, and tracked-time badges. When enabled, timer sub-settings (focus/break duration) appear inline
  • Due Dates — due date picker and date badges on cards (on by default)
  • Dependencies — blocker relationships between tasks
  • Priorities — priority picker and accent bars on cards. Auto-resets swim lanes from "By Priority" to "None" when disabled

Appearance

Found under the Appearance tab.

  • Dark / Light mode — toggle in Settings or command palette
  • Background patterns — None, Dots, Grid, Cross, Glow
  • Show/hide tags — toggle tag badges on cards

Defaults

Set preferences in Settings → Appearance → Board & Cards that apply to all new items you create:

  • Default WIP Limit — applied to every new column (1-99)
  • Default Task Language — the language new tasks open in (e.g. TypeScript, Markdown)
  • Default Task Priority — priority assigned to new tasks (or "None")

These defaults save time when you consistently use the same setup.

Export & Import

Export

Command palette → Export data as JSON. Downloads a file containing all your projects, boards, columns, tasks, and settings.

Import

Command palette → Import data from JSON. Select a previously exported file to restore your data. Import replaces all current data but preserves your subscription tier.

Undo / Redo

Kbn maintains a 50-step undo/redo history. Z to undo, Z to redo. This covers all data changes (task edits, moves, deletions, column changes, etc.).

PWA & Offline

Kbn is a Progressive Web App. On supported browsers, you can install it as a standalone app on your desktop or phone.

  • Install — click the install prompt in your browser's address bar, or go to browser menu → "Install Kbn"
  • Offline — the service worker caches the app shell. Once loaded, Kbn works fully offline since all data is in localStorage
  • Notifications — Pomodoro phase changes and due date reminders use browser notifications (requires permission)

Plans & Pricing

Kbn is free to use with generous limits. Paid tiers unlock more capacity and customization — not core features. Every plan includes the full board, keyboard shortcuts, Monaco editor, and all task management capabilities.

FeatureFree ($0)Base ($6/mo, $50/yr)Pro ($10/mo, $84/yr)Lifetime ($39 once)
Projects310UnlimitedUnlimited
Boards per project25UnlimitedUnlimited
Columns per board510UnlimitedUnlimited
Active tasks75500UnlimitedUnlimited
Tags per task510UnlimitedUnlimited
Dependencies per task310UnlimitedUnlimited
Custom keybindings-
Custom pomodoro-
Cloud backup & sync--

Yearly billing is currently discounted by 30%. The Lifetime deal is a limited-time launch offer and is scheduled to be removed after September 1, 2026.

Change your Free/Base/Pro plan in Settings → Plan. Upgrading takes effect immediately. Downgrading preserves existing data — you just can't create new items beyond the lower tier's limits. Lifetime is a launch checkout offer.