A modern, AI-powered agricultural advisory platform built with React and Vite. Brainwave provides intelligent soil analysis, crop recommendations, and farming guidance to help farmers make data-driven decisions.
Team: T027 Team Name : 404 Brain not found!
- AI-Powered Soil Analysis: Get personalized soil advisory based on locality, crop type, and growth stage
- Fertilizer Recommendations: Detailed fertilizer suggestions with quantities and application timing
- Organic Alternatives: Eco-friendly farming options and sustainable practices
- Irrigation Advice: Smart watering recommendations for optimal crop growth
- Soil Health Tips: Expert guidance for maintaining healthy soil
- Safety Alerts: Important cautions and warnings for safe farming practices
- Glassmorphism Design: Beautiful glass-like effects with backdrop blur
- Gradient Backgrounds: Animated gradient elements for visual appeal
- Responsive Layout: Seamless experience across all devices
- Smooth Animations: Fluid transitions and hover effects
- Dark Theme: Modern dark interface with excellent contrast
- Audio Integration: Play audio guidance for better accessibility
- Secure Registration: Email verification with OTP system
- User Authentication: JWT-based secure login
- Session Management: Persistent user sessions
- Form Validation: Real-time input validation and error handling
- Node.js (v16 or higher)
- npm or yarn
- Git
- MongoDB (local or cloud)
-
Clone the repository bash git clone https://github.com/Supanjit-Singh/FarmHelper.git cd FarmHelper
-
Start Backend Server bash
start-backend.bat
cd server npm install npm run dev
-
Start Frontend (in new terminal) bash
start-frontend.bat
cd brainwave npm install npm run dev
-
Open your browser
- Frontend: http://localhost:5173
- Backend API: http://localhost:3000
bash cd server npm install cp env.example .env
npm run dev
bash cd brainwave npm install npm run dev
bash
cd brainwave npm run build
cd server npm start
- React 18 - Modern React with hooks
- Vite - Fast build tool and dev server
- Tailwind CSS - Utility-first CSS framework
- React Router DOM - Client-side routing
- Axios - HTTP client for API calls
- React Hot Toast - Beautiful toast notifications
- Custom Design System - Consistent color palette and typography
- Glassmorphism Effects - Modern glass-like UI elements
- Responsive Design - Mobile-first approach
- Smooth Animations - CSS transitions and transforms
- ESLint - Code linting and formatting
- PostCSS - CSS processing
- Autoprefixer - CSS vendor prefixing
brainwave/ ├── public/ # Static assets ├── src/ │ ├── assets/ # Images, audio files, and icons │ │ ├── benefits/ # Benefit section assets │ │ ├── name.mp3 # Audio guidance files │ │ └── email.mp3 │ ├── components/ # Reusable UI components │ ├── pages/ # Main application pages │ │ ├── Dashboard.jsx # Main advisory dashboard │ │ ├── Login.jsx # User authentication │ │ └── Register.jsx # User registration │ ├── App.jsx # Main application component │ └── index.css # Global styles ├── package.json # Dependencies and scripts ├── tailwind.config.js # Tailwind configuration ├── vite.config.js # Vite configuration └── README.md # Project documentation
- Soil Advisory Form: Input locality, crop type, growth stage, and soil type
- AI Analysis: Get comprehensive farming recommendations
- Response Cards: Organized display of fertilizer, irrigation, and health tips
- Safety Alerts: Important cautions and warnings
- Login (/login): Secure user authentication with audio guidance
- Register (/register): User registration with email verification
- OTP Verification: Two-step verification process
- Primary Colors: Modern gradient combinations
- Neutral Colors: Dark theme with proper contrast
- Accent Colors: Color-coded sections for different content types
- Headings: Clear hierarchy with proper sizing
- Body Text: Readable fonts with optimal line height
- Labels: Consistent form labeling
- Input Fields: Modern rounded inputs with icons
- Buttons: Gradient buttons with hover effects
- Cards: Glassmorphism cards with backdrop blur
- Tables: Clean, responsive data tables
bash
npm run dev # Start development server npm run build # Build for production npm run preview # Preview production build npm run lint # Run ESLint
The application integrates with a backend API for:
- User authentication and registration
- Soil analysis and recommendations
- Data persistence and retrieval
- POST /api/user/register - User registration
- POST /api/user/login - User authentication
- POST /api/ai/soil - Soil advisory analysis
- Form Field Audio: Play audio guidance for username and email fields
- Accessibility: Enhanced user experience with audio feedback
- Audio Files: Integrated MP3 audio files for guidance
- Mobile First: Optimized for mobile devices
- Tablet Support: Enhanced layout for tablet screens
- Desktop: Full-featured desktop experience
- Cross-Browser: Compatible with modern browsers
- JWT Authentication: Secure token-based authentication
- Input Validation: Client and server-side validation
- HTTPS Ready: Secure communication protocols
- Session Management: Secure user session handling
- Run npm run build to create production build
- Deploy the dist folder to your hosting service
- Configure environment variables for API endpoints
env VITE_API_BASE_URL=http://localhost:3000 VITE_APP_NAME=FarmHelper
- Fork the repository
- Create a feature branch (git checkout -b feature/amazing-feature)
- Commit your changes (git commit -m 'Add some amazing feature')
- Push to the branch (git push origin feature/amazing-feature)
- Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
- React Team - For the amazing React framework
- Vite Team - For the fast build tool
- Tailwind CSS - For the utility-first CSS framework
- Open Source Community - For the amazing packages and tools
For support, email support@farmhelper.com or create an issue in the repository.
Built with ❤️ for the farming community
Empowering farmers with AI-driven agricultural insights