Setup Guide

From Zero to First Push in 4 Steps

This walkthrough is designed for unregistered and newly registered teams evaluating rollout speed and operational safety.

Prerequisites

  • HTTPS-enabled customer domain.
  • Campaign in ACTIVE state.
  • VAPID keys configured in staging environment.
  • Worker + public service healthy in observability dashboards.
Step 1

Verify Customer Domain

In Domains, issue a verification challenge and complete DNS TXT or .well-known verification before collecting subscribers.

Path: /domains
Step 2

Install Snippet + push-sw.js

Create a campaign, copy the loader snippet into your site, and host /push-sw.js on the same origin where permission will be requested.

Path: /campaigns -> Open campaign
Step 3

Send a Test Push

Use the campaign send panel with title/body/target URL. Delivery fanout runs through worker queues with retry and invalid endpoint handling.

Path: /campaign?id=<campaignId>
Step 4

Validate CTR + Geo

Open the redirect link from a delivered push and confirm sent, clicks, CTR, and location/time analytics update in the dashboard.

Path: /campaign?id=<campaignId> -> Analytics