Mobile applications

SeatLayer offers public React Native, Flutter, iOS, and Android SDK source alongside the production web SDK. React Native is available as @seatlayer/react-native, Flutter as seatlayer, iOS through Swift Package Manager, and native Android as a Kotlin/JitPack public preview.

Choose a mobile surface

Install a native SDK

npm install @seatlayer/react-native react-native-webview

import {
  SeatLayerView,
  useSeatLayerController,
} from "@seatlayer/react-native";

export function SeatMapScreen() {
  const controller = useSeatLayerController();

  return (
    <SeatLayerView
      style={{ flex: 1 }}
      controller={controller}
      configuration={{
        event: "ev_your_event_key",
        currency: "USD",
      }}
      onReady={(info) => console.log("SeatLayer ready", info.mode)}
      onLoadError={(error) => console.error(error.code, error.message)}
    />
  );
}

flutter pub add seatlayer

import "package:seatlayer/seatlayer.dart";

final controller = SeatLayerController();

SizedBox(
  height: 640,
  child: SeatLayerView(
    controller: controller,
    configuration: SeatLayerConfiguration(
      event: "ev_your_event_key",
      currency: "USD",
    ),
    onReady: (info) {
      debugPrint("SeatLayer ready: ${info.mode.raw}");
    },
  ),
);

https://github.com/seatlayer/seatlayer-ios.git

import SeatLayer

let map = SeatLayerView()
map.delegate = self

var configuration = SeatLayerConfiguration(
    event: "ev_your_event_key",
    currency: "USD"
)

let info = try await map.load(configuration)
let hold = try await map.hold()

dependencyResolutionManagement {
    repositories {
        google()
        mavenCentral()
        maven("https://jitpack.io") {
            content {
                includeGroup("com.github.seatlayer")
            }
        }
    }
}

dependencies {
    implementation(
        "com.github.seatlayer:seatlayer-android:v0.1.0",
    )
}

val seatMap = SeatLayerView(this)
setContentView(seatMap)

lifecycleScope.launch {
    seatMap.load(
        SeatLayerConfiguration(
            event = "ev_your_event_key",
            currency = "USD",
        ),
    )
}

Native screen
  └─ owned WebView
       └─ immutable SeatLayer integration page
            ├─ SeatPicker
            ├─ event inventory over HTTPS/realtime
            └─ narrow validated message bridge
                 └─ native checkout / navigation

Shared native contract

The React Native, iOS, Android, and Flutter SDKs use a versioned bridge and intentionally mirror the web SeatingChart contract:

hold, resumeHold, extendHold, release, releaseLabels, bestAvailable, holdGA, setSeatTier, getSelection, getCurrentHold, getGAAreas, getFloors, setFloor, setColorblindSafe, view and zoom methods, and destroy.

Command failures correlate to the awaited native call with structured errors. Unknown future events and enum values are retained as unknown values rather than crashing older applications.

Security boundary

Keep secret-key booking in your backend. A native binary or webview may receive a holdId, but never the secret.

• The app selects and holds; your trusted server inspects and books.
• Calculate payment from server-inspected hold items, not app input.
• Reuse the host order id as bookingRef for retry safety.
• Validate webview bridge source/origin and message schemas.
• Treat hold expiry and inventory conflicts as recoverable buyer states.

Layout and lifecycle requirements

• Give the map a definite height or make it full-screen.
• Do not nest it inside another gesture-driven scroll or zoom surface.
• Preserve the hold id across checkout navigation and app suspension when your product promises restoration.
• Dispose or destroy the SDK with its native screen.
• Test safe areas, rotation, back navigation, keyboards, process suspension, and resume.
• Test 2D fallback when the target environment cannot support optional 3D.

Preview verification checklist

• The dependency resolves from its registry or exact documented release.
• The package version or Git revision is pinned intentionally.
• No secret key exists in the native binary, WebView, or logs.
• A test event renders and receives live inventory.
• Select, hold, checkout, expiry, release, and conflict paths work.
• Gestures do not conflict with parent scrolling.
• iOS and Android physical-device smoke tests pass.
• The backend books with a stable bookingRef.

Explore the live buyer demo, continue with holds and checkout, or give an agent the SeatLayer AI Toolkit.