Notifications
OneSignal Integration
Push Notifications Setup
AppMintAppwrightBoth builders - the steps below are the same in each.
1Create OneSignal Account#
Sign up for a free OneSignal account to get started with push notifications. OneSignal provides unlimited push notifications for free.
2Create New App#
In OneSignal dashboard:
- Click 'New App/Website'
- Enter your app name
- Select 'Google Android (FCM)' as platform
- Click 'Next'
3Create Firebase Project#
You need a Firebase project for OneSignal to work. Go to Firebase Console and create a new project or use an existing one.
In Appwright
4Add Android App to Firebase#
In your Firebase project:
- Click 'Add App' and select Android
- Enter your app's package name (MUST match the package name you set in the generator)
- Download 'google-services.json' file
- ⚠️ IMPORTANT: This is the file you will upload to Appwright later.
- Click 'Continue' and finish setup
In AppMint
4Add Android App to Firebase#
In your Firebase project:
- Click 'Add App' and select Android
- Enter your app's package name (MUST match the package name you set in the generator)
- Download 'google-services.json' file
- ⚠️ IMPORTANT: This is the file you will upload to the Web2APK Generator later.
- Click 'Continue' and finish setup
In Appwright
5Create Firebase Service Account Key#
OneSignal requires a Firebase Service Account JSON to send notifications from their server.
In Firebase Console:
- Go to Project Settings > Service accounts tab
- Click 'Generate new private key'
- Confirm and download the JSON file
⚠️ WARNING: This file is ONLY for the OneSignal Dashboard. Do NOT upload this file to Appwright.
In AppMint
5Create Firebase Service Account Key#
OneSignal requires a Firebase Service Account JSON to send notifications from their server.
In Firebase Console:
- Go to Project Settings > Service accounts tab
- Click 'Generate new private key'
- Confirm and download the JSON file
⚠️ WARNING: This file is ONLY for the OneSignal Dashboard. Do NOT upload this file to the Web2APK generator.
6Configure OneSignal with Service Account#
Back in OneSignal dashboard setup:
- When asked for Firebase credentials, choose 'Upload Service Account File'
- Upload the Service Account JSON you downloaded from Firebase
- Click 'Save & Continue'
- Copy your OneSignal App ID (you'll need this in the generator)
In Appwright
7Setup in Appwright#
In the generator app:
- Enable 'OneSignal' toggle in Step 3
- Click 'Upload google-services.json' button
- Select the 'google-services.json' file (the one from Step 4)
⚠️ DO NOT upload the Service Account key from Step 5 here!
- Paste your OneSignal App ID
- Generate your APK
OneSignal App ID format:
12345678-1234-1234-1234-123456789012In AppMint
7Setup in Web2APK Generator#
In the generator app:
- Enable 'OneSignal' toggle in Step 3
- Click 'Upload google-services.json' button
- Select the 'google-services.json' file (the one from Step 4)
⚠️ DO NOT upload the Service Account key from Step 5 here!
- Paste your OneSignal App ID
- Generate your APK
OneSignal App ID format:
12345678-1234-1234-1234-1234567890128Test Push Notifications#
After installing your generated APK:
- Open the app on your device
- Go to OneSignal dashboard
- Navigate to 'Messages' > 'New Push'
- Compose and send a test notification
- You should receive it on your device within seconds
9Important Notes#
⚠️ Package Name: The package name in Firebase MUST exactly match your app's package name
⚠️ File Upload: Always upload google-services.json when using OneSignal, otherwise notifications won't work
⚠️ First Launch: Users must open the app at least once to receive notifications
✅ Free Forever: OneSignal is 100% free with unlimited notifications