Installing your iOS app

Learn how to install your Floot iOS app

Floot can automatically convert your Floot website into a native iOS app. Here's how to install your app on your iPhone or simulator.

Prerequisites

• A Mac computer running macOS

• Xcode installed (free from the Mac App Store)

Getting your iOS app

1

Navigate to the Mobile tab

1. Open your Floot project and click the Publish button

2. Switch to the Mobile tab in the publish modal

3. Make sure Build mobile apps is enabled

4. Click Publish & Generate to create your mobile apps

2

Download the iOS project

1. Go to the mobile tab and select iOS

2. Click the Download button

3. Wait for the ZIP file to download to your Mac

4. Unzip the downloaded file

3

Install NodeJS, then run the follow command in the downloaded folder

npm install -g pnpm
pnpm install

4

Open the project in Xcode

1. Navigate to the unzipped folder

2. Go to folder: ios/App

3. Double-click App.xcodeproj to open it in Xcode

Make sure you have Xcode installed. If you don't, download it from the Mac App Store.

Running app in the iOS Simulator

1. At the top of Xcode, find the device selector dropdown (next to the app name)

2. Click it and select a simulator device (e.g., "iPhone 17 Pro")

3. Click the ▶ Play button (or press ⌘ + R) to build and run your app

4. The iOS Simulator will launch with your app running

Installing app on real iPhone

To install your app on a real iPhone:

1. Connect your iPhone to your Mac via USB

2. In Xcode, select your iPhone from the device dropdown

3. You'll need to configure code signing (requires an Apple Developer account)

4. Click ▶ Play to install and run on your device

Troubleshooting

"No provisioning profiles found"

This happens when trying to run on a physical device. You'll need to set up code signing in Xcode under Signing & Capabilities.

"Build failed" errors

Try cleaning the build folder: In Xcode, go to Product → Clean Build Folder (or press ⌘ + Shift + K), then try building again.

Simulator not appearing

Make sure you have iOS simulators installed. In Xcode, go to Xcode → Preferences → Components to download simulators.

Publishing to the App Store

To publish your iOS app to the Apple App Store:

1. Create an Apple Developer Account: Enroll in the Apple Developer Program ($99 per year).

2. Follow the instruction above to make sure you can install the app on your iPhone

3. Upload to App Store Connect: Go to product -> Archive, then click Distribute app. Head to http://appstoreconnect.apple.com and fill in the required information to submit your app for a review

For detailed instructions, see Apple's publishing guide

Please note that Floot does not support App Store submissions or reviews. You will need the respective app store accounts to publish to those app stores and should contact them for any publishing support needs.