Ghost590-beep/AgroConnect-Cameroon
Domain:
agriculturesocioeconomicRecord type:
softwareproject
Creator:
Gho
Host:
Social network for farmers, buyers and service providers to collaborate freely
# 🌾 === AGROCONNECT CAMEROON ====
A simple online marketplace for agriculture in Cameroon.
Farmers, buyers, and service providers can buy, sell, and offer services in one place.
# 📌 === What is AGROCONNECT =====
A web app based platform that connects:
-Farmers → sell crops or rent equipmen.
-Buyers → buy products like crops, animals, or tools.
-Service Providers → offer services like transport, labour, or veterinary care.
# 🚀 ====== Project Goal =========
To make agriculture easier, faster, and more connected in Cameroon.
# ⚙️ Tech Stack
-Frontend: React + Tailwind CSS + Typescript
-Backend: Node.js + Express
-Database: MYSQL
-Auth: JWT + bycrypt
-API call: Axios
-File Uploads: Multer
-Deployment: Vercel (frontend), Render (backend), Railway(database)
# 📄 ==== Main Pages ====
-/ → Landing page
-/auth → Login & Register
-/dashboard → User home
-/marketplace → Browse products
-/profile → Manage account
# 👤 ==== User Modes ====
-Seller → create listings
-Buyer → buy products
-Service Provider → offer services
# 🛒 ===== Categories ======
Crops & Seeds
Animals
Machines & Tools
Services
Medications
# 📁 ==== Project Structure =====
agro_connect/
├── client/ # Frontend (React)
├── server/ # Backend (Express)
├── database/ # MySQL schema
├── .github/ # CI/CD workflows
├── README.md
└── PROGRESS.md
# 🌿 ==== Branch Rules ====
feat/... → new feature
fix/... → bug fix
docs/... → documentation
# 🚀 ===== Development Plan ====
Build frontend
Design database
Build backend
Connect frontend + backend
Test & deploy
# ===== 📊 Project Status =======
See PROGRESS.md for details.
✅ Repo created
✅ Wireframes done
⏳ Everything else in progress
# ===== ▶️ Run Locally ======
# Clone project
git clone github.com
# Frontend
cd client
npm install
npm run dev
# Backend
cd ../server
npm install
cp .env.example .env
node index.js
# 🔐 ==== Environment Variables =====
Create .env in /server:
PORT=5000
DB_HOST=localhost
DB_USER …