Smart SSGL - Flutter App

A native Flutter implementation of the Smart Shared Grocery List application.

Setup Instructions

1. Install Flutter

Make sure you have Flutter 3.24.0 or higher installed:

flutter --version

2. Get Dependencies

flutter pub get

3. Firebase Setup

Android

1. Go to Firebase Console
2. Create a new project or use existing one
3. Add an Android app with package name: com.ssgl.app
4. Download google-services.json and replace android/app/google-services.json
5. Enable Authentication (Email/Password and Google)
6. Enable Cloud Firestore

iOS

1. In Firebase Console, add an iOS app with bundle ID: com.ssgl.app
2. Download GoogleService-Info.plist and replace ios/Runner/GoogleService-Info.plist
3. Enable Authentication and Cloud Firestore for iOS

Web

1. In Firebase Console, add a web app
2. Copy the firebaseConfig and update web/index.html

4. Run the App

flutter run

Building for Release

Android

flutter build apk --release

iOS

flutter build ipa --release

GitHub Actions

The CI/CD pipeline is configured in .github/workflows/flutter.yml to build both Android and iOS on every push to main.

Troubleshooting

App crashes on startup

• Ensure google-services.json is properly configured for Android
• Ensure GoogleService-Info.plist is properly configured for iOS
• Check that translations.json exists in assets/translations/

Firebase initialization errors

• Verify Firebase is properly configured in Firebase Console
• Ensure internet permission is added in AndroidManifest.xml
• Check that you're using the correct Firebase project