Skip to main content
Transform your Kleap web app into a native mobile app using Capacitor.

What is Capacitor?

Capacitor is a framework that wraps your web app in a native container, allowing it to run as a mobile app on iOS and Android. Benefits:
  • One codebase - Your existing Kleap app
  • Native features - Camera, push notifications, etc.
  • App store distribution - Publish to App Store and Play Store

Requirements

To build mobile apps, you’ll need:
  • macOS - Required for iOS builds
  • Xcode - For iOS (free from App Store)
  • Android Studio - For Android
  • Your exported code - From GitHub or ZIP download

Getting Started

1. Export Your App

First, get your code locally:
  1. Push to GitHub
  2. Clone the repository

2. Install Capacitor

Follow the prompts:
  • App name: Your app’s name
  • App ID: com.yourcompany.yourapp

3. Build Your Web App

4. Add Platforms

5. Sync Changes

After any code changes:

iOS Development

Open in Xcode

Configure

  1. Select your team in Xcode
  2. Set bundle identifier
  3. Configure app icons

Run on Simulator

  1. Select simulator in Xcode
  2. Click Run (▶️)

Run on Device

  1. Connect your iPhone
  2. Trust the developer certificate
  3. Select device and Run

Android Development

Open in Android Studio

Configure

  1. Wait for Gradle sync
  2. Set application ID in build.gradle
  3. Configure app icons

Run on Emulator

  1. Create virtual device in AVD Manager
  2. Click Run (▶️)

Run on Device

  1. Enable Developer Mode on Android phone
  2. Enable USB debugging
  3. Connect via USB
  4. Select device and Run

Native Features

Camera

Push Notifications

Geolocation

Storage

App Store Submission

iOS App Store

  1. Apple Developer Account - $99/year
  2. Build Archive - Product → Archive in Xcode
  3. App Store Connect - Create app listing
  4. Upload - Via Xcode or Transporter
  5. Submit for Review - Usually 24-48 hours

Google Play Store

  1. Google Play Developer Account - $25 one-time
  2. Build APK/Bundle - Build → Generate Signed Bundle
  3. Play Console - Create app listing
  4. Upload - Upload AAB file
  5. Submit for Review - Usually few hours

Configuration Tips

Splash Screen

Status Bar

Safe Areas

Handle notches and home indicators:

Common Issues

  • Check console for errors
  • Verify build completed successfully
  • Check capacitor.config.ts webDir matches output
  • Run npx cap sync after changes
  • Check permissions in platform config
  • Verify plugin is installed
  • Read rejection reason carefully
  • Common: missing privacy policy, incomplete metadata
  • iOS: ensure proper permissions explanations

PWA Alternative

If native apps are too complex, consider a PWA:
PWAs can be installed on phones without app stores, though with some limitations.

Resources

Self Hosting

Deploy your web app to custom infrastructure