16 firebase integration

.github/workflows/ci.yaml

@@ -51,6 +51,14 @@ jobs:
           IGDB_CLIENT_SECRET=${{ secrets.IGDB_CLIENT_SECRET }}
           EOF
 
+      - name: 🔥 Setup Firebase config files
+        env:
+          FIREBASE_OPTIONS_DART: ${{ secrets.FIREBASE_OPTIONS_DART }}
+          FIREBASE_OPTIONS_DART_BASE64: ${{ secrets.FIREBASE_OPTIONS_DART_BASE64 }}
+        run: |
+          chmod +x scripts/setup_firebase.sh
+          ./scripts/setup_firebase.sh --require dart
+
       - name: 🔨 Generate code
         run: |
           chmod +x scripts/build_all.sh
@@ -93,6 +101,14 @@ jobs:
           IGDB_CLIENT_SECRET=${{ secrets.IGDB_CLIENT_SECRET }}
           EOF
 
+      - name: 🔥 Setup Firebase config files
+        env:
+          FIREBASE_OPTIONS_DART: ${{ secrets.FIREBASE_OPTIONS_DART }}
+          FIREBASE_OPTIONS_DART_BASE64: ${{ secrets.FIREBASE_OPTIONS_DART_BASE64 }}
+        run: |
+          chmod +x scripts/setup_firebase.sh
+          ./scripts/setup_firebase.sh --require dart
+
       - name: 🔨 Generate code
         run: |
           chmod +x scripts/build_all.sh

.github/workflows/pr-checks.yaml

@@ -40,5 +40,5 @@ jobs:
 
       - name: 🔍 Check for outdated dependencies
         run: |
-          cd apps/mobile
-          flutter pub outdated
+          chmod +x scripts/check_dependencies.sh
+          ./scripts/check_dependencies.sh

.github/workflows/release.yaml

@@ -48,6 +48,16 @@ jobs:
           IGDB_CLIENT_SECRET=${{ secrets.IGDB_CLIENT_SECRET }}
           EOF
 
+      - name: 🔥 Setup Firebase config files
+        env:
+          FIREBASE_OPTIONS_DART: ${{ secrets.FIREBASE_OPTIONS_DART }}
+          FIREBASE_OPTIONS_DART_BASE64: ${{ secrets.FIREBASE_OPTIONS_DART_BASE64 }}
+          FIREBASE_ANDROID_GOOGLE_SERVICES_JSON: ${{ secrets.FIREBASE_ANDROID_GOOGLE_SERVICES_JSON }}
+          FIREBASE_ANDROID_GOOGLE_SERVICES_JSON_BASE64: ${{ secrets.FIREBASE_ANDROID_GOOGLE_SERVICES_JSON_BASE64 }}
+        run: |
+          chmod +x scripts/setup_firebase.sh
+          ./scripts/setup_firebase.sh --require dart --require android
+
       - name: 🔨 Generate code
         run: |
           chmod +x scripts/build_all.sh

.vscode/launch.json

