Merge the نون identity into the CI and dependency work

Two lines of work met here. master had gained CI, Dependabot, an
architecture document and a Gradle 9.6.1 wrapper; this branch had replaced
the identity. The conflicts were all in the four files that carry the mark,
and in every one of them master's side was the old bell with a punctuation
pass applied over it. The identity is taken from this branch and the
punctuation convention is carried forward into its new comments, so the
codebase keeps one style.

docs/assets/header-light.svg and header-dark.svg are removed. They drew the
old bell in the old teal, so leaving them would have kept the previous logo
on the most public surface the project has while the app itself no longer
used it. The README goes back to the mark and a heading, which also renders
Arabic with GitHub's own fonts instead of hoping the viewer has an Arabic
face installed.

README stays Arabic-first and short, and keeps what the quality pass added
that has value: the CI and release badges, and a link to ARCHITECTURE.md
rather than an architecture section. Two feature claims were checked against
the source before being written down: the Arabic natural-language entry is
real and wired into the editor, and Hijri is date display only, because the
editor maps any stored Hijri schedule to its nearest Gregorian one.

Re-verified on the upgraded toolchain: 430 tests pass on Gradle 9.6.1, lint
reports zero errors, and debug, release and bundle all build.

Author: Mod578

.gitattributes

@@ -0,0 +1,20 @@
+# Normalise line endings in the repository, check out native on Windows.
+* text=auto
+
+# Scripts and wrappers that must keep LF whatever the platform.
+gradlew text eol=lf
+*.sh text eol=lf
+
+# Windows batch files need CRLF.
+*.bat text eol=crlf
+
+# Binary assets, never diffed or line-ending converted.
+*.jar binary
+*.ttf binary
+*.png binary
+*.apk binary
+*.aab binary
+*.keystore binary
+
+# Fonts are third party, keep them out of the language statistics.
+Rannah/app/src/main/res/font/* linguist-vendored

.github/dependabot.yml

@@ -0,0 +1,43 @@
+version: 2
+updates:
+  # The Gradle build, including the version catalog in gradle/libs.versions.toml.
+  - package-ecosystem: gradle
+    directory: /Rannah
+    schedule:
+      interval: monthly
+    open-pull-requests-limit: 5
+    commit-message:
+      prefix: build
+    # AGP, Kotlin, KSP, Hilt and Room move as one toolchain: the first
+    # Dependabot round proposed AGP 9.3.1, Hilt 2.60.1, Room 2.8.4 and
+    # hilt-androidx 1.4.0, and every one of them failed the build against
+    # AGP 8.7.3 and Kotlin 2.1.0, the Hilt plugin not even applying. Moving
+    # them is a deliberate, coordinated upgrade, not a monthly chore, so only
+    # patch updates arrive automatically for this group. Everything else in
+    # the catalog still gets minor and patch updates.
+    ignore:
+      - dependency-name: com.android.*
+        update-types: [version-update:semver-major, version-update:semver-minor]
+      - dependency-name: org.jetbrains.kotlin*
+        update-types: [version-update:semver-major, version-update:semver-minor]
+      - dependency-name: com.google.devtools.ksp*
+        update-types: [version-update:semver-major, version-update:semver-minor]
+      - dependency-name: com.google.dagger:*
+        update-types: [version-update:semver-major, version-update:semver-minor]
+      - dependency-name: androidx.hilt:*
+        update-types: [version-update:semver-major, version-update:semver-minor]
+      - dependency-name: androidx.room:*
+        update-types: [version-update:semver-major, version-update:semver-minor]
+      # The app compiles against SDK 35. Current AndroidX releases expect 36,
+      # so their minor updates fail the build until the platform moves. Patch
+      # updates still arrive, and anything that passes CI still gets merged.
+      - dependency-name: androidx.*
+        update-types: [version-update:semver-major, version-update:semver-minor]
+
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: monthly
+    open-pull-requests-limit: 3
+    commit-message:
+      prefix: ci

.github/workflows/ci.yml

@@ -0,0 +1,51 @@
+name: CI
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+defaults:
+  run:
+    working-directory: Rannah
+
+jobs:
+  build:
+    name: Unit tests, lint and debug build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+
+      - uses: actions/setup-java@v5
+        with:
+          distribution: temurin
+          java-version: 17
+          cache: gradle
+
+      - name: Unit tests
+        run: ./gradlew testDebugUnitTest --no-daemon
+
+      - name: Android Lint
+        run: ./gradlew lintDebug --no-daemon
+
+      - name: Debug build
+        run: ./gradlew assembleDebug --no-daemon
+
+      # The release variant is where minification and resource shrinking run,
+      # so it is the one that catches a missing ProGuard keep rule. It
+      # assembles unsigned here: the signing key lives outside the repository.
+      - name: Release build
+        run: ./gradlew assembleRelease --no-daemon
+
+      - name: Upload reports on failure
+        if: failure()
+        uses: actions/upload-artifact@v7
+        with:
+          name: reports
+          path: |
+            Rannah/app/build/reports/
+          retention-days: 7

README.md

@@ -9,6 +9,9 @@
 
 لكل موعد رَنّة
 
+<a href="https://github.com/Mod578/Rannah/actions/workflows/ci.yml"><img src="https://github.com/Mod578/Rannah/actions/workflows/ci.yml/badge.svg?branch=master" alt="حالة البناء"></a>
+<a href="https://github.com/Mod578/Rannah/releases/latest"><img src="https://img.shields.io/github/v/release/Mod578/Rannah?label=%D8%A7%D9%84%D8%A5%D8%B5%D8%AF%D8%A7%D8%B1" alt="أحدث إصدار"></a>
+
 </div>
 
 <div dir="rtl">
@@ -19,14 +22,15 @@
 ## المزايا
 
 - تذكير لمرة واحدة أو يومي أو متكرر بأيام الأسبوع أو شهريًا أو سنويًا
+- كتابة التذكير بالعربية الطبيعية، مثل «ذكرني كل يوم الساعة ٩ بالدواء»
 - رنين بشاشة كاملة فوق شاشة القفل، بصوت المنبّه
 - تأجيل بالمدة الافتراضية، أو بمدة تختارها لرنّة واحدة
 - تأكيد الإنجاز بسحب متعمّد على شاشة الرنّة
 - تخطي رنّة اليوم مع بقاء التكرار كما هو
 - إيقاف التذكير مؤقتًا واستئنافه
 - تراجع عن الإنجاز والتخطي والحذف
 - سجل لكل تذكير يبيّن ما أُنجز وما تُخطّي وما مرّ دون إجابة
-- عرض التاريخ الميلادي والهجري
+- عرض التاريخ الهجري إلى جانب الميلادي، مع تعديل الفارق عند الحاجة
 - ودجت لتاريخ اليوم والرنّة القادمة
 - مظهر نهاري وليلي، أو اتباع مظهر النظام
 - واجهة عربية بالكامل من اليمين إلى اليسار
@@ -36,8 +40,11 @@
 
 [تنزيل أحدث إصدار](https://github.com/Mod578/Rannah/releases/latest)
 
-ملف `APK` هو ملف التثبيت المباشر على أندرويد. قد يطلب النظام السماح بالتثبيت
-من هذا المصدر.
+نزّل ملف `APK` وافتحه، واسمح بالتثبيت من هذا المصدر حين يطلب النظام ذلك. وعند
+أول تشغيل امنح إذن التنبيهات وإذن التنبيه في وقته، فبدونهما لا ترنّ التذكيرات
+في مواعيدها.
+
+مع كل إصدار ملف `SHA256SUMS.txt` للتحقّق من الملفات.
 
 ## الخصوصية
 
@@ -51,6 +58,10 @@
 
 أندرويد 8.0 أو أحدث.
 
+## للمطوّرين
+
+[بنية المشروع والبناء من المصدر](Rannah/docs/ARCHITECTURE.md) · [الهوية البصرية](Rannah/docs/BRAND.md)
+
 ## المطوّر
 
 محمد المطيري

Rannah/app/src/main/java/com/bal/reminders/BalApp.kt

@@ -29,8 +29,8 @@ class BalApp : Application(), Configuration.Provider {
         super.onCreate()
         notificationPresenter.ensureChannels()
         ReconcileWorker.ensureScheduled(this)
-        // Restore alarms whenever the process starts — covers the case where a
-        // force-stop wiped them and the user just reopened the app — and clean up
+        // Restore alarms whenever the process starts, covers the case where a
+        // force-stop wiped them and the user just reopened the app, and clean up
         // one-time reminders that were completed on a previous day.
         appScope.launch {
             scheduler.pruneFinished()

Rannah/app/src/main/java/com/bal/reminders/MainActivity.kt

@@ -57,7 +57,7 @@ class MainActivity : ComponentActivity() {
                 }
                 // The system bars carry the app's appearance, not the system's.
                 // Someone running رَنّة in «نهاري» on a dark-themed phone was
-                // getting light icons over a light background — invisible.
+                // getting light icons over a light background: invisible.
                 SideEffect { applyBarAppearance(dark) }
                 BalTheme(darkTheme = dark) {
                     BalRoot(

Rannah/app/src/main/java/com/bal/reminders/alarm/AlarmActivity.kt

@@ -76,8 +76,8 @@ import kotlinx.coroutines.delay
  * The full-screen alarm surface, shown over the lock screen while the ringer
  * sounds. It offers exactly two answers: «تأجيل» postpones and closes; «تم»
  * reveals a deliberate slide-to-confirm, and only completing that slide records
- * the occurrence as done. Nothing here — a background tap, the back gesture,
- * leaving the screen — ever counts as completion.
+ * the occurrence as done. Nothing here: a background tap, the back gesture,
+ * leaving the screen: ever counts as completion.
  */
 @AndroidEntryPoint
 class AlarmActivity : ComponentActivity() {
@@ -199,7 +199,7 @@ private fun AlarmScreen(viewModel: AlarmViewModel) {
             }
         }
         // The label reads the setting, so it is always describing what the
