kawamara1/cattle-management-system

Cattle and dairy farm management web app built for Uganda — React + Firebase # Cattle Farm Management System A cattle and dairy farm management web application built for real farm operations in Uganda. ## What It Does Obuteeka Farm is a full-featured livestock management system that tracks: - **Cattle Registry** — Individual animal records with health status, paddock assignment, and lifecycle tracking (Milking, Dry, Pregnant, Heifer, Bull, Calf, Sick) - **Milk Production** — Daily milk recording per animal with UGX revenue calculations at UGX 1,200/litre - **Health Records** — Veterinary visits, treatments, and health alerts per animal - **Paddock Management** — Assignment and tracking across named paddocks (Parlor, Grazing, Heifers, Bull Pen, Calf Pen) - **Financial Dashboard** — Revenue trends, production charts, and farm analytics - **Alerts & Notifications** — Health and event reminders ## Tech Stack | Layer | Technology | |-------|-----------| | Frontend | React 19 + Vite | | Styling | Tailwind CSS v4 | | Charts | Recharts | | Database | Firebase Firestore (real-time) | | Auth | Firebase Anonymous Auth | | Icons | Lucide React | ## Getting Started ```bash # Install dependencies npm install # Run development server npm run dev ``` Visit `localhost` ```bash # Build for production npm run build ``` ## Project Structure ``` src/ ├── App.jsx # Main application (single-file architecture) ├── main.jsx # React entry point └── index.css # Global styles ``` ## Firebase The app uses Firebase Firestore for real-time data sync. Animal and production data is stored per-session using anonymous authentication. Firebase security rules handle authorisation. ## Farm Context - **Location:** Uganda - **Primary product:** Dairy (milk at UGX 1,200/litre) - **Paddocks:** Parlor (Mzee Julius), Grazing (Kaganga), Heifers (Kato), Bull Pen, Calf Pen (Samuel)