Bharat-Bhakti-Yatra

Welcome to the Bharat-Bhakti! 🙏

Join hands in a spiritual journey that brings together India’s vibrant communities—Hindu, Muslim, Sikh, Jain, and more—in a celebration of unity and devotion. 🌺🙏 Experience the essence of divine love, peace, and shared cultural harmony as we walk the sacred path of oneness. This pilgrimage is a tribute to India’s timeless spirit, where faiths converge, hearts connect, and souls rise. Embrace the true soul of India—diverse, sacred, and beautifully united. Let your spirit be part of this divine awakening.

Github Stats

🌟 Stars	🍴 Forks	🐛 Issues	📏 Repo Size	🔔 Open PRs	🔕 Close PRs

Key Features 🎯

• 🕉️ Unity in Diversity: Brings together Hindus, Muslims, Sikhs, Jains, and more in spiritual harmony.
• 🚶‍♂️ Sacred Pilgrimage: Journey through holy sites that reflect India’s spiritual soul.
• 🎶 Cultural Celebrations: Experience devotional music, rituals, and regional traditions.
• 🧘 Inner Growth: Focus on meditation, peace, and self-discovery.
• 🤝 Community Bonding: Strengthens interfaith dialogue and shared values.
• 📿 Spiritual Discourses: Learn from saints, scholars, and spiritual leaders.
• 🇮🇳 Celebrating India’s Soul: A living tribute to the country’s timeless wisdom and collective spirit.
• 🌏 Unified Cultural Platform: One spiritual stage for all traditions, faiths, and communities.
• 📸 Memorable Experiences: Capture and live the essence of India’s soulful journey.

Demo 🖥️

You can visit the live site here : WebLink : Under Development

Technologies Used 👨🏻‍💻

• React.js – A powerful JavaScript library for building fast and scalable web applications.
• TypeScript {Workflow} – A typed superset of JavaScript for more reliable, maintainable code.
• TailwindCSS – A utility-first CSS framework for creating stunning, responsive designs effortlessly.
• Node.js – A JavaScript runtime for server-side development.
• Express.js – A lightweight and flexible web framework for Node.js.
• SASS/SCSS – A preprocessor for CSS to enhance styling capabilities.
• Mongoose – An elegant MongoDB object modeling tool for Node.js.
• MongoDB – A NoSQL database for scalable and high-performance data storage.
• Firebase – Used for authentication, backend functions, and automation tasks.
• GitHub Actions – CI/CD automation for streamlined development workflows.
• Docker – A container platform for easy deployment, scalability, and app management.

Getting Started ⚙️

Prerequisites

• Node.js v22.14.0 or higher
• npm or pnpm (Package Managers)
• Code Editor (e.g., VS Code)
• Git (Version Control System)
• Docker (For containerized deployments) : Not Required Initially
• MongoDB (Ensure MongoDB is installed locally or accessible via a cloud service like MongoDB Atlas)
• Postman (Optional but useful for API testing) : For Backend Only
• Browsers (Latest versions of Chrome, Firefox, or Edge for development and testing)

Installation 🛠️

• First Read this License & their terms then proceed.
• Star ⭐ the Repository
• Fork the repository (Optional)
• Project Setup:

1. Clone the repository:

    git clone https://github.com/UjjwalSaini07/Bharat-Bhakti-Yatra.git

2. Navigate to the project root directory:

    cd Bharat-Bhakti-Yatra

3. Navigate to the project Frontend directory:

    cd Frontend

• Install Frontend dependencies:

    pnpm install

4. Navigate to the project Backend directory:

    cd Backend

• Install Backend dependencies:

    pnpm install

Start the web app 🖥️

• Start the Frontend Development server

    cd Frontend

    pnpm dev

• Start the Backend Development server

    cd Backend

     pnpm dev

• Open your browser and navigate to http://localhost:5173 to view the localhost website

🤝 Contributing to Bharat Bhakti Yatra

Thank you for your interest in contributing to Bharat Bhakti Yatra! This project is community-driven, and we truly appreciate every contribution that helps enhance the platform.

✅ Contribution Workflow

🔍 1. Pick or Propose an Issue

