https://github.com/gersonrocha9/kerygmaai
A mobile app that uses artificial intelligence to generate personalized devotionals based on user-selected themes.
https://github.com/gersonrocha9/kerygmaai
expo react-native
Last synced: 3 months ago
JSON representation
A mobile app that uses artificial intelligence to generate personalized devotionals based on user-selected themes.
- Host: GitHub
- URL: https://github.com/gersonrocha9/kerygmaai
- Owner: GersonRocha9
- Created: 2025-03-05T00:12:22.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-03-10T00:04:30.000Z (3 months ago)
- Last Synced: 2025-03-10T00:25:53.722Z (3 months ago)
- Topics: expo, react-native
- Language: TypeScript
- Homepage:
- Size: 2.17 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# KerygmaAI
A mobile application that uses artificial intelligence to generate personalized devotionals based on themes chosen by the user.
## đČ Download the App
## đ Meaning of the Name
**KerygmaAI** combines two powerful concepts:
- **Kerygma** (ÎșÎźÏÏ
ÎłÎŒÎ±): Greek word meaning "proclamation" or "announcement," often used to refer to the proclamation of the Gospel in Christianity. It is the act of announcing the Christian message in a clear and accessible way.
- **AI** (Artificial Intelligence): Represents the artificial intelligence technology that enables the generation of personalized content.
The name symbolizes the application's mission: to use modern technology (AI) to assist in the proclamation and reflection on Christian teachings, making them more accessible and personalized for users' daily lives.
## đ± Screenshots
## đĄ About the Project
KerygmaAI is an application developed to help people have personalized spiritual reflection moments. The user can choose a topic of interest and the application automatically generates a complete devotional, including:
- Related Bible verse
- Introduction to the theme
- Detailed study topics
- Conclusion
- Final prayer
Generated devotionals are automatically saved in the user's history for later reference and can be shared with friends and family.
## đ Technologies Used
- **React Native** - Mobile development framework
- **Expo** - Platform for React Native development
- **TypeScript** - Strongly typed language based on JavaScript
- **React Hook Form** - Form management
- **Zod** - Form validation
- **OpenAI API** - AI content generation
- **Async Storage** - Local data storage
- **Expo Vector Icons** - Consistent icons across platforms
- **Expo Router** - Navigation between screens
## âš Features
- Generation of personalized devotionals with AI
- Friendly and intuitive interface
- History of consulted devotionals
- Sharing devotionals via messaging apps
- Support for light and dark themes
- Interface adapted for iOS and Android
## đ ïž Installation and Usage
1. Clone the repository:
```bash
git clone https://github.com/GersonRocha9/kerygma-ai.git
cd kerygma-ai
```
2. Install dependencies:
```bash
npm install
```
3. Create a `.env` file with the necessary environment variables:
```
EXPO_PUBLIC_OPENAI_API_KEY=your_api_key_here
```
4. Run the project:
```bash
npx expo start
```
## đ Important Notes
- The AI-generated content serves as a complement to spiritual reflection, it does not replace direct Bible reading or pastoral guidance.
- An OpenAI API key is required for the full functionality of the application.
## đ€ Contributing
Contributions are welcome! Feel free to open an issue or submit a pull request.
## đ License
This project is licensed under the MIT license - see the LICENSE file for details.
---
Developed with đ and â