# Project pack: WeKan @ a463937

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

> WeKan is an open-source kanban board. You create boards with lists and cards, drag cards between lists, assign people, add due dates, checklists, labels and attachments, and keep it all on your own server. It suits a household, a club or a small team that wants Trello without a subscription.

## Setup path (checked 2026-11-03)
- **Needs Docker.** Tell the person before any setup work; no light non-Docker route is documented upstream. Upstream also offers a Windows/Mac/Linux bundle .zip; not assessed as a no-install path. Docker Desktop on Windows may need a computer restart and an admin-only Windows feature (virtualisation); say so and let the person decide.
- Verdict source: https://raw.githubusercontent.com/wekan/wekan/HEAD/README.md
- 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/wekan/wekan
- Pinned commit: `a463937cce289b58024026916b9591a228a4b354`. Use exactly this version.
- Zip the person can download in a browser: https://github.com/wekan/wekan/archive/a463937cce289b58024026916b9591a228a4b354.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://github.com/wekan/wekan/wiki
- Licence: **MIT**. Free to use, change and share, even commercially. Keep the original copyright notice.

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

  ```sh
  git clone https://github.com/wekan/wekan bespoke-wekan
  cd bespoke-wekan
  git checkout --detach a463937cce289b58024026916b9591a228a4b354
  # Prepare development requirements and local configuration first.
  meteor npm install
  meteor run --settings ./settings.json
  ```

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

  ```sh
  curl -O https://raw.githubusercontent.com/wekan/wekan/main/docker-compose.yml
  # edit ROOT_URL in the file to the address you will use, for example http://localhost:2000
  docker compose up -d
  ```
- Tools these commands use: Docker for a trial, Meteor and Node for development
- Develop: `meteor run --settings ./settings.json`
- Test: `npm test`
- Stack: javascript (Meteor, Blaze, Node.js). Difficulty for a non-developer with an AI: **advanced**. A large Meteor application with its own build tooling and many options. Board settings, templates and rules need no code; source changes need the Meteor toolchain.
- The project's own AI instructions, in the repository: `AGENTS.md`, `CLAUDE.md`.
Personal data: **yes**. Stored in: A FerretDB or MongoDB database plus an uploads store (Docker volumes). Secrets are entered by the person, never in chat.

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