libre-study/README.md

Libre Study

Libre Study is the application workspace for a free, open-source Bible study program. It consumes public LibreBible resource packages from the sibling W:\libre-bible-data repo and owns user workspace data such as sessions, notes, settings, timelines, imports, and exports.

The current development loop is HotView through Vite:

npm install
npm run dev

From Tailscale/local intranet machines, the active HotView target is:

http://desktop:5174/

During active product shaping, HotView is the lead workflow. Do not run web builds, local builds, installer builds, or hosted deployments unless a release/deploy pass is explicitly requested.

Current Shape

• React, TypeScript, and Vite browser app.
• Tauri 2 desktop adapter and Rust/SQLite lane exist but are not the lead workflow.
• Hosted web adapter exists for private login/workspace persistence but is parked until deployment is explicitly resumed.
• Browser data loads from W:\libre-bible-data\packages\json.
• Current translations include ASV, KJV, and NET where available in the LibreBible catalog.
• Study resources include Strong's links and definitions, translation/study notes, Matthew Henry Concise commentary, Easton/Smith dictionary entries, contextual maps/routes, and KJV audio metadata.
• User workspace features include sessions, timeline, verse-anchored margin notes, notebook clipping, JSON import/export, Markdown/HTML/CSV export, and optional one-way Nextcloud WebDAV export.

Project References

• Roadmap: ROADMAP.md
• Product tracks: docs/product-tracks.md
• Architecture boundaries: docs/app-architecture-boundaries.md
• Current project state: docs/project-state-2026-07-15.md
• Changelog: CHANGELOG.md