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.
- Open the board — you'll see a "Welcome" project with sample tasks
- Click the + button in the top tab bar to create a new project
- Add columns (To Do, In Progress, Done — or your own names)
- Click + on any column or press N to create a task
- 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 markdown — C on focused card
- Copy git branch name — B on focused card
- Archive — soft-delete via command palette or editor
- Delete — D 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
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
Actions
System
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.
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.
| Feature | Free ($0) | Base ($6/mo, $50/yr) | Pro ($10/mo, $84/yr) | Lifetime ($39 once) |
|---|---|---|---|---|
| Projects | 3 | 10 | Unlimited | Unlimited |
| Boards per project | 2 | 5 | Unlimited | Unlimited |
| Columns per board | 5 | 10 | Unlimited | Unlimited |
| Active tasks | 75 | 500 | Unlimited | Unlimited |
| Tags per task | 5 | 10 | Unlimited | Unlimited |
| Dependencies per task | 3 | 10 | Unlimited | Unlimited |
| 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.