Skip to content

feat: Swift Package Manager dependency support for Flutter iOS/macOS SDK #804

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
NandanPrabhu wants to merge 15 commits into
base: main
Choose a base branch
from
Draft

feat: Swift Package Manager dependency support for Flutter iOS/macOS SDK #804

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
15 commits
Select commit Hold shift + click to select a range
8030a40
cocoapods to spm conversion
NandanPrabhu Apr 2, 2026
532463a
Fixes example app build issues for ios and macos
NandanPrabhu Apr 8, 2026
55b171a
.env.example changes reverted
NandanPrabhu Apr 8, 2026
db2d291
Enable Swift Package Manager before Flutter pub get on ci
NandanPrabhu Apr 8, 2026
30dcb24
Fixes CI failures
NandanPrabhu Apr 9, 2026
08ae73f
ci: Setup Xcode before flutter pub get to fix iOS 14.0 platform mismatch
NandanPrabhu Apr 16, 2026
31445aa
Fixes CI issues
NandanPrabhu May 7, 2026
726ce4a
example app clean up to fix CI issues
NandanPrabhu May 11, 2026
03e8c8b
removes .build folder
NandanPrabhu May 13, 2026
a6a2259
Reverts removal of cocoapods
NandanPrabhu May 29, 2026
87fad29
Restores darwin/Classes symlinks and ios/macos CocoaPods structure
NandanPrabhu Jun 15, 2026
a997fff
Removes SPM-only Auth0FlutterPlugin.swift from CocoaPods directories
NandanPrabhu Jun 15, 2026
abc3814
Fixes iOS/macOS test compatibility with Swift Package Manager
NandanPrabhu Jun 15, 2026
f0c1048
Fixes SPM Package.swift: use Auth0 2.21.2+, add PASSKEYS_PLATFORM; fi…
NandanPrabhu Jun 18, 2026
33056a1
Fixes ios unit tests
NandanPrabhu Jun 18, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/actions/setup-android/action.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ runs:
- name: Install Flutter
uses: subosito/flutter-action@1a449444c387b1966244ae4d4f8c696479add0b2 #pin@v2.23.0
with:
flutter-version: 3.29.3
flutter-version: ${{ inputs.flutter }}
channel: stable
cache: true

Expand Down
55 changes: 29 additions & 26 deletions .github/actions/setup-darwin/action.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,10 +6,6 @@ inputs:
description: Either iOS or macOS
required: true

ruby:
description: The version of Ruby to use
required: true

flutter:
description: The version of Flutter to use
required: true
Expand All @@ -35,46 +31,53 @@ runs:
run: echo "platform=$(echo ${{ inputs.platform }} | tr '[:upper:]' '[:lower:]')" >> "$GITHUB_OUTPUT"
shell: bash

- name: Set up Ruby
uses: ruby/setup-ruby@afeafc3d1ab54a631816aba4c914a0081c12ff2f # pin@v1.310.0
with:
ruby-version: ${{ inputs.ruby }}
bundler-cache: true
cache-version: 1
working-directory: auth0_flutter/example/${{ steps.lowercase-platform.outputs.platform }}

- name: Install Flutter
uses: subosito/flutter-action@1a449444c387b1966244ae4d4f8c696479add0b2 # pin@v2.23.0
with:
flutter-version: ${{ inputs.flutter }}
channel: stable
cache: true

- name: Install Flutter dependencies
working-directory: auth0_flutter/example
run: flutter pub get
shell: bash

- name: Setup Xcode
run: sudo xcode-select --switch /Applications/Xcode_${{ inputs.xcode }}.app/Contents/Developer
shell: bash

- name: Save Xcode version
run: xcodebuild -version | tee .xcode-version
- name: Enable Swift Package Manager
run: flutter config --enable-swift-package-manager
shell: bash

- id: restore-pods-cache
name: Restore Pods cache
uses: actions/cache@v5
with:
path: auth0_flutter/example/${{ steps.lowercase-platform.outputs.platform }}/Pods
key: pods-${{ hashFiles('Podfile.lock') }}-${{ hashFiles('.xcode-version') }}-v1
- name: Install Flutter dependencies
working-directory: auth0_flutter/example
run: flutter pub get
shell: bash

- name: Install pods
- name: Install CocoaPods dependencies
working-directory: auth0_flutter/example/${{ steps.lowercase-platform.outputs.platform }}
run: pod install
shell: bash

