Skip to main content

Building For iOS

Use the iOS target when the shared Hosanna app needs to run on iPhone or iPad. The app can reuse shared TypeScript screens, AppConfig, fragments, networking, and business logic while iOS handles native packaging, signing, lifecycle, and device integration.

Prerequisites​

  • macOS with Xcode installed.
  • iOS simulator or physical iPhone/iPad.
  • Access to the licensed Hosanna framework sources and tooling for the project.
  • Apple signing credentials, bundle identifiers, and provisioning profiles.
  • The project dependencies installed with npm install.

Build And Run​

  1. Generate Hosanna structs and project metadata if your project does not do this automatically: 
    npm run generate
  2. Open the iOS native project from the platform folder.
  3. Select an iOS simulator or physical device.
  4. Build and run from Xcode or the configured launch target.

Debugging​

  • Use Web for fast shared UI and data-flow iteration.
  • Use Xcode for native logs, signing, lifecycle, memory, and device issues.
  • Validate touch input, text input, safe areas, orientation, accessibility settings, networking, and app resume.

See iOS for platform-specific runtime notes.