qibla-dart/.github/wiki/Home.md
Aric Camarata cc3c227d2d
feat: surface-area parity audit vs qibla-js (v1.0.1) (#1)
* chore: surface-area parity audit vs qibla-js, bump to v1.0.1

Full gap analysis: qibla-dart already matches @acamarata/qibla on all five
public functions (qiblaAngle, compassDir, compassName, qiblaGreatCircle,
distanceKm) and three constants (kaabaLat, kaabaLng, earthRadiusKm).
No runtime gaps found; 48/48 tests pass unchanged.

Patch bump documents the audit and closes T-E10-01 (Mega Phase 1).

* docs: add CHANGELOG.md for v1.0.1 release

* chore: polish pubspec, add wiki docs
2026-05-29 06:49:15 -04:00

832 B

qibla

Qibla direction, great-circle path, and haversine distance for Dart and Flutter. Computes the bearing to the Ka'bah from any point on Earth. Pure math, zero dependencies.

Install

dependencies:
  qibla: ^1.0.1
import 'package:qibla/qibla.dart';

final bearing = qiblaAngle(40.7128, -74.006);
print(bearing);               // ~58.48
print(compassDir(bearing));   // NE

final km = distanceKm(40.7128, -74.006, kaabaLat, kaabaLng);
print(km);  // ~9634

Contents