Dani
a360fadc17
✨ Features: - Create household with 6-character shareable code - Join existing household with code - View household members and owner - Leave household functionality - Automatic inventory filtering by household - Persistent household settings across app updates 🔧 Technical changes: - Added Household model with Hive adapter (typeId: 4) - Updated AppSettings with userName and currentHouseholdId fields - Modified InventoryRepository to filter items by household - Updated Add Item screen to set householdId on new items - Added HouseholdScreen with full CRUD operations - Integrated household sharing into Settings navigation 🎯 Behavior: - Users not in a household see only their personal items - Users in a household see shared household items - New items automatically tagged with current household 🤖 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!