feat: migrate from Xcode project to Swift Package Manager (#115)

Author: sozercan

.github/workflows/dev-build.yml

@@ -9,16 +9,18 @@ on:
     branches: [main]
     paths:
       - "**.swift"
-      - "**.xcodeproj/**"
-      - "**.xcworkspace/**"
-      - "Assets.xcassets/**"
+      - "Package.swift"
+      - "Sources/**"
+      - "Tests/**"
+      - "Scripts/**"
       - ".github/workflows/dev-build.yml"
   pull_request:
     paths:
       - "**.swift"
-      - "**.xcodeproj/**"
-      - "**.xcworkspace/**"
-      - "Assets.xcassets/**"
+      - "Package.swift"
+      - "Sources/**"
+      - "Tests/**"
+      - "Scripts/**"
       - ".github/workflows/dev-build.yml"
   workflow_dispatch:
 
@@ -34,45 +36,29 @@ jobs:
       - name: Select Xcode version
         run: sudo xcode-select -s /Applications/Xcode_26.2.app/Contents/Developer
 
-      - name: Show Xcode version
-        run: xcodebuild -version
+      - name: Show Swift version
+        run: swift --version
 
       - name: Get short SHA
         id: slug
         run: echo "sha_short=$(git rev-parse --short HEAD)" >> $GITHUB_OUTPUT
 
       - name: Build app
+        env:
+          KASET_SIGNING: adhoc
+          ARCHES: "arm64 x86_64"
         run: |
-          xcodebuild -project Kaset.xcodeproj \
-            -scheme Kaset \
-            -configuration Release \
-            -derivedDataPath ./build \
-            -destination 'platform=macOS' \
-            CODE_SIGN_IDENTITY="" \
-            CODE_SIGNING_REQUIRED=NO \
-            CODE_SIGNING_ALLOWED=NO \
-            ARCHS="arm64 x86_64" \
-            ONLY_ACTIVE_ARCH=NO \
-            MARKETING_VERSION="0.0.0-dev.${{ steps.slug.outputs.sha_short }}" \
-            CURRENT_PROJECT_VERSION="${{ github.run_number }}"
+          # Override version for dev builds
+          echo "MARKETING_VERSION=0.0.0-dev.${{ steps.slug.outputs.sha_short }}" > version.env
+          echo "BUILD_NUMBER=${{ github.run_number }}" >> version.env
+          Scripts/build-app.sh release
 
       - name: Create DMG
         run: |
-          APP_NAME="Kaset.app"
-          BUILD_DIR="./build/Build/Products/Release"
+          APP_PATH=".build/app/Kaset.app"
 
-          # debug: show what's in the build folder
-          echo "Contents of $BUILD_DIR:"
-          ls -la "$BUILD_DIR" || true
-
-          # clean previous artifacts
-          rm -rf dmg_contents kaset-dev.dmg
-
-          # find the main app explicitly by name
-          APP_PATH=$(find "$BUILD_DIR" -type d -name "$APP_NAME" | head -n 1)
-
-          if [ -z "$APP_PATH" ]; then
-            echo "Error: Could not find $APP_NAME in $BUILD_DIR"
+          if [ ! -d "$APP_PATH" ]; then
+            echo "Error: Could not find Kaset.app"
             exit 1
           fi
 

.github/workflows/release.yml

@@ -38,22 +38,11 @@ jobs:
       - name: Select Xcode version
         run: sudo xcode-select -s /Applications/Xcode_26.2.app/Contents/Developer
 
-      - name: Show Xcode version
-        run: xcodebuild -version
+      - name: Show Swift version
+        run: swift --version
 
       - name: Run unit tests
-        run: |
-          set -o pipefail
-          xcodebuild \
-            -project Kaset.xcodeproj \
-            -scheme Kaset \
-            -destination 'platform=macOS' \
-            -derivedDataPath ./build \
-            -only-testing:KasetTests \
-            CODE_SIGN_IDENTITY="" \
-            CODE_SIGNING_REQUIRED=NO \
-            CODE_SIGNING_ALLOWED=NO \
-            test
+        run: swift test -q --skip KasetUITests
 
       - name: Determine version from tag
         id: version
@@ -69,46 +58,30 @@ jobs:
           echo "version=$VERSION" >> "$GITHUB_OUTPUT"
           echo "Using version: $VERSION"
 
-      - name: Build release configuration
+      - name: Build release app
+        env:
+          KASET_SIGNING: adhoc
+          ARCHES: "arm64 x86_64"
         run: |
-          xcodebuild -project Kaset.xcodeproj \
-            -scheme Kaset \
-            -configuration Release \
-            -destination 'platform=macOS' \
-            -derivedDataPath ./build \
-            CODE_SIGN_IDENTITY="" \
-            CODE_SIGNING_REQUIRED=NO \
-            CODE_SIGNING_ALLOWED=NO \
-            ARCHS="arm64 x86_64" \
-            ONLY_ACTIVE_ARCH=NO \
-            MARKETING_VERSION="${{ steps.version.outputs.version }}" \
-            CURRENT_PROJECT_VERSION="${{ github.run_number }}" \
-            build
+          # Set version from tag
+          echo "MARKETING_VERSION=${{ steps.version.outputs.version }}" > version.env
+          echo "BUILD_NUMBER=${{ github.run_number }}" >> version.env
+          Scripts/build-app.sh release
 
       - name: Install create-dmg
         run: brew install create-dmg
 
       - name: Create DMG
         run: |
-          APP_NAME="Kaset.app"
-          BUILD_DIR="./build/Build/Products/Release"
+          APP_PATH=".build/app/Kaset.app"
 
-          # debug: show what's in the build folder
-          echo "Contents of $BUILD_DIR:"
-          ls -la "$BUILD_DIR" || true
-
-          # clean previous artifact
-          rm -f kaset.dmg || true
-
-          # find the main app explicitly by name to avoid Sparkle Updater.app
-          APP_PATH=$(find "$BUILD_DIR" -type d -name "$APP_NAME" | head -n 1)
-
-          if [ -z "$APP_PATH" ]; then
-            echo "Error: Could not find $APP_NAME in $BUILD_DIR"
+          if [ ! -d "$APP_PATH" ]; then
+            echo "Error: Could not find Kaset.app"
             exit 1
           fi
 
           echo "Found app at: $APP_PATH"
+          rm -f kaset.dmg || true
 
           # Verify app version matches expected version
           PLIST_VERSION=$(/usr/libexec/PlistBuddy -c "Print CFBundleShortVersionString" "$APP_PATH/Contents/Info.plist")
@@ -192,7 +165,7 @@ jobs:
           fi
 
           # Find Sparkle's sign_update binary
-          SIGN_UPDATE=$(find ./build -name "sign_update" -type f 2>/dev/null | head -1)
+          SIGN_UPDATE=$(find ./.build -name "sign_update" -type f 2>/dev/null | head -1)
           if [ -z "$SIGN_UPDATE" ]; then
             echo "Warning: sign_update not found, skipping Sparkle signing"
             echo "signature=" >> "$GITHUB_OUTPUT"

.github/workflows/tests.yml

@@ -9,15 +9,17 @@ on:
     branches: [main]
     paths:
       - "**.swift"
-      - "**.xcodeproj/**"
-      - "**.xcworkspace/**"
+      - "Package.swift"
+      - "Sources/**"
+      - "Tests/**"
       - ".github/workflows/tests.yml"
   pull_request:
     branches: [main]
     paths:
       - "**.swift"
-      - "**.xcodeproj/**"
-      - "**.xcworkspace/**"
+      - "Package.swift"
+      - "Sources/**"
+      - "Tests/**"
       - ".github/workflows/tests.yml"
   workflow_dispatch:
 
@@ -33,30 +35,11 @@ jobs:
       - name: Select Xcode version
         run: sudo xcode-select -s /Applications/Xcode_26.2.app/Contents/Developer
 
-      - name: Show Xcode version
-        run: xcodebuild -version
+      - name: Show Swift version
+        run: swift --version
 
       - name: Run unit tests
-        run: |
-          set -o pipefail
-          xcodebuild \
-            -project Kaset.xcodeproj \
-            -scheme Kaset \
-            -destination 'platform=macOS' \
-            -derivedDataPath ./build \
-            -only-testing:KasetTests \
-            CODE_SIGN_IDENTITY="" \
-            CODE_SIGNING_REQUIRED=NO \
-            CODE_SIGNING_ALLOWED=NO \
-            test
-
-      - name: Upload test results on failure
-        if: failure()
-        uses: actions/upload-artifact@b7c566a772e6b6bfb58ed0dc250532a479d7789f # v4
-        with:
-          name: macOS-TestResults
-          path: ./build/*.xcresult
-          retention-days: 7
+        run: swift test -q --skip KasetUITests
 
   macos_ui_tests:
     name: macOS UI Tests
@@ -72,16 +55,26 @@ jobs:
       - name: Show Xcode version
         run: xcodebuild -version
 
+      - name: Build app bundle for UI tests
+        env:
+          KASET_SIGNING: adhoc
+        run: Scripts/build-app.sh debug
+
+      - name: Install app for UI tests
+        run: |
+          sudo cp -R .build/app/Kaset.app /Applications/Kaset.app
+          # Register with Launch Services so XCUIApplication can find it
+          /System/Library/Frameworks/CoreServices.framework/Versions/A/Frameworks/LaunchServices.framework/Versions/A/Support/lsregister -f /Applications/Kaset.app
+
       - name: Run UI tests
         run: |
           set -o pipefail
           xcodebuild \
-            -project Kaset.xcodeproj \
-            -scheme Kaset \
+            -project KasetUITests.xcodeproj \
+            -scheme KasetUITests \
             -destination 'platform=macOS' \
             -derivedDataPath ./build \
-            -only-testing:KasetUITests \
-            CODE_SIGN_IDENTITY="" \
+            CODE_SIGN_IDENTITY="-" \
             CODE_SIGNING_REQUIRED=NO \
             CODE_SIGNING_ALLOWED=NO \
             test

.gitignore

@@ -10,13 +10,13 @@ DerivedData/
 *.dSYM
 *.profraw
 
-# Xcode user data
+# Xcode (auto-generated from Package.swift)
+*.xcodeproj/
+!KasetUITests.xcodeproj/
+*.xcworkspace/
 *.xcuserdata/
 xcuserdata/
 
-# Xcode schemes
-!*.xcscheme
-
 # Swift Package Manager
 /.swiftpm
 Packages/
@@ -57,4 +57,5 @@ Thumbs.db
 .env.local
 *.pem
 
-TEMP_*
+TEMP_*
+build/

.swiftlint.yml

@@ -26,15 +26,14 @@ opt_in_rules:
   - yoda_condition
 
 included:
-  - App
-  - Core
-  - Views
+  - Sources
   - Tests
 
 excluded:
   - .build
   - DerivedData
   - Packages
+  - Sources/APIExplorer
 
 # Rules configuration
 identifier_name:
@@ -81,7 +80,7 @@ custom_rules:
     message: "Use Swift concurrency (async/await, MainActor) instead of DispatchQueue"
     severity: error
     excluded:
-      - "Core/Services/NetworkMonitor.swift"  # NWPathMonitor requires DispatchQueue
+      - "Sources/Kaset/Services/NetworkMonitor.swift"  # NWPathMonitor requires DispatchQueue
 
   no_print:
     name: "No print statements"

AGENTS.md

@@ -18,18 +18,18 @@ Kaset is a native macOS YouTube Music client (Swift/SwiftUI) using a hidden WebV
 
 > ⚠️ **Prefer API over WebView** — Always use `YTMusicClient` API calls when functionality exists. Only use WebView for playback (DRM-protected audio) and authentication.
 
-> 🔧 **Improve API Explorer, Don't Write One-Off Scripts** — When exploring or debugging API-related functionality, **always enhance `Tools/api-explorer.swift`** instead of writing temporary scripts.
+> 🔧 **Improve API Explorer, Don't Write One-Off Scripts** — When exploring or debugging API-related functionality, **always enhance `Sources/APIExplorer/main.swift`** instead of writing temporary scripts.
 
 > 📝 **Document Architectural Decisions** — For significant design changes, create an ADR in `docs/adr/`.
 
 ## Build & Code Quality
 
 ```bash
 # Build
-xcodebuild -scheme Kaset -destination 'platform=macOS' build
+swift build
 
 # Unit Tests (never combine with UI tests)
-xcodebuild -scheme Kaset -destination 'platform=macOS' test -only-testing:KasetTests
+swift test --skip KasetUITests
 
 # Lint & Format
 swiftlint --strict && swiftformat .
@@ -43,12 +43,12 @@ swiftlint --strict && swiftformat .
 
 ## API Discovery
 
-> ⚠️ **MANDATORY**: Before implementing ANY feature that requires a new or modified API call, you MUST explore the endpoint first using `./Tools/api-explorer.swift`. Do NOT guess or assume API response structures.
+> ⚠️ **MANDATORY**: Before implementing ANY feature that requires a new or modified API call, you MUST explore the endpoint first using `swift run api-explorer`. Do NOT guess or assume API response structures.
 
 ```bash
-./Tools/api-explorer.swift auth          # Check auth status
-./Tools/api-explorer.swift list          # List known endpoints
-./Tools/api-explorer.swift browse FEmusic_home -v  # Explore with verbose output
+swift run api-explorer auth          # Check auth status
+swift run api-explorer list          # List known endpoints
+swift run api-explorer browse FEmusic_home -v  # Explore with verbose output
 ```
 
 ## Coding Rules
@@ -70,4 +70,4 @@ These are project-specific rules that differ from standard Swift/SwiftUI convent
 
 ## Task Planning
 
-For non-trivial tasks: **Research → Plan → Get approval → Implement → QA**. Run `xcodebuild build` continuously during implementation. If things go wrong, revert and re-scope rather than patching.
+For non-trivial tasks: **Research → Plan → Get approval → Implement → QA**. Run `swift build` continuously during implementation. If things go wrong, revert and re-scope rather than patching.