CapsulBETA
Start Building

Deployment

Capsul Mobile App

The Capsul Android & iOS app lets you run any of your deployed Capsul apps natively on mobile — with full CapsulDB database access, QR scanning, deep links, and pinned shortcuts. Think of it as the Microsoft Power Apps mobile experience, but for your AI-built Capsul apps.

Features

📱

Native WebView

Apps run inside a high-performance native WebView with full JavaScript, CapsulDB, and CapsulAI support.

🔢

App Code

Enter the 10-character app ID from the web builder to instantly open any app — no URL needed.

📷

QR Scanner

Scan the QR code from the builder's "Open on Mobile" dialog to launch apps in one tap.

🔗

Deep Links

Tap capsul:// links or https://capsul.app/open?code=... links to open apps directly from any message or browser.

📌

Pin Apps

Long-press any app to pin it to a quick-access grid at the top of the home screen.

🕐

Recent Apps

The last 20 apps you opened are tracked and shown for instant re-access.

🌗

Dark Mode

Fully themed Material 3 UI that follows the system light/dark preference.

⛶

Fullscreen

Tap the fullscreen icon to hide the app bar for an immersive, app-like experience.

Opening apps on mobile

There are three ways to open a Capsul app on mobile:

1. QR Code (fastest)

  1. Open your app in the Builder
  2. Click the 📱 phone icon in the toolbar
  3. A QR code appears in the "Open on Mobile" dialog
  4. Open the Capsul app on your phone and scan it

2. App Code

Every app has a unique code (its ID) visible in the "Open on Mobile" dialog. In the Capsul mobile app, tap Enter Code, type the code, and tap Open.

AB12CD3456

3. Deep Link

Share the link and anyone with the Capsul app installed can open it directly:

capsul://app/APP_ID
https://capsul.app/open?code=APP_ID

Setting up the mobile app

  1. 1Download the Capsul mobile app (APK or App Store — link will be available after launch).
  2. 2On first launch, enter your Capsul server URL (e.g. https://your-server.com).
  3. 3Optionally add your Firebase auth token (from Settings → Account) to sync your private apps.
  4. 4All your deployed public apps will appear automatically. Tap any to run it.

Build it yourself

The mobile app is open-source and lives in the mobile/ folder of the Capsul repository. It is built with Flutter and targets Android and iOS.

# Clone and enter the mobile app
cd mobile

# Install dependencies
flutter pub get

# Run on connected device/emulator
flutter run

# Build release APK
flutter build apk --release

See mobile/README.md for full build and signing instructions.

Server requirements

The mobile app uses two API endpoints. These are included in all Capsul server versions from March 2026 onward:

GET /api/apps

Returns all apps for the authenticated user. Now includes userId in each app object.

GET /api/apps/by-code/:code

Public endpoint. Resolves a public app by ID. Used by the app code look-up and QR scanner.

← Self-Hosting GuideFAQ →