Flutter Qiblah

Getting Started

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

dependencies:
  flutter_qiblah_plus: '<latest_release>'

The package not not work on the iOS Simulator. To test on iOS please use a real device. Checkout #39

iOS: Swift Package Manager only

This plugin's iOS side ships only as a Swift Package (ios/flutter_qiblah_plus/Package.swift) — there is no .podspec. Your app must have Flutter's Swift Package Manager support enabled (flutter config --enable-swift-package-manager, on by default since Flutter 3.24) for iOS builds to pick it up. Apps with SPM disabled, or on a Flutter version that doesn't support it, will fail to build with this plugin installed.

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

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

GPS Disabled

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

Qiblah with maps

Issues

Please file any issues, bugs or feature request as an issue on our GitHub 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 and send us your pull request.