Personal Kanban Board

Transform your productivity with a sleek, local-first Kanban board. No servers, no tracking—just pure efficiency in your browser.

A beautiful, modern-designed personal Kanban board that runs entirely in your browser. No backend, no cloud, no data tracking. Everything stays local with browser localStorage persistence. Perfect for personal task management, work tracking, and staying organized.

🚀 Live Demo

Experience it firsthand: Try the Live Demo

📸 Screenshots

Label Manager

Control Menu

Settings Customization

✨ Key Features

• 🚀 Blazing Fast & Simple: Lightning-quick performance with a clean, intuitive interface.
• 🔍 Powerful Search: Find tasks instantly by label, title, description, or label groups.
• 📊 Productivity Reports: Visualize your progress with Cumulative Flow Diagrams and weekly completion stats.
• 🔔 Smart Notifications: Get reminded of due dates with customizable advance notices. Toggle on/off and view as a prioritized list.
• 💻 100% Local-First: No servers, no backend, no cloud. Your data never leaves your device.
• 🎨 Drag & Drop: Effortlessly move tasks and columns for seamless workflow management.
• 🏷️ Custom Labels & Colors: Organize with personalized labels, groups, and column colors.
• 💾 Easy Backup: Export/import boards as JSON files to your favorite cloud storage (OneDrive, Google Drive, Dropbox).
• 📱 Fully Responsive: Optimized for mobile and desktop—work from anywhere.
• 🥇 Free & Open Source: Always free, no hidden costs or subscriptions.

🛡️ Data Security & Persistence

Your data is stored securely in your browser's localStorage. It persists across sessions and survives cache clears. For extra safety, use the built-in export feature to save backups to your preferred cloud storage.

🚀 Quick Start

Get up and running in minutes!

For Users: Try It Now

1. Visit the Live Demo.
2. Start creating boards, tasks, and labels immediately.
3. Export your data anytime for backup.

For Developers: Host Your Own

The repository includes a pre-built static site in dist/. Simply upload it to any web host.

1. Copy the dist/ folder.
2. Upload to your web host (e.g., Hetzner, Netlify, Vercel).
3. Done! Your personal Kanban board is live.

🛠️ Development

Prerequisites

• Node.js (v18 or higher)
• npm or yarn

Installation

1. Clone the repo:

   git clone https://github.com/mdiener21/personal-kanban.git
   cd personal-kanban

2. Install dependencies:

   npm install

3. Start the dev server:

   npm run dev

   The app will open at http://localhost:3000.

Build for Production

npm run build

Built files are in dist/.

Preview Production Build

npm run preview

Generate a Release

Use the Generate Release workflow to automate release preparation:

• npm ci + npm run build
• version bump (package.json + package-lock.json)
• changelog promotion from Unreleased
• creation/update of a release PR (release/vX.Y.Z → main)

After the release PR is merged, Publish Release runs automatically on main and:

• creates/pushes tag vX.Y.Z
• publishes GitHub Release with notes extracted from CHANGELOG.md

Publish Release is triggered on every push to main, but it only creates a tag/release when that version tag does not already exist.

GitHub CLI example:

gh workflow run release.yml --ref main -f bump=patch

Use bump=minor or bump=major when needed.

If your repo blocks Actions from opening PRs, enable repository setting: Settings → Actions → General → Workflow permissions → Allow GitHub Actions to create and approve pull requests.

Run Tests

Run all Playwright E2E tests:

npm test

Run only the create-task tests (tests/e2e/create-task.spec.ts):

npm test -- tests/e2e/create-task.spec.ts

📚 Documentation

Dive deeper with our comprehensive docs: View Documentation

🤝 Contributing

We love contributions! Whether it's bug fixes, features, or docs—every star and fork helps grow the community.

• Star this repo ⭐ to show your support!
• Fork and contribute code or ideas.
• Report issues for bugs or suggestions.

📄 License

Licensed under the MIT License. See LICENSE.md for details.

---

Made with ❤️ for productivity enthusiasts. Star us on GitHub to stay updated!