https://github.com/andrejkoller/bibleversion
✝️📖 Multilingual Bible reading application that features multiple translations, customizable themes, adjustable font sizes, and a clean, responsive interface for studying scripture.
https://github.com/andrejkoller/bibleversion
css html javascript mui react
Last synced: 19 days ago
JSON representation
✝️📖 Multilingual Bible reading application that features multiple translations, customizable themes, adjustable font sizes, and a clean, responsive interface for studying scripture.
- Host: GitHub
- URL: https://github.com/andrejkoller/bibleversion
- Owner: andrejkoller
- License: mit
- Created: 2025-03-21T19:19:44.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2026-05-29T13:10:00.000Z (21 days ago)
- Last Synced: 2026-05-29T15:07:01.486Z (20 days ago)
- Topics: css, html, javascript, mui, react
- Language: JavaScript
- Homepage: https://bibleversion.vercel.app
- Size: 3.15 MB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
# bibleversion
A modern, responsive Bible reading application built with React that provides access to multiple Bible translations in various languages. Designed for an enhanced scripture study and reading experience.
## Features
- **Multiple Translations** - Access various Bible translations across different languages
- **Language Support** - Read scripture in your preferred language
- **Theme Switcher** - Toggle between dark and light mode with `localStorage` persistence
- **Adjustable Font Size** - Customize the reading font size from 10pt to 30pt
- **Persistent Reading Position** - Saves your last selected book and chapter via `localStorage`
- **Smooth Navigation** - Browse books and chapters with animated transitions and prev/next controls
- **Responsive Design** - Mobile-first layout optimized for all screen sizes
- **Modular Architecture** - Custom hooks, contexts, and separated page components
## Tech Stack
- **Framework**: [Create React App](https://create-react-app.dev)
- **Library**: React 19
- **Routing**: React Router 7
- **UI Components**: Material UI 7
- **API**: [Scripture API (api.bible)](https://scripture.api.bible)
## Prerequisites
- Node.js 14.x or higher
- npm or yarn
## Installation
1. Clone the repository
```bash
git clone https://github.com/andrejkoller/bibleversion.git
cd bibleversion
```
2. Install dependencies
```bash
npm install
```
3. Create a `.env.local` file in the root directory and add your Scripture API credentials
```env
REACT_APP_BASE_URL="/api/v1"
REACT_APP_API_KEY="your-api-key-here"
```
4. Run the development server
```bash
npm start
```
Open [http://localhost:3000](http://localhost:3000) in your browser.
## API Key
This application uses the [Scripture API](https://scripture.api.bible/). To get your free API key:
1. Visit [https://scripture.api.bible/](https://scripture.api.bible/)
2. Sign up for a free account
3. Generate your API key
4. Add it to your `.env.local` file
## Project Structure
```
bibleversion/
├── public/
│ ├── index.html
│ ├── fonts/
│ ├── icons/
│ └── images/
├── src/
│ ├── components/
│ │ ├── footer/
│ │ ├── header/
│ │ └── pages/
│ │ ├── about/
│ │ ├── bible/
│ │ │ ├── chapter/
│ │ │ └── translations/
│ │ ├── developers/
│ │ ├── help/
│ │ ├── home/
│ │ ├── more/
│ │ ├── search/
│ │ ├── settings/
│ │ │ ├── font-size/
│ │ │ ├── language/
│ │ │ └── theme/
│ │ └── translation-language/
│ ├── configs/ # Navigation and settings configuration
│ ├── contexts/ # React context providers
│ ├── hooks/ # Custom React hooks
│ ├── lib/utils/ # Utility functions
│ ├── services/
│ │ └── bible-service.js # Scripture API integration
│ ├── App.js
│ └── index.js
├── .env.local # Local environment variables
├── .env.production # Production environment variables
├── package.json
├── LICENSE
└── SECURITY.md
```
## Screenshots
## License
This project is licensed under the [MIT License](LICENSE).