Prerequisites

• A Despia account

• An Apple Developer account

• Your web application ready for mobile deployment

Initial Setup

1. Install the Despia Package (Only if using Toddle)

   • Go to your project's packages section

   • Search for "despia"

   • Install the latest version

   • Keep the package updated for new features

If you use VueJS, React, WeWeb or any other framework - you can use Despia’s Native SDK, no installation needed.

1. Create a New Despia App

   • Navigate to the Despia interface

   • Click "Create New Application"

   • Enter your app name

   • Set your bundle ID (this is unique and permanent)

Configuring Your App

Essential Settings

1. App Icon

   • Upload a 1024x1024 icon

   • Format must be PNG

2. Splash Screen

   • Upload a GIF file

   • Transparent background recommended

   • Customize background color in settings

3. Theme Settings

   • Configure light/dark mode colors

   • Set background colors

   • Configure text colors for both modes

Device Settings

1. View Configuration

   • iPad: Choose between Portrait, Landscape, or Auto

   • Mobile: Portrait enforcement recommended

   • Set orientation preferences

2. Additional Settings

   • Force Prevent Sleep (optional)

   • Pull to Refresh

   • App Feedback Collection

   • Swipe Navigation

   • Screen Zooming Prevention

Testing Your App

Development Testing

1. Export the source code using "Export Code"

   • Get full Xcode project (2000+ files)

   • Test on simulator or device

   • Make real-time updates

Live Updates

• Changes made in your web app reflect immediately

• No need to rebuild for content updates

• Native functionality remains intact

Publishing to TestFlight

1. Register Bundle ID

   • Go to Apple Developer Portal

   • Create new App ID

   • Configure capabilities (Push Notifications, etc.)

   • Create App Group for notifications

2. App Store Connect Setup

   • Create new app

   • Enter basic information

   • Set bundle ID

   • Configure internal testing team

3. Auto Publish Setup

   • Configure Apple API integration

   • Set up development team

   • Add App Store app ID

   • Configure API keys

Publishing to the App Store

1. Prepare Submission

   • Select build version

   • Add app description

   • Include privacy policy

   • Upload screenshots

   • Add marketing material

2. Submit for Review

   • Ensure app meets minimum functionality requirements

   • Submit for Apple review

   • Monitor status in App Store Connect

Best Practices

1. Branch Management

   • Use main branch for production

   • Test on development branches

   • Update main branch before publishing

2. Native Functionality

   • Test all native features thoroughly

   • Use appropriate delays for multiple native actions

   • Implement proper error handling

3. Performance

   • Optimize for server-side rendering

   • Test on various devices

   • Monitor app size and loading times

4. Updates

   • Regular content updates don't require new builds

   • Native functionality changes need new submissions

   • Keep Despia package updated

Note: Need help? Use Despia's 24/7 support chat for assistance with any part of the publishing process, or email use at support@despia.com