Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/alexlamper/scriptura


https://github.com/alexlamper/scriptura

Last synced: 14 days ago
JSON representation

Awesome Lists containing this project

README 

        
# 📖 Scriptura



Thanks for checking out **Scriptura** – Your Interactive Bible Learning Platform.



## About Scriptura



I created Scriptura because I wanted a good solution for learning more about the bible. Scriptura is a web-based learning platform designed to help users explore and study the Bible interactively. Whether you're a beginner or someone with extensive Bible knowledge, Scriptura provides personalized tools, quizzes, and learning resources to enhance your journey.



## 📜 Table of Contents



1. [Features](#features)

2. [Tech Stack](#tech-stack)

3. [Pages](#pages)

4. [API](#api)

5. [Contributing](#contributing)

6. [Support](#support)

7. [License](#license)

8. [Version](#version)

9. [FAQ](#faq)

10. [Contact](#contact)



## 🌟 Features



- **Personalized Learning**: Track your progress with personalized suggestions and daily Bible reading prompts.

- **Bible Courses**: Learn more about your knowledge of Bible characters, events, places, and teachings with fun, interactive quizzes.

- **Progress Tracking**: Keep track of your learning milestones, quizzes, and daily Bible engagement.

- **Interactive Bible Map**: Explore key locations from the Bible with an interactive map, helping you learn about historical places, events, and people.

- **Leaderboards**: Compete with other users in quizzes and progress tracking.

- **Community Insights**: Engage with the community by sharing insights, notes, and learning experiences.

- **Daily Verses and Teachings**: Access daily Bible verses and thematic teachings to reflect upon.

- **Adding Notes**: Add, edit and remove any notes you want so you don't forget what you've learned.



## 💻 Tech Stack



Scriptura uses modern technologies to provide an optimal performance and user experience:



- **Next.js (TypeScript)**: Primary framework for building the app, supporting server-side rendering and static site generation.

- **MongoDB**: Database managed all by MongoDB Atlas, fast and easy to use.

- **Vercel**: Hosting and deployment platform optimized for Next.js applications.

- **TailwindCSS**: Utility-first CSS framework for rapid, consistent styling.

- **Bible API**: Fetch Bible verses and related information to provide an enriched learning experience.

- **ShadCN**: UI styling library for modular and accessible components, ensuring a cohesive design.

- **React-Icons**: Extensive icon library to improve visual consistency in the UI.

- **FramerMotion**: A library used for animations and transitions.

- **NextAuth**: For simple and quick to use authentication.

- **Stripe**: For handling payment and processing transactions.



## 📄 Pages



- **Dashboard**: The main page featuring the courses, daily suggestions, lessons and more...

- **Courses**: Explore courses to learn more about the bible.

- **Profile**: Customize your profile, view achievements, and track your learning journey.

- **Resources**: Discover various bible versions, commentaries and study tools.

- **Community**: Discuss biblical topics, join study groups and start conversations.

- **Settings**: Manage your account settings and preferences.

- **Help/FAQ**: Access FAQs and resources for support.



## 🌐 API



Scriptura uses the **Bible API** for fetching Bible verses and related content, providing an enriched and up-to-date learning experience. For more information on available data, check out the [Bible API Source](https://rapidapi.com/ajith/api/holy-bible).



## 🤝 Contributing



Scriptura is an open-source project and contributions are welcome! Here's how you can contribute:



1. **Fork the repository** and create a new branch.

2. **Make your changes** and add descriptive commit messages.

3. **Submit a pull request** detailing your improvements or fixes.



Every contribution helps make BibleMap better for everyone! 🎉



## ❤️ Support



If you’d like to support the project, sharing Scriptura with others or contributing to the development is greatly appreciated!



## 📄 License



This project is licensed under the [MIT License](LICENSE), allowing for reuse and modification with attribution.



## 📌 Version



Current Version: **v1.0**



## ❓ FAQ



**Q: Is Scriptura free to use?**  

A: Yes! Scriptura is free for everyone. Premium features may be added in the future.



**Q: What Bible translations are supported?**  

A: Scriptura currently supports the multiple bible version such as the King James Bible, with plans to expand to other translations in the future.



**Q: How do I report a bug or suggest a feature?**  

A: Please open an issue on our GitHub repository with details of your suggestion or bug report.



## 📬 Contact



Got questions, feedback, or just want to say hi? Reach out at [[email protected]](mailto:[email protected]).



Thanks for checking out **Scriptura**! 📖