feat: integrate Google Maps API key handling for Android and update related documentation

Author: Lalit Sharma

.github/workflows/eas-build.yml

@@ -63,6 +63,8 @@ jobs:
     name: EAS Build (${{ github.event.inputs.platform || 'all' }})
     needs: ci
     runs-on: ubuntu-latest
+    env:
+      GOOGLE_MAPS_ANDROID_API_KEY: ${{ secrets.GOOGLE_MAPS_ANDROID_API_KEY }}
 
     steps:
       - name: Checkout
@@ -88,6 +90,15 @@ jobs:
           eas-version: latest
           token: ${{ secrets.EXPO_TOKEN }}
 
+      - name: Validate Google Maps Android key
+        if: ${{ (github.event.inputs.platform || 'all') != 'ios' }}
+        run: |
+          if [ -z "$GOOGLE_MAPS_ANDROID_API_KEY" ]; then
+            echo "Missing GOOGLE_MAPS_ANDROID_API_KEY GitHub secret."
+            echo "Add it in: Settings -> Secrets and variables -> Actions."
+            exit 1
+          fi
+
       - name: Build
         working-directory: apps/mobile
         run: eas build --profile production --platform ${{ github.event.inputs.platform || 'all' }} --non-interactive

.gitignore

@@ -5,4 +5,6 @@ dist
 build
 coverage
 .DS_Store
-*.log
+*.log
+apps/mobile/.env
+apps/mobile/.env.local

PRIVACY_POLICY.md

@@ -84,7 +84,7 @@ If we update this Privacy Policy, we will revise the "Last Updated" date at the
 
 If you have questions about this Privacy Policy, you can reach us at:
 