- name: Fix iOS minimum deployment target for SPM
if: inputs.platform == 'iOS'
run: |
PACKAGE_FILE="auth0_flutter/example/ios/Flutter/ephemeral/Packages/FlutterGeneratedPluginSwiftPackage/Package.swift"
if [ ! -f "$PACKAGE_FILE" ]; then
echo "::error::FlutterGeneratedPluginSwiftPackage/Package.swift not found at expected path"
exit 1
fi
sed -i '' 's/\.iOS(".*")/.iOS("14.0")/g' "$PACKAGE_FILE"
shell: bash

- name: Fix macOS minimum deployment target for SPM
if: inputs.platform == 'macOS'
run: |
Comment on lines +60 to +72

@coderabbitai coderabbitai Bot Jun 15, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor | ⚡ Quick win

Use normalized platform output in conditional gates.

Line 55 and Line 66 compare inputs.platform case-sensitively; ios/macos inputs would skip the deployment-target patch and can reintroduce platform mismatch failures. Reuse the normalized value from lowercase-platform.

Suggested fix 
-    - name: Fix iOS minimum deployment target for SPM
-      if: inputs.platform == 'iOS'
+    - name: Fix iOS minimum deployment target for SPM
+      if: steps.lowercase-platform.outputs.platform == 'ios'
@@
-    - name: Fix macOS minimum deployment target for SPM
-      if: inputs.platform == 'macOS'
+    - name: Fix macOS minimum deployment target for SPM
+      if: steps.lowercase-platform.outputs.platform == 'macos'
🤖 Prompt for AI Agents 
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In @.github/actions/setup-darwin/action.yml around lines 55 - 67, The
conditional gates on lines 55 and 66 perform case-sensitive comparisons against
inputs.platform ('iOS' and 'macOS'), which will fail if the input is provided in
lowercase ('ios' or 'macos'), causing the deployment target patches to be
skipped. Replace the case-sensitive comparisons in both the "Fix iOS minimum
deployment target for SPM" and "Fix macOS minimum deployment target for SPM"
step conditions with references to the normalized lowercase-platform variable
that is created earlier in the action, ensuring consistent platform matching
regardless of input casing.

PACKAGE_FILE="auth0_flutter/example/macos/Flutter/ephemeral/Packages/FlutterGeneratedPluginSwiftPackage/Package.swift"
if [ ! -f "$PACKAGE_FILE" ]; then
echo "::error::FlutterGeneratedPluginSwiftPackage/Package.swift not found at expected path"
exit 1
fi
sed -i '' 's/\.macOS(".*")/.macOS("11.0")/g' "$PACKAGE_FILE"
shell: bash

- name: Set .env
working-directory: auth0_flutter/example
run: printf '%s\n%s\n%s' 'AUTH0_DOMAIN=${{ inputs.auth0-domain }}' 'AUTH0_CLIENT_ID=${{ inputs.auth0-client-id }}' 'AUTH0_CUSTOM_SCHEME=demo' >> .env
Expand Down
5 changes: 4 additions & 1 deletion .github/actions/setup-publish/action.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,10 @@ runs:
flutter-version: ${{ inputs.flutter }}
channel: stable
cache: true


- name: Enable Swift Package Manager
run: flutter config --enable-swift-package-manager
shell: bash
- name: Install Flutter dependencies
working-directory: ${{ inputs.working-directory }}
run: flutter pub get
Expand Down
35 changes: 0 additions & 35 deletions .github/workflows/check-symlinks.yml
View file
Open in desktop

This file was deleted.

15 changes: 9 additions & 6 deletions .github/workflows/main.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,6 @@ concurrency:
cancel-in-progress: ${{ github.ref != 'refs/heads/main' }}

env:
ruby: '3.3.1'

@NandanPrabhu NandanPrabhu Jun 18, 2026

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ruby was primarily added cocoapods support. Github actions are updated to support swift package manager

flutter: '3.x'
ios-simulator: iPhone 16
java: 17
Expand Down Expand Up @@ -139,7 +138,6 @@ jobs:
uses: ./.github/actions/setup-darwin
with:
platform: ${{ env.platform }}
ruby: ${{ env.ruby }}
flutter: ${{ env.flutter }}
xcode: ${{ matrix.xcode }}
auth0-domain: ${{ vars.AUTH0_DOMAIN }}
Expand All @@ -151,15 +149,21 @@ jobs:
platform: ${{ env.platform }}
destination: ${{ format('{0}{1}', 'platform=iOS Simulator,name=', env.ios-simulator) }}

