Dani
2cf51b6841
🔍 Debug Improvements: - Added detailed logging to track sync events - Print statements show: items received, added, updated, deleted - Logs Firebase connection status and errors - Easier to diagnose sync issues 🔄 UI Refresh Fix: - Added callback system to notify UI when sync occurs - HomeScreen invalidates providers after Firebase sync - UI now automatically refreshes when items sync - No manual refresh needed! 📝 Logging Output: - 📡 Starting Firebase sync for household: {id} - 🔄 Received {count} items from Firebase - ➕ Added new item from Firebase: {name} - 🔄 Updated item from Firebase: {name} - 🗑️ Deleting {count} items no longer in Firebase - ✅ UI refreshed after Firebase sync ✅ Build Status: - APK: 63.4MB - All tests passing - Ready for testing 🎯 How to Test: 1. Install on both phones 2. Check console logs (adb logcat) 3. Add item on Phone A 4. Watch logs on Phone B - should see sync messages 5. If no sync messages → Firebase not configured correctly 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
🌿 Sage - Smart Kitchen Management
A beautiful Flutter app for tracking your kitchen inventory and reducing food waste.
Features
✅ Smart Inventory Management
- Barcode scanning for quick item entry
- Auto-populated product information from multiple databases
- Smart expiration date predictions based on food category
- Visual expiration status indicators
✅ Modern UI
- Clean, intuitive Material Design 3 interface
- Sage green theme
- Custom sage leaf vector icon
- Smooth animations and transitions
✅ Notifications
- Local expiration alerts
- Discord webhook integration for remote notifications
- Customizable alert settings (persisted!)
✅ Local-First Data
- All data stored locally using Hive
- No cloud dependencies
- Privacy-focused design
- Fast and offline-capable
Tech Stack
- Framework: Flutter 3.35.5
- State Management: Riverpod 2.6.1
- Database: Hive 2.2.3 (local)
- Barcode Scanning: mobile_scanner 5.2.3
- API Integration: Open Food Facts, UPCItemDB
- Platform: Android (iOS coming soon)
Getting Started
Prerequisites
- Flutter 3.x installed
- Android Studio or VS Code
- Android SDK (for mobile) or Visual Studio (for Windows desktop)
Setup
- Clone the repository
- Install dependencies:
flutter pub get
- Run the app:
# On Android device/emulator
flutter run
# On Windows (for development)
flutter run -d windows
Project Structure
sage/
├── lib/
│ ├── core/ # Core utilities, constants, extensions
│ ├── features/ # Feature modules (inventory, recipes, etc.)
│ ├── services/ # Business logic services
│ ├── data/ # Data layer (local + remote)
│ └── shared/ # Shared widgets and providers
├── assets/ # Images, icons, fonts
└── test/ # Tests
Documentation
- PLAN.md - Development roadmap and current status
- SAGE_PROJECT.md - Complete project documentation
- PROJECT_STRUCTURE.md - Detailed architecture guide
- CLAUDE.md - AI assistant personality template
Roadmap
- Phase 1: Foundation - Basic inventory tracker ⏳ IN PROGRESS
- Phase 2: Barcode scanning with Open Food Facts
- Phase 3: Smart alerts & notifications
- Phase 4: Recipe management
- Phase 5: Shopping lists
- Phase 6: Multi-user & cloud sync
- Phase 7: Advanced features & polish
Author
Danielle Sapelli
- Built with ❤️ using Flutter & Claude Code
Contributing
Ideas and suggestions are welcome!
License
TBD
🌿 Making kitchens smarter, one scan at a time!