njoroofficial/farmart

A full-stack e-commerce marketplace for buying and selling farm animals in Kenya. Farmers list their livestock, buyers browse and purchase, and the platform handles the full lifecycle from listing to payment. # Farmart — Farm Animal Marketplace A full-stack e-commerce marketplace for buying and selling farm animals in Kenya. Farmers list their livestock, buyers browse and purchase, and the platform handles the full lifecycle from listing to payment. --- ## Table of Contents - Overview - Tech Stack - Project Structure - Features - Getting Started - Prerequisites - Backend Setup - Frontend Setup - Environment Variables - API Reference - Database Schema - Authentication & Authorization - Key Design Decisions --- ## Overview Farmart connects Kenyan farmers directly with buyers looking to purchase farm animals. Farmers manage listings (cattle, goats, sheep, and more), upload images, and process incoming orders. Buyers browse the marketplace, filter by category, add items to cart, and checkout with delivery details. The platform supports M-PESA and card payment integrations. --- ## Tech Stack ### Frontend | Technology | Version | Purpose | | --------------------- | ------------- | ---------------------------- | | React | 19.2.4 | UI framework | | TypeScript | 5.9.3 | Static typing | | Vite | 8.0.1 | Build tool & dev server | | React Router | 7.14 | Client-side routing | | Tailwind CSS | 4.2.2 | Utility-first styling | | shadcn/ui | (via base-ui) | Accessible UI components | | Lucide React | 1.7.0 | Icon library | | clsx + tailwind-merge | — | Dynamic className management | | react-countup | — | Animated statistics | ### Backend | Technology | Version | Purpose | | ----------------------- | ---------------------------- | -------------------------------- | | Flask | 3.0.3 | Web framework …