🏰 MahaFort - Maharashtra Fort Guide

A stunning, professional web application showcasing 42+ Maharashtra forts with comprehensive information, interactive chatbot, and beautiful UI/UX.

🌟 Features

✨ Stunning UI/UX

Vibrant gradient designs with Marathi cultural theme
Animated backgrounds and smooth transitions
Premium fort cards with hover effects
Equal-sized hero containers with dramatic visuals
Responsive design for all devices

🏰 Comprehensive Fort Database

42+ Maharashtra Forts with detailed information
Fort details: Location, difficulty, altitude, timings, entry fees
Historical significance and trekking routes
Search and filter by district and difficulty
Complete Sinhagad Fort itinerary

🤖 Bahirji Chatbot

Interactive AI assistant named "बहिर्जी नाईक" (Bahirji Naik)
Answers questions about forts, trekking, safety tips
Knowledge base covering major forts like Sinhagad, Raigad, Pratapgad
Beautiful chat interface with Marathi branding

📊 Statistics Dashboard

Total forts count
Districts covered
Easy trek recommendations
Average ratings

🚀 Quick Start Guide

Prerequisites

Make sure you have the following installed:

Node.js (v16 or higher) - Download here
npm (comes with Node.js)
Git - Download here

📥 Step 1: Clone the Repository

git clone https://github.com/YOUR_USERNAME/MAHAFORT-GUIDE.git
cd MAHAFORT-GUIDE

🎯 Running the Application

Option 1: Frontend Only (Recommended for Quick Start)

The frontend works standalone with static fort data!

# Navigate to frontend directory
cd frontend

# Install dependencies (first time only)
npm install

# Start the development server
npm start

The app will open automatically at: http://localhost:3000

Option 2: Full Stack (Frontend + Backend)

If you want to run both frontend and backend:

Terminal 1 - Backend Server

# Navigate to backend directory
cd backend

# Install dependencies (first time only)
npm install

# Start backend server
npm start

Backend runs on: http://localhost:5000

Terminal 2 - Frontend Server

# Navigate to frontend directory
cd frontend

# Install dependencies (first time only)
npm install

# Start frontend server
npm start

Frontend runs on: http://localhost:3000

📁 Project Structure

MAHAFORT-GUIDE/
├── frontend/                 # React frontend application
│   ├── public/              # Static files
│   │   └── index.html       # HTML template
│   ├── src/
│   │   ├── assets/          # Images (shivaji.jpg, bahirji.jpg, mahalogo.jpeg)
│   │   ├── components/      # React components
│   │   │   ├── Navbar.jsx           # Navigation bar with logo
│   │   │   ├── FortCard.jsx         # Premium fort card component
│   │   │   └── BahirjiChatbot.jsx   # AI chatbot component
│   │   ├── pages/           # Page components
│   │   │   ├── Home.jsx             # Main landing page
│   │   │   └── SinhagadItinerary.jsx # Sinhagad fort details
│   │   ├── data/
│   │   │   └── staticForts.js       # 42+ fort database
│   │   ├── services/        # API services
│   │   └── App.js           # Main app component
│   └── package.json         # Frontend dependencies
│
├── backend/                 # Node.js backend (optional)
│   ├── server.js           # Express server
│   ├── data/               # Fort data files
│   └── package.json        # Backend dependencies
│
└── README.md               # This file

🎨 Key Technologies

Frontend

React 18 - UI framework
React Router - Navigation
Tailwind CSS - Styling
React Icons - Icon library

Backend (Optional)

Node.js - Runtime
Express - Web framework
MongoDB - Database (if configured)

🛠️ Development Guide

Making Changes

Edit Fort Data: Modify frontend/src/data/staticForts.js
Update UI: Edit components in frontend/src/components/
Add Pages: Create new pages in frontend/src/pages/
Styling: Use Tailwind CSS classes

Adding New Forts

Edit frontend/src/data/staticForts.js:

