push

Send push notifications to loyalty-app recipients via Web Push and Expo Push.

Updated May 7, 2026
One-click install
npx skills add https://github.com/johinsDev/loyalty-app --skill push-johinsdev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: push
Source: https://github.com/johinsDev/loyalty-app/tree/main/.claude/skills/push
Command: npx skills add https://github.com/johinsDev/loyalty-app --skill push-johinsdev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the operational complexity of sending notifications across different push ecosystems by providing one provider-agnostic interface for both browser Web Push (VAPID + Service Worker) and Expo Push.

Core Features & Use Cases

  • Unified push abstraction: Send the same logical notification to both web PWA and future native Expo recipients, selected per stored token platform.
  • Token registration + outbox workflow: Register device tokens via tRPC, inspect queued sends in the push outbox, and manage delivery status for debugging and testing.
  • Service-worker delivery for web: Receive push payloads in the Service Worker and render notifications and click-through navigation consistently.

Use case example: When a customer earns a stamp or is eligible for a redemption, use push to notify them on their phone (Expo) and/or PWA device (Web Push) with correct titles, bodies, metadata, and click actions.

Quick Start

Use the push.send API to send a stamp-earned message to a customer, ensuring the browser or token platform has been registered first.

Frequently Asked Questions about push

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I send web push notifications to a PWA using a service worker?

Web push notifications are delivered through a VAPID-authenticated service worker that receives payloads and renders browser notifications with titles, bodies, and click actions. A provider-agnostic interface manages this process.

Can I use Expo push notifications and web push in the same loyalty app?

Yes, a unified push abstraction sends Expo push and web push through one interface. The system selects the correct provider per stored device token platform, routing the same logical notification to web PWA and Expo recipients.

How do I register device tokens for push notifications and track delivery?

Register device tokens via tRPC and inspect queued sends in a push outbox. This workflow manages delivery status, debugs queued notifications, and asserts delivery outcomes during automated testing.

What is the best way to test push notification delivery in automated tests?

Use a configured runtime mode such as log or outbox to assert push delivery without hitting real providers. This ensures reliable delivery assertions within automated test environments.

Does this push notification system support transport switching by environment?

Yes, provider selection supports transport switching by environment using a configured runtime mode. Select between log, outbox, webpush, expo, or auto modes to control how push notifications are dispatched.