Agri Inn
Agri-Inn
:star: Awarded Second Runner Up in CSE Project Show 231 at United International University :star:
Special thanks and heartfelt gratitude to Ummay Maria Muna for her unwavering support, invaluable guidance, and constant motivation throughout the project. I am truly grateful for the collaborative journey we shared.
Welcome to Agri-Inn, the next-generation platform revolutionizing livestock farming and farm management. Agri-Inn connects farm owners, enthusiasts, and experts, streamlining operations, enabling livestock sales, and fostering a vibrant community. Whether you're managing farms, participating in forums, or staying updated on industry news and events, Agri-Inn is your gateway to a sustainable and closely-knit agricultural future.
🌟 Introduction
Agri-Inn is designed to bridge the gap between traditional farming and modern technology. Our platform empowers users to:
- Explore and purchase livestock from diverse farms
- Manage farm operations efficiently
- Stay informed with real-time news and events
- Engage in community forums and discussions
Learn more about our mission: About Us
📦 Project Scope
- Centralized marketplace for livestock and farm products
- Farm management and livestock health tracking
- Real-time news and event updates
- Community forums for advice and collaboration
- Online registration and payment for events and purchases
- Personalized user experience (saved items, favorite farms)
🚀 Features
E-Farms
- Browse and purchase livestock from global farms
- View detailed farm and animal profiles
- Save favorite farms for quick access
Animal Health Check-Up
- Maintain health records for each animal
- Schedule vet appointments
- Track diseases, vaccinations, and feeding schedules
News
- Real-time updates on livestock industry
- Search and save articles for future reference
Events
- Discover and register for livestock events
- Online payment for event fees
- Receive notifications for upcoming events
Forum
- Create and join discussion threads
- Like, comment, and save posts
- Trending section for popular topics
Livestock Marketplace
- List and purchase dairy products, animal food, medicines, and equipment
- Add items to cart and choose payment options
- Powerful search bar for easy navigation
🖥️ System Requirements
- Operating System: Windows 10+, macOS 10.13+, or Linux
- Node.js: v14.17.0 or higher (Download Node.js)
- MongoDB: v4.4.6 or higher (Download MongoDB)
- Disk Space: Minimum 150 MB
🛠️ Installation & Usage
1. Clone the repository:
git clone https://github.com/mariamuna04/Agri-Inn.git
2. Install dependencies:
npm install
3. Configure environment:
Create a .env file at the project root. Contact the developers for the required configuration.
4. Run the development server:
npm run dev
📚 Documentation & Resources
📝 Note
- For security issues, see Security Policy.
- For code of conduct, see CODE_OF_CONDUCT.md.
- For licensing, see LICENSE.
- Images, icons, and videos are available in
src/lib/assets/. - For any queries, contact the developers listed in About Us.
