AI Coding Guides
Standalone markdown files you can drop into your project so AI coding assistants can generate accurate SmartAppPush integration code. Each guide contains the complete context — endpoints, request/response formats, platform-specific code examples, and common pitfalls.
Designed for Popular AI Coding Tools
These guides are plain markdown files that work with Cursor, Claude Code, GitHub Copilot, Windsurf, and other AI coding assistants that support project-level context files.
How to Use
- Download the guide that matches your setup (provider + integration layer)
- Place the
.mdfile in your project root or wherever your AI tool reads context - Reference the file when asking your AI tool to implement SmartAppPush integration
Tip
Most AI coding tools automatically pick up markdown files in your project root. In Cursor, you can also add it as a @doc reference. In Claude Code, mention the file by name in your prompt.
Choose Your Guide
Pick the guide that matches your integration layer (mobile app or backend server) and your push delivery provider (Firebase Cloud Messaging or OneSignal).
Mobile Integration
For your iOS or Android app. Covers event tracking, push open reporting, notification payload handling, and device-specific setup.
Firebase Cloud Messaging (FCM)
Event tracking, push open reporting, device token refresh, data-only message handling
smartapppush-mobile-fcm-integration.md~31 KBOneSignal
Event tracking, push open reporting, OneSignal SDK notification handling
smartapppush-mobile-onesignal-integration.md~25 KBServer Integration
For your backend. Covers the Developer Push API for sending transactional and real-time notifications from your server.
Firebase Cloud Messaging (FCM)
Developer Push API, scheduling, deduplication, priority, FCM delivery details
smartapppush-server-fcm-integration.md~10 KBOneSignal
Developer Push API, scheduling, deduplication, priority, OneSignal delivery details
smartapppush-server-onesignal-integration.md~10 KBWhat's Inside
Each guide is a self-contained reference. Here's what they cover:
| Section | Mobile Guides | Server Guides |
|---|---|---|
| Configuration | tenant_id, api_key setup | server_key setup |
| Event Tracking | Full endpoint, field reference, cURL examples | — |
| Push Open Tracking | Endpoint, payload extraction, pseudo-code | — |
| Notification Payload | Incoming payload structure and parsing | How extra_data is delivered |
| Device Token Refresh | FCM token rotation handling (FCM guide only) | — |
| Developer Push API | — | Endpoint, scheduling, deduplication, priority |
| Platform Examples | Android (Kotlin) + iOS (Swift) | cURL examples |
| Do / Don't Rules | Platform-specific best practices | Server-specific best practices |
| System Events | Full event name reference with params | — |
Which Guide Do I Need?
Working on the mobile app codebase? Pick a Mobile guide. Working on the backend that sends pushes? Pick a Server guide. Using both layers? Download one of each.