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

5.1 KiB

🌿 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!