Support & Quick Start Guide
Need help configuring your Firebase project, importing your credentials, or scheduling background push alerts in Push Studio? Follow the 5-step guide below or check the troubleshooting tips.
- Open the Firebase Console on your Mac, PC, or iPhone browser and select your project.
- Click the Gear Icon (⚙️) next to Project Overview and choose Project settings.
- Navigate to the Service accounts tab and tap Generate new private key (confirm by clicking Generate key).
-
Save the downloaded
.jsonfile to iCloud Drive or your iPhone’s Files app, open Push Studio, and tap Import service-account.json. -
Enter your title, message, and topic (e.g.,
all). Tap Send Push Notification for instant delivery, or toggle Schedule for Later to pick a future date and time!
Frequently Asked Questions
⏰ How does “Schedule for Later” work without an external server?
Push Studio uses native iOS Background URLSession tasks (nsurlsessiond). When you schedule a push, your iPhone queues the signed request at the OS level and transmits it automatically at the scheduled time—even if your iPhone is locked or you are using other apps. Just avoid force-closing (swiping up) Push Studio from the iOS App Switcher while a push is queued.
📋 Can I cancel or send a scheduled notification early?
Yes! All pending alerts appear in the 4. Background Queue section on the main screen. From there, you can tap Send Now to broadcast a scheduled alert immediately, or tap the Trash icon to cancel it before it goes out.
⚠️ Why did I get an HTTP 403 or “Permission Denied” error?
Make sure the Firebase Cloud Messaging API (V1) is enabled in your Google Cloud Console for that project, and that the service account you generated has the Firebase Admin SDK Administrator Service Agent (or Firebase Cloud Messaging Admin) role.
📱 Notifications work on Android, but iOS users aren’t receiving them. Why?
Ensure you have uploaded your Apple Push Notification service (APNs Authentication Key .p8) inside
Firebase Console → Project Settings → Cloud Messaging → Apple app configuration, and that your iOS app subscribes to the exact topic name you are targeting (e.g., all).
🔐 Is it safe to import my service-account.json file?
Yes, 100%. Push Studio operates with zero backend servers. Your JSON file is stored strictly in your iPhone’s local sandbox, and RS256 JWT tokens are signed directly on your device before talking straight to Google’s official APIs. Read more on our Privacy Policy.
🔄 How do I switch between multiple Firebase apps & why is it free?
You can import as many service-account.json files as you like and switch between projects with a single tap at the top of the screen.
Because all cryptographic signing runs locally on your iPhone, we have zero server hosting costs—making Push Studio 100% free Indie Donationware.
Still Need Help or Have a Feature Request?
Found a bug, need help with a specific FCM payload, or want to suggest a new feature for the next SwiftUI update? Send a message directly to the developer.
✉️ Email Developer Support