# Project pack: Kanboard @ e197e71

Facts about **Kanboard** for an AI following the [BespokeAI handover guide](https://handoff.bespokeai.software/guide/v4.md). Pinned to one version; never changes after publication.

> Kanboard turns any project into a board of columns, such as To do, Doing and Done, with a card for each task. Drag cards across as work moves on, add checklists, due dates and colours, and let simple rules do chores for you, like closing a task when it reaches Done. It suits a household, a club or a small team, is light enough for a Raspberry Pi, and runs on your own computer or server.

## Setup path (checked 2026-11-03)
- **Start here, no Docker:** Run the source directly with the language runtime (PHP, Node or Python). No Docker.
- Offer Docker only if the person asks or this path fails. The commands further down may use Docker; they are not the starting point.
- Verdict source: https://docs.kanboard.org/v1/
- You may be unable to download source archives or run commands in this session. The person downloads and runs things; if you cannot fetch something, give any changed file in full in chat with its path.

## Version and source
- Repository: https://github.com/kanboard/kanboard
- Pinned commit: `e197e71af4ff9f371b931ab0338b2b41827e6394`. Use exactly this version.
- Zip the person can download in a browser: https://github.com/kanboard/kanboard/archive/e197e71af4ff9f371b931ab0338b2b41827e6394.zip
- Fresh checkout (only if you have a shell and git): use the commands below in an empty folder. If this exact source is already checked out, keep your branch and use the development command; do not clone again or reset local changes.
- Official docs: https://docs.kanboard.org/v1/
- Licence: **MIT**. Very permissive. You can use, change, share and even sell it, for any purpose, as long as you keep the copyright and licence notice. There is no obligation to share your changes.

## Commands from the pinned source
- Developer commands (they may use Docker):

  ```sh
  git clone https://github.com/kanboard/kanboard bespoke-kanboard
  cd bespoke-kanboard
  git checkout --detach e197e71af4ff9f371b931ab0338b2b41827e6394
  # Prepare development requirements and local configuration first.
  # Setup notes: open http://localhost:8000, login admin/admin; copy config.default.php to config.php to change settings
  composer install && php -S localhost:8000 -t .
  ```

- Separate trial of the current upstream release (not your changes; sample data and a separate data directory only):

  ```sh
  docker run -d --name kanboard -p 8080:80 -v kanboard-data:/var/www/app/data -v kanboard-plugins:/var/www/app/plugins kanboard/kanboard:latest # then open http://localhost:8080 and log in as admin / admin. Change that password straight away.
  ```
- Tools these commands use: Docker, or PHP 8.1+ with a web server (Apache, Nginx or PHP's built-in server), SQLite (default), MySQL/MariaDB or PostgreSQL, Composer for development
- Develop: `composer install && php -S localhost:8000 -t .   # open http://localhost:8000, login admin/admin; copy config.default.php to config.php to change settings`
- Test: `make test-sqlite   # ./vendor/bin/phpunit -c tests/units.sqlite.xml`
- Check/lint: `jshint ./assets/js/core ./assets/js/components`
- Build: `./cli css && ./cli js   # rebuild the bundled CSS and JavaScript after editing assets/css/src or assets/js/src`
- Stack: php, javascript, css (Pimple, PicoDb, SwiftMailer, jQuery UI). Difficulty for a non-developer with an AI: **easy**. Plain PHP with no build step for pages: templates are simple PHP files in app/Template/, and changes show on refresh. Custom CSS, automatic actions, webhooks and a JSON-RPC API cover a lot without code, and plugins can override any template, so most changes survive updates. CSS and JavaScript sources are bundled with ./cli css and ./cli js.
- The project's own AI instructions, in the repository: `CONTRIBUTING.md`.
Personal data: **yes**. Stored in: SQLite file and attachments in data/ (/var/www/app/data in Docker, the kanboard-data volume), or a MySQL/PostgreSQL database. Plugins live in plugins/. Secrets are entered by the person, never in chat.

---
Later, only when a step needs it: [reference.md](https://handoff.bespokeai.software/p/kanboard/e197e71/r3/reference.md) (customisation points, must-keep-working, data and costs, coding conventions) · [hosting.md](https://handoff.bespokeai.software/p/kanboard/e197e71/r3/hosting.md) (long-term hosting; hosts are paid third parties) · [bespoke.yaml](https://handoff.bespokeai.software/p/kanboard/e197e71/r3/bespoke.yaml) · [SKILL.md](https://handoff.bespokeai.software/p/kanboard/e197e71/r3/SKILL.md)