{
  _id: 'fort-id',
  name: 'Fort Name',
  location: { district: 'District Name' },
  difficulty: 'Easy/Moderate/Hard',
  description: 'Fort description...',
  images: ['image-url'],
  rating: 4.5,
  bestTimeToVisit: 'October to March',
  entryFee: 'Free',
  timings: '6:00 AM - 6:00 PM',
  altitude: '1000 m',
  historicalSignificance: 'Historical info...'
}

🐛 Troubleshooting

Port Already in Use

# Kill process on port 3000 (Windows)
netstat -ano | findstr :3000
taskkill /PID <PID> /F

# Kill process on port 3000 (Mac/Linux)
lsof -ti:3000 | xargs kill -9

Dependencies Issues

# Clear npm cache
npm cache clean --force

# Delete node_modules and reinstall
rm -rf node_modules package-lock.json
npm install

Image Not Loading

Make sure images are in frontend/src/assets/ folder
Check import paths are correct
Restart development server

📦 Building for Production

cd frontend
npm run build

This creates an optimized production build in the build/ folder.

🌐 Deployment

Deploy to GitHub Pages

cd frontend
npm install gh-pages --save-dev
npm run deploy

Deploy to Vercel/Netlify

Connect your GitHub repository
Set build command: npm run build
Set publish directory: build
Deploy!

🎯 Features Checklist

✅ 42+ Maharashtra forts database
✅ Vibrant UI with Marathi theme
✅ Search and filter functionality
✅ Statistics dashboard
✅ Bahirji AI chatbot
✅ Sinhagad complete itinerary
✅ Premium fort cards
✅ Responsive design
✅ MahaFort logo and branding

🤝 Contributing

Fork the repository
Create your feature branch (git checkout -b feature/AmazingFeature)
Commit your changes (git commit -m 'Add some AmazingFeature')
Push to the branch (git push origin feature/AmazingFeature)
Open a Pull Request

📝 Notes for Developers

Important Files to Know

frontend/src/data/staticForts.js - Main fort database
frontend/src/components/BahirjiChatbot.jsx - Chatbot logic
frontend/src/pages/Home.jsx - Main landing page
frontend/src/components/Navbar.jsx - Navigation bar

Chatbot Knowledge Base

The Bahirji chatbot has built-in knowledge about:

Sinhagad, Raigad, Pratapgad forts
Trekking tips and safety
Best time to visit
Fort recommendations by difficulty

To add more knowledge, edit the fortKnowledge object in BahirjiChatbot.jsx.

🎨 Design System

Color Palette

Primary: Orange (#ea580c), Red (#b91c1c)
Accent: Yellow (#facc15)
Gradients: Multi-stop vibrant gradients
Text: White on colored backgrounds, Gray-800 on light

Typography

Headings: Font-black, large sizes (text-5xl to text-7xl)
Body: Font-medium to font-bold
Marathi Text: Clear, large, with drop-shadows

📧 Support

For issues or questions:

Check the troubleshooting section above
Review the code comments
Check browser console for errors
Create an issue on GitHub

📄 License

This project is open source and available for educational purposes.

🙏 Acknowledgments

Chhatrapati Shivaji Maharaj - Inspiration
Bahirji Naik - Maratha warrior and spy
Maharashtra Tourism - Fort information
React Community - Amazing framework

🚀 Happy Coding!

Made with ❤️ for Maharashtra's Heritage

🏰 Jai Shivaji! Jai Bhavani! 🚩

Name		Name	Last commit message	Last commit date
backend		backend
frontend		frontend
static		static
.gitignore		.gitignore
.nojekyll		.nojekyll
README.md		README.md
SETUP.md		SETUP.md
asset-manifest.json		asset-manifest.json
favicon.ico		favicon.ico
index.html		index.html
logo192.png		logo192.png
logo512.png		logo512.png
maharashtra_forts.csv		maharashtra_forts.csv
manifest.json		manifest.json
package-lock.json		package-lock.json
project_file_structure.txt		project_file_structure.txt
robots.txt		robots.txt

Latest commit

History

Folders and files

Repository files navigation