EcoCatalyst

EcoCatalyst is a sustainability-focused Android application that empowers users to make greener lifestyle choices. It includes features like product scanning, eco-alternative suggestions, carbon tracking, AI-based meal planning, and gamified achievements.

---

🚀 Features

• ✨ Product Scanner: Barcode and object recognition to assess product sustainability.
• 🌱 Eco-Friendly Alternatives: ML-based suggestions for better choices.
• 🌍 Carbon Footprint Tracker: Real-time analytics on emissions.
• 🤖 AI Diet Planner: Conversational eco-friendly meal planning.
• 🏆 Achievements System: Unlock badges for green habits.

---

🧰 Tech Stack

• React Native + Expo SDK 53
• Firebase (Auth, Firestore, Storage)
• TensorFlow Lite (on-device ML)
• OpenCV (vision)
• Jest (Testing)
• Material Design + Custom Components

---

📊 Project Structure

EcoCatalyst/
├── android/                 # Native Android build directory
├── ios/                     # Native iOS build directory
├── src/
│   ├── components/          # UI components
│   ├── screens/             # App screens
│   ├── services/            # Firebase, ML, Notifications, etc
│   ├── contexts/            # React Context Providers
│   ├── assets/              # Images, Icons
│   └── constants/           # Static configs & tips
├── App.tsx                  # App entry point
├── app.json                 # Expo config
├── package.json             # Dependencies
├── eas.json                 # EAS config (optional)
└── README.md                # Documentation

---

🚀 Getting Started (Without EAS CLI)

🔄 1. Install Dependencies

npm install

💪 2. Fix Version Compatibility (Expo SDK 53)

npm install \
  @react-native-async-storage/async-storage@2.1.2 \
  expo-notifications@~0.31.4 \
  react-dom@19.0.0 \
  react-native-safe-area-context@5.4.0 \
  react-native-svg@15.11.2 \
  react@19.0.0

🏠 3. Prebuild Native Android Project

npx expo prebuild

This generates the native android/ and ios/ folders.

---

💡 Running App on Android (Debug)

npx expo run:android

This installs the app to a connected device or emulator.

---

📁 Building APK Manually (via Android Studio)

Open in Android Studio:

1. Launch Android Studio
2. Open folder: EcoCatalyst/app/android/

Build APK:

Build → Build Bundle(s) / APK(s) → Build APK(s)

Build AAB (for Play Store):

Build → Build Bundle(s) / APK(s) → Build Bundle

Output Locations:

APK: android/app/build/outputs/apk/release/app-release.apk
AAB: android/app/build/outputs/bundle/release/app-release.aab

---

🔐 Signing APK for Release (Optional)

To publish on the Play Store, you'll need to configure signing in android/app/build.gradle. Let us know if you need help configuring this step.

---

🎮 Additional Notes

• Offline support with local scan caching
• WCAG 2.1 AA Accessibility
• GDPR-compliant (secure data at rest & transit)
• Portrait-only orientation
• Optimized for Android ≥ API 26

---

🔧 Developer Commands

# Start dev server
npm run start -- -c

# Debug on Android
npx expo run:android

# Build APK (terminal)
cd android && ./gradlew assembleRelease && cd ../

# Build AAB (Play Store)
cd android && ./gradlew bundleRelease && cd ../

---

Built with ❤️ by the rehmanTheDeveloper