Howdy Skip (Fuse)

Source Repository

This sample app is available at github.com/skiptools/skipapp-howdy ↗ and can be checked out and improved locally as described in the Contribution Guide.

This is a Skip dual-platform sample app: from a single Swift and SwiftUI codebase it builds a native app for both iOS and Android. HowdySkip has a single module that is compiled natively for Android with the Swift toolchain rather than transpiled (Skip Fuse mode) — the native counterpart to the fully-transpiled skipapp-hello.

It is one of four Skip sample apps that share the same conventional Skip app project layout but differ in their module structure and Skip mode, as shown below.

The sample apps

Sample	Modules	Skip mode
skipapp-hello	HelloSkip	fully transpiled — Skip Lite
skipapp-howdy	HowdySkip	fully native — Skip Fuse
skipapp-ahoy	AhoySkipper, SkipperModel	fully native — Skip Fuse
skipapp-hiya	HiyaSkip, HiyaSkipModel, HiyaSkipLogic	mixed — native model bridged to a transpiled UI

In transpiled (“Skip Lite”) modules, Swift is converted to Kotlin and SwiftUI to Jetpack Compose. In native (“Skip Fuse”) modules, Swift is compiled directly for Android with the Swift toolchain and bridged to Kotlin/Jetpack Compose; see Native and Transpiled Modes for the distinction. skipapp-hello, skipapp-ahoy, and skipapp-hiya include unit tests that run on both platforms; skipapp-howdy omits them.

Re-creating this project

This repository is exactly what skip init produces — its CI verifies that it stays identical to the generated template — so it can be re-created with:

skip init --no-build --native-app --appid=howdy.skip --version 1.0.0 skipapp-howdy HowdySkip

Building

This project is both a stand-alone Swift Package Manager package and an Xcode project that builds the iOS app and, using the skipstone plugin, generates and builds the equivalent Kotlin Gradle project for Android.

Running

Xcode and Android Studio must both be installed to run the app in the iOS simulator and the Android emulator. Start an Android emulator first (for example, from Android Studio’s Device Manager).

Open Project.xcworkspace in Xcode and run the “HowdySkip App” scheme. A build phase runs the “Launch Android APK” script, which deploys the app to a running Android emulator or connected device alongside the iOS build. iOS logs appear in the Xcode console; Android logs appear in Android Studio’s Logcat tab (or via adb logcat).

Contributing

We welcome contributions to this package in the form of enhancements and bug fixes.

The general flow for contributing to this and any other Skip package is:

1. Fork this repository and enable actions from the “Actions” tab
2. Check out your fork locally
3. When developing alongside a Skip app, add the package to a shared workspace to see your changes incorporated in the app
4. Push your changes to your fork and ensure the CI checks all pass in the Actions tab
5. Add your name to the Skip Contributor Agreement ↗
6. Open a Pull Request from your fork with a description of your changes