Skip to main content

First Universal App

This guide gives a clean first-flow for building a Catalyst universal app for Web, iOS, and Android.

Prerequisites​

  • Node.js 20+
  • Android Studio + Android SDK
  • Xcode (for iOS on macOS)

Step 1: Create App​

npx create-catalyst-app@latest my-universal-app
cd my-universal-app
npm install

Step 2: Configure Runtime​

Set host, ports, and webview config in config/config.json.

Configuration reference →

Step 3: Run on Web​

npm run start

Open http://localhost:3005.

Step 4: Prepare Emulators​

Step 5: Run Universal App​

Step 6: Native APIs​

Use hooks from catalyst-core/hooks for platform-native features.

Next​