Testing

Test your widgets and notifications on real devices before going live. This guide covers inviting testers, the testing workflow, and what to look for.

Inviting Testers

1. Navigate to your app → Testers
2. Click Invite Tester
3. Enter the tester's email address
4. They'll receive an email invitation

Tester Status

Status	Meaning
Pending	Invitation sent, not yet accepted
Accepted	Tester has joined and can see test releases

What Testers Need

• The NativeSuite mobile app installed on their device (iOS or Android)
• An account in the NativeSuite app (they sign up with Google or Apple)
• To accept the invitation from within the mobile app

The Testing Flow

1. Build your release — Add widgets and notification templates while in Draft
2. Invite testers — They need to accept before you start testing
3. Move to Testing — Click "Start Testing" on the release
4. Testers open the app — They'll see your app and its test release
5. Add widgets to home screen — Testers can pin widgets just like live users
6. Send test notifications — Use the API to trigger notifications to testers
7. Gather feedback — Ask testers to verify data accuracy, layout, and timing

What to Test

Widgets

• [ ] Data loads correctly from your API
• [ ] All widget sizes render properly (compact, standard, expanded)
• [ ] Field mapping shows the right values
• [ ] Visibility conditions work (widgets show/hide based on data)
• [ ] Layout looks good on different device sizes
• [ ] Widget refreshes with updated data

Notifications

• [ ] Notifications arrive on the device
• [ ] Title and body render correctly with variables filled in
• [ ] Notifications appear on the lock screen and notification center

Authentication

• [ ] Users can authenticate with your chosen method
• [ ] Authenticated data loads correctly (user-specific content)
• [ ] Token expiry is handled gracefully

Pulling Back to Draft

If testing reveals issues:

1. Click Pull Back on the release detail page
2. The release returns to Draft status
3. Make your fixes
4. Move back to Testing when ready

Removing Testers

If you need to remove a tester:

1. Go to Testers
2. Click the remove button next to their name
3. They'll immediately lose access to test releases

Tips

• Test with yourself first — Invite your own email as the first tester
• Test on both iOS and Android — Widget rendering differs between platforms
• Test with real data — Mock data hides edge cases (long strings, empty values, special characters)
• Test authentication flows end-to-end — Make sure users can actually connect and see personalized data