aboutsummaryrefslogtreecommitdiffstats
path: root/AGENTS.md
diff options
context:
space:
mode:
authorDanilo M. <danix@danix.xyz>2026-10-22 10:45:15 +0200
committerDanilo M. <danix@danix.xyz>2026-10-22 10:45:15 +0200
commit711af15b9cc3327a5b276ea5dc9faa5ad1b5a987 (patch)
treef0a63cf74944298a4bab177c5f203753f475dc89 /AGENTS.md
parent295274d3899ed08bb51b57a800452e4c5f1842b5 (diff)
downloadmygram-droid-711af15b9cc3327a5b276ea5dc9faa5ad1b5a987.tar.gz
mygram-droid-711af15b9cc3327a5b276ea5dc9faa5ad1b5a987.zip
Add approved app design spec
Design for the Android TV client: instance discovery by subnet scan, viewer-password login, Home rows with blurred rotating background, Reels, Liked and Folders tabs, and a fullscreen viewer with blurred backdrop, auto-advance, progress bar and double-OK likes. AGENTS.md now points at the spec instead of listing open decisions. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Diffstat (limited to 'AGENTS.md')
-rw-r--r--AGENTS.md24
1 files changed, 13 insertions, 11 deletions
diff --git a/AGENTS.md b/AGENTS.md
index 2e9f7a8..d190de9 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -11,11 +11,12 @@ photos and videos in a remote-friendly, D-pad driven TV interface.
## Scope
-- Read-only browsing: list folders, open a folder feed, view media
- fullscreen, step through items with the remote.
-- Server address entered once on first launch and stored on the device.
-- Out of scope unless asked: uploading, editing, deleting, accounts beyond
- what the instance itself requires, phone/tablet layouts.
+- Browsing: folder rows, folder grids, reels, fullscreen viewer driven by
+ the remote. The only write is toggling a like.
+- Instance found by LAN scan on first launch (manual URL as fallback),
+ logged in with the viewer password, both stored on the device.
+- Out of scope unless asked: uploading, editing, deleting, admin features,
+ phone/tablet layouts.
## Target device
@@ -41,13 +42,14 @@ photos and videos in a remote-friendly, D-pad driven TV interface.
- The real instance address is personal, keep it out of the repo. It is in
agent memory, or ask the user.
-## Open decisions
+## Design
-Not yet settled, ask before assuming:
-- Language and UI toolkit (e.g. Kotlin with Compose for TV vs Leanback).
-- Minimum Android TV API level.
-- Which Foldergram API endpoints to use; read the instance's actual API,
- do not guess routes.
+The approved design is
+`docs/superpowers/specs/2026-10-22-mygram-droid-design.md`: Java, minSdk
+34, Glide and Media3 ExoPlayer as the only dependencies, viewer-password
+login, subnet-scan instance discovery. Follow it; change it only with the
+user. For Foldergram endpoints read upstream `docs/api.md` and probe the
+live instance, do not guess routes or fields.
## Conventions