Skip to content

devi5040/Vegshell-Project

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

6 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🌾 AgriConnect Platform

Bridging Farmers & Markets Directly

A full-stack dual-portal agriculture platform that eliminates middlemen and connects farmers directly with buyers, vendors, and service providers.


πŸ“Œ Overview

AgriConnect is a scalable end-to-end agriculture ecosystem built to solve real-world farming and supply chain challenges. It provides dedicated platforms for Farmers and Customers/Vendors, ensuring seamless interaction, transparent pricing, and improved profitability.


✨ Key Features

  • πŸ‘¨β€πŸŒΎ Farmer Portal

    • Product listing & inventory management
    • Order tracking & sales insights
    • Direct communication with buyers
  • πŸ›’ Customer/Vendor Portal

    • Browse & purchase farm products
    • Real-time pricing & availability
    • Order history & tracking
  • πŸ› οΈ Admin Dashboard

    • User management
    • Product moderation
    • Platform analytics & monitoring
  • πŸ”— Direct Marketplace

    • Eliminates intermediaries
    • Better profit margins for farmers
    • Reduced costs for buyers
  • πŸ“± Cross-Platform Experience

    • Web app (React.js)
    • Mobile apps (React Native)
    • Shared business logic for consistency

🧰 Tech Stack

Frontend

  • βš›οΈ React.js
  • πŸ“± React Native

Backend

  • 🟒 Node.js
  • πŸš‚ Express.js

Database

  • πŸƒ MongoDB

Others

  • πŸ” RESTful APIs
  • πŸ”„ Shared business logic layer
  • ☁️ Scalable architecture

πŸš€ Getting Started

Prerequisites

  • Node.js (v16+)
  • MongoDB
  • npm / yarn

πŸ”§ Installation

1. Clone the repository

git clone https://github.com/your-username/agriconnect.git
cd agriconnect

2. Install dependencies (for each service)

cd backend
npm install

cd frontend
npm install


▢️ Running the Project

Backend

npm run dev

Frontend (Web)

npm start

Mobile Apps

npx react-native run-android

or

npx react-native run-ios


πŸ”‘ Environment Variables

Create a .env file in each backend service:

PORT=5000
MONGO_URI=your_mongodb_connection
JWT_SECRET=your_secret_key


πŸ“Š Core Modules

  • πŸ‘₯ User Authentication & Authorization
  • πŸ›οΈ Product Management
  • πŸ“¦ Order Management
  • πŸ’¬ Communication System
  • πŸ“ˆ Analytics Dashboard

πŸ§ͺ Testing

npm run test


πŸ“¦ Deployment

  • Backend: AWS / VPS / Render / Railway
  • Frontend: Vercel / Netlify
  • Database: MongoDB Atlas

🀝 Contributing

Contributions are welcome!

  1. Fork the repo 🍴
  2. Create a new branch 🌿
  3. Commit your changes πŸ’Ύ
  4. Push to the branch πŸš€
  5. Open a Pull Request πŸ”₯

πŸ›‘οΈ License

This project is licensed under the MIT License.


πŸ‘¨β€πŸ’» Author

Deviprasad Rai
πŸ’Ό Full Stack Developer | AI Enthusiast


🌟 Support

If you like this project:

  • ⭐ Star the repo
  • 🍴 Fork it
  • πŸ“’ Share it

πŸ’‘ Future Enhancements

  • πŸ“Š AI-based crop price prediction
  • 🌦️ Weather integration
  • πŸ’³ Payment gateway integration
  • 🚚 Logistics & delivery tracking

πŸš€ Empowering farmers. Simplifying agriculture. Connecting the future.

About

A full-stack agriculture platform built with MERN that connects farmers directly with buyers and vendors, eliminating middlemen. Features dual portals with role-based dashboards, cross-platform support (web and mobile), and scalable RESTful APIs for managing products, orders, and users.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors