a transparent, tech-enabled marketplace that smooths regional supply, protects farmer incomes, and delivers fresher produce to consumers
# Mt-Kenya Agro-Loup
A transparent, tech-enabled marketplace that smooths regional supply, protects farmer incomes, and delivers fresher produce to consumers.
## Project Overview
Mt-Kenya Agro-Loup is a full-stack MERN application designed to connect farmers directly with consumers in the Mt Kenya region. The platform eliminates middlemen, ensures fair pricing, and delivers farm-fresh produce efficiently.
## Features
### For Farmers
- π Easy product listing with crop details
- π° Transparent pricing and direct sales
- π Dashboard to manage products
- π± Mobile-friendly interface
### For Consumers
- πΎ Browse fresh, local produce
- π Filter products by crop type and location
- π¨βπΎ Connect directly with farmers
- β
View harvest dates and product details
### Platform Features
- π Responsive design for all devices
- β‘ Fast, modern user interface
- π Secure data handling
- π Real-time product updates
## Tech Stack
### Frontend
- React 18
- React Router for navigation
- Axios for API calls
- Vite for build tooling
- Modern CSS with custom properties
### Backend
- Node.js & Express
- MongoDB with Mongoose
- CORS enabled
- RESTful API design
## Getting Started
### Prerequisites
- Node.js (v16 or higher)
- MongoDB (local or Atlas)
- npm or yarn
### Installation
1. **Clone the repository**
```bash
git clone
cd mt-kenya-Agro-loup
```
2. **Backend Setup**
```bash
cd backend
npm install
```
Create a `.env` file in the backend directory:
```
MONGO_URI=mongodb://localhost:27017/mtkenya-agro
PORT=5000
ALLOWED_ORIGIN=
localhost
```
Start the backend server:
```bash
npm run dev
```
3. **Frontend Setup**
```bash
cd ../frontend
npm install
```
Create a `.env` file in the frontend directory:
```
VITE_API_URL=
localhost
```
Start the frontend development server:
```bash
npm run dev
```
4. **Access the Application**
- Frontend:
localhost
- Backend API:
localhost
## Project Structure
```
mt-kenya-Agro-loup/
βββ backend/
β β¦