Latest Release - January 2026

Current versions:

Client SDK (@pushary/sdk): 1.0.5
Server SDK (@pushary/server): 1.0.1
Platform: 1.0.0

Initial public release of Pushary push notification platform.

Features

Client SDK (@pushary/sdk)

Browser push notification support (Chrome, Firefox, Safari, Edge, Opera)
Service worker integration
Auto-prompt and manual permission flow
Subscriber identification with external IDs
Tag-based segmentation
Click and impression tracking
iOS Safari PWA support
Retry queue for offline reliability
Device detection utilities
TypeScript support with full type definitions

Server SDK (@pushary/server)

Complete REST API client for Node.js
Subscriber management (list, get, update, delete, count)
Campaign management (create, update, send, pause, resume, stats)
Template management for reusable notifications
Direct notification sending (by subscriber ID, external ID, or tags)
Flow automation (trigger-based notification sequences)
TypeScript support with full type definitions

Platform Features

Multi-site support with isolated VAPID keys
Team collaboration with role-based access
A/B testing for campaigns (Starter plan and above)
Flow automation with triggers and steps
Analytics dashboard with delivery and engagement metrics
Rate limiting per plan tier
Plan-based feature gating
Subscriber segmentation with tags and filters
Campaign scheduling
Data retention based on plan

Authentication

Two-tier API key system:
- Site Key (pk_xxx) for client-side use
- Full API Key (pk_xxx.sk_xxx) for server-side use
Domain validation for client requests
SHA-256 hashed API key storage
Rate limiting per workspace and plan

Integrations

Shopify integration (via extension)
Webhook support for events
REST API for custom integrations

API Endpoints

Client SDK Endpoints:

POST /api/v1/subscribe - Subscribe to notifications
POST /api/v1/unsubscribe - Unsubscribe from notifications
POST /api/v1/track - Track events
POST /api/v1/identify - Set external ID and tags
POST /api/v1/subscription-change - Update subscription endpoint
GET /api/v1/site/:siteSlug - Get site configuration

Server API Endpoints:

POST /api/v1/server/send - Send notifications directly
GET /api/v1/server/subscribers - List subscribers
GET /api/v1/server/subscribers/:id - Get subscriber
PATCH /api/v1/server/subscribers/:id - Update subscriber
DELETE /api/v1/server/subscribers/:id - Delete subscriber
GET /api/v1/server/subscribers/count - Get subscriber count
GET /api/v1/server/campaigns - List campaigns
POST /api/v1/server/campaigns - Create campaign
GET /api/v1/server/campaigns/:id - Get campaign
PATCH /api/v1/server/campaigns/:id - Update campaign
DELETE /api/v1/server/campaigns/:id - Delete campaign
POST /api/v1/server/campaigns/:id/send - Send campaign
POST /api/v1/server/campaigns/:id/pause - Pause campaign
POST /api/v1/server/campaigns/:id/resume - Resume campaign
GET /api/v1/server/campaigns/:id/stats - Get campaign statistics
GET /api/v1/server/templates - List templates
POST /api/v1/server/templates - Create template
GET /api/v1/server/templates/:id - Get template
PATCH /api/v1/server/templates/:id - Update template
DELETE /api/v1/server/templates/:id - Delete template
GET /api/v1/server/flows - List flows
POST /api/v1/server/flows - Create flow
GET /api/v1/server/flows/:id - Get flow
PATCH /api/v1/server/flows/:id - Update flow
DELETE /api/v1/server/flows/:id - Delete flow
POST /api/v1/server/flows/:id/activate - Activate flow
POST /api/v1/server/flows/:id/pause - Pause flow

Pricing Plans

Free: 100 subscribers, 500 notifications/month
Starter: 5K subscribers, 25K notifications/month - €29/month
Growth: 25K subscribers, 100K notifications/month - €99/month
Enterprise: Unlimited, custom pricing

Known Limitations

Free plan does not have API access (client SDK only)
iOS Safari requires PWA installation (not available in browser tab)
Service worker must be at root path (/pushary-sw.js)
HTTPS required (except localhost for development)
Rate limits vary by plan (100-1000 requests/minute)
Data retention: 7-90 days depending on plan

Migration Guides

For New Users

No migration needed. Follow the Getting Started guide to begin.

Future Migrations

As Pushary evolves, migration guides will be added here for major version updates.

Deprecation Policy

Policy

Breaking changes will be announced at least 90 days in advance
Deprecated features remain functional during deprecation period
Migration guides provided for all breaking changes
Enterprise customers receive dedicated migration support

Current Deprecations

No deprecations at this time.

Breaking Changes

Platform 1.0.0 / SDK 1.0.5 / Server SDK 1.0.1

Initial release - no breaking changes.

SDK Versions

Client SDK (`@pushary/sdk`)

Current: 1.0.5

Compatibility:

Works with Pushary API v1
Supports all modern browsers (see Browser Support)
Service worker compatible with all supported browsers

Server SDK (`@pushary/server`)

Current: 1.0.1

Compatibility:

Node.js 18.0.0 or higher
TypeScript 5.0 or higher (optional)
Works with Pushary API v1

Upcoming Features

We're constantly improving Pushary. Here's what's on the roadmap:

Q1 2026

Advanced segmentation with computed properties
Webhook event stream
Campaign A/B testing enhancements
Custom notification actions
Rich notification templates

Q2 2026

Mobile SDKs (React Native, Flutter)
Advanced analytics dashboard
Predictive send time optimization
Multi-language template support
Workflow builder UI

Q3 2026

AI-powered notification optimization
Advanced automation rules
Custom integrations marketplace
Geo-targeting
Time zone optimization

Future

SMS and email channels
In-app messaging
Push notification previews
Advanced permission prompts
Message scheduling AI

Want to influence the roadmap? Contact us at business@pushary.com

Security Updates

We take security seriously. Security updates are released as needed and communicated via:

Email to all workspace owners
Dashboard notifications
Status page updates

Current Status: All systems operational

API Versioning

Pushary uses URL-based API versioning:

Current: /api/v1/
Future versions will be announced with migration guides

Version Support:

Latest version: Full support
Previous version: Security updates only (12 months)
Older versions: No support

Getting Updates

Stay informed about new features and changes:

Documentation:

This changelog is updated with every release
Breaking changes are highlighted
Migration guides provided when needed

Communication:

Email announcements for major releases
Dashboard notifications for updates
Status page for incidents

Community:

GitHub Discussions (coming soon)
Twitter: @pushary (coming soon)
Discord community (coming soon)

Feedback

Have feedback or feature requests?

Email: business@pushary.com
Dashboard: Send feedback button
Enterprise customers: Contact your account manager

We review all feedback and use it to shape our roadmap.