-- **GitHub:** [https://github.com/lallimaven/eclipse-timer](https://github.com/lallimaven/eclipse-timer)
+- **GitHub:** [https://github.com/c0d3rb4b4/eclipse-timer](https://github.com/c0d3rb4b4/eclipse-timer)
 
 ---
 

README.md

@@ -232,6 +232,47 @@ pnpm install
 
 If you already have the repo locally, running `pnpm install` at the root is enough.
 
+## Google Maps API Key Setup (Local + CI)
+
+Android uses `react-native-maps`, so a Google Maps Android API key is required.
+This repo now reads the key from `GOOGLE_MAPS_ANDROID_API_KEY` at build/config time.
+
+### Local development
+
+1. Copy the example env file:
+   ```bash
+   cp apps/mobile/.env.example apps/mobile/.env.local
+   ```
+   On Windows PowerShell:
+   ```powershell
+   Copy-Item apps/mobile/.env.example apps/mobile/.env.local
+   ```
+2. Edit `apps/mobile/.env.local` and set:
+   ```env
+   GOOGLE_MAPS_ANDROID_API_KEY=your_real_android_maps_key
+   ```
+3. Rebuild the Android app after changing the key:
+   ```bash
+   pnpm -C apps/mobile android
+   ```
+
+### GitHub Actions (EAS build workflow)
+
+1. In GitHub, add repository secret:
+   - Name: `GOOGLE_MAPS_ANDROID_API_KEY`
+   - Value: your Android Maps key
+2. The workflow `.github/workflows/eas-build.yml` injects this secret into the build job.
+3. Android/all builds fail early with a clear message if the secret is missing.
+
+### Security recommendations
+
+- Restrict the key in Google Cloud Console to:
+  - Application restriction: `Android apps`
+  - Package: `com.lallimaven.eclipsetimer`
+  - SHA-1: your debug/release certificate fingerprints
+- Restrict API usage to `Maps SDK for Android`.
+- If a key was ever committed, rotate it in Google Cloud and replace it in local/CI secrets.
+
 ## Getting Started (Quick Start)
 
 From the repo root:

apps/mobile/.env.example

@@ -1,5 +1,8 @@
 # Environment variables for Eclipse Timer
-# Copy this file to .env and fill in real values before production builds.
+# Copy this file to .env.local and fill in real values before production builds.
+
+# Google Maps Android SDK key (required for react-native-maps on Android)
+GOOGLE_MAPS_ANDROID_API_KEY=
 
 # Sentry — crash reporting (used in App.tsx Sentry.init)
 SENTRY_DSN=

apps/mobile/android/app/build.gradle

@@ -81,6 +81,8 @@ def enableMinifyInReleaseBuilds = (findProperty('android.enableMinifyInReleaseBu
  */
 def jscFlavor = 'io.github.react-native-community:jsc-android:2026004.+'
 
+apply from: new File(["node", "--print", "require('path').dirname(require.resolve('@sentry/react-native/package.json'))"].execute().text.trim(), "sentry.gradle")
+
 android {
     ndkVersion rootProject.ext.ndkVersion
 

apps/mobile/android/app/src/main/AndroidManifest.xml

@@ -14,11 +14,12 @@
     </intent>
   </queries>
   <application android:name=".MainApplication" android:label="@string/app_name" android:icon="@mipmap/ic_launcher" android:roundIcon="@mipmap/ic_launcher_round" android:allowBackup="true" android:theme="@style/AppTheme" android:supportsRtl="true" android:enableOnBackInvokedCallback="false">
+    <meta-data android:name="com.google.android.geo.API_KEY" android:value="AIzaSyD7A_gIoLZvyQ2t50uzwumFNWjCpX5zuZs"/>
     <meta-data android:name="expo.modules.updates.ENABLED" android:value="true"/>
+    <meta-data android:name="expo.modules.updates.EXPO_RUNTIME_VERSION" android:value="@string/expo_runtime_version"/>
     <meta-data android:name="expo.modules.updates.EXPO_UPDATES_CHECK_ON_LAUNCH" android:value="ALWAYS"/>
     <meta-data android:name="expo.modules.updates.EXPO_UPDATES_LAUNCH_WAIT_MS" android:value="0"/>
     <meta-data android:name="expo.modules.updates.EXPO_UPDATE_URL" android:value="https://u.expo.dev/a29a7662-96be-4509-a79e-fbe4b5dac1ff"/>
-    <meta-data android:name="expo.modules.updates.EXPO_RUNTIME_VERSION" android:value="@string/expo_runtime_version"/>
     <activity android:name=".MainActivity" android:configChanges="keyboard|keyboardHidden|orientation|screenSize|screenLayout|uiMode" android:launchMode="singleTask" android:windowSoftInputMode="adjustResize" android:theme="@style/Theme.App.SplashScreen" android:exported="true" android:screenOrientation="portrait">
       <intent-filter>
         <action android:name="android.intent.action.MAIN"/>
@@ -31,5 +32,6 @@
         <data android:scheme="eclipsetimer"/>
       </intent-filter>
     </activity>
+    <uses-library android:name="org.apache.http.legacy" android:required="false"/>
   </application>
 </manifest>

apps/mobile/android/app/src/main/java/com/lallimaven/eclipsetimer/MainActivity.kt

@@ -1,4 +1,5 @@
 package com.lallimaven.eclipsetimer
+import expo.modules.splashscreen.SplashScreenManager
 
 import android.os.Build
 import android.os.Bundle
@@ -15,7 +16,10 @@ class MainActivity : ReactActivity() {
     // Set the theme to AppTheme BEFORE onCreate to support
     // coloring the background, status bar, and navigation bar.
     // This is required for expo-splash-screen.
-    setTheme(R.style.AppTheme);
+    // setTheme(R.style.AppTheme);
+    // @generated begin expo-splashscreen - expo prebuild (DO NOT MODIFY) sync-f3ff59a738c56c9a6119210cb55f0b613eb8b6af
+    SplashScreenManager.registerOnActivity(this)
+    // @generated end expo-splashscreen
     super.onCreate(null)
   }
 

apps/mobile/android/app/src/main/res/values/styles.xml

@@ -5,7 +5,10 @@
     <item name="colorPrimary">@color/colorPrimary</item>
     <item name="android:statusBarColor">#0b0b0b</item>
   </style>
-  <style name="Theme.App.SplashScreen" parent="AppTheme">
-    <item name="android:windowBackground">@drawable/ic_launcher_background</item>
+  <style name="Theme.App.SplashScreen" parent="Theme.SplashScreen">
+    <item name="windowSplashScreenBackground">@color/splashscreen_background</item>
+    <item name="windowSplashScreenAnimatedIcon">@drawable/splashscreen_logo</item>
+    <item name="postSplashScreenTheme">@style/AppTheme</item>
+    <item name="android:windowSplashScreenBehavior">icon_preferred</item>
   </style>
 </resources>

apps/mobile/android/gradle.properties

@@ -35,7 +35,7 @@ reactNativeArchitectures=armeabi-v7a,arm64-v8a,x86,x86_64
 # your application. You should enable this flag either if you want
 # to write custom TurboModules/Fabric components OR use libraries that
 # are providing them.
-newArchEnabled=true
+newArchEnabled=false
 
 # Use this property to enable or disable the Hermes JS engine.
 # If set to false, you will be using JSC instead.