# Project pack: solidtime @ 93eb93f

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

> solidtime is a modern time tracker for freelancers and small teams. You start a timer or add entries by hand, tag them to clients and projects, set billable rates, and see reports of where your time went. It can be self-hosted or used as a hosted service, and it has a desktop timer and an API.

## Setup path (checked 2026-11-03)
- **Needs Docker.** Tell the person before any setup work; no light non-Docker route is documented upstream. The desktop apps are time-tracking clients that still need a solidtime server. 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://docs.solidtime.io/self-hosting/guides/docker
- 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/solidtime-io/solidtime
- Pinned commit: `93eb93f1dc2de0d50849ce7883a601dd76691df1`. Use exactly this version.
- Zip the person can download in a browser: https://github.com/solidtime-io/solidtime/archive/93eb93f1dc2de0d50849ce7883a601dd76691df1.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.solidtime.io
- Licence: **AGPL-3.0-only**. Free to use and change. If other people use your changed version, including over a network (for example a website you host for them), you must offer them 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/solidtime-io/solidtime bespoke-solidtime
  cd bespoke-solidtime
  git checkout --detach 93eb93f1dc2de0d50849ce7883a601dd76691df1
  # Prepare development requirements and local configuration first.
  composer install
  npm install
  cp .env.example .env
  ./vendor/bin/sail up -d
  ./vendor/bin/sail artisan migrate
  npm run dev
  ```

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

  ```sh
  Follow the self-hosting guide at https://docs.solidtime.io/self-hosting/intro, which provides a ready-made Docker Compose file.
  ```
- Tools these commands use: Docker, or PHP 8.3, Composer, Node 22 and Postgres for development
- Develop: `./vendor/bin/sail up -d && npm run dev`
- Test: `./vendor/bin/sail artisan test`
- Check/lint: `./vendor/bin/pint`
- Stack: php, typescript (Laravel, Inertia.js, Vue, Tailwind). Difficulty for a non-developer with an AI: **moderate**. A standard Laravel and Vue application with an OpenAPI description. Reports, rates and exports are good places to start; the rest is regular Laravel code.
Personal data: **yes**. Stored in: A Postgres database plus a storage folder or bucket. Secrets are entered by the person, never in chat.

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