aboutsummaryrefslogtreecommitdiffstats
path: root/docs/superpowers/specs
diff options
context:
space:
mode:
Diffstat (limited to 'docs/superpowers/specs')
-rw-r--r--docs/superpowers/specs/2026-10-22-mygram-droid-design.md18
1 files changed, 13 insertions, 5 deletions
diff --git a/docs/superpowers/specs/2026-10-22-mygram-droid-design.md b/docs/superpowers/specs/2026-10-22-mygram-droid-design.md
index 4545884..13dd378 100644
--- a/docs/superpowers/specs/2026-10-22-mygram-droid-design.md
+++ b/docs/superpowers/specs/2026-10-22-mygram-droid-design.md
@@ -142,11 +142,19 @@ videos only, endless, paged with the same seed.
- Optional app PIN, 4 to 8 digits, typed twice; Remove PIN when one is set.
- Header with a back arrow, like the folder grid.
-### PIN lock
-
-- Only when a PIN is set: a splash with the logo and a PIN field covers
- any screen at app start and whenever the app comes back after leaving
- the screen (an Application lifecycle counter tracks started activities).
+### Splash (PIN lock and indexing wait)
+
+- A splash with the logo covers any screen at app start and whenever the
+ app comes back after leaving the screen (an Application lifecycle
+ counter tracks started activities). Home connects only after it.
+- When a PIN is set it asks for it first.
+- Then it checks `GET /api/scan-progress`: while `isScanning`, it stays
+ with a spinner, "Library is indexing" and the server's phase message
+ plus the derivative job counter, polling every 5 s; Foldergram is
+ unusably slow while indexing. Idle: it closes at once.
+- Unreachable at the first check: it lets the user in so Home shows its
+ error with Retry. After a scan was seen, failed polls keep waiting.
+- A scan that starts while the app is open does not interrupt it.
- Back on the lock screen leaves the app.
- Stored as salt plus SHA-256, never the PIN. It is a privacy screen, not
protection against someone with adb or root on the TV; clearing the