DeshDarshan 🇮🇳

DeshDarshan is a cultural web platform designed to help explore all 28 States and 8 Union Territories of India. Discover regional food, festivals, dances, heritage sites, and hidden fun facts through interactive cards, image sliders, and modern UI blending tradition with technology in a unique digital journey. ✨

🌐 Live Demo

🔗 Live URL: https://sampadatiwari30.github.io/DeshDarshan/

🧩 Tech Stack

• Frontend: HTML5, CSS3, JavaScript (ES6+)
• Frameworks/Libraries: Bootstrap 5
• Design: Responsive UI/UX, Card-based layout
• Version Control: Git, GitHub

📂 Folder Structure

DeshDarshan/
│
├── assets/               # Images and other static resources
├── states/               # Individual state detail pages
├── index.html            # Main homepage
├── style.css             # Custom styles
├── script.js             # JS for state linking
└── README.md             # Project documentation

🗂️ Table of Contents

1. 🌐 Live Demo
2. 🧩 Tech Stack
3. 📂 Folder Structure
4. 🤔 Problem Statement
5. 🌟 Features
6. 🛠️ Installation
7. 💵 How to Contribute
8. 📝 Note
9. 💗 Contributors
10. 🛠️ Troubleshooting
11. 🥑 License
12. ⭐ Star the Repo!
13. 🌸 GSSoC Participation

🤔 Problem Statement

India's cultural diversity is often reduced to just a few mainstream destinations. DeshDarshan addresses:

• 🏞️ Lack of platforms showcasing lesser-known cultural locations
• 🎊 No centralized information about regional traditions
• 🎯 Absence of personalized travel recommendations

🌟 Features

Core Functionalities:

• 🗺️ State-wise Exploration: Detailed cultural profiles
• 📸 Visual Galleries: Heritage spot collections
• 🔍 Smart Recommendations: Personalized suggestions
• 🧠 Cultural Quizzes: Interactive learning
• 📅 Interactive Festival Calendar: Browse and filter festivals across India
• 🌐 Multi-language Support: Coming soon

🛠️ Installation

1. Fork the repository
2. Clone locally:

git clone https://github.com/sampadatiwari30/DeshDarshan.git
cd DeshDarshan

🔑 Firebase Configuration

Update your Firebase SDK configuration in the file:

js/firebase.js

To enable Google Sign-In and other Firebase services, update your Firebase SDK configuration inside the project:

// Firebase Config
const firebaseConfig = {
  apiKey: "YOUR_API_KEY",  
  authDomain: "YOUR_AUTH_DOMAIN",  
  projectId: "YOUR_PROJECT_ID",  
  storageBucket: "YOUR_STORAGE_BUCKET",  
  messagingSenderId: "YOUR_MESSAGING_SENDER_ID",  
  appId: "YOUR_APP_ID",  
  measurementId: "YOUR_MEASUREMENT_ID"  
};

💵 How to Contribute

We ❤️ Open Source and beginner-friendly contributions!
Follow these steps to get started:

1. Check existing issues or create one describing your feature/bug.
2. Comment on the issue to get assigned.
3. Fork 🍴 → Clone 👥 → Create a new branch:

# Fork in your GitHub account
git clone https://github.com/sampadatiwari30/DeshDarshan.git
cd DeshDarshan

# Create a new branch
git checkout -b feature/your-feature-name

# Make your changes, then:
git add .
git commit -m "Add: your-feature-name"
git push origin feature/your-feature-name

4. Create Pull Request to main branch

📝 Note

✅ No need to wait for issue assignment — just comment and start working!

💗 Our Contributors

🛠️ Troubleshooting

Having trouble setting up the project?

• Double-check that you're opening index.html
• If images are not loading, check path references.
• Still stuck? Raise an issue - we're here to help ✨
• Not sure how to set up the project? Check the README steps again

🥑 License

This project is licensed under the MIT License.
Feel free to fork, remix, or build upon it — with proper credit 🙏

⭐ Star the Repo!

If this project inspired you or helped in any way — do leave a ⭐
It keeps us going and growing!

🌸 For GSSoC Participation Era

This repository is a part of GirlScript Summer of Code! 💜
We welcome contributors of all levels.

If you're participating in GSSoC, feel free to raise issues and PRs tagged with GSSoC label.

Happy Contributing! 🎉