Merge pull request #51 from LPK98/isira

Enhance UI, implement new features, and fix various issues

Author: JinethBosilu

.github/workflows/codeql.yml

@@ -4,9 +4,11 @@ on:
   push:
     branches:
       - main
+      - dev
   pull_request:
     branches:
       - main
+      - dev
   schedule:
     - cron: "0 3 * * 1"
 

.github/workflows/eas-build.yml

@@ -1,5 +1,4 @@
 name: EAS Build
-
 on:
   push:
     branches:
@@ -15,31 +14,25 @@ on:
         options:
           - preview
           - production
-
 jobs:
   build:
     name: EAS Build
     runs-on: ubuntu-latest
-
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4
-
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
           node-version: 20
           cache: "npm"
-
       - name: Install dependencies
         run: npm ci
-
       - name: Setup Expo and EAS
         uses: expo/expo-github-action@v8
         with:
           eas-version: latest
-          token: ${{ secrets.EXPO_TOKEN }}
-
+          token: ${{ secrets.EXPO_ROBOT_TOKEN }}    # 👈 Changed
       - name: Set build profile and environment
         id: config
         run: |
@@ -50,9 +43,7 @@ jobs:
           else
             PROFILE=preview
           fi
-
           echo "profile=$PROFILE" >> $GITHUB_OUTPUT
-
           # Set API_URL based on profile
           if [ "$PROFILE" == "production" ]; then
             echo "API_URL=${{ secrets.PROD_API_URL }}" >> $GITHUB_ENV
@@ -61,21 +52,17 @@ jobs:
             echo "API_URL=${{ secrets.PREVIEW_API_URL }}" >> $GITHUB_ENV
             echo "APP_ENV=preview" >> $GITHUB_ENV
           fi
-
       - name: Create .env file
         run: |
           echo "API_URL=${{ env.API_URL }}" >> .env.${{ env.APP_ENV }}
           echo "APP_ENV=${{ env.APP_ENV }}" >> .env.${{ env.APP_ENV }}
-
       - name: Build on EAS
         run: eas build --platform android --profile ${{ steps.config.outputs.profile }} --non-interactive
-
       - name: Notify success
         if: success()
         run: |
           echo "✅ Build succeeded for profile: ${{ steps.config.outputs.profile }}"
           echo "🔗 Check your build at https://expo.dev"
-
       - name: Notify failure
         if: failure()
         run: |

README.md

@@ -1,50 +1,175 @@
-# Welcome to your Expo app 👋
+# CrimeLink Analyzer Mobile App
 