• Explore the Issues tab and select any unassigned task.
• To suggest a feature or improvement, open a new issue.
• Wait for admin approval before you begin working to avoid duplicate efforts.

🎨 Development Guidelines

📱 Responsive UI with Tailwind CSS

• Ensure every component is fully responsive and visually consistent across screen sizes.
• Follow Tailwind utility-first best practices for cleaner styling.

📁 Code Organization

• Add all new components strictly inside the src/components/ directory.
• Follow DRY (Don't Repeat Yourself) principles and maintain reusable component logic.
• Use meaningful names for files, components, and commits.

🧹 Code Quality Standards

• All code must follow ESLint and Prettier formatting rules configured in the project.
• Only submit clean, modular, and properly formatted code.

🚀 Pull Request (PR) Guidelines

📤 Submitting a PR

• Only open PRs linked to an approved issue.
• Test your feature or fix thoroughly before submission.
• Include a clear PR description with a short explanation of what was added or fixed.
• If you're contributing UI changes, attach a screenshot or GIF in the PR description.
• PRs with bugs or incomplete implementations may be closed or sent back for revisions.

🕒 Task Assignment & Review Cycle

• Tasks are reviewed and assigned daily.
• PR reviews and feedback are provided regularly to maintain a smooth workflow.

💬 Need Help?

For queries or guidance, feel free to reach out to the project admin:

• GitHub: UjjwalSaini07
• LinkedIn: Ujjwal Saini

🌟 Community Support

• ⭐ Star the repository
• 🫱🏽‍🫲🏽 Share it with others who may want to contribute
• 💡 Suggest ideas, improvements, or enhancements

Thanks again for being part of Bharat Bhakti Yatra — together, we build better! 🇮🇳🚀

🌟GSSoc

🌟 Big Announcement!

🚀 This project is now officially part of GirlScript Summer of Code (GSSoC) 2025! 💻🎉
We’re excited to welcome contributors from across India and beyond to collaborate and grow with Bharat-Bhakti-Yatra. Let’s build something meaningful together and make open-source learning fun and rewarding! ✨

🎉 Excited to onboard new contributors for GSSoC 2025!
Let’s build, learn, and grow — one meaningful commit at a time. 🔥

🏆 GSSoC 2025 Contribution Guidelines

✅ Do's

• Read the project documentation before contributing
• Follow the coding standards and folder structure
• Write clear and meaningful commit messages
• Test your changes before submitting a PR
• Be respectful, collaborative, and maintain a positive environment
• Ask for help whenever you're unsure — collaboration > assumption

❌ Don'ts

• Don’t spam PRs or create multiple PRs for the same issue
• Don’t copy-paste code without understanding it
• Don’t make unnecessary or unrelated changes
• Don’t ignore review feedback from mentors or maintainers
• Don’t forget to update relevant documentation when needed

🎯 Contribution Levels

Level	Description	Points	Badge
🥉 Beginner	Fix typos, update docs, minor bug fixes	3
🥈 Intermediate	Add features, improve UI/UX, performance	7
🥇 Advanced	Major features, architecture improvements	10

📚 Helpful References

• 🔒 Security Policy – Learn how we keep the project safe and secure.
• 🤝 CODE OF CONDUCT – Understand the values and behavior we expect.
• 🛠️ CONTRIBUTING – Ready to help? Start here to contribute effectively.

Resources 📚

• Reactjs Documentation
• Typescript Documentation
• Nodejs Documentation
• Tailwind Documentation
• Expressjs Documentation
• Firebase Documentation
• GitHub Documentation
• Firebase Documentation
• Docker Documentation

👤 Project Admin

Contributors

View the full list of contributors on the GitHub Contributors Graph.

Thanks to all the wonderful contributors 💖

Contact 📞

Feel free to reach out if you have any questions or suggestions!

• Raise an issue for the same Issue
• Github: @Ujjwal Saini
• Mail: Mail ID

License 📄

License Credential Check.
You can use this project the way you want. Feel free to credit me if you want to!

Feedback and Contributions 💌

Feedback and contributions are always welcome! Feel free to open an Issue.

Show Some Love by Starring the repository and Share this product!