Bhagavad Gita Reader
A beautiful, interactive web application for reading the Bhagavad Gita, featuring Sanskrit text, transliteration, and English translations. Built with modern web technologies to provide an elegant and accessible reading experience.
About This Project
This project brings the timeless wisdom of the Bhagavad Gita to the web with a clean, user-friendly interface. Whether you're a student of Indian philosophy, a spiritual seeker, or simply curious about this ancient text, this reader makes it easy to explore all 18 chapters and their verses.
Features
- Complete Bhagavad Gita: All 18 chapters with their verses
- Multiple Display Options:
- Original Sanskrit in Devanagari script
- Romanized transliteration for easy pronunciation
- Clear English translations
- Beautiful Design: Elegant UI inspired by traditional Indian aesthetics with a modern twist
- Chapter Navigation: Easy browsing through diamond-shaped chapter cards
- Verse Navigation: Scroll-style verse selectors for authentic feel
- Responsive Layout: Works seamlessly on desktop, tablet, and mobile devices
- Toggle Controls: Show or hide transliteration and translation as needed
Technology Stack
- SvelteKit - Modern JavaScript framework for building web applications
- Tailwind CSS - Utility-first CSS framework for styling
- Vite - Fast build tool and development server
Getting Started
Prerequisites
Make sure you have Node.js (version 16 or higher) installed on your computer.
Installation
- Clone this repository to your local machine
- Navigate to the project folder in your terminal
- Install the required dependencies:
npm install
Running Locally
Start the development server:
npm run dev
Then open your browser and visit http://localhost:5180 to see the application.
Building for Production
To create an optimized production build:
npm run build
Preview the production build:
npm run preview
Project Structure
bhagavad-gita-reader/
├── src/
│ ├── lib/
│ │ ├── components/ # Reusable UI components
│ │ ├── stores/ # State management
│ │ ├── data/ # Chapter and verse data
│ │ └── api/ # API integration utilities
│ ├── routes/ # Application pages
│ ├── app.css # Global styles
│ └── app.html # HTML template
├── static/
│ └── images/ # Images and icons
└── package.json # Project dependencies
Customization
You can easily customize the look and feel by modifying:
- Colors and styling in
tailwind.config.js - Layout components in
src/lib/components/ - Chapter and verse data in
src/lib/data/
Future Enhancements
Some ideas for future development:
- Audio narration of verses
- Search functionality across chapters
- Bookmarking favorite verses
- Multiple translation options
- Commentary from different scholars
- Dark mode support
Contributing
This is an open project and contributions are welcome! Whether it's fixing bugs, improving documentation, or adding new features, feel free to fork the repository and submit a pull request.
License
This project is open source and available for educational and personal use. The Bhagavad Gita text itself is in the public domain.
Acknowledgments
Special thanks to the scholars and translators who have made the Bhagavad Gita accessible to modern readers, and to the open source community for the amazing tools that made this project possible.
May the wisdom of the Gita illuminate your path.
