# Project pack: Easy!Appointments @ f6c8a4c

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

> Easy!Appointments lets clients book your time online. You set services, working hours and breaks, and customers pick a slot on a booking page that you can embed in your own website. It syncs with Google Calendar, sends confirmation emails and has a simple back office for you and your staff.

## Setup path (checked 2026-11-03)
- **Needs Docker.** Tell the person before any setup work; no light non-Docker route is documented upstream. A manual PHP + MySQL + web server install is documented but judged too heavy for a one-sitting non-technical setup. 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/alextselegidis/easyappointments/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/alextselegidis/easyappointments
- Pinned commit: `f6c8a4c2f364bf8c64b1f913a531a7134dcfd3c6`. Use exactly this version.
- Zip the person can download in a browser: https://github.com/alextselegidis/easyappointments/archive/f6c8a4c2f364bf8c64b1f913a531a7134dcfd3c6.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://easyappointments.org/docs.html
- Live demo: https://demo.easyappointments.org/. Shared demo. Don't enter real data.
- Licence: **GPL-3.0-only**. Free to use and change. If you share your changed version with other people (give them the code or app), you must share your source code under the same licence. Using it privately for yourself or your household has no extra obligations.

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

  ```sh
  git clone https://github.com/alextselegidis/easyappointments bespoke-easyappointments
  cd bespoke-easyappointments
  git checkout --detach f6c8a4c2f364bf8c64b1f913a531a7134dcfd3c6
  # Prepare development requirements and local configuration first.
  docker compose up -d
  docker compose exec php-fpm bash -c "npm install && composer install"
  docker compose exec php-fpm npm start
  ```

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

  ```sh
  Download the latest release zip from https://github.com/alextselegidis/easyappointments/releases, upload it to PHP hosting with MySQL, and open it in a browser to run the installer.
  ```
- Tools these commands use: Docker for development, or PHP 8.1+ with MySQL and a web server
- Develop: `docker compose up -d`
- Test: `composer test`
- Stack: php, javascript (CodeIgniter 3, Bootstrap, jQuery). Difficulty for a non-developer with an AI: **easy**. A classic PHP, CodeIgniter and MySQL app. Services, hours and email wording are settings; the booking page is plain views and JavaScript.
- The project's own AI instructions, in the repository: `CLAUDE.md`.
Personal data: **yes**. Stored in: A MySQL database. Secrets are entered by the person, never in chat.

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