# Project pack: AdventureLog @ 5673ef5

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

> AdventureLog is a self-hosted travel tracker. You log places you have visited with photos, notes and dates, see them on a world map with countries and regions filled in, and plan upcoming trips with itineraries and shared collections. It is designed for travellers who want to keep their own travel history.

## 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://adventurelog.app/docs/install/quick_start.html
- 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/seanmorley15/AdventureLog
- Pinned commit: `5673ef5bb5aaa96081bc250ef1d16da8b45977e3`. Use exactly this version.
- Zip the person can download in a browser: https://github.com/seanmorley15/AdventureLog/archive/5673ef5bb5aaa96081bc250ef1d16da8b45977e3.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://adventurelog.app/docs/intro/adventurelog_overview.html
- Live demo: https://demo.adventurelog.app/signup. 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/seanmorley15/AdventureLog bespoke-adventurelog
  cd bespoke-adventurelog
  git checkout --detach 5673ef5bb5aaa96081bc250ef1d16da8b45977e3
  # Prepare development requirements and local configuration first.
  cp .env.example .env
  docker compose up -d
  ```

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

  ```sh
  git clone https://github.com/seanmorley15/AdventureLog adventurelog-run
  cd adventurelog-run
  cp .env.example .env
  # edit .env and set a strong POSTGRES_PASSWORD and the public URL
  docker compose up -d
  # then open http://localhost:8015
  ```
- Tools these commands use: Docker, or Node 22 and Python 3.12 with PostGIS for development
- Develop: `docker compose up -d`
- Stack: typescript, python (SvelteKit, Django, Django REST Framework, Tailwind, Leaflet). Difficulty for a non-developer with an AI: **moderate**. A SvelteKit front end and a Django back end with a PostGIS database. Familiar structure; the map and region data add some weight.
Personal data: **yes**. Stored in: A Postgres database plus a media folder for photos. Secrets are entered by the person, never in chat.

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