@@ -1,7 +1,30 @@
 {
     "configurations": [
         {
-            "name": "Flutter",
+            "name": "Launch (Remote Config Flags)",
+            "type": "dart",
+            "request": "launch",
+            "program": "apps/mobile/lib/main.dart",
+            "args": [
+                "--dart-define=ENABLE_CRASHLYTICS_IN_DEBUG=true",
+                "--dart-define=BACKEND_API_BASE_URL=http://localhost:4000"
+            ]
+        },
+        {
+            "name": "Launch (Force Backend ON via ENV)",
+            "type": "dart",
+            "request": "launch",
+            "program": "apps/mobile/lib/main.dart",
+            "args": [
+                "--dart-define=ENABLE_CRASHLYTICS_IN_DEBUG=true",
+                "--dart-define=BACKEND_USE_ENV_FLAG_OVERRIDES=true",
+                "--dart-define=BACKEND_INTEGRATION_ENABLED=true",
+                "--dart-define=BACKEND_SYNC_ENABLED=true",
+                "--dart-define=BACKEND_API_BASE_URL=http://localhost:4000"
+            ]
+        },
+        {
+            "name": "Launch (Without ENV)",
             "type": "dart",
             "request": "launch",
             "program": "apps/mobile/lib/main.dart"

QUICK_START.md

@@ -1,246 +1,63 @@
-# Collection Tracker - Quick Start Guide
+# Quick Start
 
-Get your Collection Tracker app up and running in minutes!
+For full documentation, start at [documentation/README.md](documentation/README.md).
 
-## ⚡ Quick Setup (5 minutes)
+## Minimal Local Run
 
-### 1. Prerequisites Check
+1. Install dependencies:
 
 ```bash
-# Verify Flutter is installed
-flutter doctor
-
-# You should see:
-# ✓ Flutter (Channel stable, 3.24.0 or higher)
-# ✓ Dart (3.2.0 or higher)
+dart pub get
 ```
 
-### 2. Install Dependencies
+2. Create env file:
 
 ```bash
-# From workspace root
-dart pub get
+cat > packages/common/env/.env <<'ENV'
+GOOGLE_BOOKS_API_KEY=...
+TMDB_API_KEY=...
+TMDB_READ_ACCESS_TOKEN=...
+IGDB_CLIENT_ID=...
+IGDB_CLIENT_SECRET=...
+ENV
 ```
 
-### 3. Generate Code
+3. Materialize Firebase config files:
 
 ```bash
-# Make scripts executable
-chmod +x scripts/*.sh
-
-# Run code generation
-./scripts/build_all.sh
+./scripts/setup_firebase.sh --require dart
 ```
 
-### 4. Run the App
+4. Generate code:
 
 ```bash
-cd apps/mobile
-flutter run
+./scripts/build_all.sh
 ```
 
-That's it! 🎉 Your app should now be running.
-
-## 📱 First Time Usage
-
-### Create Your First Collection
-
-1. Tap **"New Collection"** button
-2. Enter collection name (e.g., "My Books")
-3. Select collection type (Books, Games, Movies, etc.)
-4. Optionally add a description
-5. Tap **"Create Collection"**
-
-### Add Your First Item
-
-1. Tap on your collection
-2. Tap **"Add Item"**
-3. Enter item title (required)
-4. Optionally add:
-   - Barcode (ISBN, UPC, etc.)
-   - Description
-   - More details coming soon!
-5. Tap **"Add Item"**
-
-### View and Manage Items
-
-1. From collection detail, tap **"View Items"**
-2. See all your items in a beautiful list
-3. Tap any item to view full details
-4. Use the menu to edit or delete items
-
-## 🛠️ Development Workflow
-
-### Daily Development
+5. Run app:
 
 ```bash
-# Terminal 1: Watch for code changes
 cd apps/mobile
-flutter pub run build_runner watch --delete-conflicting-outputs
-
-# Terminal 2: Run the app
 flutter run
-
-# Press 'r' for hot reload
-# Press 'R' for hot restart
 ```
 
-### Making Changes
-
-1. **Modify code** in your IDE
-2. **Hot reload** automatically (or press 'r')
-3. **If you modify models/providers**, code is auto-generated
-4. **Test your changes** immediately
-
-### Common Commands
+## Useful Commands
 
 ```bash
-# Using Makefile (recommended)
-make build    # Generate code
-make test     # Run tests
-make analyze  # Check code quality
-make format   # Format code
-make run      # Run app
-
-# Or using scripts directly
-./scripts/build_all.sh
-./scripts/test_all.sh
 ./scripts/analyze_all.sh
+./scripts/test_all.sh
+dart format --set-exit-if-changed .
 ```
 
-## 🔧 Troubleshooting
-
-### "No such file or directory" for .g.dart files
-
-**Solution:**
-```bash
-./scripts/build_all.sh
-```
-
-### "The getter 'xxx' isn't defined"
+## Optional: Local Backend/Sync Debug Run
 
-**Solution:**
 ```bash
 cd apps/mobile
-flutter pub run build_runner build --delete-conflicting-outputs
-```
-
-### Import errors
-
-**Solution:**
-```bash
-dart pub get
-flutter pub get
-```
-
-### App won't start
-
-**Solution:**
-```bash
-# Clean and rebuild
-./scripts/clean_all.sh
-dart pub get
-./scripts/build_all.sh
-flutter run
-```
-
-### Database errors
-
-**Solution:** Database is created automatically on first run. If you see errors:
-```bash
-# Uninstall app and reinstall
-flutter clean
-flutter run
-```
-
-## 📂 Project Structure
-
+flutter run \
+  --dart-define=BACKEND_USE_ENV_FLAG_OVERRIDES=true \
+  --dart-define=BACKEND_INTEGRATION_ENABLED=true \
+  --dart-define=BACKEND_SYNC_ENABLED=true \
+  --dart-define=BACKEND_API_BASE_URL=http://localhost:4000
 ```
-collection_tracker/
-├── apps/mobile/              # Your Flutter app
-│   └── lib/
-│       ├── main.dart        # App entry point
-│       ├── features/        # Features (collections, items, etc.)
-│       └── core/            # Core app functionality
-│
-├── packages/                # Reusable packages
-│   ├── core/
-│   │   ├── domain/         # Business logic
-│   │   └── data/           # Data layer
-│   ├── common/
-│   │   ├── ui/             # Shared widgets
-│   │   └── utils/          # Utilities
-│   └── integrations/       # Third-party integrations
-│
-└── scripts/                # Build scripts
-```
-
-## 🎯 What's Next?
-
-### Explore Features
-
-- ✅ Create multiple collections
-- ✅ Add items with details
-- ✅ View statistics
-- ✅ Dark mode (automatic)
-- ✅ Beautiful Material 3 UI
-
-### Coming Soon
-
-- 📷 Barcode scanning
-- 🖼️ Photo upload
-- 🔍 Search functionality
-- ☁️ Cloud sync
-- 📊 Advanced statistics
-
-### Customize
-
-- **Change theme**: Edit `packages/common/ui/lib/theme/app_theme.dart`
-- **Add features**: Create new feature folders in `apps/mobile/lib/features/`
-- **Modify database**: Edit tables in `packages/integrations/database/lib/tables/`
-
-## 📚 Learn More
-
-### Documentation
-
-<!-- - [Full Setup Guide](BUILD_AND_RUN_GUIDE.md) - Detailed setup instructions -->
-- [Architecture Guide](documentation/ARCHITECTURE.md) - Learn about the architecture
-- [Contributing Guide](CONTRIBUTING.md) - How to contribute
-
-### Resources
-
-- [Flutter Documentation](https://flutter.dev/docs)
-- [Riverpod Documentation](https://riverpod.dev)
-- [Drift Documentation](https://drift.simonbinder.eu)
-
-## 💡 Pro Tips
-
-1. **Use hot reload** - Press 'r' instead of restarting the app
-2. **Keep build_runner watching** - Saves time during development
-3. **Use the Makefile** - Easier than remembering script paths
-4. **Check analysis** - Run `make analyze` before committing
-5. **Format code** - Run `make format` to maintain consistency
-
-## 🆘 Need Help?
-
-- 📖 Check the [README.md](README.md)
-- 🐛 Report issues on GitHub
-- 💬 Ask questions in Discussions
-- 📧 Email: kyawzayartun.contact@gmail.com
-
-## ✅ Checklist
-
-Before you start coding:
-
-- [ ] Flutter doctor shows no issues
-- [ ] Dependencies installed (`dart pub get`)
-- [ ] Code generated (`./scripts/build_all.sh`)
-- [ ] App runs successfully (`flutter run`)
-- [ ] You can create a collection
-- [ ] You can add an item
-
-You're all set! Happy coding! 🚀
-
-<!-- ---
 
-**Need more details?** Check out the [full documentation](BUILD_AND_RUN_GUIDE.md). -->
+See [documentation/FIREBASE_AND_FLAGS.md](documentation/FIREBASE_AND_FLAGS.md) for runtime flag details.