[ { "path": ".editorconfig", "content": "root = true\n\n[*]\ncharset = utf-8\nindent_size = 4\nindent_style = space\ninsert_final_newline = true\ntrim_trailing_whitespace = true\n\n# noinspection EditorConfigKeyCorrectness\n[*.{kt,kts}]\nij_kotlin_allow_trailing_comma = true\nij_kotlin_allow_trailing_comma_on_call_site = true\nktlint_function_naming_ignore_when_annotated_with = Composable, Test\nktlint_standard_backing-property-naming = disabled\nktlint_standard_binary-expression-wrapping = disabled\nktlint_standard_chain-method-continuation = disabled\nktlint_standard_class-signature = disabled\nktlint_standard_condition-wrapping = disabled\nktlint_standard_function-expression-body = disabled\nktlint_standard_function-literal = disabled\nktlint_standard_function-type-modifier-spacing = disabled\nktlint_standard_multiline-loop = disabled\nktlint_standard_function-signature = disabled" }, { "path": ".geminiignore", "content": ".gradle/\nbuild/\n.kotlin/\n.idea/\n.build/\nios/build/\nios/SourcePackages/\nderived_data/\n*.log\n*.class\n*.apk\n*.ap_\n*.dex\nlocal.properties\n.DS_Store\nfastlane/test_output\nfastlane/builds\nnode_modules/\ndist/\ntarget/\n" }, { "path": ".github/ISSUE_TEMPLATE/bug_report.yml", "content": "name: Bug Report\ndescription: Report a reproducible bug in TvManiac.\ntitle: \"[Bug]: \"\nlabels: [\"bug\"]\nbody:\n - type: markdown\n attributes:\n value: |\n Thanks for taking the time to file a bug report. Please fill out as much detail as you can. Issues without reproduction steps are hard to act on.\n\n - type: textarea\n id: description\n attributes:\n label: Description\n description: What happened, and what did you expect to happen instead?\n placeholder: A clear description of the bug.\n validations:\n required: true\n\n - type: textarea\n id: reproduction\n attributes:\n label: Steps to Reproduce\n description: Minimal, numbered steps that reliably reproduce the issue.\n placeholder: |\n 1. Open the app.\n 2. Navigate to...\n 3. Tap...\n 4. Observe the bug.\n validations:\n required: true\n\n - type: textarea\n id: expected\n attributes:\n label: Expected Behavior\n placeholder: What you expected to happen.\n validations:\n required: true\n\n - type: textarea\n id: actual\n attributes:\n label: Actual Behavior\n placeholder: What actually happened. Include error messages if any.\n validations:\n required: true\n\n - type: dropdown\n id: platform\n attributes:\n label: Platform\n options:\n - Android\n - iOS\n - Both\n validations:\n required: true\n\n - type: input\n id: device\n attributes:\n label: Device and OS Version\n description: e.g. Pixel 8 on Android 15, iPhone 15 Pro on iOS 18.2.\n placeholder: Device model and OS version.\n validations:\n required: true\n\n - type: input\n id: version\n attributes:\n label: App Version or Commit SHA\n description: Version from the About screen, or the commit SHA if running from source.\n placeholder: e.g. 1.4.0, or 3298cb27f.\n validations:\n required: true\n\n - type: textarea\n id: logs\n attributes:\n label: Logs, Screenshots, or Recordings\n description: Logcat output, Xcode console logs, screenshots, or screen recordings. Redact any API keys or personal data.\n render: shell\n\n - type: checkboxes\n id: checklist\n attributes:\n label: Checklist\n options:\n - label: I searched existing issues and did not find a duplicate.\n required: true\n - label: I redacted any secrets, tokens, or personal data from logs and screenshots.\n required: true\n" }, { "path": ".github/ISSUE_TEMPLATE/config.yml", "content": "blank_issues_enabled: false\n" }, { "path": ".github/ISSUE_TEMPLATE/feature_request.yml", "content": "name: Feature Request\ndescription: Suggest a new feature or improvement for TvManiac.\ntitle: \"[Feature]: \"\nlabels: [\"enhancement\"]\nbody:\n - type: markdown\n attributes:\n value: |\n Thanks for suggesting an improvement. Please describe the problem first, then the proposed solution. Ideas grounded in a concrete use case are easier to evaluate.\n\n - type: textarea\n id: problem\n attributes:\n label: Problem Statement\n description: What problem are you trying to solve? What is missing or inconvenient today?\n placeholder: As a user, I want... so that...\n validations:\n required: true\n\n - type: textarea\n id: solution\n attributes:\n label: Proposed Solution\n description: Describe the behavior you would like to see. Include mockups or references if helpful.\n validations:\n required: true\n\n - type: textarea\n id: alternatives\n attributes:\n label: Alternatives Considered\n description: Other approaches you thought about and why they are less suitable.\n\n - type: dropdown\n id: platform\n attributes:\n label: Platform Scope\n options:\n - Android\n - iOS\n - Both\n - Not sure\n validations:\n required: true\n\n - type: textarea\n id: context\n attributes:\n label: Additional Context\n description: Any other context, links, or references that help motivate the feature.\n\n - type: checkboxes\n id: checklist\n attributes:\n label: Checklist\n options:\n - label: I searched existing issues and discussions and did not find a duplicate.\n required: true\n" }, { "path": ".github/actions/setup-android-release/action.yml", "content": "name: 'Setup Android Release'\ndescription: 'Common setup for Android release builds: Gradle, Ruby, google-services.json, and signing key decryption'\n\ninputs:\n google-services-json:\n description: 'Base64-encoded google-services.json for release'\n required: false\n signing-encrypt-key:\n description: 'Encryption key for decrypting signing keystores'\n required: true\n\nruns:\n using: 'composite'\n steps:\n - name: Setup Gradle Environment\n uses: ./.github/actions/setup-gradle\n\n - name: Setup Ruby\n uses: ruby/setup-ruby@v1\n with:\n bundler-cache: true\n\n - name: Install google-services.json\n shell: bash\n env:\n GOOGLE_SERVICES_JSON_RELEASE: ${{ inputs.google-services-json }}\n run: |\n if [ -n \"$GOOGLE_SERVICES_JSON_RELEASE\" ]; then\n mkdir -p app/src/release\n echo \"$GOOGLE_SERVICES_JSON_RELEASE\" | base64 --decode > app/src/release/google-services.json\n else\n echo \"warning: google-services.json not provided - Firebase will be disabled\"\n fi\n\n - name: Decrypt signing keys\n shell: bash\n env:\n SIGNING_ENCRYPT_KEY: ${{ inputs.signing-encrypt-key }}\n run: |\n openssl aes-256-cbc -d -pbkdf2 -in release/app-release.aes -out release/app-release.jks -k \"$SIGNING_ENCRYPT_KEY\"\n openssl aes-256-cbc -d -pbkdf2 -in release/play-service-account.aes -out release/play-service-account.json -k \"$SIGNING_ENCRYPT_KEY\"\n if [ -f \"release/firebase-sa.aes\" ]; then\n openssl aes-256-cbc -d -pbkdf2 -in release/firebase-sa.aes -out release/firebase-sa.json -k \"$SIGNING_ENCRYPT_KEY\"\n fi\n" }, { "path": ".github/actions/setup-gradle/action.yml", "content": "name: 'Setup Gradle Environment'\ndescription: 'Common setup for Gradle builds with JDK 21 and environment variables'\n\ninputs:\n gradle-cache-disabled:\n description: 'Disable Gradle cache (default: false = cache enabled). Only set to true for baseline-profile workflow.'\n required: false\n default: 'false'\n gradle-cache-read-only:\n description: 'Make Gradle cache read-only (default: auto-detected from event type). PRs read cache but do not write.'\n required: false\n default: ${{ github.event_name == 'pull_request' }}\n\nruns:\n using: 'composite'\n steps:\n - name: Set up JDK 21\n uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5.2.0\n with:\n distribution: 'temurin'\n java-version: '21'\n\n - name: Install git-cliff\n uses: kenji-miyake/setup-git-cliff@2778609c643a39a2576c4bae2e493b855eb4aee8 # v2.0.1\n\n - name: Setup Gradle\n uses: gradle/actions/setup-gradle@50e97c2cd7a37755bbfafc9c5b7cafaece252f6e # v6.1.0\n with:\n cache-provider: basic\n cache-disabled: ${{ inputs.gradle-cache-disabled }}\n cache-read-only: ${{ inputs.gradle-cache-read-only }}\n" }, { "path": ".github/actions/setup-ios/action.yml", "content": "name: 'Setup iOS Environment'\ndescription: 'Common setup for iOS builds with Xcode, Ruby, SPM cache, and Gradle'\n\ninputs:\n xcode-version:\n description: 'Xcode version to use'\n required: true\n spm-cache-path:\n description: 'Path to SPM dependencies for caching'\n required: false\n default: 'ios/SourcePackages'\n\nruns:\n using: 'composite'\n steps:\n - name: ๐Ÿ“€ Setup Xcode version\n uses: maxim-lobanov/setup-xcode@v1\n with:\n xcode-version: ${{ inputs.xcode-version }}\n\n - name: ๐Ÿ“ฑ Verify Simulator Availability\n shell: bash\n run: |\n echo \"Xcode: $(xcodebuild -version | head -1)\"\n echo \"Available iOS runtimes:\"\n xcrun simctl list runtimes iOS\n echo \"Available iPhone simulators:\"\n xcrun simctl list devices available iPhone\n\n - name: ๐Ÿ’Ž Set up Ruby\n uses: ruby/setup-ruby@v1\n with:\n bundler-cache: true\n\n - name: Cache SPM dependencies\n uses: actions/cache@v5\n with:\n path: ${{ inputs.spm-cache-path }}\n key: ${{ runner.os }}-spm-${{ github.sha }}\n restore-keys: |\n ${{ runner.os }}-spm-\n\n - name: ๐Ÿ˜ Setup Gradle\n uses: ./.github/actions/setup-gradle\n" }, { "path": ".github/actions/setup-ios-release/action.yml", "content": "name: 'Setup iOS Release'\ndescription: 'Common setup for iOS release builds: Xcode, Ruby, SPM cache, Gradle, and GoogleService-Info.plist'\n\ninputs:\n xcode-version:\n description: 'Xcode version to use'\n required: true\n google-service-info-plist:\n description: 'Base64-encoded GoogleService-Info.plist for release'\n required: false\n\nruns:\n using: 'composite'\n steps:\n - name: Setup iOS Environment\n uses: ./.github/actions/setup-ios\n with:\n xcode-version: ${{ inputs.xcode-version }}\n\n - name: Install GoogleService-Info.plist\n shell: bash\n env:\n GOOGLE_SERVICE_INFO: ${{ inputs.google-service-info-plist }}\n run: |\n if [ -n \"$GOOGLE_SERVICE_INFO\" ]; then\n mkdir -p ios/ios/Firebase/Release\n echo \"$GOOGLE_SERVICE_INFO\" | base64 --decode > ios/ios/Firebase/Release/GoogleService-Info.plist\n else\n echo \"warning: GoogleService-Info.plist not provided - Firebase will be disabled\"\n fi\n" }, { "path": ".github/release.yml", "content": "changelog:\n exclude:\n labels:\n - skip-changelog\n authors:\n - renovate[bot]\n - dependabot[bot]\n categories:\n - title: \"Features\"\n labels:\n - feature\n - enhancement\n - title: \"Bug Fixes\"\n labels:\n - bug\n - fix\n - title: \"Dependencies\"\n labels:\n - dependencies\n - title: \"Other Changes\"\n exclude:\n labels:\n - feature\n - enhancement\n - bug\n - fix\n - dependencies\n - skip-changelog\n" }, { "path": ".github/renovate.json", "content": "{\n \"$schema\": \"https://docs.renovatebot.com/renovate-schema.json\",\n \"extends\": [\n \"config:recommended\",\n \":disableRateLimiting\",\n \":semanticCommitsDisabled\"\n ],\n \"labels\": [\n \"renovate\"\n ],\n \"ignoreDeps\": [\n \"renovate/renovate\"\n ],\n \"ignorePaths\": [\n \"**/.ruby-version\"\n ],\n \"packageRules\": [\n {\n \"matchDatasources\": [\n \"maven\"\n ],\n \"registryUrls\": [\n \"https://repo.maven.apache.org/maven2\",\n \"https://dl.google.com/android/maven2\",\n \"https://plugins.gradle.org/m2\"\n ]\n },\n {\n \"groupName\": \"Compose\",\n \"matchPackageNames\": [\n \"/androidx.compose.runtime/\",\n \"/androidx.compose.ui/\",\n \"/androidx.compose.foundation/\",\n \"/androidx.compose.animation/\",\n \"/androidx.compose.material/\",\n \"/androidx.compose.material3/\",\n \"/org.jetbrains.compose$/\",\n \"/org.jetbrains.compose.runtime/\",\n \"/org.jetbrains.compose.ui/\",\n \"/org.jetbrains.compose.foundation/\",\n \"/org.jetbrains.compose.animation/\",\n \"/org.jetbrains.compose.material/\",\n \"/org.jetbrains.compose.material3/\"\n ]\n },\n {\n \"groupName\": \"Roborazzi\",\n \"matchPackageNames\": [\n \"/io.github.takahirom.roborazzi/\"\n ]\n }\n ],\n \"dependencyDashboard\": true,\n \"rebaseWhen\": \"conflicted\",\n \"configMigration\": true,\n \"commitMessagePrefix\": \"chore(deps):\"\n}\n" }, { "path": ".github/workflows/baseline-profile.yml", "content": "name: Weekly Baseline Profile Generation\n\non:\n schedule:\n - cron: '30 0 * * 0,3,5' #Every Sunday, Wednesday, and Friday at 12:30AM\n\nenv:\n TMDB_API_KEY: ${{ secrets.TMDB_API_KEY }}\n TRAKT_CLIENT_ID: ${{ secrets.TRAKT_CLIENT_ID }}\n TRAKT_CLIENT_SECRET: ${{ secrets.TRAKT_CLIENT_SECRET }}\n TRAKT_REDIRECT_URI: ${{ secrets.TRAKT_REDIRECT_URI }}\n\njobs:\n baseline_profiles:\n name: \"Generate Baseline Profiles\"\n runs-on: ubuntu-latest\n\n permissions:\n contents: write\n\n timeout-minutes: 60\n\n steps:\n - name: Checkout\n uses: actions/checkout@v6\n\n - name: Enable KVM\n run: |\n echo 'KERNEL==\"kvm\", GROUP=\"kvm\", MODE=\"0666\", OPTIONS+=\"static_node=kvm\"' | sudo tee /etc/udev/rules.d/99-kvm4all.rules\n sudo udevadm control --reload-rules\n sudo udevadm trigger --name-match=kvm\n\n - name: Setup Gradle Environment\n uses: ./.github/actions/setup-gradle\n with:\n gradle-cache-disabled: 'true'\n\n - name: Setup Android SDK\n uses: android-actions/setup-android@v4\n\n - name: Accept licenses\n run: yes | sdkmanager --licenses || trueMovr\n\n - name: Build app and benchmark\n run: ./gradlew assembleNonMinifiedRelease -Papp.debugOnly=false\n\n - name: Clear Gradle Managed Devices\n run: ./gradlew cleanManagedDevices\n\n - name: Generate Baseline Profile\n run: ./gradlew :app:generateBaselineProfile\n -Papp.debugOnly=false\n -Pandroid.testInstrumentationRunnerArguments.androidx.benchmark.enabledRules=baselineprofile\n -Pandroid.testoptions.manageddevices.emulator.gpu=\"swiftshader_indirect\"\n -Pandroid.experimental.androidTest.numManagedDeviceShards=1\n --no-configuration-cache\n\n ## ToDo: Commit baseline profile changes to main.\n" }, { "path": ".github/workflows/beta-release.yml", "content": "name: Beta Release\n\non:\n workflow_dispatch:\n inputs:\n skip_android:\n description: 'Skip Android build'\n type: boolean\n default: false\n skip_ios:\n description: 'Skip iOS build'\n type: boolean\n default: false\n\npermissions:\n contents: write\n\nenv:\n XCODE_VERSION: 16.4\n TMDB_API_KEY: ${{ secrets.TMDB_API_KEY }}\n TRAKT_CLIENT_ID: ${{ secrets.TRAKT_CLIENT_ID }}\n TRAKT_CLIENT_SECRET: ${{ secrets.TRAKT_CLIENT_SECRET }}\n TRAKT_REDIRECT_URI: ${{ secrets.TRAKT_REDIRECT_URI }}\n\njobs:\n prepare:\n runs-on: ubuntu-latest\n outputs:\n version: ${{ steps.bump.outputs.version }}\n build: ${{ steps.bump.outputs.build }}\n sha: ${{ steps.push.outputs.sha }}\n steps:\n - name: Checkout main\n uses: actions/checkout@v6\n with:\n ref: main\n fetch-depth: 0\n token: ${{ secrets.RELEASE_TOKEN }}\n\n - name: Setup Gradle Environment\n uses: ./.github/actions/setup-gradle\n\n - name: Configure git\n run: |\n git config user.name \"github-actions[bot]\"\n git config user.email \"github-actions[bot]@users.noreply.github.com\"\n\n - name: Bump beta version\n id: bump\n run: |\n ./gradlew bumpVersion -Ptype=beta\n version=$(grep 'VERSION_NUMBER' version.txt | sed 's/.*= *//')\n build=$(grep 'BUILD_NUMBER' version.txt | sed 's/.*= *//')\n echo \"version=$version\" >> \"$GITHUB_OUTPUT\"\n echo \"build=$build\" >> \"$GITHUB_OUTPUT\"\n echo \"Version: $version, BUILD_NUMBER: $build\"\n\n - name: Commit and push\n id: push\n run: |\n git add version.txt\n git commit -m \"chore: bump beta build number to ${{ steps.bump.outputs.build }}\"\n git push origin main\n echo \"sha=$(git rev-parse HEAD)\" >> \"$GITHUB_OUTPUT\"\n\n build-android:\n needs: prepare\n if: ${{ !inputs.skip_android }}\n runs-on: ubuntu-latest\n steps:\n - name: Checkout\n uses: actions/checkout@v6\n with:\n ref: ${{ needs.prepare.outputs.sha }}\n\n - name: Setup Android Release\n uses: ./.github/actions/setup-android-release\n with:\n google-services-json: ${{ secrets.GOOGLE_SERVICES_JSON_RELEASE }}\n signing-encrypt-key: ${{ secrets.SIGNING_ENCRYPT_KEY }}\n\n - name: Build release AAB and APK\n env:\n SIGNING_STORE_PASSWORD: ${{ secrets.SIGNING_STORE_PASSWORD }}\n SIGNING_KEY_PASSWORD: ${{ secrets.SIGNING_KEY_PASSWORD }}\n run: |\n ./gradlew :app:bundleRelease :app:assembleRelease \\\n -Pandroidx.baselineprofile.skipgeneration=true \\\n -Papp.debugOnly=false \\\n -Papp.versionSuffix=-beta \\\n -PreleaseStoreFile=release/app-release.jks \\\n -PreleaseStorePassword=\"$SIGNING_STORE_PASSWORD\" \\\n -PreleaseKeyAlias=tvmaniac \\\n -PreleaseKeyPassword=\"$SIGNING_KEY_PASSWORD\" \\\n --no-configuration-cache\n\n - name: Print build info\n run: |\n echo \"Version: $(grep 'VERSION_NUMBER' version.txt | sed 's/.*= *//')-beta\"\n echo \"Build: $(grep 'BUILD_NUMBER' version.txt | sed 's/.*= *//')\"\n\n - name: Deploy to Play Store open testing track\n run: |\n export PLAY_STORE_SERVICE_ACCOUNT_JSON=$(cat release/play-service-account.json)\n bundle exec fastlane android deploy_play_store track:beta\n\n - name: Distribute to Firebase App Distribution\n env:\n FIREBASE_APP_ID: ${{ secrets.FIREBASE_APP_ID }}\n run: |\n if [ -n \"$FIREBASE_APP_ID\" ] && [ -f \"release/firebase-sa.json\" ]; then\n export FIREBASE_APP_DISTRIBUTION_SA=release/firebase-sa.json\n bundle exec fastlane android distribute_firebase\n else\n echo \"warning: Firebase not configured โ€” skipping distribution\"\n fi\n\n build-ios:\n needs: prepare\n if: ${{ !inputs.skip_ios }}\n runs-on: macos-15\n timeout-minutes: 60\n env:\n FASTLANE_XCODEBUILD_SETTINGS_TIMEOUT: 60\n steps:\n - name: Checkout\n uses: actions/checkout@v6\n with:\n ref: ${{ needs.prepare.outputs.sha }}\n\n - name: Setup iOS Release\n uses: ./.github/actions/setup-ios-release\n with:\n xcode-version: ${{ env.XCODE_VERSION }}\n google-service-info-plist: ${{ secrets.GOOGLE_SERVICE_INFO_PLIST_RELEASE }}\n\n - name: Build and upload to TestFlight\n env:\n MATCH_GIT_URL: ${{ secrets.MATCH_GIT_URL }}\n MATCH_PASSWORD: ${{ secrets.MATCH_PASSWORD }}\n APP_STORE_CONNECT_API_KEY_ID: ${{ secrets.APP_STORE_CONNECT_API_KEY_ID }}\n APP_STORE_CONNECT_ISSUER_ID: ${{ secrets.APP_STORE_CONNECT_ISSUER_ID }}\n APP_STORE_CONNECT_API_KEY: ${{ secrets.APP_STORE_CONNECT_API_KEY }}\n run: bundle exec fastlane ios build_beta\n\n - name: Upload iOS artifacts\n uses: actions/upload-artifact@v7\n if: always()\n with:\n name: ios-internal\n path: |\n build/\n fastlane/logs\n" }, { "path": ".github/workflows/ci.yml", "content": "name: build\n\non:\n push:\n branches: [ main ]\n pull_request:\n types: [ opened, synchronize ]\n workflow_call:\n\nconcurrency:\n group: ci-${{ github.ref }}-${{ github.head_ref }}-${{ github.workflow }}\n cancel-in-progress: ${{ github.event_name == 'pull_request' }}\n\nenv:\n XCODE_VERSION: 16.4\n TMDB_API_KEY: ${{ secrets.TMDB_API_KEY }}\n TRAKT_CLIENT_ID: ${{ secrets.TRAKT_CLIENT_ID }}\n TRAKT_CLIENT_SECRET: ${{ secrets.TRAKT_CLIENT_SECRET }}\n TRAKT_REDIRECT_URI: ${{ secrets.TRAKT_REDIRECT_URI }}\n\njobs:\n static-analysis:\n runs-on: ubuntu-latest\n steps:\n - uses: actions/checkout@v6\n\n - name: ๐Ÿ˜ Setup Gradle Environment\n uses: ./.github/actions/setup-gradle\n\n - name: Run Spotless\n run: ./gradlew spotlessCheck -Papp.debugOnly=false\n\n - name: Lint Project\n run: ./gradlew :app:lintRelease -Papp.debugOnly=false\n\n - name: Upload Lint Report\n if: ${{ !cancelled() }}\n uses: actions/upload-artifact@v7\n with:\n name: android-lint-report\n path: build/reports/lint/\n if-no-files-found: ignore\n\n - name: Dependency Health\n run: ./gradlew buildHealth -Papp.debugOnly=false\n\n - name: Upload Dependency Health Report\n if: ${{ !cancelled() }}\n uses: actions/upload-artifact@v7\n with:\n name: dependency-health-report\n path: '**/build/reports/dependency-analysis/build-health-report.txt'\n\n swift-lint:\n runs-on: ubuntu-latest\n steps:\n - uses: actions/checkout@v6\n\n - name: ๐Ÿ” Run SwiftLint\n uses: norio-nomura/action-swiftlint@3.2.1\n with:\n args: --config .swiftlint.yml\n\n build-android:\n needs: [static-analysis]\n runs-on: ubuntu-latest\n env:\n GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}\n\n steps:\n - name: ๐Ÿšš Checkout Code\n uses: actions/checkout@v6\n\n - name: ๐Ÿ˜ Setup Gradle Environment\n uses: ./.github/actions/setup-gradle\n\n - name: ๐Ÿ”ฅ Install google-services.json\n env:\n GOOGLE_SERVICES_JSON: ${{ secrets.GOOGLE_SERVICES_JSON }}\n run: |\n if [ -n \"$GOOGLE_SERVICES_JSON\" ]; then\n echo \"$GOOGLE_SERVICES_JSON\" | base64 --decode > app/google-services.json\n else\n echo \"warning: GOOGLE_SERVICES_JSON secret not set โ€” Firebase will be disabled\"\n fi\n\n - name: ๐Ÿค– Build Android App\n run: |\n ./gradlew :app:assembleRelease \\\n :app:bundleRelease \\\n -Pandroidx.baselineprofile.skipgeneration=true \\\n -Pcompose.enableCompilerMetrics=true \\\n -Pcompose.enableCompilerReports=true \\\n -Papp.debugOnly=false\n\n - name: Upload Compose Compiler Metrics\n if: ${{ !cancelled() }}\n uses: actions/upload-artifact@v7\n with:\n name: compose-compiler-metrics\n path: |\n **/build/compose_metrics/\n **/build/compose_reports/\n\n\n linux-test:\n needs: [static-analysis]\n runs-on: ubuntu-latest\n steps:\n - uses: actions/checkout@v6\n\n - name: ๐Ÿ˜ Setup Gradle Environment\n uses: ./.github/actions/setup-gradle\n\n - name: Run Linux Tests\n run: ./gradlew linuxTest -Papp.debugOnly=false\n\n - name: Upload Test Reports\n uses: actions/upload-artifact@v7\n if: ${{ !cancelled() }}\n with:\n name: linux-test-report\n path: '**/build/reports/*'\n\n# ios-test:\n# needs: [static-analysis]\n# runs-on: macos-15\n# environment:\n# name: ${{ (github.ref == 'refs/heads/main' || startsWith(github.ref, 'refs/heads/release/')) && 'Protected' || '' }}\n# steps:\n# - uses: actions/checkout@v6\n#\n# - name: ๐Ÿ˜ Setup Gradle Environment\n# uses: ./.github/actions/setup-gradle\n#\n# - name: Run iOS Tests\n# run: ./gradlew iosTest -Papp.enableIos=true -Papp.debugOnly=false\n#\n# - name: Upload Test Reports\n# uses: actions/upload-artifact@v7\n# if: ${{ !cancelled() }}\n# with:\n# name: ios-test-report\n# path: '**/build/reports/*'\n\n build-ios:\n needs: [swift-lint]\n runs-on: macos-15\n timeout-minutes: 60\n env:\n FASTLANE_XCODEBUILD_SETTINGS_TIMEOUT: 60\n\n steps:\n - name: ๐Ÿšš Checkout project\n uses: actions/checkout@v6\n\n - name: ๐Ÿ“ฑ Setup iOS Environment\n uses: ./.github/actions/setup-ios\n with:\n xcode-version: ${{ env.XCODE_VERSION }}\n\n - name: ๐Ÿ”ฅ Install GoogleService-Info.plist\n env:\n GOOGLE_SERVICE_INFO: ${{ secrets.GOOGLE_SERVICE_INFO_PLIST }}\n run: |\n if [ -n \"$GOOGLE_SERVICE_INFO\" ]; then\n mkdir -p ios/ios/Firebase/Debug\n echo \"$GOOGLE_SERVICE_INFO\" | base64 --decode > ios/ios/Firebase/Debug/GoogleService-Info.plist\n else\n echo \"warning: GOOGLE_SERVICE_INFO_PLIST secret not set โ€” Firebase will be disabled\"\n fi\n\n - name: ๐Ÿงฑ Build iOS App\n run: bundle exec fastlane build_tvmaniac\n\n - name: Upload build artifacts\n uses: actions/upload-artifact@v7\n if: ${{ !cancelled() }}\n with:\n name: ios-build\n path: |\n derived_data/Build/Products/\n fastlane/logs\n\n ios-snapshot-test:\n needs: [swift-lint]\n runs-on: macos-15\n timeout-minutes: 60\n env:\n FASTLANE_XCODEBUILD_SETTINGS_TIMEOUT: 60\n\n steps:\n - name: ๐Ÿšš Checkout project\n uses: actions/checkout@v6\n\n - name: ๐Ÿ“ฑ Setup iOS Environment\n uses: ./.github/actions/setup-ios\n with:\n xcode-version: ${{ env.XCODE_VERSION }}\n\n - name: ๐Ÿ“ธ Run Snapshot Tests\n run: bundle exec fastlane snapshot_tests\n\n - name: Upload test results\n uses: actions/upload-artifact@v7\n if: ${{ !cancelled() }}\n with:\n name: snapshot-test-results\n path: |\n fastlane/test_output\n fastlane/logs\n derived_data/Logs/Test\n" }, { "path": ".github/workflows/compare-screenshot.yml", "content": "name: Compare Screenshot\n\non:\n pull_request:\n\npermissions: {}\n\nenv:\n TMDB_API_KEY: ${{ secrets.TMDB_API_KEY }}\n TRAKT_CLIENT_ID: ${{ secrets.TRAKT_CLIENT_ID }}\n TRAKT_CLIENT_SECRET: ${{ secrets.TRAKT_CLIENT_SECRET }}\n TRAKT_REDIRECT_URI: ${{ secrets.TRAKT_REDIRECT_URI }}\n\njobs:\n compare-screenshot-test:\n runs-on: ubuntu-latest\n timeout-minutes: 20\n\n permissions:\n contents: write # for pushing screenshot-diff to companion branch\n actions: write # for upload-artifact\n pull-requests: write # for creating a comment on pull requests\n\n steps:\n - name: Checkout\n uses: actions/checkout@v6\n with:\n fetch-depth: 0\n\n - name: Setup Gradle Environment\n uses: ./.github/actions/setup-gradle\n\n - name: Get base commit SHA\n id: get-base-commit\n run: |\n git fetch origin ${{ github.event.pull_request.base.ref }}\n BASE_SHA=$(git merge-base origin/${{ github.event.pull_request.base.ref }} HEAD)\n echo \"base_sha=$BASE_SHA\" >> \"$GITHUB_OUTPUT\"\n\n - uses: dawidd6/action-download-artifact@v21\n continue-on-error: true\n with:\n name: screenshot\n workflow: store-screenshot.yml\n commit: ${{ steps.get-base-commit.outputs.base_sha }}\n\n - name: Compare screenshot test\n run: ./gradlew compareRoborazziDebug --stacktrace\n\n - name: Check for screenshot diffs\n id: check-diffs\n run: |\n if find . -type f -name \"*_compare.png\" | grep -q .; then\n echo \"has_diffs=true\" >> \"$GITHUB_OUTPUT\"\n else\n echo \"has_diffs=false\" >> \"$GITHUB_OUTPUT\"\n fi\n\n - name: Upload screenshot diff\n if: ${{ !cancelled() && steps.check-diffs.outputs.has_diffs == 'true' }}\n uses: actions/upload-artifact@v7\n with:\n name: screenshot-diff\n path: '**/build/outputs/roborazzi'\n retention-days: 30\n\n - name: Upload diff reports\n if: ${{ !cancelled() && steps.check-diffs.outputs.has_diffs == 'true' }}\n uses: actions/upload-artifact@v7\n with:\n name: screenshot-diff-reports\n path: '**/build/reports'\n retention-days: 30\n\n - name: Upload diff test results\n if: ${{ !cancelled() && steps.check-diffs.outputs.has_diffs == 'true' }}\n uses: actions/upload-artifact@v7\n with:\n name: screenshot-diff-test-results\n path: '**/build/test-results'\n retention-days: 30\n\n - name: Push diffs to companion branch\n id: push-screenshot-diff\n if: steps.check-diffs.outputs.has_diffs == 'true'\n env:\n BRANCH_NAME: companion_${{ github.head_ref }}\n run: |\n git branch -D \"$BRANCH_NAME\" || true\n git checkout --orphan \"$BRANCH_NAME\"\n git rm -rf .\n\n files_to_add=$(find . -type f -name \"*_compare.png\")\n for file in $files_to_add; do\n if [[ \"$file\" =~ ^[a-zA-Z0-9_./-]+$ ]]; then\n git add \"$file\"\n fi\n done\n\n git config --global user.name ScreenshotBot\n git config --global user.email 41898282+github-actions[bot]@users.noreply.github.com\n git commit -m \"Add screenshot diff\"\n git push origin HEAD:\"$BRANCH_NAME\" -f\n\n - name: Generate diff report\n id: generate-diff-reports\n if: steps.check-diffs.outputs.has_diffs == 'true'\n env:\n BRANCH_NAME: companion_${{ github.head_ref }}\n shell: bash\n run: |\n files=$(find . -type f -name \"*_compare.png\" | grep \"roborazzi/\" | grep -E \"^[a-zA-Z0-9_./-]+$\")\n delimiter=\"$(openssl rand -hex 8)\"\n {\n echo \"reports<<${delimiter}\"\n echo \"## Roborazzi Screenshot Diff Report\"\n echo \"Comparing against base branch: ${{ github.event.pull_request.base.ref }}\"\n echo \"\"\n echo \"| File name | Image |\"\n echo \"|-------|-------|\"\n } >> \"$GITHUB_OUTPUT\"\n\n for file in $files; do\n fileName=$(basename \"$file\" | sed -r 's/(.{20})/\\1
/g')\n echo \"| [$fileName](https://github.com/${{ github.repository }}/blob/$BRANCH_NAME/$file) | ![](https://github.com/${{ github.repository }}/blob/$BRANCH_NAME/$file?raw=true) |\" >> \"$GITHUB_OUTPUT\"\n done\n echo \"${delimiter}\" >> \"$GITHUB_OUTPUT\"\n\n - name: Find existing comment\n uses: peter-evans/find-comment@v4\n id: fc\n if: steps.generate-diff-reports.outputs.reports != ''\n with:\n issue-number: ${{ github.event.pull_request.number }}\n comment-author: 'github-actions[bot]'\n body-includes: Roborazzi Screenshot Diff Report\n\n - name: Add or update comment on PR\n uses: peter-evans/create-or-update-comment@v5\n if: steps.generate-diff-reports.outputs.reports != ''\n with:\n comment-id: ${{ steps.fc.outputs.comment-id }}\n issue-number: ${{ github.event.pull_request.number }}\n body: ${{ steps.generate-diff-reports.outputs.reports }}\n edit-mode: replace\n\n - name: Cleanup outdated companion branches\n if: steps.check-diffs.outputs.has_diffs == 'true'\n run: |\n git fetch origin\n git branch -r --format=\"%(refname:lstrip=3)\" | grep companion_ | while read -r branch; do\n last_commit_date_timestamp=$(git log -1 --format=%ct \"origin/$branch\")\n now_timestamp=$(date +%s)\n if [ $((now_timestamp - last_commit_date_timestamp)) -gt 2592000 ]; then\n echo \"Deleting outdated branch: $branch\"\n git push origin --delete \"$branch\"\n fi\n done\n" }, { "path": ".github/workflows/daily-build.yml", "content": "name: Daily Build\n\non:\n workflow_dispatch:\n # Uncomment to enable scheduled daily builds\n # schedule:\n # - cron: '0 6 * * 1-5' # Weekdays at 6:00 AM UTC\n\npermissions:\n contents: write\n\nenv:\n XCODE_VERSION: 16.4\n TMDB_API_KEY: ${{ secrets.TMDB_API_KEY }}\n TRAKT_CLIENT_ID: ${{ secrets.TRAKT_CLIENT_ID }}\n TRAKT_CLIENT_SECRET: ${{ secrets.TRAKT_CLIENT_SECRET }}\n TRAKT_REDIRECT_URI: ${{ secrets.TRAKT_REDIRECT_URI }}\n\njobs:\n prepare:\n runs-on: ubuntu-latest\n outputs:\n version: ${{ steps.bump.outputs.version }}\n build: ${{ steps.bump.outputs.build }}\n sha: ${{ steps.push.outputs.sha }}\n steps:\n - name: Checkout main\n uses: actions/checkout@v6\n with:\n ref: main\n fetch-depth: 0\n token: ${{ secrets.RELEASE_TOKEN }}\n\n - name: Setup Gradle Environment\n uses: ./.github/actions/setup-gradle\n\n - name: Configure git\n run: |\n git config user.name \"github-actions[bot]\"\n git config user.email \"github-actions[bot]@users.noreply.github.com\"\n\n - name: Bump build number\n id: bump\n run: |\n ./gradlew bumpVersion -Ptype=beta\n version=$(grep 'VERSION_NUMBER' version.txt | sed 's/.*= *//')\n build=$(grep 'BUILD_NUMBER' version.txt | sed 's/.*= *//')\n echo \"version=$version\" >> \"$GITHUB_OUTPUT\"\n echo \"build=$build\" >> \"$GITHUB_OUTPUT\"\n echo \"Version: $version, BUILD_NUMBER: $build\"\n\n - name: Commit and push\n id: push\n run: |\n git add version.txt\n git commit -m \"chore: bump daily build number to ${{ steps.bump.outputs.build }}\"\n git push origin main\n echo \"sha=$(git rev-parse HEAD)\" >> \"$GITHUB_OUTPUT\"\n\n build-android:\n needs: prepare\n runs-on: ubuntu-latest\n steps:\n - name: Checkout\n uses: actions/checkout@v6\n with:\n ref: ${{ needs.prepare.outputs.sha }}\n\n - name: Setup Android Release\n uses: ./.github/actions/setup-android-release\n with:\n google-services-json: ${{ secrets.GOOGLE_SERVICES_JSON_RELEASE }}\n signing-encrypt-key: ${{ secrets.SIGNING_ENCRYPT_KEY }}\n\n - name: Build release AAB and APK\n env:\n SIGNING_STORE_PASSWORD: ${{ secrets.SIGNING_STORE_PASSWORD }}\n SIGNING_KEY_PASSWORD: ${{ secrets.SIGNING_KEY_PASSWORD }}\n run: |\n ./gradlew :app:bundleRelease :app:assembleRelease \\\n -Pandroidx.baselineprofile.skipgeneration=true \\\n -Papp.debugOnly=false \\\n -Papp.versionSuffix=-dev \\\n -PreleaseStoreFile=release/app-release.jks \\\n -PreleaseStorePassword=\"$SIGNING_STORE_PASSWORD\" \\\n -PreleaseKeyAlias=tvmaniac \\\n -PreleaseKeyPassword=\"$SIGNING_KEY_PASSWORD\" \\\n --no-configuration-cache\n\n - name: Print build info\n run: |\n echo \"Version: $(grep 'VERSION_NUMBER' version.txt | sed 's/.*= *//')-dev\"\n echo \"Build: $(grep 'BUILD_NUMBER' version.txt | sed 's/.*= *//')\"\n\n - name: Deploy to Play Store internal track\n run: |\n export PLAY_STORE_SERVICE_ACCOUNT_JSON=$(cat release/play-service-account.json)\n bundle exec fastlane android deploy_play_store\n\n - name: Distribute to Firebase App Distribution\n env:\n FIREBASE_APP_ID: ${{ secrets.FIREBASE_APP_ID }}\n run: |\n if [ -n \"$FIREBASE_APP_ID\" ] && [ -f \"release/firebase-sa.json\" ]; then\n export FIREBASE_APP_DISTRIBUTION_SA=release/firebase-sa.json\n bundle exec fastlane android distribute_firebase\n else\n echo \"warning: Firebase not configured โ€” skipping distribution\"\n fi\n\n build-ios:\n needs: prepare\n runs-on: macos-15\n timeout-minutes: 60\n env:\n FASTLANE_XCODEBUILD_SETTINGS_TIMEOUT: 60\n steps:\n - name: Checkout\n uses: actions/checkout@v6\n with:\n ref: ${{ needs.prepare.outputs.sha }}\n\n - name: Setup iOS Release\n uses: ./.github/actions/setup-ios-release\n with:\n xcode-version: ${{ env.XCODE_VERSION }}\n google-service-info-plist: ${{ secrets.GOOGLE_SERVICE_INFO_PLIST_RELEASE }}\n\n - name: Build and upload to TestFlight\n env:\n MATCH_GIT_URL: ${{ secrets.MATCH_GIT_URL }}\n MATCH_PASSWORD: ${{ secrets.MATCH_PASSWORD }}\n APP_STORE_CONNECT_API_KEY_ID: ${{ secrets.APP_STORE_CONNECT_API_KEY_ID }}\n APP_STORE_CONNECT_ISSUER_ID: ${{ secrets.APP_STORE_CONNECT_ISSUER_ID }}\n APP_STORE_CONNECT_API_KEY: ${{ secrets.APP_STORE_CONNECT_API_KEY }}\n run: bundle exec fastlane ios build_beta\n\n - name: Upload iOS artifacts\n uses: actions/upload-artifact@v7\n if: always()\n with:\n name: ios-daily\n path: |\n build/\n fastlane/logs\n" }, { "path": ".github/workflows/nightly-integration-tests.yml", "content": "name: Nightly Integration Tests\n\non:\n schedule:\n - cron: '30 1 * * *'\n workflow_dispatch:\n workflow_call:\n\nconcurrency:\n group: nightly-integration-tests-${{ github.ref }}\n cancel-in-progress: false\n\nenv:\n TMDB_API_KEY: ${{ secrets.TMDB_API_KEY }}\n TRAKT_CLIENT_ID: ${{ secrets.TRAKT_CLIENT_ID }}\n TRAKT_CLIENT_SECRET: ${{ secrets.TRAKT_CLIENT_SECRET }}\n TRAKT_REDIRECT_URI: ${{ secrets.TRAKT_REDIRECT_URI }}\n\njobs:\n integration-tests:\n name: \"Pixel 6 API 34 Integration Tests\"\n runs-on: ubuntu-latest\n timeout-minutes: 90\n\n steps:\n - name: ๐Ÿšš Checkout\n uses: actions/checkout@v6\n\n - name: Enable KVM\n run: |\n echo 'KERNEL==\"kvm\", GROUP=\"kvm\", MODE=\"0666\", OPTIONS+=\"static_node=kvm\"' | sudo tee /etc/udev/rules.d/99-kvm4all.rules\n sudo udevadm control --reload-rules\n sudo udevadm trigger --name-match=kvm\n\n - name: ๐Ÿ˜ Setup Gradle Environment\n uses: ./.github/actions/setup-gradle\n\n - name: Setup Android SDK\n uses: android-actions/setup-android@v4\n\n - name: Accept licenses\n run: yes | sdkmanager --licenses || true\n\n - name: ๐Ÿ“ฆ Cache AVD\n uses: actions/cache@v5\n with:\n path: |\n ~/.android/avd/*\n ~/.android/adb*\n ~/.android/debug.keystore\n key: avd-pixel6Api34-${{ hashFiles('gradle/libs.versions.toml') }}\n restore-keys: |\n avd-pixel6Api34-\n\n - name: ๐Ÿ”ฅ Install google-services.json\n env:\n GOOGLE_SERVICES_JSON: ${{ secrets.GOOGLE_SERVICES_JSON }}\n run: |\n if [ -n \"$GOOGLE_SERVICES_JSON\" ]; then\n echo \"$GOOGLE_SERVICES_JSON\" | base64 --decode > app/google-services.json\n else\n echo \"warning: GOOGLE_SERVICES_JSON secret not set โ€” Firebase will be disabled\"\n fi\n\n - name: ๐Ÿค– Run Integration Tests on Emulator\n run: |\n ./gradlew :app:pixel6Api34DebugAndroidTest \\\n -Pandroid.testoptions.manageddevices.emulator.gpu=\"swiftshader_indirect\" \\\n --no-configuration-cache\n\n - name: ๐Ÿ“Š Upload Test Reports\n if: ${{ !cancelled() }}\n uses: actions/upload-artifact@v7\n with:\n name: integration-test-reports\n path: |\n app/build/reports/androidTests/\n app/build/outputs/androidTest-results/\n app/build/outputs/managed_device_android_test_additional_output/\n if-no-files-found: ignore\n" }, { "path": ".github/workflows/promote-release.yml", "content": "name: Promote Release\n\non:\n # schedule:\n # - cron: '0 5 * * *'\n workflow_dispatch:\n inputs:\n android_rollout:\n description: 'Android rollout percentage override (e.g., 0.5 for 50%)'\n type: string\n required: false\n skip_ios:\n description: 'Skip iOS App Store submission'\n type: boolean\n default: false\n crash_free_threshold:\n description: 'Minimum crash-free rate (%) to allow promotion'\n type: string\n default: '99.0'\n\npermissions:\n contents: read\n\nenv:\n TMDB_API_KEY: ${{ secrets.TMDB_API_KEY }}\n TRAKT_CLIENT_ID: ${{ secrets.TRAKT_CLIENT_ID }}\n TRAKT_CLIENT_SECRET: ${{ secrets.TRAKT_CLIENT_SECRET }}\n TRAKT_REDIRECT_URI: ${{ secrets.TRAKT_REDIRECT_URI }}\n\njobs:\n check-rollout:\n runs-on: ubuntu-latest\n outputs:\n should_promote: ${{ steps.check.outputs.should_promote }}\n next_rollout: ${{ steps.check.outputs.next_rollout }}\n current_rollout: ${{ steps.check.outputs.current_rollout }}\n release_tag: ${{ steps.check.outputs.release_tag }}\n days_since_release: ${{ steps.check.outputs.days_since_release }}\n steps:\n - name: Checkout\n uses: actions/checkout@v6\n with:\n fetch-depth: 0\n\n - name: Determine rollout state\n id: check\n run: |\n if [ -n \"${{ inputs.android_rollout }}\" ]; then\n echo \"should_promote=true\" >> \"$GITHUB_OUTPUT\"\n echo \"next_rollout=${{ inputs.android_rollout }}\" >> \"$GITHUB_OUTPUT\"\n echo \"current_rollout=manual\" >> \"$GITHUB_OUTPUT\"\n echo \"days_since_release=manual\" >> \"$GITHUB_OUTPUT\"\n latest_tag=$(git tag --list 'v[0-9]*.[0-9]*.[0-9]*' --sort=-version:refname | head -1)\n echo \"release_tag=$latest_tag\" >> \"$GITHUB_OUTPUT\"\n exit 0\n fi\n\n latest_tag=$(git tag --list 'v[0-9]*.[0-9]*.[0-9]*' --sort=-version:refname | head -1)\n if [ -z \"$latest_tag\" ]; then\n echo \"No release tags found\"\n echo \"should_promote=false\" >> \"$GITHUB_OUTPUT\"\n exit 0\n fi\n\n tag_epoch=$(git log -1 --format=%ct \"$latest_tag\")\n now_epoch=$(date +%s)\n days_since=$(( (now_epoch - tag_epoch) / 86400 ))\n\n # Rollout schedule: Day 0=0.1%, Day 1=1%, Day 3=10%, Day 5=50%, Day 7=100%\n if [ \"$days_since\" -ge 7 ]; then\n next_rollout=\"1.0\"\n elif [ \"$days_since\" -ge 5 ]; then\n next_rollout=\"0.5\"\n elif [ \"$days_since\" -ge 3 ]; then\n next_rollout=\"0.1\"\n elif [ \"$days_since\" -ge 1 ]; then\n next_rollout=\"0.01\"\n else\n echo \"Day 0: release just deployed at 0.1%, no promotion needed yet\"\n echo \"should_promote=false\" >> \"$GITHUB_OUTPUT\"\n exit 0\n fi\n\n echo \"should_promote=true\" >> \"$GITHUB_OUTPUT\"\n echo \"next_rollout=$next_rollout\" >> \"$GITHUB_OUTPUT\"\n echo \"days_since_release=$days_since\" >> \"$GITHUB_OUTPUT\"\n echo \"release_tag=$latest_tag\" >> \"$GITHUB_OUTPUT\"\n echo \"Release: $latest_tag, Days since: $days_since, Next rollout: $next_rollout\"\n\n check-vitals:\n needs: check-rollout\n if: ${{ needs.check-rollout.outputs.should_promote == 'true' }}\n runs-on: ubuntu-latest\n outputs:\n passed: ${{ steps.vitals.outputs.passed }}\n steps:\n - name: Checkout\n uses: actions/checkout@v6\n\n - name: Decrypt Play Store service account\n env:\n SIGNING_ENCRYPT_KEY: ${{ secrets.SIGNING_ENCRYPT_KEY }}\n run: |\n openssl aes-256-cbc -d -pbkdf2 \\\n -in release/play-service-account.aes \\\n -out release/play-service-account.json \\\n -k \"$SIGNING_ENCRYPT_KEY\"\n\n - name: Check Play Vitals crash-free Rate\n id: vitals\n run: |\n THRESHOLD=\"${{ inputs.crash_free_threshold }}\"\n THRESHOLD=\"${THRESHOLD:-99.0}\"\n APP_PACKAGE=\"com.thomaskioko.tvmaniac\"\n\n if ! gcloud auth activate-service-account --key-file=release/play-service-account.json 2>/dev/null; then\n echo \"::warning::Could not authenticate โ€” skipping vitals check\"\n echo \"passed=true\" >> \"$GITHUB_OUTPUT\"\n exit 0\n fi\n\n ACCESS_TOKEN=$(gcloud auth print-access-token 2>/dev/null || true)\n if [ -z \"$ACCESS_TOKEN\" ]; then\n echo \"::warning::Could not obtain access token โ€” skipping vitals check\"\n echo \"passed=true\" >> \"$GITHUB_OUTPUT\"\n exit 0\n fi\n\n END_DATE=$(date -u +%Y-%m-%d)\n START_DATE=$(date -u -d \"7 days ago\" +%Y-%m-%d)\n\n RESPONSE=$(curl -sf \\\n -H \"Authorization: Bearer $ACCESS_TOKEN\" \\\n -H \"Content-Type: application/json\" \\\n -X POST \\\n \"https://playdeveloperreporting.googleapis.com/v1beta1/apps/${APP_PACKAGE}/crashRateMetricSet:query\" \\\n -d \"{\n \\\"timelineSpec\\\": {\n \\\"aggregationPeriod\\\": \\\"DAILY\\\",\n \\\"startTime\\\": {\n \\\"year\\\": $(date -u -d \"$START_DATE\" +%Y),\n \\\"month\\\": $(date -u -d \"$START_DATE\" +%-m),\n \\\"day\\\": $(date -u -d \"$START_DATE\" +%-d)\n },\n \\\"endTime\\\": {\n \\\"year\\\": $(date -u -d \"$END_DATE\" +%Y),\n \\\"month\\\": $(date -u -d \"$END_DATE\" +%-m),\n \\\"day\\\": $(date -u -d \"$END_DATE\" +%-d)\n }\n },\n \\\"metrics\\\": [\\\"crashRate\\\"],\n \\\"dimensions\\\": []\n }\" 2>/dev/null) || true\n\n if [ -z \"$RESPONSE\" ]; then\n echo \"::warning::Play Vitals API unavailable โ€” skipping crash check\"\n echo \"::warning::To enable: activate the Play Developer Reporting API and grant the service account 'View app information' permission\"\n echo \"passed=true\" >> \"$GITHUB_OUTPUT\"\n exit 0\n fi\n\n CRASH_RATE=$(echo \"$RESPONSE\" | jq -r '[.rows[].metrics[0].decimalValue.value // \"0\"] | last' 2>/dev/null || echo \"\")\n\n if [ -z \"$CRASH_RATE\" ] || [ \"$CRASH_RATE\" = \"null\" ]; then\n echo \"::warning::Could not parse crash rate โ€” skipping check\"\n echo \"passed=true\" >> \"$GITHUB_OUTPUT\"\n exit 0\n fi\n\n CRASH_FREE=$(echo \"scale=2; (1 - $CRASH_RATE) * 100\" | bc -l)\n echo \"Crash-free rate: ${CRASH_FREE}% (threshold: ${THRESHOLD}%)\"\n echo \"crash_free_rate=${CRASH_FREE}\" >> \"$GITHUB_OUTPUT\"\n\n if (( $(echo \"$CRASH_FREE < $THRESHOLD\" | bc -l) )); then\n echo \"::error::Crash-free rate ${CRASH_FREE}% is below threshold ${THRESHOLD}% โ€” blocking promotion\"\n echo \"passed=false\" >> \"$GITHUB_OUTPUT\"\n else\n echo \"passed=true\" >> \"$GITHUB_OUTPUT\"\n fi\n\n promote-android:\n needs: [check-rollout, check-vitals]\n if: ${{ needs.check-rollout.outputs.should_promote == 'true' && needs.check-vitals.outputs.passed == 'true' }}\n runs-on: ubuntu-latest\n environment: production\n steps:\n - name: Checkout\n uses: actions/checkout@v6\n\n - name: Setup Ruby\n uses: ruby/setup-ruby@v1\n with:\n bundler-cache: true\n\n - name: Decrypt Play Store service account\n env:\n SIGNING_ENCRYPT_KEY: ${{ secrets.SIGNING_ENCRYPT_KEY }}\n run: |\n openssl aes-256-cbc -d -pbkdf2 -in release/play-service-account.aes -out release/play-service-account.json -k \"$SIGNING_ENCRYPT_KEY\"\n\n - name: Promote Android release\n run: |\n export PLAY_STORE_SERVICE_ACCOUNT_JSON=$(cat release/play-service-account.json)\n bundle exec fastlane android promote \\\n from:production \\\n to:production \\\n rollout:${{ needs.check-rollout.outputs.next_rollout }}\n\n - name: Summary\n run: |\n echo \"### Android Promotion\" >> $GITHUB_STEP_SUMMARY\n echo \"- **Release**: ${{ needs.check-rollout.outputs.release_tag }}\" >> $GITHUB_STEP_SUMMARY\n echo \"- **Days since release**: ${{ needs.check-rollout.outputs.days_since_release }}\" >> $GITHUB_STEP_SUMMARY\n echo \"- **Rollout**: ${{ needs.check-rollout.outputs.next_rollout }}\" >> $GITHUB_STEP_SUMMARY\n echo \"- **Vitals**: crash-free ${{ needs.check-vitals.outputs.crash_free_rate || 'N/A' }}%\" >> $GITHUB_STEP_SUMMARY\n\n promote-ios:\n needs: [check-rollout, check-vitals]\n if: ${{ needs.check-rollout.outputs.should_promote == 'true' && !inputs.skip_ios }}\n runs-on: ubuntu-latest\n environment: production\n steps:\n - name: Checkout\n uses: actions/checkout@v6\n\n - name: Setup Ruby\n uses: ruby/setup-ruby@v1\n with:\n bundler-cache: true\n\n - name: Submit to App Store\n env:\n APP_STORE_CONNECT_API_KEY_ID: ${{ secrets.APP_STORE_CONNECT_API_KEY_ID }}\n APP_STORE_CONNECT_ISSUER_ID: ${{ secrets.APP_STORE_CONNECT_ISSUER_ID }}\n APP_STORE_CONNECT_API_KEY: ${{ secrets.APP_STORE_CONNECT_API_KEY }}\n IOS_SUBMIT_FOR_REVIEW: \"true\"\n run: bundle exec fastlane ios deploy_app_store\n\n - name: Summary\n run: |\n echo \"### iOS Promotion\" >> $GITHUB_STEP_SUMMARY\n echo \"- **Release**: ${{ needs.check-rollout.outputs.release_tag }}\" >> $GITHUB_STEP_SUMMARY\n echo \"- **Action**: Submitted for App Store review\" >> $GITHUB_STEP_SUMMARY\n" }, { "path": ".github/workflows/release.yml", "content": "name: Release\n\non:\n push:\n tags:\n - 'v[0-9]+.[0-9]+.[0-9]+'\n\npermissions:\n contents: write\n\nenv:\n XCODE_VERSION: 16.4\n TMDB_API_KEY: ${{ secrets.TMDB_API_KEY }}\n TRAKT_CLIENT_ID: ${{ secrets.TRAKT_CLIENT_ID }}\n TRAKT_CLIENT_SECRET: ${{ secrets.TRAKT_CLIENT_SECRET }}\n TRAKT_REDIRECT_URI: ${{ secrets.TRAKT_REDIRECT_URI }}\n\njobs:\n prepare:\n runs-on: ubuntu-latest\n outputs:\n version: ${{ steps.info.outputs.version }}\n changelog: ${{ steps.changelog.outputs.body }}\n steps:\n - name: Checkout tag\n uses: actions/checkout@v6\n with:\n fetch-depth: 0\n\n - name: Setup Gradle Environment\n uses: ./.github/actions/setup-gradle\n\n - name: Read version info\n id: info\n run: |\n version=$(grep 'VERSION_NUMBER' version.txt | sed 's/.*= *//')\n build=$(grep 'BUILD_NUMBER' version.txt | sed 's/.*= *//')\n echo \"version=$version\" >> \"$GITHUB_OUTPUT\"\n echo \"build=$build\" >> \"$GITHUB_OUTPUT\"\n echo \"Version: $version, Build: $build, Tag: ${{ github.ref_name }}\"\n\n - name: Validate tag matches version.txt\n run: |\n tag=\"${{ github.ref_name }}\"\n version=$(grep 'VERSION_NUMBER' version.txt | sed 's/.*= *//')\n expected_tag=\"v${version}\"\n if [ \"$tag\" != \"$expected_tag\" ]; then\n echo \"::error::Tag '$tag' does not match version.txt version '$expected_tag'\"\n exit 1\n fi\n\n - name: Generate release notes\n id: changelog\n run: |\n body=$(git cliff --current --strip header 2>/dev/null || echo \"Release ${{ github.ref_name }}\")\n {\n echo 'body<> \"$GITHUB_OUTPUT\"\n\n build-android:\n needs: prepare\n runs-on: ubuntu-latest\n steps:\n - name: Checkout tag\n uses: actions/checkout@v6\n with:\n fetch-depth: 0\n\n - name: Setup Android Release\n uses: ./.github/actions/setup-android-release\n with:\n google-services-json: ${{ secrets.GOOGLE_SERVICES_JSON_RELEASE }}\n signing-encrypt-key: ${{ secrets.SIGNING_ENCRYPT_KEY }}\n\n - name: Build release AAB and APK\n env:\n SIGNING_STORE_PASSWORD: ${{ secrets.SIGNING_STORE_PASSWORD }}\n SIGNING_KEY_PASSWORD: ${{ secrets.SIGNING_KEY_PASSWORD }}\n run: |\n ./gradlew :app:bundleRelease :app:assembleRelease \\\n -Pandroidx.baselineprofile.skipgeneration=true \\\n -Papp.debugOnly=false \\\n -Papp.versionSuffix= \\\n -PreleaseStoreFile=release/app-release.jks \\\n -PreleaseStorePassword=\"$SIGNING_STORE_PASSWORD\" \\\n -PreleaseKeyAlias=tvmaniac \\\n -PreleaseKeyPassword=\"$SIGNING_KEY_PASSWORD\" \\\n --no-configuration-cache\n\n - name: Write release notes\n env:\n RELEASE_CHANGELOG: ${{ needs.prepare.outputs.changelog }}\n run: |\n mkdir -p fastlane/metadata/android/en-US/changelogs\n echo \"$RELEASE_CHANGELOG\" > fastlane/metadata/android/en-US/changelogs/default.txt\n\n - name: Deploy to Play Store production (0.1% rollout)\n run: |\n export PLAY_STORE_SERVICE_ACCOUNT_JSON=$(cat release/play-service-account.json)\n bundle exec fastlane android deploy_production rollout:0.001\n\n - name: Distribute to Firebase App Distribution\n env:\n FIREBASE_APP_ID: ${{ secrets.FIREBASE_APP_ID }}\n run: |\n if [ -n \"$FIREBASE_APP_ID\" ] && [ -f \"release/firebase-sa.json\" ]; then\n export FIREBASE_APP_DISTRIBUTION_SA=release/firebase-sa.json\n bundle exec fastlane android distribute_firebase\n else\n echo \"warning: Firebase not configured - skipping distribution\"\n fi\n\n - name: Upload Android artifacts\n uses: actions/upload-artifact@v7\n with:\n name: android-release\n path: |\n app/build/outputs/bundle/release/*.aab\n app/build/outputs/apk/release/*.apk\n\n build-ios:\n needs: prepare\n runs-on: macos-15\n timeout-minutes: 60\n env:\n FASTLANE_XCODEBUILD_SETTINGS_TIMEOUT: 60\n steps:\n - name: Checkout tag\n uses: actions/checkout@v6\n\n - name: Setup iOS Release\n uses: ./.github/actions/setup-ios-release\n with:\n xcode-version: ${{ env.XCODE_VERSION }}\n google-service-info-plist: ${{ secrets.GOOGLE_SERVICE_INFO_PLIST_RELEASE }}\n\n - name: Build and upload to TestFlight\n env:\n MATCH_GIT_URL: ${{ secrets.MATCH_GIT_URL }}\n MATCH_PASSWORD: ${{ secrets.MATCH_PASSWORD }}\n APP_STORE_CONNECT_API_KEY_ID: ${{ secrets.APP_STORE_CONNECT_API_KEY_ID }}\n APP_STORE_CONNECT_ISSUER_ID: ${{ secrets.APP_STORE_CONNECT_ISSUER_ID }}\n APP_STORE_CONNECT_API_KEY: ${{ secrets.APP_STORE_CONNECT_API_KEY }}\n run: bundle exec fastlane ios build_release\n\n - name: Upload iOS artifacts\n uses: actions/upload-artifact@v7\n if: always()\n with:\n name: ios-release\n path: |\n build/\n fastlane/logs\n\n create-github-release:\n needs: [prepare, build-android, build-ios]\n if: ${{ always() && (needs.build-android.result == 'success' || needs.build-ios.result == 'success') }}\n runs-on: ubuntu-latest\n steps:\n - name: Checkout\n uses: actions/checkout@v6\n\n - name: Download Android artifacts\n if: ${{ needs.build-android.result == 'success' }}\n uses: actions/download-artifact@v8\n with:\n name: android-release\n path: artifacts/android\n\n - name: Create GitHub Release\n env:\n GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}\n run: |\n tag=\"${{ github.ref_name }}\"\n version=\"${tag#v}\"\n\n release_args=(\n \"$tag\"\n --title \"Release $version\"\n --notes \"${{ needs.prepare.outputs.changelog }}\"\n --draft\n )\n\n if [ -d \"artifacts/android\" ]; then\n apk=$(find artifacts/android -name \"*.apk\" -type f | head -1)\n if [ -n \"$apk\" ]; then\n release_args+=(\"$apk\")\n fi\n fi\n\n gh release create \"${release_args[@]}\"\n" }, { "path": ".github/workflows/store-screenshot.yml", "content": "name: Store Screenshot\n\non:\n push:\n branches:\n - main\n\npermissions: {}\n\nenv:\n TMDB_API_KEY: ${{ secrets.TMDB_API_KEY }}\n TRAKT_CLIENT_ID: ${{ secrets.TRAKT_CLIENT_ID }}\n TRAKT_CLIENT_SECRET: ${{ secrets.TRAKT_CLIENT_SECRET }}\n TRAKT_REDIRECT_URI: ${{ secrets.TRAKT_REDIRECT_URI }}\n\njobs:\n store-screenshot-test:\n runs-on: ubuntu-latest\n timeout-minutes: 20\n\n permissions:\n contents: read # for clone\n actions: write # for upload-artifact\n\n steps:\n - name: Checkout\n uses: actions/checkout@v6\n\n - name: Setup Gradle Environment\n uses: ./.github/actions/setup-gradle\n\n - name: Record screenshot\n id: record-test\n run: |\n # Use --rerun-tasks to disable cache for test task\n ./gradlew recordRoborazziDebug --stacktrace --rerun-tasks\n\n - uses: actions/upload-artifact@v7\n if: ${{ always() }}\n with:\n name: screenshot\n path: |\n **/build/outputs/roborazzi\n retention-days: 30\n\n - uses: actions/upload-artifact@v7\n if: ${{ always() }}\n with:\n name: screenshot-reports\n path: |\n **/build/reports\n retention-days: 30\n\n - uses: actions/upload-artifact@v7\n if: ${{ always() }}\n with:\n name: screenshot-test-results\n path: |\n **/build/test-results\n retention-days: 30\n" }, { "path": ".gitignore", "content": "# Built application files\n*.apk\n*.ap_\n\n# Files for the ART/Dalvik VM\n*.dex\n\n# Java class files\n*.class\n\n# Generated files\nbin/\ngen/\nout/\n\n# Gradle files\n.gradle/\nbuild/\n.kotlin/\n/build\n\n# Local configuration file (sdk path, etc)\nlocal.properties\n\n# Proguard folder generated by Eclipse\nproguard/\n\n# Log Files\n*.log\n\n# Android Studio Navigation editor temp files\n.navigation/\n\n# Android Studio captures folder\ncaptures/\n\n# Android Studio\n*.iws\n*.ipr\n*.iml\n.gradle\n/local.properties\n.DS_Store\n/build\n/captures\n.externalNativeBuild\n.cxx\n\n/.idea/*\n!/.idea/codeStyles\n!/.idea/dictionaries\n\n# Eclipse project files\n.classpath\n.project\n\n## Playgrounds\ntimeline.xctimeline\nplayground.xcworkspace\n\n## Shared\n/shared/domain/settings/implementation/*.preferences_pb\n\n*.xcworkspacedata\n*.xcuserstate\nxcschememanagement.plist\n*.xcbkptlist\n\n## User settings\nxcuserdata/\n\n## compatibility with Xcode 3 and earlier (ignoring not required starting Xcode 4)\nDerivedData/\n*.moved-aside\n*.pbxuser\n!default.pbxuser\n*.mode1v3\n!default.mode1v3\n*.mode2v3\n!default.mode2v3\n*.perspectivev3\n!default.perspectivev3\n\n*.xcuserstate\n\n###### FastLane #######\nfastlane/report.xml\nfastlane/Preview.html\nfastlane/test_output\nfastlane/builds\n/ios/fastlane/report.xml\nios/build\nios/SourcePackages/\n\nderived_data/\n*.xcresult\n\n/.junie/guidelines.md\n/tasks\nCLAUDE.md\n.claude/\n\n# Configuration files with secrets\n**/dev.yaml\n**/prod.yaml\n!**/*.yaml.template\n**/.build/\n**/Package.resolved\n\n# Firebase\ngoogle-services.json\nGoogleService-Info.plist\n\n# Release signing\nrelease/app-release.jks\nrelease/play-service-account.json\nrelease/firebase-sa.json\nrelease/signing.properties\n" }, { "path": ".idea/codeStyles/Project.xml", "content": "\n \n \n \n \n \n \n \n \n \n \n \n" }, { "path": ".idea/codeStyles/codeStyleConfig.xml", "content": "\n \n \n" }, { "path": ".idea/dictionaries/project.xml", "content": "\n \n \n tmdb\n trakt\n \n \n\n" }, { "path": ".ruby-version", "content": "3.3.0\n" }, { "path": ".swiftformat", "content": "--indent 4\n--exclude ios/build,ios/Modules/*/.build,**/.build,**/build,**/ios-framework/build,ios/SourcePackages,ios/derived_data,**/SourcePackages,**/derived_data,**/checkouts\n" }, { "path": ".swiftlint.yml", "content": "cyclomatic_complexity:\n warning: 15\n error: 20\n\nfunction_body_length:\n warning: 75\n error: 100\n\ndisabled_rules:\n - todo\n - trailing_whitespace\n - trailing_comma\n - trailing_newline\n - identifier_name\n - type_name\n - multiple_closures_with_trailing_closure\n - type_body_length\n - line_length\n - opening_brace\n - leading_whitespace\n - void_function_in_ternary\n\nopt_in_rules:\n - sorted_imports\n\n\n# Files & Folder not to check\nexcluded:\n - .build\n - \"**/build\"\n - \"**/.build\"\n - \"**/checkouts\"\n - \"**/SourcePackages\"\n - derived_data\n - DerivedData\n - ios/Modules/SnapshotTestingLib\n - ios/build\n - vendor/bundle\n - ios-framework/build\n" }, { "path": "CHANGELOG.md", "content": "# Changelog\n\nAll notable changes to this project will be documented in this file.\n\n## [0.1.2] - 2026-03-25\n\n### Bug Fixes\n\n- **Android**: Fix SnackBar shown in error state.\n- **auth**: Update Trakt token endpoint and client authentication method\n- update Firebase distribution path to use release APK\n- fix linting\n### CI/CD\n\n- Ignore iOS tests in watchlist module\n### Features\n\n- **i18n**: Add new strings for marking episodes\n- **ios**: Configure background processing and fetch modes\n- enable experimental R8 optimized resource shrinking\n- enable mapping file upload for Firebase Crashlytics in release build\n- Add query to get the latest season for followed shows\n- Add episode notification scheduling tasks\n- Add 'Auto' image quality setting and optimize image loading\n- Add `season_numbers` to `TvShow` SQL queries\n- Refactor theme implementation in settings\n### Miscellaneous\n\n- update release workflow to use release-specific secrets and add signing files to .gitignore\n- add encrypted signing keys\n" }, { "path": "CONTRIBUTING.md", "content": "# Contributing to TvManiac\n\nTvManiac is a personal learning playground for Kotlin Multiplatform development. Contributions that fix bugs,\nimprove documentation, or demonstrate KMP patterns are welcome.\n\n## Prerequisites\n\n| Tool | Version |\n|---|---|\n| JDK | 21 (Zulu recommended: https://www.azul.com/downloads/?package=jdk#zulu) |\n| Android Studio | Latest stable or canary |\n| Xcode | 16.4 (iOS contributions) |\n| KMM Plugin | Latest compatible with the Kotlin version in `gradle/libs.versions.toml` |\n\nCocoaPods is not used. The iOS app consumes the shared KMP framework as an XCFramework built by Gradle.\n\n## Cloning and Initial Setup\n\n```bash\ngit clone https://github.com/thomaskioko/tv-maniac.git\ncd tv-maniac\n./scripts/install-git-hooks.sh\n```\n\nThe git hooks run Spotless formatting checks before each commit. A commit is blocked if formatting fails.\nFix formatting with `./gradlew spotlessApply` and then re-commit.\n\n### API Keys\n\nThe app requires TMDB and Trakt credentials at build time. See [docs/setup.md](docs/setup.md) for how to\nobtain them. Create `local.properties` in the project root:\n\n```properties\nTMDB_API_KEY=your_tmdb_api_key\nTRAKT_CLIENT_ID=your_trakt_client_id\nTRAKT_CLIENT_SECRET=your_trakt_client_secret\nTRAKT_REDIRECT_URI=tvmaniac://callback\n```\n\nThis file is gitignored. Do not commit it.\n\n## Building\n\n**Android (debug):**\n\n```bash\n./gradlew :app:assembleDebug\n```\n\nFor a faster local build that skips the iOS XCFramework:\n\n```bash\n./gradlew assembleDebug -Ptvmaniac.debugOnly=true\n```\n\n**iOS:**\n\nOpen `ios/tv-maniac.xcodeproj` in Xcode 16.4, select a simulator or device, and run.\n\n## Running Tests\n\n```bash\n# JVM unit tests (fast, no device needed)\n./gradlew jvmTest\n\n# Android connected tests (requires a running emulator or device)\n./gradlew connectedAndroidTest\n\n# iOS simulator tests\n./gradlew iosSimulatorArm64Test -Papp.enableIos=true\n```\n\n## Code Style\n\n**Kotlin:**\n\n- 2-space indentation, 140-character line length.\n- Use `ImmutableList` and `toImmutableList()` from `kotlinx.collections.immutable` for state classes.\n- No try-catch blocks that silently swallow errors. Propagate exceptions up to the presentation layer.\n- Fakes, not mocks. Each `data/*/testing` module provides fake implementations for tests.\n- Test names follow the pattern: `should X given Y`. Do not include function names in test names.\n- Spotless enforces formatting. Run `./gradlew spotlessApply` before pushing.\n\n**Swift:**\n\n- Follow the Swift API Design Guidelines.\n- Format with SwiftFormat. Check with `fastlane ios check_swift_format` before pushing.\n- Do not add business logic to SwiftUI views. Views consume shared KMP presenters only.\n\n**General:**\n\n- No comments in code unless the intent cannot be expressed through naming.\n- Always specify access modifiers on all Kotlin declarations.\n- Business logic belongs in shared KMP code (`domain/*`, `data/*`), never in platform UI layers.\n\n## Branching and Pull Requests\n\n1. Fork the repository and create your branch from `main`.\n2. Keep branches focused on a single concern. Large refactors should be discussed in an issue first.\n3. Ensure CI passes: Spotless, unit tests, and lint checks must all be green.\n4. Include a clear description in your PR: what changed, why, and how to test it.\n5. Reference any related issue with `Closes #123` or `Relates to #123` in the PR body.\n\nPRs that add new architectural patterns should also update the relevant file under `docs/architecture/`.\n\n## Architecture Overview\n\nBefore contributing, read the architecture docs so your change fits the existing patterns:\n\n- [Modularization](docs/architecture/modularization.md)\n- [Presentation Layer](docs/architecture/presentation-layer.md)\n- [Data Layer](docs/architecture/data-layer.md)\n- [Navigation](docs/architecture/navigation.md)\n- [Dependency Injection](docs/architecture/dependency-injection.md)\n\n## Filing Bugs and Questions\n\nOpen an issue on GitHub. Use the bug report template for reproducible defects and the feature request\ntemplate for new ideas. For open-ended questions, open a GitHub issue with the `question` label.\n" }, { "path": "GEMINI.md", "content": "# TV Maniac Agent Rules\n\n## Project Overview\nTV Maniac is a Kotlin Multiplatform (KMP) project for tracking TV shows. It follows a highly modularized Clean Architecture with a strict separation of concerns.\n\n## Architecture & Tech Stack\n- **KMP**: Shared business logic, state management, and data layer.\n- **Clean Architecture**: Organized into `data`, `domain`, `presenter`, and `ui` layers.\n- **Metro**: A custom compile-time Dependency Injection (DI) system.\n- **Decompose**: Used for shared navigation and lifecycle management.\n- **Store 5**: Used for data fetching (Fetcher) and caching (SourceOfTruth).\n- **SQLDelight**: Local persistence.\n- **UI**: Jetpack Compose for Android, SwiftUI for iOS.\n\n## Core Mandates & Conventions\n\n### 1. Modularization & Dependencies\n- **Strict API/Implementation Split**: Most modules are split into `:api` and `:implementation` (or implicit).\n- **Rule**: Modules MUST depend on `api` modules of other features, never `implementation` (except for entry points like `:app` and `:ios-framework`).\n- **Feature Structure**: Features follow a 3-module split:\n - `nav`: Contains routes, parameters, and navigation-related DI.\n - `presenter`: Contains business logic, state management (MVI), and domain interactors.\n - `ui`: Contains platform-specific UI (Compose).\n\n### 2. Dependency Injection (Metro)\n- Use `@DependencyGraph`, `@GraphExtension`, and `@BindingContainer` for DI.\n- **Naming**:\n - DI interfaces MUST use the `*Graph` suffix.\n - Binding providers MUST use the `*BindingContainer` suffix.\n- **Scopes**:\n - `AppScope`: Singleton/Application lifetime.\n - `ActivityScope`: Activity lifetime.\n - `ScreenScope`: Decompose component lifetime.\n\n### 3. Navigation (Decompose)\n- Use `NavRoute` for standard navigation and `SheetConfig` for bottom sheets.\n- **Annotations**:\n - `@NavScreen`: Annotate presenters for standard screens.\n - `@NavSheet`: Annotate presenters for bottom sheets.\n - `@TabScreen`: Annotate presenters for tab screens.\n- **Codegen**: Navigation is largely handled via codegen based on these annotations.\n\n### 4. Presentation Layer (MVI)\n- **Presenters**:\n - MUST use `@AssistedInject` and have an `@AssistedFactory`.\n - MUST extend `ComponentContext` (via delegation).\n - MUST expose state as `Value` (for Decompose) or `StateFlow`.\n - MUST use a `dispatch(Action)` function for UI events.\n- **Naming**: `*Presenter`, `*Action`, `*Content` (for state).\n- **Standardized Helpers**:\n - Use `ObservableLoadingCounter` for tracking loading states.\n - Use `UiMessageManager` for managing transient UI messages (errors, snackbars).\n - Use `.collectStatus()` extension to handle flow statuses and pipe errors/loading to the above managers.\n\n### 5. Data Layer (Store)\n- Use `Store 5` for fetching and caching.\n- `Fetcher`: For network requests (Ktor).\n- `SourceOfTruth`: For local caching (SQLDelight).\n- `Validator`: To determine if cached data is still valid.\n\n### 6. Localization\n- **Rule**: Never use hardcoded strings or platform-specific string resources in shared code.\n- Use `Localizer` interface for shared string resolution.\n- Use `MR` (MOKO Resources) for string and plural definitions.\n- In Compose UI, use `resource.resolve(LocalContext.current)` or similar helpers.\n\n### 7. Coding Style\n- **Naming**: Use descriptive names. Suffix classes with their role (e.g., `Interactor`, `Repository`, `Presenter`).\n- **Types**: Prefer explicit types for public APIs.\n- **Immutability**: Use `kotlinx.collections.immutable` for state collections.\n\n### 8. Testing\n- **Prefer Fakes over Mocks**: Use hand-written fakes for repositories and interactors.\n- **Testing Modules**: Fakes should reside in a `:testing` module corresponding to the feature or layer.\n- **Navigator**: Use `TestNavigator` for asserting navigation events in presenter tests.\n- **Turbine**: Use Turbine for testing flows.\n\n### 9. Integration Testing\n- **Location**: Integration tests reside in the `:core:integration` module.\n- **TestGraph**: Use `TestGraph` to resolve dependencies. It provides a real dependency graph with specific components replaced by fakes (e.g., Network, DataStore).\n- **Execution**:\n - Use `runTestWithGraph { graph -> ... }` to run tests. This helper handles setting up the `TestGraph` and the `TestDispatcher`.\n - Ensure `Lifecycle.destroy()` is called and `advanceUntilIdle()` is used when testing presenters to prevent coroutine leaks.\n- **Platform Specifics**: Metro's graph factories are materialized per target. JVM and iOS variants of helpers must live in their respective source sets.\n- **Android**: Use `androidHostTest` for running integration tests on the JVM while having access to Android resources if needed.\n\n## Development Workflow\n1. **Feature Addition**:\n - Define `Route` in `nav`.\n - Implement `Interactor` in `domain` (if needed).\n - Implement `Presenter` in `presenter` using `@AssistedInject` and `@NavScreen`.\n - Implement `Screen` in `ui` using `@ScreenUi`.\n2. **Data Changes**:\n - Update SQLDelight `.sq` files.\n - Update `Store` configuration.\n - Update `Mapper` to convert database/network entities to domain/UI models.\n\n## Verification\n- Run `./gradlew lint` for Android linting.\n- Run `./gradlew test` for unit tests.\n- Ensure all DI graphs are valid by running a build.\n" }, { "path": "Gemfile", "content": "source \"https://rubygems.org\"\n\ngem \"fastlane\"\ngem \"xcode-install\"\ngem \"xcpretty\"\n\nplugins_path = File.join(File.dirname(__FILE__), 'fastlane', 'Pluginfile')\neval_gemfile(plugins_path) if File.exist?(plugins_path)\n" }, { "path": "LICENSE", "content": " Apache License\n Version 2.0, January 2004\n http://www.apache.org/licenses/\n\n TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION\n\n 1. Definitions.\n\n \"License\" shall mean the terms and conditions for use, reproduction,\n and distribution as defined by Sections 1 through 9 of this document.\n\n \"Licensor\" shall mean the copyright owner or entity authorized by\n the copyright owner that is granting the License.\n\n \"Legal Entity\" shall mean the union of the acting entity and all\n other entities that control, are controlled by, or are under common\n control with that entity. For the purposes of this definition,\n \"control\" means (i) the power, direct or indirect, to cause the\n direction or management of such entity, whether by contract or\n otherwise, or (ii) ownership of fifty percent (50%) or more of the\n outstanding shares, or (iii) beneficial ownership of such entity.\n\n \"You\" (or \"Your\") shall mean an individual or Legal Entity\n exercising permissions granted by this License.\n\n \"Source\" form shall mean the preferred form for making modifications,\n including but not limited to software source code, documentation\n source, and configuration files.\n\n \"Object\" form shall mean any form resulting from mechanical\n transformation or translation of a Source form, including but\n not limited to compiled object code, generated documentation,\n and conversions to other media types.\n\n \"Work\" shall mean the work of authorship, whether in Source or\n Object form, made available under the License, as indicated by a\n copyright notice that is included in or attached to the work\n (an example is provided in the Appendix below).\n\n \"Derivative Works\" shall mean any work, whether in Source or Object\n form, that is based on (or derived from) the Work and for which the\n editorial revisions, annotations, elaborations, or other modifications\n represent, as a whole, an original work of authorship. For the purposes\n of this License, Derivative Works shall not include works that remain\n separable from, or merely link (or bind by name) to the interfaces of,\n the Work and Derivative Works thereof.\n\n \"Contribution\" shall mean any work of authorship, including\n the original version of the Work and any modifications or additions\n to that Work or Derivative Works thereof, that is intentionally\n submitted to Licensor for inclusion in the Work by the copyright owner\n or by an individual or Legal Entity authorized to submit on behalf of\n the copyright owner. For the purposes of this definition, \"submitted\"\n means any form of electronic, verbal, or written communication sent\n to the Licensor or its representatives, including but not limited to\n communication on electronic mailing lists, source code control systems,\n and issue tracking systems that are managed by, or on behalf of, the\n Licensor for the purpose of discussing and improving the Work, but\n excluding communication that is conspicuously marked or otherwise\n designated in writing by the copyright owner as \"Not a Contribution.\"\n\n \"Contributor\" shall mean Licensor and any individual or Legal Entity\n on behalf of whom a Contribution has been received by Licensor and\n subsequently incorporated within the Work.\n\n 2. Grant of Copyright License. Subject to the terms and conditions of\n this License, each Contributor hereby grants to You a perpetual,\n worldwide, non-exclusive, no-charge, royalty-free, irrevocable\n copyright license to reproduce, prepare Derivative Works of,\n publicly display, publicly perform, sublicense, and distribute the\n Work and such Derivative Works in Source or Object form.\n\n 3. Grant of Patent License. Subject to the terms and conditions of\n this License, each Contributor hereby grants to You a perpetual,\n worldwide, non-exclusive, no-charge, royalty-free, irrevocable\n (except as stated in this section) patent license to make, have made,\n use, offer to sell, sell, import, and otherwise transfer the Work,\n where such license applies only to those patent claims licensable\n by such Contributor that are necessarily infringed by their\n Contribution(s) alone or by combination of their Contribution(s)\n with the Work to which such Contribution(s) was submitted. If You\n institute patent litigation against any entity (including a\n cross-claim or counterclaim in a lawsuit) alleging that the Work\n or a Contribution incorporated within the Work constitutes direct\n or contributory patent infringement, then any patent licenses\n granted to You under this License for that Work shall terminate\n as of the date such litigation is filed.\n\n 4. Redistribution. You may reproduce and distribute copies of the\n Work or Derivative Works thereof in any medium, with or without\n modifications, and in Source or Object form, provided that You\n meet the following conditions:\n\n (a) You must give any other recipients of the Work or\n Derivative Works a copy of this License; and\n\n (b) You must cause any modified files to carry prominent notices\n stating that You changed the files; and\n\n (c) You must retain, in the Source form of any Derivative Works\n that You distribute, all copyright, patent, trademark, and\n attribution notices from the Source form of the Work,\n excluding those notices that do not pertain to any part of\n the Derivative Works; and\n\n (d) If the Work includes a \"NOTICE\" text file as part of its\n distribution, then any Derivative Works that You distribute must\n include a readable copy of the attribution notices contained\n within such NOTICE file, excluding those notices that do not\n pertain to any part of the Derivative Works, in at least one\n of the following places: within a NOTICE text file distributed\n as part of the Derivative Works; within the Source form or\n documentation, if provided along with the Derivative Works; or,\n within a display generated by the Derivative Works, if and\n wherever such third-party notices normally appear. The contents\n of the NOTICE file are for informational purposes only and\n do not modify the License. You may add Your own attribution\n notices within Derivative Works that You distribute, alongside\n or as an addendum to the NOTICE text from the Work, provided\n that such additional attribution notices cannot be construed\n as modifying the License.\n\n You may add Your own copyright statement to Your modifications and\n may provide additional or different license terms and conditions\n for use, reproduction, or distribution of Your modifications, or\n for any such Derivative Works as a whole, provided Your use,\n reproduction, and distribution of the Work otherwise complies with\n the conditions stated in this License.\n\n 5. Submission of Contributions. Unless You explicitly state otherwise,\n any Contribution intentionally submitted for inclusion in the Work\n by You to the Licensor shall be under the terms and conditions of\n this License, without any additional terms or conditions.\n Notwithstanding the above, nothing herein shall supersede or modify\n the terms of any separate license agreement you may have executed\n with Licensor regarding such Contributions.\n\n 6. Trademarks. This License does not grant permission to use the trade\n names, trademarks, service marks, or product names of the Licensor,\n except as required for reasonable and customary use in describing the\n origin of the Work and reproducing the content of the NOTICE file.\n\n 7. Disclaimer of Warranty. Unless required by applicable law or\n agreed to in writing, Licensor provides the Work (and each\n Contributor provides its Contributions) on an \"AS IS\" BASIS,\n WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or\n implied, including, without limitation, any warranties or conditions\n of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A\n PARTICULAR PURPOSE. You are solely responsible for determining the\n appropriateness of using or redistributing the Work and assume any\n risks associated with Your exercise of permissions under this License.\n\n 8. Limitation of Liability. In no event and under no legal theory,\n whether in tort (including negligence), contract, or otherwise,\n unless required by applicable law (such as deliberate and grossly\n negligent acts) or agreed to in writing, shall any Contributor be\n liable to You for damages, including any direct, indirect, special,\n incidental, or consequential damages of any character arising as a\n result of this License or out of the use or inability to use the\n Work (including but not limited to damages for loss of goodwill,\n work stoppage, computer failure or malfunction, or any and all\n other commercial damages or losses), even if such Contributor\n has been advised of the possibility of such damages.\n\n 9. Accepting Warranty or Additional Liability. While redistributing\n the Work or Derivative Works thereof, You may choose to offer,\n and charge a fee for, acceptance of support, warranty, indemnity,\n or other liability obligations and/or rights consistent with this\n License. However, in accepting such obligations, You may act only\n on Your own behalf and on Your sole responsibility, not on behalf\n of any other Contributor, and only if You agree to indemnify,\n defend, and hold each Contributor harmless for any liability\n incurred by, or claims asserted against, such Contributor by reason\n of your accepting any such warranty or additional liability.\n\n END OF TERMS AND CONDITIONS\n\n APPENDIX: How to apply the Apache License to your work.\n\n To apply the Apache License to your work, attach the following\n boilerplate notice, with the fields enclosed by brackets \"[]\"\n replaced with your own identifying information. (Don't include\n the brackets!) The text should be enclosed in the appropriate\n comment syntax for the file format. We also recommend that a\n file or class name and description of purpose be included on the\n same \"printed page\" as the copyright notice for easier\n identification within third-party archives.\n\n Copyright [yyyy] [name of copyright owner]\n\n Licensed under the Apache License, Version 2.0 (the \"License\");\n you may not use this file except in compliance with the License.\n You may obtain a copy of the License at\n\n http://www.apache.org/licenses/LICENSE-2.0\n\n Unless required by applicable law or agreed to in writing, software\n distributed under the License is distributed on an \"AS IS\" BASIS,\n WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n See the License for the specific language governing permissions and\n limitations under the License." }, { "path": "README.md", "content": "

\n\n

\n\n# TvManiac\n\n![Check](https://github.com/thomaskioko/tv-maniac/actions/workflows/ci.yml/badge.svg)\n![kmp](https://img.shields.io/badge/multiplatform-%237F52FF.svg?style=for-the-badge&logo=kotlin&logoColor=white)\n![compose](https://img.shields.io/badge/jetpack_compose-2bab6b.svg?style=for-the-badge&logo=android&logoColor=white)\n![swiftui](https://img.shields.io/badge/swiftui-%23000000.svg?style=for-the-badge&logo=swift&logoColor=white)\n\n[![Download APK](https://img.shields.io/github/v/release/thomaskioko/tv-maniac?label=Download%20APK&logo=android&style=for-the-badge)](https://github.com/thomaskioko/tv-maniac/releases/latest)\n\n**TvManiac** is a personalized entertainment tracking and recommendation Multiplatform app (Android & iOS) for tracking TV Shows. By utilizing [Trakt](https://trakt.tv) and [TMDB](https://developer.themoviedb.org/docs), you can discover shows, manage your watchlist, track watch progress, and get personalized recommendations.\n\n| Android | iOS |\n|---|---|\n|