TilawahApp-project (In Development)

Welcome to the Tilawah App! This app is designed to be a helpful tool for Muslims in their daily lives, providing convenient access to essential resources. Currently, the app features:

• Quran: A digital version of the Holy Quran for reading and reflection. in development
• Prayer Times: Accurate daily prayer times based on your location, fetched from a reliable API. in development

Please note: This app is currently in active development. We are continuously working to improve the app, add new features, and enhance the user experience. As such, you may encounter bugs or incomplete functionality. We appreciate your patience and understanding as we work towards a stable release.

We welcome your feedback! Please feel free to share any suggestions, bug reports, or feature requests. Your input is valuable in helping us create a better app for the Muslim community.

Building and Running the App (For Developers - Expo):

Because this project uses Expo, the setup and running process is simplified.

1. Clone the repository: git clone https://github.com/Abdulrahman-Alanazi1/TilawahApp-project.git
2. Navigate to the project directory: cd TilawahApp
3. Install dependencies: npm install or yarn install

   npm install @react-navigation/drawer @react-navigation/material-top-tabs @shopify/flash-list axios expo ~52.0.35 expo-constants ~17.0.3 expo-font ~13.0.1 expo-linking ~7.0.5 expo-navigation-bar ~4.0.8 expo-router ~4.0.17 expo-splash-screen ~0.29.22 expo-status-bar ~2.0.1 moment-hijri ^3.0.0 react 18.3.1 react-native 0.76.7 react-native-gesture-handler ~2.20.2 react-native-pager-view 6.5.1 react-native-reanimated ~3.16.1 react-native-safe-area-context 4.12.0 react-native-screens ~4.4.0 react-native-svg 15.8.0

4. Start the Expo development server: expo start or npx expo start or yarn start

Contributing

We welcome contributions to the Tilawah App! If you're interested in helping us improve the app, please follow these guidelines:

1. Fork the repository: Create your own copy of the repository by forking it.
2. Create a branch: Create a new branch for your changes: git checkout -b feature/your-feature-name or git checkout -b fix/your-bug-fix.
3. Make your changes: Implement your feature or bug fix.
4. Test your changes: Ensure your changes work as expected.
5. Commit your changes: Commit your changes with clear and concise commit messages.
6. Push your changes: Push your branch to your forked repository: git push origin feature/your-feature-name.
7. Submit a pull request: Create a pull request to the main branch of the original repository.

P.C. : If you want to collaborate with me in this project, please contact through Github, LinkedIn, or X.

Guidelines:

• Please follow the existing code style.
• Write clear and concise commit messages.
• If you're adding a new feature, please include relevant tests.
• If you're fixing a bug, please provide steps to reproduce the bug.
• Discuss major changes in an issue before submitting a pull request.
• When contributing to the UI, please keep a clean and consistent design.

Reporting Issues:

If you find a bug or have a feature request, please create an issue on GitHub. When reporting a bug, please provide as much information as possible, including:

• Steps to reproduce the bug.
• Expected behavior.
• Actual behavior.
• Your operating system and device.

Photos

The Home Page

Code of Conduct:

Please note that this project has a Code of Conduct. By participating in this project, you agree to abide by its terms.

We appreciate your contributions and look forward to working with you!