# Project pack: TREK @ d805774

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

> TREK is a self-hosted trip planner. You build a day-by-day itinerary on a map, add places and bookings, track a shared budget, keep packing lists and documents, and plan with friends or family in real time. It works as an installable app on your phone.

## 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/liketrek/TREK/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/liketrek/TREK
- Pinned commit: `d80577480c672799154ea9912918d906d16c0a75`. Use exactly this version.
- Zip the person can download in a browser: https://github.com/liketrek/TREK/archive/d80577480c672799154ea9912918d906d16c0a75.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/liketrek/TREK/wiki
- Live demo: https://demo.liketrek.com/. Shared demo. Don't enter real data.
- 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/liketrek/TREK bespoke-trek
  cd bespoke-trek
  git checkout --detach d80577480c672799154ea9912918d906d16c0a75
  # Prepare development requirements and local configuration first.
  cd server
  npm install
  npm run dev
  ```

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

  ```sh
  ENCRYPTION_KEY=$(openssl rand -hex 32) docker run -d -p 3000:3000 -e ENCRYPTION_KEY=$ENCRYPTION_KEY -v ./data:/app/data -v ./uploads:/app/uploads mauriceboe/trek
  # then open http://localhost:3000 (the admin login is printed in the container log on first start)
  ```
- Tools these commands use: Docker for a trial, Node 22 for development
- Develop: `cd server && npm run dev  # and, in another terminal: cd client && npm run dev`
- Test: `cd client && npm test`
- Stack: typescript (React, Vite, Node.js, Express, Tailwind). Difficulty for a non-developer with an AI: **moderate**. A compact TypeScript project with a React client, a Node server and a plugin SDK. Settings cover most trips; new features follow clear client and server folders.
- The project's own AI instructions, in the repository: `CLAUDE.md`.
Personal data: **yes**. Stored in: A SQLite database and uploaded documents in /app/data and /app/uploads. Secrets are entered by the person, never in chat.

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