docs: M7 Part 2 landed — embedded ntfy distributor + push.ntfyUrl #22

wtclaude · 2026-07-20T20:28:23Z

wtclaude commented

2026-07-20 20:28:23 +00:00

What & why

Documentation companion to the M7 Part 2 implementation: RunicGateway/Android-app#15 (the app's push notifications) and RunicGateway/website#79 (the small push.ntfyUrl settings field). Keeps docs/ in lockstep per the repo contract. Follows the merged plan PR (#21).

Changes

docs/android/PLAN.md — flips M7 Part 2 → landed (top status line, the "M7 plan" Part 2 block, and the §9 M7 milestone) and records the two implementation decisions:
- Direct-ntfy embedded distributor, no UnifiedPush library (the plan's stated likely path): a foreground PushService holding an OkHttp-SSE connection to <ntfy>/<topic>/sse, PushManager orchestration, per-stream deep-link notifications — no second app, no Google Play Services, no new Gradle dependency; a transport seam for a future FCM flavor.
- The small additive push.ntfyUrl backend field the app needs to discover the relay (the "no backend work in Part 2" caveat, corrected). Deploy dependency stands: push delivers once the shard sets NTFY_PUBLIC_URL / NTFY_ALLOWED_ORIGINS.
docs/website/BACKEND_DESIGN.md — documents the /public/settings push block and the new NTFY_PUBLIC_URL env var.

AI disclosure

Authored with Claude Code (Claude Opus). Commits carry a Co-Authored-By: Claude trailer per org policy.

🤖 Generated with Claude Code

## What & why Documentation companion to the M7 **Part 2** implementation: **`RunicGateway/Android-app#15`** (the app's push notifications) and **`RunicGateway/website#79`** (the small `push.ntfyUrl` settings field). Keeps `docs/` in lockstep per the repo contract. Follows the merged plan PR (#21). ## Changes - **`docs/android/PLAN.md`** — flips **M7 Part 2 → landed** (top status line, the "M7 plan" Part 2 block, and the §9 M7 milestone) and records the two implementation decisions: - **Direct-ntfy embedded distributor, no UnifiedPush library** (the plan's stated likely path): a foreground `PushService` holding an OkHttp-SSE connection to `<ntfy>/<topic>/sse`, `PushManager` orchestration, per-stream deep-link notifications — no second app, no Google Play Services, no new Gradle dependency; a transport seam for a future FCM flavor. - **The small additive `push.ntfyUrl` backend field** the app needs to discover the relay (the "no backend work in Part 2" caveat, corrected). Deploy dependency stands: push delivers once the shard sets `NTFY_PUBLIC_URL` / `NTFY_ALLOWED_ORIGINS`. - **`docs/website/BACKEND_DESIGN.md`** — documents the `/public/settings` `push` block and the new `NTFY_PUBLIC_URL` env var. ## AI disclosure Authored with **Claude Code** (Claude Opus). Commits carry a `Co-Authored-By: Claude` trailer per org policy. 🤖 Generated with [Claude Code](https://claude.com/claude-code)

wtclaude added 1 commit 2026-07-20 20:28:26 +00:00

docs(android): M7 Part 2 landed — embedded ntfy distributor + push.ntfyUrl 71cb181152

Flip M7 Part 2 to landed (Android-app#15) and record the two implementation
decisions: the direct-ntfy embedded distributor (no UnifiedPush library — the
plan's stated likely path; foreground-service SSE, no second app, no Google
Play Services), and the small additive push.ntfyUrl settings field the app
needs to discover the relay (website#79). Document push.ntfyUrl +
NTFY_PUBLIC_URL in BACKEND_DESIGN.md.

Co-Authored-By: Claude <noreply@anthropic.com>

whitlocktech approved these changes 2026-07-20 20:29:17 +00:00

whitlocktech merged commit 5a7bbc26fa into main

2026-07-20 20:29:44 +00:00

whitlocktech deleted branch docs/android-m7-part2-landed

2026-07-20 20:29:45 +00:00

whitlocktech referenced this issue from a commit

2026-07-20 20:29:46 +00:00

Merge pull request 'docs: M7 Part 2 landed — embedded ntfy distributor + push.ntfyUrl' (#22) from docs/android-m7-part2-landed into main

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: RunicGateway/docs#22