Access the app here: https://provinent.org

Provinent Scripture Study

A powerful, feature-rich web application for in-depth Bible study, designed to facilitate meaningful engagement with Scripture through modern digital tools. The name "Provinent" combines "providence" and "covenant", two profound theological concepts representing God's sovereign care and eternal promises. This project was developed with assistance from AI tools including Gab AI and Lumo.

Features

Core Functionality

• Multi-Translation Support: ASV, BSB, GNV, KJV, NET
• Study Notes: Full Markdown support with preview, hotkeys, and export capabilities
• Verse Analysis: Left-click any verse for analysis of a single verse with a side-by-side view of Strong's concordance (provided by STEP Bible) and a Hebrew or Greek interlinear Bible (provided by Bible Hub)
• Verse Highlighting: Right-click verses to highlight in one of six colors for study emphasis
• Reference Bible: Use the reference Bible to select from multiple translation options to compare with (ASV, BSB, CSB, ESV, GNV, KJV, LSB, NASB 1995, NASB 2020, NET, NIV, NKJV, NLT); this also sets the translation for Bible Gateway searches and the Verse Analysis popup
• Search Integration: Built-in Bible Gateway search functionality to search for any word or passage
• Theming: Dark/light mode with six color themes

Advanced Features

• Highlights Management: Search and filter highlighted verses by color/content
• Keyboard Navigation: Extensive keyboard shortcuts (F1 to toggle help)
• Data Portability: Import/export highlights, notes, and settings
• Local Device Syncing: Pair devices on your local network to sync your highlights, notes, and settings using a simple, 8-digit code
• Responsive Design: Optimized for both desktop and mobile devices (mobile has limited features)

Markdown Keyboard Shortcuts

Basic Formatting (Ctrl/Cmd + Key)

Shortcut	Action	Result
Ctrl/Cmd + B	Bold	**bold text**
Ctrl/Cmd + I	Italic	*italic text*
Ctrl/Cmd + K	Link	[link text](url)
Ctrl/Cmd + 1	Heading 1	# Heading 1
Ctrl/Cmd + 2	Heading 2	## Heading 2
Ctrl/Cmd + 3	Heading 3	### Heading 3
Ctrl/Cmd + `	Code	`code`
Ctrl/Cmd + Shift + U	Unordered List	- List item
Ctrl/Cmd + Shift + O	Ordered List	1. List item
Ctrl/Cmd + Shift + >	Blockquote	> Quote

Note: Tested only on Windows (Ctrl) but should also work on Mac (Cmd) environments

Navigation Keyboard Shortcuts

Chapter Navigation

Shortcut	Action
Alt + ←	Previous Chapter
Alt + →	Next Chapter

Book Navigation

Shortcut	Action
Alt + Shift + ↑	Previous Book
Alt + Shift + ↓	Next Book

Other Functions

Shortcut	Action
Alt + B	Toggle Reference Bible
Alt + N	Toggle Notes
Alt + S	Toggle Sidebar
Alt + P	Play/Pause Audio
Alt + R	Random Passage
Alt + E	Export Data
Alt + I	Import Data
Alt + M	Export Notes
Alt + D	Manual Sync (if devices paired)
F1	Show Help Modal

Note: Hotkeys can be customized in the settings menu

Study Resources Integration

The sidebar provides organized access to extensive theological resources (Reformed Theology/Calvinism) including:

• Online Bible platforms
• Christian doctrine references
• Theological resources
• Podcasts and devotionals
• Study tools and commentaries
• Important literary works

Technical Stack

• Frontend: Pure HTML5, CSS3, and Vanilla JavaScript (ES6+)
• Libraries:
  • Font Awesome for icons
  • Marked.js for Markdown processing
  • PeerJS for discovery (local device syncing)
  • Google for STUN servers (local device syncing)
• API: Bible.helloao.org for scripture text, footnotes, and BSB audio
• Storage: LocalStorage for user data persistence
• Build: Use the provided scripts for setup and consistency

Installation

1. Clone or download this repository
2. Serve the files through any web server (no server-side processing required)
3. Open index.html in a web browser

Usage

Basic Navigation

• Navigate with arrow buttons or dropdown menus
• Use “Random Passage” to study from any canon passage of Holy Scripture
• Select a narrator and play audio for any chapter of the Bible in the BSB or KJV translations (KJV only supports one narrator)
• Press F1 to view or change keyboard shortcuts

Browser Support

• Chrome/Chromium 80+ (only tested on these browsers)
• Firefox 75+
• Safari 13+
• Edge 80+

Privacy & Data

No cloud storage: Highlights, notes, and settings are stored locally in your browser and never pass through servers (only signaling for discovery). Device sync is optional.

Data that is transmitted to external servers:

• Bible passage requests are handled by bible.helloao.org
• Bible Hub (interlinear) and STEP Bible (both when using Verse Analysis popup)
• Bible Gateway searches
• Reference Bible websites while the panel is opened
• Resource links opened in external sites via the sidebar
• Third-party libraries:
  • Font Awesome
  • Marked.js
  • PeerJS
  • Google STUN servers

Attribution

• Scripture text provided by AO Lab API
• Berean Standard Bible translation by Berean Bible
• Audio files hosted by Open Bible
• Icons by Font Awesome
• Markdown processing by Marked.js
• Local device syncing by PeerJS
• STUN servers by [Google]("stun.l.google.com" and "stun1.l.google.com")
• Reference Bible websites
  • Bible Gateway
  • Bible.com (YouVersion)
  • Bible Hub
  • STEP Bible
  • eBible.org
• All copyrights, trademarks, and attributions belong to their respective owners

License

This project is licensed under the GNU General Public License v3.0 (GPLv3).

• Freedom to use: Anyone can use this software for any purpose
• Freedom to study: Anyone can examine how it works and modify it
• Freedom to distribute: Anyone can share original or modified versions
• Copyleft: All derivative works must remain under GPLv3, preventing commercial proprietary exploitation

Support

For issues or suggestions, please check the browser console for error messages and ensure you're using a supported browser version.

Romans 11:36

For from Him and through Him and to Him are all things. To Him be the glory forever. Amen.

---

Soli Deo Gloria