Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/dadvaiahpavan/bhagavad-gita

A modern web application providing an interactive and accessible way to explore the teachings of the Bhagavad Gita. Built with React, TypeScript, and Tailwind CSS.
https://github.com/dadvaiahpavan/bhagavad-gita

firebase framer-motion react-18 tailwind-css typescript

Last synced: about 1 month ago
JSON representation

A modern web application providing an interactive and accessible way to explore the teachings of the Bhagavad Gita. Built with React, TypeScript, and Tailwind CSS.

Awesome Lists containing this project

README

        

# 📚 Bhagavad Gita App

A modern web application providing an interactive and accessible way to explore the teachings of the Bhagavad Gita. Built with React, TypeScript, and Tailwind CSS.

![Image 1](https://i.ibb.co/C8nxDrh/Screenshot-2024-12-06-143135.png)
![Image 2](https://i.ibb.co/9WVBbG2/Screenshot-2024-12-06-143149.png)
![Image 3](https://i.ibb.co/GJX2Vg0/Screenshot-2024-12-06-143210.png)
![Image 4](https://i.ibb.co/yyyCzvT/Screenshot-2024-12-06-143223.png)

## ✨ Features

- 📖 Browse all 18 chapters of the Bhagavad Gita
- 🔍 Search functionality for verses and keywords
- 🌙 Dark/Light theme support
- 🌐 Multi-language support
- 🎵 Built-in music player for spiritual ambiance
- 📱 Fully responsive design
- 🔥 Firebase authentication
- ⚡ Fast and optimized performance

## 🚀 Live Demo

[https://bhagavadgita-wisdom.netlify.app/](https://bhagavadgita-wisdom.netlify.app/)

## 🛠️ Tech Stack

- **Frontend Framework:** React 18
- **Language:** TypeScript
- **Styling:** Tailwind CSS
- **Build Tool:** Vite
- **State Management:** React Context API
- **Routing:** React Router DOM
- **Authentication:** Firebase
- **Animation:** Framer Motion
- **HTTP Client:** Axios
- **Additional Libraries:**
- React Slick (Carousel)
- React Icons
- React Audio Player

## 📋 Prerequisites

Before you begin, ensure you have the following installed:
- Node.js (v18 or higher)
- npm or yarn

## 🔧 Installation

1. Clone the repository:
```bash
git clone https://github.com/DadvaiahPavan/Bhagavad-Gita.git
cd bhagavad-gita-app
```

2. Install dependencies:
```bash
npm install
# or
yarn install
```

3. Create a `.env` file in the root directory and add your environment variables:
```env
VITE_FIREBASE_API_KEY=your_api_key
VITE_FIREBASE_AUTH_DOMAIN=your_auth_domain
VITE_FIREBASE_PROJECT_ID=your_project_id
```

4. Start the development server:
```bash
npm run dev
# or
yarn dev
```

## 📦 Build

To build the project for production:

```bash
npm run build
# or
yarn build
```

## 🏗️ Project Structure

```
src/
├── components/ # React components
├── context/ # Context providers
├── services/ # API services
├── styles/ # Global styles
├── App.tsx # Main app component
└── main.tsx # Entry point
```

## 🔍 Available Scripts

- `npm run dev` - Start development server
- `npm run build` - Build for production
- `npm run lint` - Run ESLint
- `npm run preview` - Preview production build

## 🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the project
2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request

## 📝 License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## 👏 Acknowledgments

- Bhagavad Gita API providers
- All contributors and supporters
- Open source community

## 📧 Contact

Pavan Dadvaiah - [[email protected]](mailto:[email protected])

Project Link: [https://github.com/DadvaiahPavan/Bhagavad-Gita.git](https://github.com/DadvaiahPavan/Bhagavad-Gita.git)