Chhatrapati-sahu-09/Cropshare-connect-farmers-to-NGOs

Key Challenges:

• Information Asymmetry: Farmers and NGOs lack visibility into each other's needs and availability
• Logistical Barriers: No streamlined system for coordinating pickups and deliveries
• Communication Gaps: Limited channels for direct farmer-NGO interaction
• Resource Waste: Surplus crops often go to waste instead of reaching those in need
• Geographic Limitations: Local solutions needed for fresh produce distribution

🎯 Solution Overview

CropShare is a comprehensive digital platform that bridges the gap between farmers and NGOs, enabling seamless crop donation and distribution workflows. The platform provides:

• Direct Farmer-NGO Connections: Real-time marketplace for crop listings and requests
• Intelligent Matching: Smart algorithms to connect surplus with need
• Logistics Management: Integrated pickup and delivery coordination
• Communication Tools: Built-in messaging and notification systems
• Multi-language Support: Google Translate integration for accessibility
• Weather Intelligence: Real-time weather alerts for crop protection
• Role-based Dashboards: Tailored interfaces for farmers and NGO

🚀 Features & Workflows

1. User Authentication & Role Management

Workflow:

1. User registers as Farmer or NGO with profile information
2. Email verification and account activation
3. Role-based access to platform features
4. Profile management and preferences

Technical Implementation:

• JWT-based authentication
• Role-based middleware protection
• Secure password hashing
• Session management

2. Farmer Crop Management

Workflow:

1. Farmer logs in and accesses dashboard
2. Adds new crop listings with details (type, quantity, location, price)
3. Manages existing listings (edit, delete, update status)
4. Views incoming NGO requests
5. Approves/rejects pickup requests
6. Tracks donation history and earnings

Key Features:

• Image upload for crop verification
• Real-time listing status updates
• Request management interface
• Donation tracking and analytics

3. NGO Marketplace & Requests

Workflow:

1. NGO browses available crop listings
2. Filters by crop type, location, quantity
3. Sends requests to farmers with specific needs
4. Manages sent requests and responses
5. Initiates pickup scheduling for approved requests
6. Tracks ecosystem partnerships

Key Features:

• Advanced search and filtering
• Farmer profile viewing
• Request status tracking
• Ecosystem analytics

4. Real-time Communication

Workflow:

1. Users initiate chats from crop listings or requests
2. Real-time messaging with typing indicators
3. File/image sharing capabilities
4. Message history and archiving
5. Notification system for new messages

Technical Implementation:

• Socket.io for real-time communication
• Message encryption and privacy
• File upload handling
• Push notifications

5. Pickup & Delivery Operations

Workflow:

1. NGO initiates pickup request for approved crops
2. Farmer receives and responds to pickup requests
3. Logistics coordination (date, time, location)
4. Status tracking through pickup lifecycle
5. Completion confirmation and feedback

Key Features:

• GPS-based location coordination
• Real-time status updates
• Automated notifications
• Quality assurance checkpoints

6. Weather Intelligence & Alerts

Workflow:

1. System monitors local weather conditions
2. Generates alerts for farmers based on location
3. Weather impact analysis for crops
4. Preventive action recommendations
5. Historical weather data tracking

Integration:

• External weather API integration
• Location-based alerts
• Crop-specific weather recommendations

7. Multi-language Support

Workflow:

1. Automatic language detection
2. Google Translate widget integration
3. User language preferences
4. Translated UI elements and content

Technical Implementation:

• Google Translate API integration
• Cookie-based language persistence
• RTL language support

8. Dashboard Analytics

Farmer Dashboard:

• Crop listing performance
• Donation statistics
• Earnings tracking
• NGO connection metrics
• Weather alerts summary

NGO Dashboard:

• Request success rates
• Connected farmers overview
• Pickup operation status
• Ecosystem insights
• Available crop marketplace

🛠 Tech Stack

Frontend

