Tasks.md

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.