Files
Sage/PLAY_STORE_LISTING.md
Dani 7ab641a3c8 v1.3.0+4: FOSS Compliance + Dark Mode + Enhanced Settings
 Major Features:
- Dark mode toggle with app-wide theme switching
- Sort inventory by Expiration Date, Name, or Location
- Toggle between Grid and List view for inventory
- Export inventory data to CSV with share functionality
- Custom sage leaf app icon with adaptive icon support

🔄 FOSS Compliance (F-Droid Ready):
- Replaced Firebase with Supabase (open-source backend)
- Anonymous authentication (no user accounts required)
- Cloud-first with hosted Supabase as default
- Optional self-hosting support
- 100% FOSS-compliant dependencies

🎨 UI/UX Improvements:
- Dynamic version display from package.json (was hardcoded)
- Added edit buttons for household and user names
- Removed non-functional search button
- Replaced Recipes placeholder with Settings button
- Improved settings organization with clear sections

📦 Dependencies:
Added:
- supabase_flutter: ^2.8.4 (FOSS backend sync)
- package_info_plus: ^8.1.0 (dynamic version)
- csv: ^6.0.0 (data export)
- share_plus: ^10.1.2 (file sharing)
- image: ^4.5.4 (dev, icon generation)

Removed:
- firebase_core (replaced with Supabase)
- cloud_firestore (replaced with Supabase)

🗑️ Cleanup:
- Removed Firebase setup files and google-services.json
- Removed unimplemented features (Recipes, Search)
- Removed firebase_household_service.dart
- Removed inventory_sync_service.dart (replaced with Supabase)

📄 New Files:
- lib/features/household/services/supabase_household_service.dart
- web/privacy-policy.html (Play Store requirement)
- web/terms-of-service.html (Play Store requirement)
- PLAY_STORE_LISTING.md (marketing copy)
- tool/generate_icons.dart (icon generation script)
- assets/icon/sage_leaf.png (1024x1024)
- assets/icon/sage_leaf_foreground.png (adaptive icon)

🐛 Bug Fixes:
- Fixed version display showing hardcoded "1.0.0"
- Fixed Sort By and Default View showing static text
- Fixed ConsumerWidget build signatures
- Fixed Location.displayName import issues
- Added clearAllData method to Hive database

📊 Stats: +1,728 additions, -756 deletions across 42 files

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-04 22:27:42 -04:00

179 lines
5.1 KiB
Markdown

# 🌿 Sage - Play Store Listing
## App Title
**Sage: Smart Kitchen Manager**
## Short Description (80 characters max)
Track food inventory, reduce waste, share with family - privacy-first & FOSS
## Full Description (4000 characters max)
🌿 **Stop Wasting Food. Start Saving Money.**
Sage is the smart, privacy-first kitchen management app that helps you track your food inventory, never miss expiration dates, and reduce food waste. Built with love as 100% free and open-source software (FOSS).
---
**KEY FEATURES**
📦 **Smart Inventory Tracking**
• Scan barcodes for instant product info
• Auto-populated names, categories, and photos
• Track quantities, locations, and expiration dates
• Visual expiration indicators (green = fresh, yellow = soon, red = expired)
**Never Waste Food Again**
• Smart expiration date predictions by category
• Discord notifications for items expiring soon
• Dashboard showing what needs to be used first
• Track items in fridge, freezer, or pantry
👨‍👩‍👧‍👦 **Household Sharing (Optional)**
• Share inventory with family members in real-time
• Everyone sees the same items, no duplicates
• Perfect for coordinating grocery shopping
• Cloud sync powered by Supabase (open-source!)
🎨 **Beautiful Material Design 3 UI**
• Sage green theme that's easy on the eyes
• Grid and list view options
• Dark mode support
• Smooth animations and intuitive navigation
🔒 **Privacy-First Architecture**
• Local-first: All data stored on YOUR device
• No email, no phone number, no tracking
• Optional cloud sync (you control it)
• 100% open-source - verify the code yourself
• No ads, no data selling, ever
🚀 **Smart Barcode Scanning**
• Powered by Open Food Facts (free database)
• Fallback to UPCItemDB for coverage
• Auto-fills product name, category, and image
• Works with most grocery items
🔔 **Discord Integration**
• Get expiration alerts in your Discord server
• Configurable webhook notifications
• Perfect for tech-savvy households
• Completely optional
---
💚 **WHY SAGE?**
**Unlike Other Apps, We:**
• Don't require accounts or emails
• Don't track or sell your data
• Work offline-first (cloud sync is optional)
• Are 100% free and open-source
• Have no ads or premium features
• Let you self-host if you want full control
**Perfect For:**
• Families reducing food waste
• Budget-conscious shoppers
• People with food allergies (track ingredients)
• Meal planners
• Anyone tired of throwing away spoiled food
• Privacy advocates
• FOSS enthusiasts
---
🛠️ **TECHNICAL DETAILS**
**Built With:**
• Flutter 3.35.5 - Cross-platform framework
• Hive 2.2.3 - Local encrypted database
• Supabase - Optional FOSS cloud backend
• Material Design 3 - Modern UI
• Riverpod - State management
**Open Source:**
• MIT License
• GitHub: [Your GitHub URL]
• F-Droid available
• Contribute or fork anytime
**Privacy:**
• See our detailed Privacy Policy
• Local-first data storage
• Optional anonymous cloud sync
• GDPR friendly
• No third-party trackers
---
📊 **HOW IT WORKS**
1. **Scan or Add Items**
Scan barcodes or manually add food items with expiration dates
2. **Track Everything**
See all your food in one place - fridge, freezer, pantry
3. **Get Notified**
Receive alerts when items are expiring soon (Discord or in-app)
4. **Share with Family (Optional)**
Create a household and sync inventory with family members
5. **Reduce Waste**
Use what you have before it expires, save money, help the planet
---
🌍 **REDUCE FOOD WASTE, HELP THE PLANET**
Did you know? The average household wastes $1,500/year on spoiled food. Sage helps you:
• Use food before it expires
• Avoid buying duplicates
• Plan meals around what you have
• Save money and reduce your carbon footprint
---
🔐 **YOUR DATA, YOUR CONTROL**
**Local Storage:**
All data is stored on your device in an encrypted Hive database. Uninstall the app = data is gone.
**Cloud Sync (Optional):**
If you enable household sharing, data syncs via Supabase (open-source). You can use our hosted instance OR self-host your own server for complete control.
**No Tracking:**
Zero analytics, zero ad tracking, zero data collection. We literally can't sell your data because we never have it.
---
📱 **SUPPORT & COMMUNITY**
• GitHub Issues: Report bugs or request features
• Open Source: Contribute code or translations
• Documentation: Full setup guides available
• F-Droid: Available on F-Droid store
---
💚 **FREE FOREVER**
Sage is free, open-source software built by someone who was tired of wasting food. No ads, no premium tiers, no hidden costs. Just a useful app that respects your privacy.
Download Sage today and join thousands of households reducing food waste!
---
**Permissions:**
• Camera - For barcode scanning (optional)
• Internet - For barcode lookups and cloud sync (optional)
• Storage - For local database
All permissions are used ONLY for stated purposes. See Privacy Policy for details.
---
🌿 **Start Your Journey to Zero Food Waste Today!**