• React 19+ - Modern UI framework
• Vite - Fast build tool and dev server
• React Router - Client-side routing
• Axios - HTTP client for API calls
• Socket.io-client - Real-time communication
• React Icons - Icon library
• CSS Modules - Component-scoped styling

Backend

• Node.js - Runtime environment
• Express.js - Web framework
• MongoDB - NoSQL database
• Mongoose - ODM for MongoDB
• Socket.io - Real-time bidirectional communication
• JWT - Authentication tokens
• bcryptjs - Password hashing
• multer - File upload handling

External Services

• Google Translate - Multi-language support
• Weather API - Weather data and alerts
• Email Service - User notifications

📋 Prerequisites

• Node.js 20.13.1 or higher
• MongoDB 4.4+ or MongoDB Atlas
• npm or yarn package manager

Screenshots

Landing Page

Crop Marketplace

Interactive Map View

Farmer Dashboard

Real-time Chat Interface

Donate to NGOs

In many developing regions, farmers face significant challenges with crop surplus and food waste, while NGOs struggle to source fresh, locally-grown produce for their community programs. The lack of efficient platforms creates barriers between farmers who have excess crops and NGOs that need them for distribution to vulnerable populations.

🚀 Installation & Setup

1. Clone the Repository

git clone https://github.com/Chhatrapati-sahu-09/Cropshare-connect-farmers-to-NGOs.git
cd Cropshare-connect-farmers-to-NGOs

2. Backend Setup

cd server
npm install

Create .env file in server directory:

PORT=5000
MONGODB_URI=mongodb://localhost:27017/cropshare
JWT_SECRET=your_jwt_secret_key
EMAIL_USER=your_email@gmail.com
EMAIL_PASS=your_email_password
WEATHER_API_KEY=your_weather_api_key
GOOGLE_TRANSLATE_API_KEY=your_google_translate_key

Start the backend server:

npm start

3. Frontend Setup

cd ../client
npm install

Create .env file in client directory:

VITE_API_BASE_URL=http://localhost:5000/api
VITE_SOCKET_URL=http://localhost:5000

Start the frontend development server:

npm run dev

4. Database Setup

Ensure MongoDB is running locally or configure MongoDB Atlas connection.

📖 Usage

For Farmers:

1. Register/Login as a farmer
2. Complete your profile with location and farming details
3. Add crop listings with photos and specifications
4. Monitor incoming NGO requests
5. Coordinate pickups for approved donations
6. Track your impact and earnings

For NGOs:

1. Register/Login as an NGO
2. Set up organization profile and focus areas
3. Browse available crops in your region
4. Send requests to farmers for specific needs
5. Manage pickup logistics
6. Build and track farmer partnerships

🔌 API Documentation

Authentication Endpoints

• POST /api/auth/register - User registration
• POST /api/auth/login - User login
• GET /api/auth/profile - Get user profile

Crop Management

• GET /api/crops - Get all crops (with filters)
• POST /api/crops - Add new crop (farmer only)
• PUT /api/crops/:id - Update crop
• DELETE /api/crops/:id - Delete crop

Request Management

• GET /api/requests - Get user requests
• POST /api/requests - Send crop request
• PUT /api/requests/:id - Update request status

Messaging

• GET /api/messages/:userId - Get conversation
• POST /api/messages - Send message
• GET /api/messages/unread - Get unread count

Pickup Operations

• GET /api/pickups - Get pickups for user
• POST /api/pickups - Create pickup request
• PUT /api/pickups/:id - Update pickup status

🚀 Future Enhancements

We're continuously working to improve CropShare and expand its capabilities. Here are some planned enhancements:

💳 Online Payment Integration

• Secure payment processing for crop purchases
• Multiple payment methods (UPI, cards, net banking)
• Transaction history and receipts
• Revenue tracking for farmers

📦 Order Tracking System

• Real-time GPS tracking for pickups and deliveries
• ETA predictions and route optimization
• Delivery confirmation with photos
• Automated status updates via SMS/email

🏛️ Government Scheme Integration

