Tasks.md

Tasks.md is a self-hosted task management application that stores cards and lanes as Markdown files on the local filesystem. It provides a visual interface for organizing work using a board layout where each lane corresponds to a directory and each task corresponds to an individual file. This architecture ensures that all project data remains portable and accessible through any standard text editor.

The software is deployed as a server application, typically via a Docker container, and is accessed through a web browser. It is designed for users who prefer a file-based approach to data storage, allowing task data to remain independent of a proprietary database. The application can be configured with specific user and group IDs to maintain correct file permissions on Linux distributions.

Key features

• Creation of cards, lanes, and tags via a responsive interface
• Storage of task content as Markdown files
• Support for light and dark themes synced with system settings
• Customization through three default color themes
• Installation as a Progressive Web App (PWA)
• Multilingual support with automatic browser locale detection
• Support for subpath based reverse-proxy configurations

The application is built using SolidJS and Koa, utilizing Stacks-Editor for text editing and serve-static for CSS delivery. It allows for deep customization of the user interface through a custom CSS file and a set of predefined color variables for accents, backgrounds, and tags. Because the data structure mirrors the filesystem, users can treat sub-directories as independent projects, each with its own set of lanes and tasks, enabling a hierarchical organization of different workstreams.

To maintain long-term viability, the project maintains a narrow scope of features. It is intended for individuals or teams who require a simple, file-centric way to manage agile boards without relying on complex database backends.