# Project pack: wallabag @ 72bdffa

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

> wallabag is a read-it-later service you run yourself. Save any web page with one click from your browser or phone, and wallabag keeps a clean copy of the text and pictures with no adverts or pop-ups. Read it later on any device, even offline in the apps, add highlights and notes, and tag articles automatically. You can bring your saved articles from Pocket, Instapaper and others.

## 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://doc.wallabag.org
- 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/wallabag/wallabag
- Pinned commit: `72bdffa41fd6b73a547e140206cf702e7bd29f8f`. Use exactly this version.
- Zip the person can download in a browser: https://github.com/wallabag/wallabag/archive/72bdffa41fd6b73a547e140206cf702e7bd29f8f.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://doc.wallabag.org
- Licence: **MIT**. Very permissive. You can use, change and share it, even commercially. If you pass on copies, keep the copyright notice and licence text.

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

  ```sh
  git clone https://github.com/wallabag/wallabag bespoke-wallabag
  cd bespoke-wallabag
  git checkout --detach 72bdffa41fd6b73a547e140206cf702e7bd29f8f
  # Prepare development requirements and local configuration first.
  # Setup notes: http://127.0.0.1:8000; run make dev-watch for assets
  cp docker/php/env.example docker/php/env && make dev-docker-up && make dev-setup
  ```

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

  ```sh
  docker run -d --name wallabag -p 8080:80 -v wallabag-data:/var/www/wallabag/data -v wallabag-images:/var/www/wallabag/web/assets/images -e APP_SECRET=$(openssl rand -hex 16) -e WALLABAG_BASE_URL=http://localhost:8080 -e DATABASE_URL=sqlite:////var/www/wallabag/data/db/wallabag.sqlite wallabag/wallabag
  # open http://localhost:8080 and log in as wallabag / wallabag, then change the password.
  # This follows the install docs at the pinned commit; older image releases may use different variable names (see Docker Hub).
  ```
- Tools these commands use: Docker, or PHP 8.2+ with Composer, a web server and SQLite, PostgreSQL or MySQL, For development, GNU make, Node.js and Yarn (or the Docker dev stack)
- Develop: `cp docker/php/env.example docker/php/env && make dev-docker-up && make dev-setup   # http://127.0.0.1:8000; run make dev-watch for assets`
- Test: `make test`
- Check/lint: `make lint`
- Build: `make build`
- Stack: php, javascript, twig, scss (Symfony 5.4, Doctrine, Twig, Webpack Encore, Stimulus, Materialize CSS, Graby). Difficulty for a non-developer with an AI: **moderate**. A long-lived Symfony app with good structure: controllers in src/Controller/, pages in templates/ (Twig), styles in assets/scss/ and small Stimulus controllers in assets/controllers/. Tagging rules, custom CSS and the API cover a lot without code. Code changes need PHP 8.2+ and Node for the assets; the Docker dev stack makes that easier.
- The project's own AI instructions, in the repository: `.github/CONTRIBUTING.md`.
Personal data: **yes**. Stored in: Database (SQLite file in data/db/ by default, or PostgreSQL/MySQL) for articles, tags and highlights; saved pictures in web/assets/images. Secrets are entered by the person, never in chat.

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