Logo Lanfrica

Ghost590-beep/AgroConnect-Cameroon

Domaine:

agriculturesocioeconomic

Type de record:

softwareproject
Créateur:
Gho
Hôte:
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 …