Universal Access to Spiritual Wisdom
🌐 Live Demo • 📚 Documentation • 🚀 Getting Started • 🤝 Contributing
HoliBooks is a modern, beautifully designed web application that provides universal access to sacred texts from the world's major religions. Our mission is to make spiritual wisdom accessible to everyone, everywhere, in their preferred language.
Experience timeless teachings from Islam, Christianity, Hinduism, Judaism, Sikhism, and Buddhism through an elegant, distraction-free interface designed for contemplative reading.
- 🌍 300+ Languages - Read in your native tongue
- 📱 Progressive Web App - Install on any device
- 🎨 Stunning Design - Glass morphism UI with aurora gradients
- 🔍 Smart Search - Find verses instantly with
Ctrl+K - 🔖 Bookmarks - Save and organize your favorite passages
- 🌙 Dark/Light Themes - Comfortable reading day or night
- ⚡ Lightning Fast - Optimized vanilla JavaScript
- 🔊 Audio Recitations - Listen to sacred verses
- 📱 Desktop/Mobile Toggle - Switch between optimized layouts
- 📊 API Monitoring - Real-time health status of all data sources
Access sacred texts in your preferred language with comprehensive multi-language support:
| Religion | Sacred Text | Languages Available |
|---|---|---|
| ☪️ Islam | Holy Quran | 90+ languages including Arabic, English, Urdu, French, Spanish, Indonesian, and more |
| ✝️ Christianity | Holy Bible | 200+ versions including KJV, NIV, ESV, and translations in 100+ languages |
| 🕉️ Hinduism | Bhagavad Gita | Sanskrit, English, Hindi, and other Indian languages |
| ✡️ Judaism | Torah | Hebrew, English, Yiddish, and Ladino |
| 🪯 Sikhism | Guru Granth Sahib | Gurmukhi, English, and Punjabi |
| ☸️ Buddhism | Tripitaka/Dhammapada | Pali, English, and other Buddhist canonical languages |
HoliBooks works seamlessly across all devices with full PWA capabilities:
- ✅ Works Offline - Complete offline fallback data for uninterrupted reading
- ✅ Installable - Add to home screen on iOS, Android, and Desktop
- ✅ Fast Loading - Optimized assets and lazy loading
- ✅ Native Experience - Feels like a native app
- ✅ Automatic Updates - Always get the latest version
Powerful discovery tools for deeper engagement:
- Global Search (
Ctrl+K) - Search across all texts instantly - Deep Linking - Share specific verses with URL parameters
- Smart Suggestions - Intelligent search with autocomplete
Never lose access to spiritual wisdom:
- Fallback Data - All 6 religions have complete offline data
- Cached Content - Previously viewed content available offline
- No Internet Required - Core functionality works without connection
Every pixel crafted for spiritual contemplation:
- Glass Morphism UI - Modern translucent elements with backdrop blur
- Aurora Gradient Backgrounds - Ethereal animated color flows
- Custom SVG Icons - Beautiful handcrafted icons (no emojis)
- 3D Card Effects - Interactive hover animations with depth
- Smooth Transitions - 60fps animations throughout
Comfortable reading in any environment:
- Automatic Detection - Respects system preferences
- Manual Override - Toggle anytime with one click
- Persistent Preference - Remembers your choice across sessions
Track your spiritual journey:
- Progress Indicators - Visual progress bars for each text
- Resume Reading - Pick up where you left off
- Completion Stats - Track your reading achievements
Organize your spiritual exploration:
- One-Click Bookmarking - Save verses instantly
- Organized Collections - Categorize by religion or theme
- Reading History - Recently viewed passages
- Export/Import - Backup your bookmarks
Optimized experience for every screen:
- Responsive Layouts - Adaptive design for all devices
- View Toggle - Switch between desktop and mobile layouts
- Touch Optimized - Gesture support for mobile devices
- Keyboard Navigation - Full keyboard support for desktop
Stay informed about data sources:
- Real-Time Status - Live monitoring of all APIs
- Visual Indicators - Color-coded health status
- Automatic Fallbacks - Seamless switching to offline data
- Uptime Statistics - Track API reliability
Detailed breakdown of language support by religion:
| Religion | Primary Languages | Translation Coverage |
|---|---|---|
| Islam (Quran) | Arabic, English, Urdu, French, Spanish, Indonesian, Turkish, Bengali, Russian, Chinese | 90+ translations with audio recitations |
| Christianity (Bible) | English, Spanish, Portuguese, French, German, Chinese, Korean, Japanese, Arabic, Hindi | 200+ versions across 100+ languages |
| Hinduism (Bhagavad Gita) | Sanskrit, English, Hindi, Tamil, Telugu, Kannada, Malayalam, Gujarati, Bengali | Original Sanskrit with multiple translations |
| Judaism (Torah) | Hebrew, English, Yiddish, Ladino, Spanish, French, Russian, German | Traditional and modern translations |
| Sikhism (Guru Granth Sahib) | Gurmukhi, English, Punjabi, Hindi, Spanish, French | Original Gurmukhi with transliterations |
| Buddhism (Dhammapada) | Pali, English, Spanish, French, German, Chinese, Japanese, Thai, Sinhala | Canonical Pali texts with translations |
| Home Page | Quran Reader | Mobile View | Dark Mode |
|---|---|---|---|
 |
 |
 |
 |
