Skip to content

Commit 05fab34

Browse files
Merge pull request #83 from CompassMB/features
Included additional sections and app dependency updates
2 parents 714bd1c + 1ff8e52 commit 05fab34

File tree

15 files changed

+92
-22
lines changed

15 files changed

+92
-22
lines changed

Featured.md

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
## Featured
2+
3+
Trusted by developers worldwide, **MBCompass** has received significant recognition across the Android and open-source communities:
4+
5+
<p align="center">
6+
<a href="https://www.producthunt.com/products/mbcompass/launches/mbcompass">
7+
<img src="https://github.com/CompassMB/MBCompass-site/blob/main/assets/img/ph_400_140.png?raw=true" alt="Product Hunt" style="margin-right: 10px;" />
8+
</a>
9+
10+
<a href="https://news.ycombinator.com/item?id=44155741">
11+
<img src="https://github.com/CompassMB/MBCompass-site/blob/main/assets/img/ychackernews_400_100.png?raw=true" alt="Hacker News" style="margin-right: 10px;" />
12+
</a>
13+
14+
<a href="https://x.com/MubarakNative/status/1944745544905285893">
15+
<img src="https://github.com/CompassMB/MBCompass-site/blob/main/assets/img/android-weekly_400_100.png?raw=true" style="margin-right: 10px;" alt="Android Weekly" />
16+
</a>
17+
</p>
18+
19+
20+
<p align="center">
21+
22+
- Ranked **#13 Product of the Day** on [Product Hunt](https://www.producthunt.com/products/mbcompass) with #1
23+
- Topped the <strong>#1 trending post</strong> in <a href="https://www.linkedin.com/feed/update/urn:li:activity:7359285672341315585/">Product Hunt Forums</a><br>
24+
- Made it to the **front page of [Hacker News](https://news.ycombinator.com/item?id=44155741)**
25+
- Featured in **two consecutive issues** of [Android Weekly](https://x.com/MubarakNative/status/1944745544905285893)
26+
- and featured on many [indie-communies]("https://www.google.com/search?q=MBCompass").
27+
</p>
28+

README.md

Lines changed: 36 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -35,9 +35,6 @@
3535
</h4>
3636

3737
<div align="center" style="display: flex; justify-content: center; align-items: flex-start; gap: 12px; flex-wrap: wrap;">
38-
<a href="https://www.producthunt.com/products/mbcompass?embed=true..." target="_blank">
39-
<img src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=980786&theme=dark&t=1750390503058" width="250" height="54" alt="MBCompass on Product Hunt" />
40-
</a>
4138
<a href="https://f-droid.org/app/com.mubarak.mbcompass">
4239
<img src="https://fdroid.gitlab.io/artwork/badge/get-it-on.png" width="170" alt="Get it on F-Droid"/>
4340
</a>
@@ -48,10 +45,11 @@
4845

4946
## About
5047

51-
MBCompass is a simple yet feature-rich compass app for Android, built with Jetpack Compose. It uses the device’s magnetometer and accelerometer to provide real-time geomagnetic field updates. Designed with Android Lifecycle in mind, In general, a **modern and efficient compass**.
48+
**MBCompass** is a modern, free, and open-source compass and navigation app without **ads**, **IAP**, or **tracking**. Built with **Jetpack Compose**, it supports compass and navigation features while being **lightweight** and simple.
5249

53-
> Most compass apps are either too basic or bloated with ads.
54-
> **MBCompass** was created to fix that: lightweight, accurate, and ad-free.
50+
> Not just a compass. Not a map app.
51+
>
52+
> MBCompass bridges the gap between a **compass** and a **full navigation app** - shows direction and live location without using hundreds of MBs of storage or privacy trade-offs.
5553
5654
---
5755

@@ -65,22 +63,31 @@ MBCompass is a simple yet feature-rich compass app for Android, built with Jetpa
6563
<img width="250" src="fastlane/metadata/android/en-US/images/phoneScreenshots/3.png" />
6664
<img width="250" src="fastlane/metadata/android/en-US/images/phoneScreenshots/4.png" />
6765
</p>
68-
<p align="center">
69-
<img width="250" src="fastlane/metadata/android/en-US/images/phoneScreenshots/5.png" />
70-
<img width="250" src="fastlane/metadata/android/en-US/images/phoneScreenshots/6.png" />
71-
</p>
7266

7367
## Features ✨
7468

75-
- Magnetic north-based [azimuths](https://en.wikipedia.org/wiki/Azimuth).
76-
- Ability to show the user's current location using [OpenStreetMap](https://openstreetmap.org).
77-
- Light / Dark Theme support.
78-
- Display Magnetic Strength in µT.
79-
- Keep the screen on support.
69+
- Shows clear cardinal direction and magnetic azimuths.
70+
- Displays magnetic strength in µT.
71+
- Live GPS location tracking on OpenStreetMap.
72+
- Sensor fusion for improved accuracy (accelerometer, magnetometer, gyroscope).
73+
- Light and dark theme support controlled via Settings.
74+
- Keeps screen on during navigation.
8075
- Landscape orientation support.
81-
- Smooth compass rotation.
82-
- Sensor fusion: Combines (Accelerometer, Magnetometer, and Gyroscope) for better accuracy.
83-
- No annoying ads or in-app purchases.
76+
- Built with Jetpack Compose and Material Design.
77+
- Runs on Android 5.0+
78+
- No ads, no in-app purchases, no tracking.
79+
- [Find more on the website](https://compassmb.github.io/MBCompass-site/#features)
80+
81+
## Recognition 🌟
82+
83+
MBCompass has gained recognition from the global developer community:
84+
85+
- #13 Product of the Day on Product Hunt
86+
- Featured in two consecutive issues of Android Weekly
87+
- Reached the front page of Hacker News
88+
89+
[See full highlights](./Featured.md)
90+
8491

8592
## Permissions 🔐
8693

@@ -90,6 +97,17 @@ MBCompass is a simple yet feature-rich compass app for Android, built with Jetpa
9097

9198
Contributions are welcome! If you encounter bugs or have feature suggestions, please open an issue or submit a pull request. See [Contributing Guidelines](CONTRIBUTING.md) for details.
9299

100+
## Support 💖
101+
102+
Open-source projects couldn't survive in the long run without donations or funding.
103+
104+
MBCompass is a fully open-source project - free of ads, trackers, or in-app purchases.
105+
If you find it useful, consider supporting its continued development and maintenance:
106+
107+
Find more info on [MBCompass page](https://compassmb.github.io/MBCompass-site/donate.html)
108+
109+
Your support helps ensure the project stays sustainable and continues to improve for everyone. Thank you!
110+
93111
## License 📄
94112

95113
[![GNU GPLv3 Image](https://www.gnu.org/graphics/gplv3-127x51.png)](http://www.gnu.org/licenses/gpl-3.0.en.html)

app/src/main/java/com/mubarak/mbcompass/ui/settings/SettingsScreen.kt

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -67,6 +67,7 @@ import com.mubarak.mbcompass.ui.theme.spacingSmall
6767
import com.mubarak.mbcompass.utils.Const.APP_PAGE
6868
import com.mubarak.mbcompass.utils.Const.AUTHOR_EMAIL
6969
import com.mubarak.mbcompass.utils.Const.LICENSE_PAGE
70+
import com.mubarak.mbcompass.utils.Const.SUPPORT_PAGE
7071
import com.mubarak.mbcompass.utils.ThemeConfig
7172

7273
@Composable
@@ -92,6 +93,9 @@ fun SettingsScreen(
9293
onLicensesClicked = {
9394
uriHandler.openUri(LICENSE_PAGE)
9495
},
96+
onSupportClicked = {
97+
uriHandler.openUri(SUPPORT_PAGE)
98+
},
9599
onSourceClicked = {
96100
uriHandler.openUri(APP_PAGE)
97101
}
@@ -105,6 +109,7 @@ fun SettingsScreen(
105109
onBackClicked: () -> Unit,
106110
onThemeOptionClicked: (String) -> Unit,
107111
onAuthorPageClicked: () -> Unit,
112+
onSupportClicked: () -> Unit,
108113
onLicensesClicked: () -> Unit,
109114
onSourceClicked: () -> Unit
110115
) {
@@ -132,6 +137,7 @@ fun SettingsScreen(
132137
onThemeItemClicked = { isThemeDialogVisible = true },
133138
onLicensesClicked = onLicensesClicked,
134139
onAuthorPageClicked = onAuthorPageClicked,
140+
onSupportClicked = onSupportClicked,
135141
onSourceClicked = onSourceClicked
136142
)
137143
ThemeDialog(
@@ -151,6 +157,7 @@ private fun SettingsList(
151157
onThemeItemClicked: () -> Unit,
152158
onAuthorPageClicked: () -> Unit = {},
153159
onLicensesClicked: () -> Unit = {},
160+
onSupportClicked: () -> Unit = {},
154161
onSourceClicked: () -> Unit = {},
155162
) {
156163
Box(
@@ -202,6 +209,14 @@ private fun SettingsList(
202209
onClick = onLicensesClicked,
203210
)
204211
}
212+
item(key = "__supportItem") {
213+
SettingsItem(
214+
title = stringResource(R.string.support),
215+
icon = R.drawable.icon_support_24,
216+
subtitle = stringResource(R.string.donate),
217+
onClick = onSupportClicked,
218+
)
219+
}
205220
item(key = "__sourcecodeItem") {
206221
SettingsItem(
207222
title = stringResource(R.string.source_code),
@@ -353,6 +368,7 @@ fun SettingsScreenPreview() {
353368
onBackClicked = {},
354369
onThemeOptionClicked = {},
355370
onLicensesClicked = {},
371+
onSupportClicked = {},
356372
onAuthorPageClicked = {},
357373
onSourceClicked = {}
358374
)
Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,8 @@
11
package com.mubarak.mbcompass.utils
22

33
object Const {
4-
const val APP_PAGE = "https://github.com/MubarakNative/MBCompass"
4+
const val APP_PAGE = "https://github.com/CompassMB/MBCompass"
55
const val LICENSE_PAGE = "https://www.gnu.org/licenses/gpl-3.0.txt"
6+
const val SUPPORT_PAGE = "https://compassmb.github.io/MBCompass-site/donate.html"
67
const val AUTHOR_EMAIL = "dev.mubarakbasha@gmail.com"
78
}
Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
<vector xmlns:android="http://schemas.android.com/apk/res/android" android:height="24dp" android:tint="#000000" android:viewportHeight="960" android:viewportWidth="960" android:width="24dp">
2+
3+
<path android:fillColor="@android:color/white" android:pathData="M640,520L474,358Q443,328 421.5,291.5Q400,255 400,212Q400,157 438.5,118.5Q477,80 532,80Q564,80 592,93.5Q620,107 640,130Q660,107 688,93.5Q716,80 748,80Q803,80 841.5,118.5Q880,157 880,212Q880,255 859,291.5Q838,328 807,358L640,520ZM640,408L749,301Q768,282 784,260.5Q800,239 800,212Q800,190 785,175Q770,160 748,160Q734,160 721.5,165.5Q709,171 700,182L640,254L580,182Q571,171 558.5,165.5Q546,160 532,160Q510,160 495,175Q480,190 480,212Q480,239 496,260.5Q512,282 531,301L640,408ZM280,740L558,816L796,742Q791,733 781.5,726.5Q772,720 760,720L558,720Q531,720 515,718Q499,716 482,710L389,679L411,601L492,628Q509,633 532,636Q555,639 600,640L600,640Q600,640 600,640Q600,640 600,640Q600,629 593.5,619Q587,609 578,606L344,520Q344,520 344,520Q344,520 344,520L280,520L280,740ZM40,880L40,440L344,440Q351,440 358,441.5Q365,443 371,445L606,532Q639,544 659.5,574Q680,604 680,640L760,640Q810,640 845,673Q880,706 880,760L880,800L560,900L280,822L280,822L280,880L40,880ZM120,800L200,800L200,520L120,520L120,800ZM640,254L640,254Q640,254 640,254Q640,254 640,254Q640,254 640,254Q640,254 640,254Q640,254 640,254Q640,254 640,254L640,254L640,254Q640,254 640,254Q640,254 640,254Q640,254 640,254Q640,254 640,254Q640,254 640,254Q640,254 640,254Z"/>
4+
5+
</vector>

app/src/main/res/values/strings.xml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -44,4 +44,6 @@
4444
<string name="developer">Mubarak Basha</string>
4545
<string name="source_code">Source code</string>
4646
<string name="github">GitHub</string>
47+
<string name="support">Support Us</string>
48+
<string name="donate">Donate to keep this app free and ad-free</string>
4749
</resources>
2.56 KB
Loading
1.13 MB
Loading
-101 KB
Loading
-950 KB
Loading

0 commit comments

Comments
 (0)