Kanban SauceA flexible, local-first Kanban board for your editor. Manage projects, tasks, notes, and ideas using Markdown files you own and control.
Kanban Sauce brings Trello- and Notion-style visual project and note management straight into your editor. Every card is stored on disk as a plain Markdown file with YAML frontmatter, making your boards 100% offline, version-controllable, Git-diffable, and portable. No account setup, no cloud lock-in, no telemetry — just fast, local productivity that lives right next to your code. Why Kanban Sauce?Most editor Kanban extensions lock you into a single monolithic file or an opaque database. Kanban Sauce is built around your filesystem. Whether you are managing software projects, planning content, organizing research notes, tracking personal tasks, or coordinating a team, Kanban Sauce adapts to your workflow:
Get Started in Seconds1. Install
2. Open a Board
3. Create & Manage Cards
Key FeaturesSplit-View Rich Editor & Two-Way SyncEdit cards inline with the built-in rich-text or raw-source Markdown editor (powered by MDXEditor) on the right while keeping your board visible on the left — or enable
Multi-Board Workspace & Sidebar Navigation
Rich Card Metadata & Epic Swimlanes
Fast Search, Filtering & Layouts
Plain-Text File FormatEvery card is a human-readable
Per-Board Columns (
|
| Setting | Default | Description |
|---|---|---|
filenamePattern |
name-date |
Filename pattern for new cards (name-date, date-name, name-datetime, datetime-name) |
defaultPriority |
medium |
Default priority for new cards (critical, high, medium, low) |
defaultStatus |
backlog |
Default column status for new cards (backlog, todo, in-progress, review, done) |
columns |
5 default columns | Default column IDs, names, and colors when no .kanbansauce file is present |
showPriorityBadges |
true |
Show priority on cards and in editors |
showAssignee |
true |
Show assignee on cards and in editors |
showDueDate |
true |
Show due date on cards and in editors |
showLabels |
true |
Show labels on cards and in editors |
showEpic |
true |
Show epic badge on cards and in editors |
showFileName |
false |
Show the source Markdown filename on cards |
compactMode |
false |
Use compact card layout for denser boards |
addNewCardsToTop |
false |
Add newly created cards to the top of the column |
markdownEditorMode |
false |
Open cards in the editor's native text tab instead of the inline split-view editor |
defaultEditorMode |
rich-text |
Default mode for the inline editor (rich-text or raw) |
showLineNumbersInRawMode |
true |
Show line numbers in the raw Markdown source mode |
editorToolbarHeight |
32 |
Height in pixels of the inline editor toolbar |
language |
auto |
UI language (auto, en — English, es — Español, pt — Português) |
hideScrollbar |
false |
Hide scrollbars on the Kanban board while keeping scrolling enabled |
Font Size & Typography Settings (click to expand)
| Setting | Default | Description |
|---|---|---|
fontSizeColumnHeader |
16px |
Font size for column headers on the board (e.g., 16px, 1.1rem) |
fontSizeCardTitle |
14px |
Font size for card titles on the board (e.g., 14px, 1rem) |
fontSizeCardDescription |
14px |
Font size for card body/description previews on the board (e.g., 14px, 0.9rem) |
fontSizeCardLabel |
12px |
Font size for label tags on cards (e.g., 12px, 0.8rem) |
fontSizeCardMeta |
13px |
Font size for card metadata such as assignee, due date, epic, filename, and priority (e.g., 13px, 0.8rem) |
fontSizeEditorHeader |
18px |
Base font size for headings in the inline editor/preview panel (e.g., 18px, 1.5rem) |
fontSizeEditorBody |
16px |
Font size for body text, lists, and tables in the inline editor/preview panel (e.g., 16px, 1.1rem) |
fontSizeEditorMeta |
14px |
Font size for the metadata block above the inline editor (e.g., 14px, 0.9rem) |
Development
Contributions are welcome!
Prerequisites: Node.js 22+ and pnpm.
pnpm install # Install dependencies
pnpm dev # Start development (watch mode)
pnpm build # Build for production
pnpm test # Run unit and component tests
pnpm lint # Run ESLint
pnpm typecheck # Run TypeScript type checking
pnpm package # Package extension as a .vsix
See CONTRIBUTING.md for architecture and testing details.
Tech Stack
- Extension Host: TypeScript 6, VS Code Extension API, esbuild
- Webview UI: React 19, Vite 7, Tailwind CSS 3, Zustand 5, MDXEditor 4, Lucide Icons
- Testing & Tooling: Vitest 5, Testing Library, Mocha (
@vscode/test-electron), ESLint 10
Acknowledgements
Kanban Sauce is a heavily evolved fork of Kanban Markdown. Huge thanks to the original contributors: @LachyFS, @luciopaiva, @ungive, @hodanli, and @SuperbDotHub.
Kanban Sauce builds on their foundation to deliver a more flexible, multi-board, and 100% local-first experience.
License
Released under the MIT License.
