Initial commit: Sage Kitchen Management App v1.0.0

 Features implemented:
- Smart inventory tracking with Hive database
- Barcode scanning with auto-populated product info
- Multiple API fallbacks (Open Food Facts, UPCItemDB)
- Smart expiration date predictions by category
- Discord webhook notifications (persisted)
- Custom sage leaf vector icon
- Material Design 3 UI with sage green theme
- Privacy Policy & Terms of Service
- Local-first, privacy-focused architecture

🎨 UI/UX:
- Home dashboard with inventory stats
- Add Item screen with barcode integration
- Inventory list with expiration indicators
- Settings with persistent preferences
- About section with legal docs

🔧 Technical:
- Flutter 3.35.5 with Riverpod state management
- Hive 2.2.3 for local database
- Mobile scanner for barcode detection
- Feature-first architecture

🤖 Generated with Claude Code (https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
2025-10-04 13:54:21 -04:00
commit 7be7b270e6
155 changed files with 13133 additions and 0 deletions

106
README.md Normal file
View File

@@ -0,0 +1,106 @@
# 🌿 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
1. Clone the repository
2. Install dependencies:
```bash
flutter pub get
```
3. Run the app:
```bash
# 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](PLAN.md) - Development roadmap and current status
- [SAGE_PROJECT.md](SAGE_PROJECT.md) - Complete project documentation
- [PROJECT_STRUCTURE.md](PROJECT_STRUCTURE.md) - Detailed architecture guide
- [CLAUDE.md](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
## Contributing
This is currently a personal project, but ideas and suggestions are welcome!
## License
TBD
---
**Built with 💚 by developers who hate wasting food!**
Let's make kitchens smarter, one scan at a time! 🌿