Stars
Forks
Watchers
Developer links
Tasks.md
Your task list should outlive the app that displays it: Tasks.md turns a folder of plain Markdown files into a kanban board, so the board is a view of your notes rather than a database holding them hostage. Every lane you create becomes a directory and every card a Markdown file inside it, which means the whole board stays readable in any text editor, greppable from a terminal, and friendly to the note tools you already use. You write card bodies in a proper Markdown editor, organize work with tags and due dates, and drag cards between lanes as priorities change. Sub-folders open as their own projects with separate lanes, so one installation quietly serves a work board, a home board, and a writing board side by side. Light and dark themes follow your operating system, three bundled color schemes (Adwaita, Nord, and Catppuccin) set the mood, and a custom stylesheet hook recolors everything else. The board installs as a PWA for an app-like window, speaks multiple languages detected from the browser, and slots under a subpath reverse proxy when it shares a domain. One Docker container on port 8080 serves the whole thing. Running on a dedicated VPS on RepoCloud with guaranteed CPU, RAM, and SSD, full root SSH access, and a browser serial console. MIT licensed.
Benefits
- Your Tasks Stay Plain Files
- Lanes are folders and cards are Markdown files, so your task data remains readable, searchable, and movable with ordinary file tools long after any single app version is gone.
- No Migration In Or Out
- Point Tasks.md at an existing folder of notes and it becomes a board; stop using it and the notes remain exactly where they were, in the format they started in.
- One Board Per Folder
- Sub-directories open as separate projects with their own lanes, which keeps work, home, and side projects apart without separate installations or accounts.
- Small, Calm, And Themeable
- A single container, operating-system-synced light and dark modes, three bundled color themes, and a custom CSS hook make the board pleasant without making it heavy.
Features
- Kanban Lanes And Cards
- Create lanes, cards, and tags in a responsive board; drag work between stages and mark due dates that highlight when they arrive or slip past.
- Markdown Card Editor
- Card bodies are Markdown files edited in a rich editor, so formatting, lists, and links live in portable text instead of a proprietary field.
- Folder-As-Project Structure
- Each lane is a directory and each sub-directory can open as its own project, mirroring the filesystem you can browse outside the app.
- Themes And Custom CSS
- Adwaita, Nord, and Catppuccin color schemes, light and dark modes synced to the system, and a custom.css override for deeper restyling.
- PWA And Multilingual Interface
- Installable as a progressive web app with locale auto-detected from the browser and remembered per user for multilingual households and teams.
- Single Docker Image
- One container serves port 8080 with PUID and PGID controls, a custom title, subpath base support, and automatic cleanup of orphaned local images.
