
Tasks.md
Self-hosted kanban-style task board that stores lanes as folders and tasks as Markdown files, with tags, theming, reverse-proxy support, and optional PWA install.

Tasks.md is a self-hosted task management board that uses your filesystem as the source of truth. Lanes are directories and tasks are Markdown files, giving you a simple, portable structure that works well with typical note-taking and file-sync workflows.
Key Features
- Kanban-style board with lanes, cards, and tags in a modern responsive UI
- Tasks stored as Markdown files on disk (folders represent lanes)
- Supports opening subdirectories as separate projects via URL path
- Light/dark mode that follows operating system settings
- CSS customization via a user-editable stylesheet and built-in color themes
- Supports subpath reverse-proxy deployments via a configurable base path
- Simple deployment using a single Docker image; can also run from source
- Optional install as a Progressive Web App (PWA)
Use Cases
- Personal task tracking with plain-text Markdown files you can version or sync
- Lightweight project boards for small teams or homelabs without a database
- Organizing tasks alongside a folder-based knowledge base or notes workflow
Limitations and Considerations
- PWA functionality does not work when the base path is set to anything other than "/"
- Feature scope is intentionally kept narrow, so advanced project management features may be out of scope
Tasks.md is a practical choice if you want a kanban board without a database and prefer human-readable files. Its folder-and-Markdown approach keeps your tasks easy to back up, migrate, and edit outside the UI when needed.
