mirror of
https://github.com/kennethreitz/kjvstudy.org.git
synced 2026-06-05 23:00:16 +00:00
kennethreitz
4f2e698f2b
Visual Improvements: - Added border, background, and subtle shadow to sidebar - Increased width from 160px to 200px for better readability - Added icons to navigation items (🏠📖✨🎲📅🏷️🔍) - Organized resources into logical groups: People, Theology, History & Culture, Study Tools - Better spacing and typography New Functionality: - Sidebar search box with live filtering of links - Recently viewed pages tracking (localStorage, max 5 items) - Search on Enter key press redirects to full search - Auto-tracking of page views (excludes home and search pages) Mobile Responsiveness: - Sidebar slides in from left on mobile (280px width) - Full-height overlay behavior on tablets/mobile - Larger toggle button (36px) with better shadows - Toggle button now says "Sidebar" when collapsed, "×" when expanded - Smooth transitions and proper z-indexing All features use localStorage for persistence across sessions. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
KJV Study
A web application for studying the King James Bible with AI-powered commentary and insights.
Features
- Browse and search King James Bible verses
- Study Guides - Comprehensive Bible study guides covering foundational Christian truths, character development, and biblical themes
- Verse of the Day - Daily Scripture verses with reflection questions and sharing capabilities
- AI-powered biblical commentary and insights
- Clean, responsive web interface
- Fast verse lookup and navigation
Installation
- Clone the repository
- Install dependencies:
uv sync
Usage
Run the development server:
uv run kjvstudy-org
The application will be available at http://localhost:8000
Docker
Build and run with Docker:
docker build -t kjvstudy .
docker run -p 8000:8000 kjvstudy
Requirements
- Python 3.13+
- FastAPI
- biblepy
License
See LICENSE file for details.
=======
New Features
Study Guides
Access comprehensive Bible study guides at /study-guides covering:
- Foundational Studies: New Believer's Guide, Salvation by Grace, The Gospel Message
- Character & Living: Fruits of the Spirit, Prayer & Faith, Christian Living
- Biblical Themes: God's Love, Hope & Comfort, Wisdom & Guidance
Each study guide includes:
- Scripture references with full text
- Study notes and practical applications
- Reflection questions for deeper understanding
Verse of the Day
Visit /verse-of-the-day for:
- Daily Scripture verses from a curated collection
- Reflection questions for meditation
- Easy sharing capabilities
- Links to read the full chapter or book
- Integrated with the homepage for daily inspiration
Docker
Build and run with Docker:
docker build -t kjvstudy .
docker run -p 8000:8000 kjvstudy
Requirements
- Python 3.13+
- FastAPI
- biblepy
License
<<<<<<< HEAD
Typography and Reading Experience
- Serif fonts for Scripture text to enhance readability
- Optimal line spacing and margins for extended reading
- Responsive text sizing that adapts to screen size and user preferences
- High contrast for accessibility and eye comfort
User Interface
- Minimalist design that keeps focus on the text
- Intuitive navigation that doesn't distract from study
- Progressive disclosure of features to avoid overwhelming new users
- Consistent visual hierarchy throughout the application
Performance
- Fast loading times for immediate access to Scripture
- Efficient caching of frequently accessed content
- Progressive enhancement for users with slower connections
- Offline capability for core reading features (planned)
🔮 Future Enhancements
Content Expansion
- Multiple Bible translations and versions
- Original language tools (Hebrew, Greek)
- Historical Bible versions and manuscripts
- Integration with Bible atlases and timelines
Study Tools
- Note-taking and highlighting system
- Bible reading plans and tracking
- Prayer journal integration
- Scripture memorization tools
AI-Powered Features
- Automatic sermon generation from passages
- Bible study curriculum creation
- Personalized devotional content
- Intelligent study group matching
Community Features
- User profiles and study progress tracking
- Discussion forums for passage exploration
- Expert commentary from biblical scholars
- Live streaming of Bible studies and sermons
🤝 Contributing
We welcome contributions from developers, theologians, and Bible enthusiasts! Here's how you can help:
For Developers
- Frontend improvements and responsive design
- Backend optimization and new features
- AI integration and commentary generation
- Testing and quality assurance
For Biblical Scholars
- Content review and theological accuracy
- Historical and cultural context insights
- Cross-reference suggestions and verification
- Study question and outline creation
For Users
- Bug reports and feature requests
- User experience feedback
- Beta testing of new features
- Community building and engagement
📄 License
This project is open source and available under the ISC License.
🙏 Acknowledgments
- King James Bible (1769): The foundational text that makes this project possible
- FastAPI Community: For the excellent web framework
- Open Source Community: For the tools and libraries that power this application
- Biblical Scholars: Whose centuries of study inform our AI commentary approach
📞 Contact
For questions, suggestions, or collaboration opportunities:
- Create an issue on GitHub
- Join our community discussions
- Follow development updates
"Study to shew thyself approved unto God, a workman that needeth not to be ashamed, rightly dividing the word of truth." - 2 Timothy 2:15 (KJV)
See LICENSE file for details.