Bhagavad Gita - Interactive Reader

Project is live at https://ganeshneupane01.github.io/BhagvadGita/

An elegant, interactive web application for reading and exploring the Bhagavad Gita. This project provides a modern, user-friendly interface to read, search, and bookmark verses from the sacred Hindu scripture.

✨ Features

• 📖 Complete Text: All 18 chapters with verses from the Bhagavad Gita
• 🎨 Modern UI: Beautiful, responsive design with gradient themes
• 🌓 Dark/Light Mode: Toggle between dark and light themes for comfortable reading
• 🔍 Search Functionality: Search across all verses to find specific content
• 🔖 Bookmarks: Save your favorite verses for quick access later
• 🗣️ Text-to-Speech: Listen to verses with built-in text-to-speech functionality
• ⌨️ Keyboard Navigation: Use arrow keys to navigate between verses
• 📱 Mobile Responsive: Optimized for all screen sizes
• 💾 Local Storage: Bookmarks and theme preferences are saved locally

🚀 Getting Started

Prerequisites

You only need a modern web browser to run this application. No additional installations or dependencies are required.

Installation

1. Clone the repository:

git clone https://github.com/GaneshNeupane01/BhagvadGita.git

2. Navigate to the project directory:

cd BhagvadGita

3. Open index.html in your web browser:

# On Linux/Mac
open index.html

# On Windows
start index.html

# Or simply double-click the index.html file

📖 Usage

Navigation

• Chapter Selection: Click on any chapter in the left sidebar to view its verses
• Verse Navigation: Use the "Previous Verse" and "Next Verse" buttons to navigate
• Quick Jump: Use the dropdown menu at the bottom to jump to a specific verse
• Keyboard Shortcuts: Press left/right arrow keys to navigate between verses

Search

1. Enter your search query in the search bar at the top
2. Press Enter or click the search button
3. Click on any search result to navigate directly to that verse

Bookmarks

• Add Bookmark: Click the bookmark icon (🔖) on any verse to save it
• View Bookmarks: Click the bookmark icon in the header or switch to the "Bookmarks" tab
• Remove Bookmark: Click the trash icon on any bookmark card to remove it
• Clear All: Use the "Clear All" button to remove all bookmarks at once

Text-to-Speech

1. Click the "Read" button on any verse
2. Use the play/pause/stop controls to manage audio playback

Theme Toggle

Click the moon/sun icon in the header to switch between dark and light modes.

📁 Project Structure

BhagvadGita/
├── index.html           # Main HTML file with embedded CSS and JavaScript
├── bhagavad-gita.json  # JSON file containing all chapters and verses
└── README.md           # Project documentation (this file)

🎨 Technologies Used

• HTML5: Structure and content
• CSS3: Styling with custom properties and animations
• Vanilla JavaScript: All functionality without external frameworks
• Font Awesome: Icons for the user interface
• Web Speech API: Text-to-speech functionality
• Local Storage API: Persistent storage for bookmarks and preferences

🌐 Browser Compatibility

This application works best on modern browsers:

• Chrome/Edge (recommended)
• Firefox
• Safari
• Opera

📝 Data Source

The content of the Bhagavad Gita has been sourced from internet archives. Please note:

• The maintainer is not the original owner of this content
• There may be variations or differences from other versions
• Users should verify important references with authoritative sources

🤝 Contributing

Contributions are welcome! If you'd like to improve this project:

1. Fork the repository
2. Create a new branch (git checkout -b feature/improvement)
3. Make your changes
4. Commit your changes (git commit -am 'Add new feature')
5. Push to the branch (git push origin feature/improvement)
6. Open a Pull Request

🙏 Acknowledgments

• Content sourced from various internet archives
• Font Awesome for the icon library
• The open-source community for inspiration and tools

📧 Contact

For questions or suggestions, please open an issue on the GitHub repository.

---

Note: This is a web-based reader application intended for educational and spiritual purposes. Always refer to authenticated translations and commentaries for serious study.