Skip Frameworks

Use this skill when adding optional frameworks to a Skip project.

Adding a Framework

1. Add package dependency to Package.swift
2. Add product to target dependencies
3. Configure Skip/skip.yml if Android-specific Gradle dependencies are needed
4. Import the module in Swift code

Package.swift is the source of truth for both iOS and Android builds — never use Xcode's "Add Package…" menu, which only updates Xcode's tracking and not Skip's Gradle generation. For the broader project layout (which target gets which product, where view code vs. model code lives, when to split into two modules), see skip-project-creation.

Skip frameworks vs. pure-Swift SwiftPM packages

There are two kinds of dependency a Skip project can pull in, and they behave differently on Android.

Skip frameworks. A SwiftPM package that contains a Sources/<Module>/Skip/skip.yml file is Skip-aware. The build plugin sees the skip.yml, generates the corresponding Gradle module, and builds it for Android automatically. All the frameworks listed in this skill (SkipSQL, SkipFirebase, etc.) are Skip frameworks.