-This is an [Expo](https://expo.dev) project created with [`create-expo-app`](https://www.npmjs.com/package/create-expo-app).
+React Native + Expo mobile client for the CrimeLink Analyzer platform.
 
-## Get started
+This app connects to:
 
-1. Install dependencies
+- CrimeLink backend APIs (authentication, duty, leave, announcements, safety zones, weapon requests, officer location)
+- Firebase (chat/auth-related integrations)
+- Google Maps services (map and location features)
 
-   ```bash
-   npm install
-   ```
+## Tech stack
 
-2. Start the app
+- Expo SDK 54
+- React Native 0.81
+- Expo Router (file-based routing)
+- TypeScript
+- NativeWind
+- Axios
+- Firebase
 
-   ```bash
-   npx expo start
-   ```
+## Prerequisites
 
-In the output, you'll find options to open the app in a
+Install the following before running:
 
-- [development build](https://docs.expo.dev/develop/development-builds/introduction/)
-- [Android emulator](https://docs.expo.dev/workflow/android-studio-emulator/)
-- [iOS simulator](https://docs.expo.dev/workflow/ios-simulator/)
-- [Expo Go](https://expo.dev/go), a limited sandbox for trying out app development with Expo
+- Node.js 18+ (recommended: latest LTS)
+- npm 9+
+- Expo CLI (via npx, no global install required)
+- Android Studio (for Android emulator) or Xcode (for iOS simulator on macOS)
 
-You can start developing by editing the files inside the **app** directory. This project uses [file-based routing](https://docs.expo.dev/router/introduction).
+For API calls to work, run the backend service and make sure its URL is reachable from your device/emulator.
 
-## Get a fresh project
+## Environment configuration
 
-When you're ready, run:
+This project reads environment values from:
+
+- `.env.development`
+- `.env.preview`
+- `.env.production`
+
+The selected file depends on `APP_ENV` (default is `development`).
+
+### 1. Create your env file
+
+From this folder, copy `.env.example` to one of the environment files:
+
+```bash
+cp .env.example .env.development
+```
+
+### 2. Fill required values
+
+At minimum, set all of the following keys:
+
+```env
+API_URL=
+FIREBASE_API_KEY=
+FIREBASE_AUTH_DOMAIN=
+FIREBASE_PROJECT_ID=
+FIREBASE_STORAGE_BUCKET=
+FIREBASE_MESSAGING_SENDER_ID=
+FIREBASE_APP_ID=
+```
+
+Optional but recommended:
+
+```env
+GOOGLE_MAPS_API_KEY=
+```
+
+### API_URL tips
+
+- Android emulator (calling backend on your machine):
+
+```env
+API_URL=http://10.0.2.2:8080
+```
+
+- iOS simulator:
+
+```env
+API_URL=http://localhost:8080
+```
+
+- Physical device (same Wi-Fi as your machine):
+
+```env
+API_URL=http://<YOUR_LOCAL_IP>:8080
+```
+
+## Install dependencies
+
+```bash
+npm install
+```
+
+## Run the app
+
+### Start Expo dev server
+
+Development environment (default):
+
+```bash
+npx expo start
+```
+
+Use a specific environment file:
 
 ```bash
-npm run reset-project
+APP_ENV=preview npx expo start
+APP_ENV=production npx expo start
 ```
 
-This command will move the starter code to the **app-example** directory and create a blank **app** directory where you can start developing.
+### Run on Android
+
+```bash
+npm run android
+```
+
+### Run on iOS (macOS only)
+
+```bash
+npm run ios
+```
+
+### Run on web
+
+```bash
+npm run web
+```
+
+## Lint
+
+```bash
+npm run lint
+```
+
+## Typical local workflow
+
+1. Start backend service (default expected port: 8080).
+2. Configure `.env.development` with valid API/Firebase values.
+3. Install dependencies with `npm install`.
+4. Start Expo using `npx expo start`.
+5. Launch on emulator/device (`a` for Android, `i` for iOS in Expo terminal, or use npm scripts).
+
+## Build and deployment notes
+
+- App config values are injected through `app.config.js` into Expo `extra`.
+- If you use EAS Build, define the same env vars in your EAS environment. Missing values can cause runtime failures when reading config.
 
-## Learn more
+## Project structure
 
-To learn more about developing your project with Expo, look at the following resources:
+- `app/` route screens (Expo Router)
+- `src/api/` API client setup
+- `src/services/` feature service layers
+- `src/constants/` shared constants and runtime config
+- `src/components/` reusable UI and feature components
+- `src/context/` and `src/hooks/` app state and hooks
 
-- [Expo documentation](https://docs.expo.dev/): Learn fundamentals, or go into advanced topics with our [guides](https://docs.expo.dev/guides).
-- [Learn Expo tutorial](https://docs.expo.dev/tutorial/introduction/): Follow a step-by-step tutorial where you'll create a project that runs on Android, iOS, and the web.
+## Troubleshooting
 
-## Join the community
+- Error: Missing required app config
+  - Check `.env.*` values and confirm you started the app with the intended `APP_ENV`.
+- Network request failed
+  - Verify backend is running and `API_URL` is reachable from emulator/device.
+- Android physical device cannot reach backend
+  - Use your machine local IP address, not `localhost`.
 
-Join our community of developers creating universal apps.
+## Useful scripts
 
-- [Expo on GitHub](https://github.com/expo/expo): View our open source platform and contribute.
-- [Discord community](https://chat.expo.dev): Chat with Expo users and ask questions.
+- `npx expo start` - Start Expo development server
+- `npm run android` - Build/run on Android
+- `npm run ios` - Build/run on iOS
+- `npm run web` - Run web target
+- `npm run lint` - Lint project
+- `npm run reset-project` - Reset scaffolded starter structure

app.config.js

@@ -16,7 +16,8 @@ const appName =
 export default {
   expo: {
     name: appName,
-    slug: "CrimelinkAnalyzer_app",
+    slug: "crimelink",
+    owner: "isiraexpoeass-organization",
     version: "1.0.0",
     orientation: "portrait",
     icon: "./assets/images/logo.png",
@@ -27,9 +28,17 @@ export default {
 
     ios: {
       supportsTablet: true,
+      config: {
+        googleMapsApiKey: process.env.GOOGLE_MAPS_API_KEY,
+      },
       infoPlist: {
         NSLocationWhenInUseUsageDescription:
           "This app uses your location to show nearby places and reports.",
+        NSLocationAlwaysAndWhenInUseUsageDescription:
+          "Crime Link Analyzer needs your location even when the app is in the background during duty hours.",
+        NSLocationAlwaysUsageDescription:
+          "Crime Link Analyzer needs your location even when the app is in the background during duty hours.",
+        UIBackgroundModes: ["location"],
         NSFaceIDUsageDescription:
           "Allow Crime Link Analyzer to use Face ID to authenticate you.",
       },
@@ -44,7 +53,18 @@ export default {
       },
       edgeToEdgeEnabled: true,
       predictiveBackGestureEnabled: false,
-      permissions: ["ACCESS_FINE_LOCATION"],
+      permissions: [
+        "ACCESS_COARSE_LOCATION",
+        "ACCESS_FINE_LOCATION",
+        "ACCESS_BACKGROUND_LOCATION",
+        "FOREGROUND_SERVICE",
+        "FOREGROUND_SERVICE_LOCATION",
+      ],
+      config: {
+        googleMaps: {
+          apiKey: process.env.GOOGLE_MAPS_API_KEY,
+        },
+      },
       package: "com.anonymous.CrimelinkAnalyzer_app",
       jsEngine: "hermes",
     },
@@ -70,6 +90,14 @@ export default {
       ],
       "expo-secure-store",
       "expo-sqlite",
+      [
+        "expo-location",
+        {
+          isAndroidBackgroundLocationEnabled: true,
+          isAndroidForegroundServiceEnabled: true,
+          isIosBackgroundLocationEnabled: true,
+        },
+      ],
     ],
 
     experiments: {
@@ -80,7 +108,7 @@ export default {
     extra: {
       router: {},
       eas: {
-        projectId: "ab5e7b7b-eb2e-49f5-9a61-01529d4cae27",
+        projectId: "cfc2ec4e-36f0-4781-a496-4c08aa07b763",
       },
       appEnv: ENV,
       apiUrl: process.env.API_URL,