AgroRoot ek full-stack web application hai jo farmers aur agriculture ecosystem ke liye modern digital solutions provide karta hai. Yeh project scalable architecture ke saath design kiya gaya hai jisme frontend aur backend clearly separated hain.

• Project Overview
• Features
• Tech Stack
• Project Structure
• System Architecture
• Installation Guide
• Running the Project
• API Communication
• Environment Variables
• Troubleshooting
• Build & Deployment
• Future Improvements

AgroRoot ka aim hai agriculture domain ko digitalize karna by providing:

• User-friendly interface
• Fast backend APIs
• Scalable system design
• Real-time interaction capability (extendable)

• Responsive UI
• Fast navigation (Vite powered)
• API-based dynamic data rendering

• REST API architecture
• Modular backend structure
• Easy scalability
• Clean separation of frontend & backend

• React.js
• Vite
• JavaScript (ES6+)
• CSS

• Java
• Spring Boot
• Maven
• REST APIs

AgroRoot/
│
├── AgroRoot--Frontend-main/
│   ├── src/
│   ├── public/
│   ├── package.json
│   └── vite.config.js
│
├── AgroRoot--Backend-main/
│   ├── src/main/java/
│   ├── src/main/resources/
│   ├── pom.xml
│   └── mvnw

[ React Frontend ]  --->  [ Spring Boot Backend ]  --->  [ Database (optional/future) ]
        |
        | HTTP (REST API Calls)
        ↓
   JSON Responses

Ensure system me ye installed ho:

Check versions:

node -v
java -version
mvn -v

git clone <your-repo-url>
cd AgroRoot

cd AgroRoot--Frontend-main

npm install

npm run dev

👉 Runs on:

http://localhost:5173

cd AgroRoot--Backend-main

mvnw.cmd spring-boot:run

./mvnw spring-boot:run

👉 Runs on:

http://localhost:8080

Frontend backend APIs ko call karta hai via HTTP requests.

• Backend must run before frontend
• API URL sahi hona chahiye

Example:

const BASE_URL = "http://localhost:8080";

Create .env file in frontend:

VITE_API_BASE_URL=http://localhost:8080

Use in code:

import.meta.env.VITE_API_BASE_URL

server.port=8080

1. User frontend pe action karta hai
2. React API call bhejta hai
3. Spring Boot request handle karta hai
4. Response JSON me return hota hai
5. UI update hoti hai

• Run: npm install
• Check Node version

• Java version check karo
• Maven install verify karo

• Check:

  • Backend running hai?
  • Port correct hai?
  • CORS enabled hai?

npm run build

Output:

dist/ folder

./mvnw clean package

Output:

target/*.jar

Run jar:

java -jar target/app.jar

• Vercel
• Netlify

• Render
• AWS EC2
• Railway

• Authentication system (JWT)
• Database integration (MySQL/PostgreSQL)
• Role-based access
• Real-time notifications
• AI-based recommendations

1. Fork repo
2. Create branch
3. Make changes
4. Commit
5. Open Pull Request

This project is intended for learning and development purposes.

AgroRoot Development Team