# Project pack: Leantime @ 8464a2e

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

> Leantime is a project planner for people who don't think of themselves as project managers. A "My Work" home page shows today's to-dos and calendar, and each project has boards, lists, a timeline, goals, idea boards, documents and timesheets. It was designed with ADHD, dyslexia and autism in mind, with a readable font option and gentle nudges. Use it for a house move, a small business or a volunteer group, on your own server.

## Setup path (checked 2026-11-03)
- **Needs Docker.** Tell the person before any setup work; no light non-Docker route is documented upstream. 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/Leantime/leantime/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/Leantime/leantime
- Pinned commit: `8464a2eac9f6206f85e03269909c5227ea12f8ea`. Use exactly this version.
- Zip the person can download in a browser: https://github.com/Leantime/leantime/archive/8464a2eac9f6206f85e03269909c5227ea12f8ea.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.leantime.io
- Licence: **AGPL-3.0-only**. Free to use and change. If you run a changed version that other people use over the internet (not just you or your household), you must offer them your source code under the same licence. Private use has no extra obligations. Plugins in app/Plugins/ can carry other licences, including Leantime's paid ones.

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

  ```sh
  git clone https://github.com/Leantime/leantime bespoke-leantime
  cd bespoke-leantime
  git checkout --detach 8464a2eac9f6206f85e03269909c5227ea12f8ea
  # Prepare development requirements and local configuration first.
  # Setup notes: app on http://localhost:5080 with MySQL, MailDev and S3Ninja
  make clean build && make run-dev
  ```

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

  ```sh
  docker network create leantime-net
  docker run -d --name mysql_leantime --network leantime-net -e MYSQL_ROOT_PASSWORD=change-me-root -e MYSQL_DATABASE=leantime -e MYSQL_USER=lean -e MYSQL_PASSWORD=change-me -v leantime-db:/var/lib/mysql mysql:8.4 --character-set-server=UTF8MB4 --collation-server=UTF8MB4_unicode_ci
  docker run -d --name leantime --network leantime-net -p 8080:8080 -e LEAN_DB_HOST=mysql_leantime -e LEAN_DB_USER=lean -e LEAN_DB_PASSWORD=change-me -e LEAN_DB_DATABASE=leantime -e LEAN_EMAIL_RETURN=you@example.com -e LEAN_SESSION_PASSWORD="$(openssl rand -hex 32)" -v leantime-userfiles:/var/www/html/userfiles -v leantime-public:/var/www/html/public/userfiles -v leantime-plugins:/var/www/html/app/Plugins leantime/leantime:latest
  # Wait for MySQL to start, then open http://localhost:8080/install to create your account.
  # Change both passwords before real use. The official compose file is in the Leantime/docker-leantime repository.
  ```
- Tools these commands use: Docker, or PHP 8.2+ with the extensions listed in the README, Apache or Nginx, and MySQL 8.0+ or MariaDB 10.6+, For development, Docker, make, Composer, Node.js and npm
- Develop: `make clean build && make run-dev   # app on http://localhost:5080 with MySQL, MailDev and S3Ninja`
- Test: `make unit-test   # make acceptance-test needs the Docker dev stack`
- Check/lint: `make test-code-style && make phpstan`
- Build: `make build-dev   # installs dependencies and builds the JavaScript and CSS`
- Stack: php, javascript, css (Laravel components, Blade, HTMX, jQuery, Tailwind CSS, Laravel Mix). Difficulty for a non-developer with an AI: **moderate**. Site name, logo, colours, themes, fonts, to-do statuses and chat notifications are settings. Code is organised by feature in app/Domain/<Feature>/ (controllers, services, repositories, templates), but it is mid-migration: old .tpl.php and newer Blade templates, jQuery and HTMX sit side by side, and the JavaScript needs a webpack build. CLAUDE.md explains the patterns.
- The project's own AI instructions, in the repository: `CLAUDE.md`, `CONTRIBUTING.md`.
Personal data: **yes**. Stored in: A MySQL or MariaDB database for projects, to-dos, comments, goals and timesheets; uploaded files in userfiles/ (or S3); plugins in app/Plugins/. Secrets are entered by the person, never in chat.

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