History

Erich Blume 271c609c14 feat(heph-pwa): re-fetch the current view when the app regains focus The PWA shares the daemon's store with the TUI/desktop popover but only re-fetched on a view switch or action — so a task marked done elsewhere left a stale list on screen. Reload the current view on visibilitychange→visible (switch back to the phone, unlock, tab re-show), skipping it mid-modal/search. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>		2026-06-04 17:16:15 -07:00
..
icons	feat(heph-pwa): mobile app shell — views, quick-add, triage, search, voice	2026-06-04 16:59:37 -07:00
src	feat(heph-pwa): re-fetch the current view when the app regains focus	2026-06-04 17:16:15 -07:00
test	feat(heph-pwa): port quickadd + datespec parsers to JS (with parity tests)	2026-06-04 16:42:09 -07:00
index.html	feat(heph-pwa): mobile app shell — views, quick-add, triage, search, voice	2026-06-04 16:59:37 -07:00
manifest.webmanifest	feat(heph-pwa): mobile app shell — views, quick-add, triage, search, voice	2026-06-04 16:59:37 -07:00
README.md	feat(heph-pwa): mobile app shell — views, quick-add, triage, search, voice	2026-06-04 16:59:37 -07:00
styles.css	feat(heph-pwa): mobile app shell — views, quick-add, triage, search, voice	2026-06-04 16:59:37 -07:00
sw.js	feat(heph-pwa): re-fetch the current view when the app regains focus	2026-06-04 17:16:15 -07:00

README.md

heph-pwa

A phone-first, installable Progressive Web App that mirrors heph-tui: browse the built-in views and projects, triage tasks, and — the primary use case — capture tasks fast with the same quick-add syntax as the TUI's a / Cmd-' popover. Context/KB is read-only here.

Full guide: docs/how-to/heph-pwa.md.

What it is

Thin, online-only client. Every read/write is a JSON-RPC call to a server-mode hephd (the sync hub). No local replica, no offline write queue.
Buildless. Plain ES modules, no bundler, no npm install. Serve the directory and go.
Same parser as the TUI. src/quickadd.js + src/datespec.js are faithful ports of the Rust hephd::quickadd / hephd::datespec modules, verified by parity tests against the original Rust unit cases.

Layout

index.html              # app shell
styles.css              # dark, terminal-flavored, touch-tuned
manifest.webmanifest    # PWA manifest (installable)
sw.js                   # service worker — caches the app shell for offline launch
icons/                  # app icons (svg + rasterized png, incl. maskable)
src/
  app.js                # UI controller: views, list, quick-add, triage, search, voice
  rpc.js                # hephd JSON-RPC-over-HTTP client + settings (localStorage)
  quickadd.js           # quick-add parser (port of quickadd.rs)
  datespec.js           # date + recurrence parser (port of datespec.rs)
  fmt.js                # display helpers (date chips, attention colors, bullets)
test/
  parsers.test.mjs      # parity tests for the parser ports

Run it

Serve from the hub (recommended — same-origin, no CORS):

hephd --mode server --http-addr 0.0.0.0:8787 --web-root /path/to/heph-pwa
# then open http://<host>:8787/ on your phone and Add to Home Screen

Or from any static server (the hub now sends CORS headers, so cross-origin /rpc calls work); set the hub URL in the app's Settings screen.

Test

node --test heph-pwa/test/parsers.test.mjs

Status / next steps

First cut (C1). Known gaps, roughly in priority order:

In-app OIDC device-code login (today: paste a bearer token in Settings).
Offline write queue / CRDT replica (today: online-only).
Read-only context could grow wiki-link navigation.
A native Swift wrapper, if/when an Apple Developer account is in play.