BloomMeld - Your Plants Are Trying to Tell You Something.

BloomMeld – AI-Powered Plant Care Assistant

A production-ready, full-stack plant care ecosystem combining AI disease detection, a conversational plant coach, care scheduling, community features, and gamification — all in one polished Flutter app. Ships with a NestJS backend API, Laravel + Filament admin panel, and React landing page.

✨ Key Features

🔐 Authentication & Onboarding

• Email/password registration with OTP email verification

• Google Sign-In and Apple Sign-In (OAuth 2.0)

• JWT access + refresh token flow with automatic renewal

• 4-page animated onboarding walkthrough for first-time users

• Forgot password and password reset via email

• Account deletion support

🪴 My Garden – Plant Management

• Add, edit, and delete plants with photos

• Track health status, location, light conditions, and pot size

• AI-generated care schedules per plant

• Multiple photo uploads per plant

• Growth record tracking: height, leaf count, health score

🤖 AI Plant Coach

• Multi-turn conversational AI assistant powered by GPT-4o-mini via OpenRouter

• Context-aware responses using the user's real plant collection data

• AI-powered plant species identification from descriptions

• Persistent conversation history and management

• Rate-limited by tier: Free (3/day), Premium (unlimited)

🔬 AI Disease Detection

• Upload a photo of a leaf or stem for instant AI analysis

• Returns disease name, confidence score, severity level, treatment recommendations, and prevention tips

• Scan history with results stored per user

• Links scans to specific plants in the user's garden

• Earns XP rewards as part of gamification

📅 Care Schedules & Reminders

• Create and manage watering, fertilizing, pruning, misting, rotating, repotting, cleaning, and pest check schedules

• Today's tasks and overdue tasks views

• Care log history per plant

• Automated hourly reminder checks via cron jobs

• Push notification reminders via Firebase Cloud Messaging

📖 Plant Journal

• Create dated journal entries with text and photos

• Track moods, weather conditions, and observations

• Full CRUD with photo management

• Searchable entry history

📚 Plant Library & Encyclopedia

• 97+ plant species across 12 categories

• Detailed species info: care requirements, light/water needs, growing zones

• Search and category filtering

• Species detail pages with full care guides

👥 Community

• Create posts: showcase, question, tip, or trade

• Like/unlike with optimistic UI updates

• Comment threads on posts

• Paginated feed with infinite scroll

• Real-time updates via Socket.io WebSocket

🏆 Gamification

• 25 achievements across 7 categories

• XP points and level progression system

• Streak tracking for daily care tasks

• Leaderboard rankings

• Achievement unlocking with progress tracking

📊 Analytics & Insights

• Dashboard with total plants, weekly tasks, current streak, and plants needing attention

• Care history charts with configurable time periods

• Plant health trend metrics and growth tracking visualization

• Recent activity feed

🛠️ Admin Panel (Laravel + Filament)

• Dashboard with stats overview

• User, plant species, and subscription management

• Feedback management with admin reply support

• Webhook handlers for Apple and Google IAP events

🌍 Multi-Language & Notifications

• 7 languages: English, German, Spanish, French, Italian, Japanese, Portuguese

• Runtime language switching without app restart

• Firebase Cloud Messaging (FCM) push notifications for iOS and Android

• Per-type notification preferences in settings

• Local notification channels (Android)

⚙️ Tech Stack

• Mobile: Flutter 3.x (iOS, Android, Web) — Riverpod, GoRouter, Socket.io client

• Backend: NestJS 11 + TypeScript — PostgreSQL, Redis, BullMQ, Socket.io, Swagger

• Admin Panel: Laravel 11 + Filament 3.2

• AI: OpenRouter API (GPT-4o-mini) for coach and disease detection

• Auth: JWT + Refresh Tokens, Google OAuth, Apple Sign-In, OTP via AWS SES

• Payments: Apple StoreKit, Google Play Billing, Stripe (web)

• Storage: Cloudflare R2 (S3-compatible) with presigned URLs

• Infra: PM2 + Nginx on Hetzner, GitHub Actions CI/CD (3 workflows)

📦 What's Included

• Flutter Mobile App — 35+ screens, iOS, Android & Web, full source code

• NestJS Backend API — 22 modules, 107+ REST endpoints, WebSocket real-time

• Laravel + Filament Admin Panel — full admin dashboard with resource management

• PostgreSQL Database — 32 tables, 4 migrations, seed data (97 species, 25 achievements)

• CI/CD Pipelines — 3 GitHub Actions workflows (build, test, deploy)

• Swagger API Docs — auto-generated, available at /docs

• Full documentation and setup guide

💎 Subscription Plans (In-App)

• Free: 5 plants, 3 AI chats/day, 2 disease scans/day, basic schedules

• Premium Monthly — $4.99/month: Unlimited plants, unlimited AI, unlimited scans, full analytics, data export, seasonal calendar

• Premium Yearly — $49.99/year: All premium features at best value

• 7-day free trial on all premium plans

• Server-side receipt validation for Apple App Store and Google Play

📋 Requirements

• Flutter SDK 3.x

• Node.js 22+ and npm

• PHP 8.2+ and Composer (for Laravel admin panel)

• PostgreSQL 16+ database

• Redis 7+ instance

• Firebase project (Cloud Messaging / FCM)

• OpenRouter API key (GPT-4o-mini for AI features)

• Cloudflare R2 or S3-compatible storage bucket

• AWS SES account (transactional email)

• Stripe account (web payments)

• Apple Developer and/or Google Play account for IAP