• Integration with agricultural subsidy programs
• Automatic eligibility checking
• Scheme benefit tracking and reporting
• Government certification verification

🤖 AI-based Price Recommendations

• Machine learning models for fair pricing
• Market trend analysis and predictions
• Crop quality assessment for pricing
• Dynamic pricing based on demand and supply

🌐 Regional Language Support

• Support for major Indian languages (Hindi, Tamil, Telugu, etc.)
• Voice-based input and commands
• Localized content and notifications
• Cultural adaptation for different regions

🤝 Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Development Guidelines

• Follow ESLint configuration
• Write meaningful commit messages
• Test API endpoints thoroughly
• Maintain component documentation
• Ensure responsive design

� Deployment on Render

Prerequisites for Deployment

• Render account (free tier available)
• MongoDB Atlas account (for database)
• GitHub repository access

Step 1: Prepare Environment Variables

Backend (.env)

NODE_ENV=production
PORT=10000
MONGODB_URI=your_mongodb_atlas_connection_string
JWT_SECRET=your_secure_jwt_secret
EMAIL_USER=your_email@gmail.com
EMAIL_PASS=your_app_password
WEATHER_API_KEY=your_weather_api_key
GOOGLE_TRANSLATE_API_KEY=your_translate_key
CLIENT_URL=https://your-client-app.onrender.com

Frontend (.env)

VITE_API_BASE_URL=https://your-server-app.onrender.com/api
VITE_SOCKET_URL=https://your-server-app.onrender.com

Step 2: Deploy Backend (Web Service)

1. Go to Render Dashboard
2. Click "New" → "Web Service"
3. Connect your GitHub repository
4. Configure service:
   • Name: cropshare-server
   • Runtime: Node
   • Build Command: npm install
   • Start Command: npm start
   • Root Directory: server
5. Add environment variables from Step 1
6. Click "Create Web Service"

Step 3: Deploy Frontend (Static Site)

1. Click "New" → "Static Site" in Render
2. Connect your GitHub repository
3. Configure site:
   • Name: cropshare-client
   • Build Command: npm run build
   • Publish Directory: client/dist
   • Root Directory: client
4. Add frontend environment variables
5. Click "Create Static Site"

Step 4: Update CORS Configuration

After deployment, update the backend environment variable:

CLIENT_URL=https://cropshare-client.onrender.com

Step 5: Database Setup

1. Create MongoDB Atlas cluster
2. Whitelist Render IP addresses (0.0.0.0/0 for development)
3. Update MONGODB_URI in backend environment variables

Step 6: Testing Deployment

1. Visit your frontend URL
2. Test user registration/login
3. Verify API calls work
4. Test real-time features (chat)
5. Check responsive design
6. Verify health check endpoint: https://your-server-app.onrender.com/api/health

Alternative: Using render.yaml

If you prefer automated deployment:

1. Ensure render.yaml is in your repository root
2. Push changes to GitHub
3. In Render dashboard, select "Blueprint" when creating new services
4. Render will automatically create both services

Troubleshooting Common Issues

Build Failures

• Check Node.js version compatibility
• Verify all dependencies are listed in package.json
• Check build logs for specific errors

CORS Errors

• Ensure CLIENT_URL matches your frontend domain
• Check if environment variables are set correctly
• Verify backend is redeployed after CORS changes

Database Connection

• Verify MongoDB Atlas IP whitelist
• Check connection string format
• Ensure database user has correct permissions

Real-time Features

• Confirm Socket.io configuration
• Check firewall settings
• Verify environment variables

Production Optimizations

• Enable gzip compression

• Set up CDN for static assets

• Configure monitoring and logging

• Set up backup strategies

• Implement rate limiting

  mermaid-diagram (1).png

�📄 License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

🙏 Acknowledgments

• Farmers and NGOs for their invaluable input
• Open source community for amazing tools and libraries
• Weather API providers for environmental data
• Google Translate for accessibility features

📞 Support

For support, email support@cropshare.com or join our Discord community.

Built with ❤️ for sustainable agriculture and community welfare"