| RELEASE | v1.0.0 | BOTANICAL DATA | 300+ SPECIES | UI STYLES | 50+ COMPONENTS | STACK | NEXT.js 16 | LICENSE | MIT |
|---|
A premium botanical identification and adoption ecosystem powered by AI and RAG-based intelligence.
| 🤖 AI Botanical Consultant | 🗺️ Geospatial Plantation Mapping | 🤝 Community Social Feed |
|---|---|---|
 |
 |
 |
| Real-time Identification: Powered by Gemini 1.5 Flash and PlantNet, providing instant botanical diagnostics. | Interactive Impact: Live reforestation tracking with precise geospatial coordinates and carbon metrics. | Sustainable Social: Share growth milestones, adopt trees, and connect with verified environmental NGOs. |
GreenGuard is a state-of-the-art environmental platform designed to bridge the gap between Non-Governmental Organizations (NGOs) and nature enthusiasts. By combining high-fidelity UI/UX with advanced Retrieval-Augmented Generation (RAG), we transform environmental conservation into an immersive, social, and AI-enhanced journey.
- 🧠 Flora Genius Consultant (RAG AI): Standalone microservice utilizing Google Gemini for reasoning and Supabase
pgvectorfor grounded botanical advice. Now featuring Stateful Conversational Memory using thestartChatinterface for multi-turn dialogues. - 🎨 Premium Visual Engine: Next.js 16 + React 19 + Tailwind CSS 4 implementation featuring Glassmorphism 2.0, Framer Motion 12, and immersive Atmospheric Backgrounds.
- 🗺️ Geospatial Discovery: Integrated PostGIS to enable radius-based searches and live interactive plantation mapping.
- 🛡️ NGO Verification: Multi-step onboarding with Darpan ID validation and administrative impact questionnaires.
- 📸 Growth Timeline: Track plant health from sapling to tree with health metrics and community sharing.
GreenGuard is built for long-term sustainability. We employ automated systems to ensure the repository remains healthy, active, and documented.
- 🤖 Automated Daily Heartbeat: A scheduled GitHub Action that validates repository connectivity and ensures daily progress tracking.
- 📜 Live Technical Log: All system updates and automated health checks are recorded in our DAILY_LOG.md.
- 🚀 CI/CD Rulesets: Protected
mainbranch with automated deployment to Hugging Face via GitHub Actions. - ✅ Continuous Monitoring: Real-time status tracking of our AI microservices and database integrity.
| Layer | Technologies |
|---|---|
| Frontend | Next.js 16, React 19, Tailwind CSS 4, Framer Motion, Axios, Leaflet |
| Backend | Node.js, Express.js, Supabase, PostGIS, JWT |
| AI/ML | Google Gemini 1.5 Flash, Supabase pgvector (RAG) |
| DevOps | Hugging Face Spaces, Vercel (Frontend), Supabase (DB/Auth) |
git clone https://github.com/shard-c6/greeguard_complete.git
cd greeguard_completeConfigure .env files in backend/, frontend/, and flora-genius-consultant/ using the provided templates.
# Terminal 1: Backend
cd backend && npm run dev
# Terminal 2: Frontend
cd frontend && npm run dev
# Terminal 3: AI Consultant
cd flora-genius-consultant && npm run devWe welcome contributions from environmentalists and developers of all skill levels. Whether you're fixing a bug, adding botanical data, or suggesting a feature, your impact matters.
- Mobile Transition: Expanding the UI to a native mobile experience via Capacitor & Offline PWAs.
- Advanced RAG: Integrated hybrid search and stateful conversational memory for precision diagnostics.
- Global Species Expansion: Successfully reached 500+ validated botanical entries.
- Scalability Engine: Implementing Redis caching, Edge middleware, and API rate limiting.
- UI/UX Polish: Smooth page transitions and micro-interactions using Framer Motion.
- Explore: Check out DAILY_LOG.md to see what's currently in progress.
- Setup: Follow the Getting Started guide to run the project locally.
- Standards: Ensure all PRs include relevant updates to the technical log and documentation.
- Submit: Create a pull request against the
mainbranch with a clear description of your changes.
Need inspiration? Look for good first issue tags in our issues or propose a new feature in the discussions!
- Getting Started Guide — Complete local development and onboarding guide.
- API Specification — Flora Genius AI Consultant endpoint details.
- Database & RAG Logic — Supabase schema, PostGIS spatial queries, and pgvector RAG mechanics.
- Contributing Guidelines — Branch naming standards, GPG/SSH signature requirements, and workflows.
- Project Report — Full ecosystem walkthrough.
- Technical Handover — Architectural details and schema logic.
- Deployment Guide — Production setup and seeding.
This project is licensed under the MIT License - see the LICENSE file for details.