hxxdini/FarmMarket

FarmMarket is a platform delivering real-time market data, direct sales, and agri-support services to smallholder farmers in Uganda. Helps farmers bridge information gaps for better decisions on pricing, timing, and practices. # FarmMarket: Farmer Market Platform The Farmer Market Platform is a comprehensive web application designed to connect farmers, buyers, and agricultural experts. It provides a suite of tools to help farmers manage their crops, sell their produce directly to consumers, and access expert advice to improve their yields. ## 📊 Project Status **Status:** Actively in development The platform is nearly feature-complete, with a comprehensive testing suite and a full-featured offline-first Progressive Web App (PWA). The current focus is on preparing the application for its initial production launch. **Next Up:** Production Deployment & Monitoring For more details on the project's progress, you can review the Implementation Plan. ## ✨ Key Features - **🛍️ Marketplace**: A platform for farmers to list their products and for buyers to purchase fresh produce. - **📈 Real-time Market Prices**: Access up-to-date market prices for various crops. - **🔔 Price Alerts**: Customizable alerts for significant price changes. - **💬 Community Forum & Expert Advice**: A space for farmers and experts to connect, ask questions, and share knowledge. - **🗓️ Planting Calendar**: A tool to help farmers schedule and manage their planting and harvesting activities. - **✉️ Real-time Messaging**: A chat system for seamless communication between users. - **🌐 Offline Support**: Designed to work in areas with limited internet connectivity. For a full list of features, please see the **[[Key Features|docs/Key-Features.md]]** documentation. ## 🛠️ Tech Stack - **Framework**: Next.js (React) - **Language**: TypeScript - **Database**: PostgreSQL - **ORM**: Prisma - **Authentication**: NextAuth.js - **Styling**: Tailwind CSS with shadcn/ui - **Real-time**: Socket.IO - **Testing**: Jest & Playwright For a more detailed breakdown, check out the **[[Project Architecture|docs/Project-Architecture.md]]** document. ## 🚀 Getting Started This guide will get you a copy of the project up and running on your …