https://github.com/medyas/flutter_qiblah

Flutter Qiblah is a plugin that allows you to display Qiblah direction in you app with support for both Android and iOS.
https://github.com/medyas/flutter_qiblah

android compass flutter ios plugin qibla qiblah qiblah-direction sensors

Last synced: 3 months ago
JSON representation

Flutter Qiblah is a plugin that allows you to display Qiblah direction in you app with support for both Android and iOS.

• Host: GitHub
• URL: https://github.com/medyas/flutter_qiblah
• Owner: medyas
• License: mit
• Created: 2020-02-21T19:26:48.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2024-03-28T12:38:31.000Z (7 months ago)
• Last Synced: 2024-06-24T01:02:01.132Z (4 months ago)
• Topics: android, compass, flutter, ios, plugin, qibla, qiblah, qiblah-direction, sensors
• Language: Dart
• Homepage: https://pub.dev/packages/flutter_qiblah
• Size: 6.34 MB
• Stars: 127
• Watchers: 2
• Forks: 91
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

• Awesome-Muslims - Flutter Qiblah

README

        
# Flutter Qiblah

[![pub package](https://img.shields.io/pub/v/flutter_qiblah.svg)](https://pub.dev/packages/flutter_qiblah) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)  

## Getting Started

To start using this package, add `flutter_qiblah` dependency to your `pubspec.yaml`

```yaml

dependencies:

  flutter_qiblah: ''

```

> The package not not work on the iOS Simulator. To test on iOS please use a real device. Checkout [#39](https://github.com/medyas/flutter_qiblah/issues/39)

## Features

* Check Device Sensor support (Android)

* Request Location permission

* Check GPS Status (Enabled and permission status)

* Receive Qiblah direction, North direction and Qiblah offset from North

## Screens

Here is the Example app demo:

![Example app Demo](https://drive.google.com/uc?export=view&id=19nhSR_VUFczOIriDC2hHJ_nSzhQY8Mic)

Based on the LocationStatus class, you can add a check to see the current status of the GPS and display an error widget if it's disabled or permission is denied. 

check the :memo: [Example Code](https://github.com/medyas/flutter_qiblah/tree/master/example/)

![GPS Disabled](https://drive.google.com/uc?export=view&id=1vRB_GtFtK9sVCQIJqm3Tslsfy5hxQ6at)

For devices with no sensors, a Map can be displayed with the direction from the current/selected location to Mecca. 

check the :memo: [Example Code](https://github.com/medyas/flutter_qiblah/tree/master/example/)

![Qiblah with maps](https://drive.google.com/uc?export=view&id=1CeLQXEVYOO08EPDyl7ycOUvdRGoxrVjG)

## Issues

Please file any issues, bugs or feature request as an issue on our [GitHub](https://github.com/medyas/flutter_qiblah/issues) page.

## Want to contribute

If you would like to contribute to the plugin (e.g. by improving the documentation, solving a bug or adding a cool new feature), please carefully review our [contribution guide](CONTRIBUTING.md) and send us your [pull request](https://github.com/medyas/flutter_qiblah/pulls).