Skip to content

chirchirx1/Farm-advisory-

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

3 Commits
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐ŸŒพ Farm Advisor - Offline First

An offline-capable web application designed to provide farmers with immediate access to agricultural advice, even in areas with poor or intermittent internet connectivity.

๐ŸŽฏ Problem Statement

Many farmers in rural areas face significant challenges accessing timely agricultural information due to:

  • Unreliable internet connectivity
  • Limited access to agricultural extension services
  • Time-sensitive farming decisions that can't wait for connectivity

This application addresses these challenges by providing a fully functional offline experience with essential farming guidance.

Features Core Functionality

  • ๐ŸŒ Offline-First Architecture - Works completely without internet connection
  • ๐ŸŒฑ Multiple Crop Support - Advice for Maize, Wheat, Rice, Soybeans, Tomatoes, and Potatoes
  • Weather-Based Guidance- Tailored recommendations for drought, heavy rain, and strong winds
  • ๐Ÿ’พ Local Storage - Automatically saves advice history for future reference
  • ๐Ÿ“ฑ Mobile-Responsive - Accessible on any device, from smartphones to desktops

Technical Features

  • Real-time online/offline status detection
  • Persistent data storage using browser localStorage
  • Clean, intuitive user interface
  • No backend required - fully client-side application

๐Ÿš€ Live Demo

๐Ÿ› ๏ธ Technologies Used

  • React - UI framework
  • Tailwind CSS - Styling
  • Lucide React - Icon library
  • localStorage API- Offline data persistence

๐Ÿ’ป Installation & Setup

Prerequisites

  • Node.js (v14 or higher)
  • npm or yarn

Local Development

  1. Clone the repository
git clone https://github.com/YOUR-USERNAME/farm-advisor.git
cd farm-advisor
  1. Install dependencies
npm install
  1. Start the development server
npm start
  1. ๐Ÿ“ฑ Usage

  2. Select Your Crop - Choose from the available crop options

  3. Identify Weather Condition - Select current weather challenges (dry, wet, or windy)

  4. Get Advice - Receive immediate, actionable farming recommendations

  5. Access History - View previously accessed advice even when offline

๐ŸŒŸ Use Cases

  • Rural Farmers - Access farming advice without reliable internet
  • Agricultural Extension Workers - Quick reference tool in the field
  • Agricultural Students - Learning resource for crop management
  • Emergency Situations - Critical guidance during connectivity outages

๐Ÿ”ฎ Future Enhancements

  • Add more crops and weather conditions
  • Pest and disease identification guides
  • Seasonal planting calendar
  • Photo capture for crop monitoring
  • Multi-language support
  • Voice-based interaction for low-literacy users
  • SMS integration for ultra-low connectivity areas
  • Progressive Web App (PWA) capabilities for installation

๐Ÿค Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the project
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

๐Ÿ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

๐Ÿ‘ค Author

Your Name

๐Ÿ™ Acknowledgments

  • Inspired by the real challenges faced by farmers in rural communities
  • Built as part of my commitment to creating technology that bridges the digital divide
  • Thanks to the open-source community for the amazing tools and libraries

๐Ÿ“ž Contact

Have questions or suggestions? Feel free to reach out or open an issue! Email: newtonchirchir@gmail.com

Made with โค๏ธ for farmers everywhereLive demo coming soon* - Currently setting up GitHub Pages deployment๐Ÿ˜€

About

Offline-capable agricultural advisory app solving real-world connectivity challenges for rural farmers.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors