Transform your black thumb into a green one with intelligent plant monitoring, proactive care recommendations, and personalized schedules that adapt to your plants' unique needs.

✅ Firebase Authentication (Google Sign-In)
✅ Cloud Firestore Database (Real-time sync)
✅ Firebase Storage (File uploads)
✅ Production Ready (Security & documentation)

→ Architecture Documentation

Most plant care apps are glorified reminders that treat every plant the same. Flourish is different.

We've built an AI agent that actually understands your plants - monitoring their health, predicting problems before they happen, and creating dynamic care schedules that evolve based on how your plants respond. No more guesswork, no more dead plants.

🧠 Intelligent Monitoring
Our AI continuously analyzes your plants' health metrics and environmental conditions, spotting issues before they become problems.

📸 Multi-Modal Analysis
Take a photo of your plant and get instant health assessments, disease identification, and personalized care recommendations.

🎯 Adaptive Scheduling
Care plans that learn and adjust based on your plants' actual responses - not generic timers that ignore reality.

💬 Expert AI Assistant
Chat with our plant care expert AI for instant answers about watering, lighting, diseases, and more.

📊 Garden Dashboard
Beautiful visualizations of your garden's overall health with actionable insights and progress tracking.

• ❌ Generic watering reminders every 3 days
• ❌ Guessing what's wrong when plants look sick
• ❌ One-size-fits-all care instructions
• ❌ Learning about problems too late

• ✅ Smart schedules that adapt to each plant's needs
• ✅ AI-powered health analysis from photos
• ✅ Personalized care plans that evolve over time
• ✅ Proactive alerts before problems develop

Flourish features a beautiful, cheerful design that makes plant care feel delightful rather than daunting. Our custom color palette and intuitive interface create a welcoming experience that encourages consistent care.

Core Features:

• 🌱 Plant Health Tracking - Monitor growth, watering needs, and overall wellness
• 📅 AI-Generated Schedules - Dynamic care plans that adapt to plant responses
• 🔍 Image Analysis - Instant plant health assessment from photos
• 💡 Smart Insights - Proactive recommendations to optimize plant health
• 📈 Progress Tracking - Visualize your garden's health trends over time

Flourish is built with modern, reliable technologies to ensure fast performance and seamless user experience:

Frontend: React 18 + TypeScript + Vite for lightning-fast development and optimized builds
UI/UX: Tailwind CSS + shadcn/ui components with custom Flourish design system
Backend: FastAPI (Python) with clean architecture and type-safe data models
AI Integration: Groq language models for advanced plant care intelligence
Authentication: Firebase Auth with Google OAuth for secure, hassle-free sign-in
State Management: React Query for efficient server state and caching
Development: Turborepo monorepo with optimized build pipelines

• Python 3.9+ - Download
• Node.js 18+ - Download
• Firebase Account - Project: flourish-de908 (already configured)

# Using batch file (recommended)
start.bat

# Or using PowerShell
.\start.ps1

This automated script will:

• ✅ Check all dependencies
• ✅ Install missing packages
• ✅ Start backend API on port 8000
• ✅ Start frontend on port 5173
• ✅ Open the app in your browser

Development (runs both services):

npm run dev              # Start both API and web in watch mode
npm run dev:api          # Start API only (port 8000)
npm run dev:web          # Start web only (port 5173)

Production:

npm run build            # Build both services
npm run build:api        # Build API Docker image
npm run build:web        # Build web for production
npm start                # Start both services in production mode

Testing:

npm test                 # Run all tests (frontend + backend)
npm run test:api         # Run backend tests (pytest)
npm run test:web         # Run frontend tests (vitest)
npm run test:watch       # Run frontend tests in watch mode
npm run test:ui          # Open vitest UI

Maintenance:

npm run lint             # Lint all workspaces
npm run clean            # Clean all build artifacts
npm run install:all      # Install all dependencies
npm run typecheck        # TypeScript type checking

Access:

• 🌐 Frontend: http://localhost:5173
• ⚙️ Backend: http://localhost:8000
• 📚 API Docs: http://localhost:8000/docs

Backend:

cd apps/api
pip install -r requirements.txt
python -m uvicorn main:app --reload

Frontend:

cd apps/web
npm install
npm run dev

1. Firebase Configuration

   • Service account key is already configured at apps/api/firebase-service-account.json
   • Environment variables are set in .env files

2. Sign In

   • Go to http://localhost:5173
   • Click "Sign in with Google"
   • Start managing your plants! 🌱

3. Optional: AI Features

   • Install Ollama for local AI
   • Run: ollama pull llama3
   • Or use Groq API (add GROQ_API_KEY to apps/api/.env)

Flourish/
├── apps/
│   ├── api/                    # Backend (FastAPI + Python)
│   │   ├── api/
│   │   │   ├── core/          # Auth & config
│   │   │   ├── db/            # Firestore & Storage
│   │   │   ├── routes/        # API endpoints
│   │   │   └── services/      # Business logic
│   │   ├── main.py            # API entry point
│   │   └── requirements.txt   # Python dependencies
│   └── web/                   # Frontend (React + TypeScript)
│       ├── src/
│       │   ├── components/    # React components
│       │   ├── hooks/         # Custom hooks (useAuth)
│       │   ├── lib/           # Firebase & utilities
│       │   ├── pages/         # App pages
│       │   └── integrations/  # API client
│       └── package.json       # Node dependencies
├── ARCHITECTURE.md            # System architecture docs
├── README.md                  # This file
└── start.ps1                  # Development start script

This project uses Firebase for all backend services:

• Google Sign-In provider
• JWT token-based API security
• Automatic session management

• profiles - User profiles & gamification
• plants - Plant inventory
• care_tasks - Scheduled tasks
• notifications - Real-time alerts
• health_checks - Plant health tracking

• Plant images: users/{userId}/plants/{plantId}/
• Documents: users/{userId}/documents/
• Profile photos: users/{userId}/profile/

Firebase Console: https://console.firebase.google.com/project/flourish-de908