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

Install homebrew if you don't already have it installed

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

5

Install CocoaPods if you don't already have it installed

brew install cocoapods

6

Install the native dependencies

cd ios/App
pod install --repo-update

7

Open the project in Xcode

1. Navigate to the unzipped folder

2. Go to folder: ios/App

3. Double-click App.xcworkspace 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

If you make any changes, click ▶ Play again to refresh the installed app.

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. If your app requires push notifications: You need to set up the push notification capabilities

   1. Click on the App target on the left side pane

   2. Click on App under TARGETS

   3. Click on the Signing & Capabilities tab

   4. Click on + Capability

   5. Search for "Push Notifications" and add that

4. 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

Updating your app on the App Store

After your app has been accepted on the App Store and you want to push an update:

1. Update your Floot project with your changes and publish them

2. Download the updated iOS project from Floot (same steps as initial setup)

3. Increment the version number:

   • Open the project in Xcode and select your app target

   • Go to the General tab

   • Increase Build number by 1 (e.g., from 1 to 2)

   • Update Version to reflect your new version (e.g., from 1.0.0 to 1.1.0)

4. Then follow the same steps above for submitting to the App Store.

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.