| Elegant landing with 3D cards | Immersive reading experience | Perfect on all devices | Easy on the eyes |
- Node.js 16+ (for local development server)
- Modern web browser (Chrome 90+, Firefox 88+, Safari 14+, Edge 90+)
- Internet connection (for initial API data)
-
Clone the repository
git clone https://github.com/ai-dev-2024/HoliBooks.git cd HoliBooks -
Start development server
node serve.js
-
Open in browser Navigate to
http://localhost:3000
# Run local development server
node serve.js
# Test API endpoints
node test-apis.js
# Open browser at http://localhost:3000# Install Vercel CLI (if not already installed)
npm i -g vercel
# Deploy to production
npx vercel --prodOr connect your GitHub repository to Vercel for automatic deployments on every push.
# Build for production (if build step exists)
npm run build
# Deploy static files to any static hosting
# (Vercel, Netlify, GitHub Pages, etc.)HoliBooks is built with modern web technologies while maintaining zero dependencies:
- Zero Dependencies - No framework bloat
- Lightning Fast - No build step required
- Future Proof - Uses native Web APIs
- Easy to Contribute - No framework knowledge needed
- Small Bundle Size - Optimal performance
HoliBooks integrates with multiple APIs to provide comprehensive religious text data:
- Provider: AlQuran Cloud
- Documentation: https://alquran.cloud/api
- Features: 90+ translations, audio recitations
- Provider: Bible API
- Source: JSDelivr CDN
- Features: 200+ versions, multiple languages
- Provider: Vedic Scriptures
- Documentation: https://vedicscriptures.github.io
- Features: Sanskrit verses with translations
- Provider: Bible API
- Source: JSDelivr CDN
- Features: Hebrew and English texts
- Provider: GurbaniNow
- Documentation: https://gurbaninow.com/api
- Features: Gurmukhi, transliteration, translations
- Source: Embedded JSON data with complete offline fallback
- Features: Pali canon with English translations
HoliBooks/
├── index.html # Landing page with religion selector
├── serve.js # Local development server (Node.js)
├── test-apis.js # API endpoint testing
├── css/
│ ├── global.css # Global styles, CSS variables, themes
│ └── animations.css # Animation keyframes and effects
├── js/
│ ├── utils.js # Shared utilities, theme management
│ ├── audio-player.js # Audio player component
│ ├── language-selector.js # Language selection component
│ ├── bookmarks.js # Bookmark management system
│ └── search.js # Global search functionality
├── religions/ # Individual religion readers
│ ├── islam/ # Quran reader (quran.html, quran.css, quran.js)
│ ├── christianity/ # Bible reader (bible.html, bible.css, bible.js)
│ ├── hinduism/ # Gita reader (gita.html, gita.css, gita.js)
│ ├── judaism/ # Torah reader (torah.html, torah.css, torah.js)
│ ├── sikhism/ # Gurbani reader (gurbani.html, gurbani.css, gurbani.js)
│ └── buddhism/ # Tripitaka reader (tripitaka.html, tripitaka.css, tripitaka.js)
├── assets/
│ ├── images/ # Images and screenshots
│ └── icons/ # Custom SVG icons
└── data/ # Offline fallback data
HoliBooks supports all modern browsers:
| Browser | Version | Support |
|---|---|---|
| Chrome | 90+ | ✅ Full Support |
| Firefox | 88+ | ✅ Full Support |
| Safari | 14+ | ✅ Full Support |
| Edge | 90+ | ✅ Full Support |
| Opera | 76+ | ✅ Full Support |
| Samsung Internet | 15+ | ✅ Full Support |
Note: Internet Explorer is not supported.
We welcome contributions from the community! Here's how you can help:
- Fork the repository
- Create a feature branch
git checkout -b feature/amazing-feature
- Make your changes
- Commit your changes
git commit -m "Add amazing feature" - Push to your fork
git push origin feature/amazing-feature
- Open a Pull Request
- Follow the existing code style
- Write clear commit messages
- Test your changes across browsers
- Update documentation if needed
- Be respectful and inclusive
- 🌍 Translations - Help translate the UI into more languages
- 🎨 Design - Improve UI/UX with new ideas
- 🐛 Bug Fixes - Report and fix issues
- ✨ Features - Suggest and implement new features
- 📖 Documentation - Improve docs and guides
This project is licensed under the MIT License - see the LICENSE file for details.
MIT License
Copyright (c) 2026 HoliBooks Contributors
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
HoliBooks would not be possible without the following amazing resources and contributors:
- AlQuran Cloud - For comprehensive Quran data and audio
- Bible API - For extensive Bible translations
- Vedic Scriptures - For Bhagavad Gita content
- GurbaniNow - For Guru Granth Sahib data
- Google Fonts - Beautiful typography (Amiri, Inter, Noto Sans)
- Vercel - Hosting and deployment platform
- All contributors who have helped improve HoliBooks
- The open source community for inspiration and support
- Users around the world who use HoliBooks for their spiritual practice
- Religious scholars who have preserved and translated these sacred texts
