Dani
af63e11abd
📦 Release Preparation: - Created comprehensive RELEASE_GUIDE.md - Added signing key instructions - Store listing content ready - Screenshots checklist - F-Droid preparation guide 🔐 Security: - Updated .gitignore to exclude signing keys - Protected key.properties from git - Added *.jks and *.keystore exclusions 📝 Documentation Includes: - Step-by-step signing key generation - Google Play Store submission checklist - F-Droid requirements and options - Store assets specifications - Privacy policy hosting options - Version management guide 🏪 Store Listing Content: - App title: "Sage - Kitchen Inventory Manager" - Full description with features - Category: Food & Drink - Screenshots requirements (2-8 images) - Feature graphic specs (1024x500) ⚠️ F-Droid Considerations: - Firebase is proprietary (not FOSS) - Options: Remove Firebase for F-Droid build - Or: Provide APK downloads from GitHub - Or: Self-host F-Droid repo 📱 Next Steps for Developer: 1. Generate signing key with keytool 2. Create key.properties file 3. Take screenshots (6 recommended) 4. Create feature graphic 5. Host privacy policy 6. Create Google Play Developer account ($25) 7. Build signed AAB: flutter build appbundle --release 8. Upload to Play Store Version: 1.1.0+2 Package: com.github.mystiatech.sage 🤖 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!