App Deployment
Natively handles the entire app deployment process, from building your app to submitting it to the App Store and Play Store.Deployment Options
APK (Android)
Android installable file for testing and side-loading
AAB (Android)
Android App Bundle for Google Play Store submission
iOS Build
iOS build for App Store submission
Backend Deploy
Push backend changes to production
Building for Android
APK Build (Testing)
APK files let you install your app directly on Android devices:APKs can be shared with testers directly without going through the Play Store.
AAB Build (Play Store)
For Google Play Store submission:Building for iOS
iOS builds require an Apple Developer Account ($99/year):Apple Developer Account
Ensure you have an active Apple Developer Account
Enter Credentials
Provide your Apple Developer credentials:
- Apple ID
- App-specific password (generate in Apple ID settings)
Creating App-Specific Password
For iOS builds, you need an app-specific password:- Go to appleid.apple.com
- Sign in with your Apple ID
- Navigate to Security → App-Specific Passwords
- Click “Generate Password”
- Name it “Natively” and save the generated password
App Configuration
Before building, configure your app settings:App Name & Icon
- In Natively
- Via AI
- Click More → Project Settings
- Update app name
- Upload app icon (1024x1024 recommended)
App Icon Requirements
| Platform | Size | Format |
|---|---|---|
| iOS | 1024x1024 | PNG, no transparency |
| Android | 512x512 | PNG, with or without transparency |
Backend Deployment
If your app uses Specular backend:GitHub Integration
Connect GitHub for automatic code sync:- Click More → GitHub in the burger menu
- Authorize Natively to access GitHub
- Create a new repository or select existing
- Code syncs on each commit
- Full version control
- Collaborate with other developers
- Deploy to custom infrastructure
- Code backup and portability
GitHub Integration
Learn more about GitHub setup
Testing Before Submission
Before submitting to app stores:Test on Real Devices
Test on Real Devices
- Download APK and test on Android phone
- Use TestFlight for iOS testing
- Try different screen sizes
Check All Features
Check All Features
- Test authentication flows
- Verify data persistence
- Check offline behavior
- Test payments (if applicable)
Review App Store Guidelines
Review App Store Guidelines
App Store Submission Tips
Apple App Store
- Screenshots: Required for each device size
- Description: Clear, accurate app description
- Privacy Policy: Required for all apps
- Age Rating: Answer questionnaire accurately
- Review Notes: Provide demo account if login required
Google Play Store
- Screenshots: At least 2, up to 8
- Feature Graphic: 1024x500 banner image
- Privacy Policy: Link required
- Content Rating: Complete questionnaire
- Target Audience: Specify correctly
Troubleshooting Builds
Build Fails
iOS Build Errors
iOS Build Errors
- Verify Apple ID and password are correct
- Check app-specific password is valid
- Ensure bundle ID is unique
- Review build logs for specific errors
Android Build Errors
Android Build Errors
- Check package name format
- Verify version code is higher than previous
- Review Gradle/dependency errors in logs
Generic Errors
Generic Errors
- Try building again (transient issues)
- Clear build cache if available
- Contact support via Discord
App Rejection
If your app is rejected from stores:- Read the rejection reason carefully
- Ask AI to help fix the issue
- Rebuild and resubmit
- Respond to reviewer if needed
- Crashes or bugs
- Incomplete functionality
- Misleading metadata
- Privacy policy issues
- Guideline violations