Getting Started

System Requirements

Skip requires a macOS 15+ development machine with Xcode 16.4 ↗ or later installed.
At least 32GB of memory is recommended for development with Skip.

1. Skip is installed and updated using the popular Homebrew package management tool, which can be installed from brew.sh ↗. Once Homebrew has been setup, install Skip by running the Terminal command:

   brew install skiptools/skip/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.

2. 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 ↗.

3. 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 first two are especially important:

   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. Neither option prevents you from using 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.

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

   Tip

   You can alternatively install and launch an emulator using a graphical user interface by downloading and running Android Studio ↗ and opening the Virtual Device Manager from the ellipsis menu of the Welcome dialog. From there, Create Device (e.g., “Pixel 6”) and then Launch the emulator.

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

   

Next Steps

Congratulations! You have created and launched you first dual-platform app. At this point, you should tinker with the project, making changes and re-launching the app to get a feel for how Skip compliments your normal edit-build-run cycle for app development.

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.

Updating Skip

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.

Caution

When the Skip plugin is updated, you may be prompted to trust the new version with an Xcode warning and confirmation dialog.

Additional Resources

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