From dcadf34aa36bd2b1bb375e7f6c961817b1b86788 Mon Sep 17 00:00:00 2001 From: jessikitty Date: Wed, 23 Sep 2026 20:13:08 +1000 Subject: [PATCH] docs: add .claude-context overview + session log --- .claude-context/00-overview.md | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) create mode 100644 .claude-context/00-overview.md diff --git a/.claude-context/00-overview.md b/.claude-context/00-overview.md new file mode 100644 index 0000000..3f36cca --- /dev/null +++ b/.claude-context/00-overview.md @@ -0,0 +1,24 @@ +# Frambe — Project Overview + +Frambe is a self-hosted, single-container web app that turns older tablets and +spare screens into digital photo frames, backed by an Immich server. The browser +client pulls photos (by album, person, favorites, or random) from Immich via a +thin Node/Express proxy and runs a full-screen slideshow with clock, EXIF, blur +background, and transition effects. Designed to run well on old/low-power browsers. + +**Stack:** Node.js + Express server (`server.js`), vanilla-JS frontend +(`public/js/app.js`), Docker + docker-compose deployment. No build step on the +frontend. Immich creds passed via compose `environment:` (`IMMICH_URL`, +`IMMICH_API_KEY`). + +**Current version:** 1.6.0 (on `dev`) — Immich v3 API compatibility. + +**Deployment:** hal-blackpearl, container on host port 3030. Repo on self-hosted +Gitea (`jessikitty/frambe`). Release flow: work on `dev`, merge to `main` when +confirmed. Files uploaded via scp+ssh (Gitea API truncates files >~16KB, and +`server.js` is ~27KB). + +**Credit / footer:** "Created by: Jess Rogerson (yelling commands at Claude.AI)" + +## Session Log +- 2026-09-23 — Immich v3 API Migration & Deploy Debugging — Updated all Immich API calls for v3 breaking changes (isShared/isOwned, search/metadata for album+person assets, search/random, ms duration); bumped to 1.6.0. Slideshow "no photos" traced to a missing `.env` breaking docker-compose, not the code.