Ndala-K-Abigail-Corp/CropSense

RAG WEB APP # 🌱 CropSense - Agricultural Guidance Platform CropSense is an AI-powered agricultural guidance platform that provides farmers with evidence-based answers to their farming questions using RAG (Retrieval-Augmented Generation) technology. ## 📋 Table of Contents - Overview - Architecture - Tech Stack - Project Structure - Getting Started - Development - Deployment - Documentation ## 🎯 Overview CropSense combines trusted agricultural resources with advanced AI to deliver: - **Context-aware answers** grounded in verified agricultural documents - **Source citations** for every response - **Mobile-friendly** chat interface - **Real-time** query processing ## 🏗️ Architecture ``` ┌──────────────┐ │ Web App │ │ (React+Vite) │ └──────┬───────┘ │ ▼ ┌──────────────┐ │ Firebase │ │ Auth+Hosting │ └──────┬───────┘ │ ▼ ┌──────────────┐ ┌──────────────┐ │ Functions │────▶│ RAG Backend │ │ (Node.js) │ │ (FastAPI) │ └──────────────┘ └──────┬───────┘ │ ▼ ┌──────────────┐ │ Vertex AI │ │ Embeddings + │ │ Gemini │ └──────────────┘ ``` ## 🛠️ Tech Stack ### Frontend - **React 18** - UI library - **Vite** - Build tool - **TypeScript** - Type safety - **Tailwind CSS** - Styling - **Framer Motion** - Animations - **React Router** - Navigation - **TanStack Query** - Data fetching - **React Hook Form + Zod** - Form handling ### Backend - **Firebase** - Auth, Hosting, Firestore, Functions - **FastAPI** (Python) - RAG backend - **Vertex AI** - Embeddings & Generation - **Firestore** - Vector storage (MVP) ### Tooling - **PNPM** - Package manager - **ESLint + Prettier** - Code quality - **Vitest** - Testing - **GitHub Actions** - CI/CD ## 📁 Project Structure ``` . ├── apps/ │ └── web/ # React frontend application │ ├── src/ │ │ ├── components/ # React components │ │ │ ├── ui/ # Base UI components │ │ │ └── layouts/ # Layout components │ │ ├── pages/ # Page co …