Getting Started

Start by creating your first hybrid mobile app

Despia transforms your web application into a truly native mobile app with just a few clicks. Our platform lets you keep your existing web codebase while gaining access to native device features through our runtime bridge.

How Despia Works

┌────────────────────────────────────────────────┐
│                 YOUR WEB APP                   │
│                                                │
│       ┌────────────────────────────────┐       │
│       │        DESPIA JS SDK           │       │
└───────┴──────────────┬─────────────────┴───────┘
                       │
                       ▼
┌────────────────────────────────────────────────┐
│                RUNTIME BRIDGE                  │
│      JavaScript ◄───────────► Swift/Kotlin     │
└──────────────────────┬─────────────────────────┘
                       │
                       ▼
┌────────────────────────────────────────────────┐
│                  NATIVE CORE                   │
│                                                │
│   ┌──────────────────┐  ┌──────────────────┐   │
│   │       iOS        │  │     Android      │   │
│   │      Swift       │  │     Kotlin       │   │
│   └──────────────────┘  └──────────────────┘   │
└────────────────────────────────────────────────┘

The Despia Runtime Bridge connects your JavaScript code to native device capabilities without requiring any npm libraries or dependencies. Our SDK is included directly in the Swift/Kotlin code that Despia compiles.

First Steps

1. Create a New Project

  1. Log in to your Despia dashboard

  2. Click "Create New Project"

  3. Enter your project name and details

  4. Choose your app icon or upload a custom one

2. Connect Your Web Application

  1. Enter your web app URL (production)

  2. Configure viewport settings and initial orientation

3. Customize Your App

  1. Adjust the appearance (statusbar color, splash screen, etc.)

  2. Configure device permissions and settings

Using Native Features

Accessing native functionality is easy with our protocol handler system. All native features are available through the global window.despia object:

// Simple example: Save to camera roll
const image = "https://example.com/cdn/image.png"
window.despia = `savethisimage://?url=${image}`

There's no need to install any libraries - the Despia runtime automatically intercepts these protocol calls and routes them to the appropriate native functionality. You can simply add those protocol calls into your web app code and after your app was compiled by the Despia platform it will have all native functionality.

Testing Your App

  1. One Click Publish to TestFlight / Android Beta (iOS Guide | Android Guide)

  2. Try on your own device

Publishing Your App

When you're ready to publish:

  1. Connect your developer accounts (Apple/Google)

  2. One Click Publish to TestFlight / Android Beta (iOS Guide | Android Guide)

  3. Publish from app stores

Need Help?

Updated on
Project Creation