1. Install Xcode ↗

2. Install Android Studio ↗

3. Install Homebrew ↗

4. Once Homebrew has been setup, install Skip by running the Terminal commands:

   brew install skip

   This will download and install the skip tool itself, along with the Android SDK and gradle build tool that is necessary for building and running the Android side of your apps.

5. You can ensure that the basic development prerequisites are satisfied by running:

   skip checkup

   [✓] Skip version 1.7.0 (= 1.7.0)
   [✓] macOS version 15.7.2 (> 13.5.0)
   [✓] macOS architecture: ARM
   [✓] Swift version 6.2.3 (> 5.9.0)
   [✓] Swiftly version 1.0.1 (> 1.0.0)
   [✓] Xcode version 26.2 (> 15.0.0)
   [✓] Xcode tools SDKs: 5
   [✓] Homebrew version 5.0.9 (> 4.1.0)
   [✓] Gradle version 9.2.1 (> 8.6.0)
   [✓] Java version 25.0.1 (> 17.0.0)
   [✓] Android Debug Bridge version 1.0.41 (> 1.0.40)
   [✓] Resolve dependencies (10.43s)
   [✓] Build hello-skip (56.08s)
   [✓] Test Swift (15.43s)
   [✓] Test Kotlin (26.19s)
   [✓] Check project schemes (5.65s)
   [✓] Archive iOS ipa (13.13s)
   [✓] Assemble HelloSkip-debug.ipa 175 KB
   [✓] Verifying HelloSkip-debug.ipa: 175 KB
   [✓] Assembling Android apk (61.1s)
   [✓] Verify HelloSkip-debug.apk: 80 MB
   [✓] Check Skip Updates: 1.7.0
   [✓] Skip checkup succeeded in 190.21s

   If the installation or checkup fails, try running again with skip checkup --verbose to get more details, and check the FAQ for common solutions or reach out to the community on Slack or the Discussion Forums ↗.

6. Create a new Skip app project with:

   skip create

   You will be guided through a series of questions about the app you want to create. The two key choices are:

   1. App or Library? The App option creates a single Swift and SwiftUI app that uses Skip’s Xcode plugin to automatically build for Android. The Library option creates a Swift library that you can use in a unified Skip app, or use as shared business logic in separate iOS and Android apps. Both options allow you to use a combination of Swift and Kotlin, SwiftUI and Compose in your final application.
   2. Skip Fuse or Skip Lite? Information about the different modes can be found in the Native and Transpiled Modes documentation. In this example, we create a Skip Fuse app, which uses the official Swift SDK for Android ↗.

   If you’re new to Skip, we recommend starting your exploration with an App project. An example session for creating a hello-skip/HelloSkip project (which generates a project identical to the minimal Skip Fuse sample app ↗ or Skip Lite sample app ↗) might look like:

   $ skip create
   
   Welcome to Skip!
   
   Select type of project to create:
     1: App: mobile application for Android and iOS
     2: Library: library project with one or more modules
   Enter selection (default: App) [1..2] 1
   
   Select the mode of the project:
     1: Skip Fuse: natively compiled project
     2: Skip Lite: transpiled project
   Enter selection [1..2] 1
   
   Enter the project-name for the App: hello-skip
   
   Enter the CamelCase name of the App module: HelloSkip
   
   Optionally enter additional module names:
   
   Enter the app bundle identifier: com.example.HelloSkip
   
   Create a free open-source project? (y/n) [n]: n
   Initialize git repository for the project? (y/n) [n]: n
   Initialize a Fastlane configuration for the project? (y/n) [y]: y
   Pre-build the project? (y/n) [y]: y
   Install the Swift Android SDK? (y/n) [y]: y
   Open the Xcode project after initialization? (y/n) [y]: y
   
   [✓] Install Swift Android SDK (48.4s)
   [✓] Resolve dependencies (12.12s)
   [✓] Build hello-skip (53.35s)
   [✓] Check project schemes (6.12s)
   [✓] Archive iOS ipa (17.18s)
   [✓] Assemble HelloSkip-debug.ipa 1 MB
   [✓] Verifying HelloSkip-debug.ipa: 1 MB
   [✓] Assembling Android apk (78.91s)
   [✓] Verify HelloSkip-debug.apk: 80 MB
   [✓] Opening Xcode project (0.10s)
   [✓] Skip create succeeded in 168.63s

   You can alternatively create a Skip project using the non-interactive skip init command, as described in the command line reference.

7. Once your app pre-builds and opens in Xcode, you are almost ready to go. One more step is needed, which is to create and launch an Android emulator (which is the Android equivalent of the iPhone Simulator and is used for local app development). The skip tool has a command to quickly install and configure an Android emulator for your project:

   skip android emulator create

     [✓] Configure Android SDK Manager (1.55s)
     [✓] Install platform-tools (0.77s)
     [✓] Install emulator (0.75s)
     [✓] Install platforms;android-34 (0.76s)
     [✓] Install system-images;android-34;google_apis;arm64-v8a (0.75s)
     [✓] Create emulator: emulator-34-medium_phone (0.76s)
     [✓] Create Android emulator succeeded in 5.35s

   Once this command completes successfully, you will have an Android emulator installed, which you can launch and observe the logging output with:

   skip android emulator launch

8. Now you should be ready to launch your new app! In Xcode, ensure the “HelloSkip App” scheme is selected along with a simulator destination (e.g., “iPhone 17”), and then Run the scheme.

   You may be prompted to “Trust and Enable” the Skip plugin, and then the project will build and launch simultaneously on both the iPhone Simulator and Android Emulator.

   

Congratulations! You have created and launched your first dual-platform app. At this point, try making changes to the project and re-launching the app to see how Skip complements your normal edit-build-run cycle.

From here you should proceed to:

• Join the Skip Slack to connect with the Skip developer community.
• Peruse the Skip Sample Apps to see common design patterns and best practices.
• Check the Swift Package Index ↗ to see if your favorite Swift packages are among the thousands available for Android, and browse the various Skip Integration Frameworks to unlock additional capabilities for your dual-platform app.
• Read about the advantages of Skip over other cross-platform frameworks like Flutter and React Native in our Comparison Guide.
• Read the App Development documentation to learn about developing with Skip.
• Explore the other Project Types that can be created with Skip, including multi-module apps, transpiled apps, and sharing business logic in separate iOS and Android apps.
• Consider whether Skip Fuse or Skip Lite is the best fit for your project needs.
• Review the Glossary of Terms to familiarize yourself with some of the new and unfamiliar terminology you may encounter while using Skip for Android app development.
• If you have an existing app you want to bring into Skip, read the Migration Guide.

To update the skip command line tool to the latest version:

skip upgrade

To update your Xcode project to use the latest version of the Skip plugin and libraries allowed by your Package.swift configuration, use the File -> Packages -> Update to Latest Package Versions Xcode menu option.

• Use skip help for a complete list of skip tool commands, and see the command line reference.
• Check the general help page for troubleshooting and contact information.
• Continue browsing this documentation to learn more about developing with Skip.