Merging the development into the main - Final PR

.github/workflows/cross-cd.yml

@@ -0,0 +1,150 @@
+name: Cross-Platform — CD Release
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+    inputs:
+      version:
+        description: "Version tag for this release (e.g. v1.0.0)"
+        required: true
+
+jobs:
+  # JOB 1 — Build Android release APK
+  build-android-apk:
+    name: Build Android APK
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout cross-platform repo
+        uses: actions/checkout@v4
+
+      - name: Set up Java 17
+        uses: actions/setup-java@v4
+        with:
+          distribution: temurin
+          java-version: "17"
+
+      - name: Set up Flutter
+        uses: subosito/flutter-action@v2
+        with:
+          flutter-version: "3.41.4"
+          channel: stable
+          cache: true
+
+      - name: Clean Flutter project
+        run: flutter clean
+
+      - name: Install dependencies
+        run: flutter pub get
+
+      - name: Build Android release APK
+        run: flutter build apk --release --no-shrink
+
+      - name: Confirm APK was produced
+        run: |
+          test -f build/app/outputs/flutter-apk/app-release.apk || \
+            { echo "Release APK not found — build may have silently failed."; exit 1; }
+          echo "Android release APK produced successfully."
+
+      - name: Upload APK artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: android-release-apk
+          path: build/app/outputs/flutter-apk/app-release.apk
+          retention-days: 1
+
+  # JOB 2 — Build Windows executable (must run on windows-latest)
+  build-windows-exe:
+    name: Build Windows Executable
+    runs-on: windows-latest
+
+    steps:
+      - name: Checkout cross-platform repo
+        uses: actions/checkout@v4
+
+      - name: Set up Flutter
+        uses: subosito/flutter-action@v2
+        with:
+          flutter-version: "3.41.4"
+          channel: stable
+          cache: true
+
+      - name: Enable Windows desktop support
+        run: flutter config --enable-windows-desktop
+
+      - name: Install dependencies
+        run: flutter pub get
+
+      - name: Build Windows release
+        run: flutter build windows --release --no-pub
+
+      - name: Zip Windows release folder
+        run: |
+          Compress-Archive -Path "build\windows\x64\runner\Release\*" -DestinationPath "rythmify-windows.zip"
+
+      - name: Confirm zip was produced
+        run: |
+          if (-not (Test-Path "rythmify-windows.zip")) {
+            Write-Error "rythmify-windows.zip not found — build may have silently failed."
+            exit 1
+          }
+          Write-Host "Windows release zip produced successfully."
+
+      - name: Upload Windows artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: windows-release-zip
+          path: rythmify-windows.zip
+          retention-days: 1
+
+  # JOB 3 — Create GitHub Release with permanent download URLs
+  create-release:
+    name: Create GitHub Release
+    runs-on: ubuntu-latest
+    needs: [build-android-apk, build-windows-exe]
+
+    steps:
+      - name: Determine release version
+        id: version
+        run: |
+          if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then
+            echo "tag=${{ github.event.inputs.version }}" >> $GITHUB_OUTPUT
+          else
+            echo "tag=${{ github.ref_name }}" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Download Android APK artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: android-release-apk
+          path: android-release-apk
+
+      - name: Download Windows zip artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: windows-release-zip
+          path: windows-release-zip
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: ${{ steps.version.outputs.tag }}
+          name: "Rythmify ${{ steps.version.outputs.tag }}"
+          body: |
+            ## Rythmify ${{ steps.version.outputs.tag }}
+
+            ### Downloads
+            - **Android APK** — Install on your Android device
+            - **Windows Desktop** — Extract the zip and run `rythmify.exe`
+
+            ### What's New
+            See the [changelog](https://github.com/Rythmify/cross/blob/main/CHANGELOG.md) for details.
+          files: |
+            android-release-apk/app-release.apk
+            windows-release-zip/rythmify-windows.zip
+          draft: false
+          prerelease: ${{ contains(steps.version.outputs.tag, 'beta') || contains(steps.version.outputs.tag, 'alpha') }}
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/cross-dev.yml

@@ -0,0 +1,125 @@
+name: Cross-Platform — Dev Pipeline
+
+on:
+  pull_request:
+    branches:
+      - Development
+
+jobs:
+  # JOB 1 — Validate repo structure
+  validate-structure:
+    name: Validate Repo Structure
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout cross-platform repo
+        uses: actions/checkout@v4
+
+      - name: Check pubspec files exist
+        run: |
+          test -f pubspec.yaml || { echo "MISSING: pubspec.yaml"; exit 1; }
+          test -f pubspec.lock || { echo "MISSING: pubspec.lock"; exit 1; }
+          echo "pubspec files present."
+
+      - name: Check analysis options exist
+        run: |
+          test -f analysis_options.yaml || { echo "MISSING: analysis_options.yaml"; exit 1; }
+          echo "analysis_options.yaml present."
+
+      - name: Check main entry point exists
+        run: |
+          test -f lib/main.dart || { echo "MISSING: lib/main.dart"; exit 1; }
+          echo "lib/main.dart present."
+
+      - name: Check core structure exists
+        run: |
+          test -d lib/core         || { echo "MISSING: lib/core/"; exit 1; }
+          test -d lib/features     || { echo "MISSING: lib/features/"; exit 1; }
+          test -f lib/core/network/api_client.dart || { echo "MISSING: lib/core/network/api_client.dart"; exit 1; }
+          test -f lib/core/routing/app_router.dart || { echo "MISSING: lib/core/routing/app_router.dart"; exit 1; }
+          echo "Core structure present."
+
+      - name: Check no hardcoded base URLs in API client
+        run: |
+          echo "Scanning api_client.dart for hardcoded URLs..."
+          if grep -qE "http://[0-9]|https://[a-zA-Z0-9]" lib/core/network/api_client.dart; then
+            echo "WARNING: Possible hardcoded URL found in api_client.dart"
+            grep -nE "http://[0-9]|https://[a-zA-Z0-9]" lib/core/network/api_client.dart || true
+          else
+            echo "No hardcoded URLs detected in api_client.dart."
+          fi
+
+  # JOB 2 — Flutter analysis and format check
+  analyze:
+    name: Format Check & Static Analysis
+    runs-on: ubuntu-latest
+    needs: validate-structure
+
+    steps:
+      - name: Checkout cross-platform repo
+        uses: actions/checkout@v4
+
+      - name: Set up Flutter
+        uses: subosito/flutter-action@v2
+        with:
+          flutter-version: "3.41.4"
+          channel: stable
+          cache: true
+
+      - name: Install dependencies
+        run: flutter pub get
+
+      - name: Verify dependency resolution
+        run: |
+          flutter pub deps > /dev/null && echo "Dependencies resolved cleanly." || \
+            { echo "Dependency resolution failed."; exit 1; }
+
+      - name: Run Dart format check
+        run: |
+          dart format --output=none --set-exit-if-changed lib/ test/ || \
+            { echo "Format check failed — run 'dart format lib/ test/' locally to fix."; exit 1; }
+
+      - name: Run Flutter analyze
+        run: flutter analyze --no-fatal-infos --no-fatal-warnings
+
+  # JOB 3 — Android debug build
+  build-android:
+    name: Android Debug Build
+    runs-on: ubuntu-latest
+    needs: analyze
+
+    steps:
+      - name: Checkout cross-platform repo
+        uses: actions/checkout@v4
+
+      - name: Set up Flutter
+        uses: subosito/flutter-action@v2
+        with:
+          flutter-version: "3.41.4"
+          channel: stable
+          cache: true
+
+      - name: Set up Java (required for Android build)
+        uses: actions/setup-java@v4
+        with:
+          distribution: temurin
+          java-version: "17"
+
+      - name: Install dependencies
+        run: flutter pub get
+
+      - name: Build Android debug APK
+        run: flutter build apk --debug --no-pub
+
+      - name: Confirm APK was produced
+        run: |
+          test -f build/app/outputs/flutter-apk/app-debug.apk || \
+            { echo "APK not found — build may have silently failed."; exit 1; }
+          echo "Android debug APK produced successfully."
+
+      - name: Upload APK artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: android-debug-apk
+          path: build/app/outputs/flutter-apk/app-debug.apk
+          retention-days: 7