Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/alexlamper/scripture

Scripture is a Next.js-powered web app that offers a gamified experience to explore Bible teachings through quizzes, a dynamic map, and personalized progress tracking.
https://github.com/alexlamper/scripture

bible bible-study education learning nextjs open-source

Last synced: 9 days ago
JSON representation

Scripture is a Next.js-powered web app that offers a gamified experience to explore Bible teachings through quizzes, a dynamic map, and personalized progress tracking.

Awesome Lists containing this project

README 

        
# 📖 Scripture



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



## About Scripture



I created Scripture as my second 'startup' in the creation of 6 startups in 6 months. Scripture is a web-based platform designed to help users explore and study the Bible interactively. Whether you're a beginner or someone with extensive Bible knowledge, Scripture 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 Quizzes**: Test 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



Scripture 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.

- **Supabase**: Database and authentication managed all by Supabase, 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.

- **RedixUI**: A library for creating responsive design systems with React.

- **NextUI**: A library for creating responsive design systems with Next.js.

- **RelumeIO**: A library used for design templates and components.

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



## 📄 Pages



- **Learn**: The main page featuring the interactive Bible map and daily content suggestions.

- **Chapters**: Explore individual Bible chapters with a breakdown of key verses and themes.

- **Places**: Learn about significant biblical places and their relevance in the Bible.

- **Characters**: Discover key Bible characters, their stories, and their impact.

- **Events**: Explore significant events in the Bible and their teachings.

- **Themes**: Study key Bible themes, including love, salvation, and more.

- **Leaderboard**: Compete with other users and track your progress.

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

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

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



## 🌐 API



Scripture 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



Scripture 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 Scripture 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 Scripture free to use?**  

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



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

A: Scripture 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 **Scripture**! 📖