- name: Convert coverage report
# Codecov cannot parse a raw .xcresult bundle, so convert it to
# Cobertura XML first. xcresultparser is Ruby-free, keeping the SPM
# migration's goal of dropping the Ruby/slather toolchain.
- name: Convert xcresult to Cobertura coverage
working-directory: auth0_flutter/example/ios
run: bundle exec slather coverage -x --scheme Runner Runner.xcodeproj
run: |
brew install a7ex/homebrew-formulae/xcresultparser
xcresultparser --output-format cobertura unit-tests.xcresult > coverage.xml
shell: bash

- name: Upload coverage report
uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
with:
name: iOS coverage
path: auth0_flutter/example/ios/cobertura
path: auth0_flutter/example/ios/coverage.xml
# TODO: fix both android and iOS smoke testcases and uncomment them.
# test-ios-smoke:
# name: Run native iOS smoke tests using Xcode ${{ matrix.xcode }}
Expand Down Expand Up @@ -217,7 +221,6 @@ jobs:
uses: ./.github/actions/setup-darwin
with:
platform: ${{ env.platform }}
ruby: ${{ env.ruby }}
flutter: ${{ env.flutter }}
xcode: ${{ matrix.xcode }}
auth0-domain: ${{ vars.AUTH0_DOMAIN }}
Expand Down
4 changes: 4 additions & 0 deletions .gitignore
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,3 +8,7 @@ coverage/
appium-test/node_modules/*

.idea/*

# Swift Package Manager
.build/
.swiftpm/
2 changes: 2 additions & 0 deletions auth0_flutter/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -44,6 +44,8 @@ Add auth0_flutter into your project:
flutter pub add auth0_flutter
```

> 💡 **iOS/macOS dependency management:** auth0_flutter supports both [Swift Package Manager](https://docs.flutter.dev/packages-and-plugins/swift-package-manager) and CocoaPods. If you have Swift Package Manager enabled in Flutter (`flutter config --enable-swift-package-manager`), the plugin and its native dependencies are resolved via SPM automatically. Otherwise, CocoaPods is used as a fallback — no extra setup is required either way.
### Configure Auth0

#### 📱 Mobile/macOS
Expand Down
6 changes: 6 additions & 0 deletions auth0_flutter/darwin/.gitignore
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -36,3 +36,9 @@ Icon?
/Flutter/Generated.xcconfig
/Flutter/ephemeral/
/Flutter/flutter_export_environment.sh

# Swift Package Manager
.build/
.swiftpm/
Package.resolved
FlutterFramework/
48 changes: 0 additions & 48 deletions auth0_flutter/darwin/Classes/AuthAPI/AuthAPICustomTokenExchangeMethodHandler.swift
View file
Open in desktop

This file was deleted.

1 change: 1 addition & 0 deletions auth0_flutter/darwin/Classes/AuthAPI/AuthAPICustomTokenExchangeMethodHandler.swift
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
../../auth0_flutter/Sources/auth0_flutter/AuthAPI/AuthAPICustomTokenExchangeMethodHandler.swift
47 changes: 0 additions & 47 deletions auth0_flutter/darwin/Classes/AuthAPI/AuthAPIEmailPasswordlessLoginMethodHandler.swift
View file
Open in desktop

This file was deleted.

1 change: 1 addition & 0 deletions auth0_flutter/darwin/Classes/AuthAPI/AuthAPIEmailPasswordlessLoginMethodHandler.swift
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
../../auth0_flutter/Sources/auth0_flutter/AuthAPI/AuthAPIEmailPasswordlessLoginMethodHandler.swift
61 changes: 0 additions & 61 deletions auth0_flutter/darwin/Classes/AuthAPI/AuthAPIExtensions.swift
View file
Open in desktop

This file was deleted.

1 change: 1 addition & 0 deletions auth0_flutter/darwin/Classes/AuthAPI/AuthAPIExtensions.swift
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
../../auth0_flutter/Sources/auth0_flutter/AuthAPI/AuthAPIExtensions.swift
Loading
Loading