A Kanboard plugin that automatically assigns task card colors based on the day of the week of the task's due date, triggered at task creation time.
This plugin adds an automatic action to Kanboard that assigns a configurable color to newly created tasks based on the day of the week of their due date. Colors are configured per-project using Kanboard's built-in automatic action UI — no extra configuration screens needed.
- Registers a new automatic action: "Assign a color based on the day of the week of the task's due date"
- Configurable Mon–Sun color mapping per project (choose any Kanboard color for each day, or 'No change' to leave weekends untouched)
- Configurable timezone per action instance (defaults to the PHP server timezone)
- Color is determined by the due date's day of week — not the creation date
- Only fires when a task has the default color and a non-zero due date, preventing unwanted overrides
- Uses Kanboard's existing action parameter storage — no custom database tables
- Kanboard ≥ 1.2.19
- PHP 7.0+ (as required by your Kanboard installation)
Option A — Drop into plugins directory:
cd /path/to/kanboard/plugins
git clone https://github.com/geekmuse/kanboard-plugin-auto-action-assign-colors-by-day-of-week.git AssignColorsByDayOfWeek
⚠️ The directory must be namedAssignColorsByDayOfWeekto match the PHP namespace.
Option B — Download ZIP:
Download a release archive and extract it as plugins/AssignColorsByDayOfWeek/ inside
your Kanboard installation.
- Navigate to a project → Actions → Automatic Actions
- Add a new action: select "Assign a color based on the day of the week of the task's due date"
- Choose a color for each day of the week (Monday through Sunday); select "No change" for any day you want to leave untouched
- Optionally select a Timezone (defaults to the PHP server timezone)
- Save the action
Important: the color assigned is based on the due date's day of week, not the day the task is created. A task created on Monday with a due date of Wednesday will receive Wednesday's configured color.
When tasks are created with a due date falling on a configured day, the plugin will automatically set the task color to the configured value for that day. Tasks with a due date on a day configured as 'No change', or tasks with no due date, are left unmodified.
Detailed documentation lives in the docs/ directory:
| Section | Path | Description |
|---|---|---|
| Architecture | docs/001-architecture.md |
System design and key decisions |
| Development Guide | docs/002-development-guide.md |
How to develop, test, and contribute |
| Doc Standards | docs/003-documentation-standards.md |
How docs are structured and maintained |
| Specs | docs/specs/ |
Feature specifications and design docs |
| ADRs | docs/adrs/ |
Architecture Decision Records |
| References | docs/references/ |
API docs, glossary, config reference |
| Tasks | docs/tasks/ |
Work items and sprint plans |
| Research | docs/research/ |
Spikes, investigations, POC write-ups |
# Clone
git clone https://github.com/geekmuse/kanboard-plugin-auto-action-assign-colors-by-day-of-week.git
cd plugin-auto-action-assign-colors-by-day-of-week
# Install git hooks
prek install
# Syntax check
find . -name "*.php" -not -path "./vendor/*" | xargs php -l
# Install dev tooling (once composer.json is added)
composer install --dev
# Run tests
./vendor/bin/phpunit
# Lint
./vendor/bin/phpcs --standard=PSR12 .See Development Guide for full details.
- Fork the repository
- Create a feature branch (
git checkout -b feat/amazing-feature) - Commit using conventional commits (
git commit -m 'feat(action): add amazing feature') - Push to the branch (
git push origin feat/amazing-feature) - Open a Pull Request
Please read AGENTS.md for project conventions and docs/002-development-guide.md for the full development workflow.
This project uses Semantic Versioning. The version is maintained
in Plugin.php → getPluginVersion(). See CHANGELOG.md for release
history.
MIT — see LICENSE for details.
Brad Campbell