Getting started

Choose the fastest target for your work: browser preview for interface iteration, Android for the React Native native bridge, or native iOS for SwiftUI and local Apple/Gemma runtimes.

Requirements

Tool	Requirement
Node.js	`>= 22.11.0` with npm
Android	OpenJDK 17, Android Studio, Android SDK, and a device or emulator
iOS	macOS, full Xcode, CocoaPods, and a compatible simulator or device
Native model testing	iOS 26.2 or newer for current Apple Foundation Models and Gemma runtime work

Install

git clone https://github.com/open-edge-ai-app/core-app.git
cd core-app
npm install

Run the browser preview

npm run web

The Vite web target is designed for rapid UI development. Native AI calls use safe development fallbacks because browser code cannot load the Android or iOS runtimes.

Run Android

npm run start:android
npm run android

The Android workflow uses Metro port 8082, applies the matching adb reverse, installs the debug build, and starts the app activity.

If another process owns port 8081, keep using the repository's 8082 scripts. They exist specifically to avoid loading the wrong bundle.

Run native iOS

npm run ios:pods
npm run ios

The iOS app boots from a native SwiftUI shell and does not require Metro. The helper installs Pods when needed, builds the workspace, installs the app, and launches it on a simulator.

Build installable development artifacts

npm run build:installers

# Platform-specific alternatives
npm run build:android:apk
npm run build:ios:simulator

Generated files are written under dist/installers/ and are intentionally ignored by Git. Signed iPhone distribution requires Apple signing credentials and a proper archive export.

Run quality checks

npm run lint
npx tsc --noEmit
npm test -- --runInBand