-        // button will actually do — including right after the user changed it.
+        // button will actually do: including right after the user changed it.
         val snoozeLabel = context.resources.getQuantityString(
             R.plurals.notification_snooze_minutes,
             state.defaultSnoozeMinutes,
@@ -217,7 +217,7 @@ private fun AlarmScreen(viewModel: AlarmViewModel) {
             horizontalAlignment = Alignment.CenterHorizontally,
             verticalArrangement = Arrangement.Center,
         ) {
-            // While the ring sounds, the mark breathes — a slow swell, the one
+            // While the ring sounds, the mark breathes: a slow swell, the one
             // place motion says "this is happening now". It used to rotate
             // about a point 14% down the height, which was a bell's hanging
             // loop; the mark has no loop to hang from, and a tilted نون reads
@@ -312,7 +312,7 @@ private fun AlarmScreen(viewModel: AlarmViewModel) {
                     )
                 }
                 Spacer(Modifier.height(8.dp))
-                // «مدة أخرى»: one quiet, ordinary, focusable button — not a
+                // «مدة أخرى»: one quiet, ordinary, focusable button: not a
                 // long-press, which TalkBack and switch access cannot reach and
                 // nobody discovers. Everything it offers lives one layer down,
                 // so the ringing screen keeps its two large answers.

Rannah/app/src/main/java/com/bal/reminders/alarm/AlarmViewModel.kt

@@ -99,7 +99,7 @@ class AlarmViewModel @Inject constructor(
         confirming.value = false
     }
 
-    /** «تأجيل»: the global default, applied now — not a number frozen into the reminder. */
+    /** «تأجيل»: the global default, applied now, not a number frozen into the reminder. */
     fun snooze() = resolveOnce { id, occurrence ->
         scheduler.snooze(id, occurrence, SnoozeRequest.Default)
     }

Rannah/app/src/main/java/com/bal/reminders/data/Mappers.kt

@@ -23,7 +23,7 @@ private const val TYPE_HIJRI_MONTHLY_LEGACY = "hijri_monthly"
 
 /**
  * رَنّة dropped categories, priorities, alert modes, follow-up, per-reminder
- * alarm options and — since 1.1 — the per-reminder snooze length. The columns
+ * alarm options and, since 1.1, the per-reminder snooze length. The columns
  * survive so old databases migrate losslessly (and a downgrade would still
  * read); every new row writes these neutral defaults, and nothing in the app
  * reads them back. Hijri schedule columns are also preserved so reminders saved

Rannah/app/src/main/java/com/bal/reminders/data/db/BalDatabase.kt

@@ -96,8 +96,8 @@ abstract class BalDatabase : RoomDatabase() {
          * v4: drops `stopMarksCompleted`.
          *
          * The column let «إيقاف الصوت» record a completion. That made one verb
-         * mean two things — silence a ringer, and assert that an obligation in
-         * the world was met — and which one it meant depended on a switch buried
+         * mean two things: silence a ringer, and assert that an obligation in
+         * the world was met, and which one it meant depended on a switch buried
          * in customization. رَنّة now has exactly one rule: stopping a sound
          * stops a sound. Completion is always its own deliberate act.
          *
@@ -183,13 +183,13 @@ abstract class BalDatabase : RoomDatabase() {
         /**
          * v6: one answer per occurrence, and one global snooze length.
          *
-         * The table shape does not change — this migration is entirely about
+         * The table shape does not change: this migration is entirely about
          * data that older builds could produce and 1.1 no longer can:
          *
          * - An occurrence could hold **both** a `completed` and a `skipped`
          *   record. The unique index is per (reminder, occurrence, status), so
          *   SQLite always allowed the pair, and two surfaces racing could write
-         *   it. «تم» is the stronger claim — it asserts the task happened — so a
+         *   it. «تم» is the stronger claim: it asserts the task happened, so a
          *   contradicting `skipped` row is dropped and the completion stands.
          * - A `missed` record alongside an answer said two things about one
          *   occurrence. The answer is the later and truer one; the `missed` row