A self-hosted file based task management board that supports Markdown syntax.
- Create cards, lists and tags in a modern and responsive interface;
- Write cards as Markdown files;
- Easy to install with a single Docker image;
- Light and dark themes synced with operating system settings;
- Heavy customizable with 3 default color themes (Adwaita, Nord and Catppuccin);
- Support for subpath based reverse-proxy with an environment variable for base path;
Via Docker:
docker run -d \
--name tasks.md \
-e PUID=1000 `#optional` \
-e PGID=1000 `#optional` \
-e TITLE="My tasks board" `#optional` \
-e BASE_PATH=/tasks `#optional` \
-p 8080:8080 \
-v /path/to/cards/:/api/files/ \
-v /path/to/styles/:/api/static/stylesheets/ `#optional \
--restart unless-stopped \
baldissaramatheus/tasks.md
For docker-compose, you can see an example here.
All CSS files are available in the public stylesheets directory, which can be mounted as a docker volume. It already comes with 3 color themes: Adwaita, Nord and Catppuccin. To use them, open the file /stylesheets/index.css and change the second line to the path of the color theme you want, you can find them under /stylesheets/color-themes.
With the goal of having a good mix of performance and maintainability, the application was built SolidJS and Koa. It also uses SimpleMDE for text editing and serve-static to serve the css files as-is.
Feel free to create issues for encountered bugs or to request new features, just make sure to include a proper label. Also give a thumbs up to the issues you feel that are relevant to be implemented for the next releases.
If you want to contribute with its development, select one of the existing issues, develop your solution and submit a pull request, it will be reviewed and may be merged with the existing code. To run the source code, open a terminal instance in the frontend directory and another instance in the backend directory, then in both of them run npm install and npm start.