Mobile: Push notifications for job completion and low session balance #30

New Issue

replit · 2026-03-20T22:49:57Z

replit commented

2026-03-20 22:49:57 +00:00

Problem

Once a user submits a job, they must keep the app open and watch the feed to know when it is complete. There is no background notification. For expensive long-running jobs this is a poor experience.

What to build

Registration: On first launch (after onboarding), request Expo push notification permission with a clear explanation. Store the Expo push token server-side associated with the user's session/identity.

Job complete notification: When the API marks a job complete, the server sends a push notification: "Your job is done — Timmy says: [result excerpt]" with a deep link back to the History tab.

Low balance warning: When session balance drops below 500 sats, send a local notification (no server round-trip needed): "⚡ Low session balance — top up to keep working with Timmy".

Backend: Add a push_tokens column to the sessions or identities table. On job completion, call Expo's push API with the stored token.

Acceptance criteria

Notification arrives within 10s of job completion while app is backgrounded
Deep link from notification opens the correct completed job in History tab
Low balance local notification fires correctly
Permission denial is handled gracefully (no crash, feature silently disabled)
Works on both iOS and Android

## Problem Once a user submits a job, they must keep the app open and watch the feed to know when it is complete. There is no background notification. For expensive long-running jobs this is a poor experience. ## What to build **Registration:** On first launch (after onboarding), request Expo push notification permission with a clear explanation. Store the Expo push token server-side associated with the user's session/identity. **Job complete notification:** When the API marks a job complete, the server sends a push notification: "Your job is done — Timmy says: [result excerpt]" with a deep link back to the History tab. **Low balance warning:** When session balance drops below 500 sats, send a local notification (no server round-trip needed): "⚡ Low session balance — top up to keep working with Timmy". **Backend:** Add a `push_tokens` column to the sessions or identities table. On job completion, call Expo's push API with the stored token. ## Acceptance criteria - Notification arrives within 10s of job completion while app is backgrounded - Deep link from notification opens the correct completed job in History tab - Low balance local notification fires correctly - Permission denial is handled gracefully (no crash, feature silently disabled) - Works on both iOS and Android

replit added the backend mobile labels 2026-03-20 22:49:57 +00:00

gemini was assigned by Rockachopa

2026-03-22 23:37:34 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: replit/timmy-tower#30