# Project pack: Donetick @ 1291130

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

> Donetick is a task and chore manager for households and small teams. Chores can repeat on a schedule or rotate between people, be done together, and earn points that you can trade for rewards. It sends reminders and runs as one small Go service with a built-in database.

## Setup path (checked 2026-11-03)
- **Start here, no Docker:** Download the prebuilt program for your system and run it. 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://raw.githubusercontent.com/donetick/donetick/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/donetick/donetick
- Pinned commit: `1291130d7d1940a506fb18ab19bc40c833eedab9`. Use exactly this version.
- Zip the person can download in a browser: https://github.com/donetick/donetick/archive/1291130d7d1940a506fb18ab19bc40c833eedab9.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.donetick.com
- Live demo: https://app.donetick.com/. The project's hosted app. Don't enter anything private.
- 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/donetick/donetick bespoke-donetick
  cd bespoke-donetick
  git checkout --detach 1291130d7d1940a506fb18ab19bc40c833eedab9
  # Prepare development requirements and local configuration first.
  cd frontend
  npm install
  npm run build
  cd ..
  go run .
  ```

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

  ```sh
  docker run -d --name donetick -p 2021:2021 -e DT_ENV=selfhosted -e DT_SQLITE_PATH=/donetick-data/donetick.db -e TZ=Etc/UTC -v donetick-data:/donetick-data -v donetick-config:/config donetick/donetick
  # then open http://localhost:2021
  ```
- Tools these commands use: Docker for a trial, Go and Node for development
- Develop: `go run .`
- Test: `go test ./...`
- Stack: go, typescript (Gin, GORM, React, Vite). Difficulty for a non-developer with an AI: **moderate**. A Go back end that embeds a React front end. Most personal changes are chore settings and notifications; new features touch both sides.
Personal data: **yes**. Stored in: SQLite database in /donetick-data (Docker volume) or Postgres. Secrets are entered by the person, never in chat.

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