Ecosyste.ms: Awesome

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

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: 8 days 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 (3 months ago)
Last Synced: 2024-06-20T22:38:55.590Z (11 days 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

Lists

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