Survivor side (4/4): truthful ring confirmation + 'Who owns it?'

- TrackerRinger now reads the DULT/Find My indication: reports 'Ringing confirmed' on the tag's response, or (after a 4s wait with no confirmation) 'sent, but the tracker didn't confirm - it only rings when separated from its owner'. AirTag still confirmed by its self-disconnect. No more over-claiming from a bare write-ACK.
- 'Who owns it?' on the tracker detail: guidance to tap the tag with NFC and let the phone open the owner's masked contact page (works via Android's built-in NFC dispatch; VIGIL stays offline).
Release 0.1.11 — completes the survivor-actionability work (safety + onboarding, history + export, trail, ring confirmation + owner info).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0187UiEtasyowhEBYs6s9iF5

README.md

@@ -28,6 +28,18 @@ that idea.
 
 ---
 
+## Screenshots
+
+<p align="center">
+  <img src="docs/screenshots/main.png" width="230" alt="VIGIL watch list — whether anything has been following you" />
+  &nbsp;
+  <img src="docs/screenshots/finder-searching.png" width="230" alt="Hot/cold finder searching for a tracker" />
+  &nbsp;
+  <img src="docs/screenshots/finder-close.png" width="230" alt="Finder homing in on a device, with Make it ring" />
+</p>
+
+<p align="center"><sub>The watch list &nbsp;·&nbsp; the hot/cold finder searching &nbsp;·&nbsp; homing in on a tracker, with “Make it ring”</sub></p>
+
 ## Privacy first — fully offline
 
 VIGIL requests **no `INTERNET` permission at all.** There is no server, no account,

app/build.gradle.kts

@@ -13,8 +13,8 @@ android {
         applicationId = "org.soulstone.vigil"
         minSdk = 26
         targetSdk = 35
-        versionCode = 8
+        versionCode = 12
-        versionName = "0.1.7"
+        versionName = "0.1.11"
     }
 
     // Fixed debug keystore committed to the repo (a debug key is non-secret — its

app/src/main/AndroidManifest.xml

@@ -67,5 +67,16 @@
             android:enabled="true"
             android:exported="false"
             android:foregroundServiceType="connectedDevice|location" />
+
+        <!-- Shares exported evidence files (report + GPX) with other apps. No network. -->
+        <provider
+            android:name="androidx.core.content.FileProvider"
+            android:authorities="${applicationId}.fileprovider"
+            android:exported="false"
+            android:grantUriPermissions="true">
+            <meta-data
+                android:name="android.support.FILE_PROVIDER_PATHS"
+                android:resource="@xml/file_paths" />
+        </provider>
     </application>
 </manifest>

app/src/main/kotlin/org/soulstone/vigil/MainActivity.kt

@@ -14,16 +14,23 @@ import androidx.activity.result.contract.ActivityResultContracts
 import androidx.compose.runtime.collectAsState
 import androidx.compose.runtime.getValue
 import androidx.compose.runtime.mutableStateOf
+import androidx.compose.runtime.remember
+import androidx.compose.runtime.setValue
 import androidx.core.content.ContextCompat
+import androidx.core.content.FileProvider
 import androidx.lifecycle.lifecycleScope
 import kotlinx.coroutines.launch
+import java.io.File
 import org.soulstone.vigil.data.TrackerRepository
 import org.soulstone.vigil.data.db.TrackerEntity
 import org.soulstone.vigil.data.db.VigilDatabase
 import org.soulstone.vigil.ring.TrackerRinger
 import org.soulstone.vigil.data.settings.Settings
 import org.soulstone.vigil.service.ScanService
+import org.soulstone.vigil.ui.HistoryScreen
 import org.soulstone.vigil.ui.MainScreen
+import org.soulstone.vigil.ui.OnboardingScreen
+import org.soulstone.vigil.ui.SafetyScreen
 import org.soulstone.vigil.ui.theme.VigilTheme
 
 class MainActivity : ComponentActivity() {
@@ -68,6 +75,25 @@ class MainActivity : ComponentActivity() {
 
         setContent {
             VigilTheme {
+                val onboarded by settings.onboarded.collectAsState()
+                var showSafety by remember { mutableStateOf(false) }
+                var showHistory by remember { mutableStateOf(false) }
+                when {
+                    !onboarded -> OnboardingScreen(onFinish = {
+                        settings.setOnboarded(true)
+                        if (!hasEssentialPermissions()) permissionLauncher.launch(requiredPermissions)
+                    })
+                    showSafety -> SafetyScreen(onBack = { showSafety = false })
+                    showHistory -> {
+                        val alerts by repo.observeAlerts().collectAsState(initial = emptyList())
+                        HistoryScreen(
+                            alerts = alerts,
+                            onExport = { exportEvidence() },
+                            onClear = { lifecycleScope.launch { repo.clearAlerts() } },
+                            onBack = { showHistory = false }
+                        )
+                    }
+                    else -> {
                         val running by ScanService.running.collectAsState()
                         val trackers by repo.observeTrackers().collectAsState(initial = emptyList())
                         val sensitivity by settings.sensitivity.collectAsState()
@@ -96,11 +122,16 @@ class MainActivity : ComponentActivity() {
                                 lifecycleScope.launch { repo.clearBaseline(id) }
                             },
                             onRing = { tracker -> ringTracker(tracker) },
-                    onClearAll = { lifecycleScope.launch { repo.clearAll() } }
+                            onClearAll = { lifecycleScope.launch { repo.clearAll() } },
+                            onOpenSafety = { showSafety = true },
+                            onOpenHistory = { showHistory = true },
+                            loadTrail = { id -> repo.trailFor(id) }
                         )
                     }
                 }
             }
+        }
+    }
 
     override fun onResume() {
         super.onResume()
@@ -119,6 +150,34 @@ class MainActivity : ComponentActivity() {
         }
     }
 
+    private fun exportEvidence() {
+        lifecycleScope.launch {
+            val report = repo.buildTextReport()
+            if (report == null) {
+                Toast.makeText(this@MainActivity, "No alerts to export yet.", Toast.LENGTH_SHORT).show()
+                return@launch
+            }
+            runCatching {
+                val dir = File(cacheDir, "exports").apply { mkdirs() }
+                val txt = File(dir, "vigil-report.txt").apply { writeText(report) }
+                val gpx = File(dir, "vigil-track.gpx").apply { writeText(repo.buildGpx()) }
+                val auth = "$packageName.fileprovider"
+                val uris = arrayListOf(
+                    FileProvider.getUriForFile(this@MainActivity, auth, txt),
+                    FileProvider.getUriForFile(this@MainActivity, auth, gpx)
+                )
+                val share = Intent(Intent.ACTION_SEND_MULTIPLE).apply {
+                    type = "*/*"
+                    putParcelableArrayListExtra(Intent.EXTRA_STREAM, uris)
+                    addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION)
+                }
+                startActivity(Intent.createChooser(share, "Export VIGIL evidence"))
+            }.onFailure {
+                Toast.makeText(this@MainActivity, "Export failed: ${it.message}", Toast.LENGTH_LONG).show()
+            }
+        }
+    }
+
     @Suppress("unused")
     private fun openAppSettings() {
         startActivity(

app/src/main/kotlin/org/soulstone/vigil/data/TrackerRepository.kt

@@ -3,6 +3,7 @@ package org.soulstone.vigil.data
 import kotlinx.coroutines.flow.Flow
 import kotlinx.coroutines.sync.Mutex
 import kotlinx.coroutines.sync.withLock
+import org.soulstone.vigil.data.db.AlertEntity
 import org.soulstone.vigil.data.db.SightingEntity
 import org.soulstone.vigil.data.db.TrackerEntity
 import org.soulstone.vigil.data.db.VigilDatabase
@@ -11,8 +12,14 @@ import org.soulstone.vigil.detect.CoMovementEvaluator
 import org.soulstone.vigil.model.RiskState
 import org.soulstone.vigil.model.SeparatedState
 import org.soulstone.vigil.model.Sensitivity
+import org.soulstone.vigil.model.TrackerEcosystem
 import org.soulstone.vigil.model.TrackerObservation
+import org.soulstone.vigil.model.TrailPoint
 import org.soulstone.vigil.util.Geohash
+import java.text.SimpleDateFormat
+import java.util.Date
+import java.util.Locale
+import java.util.TimeZone
 
 /**
  * The temporal core. Persists sightings, maintains the learned baseline, and runs
@@ -133,10 +140,98 @@ class TrackerRepository(private val db: VigilDatabase) {
             lastMac = obs.mac
         )
         db.trackerDao().upsert(updated)
+        if (newlyAlerting) {
+            db.alertDao().insert(
+                AlertEntity(
+                    trackerId = obs.stableId,
+                    ecosystem = obs.ecosystem.name,
+                    label = obs.label,
+                    timestamp = now,
+                    distinctPlaces = assessment.distinctPlaces,
+                    peakRssi = updated.peakRssi,
+                    lat = lat, lon = lon
+                )
+            )
+        }
         RecordResult(updated, newlyAlerting)
     }
 
+    fun observeAlerts(): Flow<List<AlertEntity>> = db.alertDao().observeAll()
+
+    suspend fun clearAlerts() = db.alertDao().clear()
+
+    /** Geotagged sightings of one tracker, in time order, for the in-app trail. */
+    suspend fun trailFor(id: String): List<TrailPoint> =
+        db.sightingDao().allFor(id).mapNotNull { s ->
+            val la = s.lat; val lo = s.lon
+            if (la != null && lo != null) TrailPoint(la, lo) else null
+        }
+
+    /** Human-readable evidence report; null if there are no alerts yet. */
+    suspend fun buildTextReport(): String? {
+        val alerts = db.alertDao().all()
+        if (alerts.isEmpty()) return null
+        val fmt = SimpleDateFormat("yyyy-MM-dd HH:mm:ss z", Locale.US)
+        val sb = StringBuilder()
+        sb.appendLine("VIGIL — tracker evidence report")
+        sb.appendLine("Generated: ${fmt.format(Date())}")
+        sb.appendLine("Times are this phone's local time; locations are approximate (phone GPS).")
+        sb.appendLine("=".repeat(52))
+        for ((trackerId, group) in alerts.groupBy { it.trackerId }) {
+            val head = group.first()
+            sb.appendLine()
+            sb.appendLine("${ecoLabel(head.ecosystem)} — ${head.label}")
+            sb.appendLine("Identity: $trackerId")
+            sb.appendLine("Flagged ${group.size} time(s):")
+            for (a in group) {
+                val where = if (a.lat != null && a.lon != null) "%.5f, %.5f".format(a.lat, a.lon) else "no location"
+                sb.appendLine("  - ${fmt.format(Date(a.timestamp))} : ${a.distinctPlaces} places, peak ${a.peakRssi} dBm, at $where")
+            }
+            val geo = db.sightingDao().allFor(trackerId).filter { it.lat != null && it.lon != null }
+            if (geo.isNotEmpty()) {
+                sb.appendLine("  Seen with you at ${geo.size} location(s):")
+                for (s in geo) {
+                    sb.appendLine("    ${fmt.format(Date(s.timestamp))}  ${"%.5f, %.5f".format(s.lat, s.lon)}  ${s.rssi} dBm")
+                }
+            }
+        }
+        sb.appendLine()
+        sb.appendLine("=".repeat(52))
+        sb.appendLine("Recorded by VIGIL, an offline anti-tracking app — a log of Bluetooth trackers detected moving with this phone.")
+        return sb.toString()
+    }
+
+    /** GPX of every geotagged sighting, to open in a maps app. */
+    suspend fun buildGpx(): String {
+        val fmt = SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss'Z'", Locale.US).apply {
+            timeZone = TimeZone.getTimeZone("UTC")
+        }
+        val sb = StringBuilder()
+        sb.appendLine("""<?xml version="1.0" encoding="UTF-8"?>""")
+        sb.appendLine("""<gpx version="1.1" creator="VIGIL" xmlns="http://www.topografix.com/GPX/1/1">""")
+        for (s in db.sightingDao().allGeotagged()) {
+            sb.appendLine("""  <wpt lat="${s.lat}" lon="${s.lon}">""")
+            sb.appendLine("    <time>${fmt.format(Date(s.timestamp))}</time>")
+            sb.appendLine("    <name>${trackerShortName(s.trackerId)} ${s.rssi}dBm</name>")
+            sb.appendLine("  </wpt>")
+        }
+        sb.appendLine("</gpx>")
+        return sb.toString()
+    }
+
     companion object {
         const val RETENTION_DAYS = 14
     }
 }
+
+private fun ecoLabel(name: String): String =
+    runCatching { TrackerEcosystem.valueOf(name).display }.getOrDefault(name)
+
+private fun trackerShortName(stableId: String): String = when (stableId.substringBefore(':')) {
+    "apple" -> "AppleFindMy"
+    "fmdn" -> "GoogleFMD"
+    "samsung" -> "SmartTag"
+    "tile" -> "Tile"
+    "dult" -> "DULT"
+    else -> "Tracker"
+}

app/src/main/kotlin/org/soulstone/vigil/data/db/VigilDatabase.kt

@@ -68,6 +68,21 @@ data class PlaceEntity(
     val anchor: Boolean = false
 )
 
+/** A recorded alert — when a tracker first crossed into ALERTING. Kept for the
+ *  history list and the evidence export. */
+@Entity(tableName = "alerts")
+data class AlertEntity(
+    @PrimaryKey(autoGenerate = true) val id: Long = 0,
+    val trackerId: String,
+    val ecosystem: String,
+    val label: String,
+    val timestamp: Long,
+    val distinctPlaces: Int,
+    val peakRssi: Int,
+    val lat: Double? = null,
+    val lon: Double? = null
+)
+
 @Dao
 interface TrackerDao {
     @Query("SELECT * FROM trackers WHERE stableId = :id")
@@ -104,6 +119,12 @@ interface SightingDao {
     @Query("SELECT * FROM sightings WHERE trackerId = :id AND timestamp >= :since ORDER BY timestamp")
     suspend fun recentFor(id: String, since: Long): List<SightingEntity>
 
+    @Query("SELECT * FROM sightings WHERE trackerId = :id ORDER BY timestamp")
+    suspend fun allFor(id: String): List<SightingEntity>
+
+    @Query("SELECT * FROM sightings WHERE lat IS NOT NULL ORDER BY timestamp")
+    suspend fun allGeotagged(): List<SightingEntity>
+
     @Query("DELETE FROM sightings WHERE timestamp < :cutoff")
     suspend fun prune(cutoff: Long)
 
@@ -120,15 +141,31 @@ interface PlaceDao {
     suspend fun upsert(place: PlaceEntity)
 }
 
+@Dao
+interface AlertDao {
+    @Insert
+    suspend fun insert(alert: AlertEntity)
+
+    @Query("SELECT * FROM alerts ORDER BY timestamp DESC")
+    fun observeAll(): Flow<List<AlertEntity>>
+
+    @Query("SELECT * FROM alerts ORDER BY timestamp DESC")
+    suspend fun all(): List<AlertEntity>
+
+    @Query("DELETE FROM alerts")
+    suspend fun clear()
+}
+
 @Database(
-    entities = [TrackerEntity::class, SightingEntity::class, PlaceEntity::class],
+    entities = [TrackerEntity::class, SightingEntity::class, PlaceEntity::class, AlertEntity::class],
-    version = 3,
+    version = 4,
     exportSchema = false
 )
 abstract class VigilDatabase : RoomDatabase() {
     abstract fun trackerDao(): TrackerDao
     abstract fun sightingDao(): SightingDao
     abstract fun placeDao(): PlaceDao
+    abstract fun alertDao(): AlertDao
 
     companion object {
         @Volatile private var INSTANCE: VigilDatabase? = null

app/src/main/kotlin/org/soulstone/vigil/data/settings/Settings.kt

@@ -25,8 +25,16 @@ class Settings private constructor(context: Context) {
         _sensitivity.value = value
     }
 
+    private val _onboarded = MutableStateFlow(prefs.getBoolean(KEY_ONBOARDED, false))
+    val onboarded: StateFlow<Boolean> = _onboarded.asStateFlow()
+    fun setOnboarded(value: Boolean) {
+        prefs.edit().putBoolean(KEY_ONBOARDED, value).apply()
+        _onboarded.value = value
+    }
+
     companion object {
         private const val KEY_SENSITIVITY = "sensitivity"
+        private const val KEY_ONBOARDED = "onboarded"
 
         @Volatile private var INSTANCE: Settings? = null
         fun get(context: Context): Settings = INSTANCE ?: synchronized(this) {

app/src/main/kotlin/org/soulstone/vigil/model/Types.kt

@@ -37,3 +37,6 @@ enum class TrackerStatus { SAFE_APPROVED, SAFE_BASELINE, OBSERVED, SUSPICIOUS, A
 
 /** Detection sensitivity — trades time-to-alert against false positives. */
 enum class Sensitivity { HIGH, MEDIUM, LOW }
+
+/** A geotagged point where a tracker was seen, for the in-app co-movement trail. */
+data class TrailPoint(val lat: Double, val lon: Double)

app/src/main/kotlin/org/soulstone/vigil/ring/TrackerRinger.kt

@@ -12,6 +12,8 @@ import android.bluetooth.BluetoothProfile
 import android.content.Context
 import android.content.pm.PackageManager
 import android.os.Build
+import android.os.Handler
+import android.os.Looper
 import android.util.Log
 import androidx.core.content.ContextCompat
 import kotlinx.coroutines.TimeoutCancellationException
@@ -98,7 +100,9 @@ object TrackerRinger {
         suspendCancellableCoroutine { cont ->
             var gatt: BluetoothGatt? = null
             var selected: Proto? = null
-            fun done(msg: String, g: BluetoothGatt) {
+            val handler = Handler(Looper.getMainLooper())
+            fun finish(msg: String, g: BluetoothGatt) {
+                handler.removeCallbacksAndMessages(null)
                 if (cont.isActive) cont.resume(msg)
                 g.disconnect()
             }
@@ -107,11 +111,14 @@ object TrackerRinger {
                     when (newState) {
                         BluetoothProfile.STATE_CONNECTED -> g.discoverServices()
                         BluetoothProfile.STATE_DISCONNECTED -> {
+                            handler.removeCallbacksAndMessages(null)
                             // An AirTag self-disconnects (status 19) once it has started ringing.
                             if (cont.isActive) {
+                                cont.resume(
                                     if (selected == AIRTAG && status == STATUS_PEER_DISCONNECT)
-                                    cont.resume("Ringing… listen for the AirTag.")
+                                        "Ringing - listen for the AirTag."
-                                else cont.resume("Tracker disconnected before it could ring.")
+                                    else "Tracker disconnected before it could ring."
+                                )
                             }
                             g.close()
                         }
@@ -120,9 +127,9 @@ object TrackerRinger {
 
                 override fun onServicesDiscovered(g: BluetoothGatt, status: Int) {
                     val proto = PRIORITY.firstOrNull { g.getService(it.service) != null }
-                        ?: return done("This tracker type doesn't expose a remote-ring service.", g)
+                        ?: return finish("This tracker type doesn't expose a remote-ring service.", g)
                     val ch = g.getService(proto.service)?.getCharacteristic(proto.characteristic)
-                        ?: return done("Ring characteristic missing on this tracker.", g)
+                        ?: return finish("Ring characteristic missing on this tracker.", g)
                     selected = proto
                     if (proto.cccd) {
                         g.setCharacteristicNotification(ch, true)
@@ -131,32 +138,41 @@ object TrackerRinger {
                         else BluetoothGattDescriptor.ENABLE_NOTIFICATION_VALUE
                         if (desc == null || !writeDescriptor(g, desc, v)) writeStart(g, ch, proto)
                     } else {
-                        if (!writeStart(g, ch, proto)) done("Couldn't send the ring command.", g)
+                        if (!writeStart(g, ch, proto)) finish("Couldn't send the ring command.", g)
                     }
                 }
 
                 override fun onDescriptorWrite(g: BluetoothGatt, desc: BluetoothGattDescriptor, status: Int) {
                     val proto = selected ?: return
                     val ch = g.getService(proto.service)?.getCharacteristic(proto.characteristic)
-                        ?: return done("Ring characteristic missing on this tracker.", g)
+                        ?: return finish("Ring characteristic missing on this tracker.", g)
-                    if (!writeStart(g, ch, proto)) done("Couldn't send the ring command.", g)
+                    if (!writeStart(g, ch, proto)) finish("Couldn't send the ring command.", g)
                 }
 
                 override fun onCharacteristicWrite(g: BluetoothGatt, ch: BluetoothGattCharacteristic, status: Int) {
-                    // AirTag reports via self-disconnect; others confirm here.
+                    if (selected == AIRTAG) { finish("Ringing - listen for the AirTag.", g); return }
-                    if (selected == AIRTAG) {
+                    if (status != BluetoothGatt.GATT_SUCCESS) { finish("The tracker refused the ring command.", g); return }
-                        done("Ringing… listen for the AirTag.", g)
+                    // DULT/FindMy confirm via an indication. Wait briefly; if none arrives, the tag
-                    } else {
+                    // likely isn't separated from its owner (so it won't actually ring).
-                        done(
+                    handler.postDelayed({
-                            if (status == BluetoothGatt.GATT_SUCCESS)
+                        finish("Ring command sent, but the tracker didn't confirm - it only rings when separated from its owner.", g)
-                                "Ring command sent. A tag only chirps when it's separated from its owner — your own tag that's with you won't."
+                    }, 4000)
-                            else "The tracker refused the ring command.", g
-                        )
                 }
+
+                @Suppress("DEPRECATION")
+                override fun onCharacteristicChanged(g: BluetoothGatt, ch: BluetoothGattCharacteristic) {
+                    finish("Ringing confirmed - listen for the tracker.", g)
+                }
+
+                override fun onCharacteristicChanged(g: BluetoothGatt, ch: BluetoothGattCharacteristic, value: ByteArray) {
+                    finish("Ringing confirmed - listen for the tracker.", g)
                 }
             }
             gatt = device.connectGatt(context, false, callback, BluetoothDevice.TRANSPORT_LE)
-            cont.invokeOnCancellation { runCatching { gatt?.disconnect(); gatt?.close() } }
+            cont.invokeOnCancellation {
+                handler.removeCallbacksAndMessages(null)
+                runCatching { gatt?.disconnect(); gatt?.close() }
+            }
         }
 
     @Suppress("DEPRECATION")

app/src/main/kotlin/org/soulstone/vigil/ui/HistoryScreen.kt

@@ -0,0 +1,97 @@
+package org.soulstone.vigil.ui
+
+import android.text.format.DateUtils
+import androidx.activity.compose.BackHandler
+import androidx.compose.foundation.layout.Arrangement
+import androidx.compose.foundation.layout.Column
+import androidx.compose.foundation.layout.Row
+import androidx.compose.foundation.layout.Spacer
+import androidx.compose.foundation.layout.fillMaxSize
+import androidx.compose.foundation.layout.fillMaxWidth
+import androidx.compose.foundation.layout.height
+import androidx.compose.foundation.layout.padding
+import androidx.compose.foundation.layout.size
+import androidx.compose.foundation.lazy.LazyColumn
+import androidx.compose.foundation.lazy.items
+import androidx.compose.material.icons.Icons
+import androidx.compose.material.icons.filled.ArrowBack
+import androidx.compose.material.icons.filled.Share
+import androidx.compose.material3.Button
+import androidx.compose.material3.Card
+import androidx.compose.material3.CardDefaults
+import androidx.compose.material3.Icon
+import androidx.compose.material3.IconButton
+import androidx.compose.material3.MaterialTheme
+import androidx.compose.material3.OutlinedButton
+import androidx.compose.material3.Surface
+import androidx.compose.material3.Text
+import androidx.compose.runtime.Composable
+import androidx.compose.ui.Alignment
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.text.font.FontWeight
+import androidx.compose.ui.unit.dp
+import org.soulstone.vigil.data.db.AlertEntity
+import org.soulstone.vigil.model.TrackerEcosystem
+
+/** Log of past alerts, with a one-tap evidence export (report + GPX). */
+@Composable
+fun HistoryScreen(
+    alerts: List<AlertEntity>,
+    onExport: () -> Unit,
+    onClear: () -> Unit,
+    onBack: () -> Unit
+) {
+    BackHandler(onBack = onBack)
+    Surface(Modifier.fillMaxSize(), color = MaterialTheme.colorScheme.background) {
+        Column(Modifier.fillMaxSize().padding(16.dp)) {
+            Row(verticalAlignment = Alignment.CenterVertically) {
+                IconButton(onClick = onBack) { Icon(Icons.Filled.ArrowBack, "Back") }
+                Spacer(Modifier.size(4.dp))
+                Text("Alert history", style = MaterialTheme.typography.titleLarge, fontWeight = FontWeight.Bold)
+            }
+            Spacer(Modifier.height(12.dp))
+            Row(Modifier.fillMaxWidth(), horizontalArrangement = Arrangement.spacedBy(8.dp)) {
+                Button(onClick = onExport, modifier = Modifier.weight(1f)) {
+                    Icon(Icons.Filled.Share, null, modifier = Modifier.size(18.dp))
+                    Spacer(Modifier.size(6.dp))
+                    Text("Export evidence")
+                }
+                OutlinedButton(onClick = onClear, enabled = alerts.isNotEmpty()) { Text("Clear") }
+            }
+            Spacer(Modifier.height(6.dp))
+            Text(
+                "Export saves a timestamped report and a GPX track (open it in a maps app). Files stay on your phone until you share them.",
+                style = MaterialTheme.typography.bodySmall,
+                color = MaterialTheme.colorScheme.onSurfaceVariant
+            )
+            Spacer(Modifier.height(16.dp))
+            if (alerts.isEmpty()) {
+                Text(
+                    "No alerts yet. When a tracker is confirmed following you, it'll be logged here.",
+                    color = MaterialTheme.colorScheme.onSurfaceVariant
+                )
+            } else {
+                LazyColumn(verticalArrangement = Arrangement.spacedBy(8.dp)) {
+                    items(alerts, key = { it.id }) { a -> AlertRow(a) }
+                }
+            }
+        }
+    }
+}
+
+@Composable
+private fun AlertRow(a: AlertEntity) {
+    Card(Modifier.fillMaxWidth(), colors = CardDefaults.cardColors(containerColor = MaterialTheme.colorScheme.surface)) {
+        Column(Modifier.padding(14.dp)) {
+            Text(ecoName(a.ecosystem), fontWeight = FontWeight.SemiBold)
+            Text(
+                "${a.distinctPlaces} places · peak ${a.peakRssi} dBm · ${rel(a.timestamp)}",
+                style = MaterialTheme.typography.bodySmall,
+                color = MaterialTheme.colorScheme.onSurfaceVariant
+            )
+        }
+    }
+}
+
+private fun ecoName(name: String) = runCatching { TrackerEcosystem.valueOf(name).display }.getOrDefault(name)
+private fun rel(ts: Long) = DateUtils.getRelativeTimeSpanString(ts, System.currentTimeMillis(), DateUtils.MINUTE_IN_MILLIS).toString()

app/src/main/kotlin/org/soulstone/vigil/ui/MainScreen.kt

@@ -12,6 +12,7 @@ import androidx.compose.ui.graphics.lerp
 import androidx.compose.ui.res.painterResource
 import org.soulstone.vigil.service.ScanService
 import androidx.compose.foundation.Image
+import androidx.compose.foundation.Canvas
 import androidx.compose.foundation.background
 import androidx.compose.foundation.clickable
 import androidx.compose.foundation.layout.Arrangement
@@ -32,11 +33,14 @@ import androidx.compose.material.icons.filled.Bluetooth
 import androidx.compose.material.icons.filled.CheckCircle
 import androidx.compose.material.icons.filled.DeleteSweep
 import androidx.compose.material.icons.filled.GppMaybe
+import androidx.compose.material.icons.filled.HealthAndSafety
+import androidx.compose.material.icons.filled.History
 import androidx.compose.material.icons.filled.Lock
 import androidx.compose.material.icons.filled.Radar
 import androidx.compose.material.icons.filled.Shield
 import androidx.compose.material.icons.filled.Verified
 import androidx.compose.material.icons.filled.Warning
+import androidx.compose.material3.AlertDialog
 import androidx.compose.material3.Button
 import androidx.compose.material3.ButtonDefaults
 import androidx.compose.material3.Card
@@ -48,6 +52,7 @@ import androidx.compose.material3.Icon
 import androidx.compose.material3.IconButton
 import androidx.compose.material3.MaterialTheme
 import androidx.compose.material3.ModalBottomSheet
+import androidx.compose.material3.OutlinedButton
 import androidx.compose.material3.Scaffold
 import androidx.compose.material3.Surface
 import androidx.compose.material3.Text
@@ -58,11 +63,13 @@ import androidx.compose.material3.rememberModalBottomSheetState
 import androidx.compose.runtime.Composable
 import androidx.compose.runtime.getValue
 import androidx.compose.runtime.mutableStateOf
+import androidx.compose.runtime.produceState
 import androidx.compose.runtime.remember
 import androidx.compose.runtime.setValue
 import androidx.compose.ui.Alignment
 import androidx.compose.ui.Modifier
 import androidx.compose.ui.draw.clip
+import androidx.compose.ui.geometry.Offset
 import androidx.compose.ui.graphics.Color
 import androidx.compose.ui.graphics.vector.ImageVector
 import androidx.compose.ui.text.font.FontWeight
@@ -74,6 +81,7 @@ import org.soulstone.vigil.model.Sensitivity
 import org.soulstone.vigil.model.TrackerEcosystem
 import org.soulstone.vigil.R
 import org.soulstone.vigil.model.TrackerStatus
+import org.soulstone.vigil.model.TrailPoint
 import org.soulstone.vigil.ui.theme.VigilGreen
 import org.soulstone.vigil.ui.theme.VigilPeach
 import org.soulstone.vigil.ui.theme.VigilRed
@@ -90,7 +98,10 @@ fun MainScreen(
     onApprove: (String, Boolean) -> Unit,
     onDistrust: (String) -> Unit,
     onRing: (TrackerEntity) -> Unit,
-    onClearAll: () -> Unit
+    onClearAll: () -> Unit,
+    onOpenSafety: () -> Unit,
+    onOpenHistory: () -> Unit,
+    loadTrail: suspend (String) -> List<TrailPoint>
 ) {
     var detail by remember { mutableStateOf<TrackerEntity?>(null) }
     var finding by remember { mutableStateOf<TrackerEntity?>(null) }
@@ -119,6 +130,20 @@ fun MainScreen(
                     }
                 },
                 actions = {
+                    IconButton(onClick = onOpenHistory) {
+                        Icon(
+                            Icons.Filled.History,
+                            contentDescription = "Alert history",
+                            tint = MaterialTheme.colorScheme.onSurfaceVariant
+                        )
+                    }
+                    IconButton(onClick = onOpenSafety) {
+                        Icon(
+                            Icons.Filled.HealthAndSafety,
+                            contentDescription = "Safety & help",
+                            tint = MaterialTheme.colorScheme.onSurfaceVariant
+                        )
+                    }
                     if (trackers.isNotEmpty()) {
                         IconButton(onClick = onClearAll) {
                             Icon(
@@ -228,7 +253,9 @@ fun MainScreen(
                 onApprove = { id, a -> onApprove(id, a); detail = null },
                 onDistrust = { id -> onDistrust(id); detail = null },
                 onFind = { dev -> ScanService.setFinderTarget(dev.stableId); finding = dev; detail = null },
-                onRing = onRing
+                onRing = onRing,
+                onSafety = { onOpenSafety(); detail = null },
+                loadTrail = loadTrail
             )
         }
     }
@@ -378,7 +405,9 @@ private fun TrackerDetail(
     onApprove: (String, Boolean) -> Unit,
     onDistrust: (String) -> Unit,
     onFind: (TrackerEntity) -> Unit,
-    onRing: (TrackerEntity) -> Unit
+    onRing: (TrackerEntity) -> Unit,
+    onSafety: () -> Unit,
+    loadTrail: suspend (String) -> List<TrailPoint>
 ) {
     val status = statusOf(t)
     Column(Modifier.fillMaxWidth().padding(24.dp)) {
@@ -389,6 +418,18 @@ private fun TrackerDetail(
         }
         Spacer(Modifier.height(4.dp))
         Text(statusLabel(status), color = statusColor(status), fontWeight = FontWeight.SemiBold)
+        if (status == TrackerStatus.ALERTING || status == TrackerStatus.SUSPICIOUS) {
+            Spacer(Modifier.height(14.dp))
+            Button(
+                onClick = onSafety,
+                modifier = Modifier.fillMaxWidth(),
+                colors = ButtonDefaults.buttonColors(containerColor = VigilRed, contentColor = Color(0xFF11111B))
+            ) {
+                Icon(Icons.Filled.HealthAndSafety, null, modifier = Modifier.size(18.dp))
+                Spacer(Modifier.size(8.dp))
+                Text("What should I do?", fontWeight = FontWeight.Bold)
+            }
+        }
         Spacer(Modifier.height(16.dp))
 
         DetailRow("Signal (last / peak)", "${t.lastRssi} / ${t.peakRssi} dBm")
@@ -408,6 +449,25 @@ private fun TrackerDetail(
             style = MaterialTheme.typography.bodyMedium,
             color = MaterialTheme.colorScheme.onSurfaceVariant
         )
+
+        val trail by produceState(initialValue = emptyList<TrailPoint>(), t.stableId) { value = loadTrail(t.stableId) }
+        if (trail.size >= 2) {
+            Spacer(Modifier.height(18.dp))
+            Text("Where it's moved with you", style = MaterialTheme.typography.labelLarge, fontWeight = FontWeight.SemiBold)
+            Spacer(Modifier.height(8.dp))
+            TrailView(
+                trail,
+                Modifier.fillMaxWidth().height(150.dp).clip(RoundedCornerShape(12.dp))
+                    .background(MaterialTheme.colorScheme.surfaceVariant.copy(alpha = 0.5f))
+            )
+            Text(
+                "A schematic of the ${trail.size} points it was seen — not a real map. Use Export for that.",
+                style = MaterialTheme.typography.bodySmall,
+                color = MaterialTheme.colorScheme.onSurfaceVariant,
+                modifier = Modifier.padding(top = 6.dp)
+            )
+        }
+
         Spacer(Modifier.height(20.dp))
         Row(Modifier.fillMaxWidth(), horizontalArrangement = Arrangement.spacedBy(8.dp)) {
             FilledTonalButton(onClick = { onFind(t) }, modifier = Modifier.weight(1f)) {
@@ -421,6 +481,23 @@ private fun TrackerDetail(
                 Text("Ring it")
             }
         }
+        var showInfo by remember { mutableStateOf(false) }
+        Spacer(Modifier.height(8.dp))
+        OutlinedButton(onClick = { showInfo = true }, modifier = Modifier.fillMaxWidth()) {
+            Text("Who owns it?")
+        }
+        if (showInfo) {
+            AlertDialog(
+                onDismissRequest = { showInfo = false },
+                confirmButton = { TextButton(onClick = { showInfo = false }) { Text("Got it") } },
+                title = { Text("Who owns this tracker?") },
+                text = {
+                    Text(
+                        "Tap the tracker against the top of your phone (NFC). If it's an AirTag or a DULT tag in lost mode, your phone opens a page with the owner's masked phone or email. VIGIL stays offline - the tag's NFC hands the link to your browser."
+                    )
+                }
+            )
+        }
         Spacer(Modifier.height(12.dp))
         when (status) {
             TrackerStatus.SAFE_APPROVED ->
@@ -522,6 +599,38 @@ private fun FinderScreen(t: TrackerEntity, onRing: (TrackerEntity) -> Unit, onCl
     }
 }
 
+/** Offline schematic of a tracker's geotagged sightings — points + path, scaled
+ *  to fit. Not a real map (VIGIL has no network); the GPX export opens in one. */
+@Composable
+private fun TrailView(points: List<TrailPoint>, modifier: Modifier = Modifier) {
+    val line = Color(0xFF89B4FA)
+    val startC = Color(0xFFA6E3A1)
+    val endC = Color(0xFFFAB387)
+    Canvas(modifier) {
+        if (points.size < 2) return@Canvas
+        val pad = 18f
+        val minLat = points.minOf { it.lat }; val maxLat = points.maxOf { it.lat }
+        val minLon = points.minOf { it.lon }; val maxLon = points.maxOf { it.lon }
+        val rLat = (maxLat - minLat).let { if (it > 1e-9) it else 1e-9 }
+        val rLon = (maxLon - minLon).let { if (it > 1e-9) it else 1e-9 }
+        val w = size.width - 2 * pad
+        val h = size.height - 2 * pad
+        val pts = points.map { p ->
+            Offset(
+                pad + ((p.lon - minLon) / rLon).toFloat() * w,
+                pad + (1f - ((p.lat - minLat) / rLat).toFloat()) * h
+            )
+        }
+        for (i in 0 until pts.size - 1) {
+            drawLine(line.copy(alpha = 0.55f), pts[i], pts[i + 1], strokeWidth = 3f)
+        }
+        pts.forEachIndexed { i, o ->
+            val c = if (i == 0) startC else if (i == pts.lastIndex) endC else line
+            drawCircle(c, radius = if (i == 0 || i == pts.lastIndex) 6f else 4f, center = o)
+        }
+    }
+}
+
 // ---- pure helpers ----------------------------------------------------------
 
 private const val ACTIVE_WINDOW_MS = 10 * 60_000L  // trackers not seen this recently drop off "Active"

app/src/main/kotlin/org/soulstone/vigil/ui/OnboardingScreen.kt

@@ -0,0 +1,87 @@
+package org.soulstone.vigil.ui
+
+import androidx.compose.foundation.Image
+import androidx.compose.foundation.layout.Arrangement
+import androidx.compose.foundation.layout.Column
+import androidx.compose.foundation.layout.Row
+import androidx.compose.foundation.layout.Spacer
+import androidx.compose.foundation.layout.fillMaxSize
+import androidx.compose.foundation.layout.fillMaxWidth
+import androidx.compose.foundation.layout.height
+import androidx.compose.foundation.layout.padding
+import androidx.compose.foundation.layout.size
+import androidx.compose.foundation.rememberScrollState
+import androidx.compose.foundation.verticalScroll
+import androidx.compose.material.icons.Icons
+import androidx.compose.material.icons.filled.LocationOn
+import androidx.compose.material.icons.filled.Lock
+import androidx.compose.material.icons.filled.Sensors
+import androidx.compose.material3.Button
+import androidx.compose.material3.Icon
+import androidx.compose.material3.MaterialTheme
+import androidx.compose.material3.Surface
+import androidx.compose.material3.Text
+import androidx.compose.runtime.Composable
+import androidx.compose.ui.Alignment
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.graphics.vector.ImageVector
+import androidx.compose.ui.res.painterResource
+import androidx.compose.ui.text.font.FontWeight
+import androidx.compose.ui.unit.dp
+import org.soulstone.vigil.R
+
+/** First-run: what VIGIL does, its offline promise, and why it needs its permissions. */
+@Composable
+fun OnboardingScreen(onFinish: () -> Unit) {
+    Surface(Modifier.fillMaxSize(), color = MaterialTheme.colorScheme.background) {
+        Column(
+            Modifier.fillMaxSize().verticalScroll(rememberScrollState()).padding(28.dp),
+            horizontalAlignment = Alignment.CenterHorizontally
+        ) {
+            Spacer(Modifier.height(32.dp))
+            Image(painterResource(R.drawable.vigil_logo), null, modifier = Modifier.size(76.dp))
+            Spacer(Modifier.height(14.dp))
+            Text("VIGIL", style = MaterialTheme.typography.headlineMedium, fontWeight = FontWeight.Bold)
+            Text(
+                "Know what's been following you.",
+                style = MaterialTheme.typography.bodyLarge,
+                color = MaterialTheme.colorScheme.onSurfaceVariant
+            )
+            Spacer(Modifier.height(36.dp))
+
+            Point(
+                Icons.Filled.Sensors,
+                "Finds what follows you",
+                "Detects AirTags, Tile, Samsung SmartTags and Find My trackers that travel with you over time — not just whatever happens to be nearby."
+            )
+            Point(
+                Icons.Filled.Lock,
+                "Stays on your phone",
+                "No account, no internet, no telemetry. Everything VIGIL learns lives on this device and never leaves it."
+            )
+            Point(
+                Icons.Filled.LocationOn,
+                "Why it needs permissions",
+                "Bluetooth to hear trackers, location to tell one is moving with you across places, and notifications to warn you. That's the whole reason it asks."
+            )
+
+            Spacer(Modifier.height(32.dp))
+            Button(onClick = onFinish, modifier = Modifier.fillMaxWidth().height(52.dp)) {
+                Text("Get started", fontWeight = FontWeight.Bold)
+            }
+            Spacer(Modifier.height(24.dp))
+        }
+    }
+}
+
+@Composable
+private fun Point(icon: ImageVector, title: String, body: String) {
+    Row(Modifier.fillMaxWidth().padding(vertical = 12.dp)) {
+        Icon(icon, null, tint = MaterialTheme.colorScheme.primary, modifier = Modifier.size(26.dp).padding(top = 2.dp))
+        Spacer(Modifier.size(16.dp))
+        Column(verticalArrangement = Arrangement.spacedBy(3.dp)) {
+            Text(title, fontWeight = FontWeight.SemiBold)
+            Text(body, style = MaterialTheme.typography.bodyMedium, color = MaterialTheme.colorScheme.onSurfaceVariant)
+        }
+    }
+}

app/src/main/kotlin/org/soulstone/vigil/ui/SafetyScreen.kt

@@ -0,0 +1,135 @@
+package org.soulstone.vigil.ui
+
+import android.content.Intent
+import android.net.Uri
+import androidx.activity.compose.BackHandler
+import androidx.compose.foundation.background
+import androidx.compose.foundation.layout.Arrangement
+import androidx.compose.foundation.layout.Box
+import androidx.compose.foundation.layout.Column
+import androidx.compose.foundation.layout.Row
+import androidx.compose.foundation.layout.Spacer
+import androidx.compose.foundation.layout.fillMaxSize
+import androidx.compose.foundation.layout.fillMaxWidth
+import androidx.compose.foundation.layout.height
+import androidx.compose.foundation.layout.padding
+import androidx.compose.foundation.layout.size
+import androidx.compose.foundation.rememberScrollState
+import androidx.compose.foundation.shape.CircleShape
+import androidx.compose.foundation.verticalScroll
+import androidx.compose.material.icons.Icons
+import androidx.compose.material.icons.filled.ArrowBack
+import androidx.compose.material.icons.filled.Call
+import androidx.compose.material.icons.filled.Chat
+import androidx.compose.material.icons.filled.OpenInNew
+import androidx.compose.material3.Button
+import androidx.compose.material3.ButtonDefaults
+import androidx.compose.material3.Card
+import androidx.compose.material3.CardDefaults
+import androidx.compose.material3.Icon
+import androidx.compose.material3.IconButton
+import androidx.compose.material3.MaterialTheme
+import androidx.compose.material3.OutlinedButton
+import androidx.compose.material3.Surface
+import androidx.compose.material3.Text
+import androidx.compose.runtime.Composable
+import androidx.compose.ui.Alignment
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.draw.clip
+import androidx.compose.ui.graphics.Color
+import androidx.compose.ui.platform.LocalContext
+import androidx.compose.ui.text.font.FontWeight
+import androidx.compose.ui.unit.dp
+import androidx.compose.ui.unit.sp
+import org.soulstone.vigil.ui.theme.VigilRed
+
+/** Survivor-centred guidance shown when a tracker may be following you. Every
+ *  action hands off to the dialer / messages / browser — VIGIL stays offline. */
+@Composable
+fun SafetyScreen(onBack: () -> Unit) {
+    BackHandler(onBack = onBack)
+    val ctx = LocalContext.current
+    fun go(intent: Intent) = runCatching { ctx.startActivity(intent) }
+
+    Surface(Modifier.fillMaxSize(), color = MaterialTheme.colorScheme.background) {
+        Column(Modifier.fillMaxSize().verticalScroll(rememberScrollState()).padding(20.dp)) {
+            Row(verticalAlignment = Alignment.CenterVertically) {
+                IconButton(onClick = onBack) { Icon(Icons.Filled.ArrowBack, "Back") }
+                Spacer(Modifier.size(4.dp))
+                Text("If a tracker is following you", style = MaterialTheme.typography.titleLarge, fontWeight = FontWeight.Bold)
+            }
+            Spacer(Modifier.height(8.dp))
+            Text(
+                "VIGIL is a detection tool, not a substitute for professional help. If you're in immediate danger, call emergency services.",
+                style = MaterialTheme.typography.bodyMedium,
+                color = MaterialTheme.colorScheme.onSurfaceVariant
+            )
+
+            Spacer(Modifier.height(20.dp))
+            Step(1, "Get somewhere safe", "If you feel in danger, head to a public place or someone you trust before doing anything else.")
+            Step(2, "Think before you remove it", "Turning a tracker off can alert whoever placed it and escalate the risk. If you might be in danger, consider documenting it and getting help first.")
+            Step(3, "Document what you can", "Save when and where it was seen (use Export), and photograph the device if you find it. A dated record helps police and advocates.")
+            Step(4, "Report it", "Contact local police — 911 if you're in immediate danger. If this involves a partner or ex, a domestic-violence advocate can help you make a safety plan.")
+
+            Spacer(Modifier.height(24.dp))
+            Text("Get help", style = MaterialTheme.typography.labelLarge, fontWeight = FontWeight.Bold, letterSpacing = 1.sp)
+
+            Spacer(Modifier.height(10.dp))
+            Button(
+                onClick = { go(Intent(Intent.ACTION_DIAL, Uri.parse("tel:911"))) },
+                modifier = Modifier.fillMaxWidth().height(50.dp),
+                colors = ButtonDefaults.buttonColors(containerColor = VigilRed, contentColor = Color(0xFF11111B))
+            ) {
+                Icon(Icons.Filled.Call, null); Spacer(Modifier.size(8.dp)); Text("Call 911 (emergency)", fontWeight = FontWeight.Bold)
+            }
+
+            Spacer(Modifier.height(10.dp))
+            Card(Modifier.fillMaxWidth(), colors = CardDefaults.cardColors(containerColor = MaterialTheme.colorScheme.surface)) {
+                Column(Modifier.padding(16.dp), verticalArrangement = Arrangement.spacedBy(10.dp)) {
+                    Text("U.S. National Domestic Violence Hotline", fontWeight = FontWeight.SemiBold)
+                    Text("Free, confidential, 24/7 — help with stalking and abuse, including safety planning.",
+                        style = MaterialTheme.typography.bodySmall, color = MaterialTheme.colorScheme.onSurfaceVariant)
+                    Row(horizontalArrangement = Arrangement.spacedBy(8.dp)) {
+                        OutlinedButton(onClick = { go(Intent(Intent.ACTION_DIAL, Uri.parse("tel:18007997233"))) }, modifier = Modifier.weight(1f)) {
+                            Icon(Icons.Filled.Call, null, modifier = Modifier.size(18.dp)); Spacer(Modifier.size(6.dp)); Text("Call")
+                        }
+                        OutlinedButton(onClick = { go(Intent(Intent.ACTION_SENDTO, Uri.parse("smsto:88788")).putExtra("sms_body", "START")) }, modifier = Modifier.weight(1f)) {
+                            Icon(Icons.Filled.Chat, null, modifier = Modifier.size(18.dp)); Spacer(Modifier.size(6.dp)); Text("Text START")
+                        }
+                    }
+                }
+            }
+
+            Spacer(Modifier.height(10.dp))
+            OutlinedButton(
+                onClick = { go(Intent(Intent.ACTION_VIEW, Uri.parse("https://www.stalkingawareness.org/help-for-victims/"))) },
+                modifier = Modifier.fillMaxWidth()
+            ) {
+                Icon(Icons.Filled.OpenInNew, null, modifier = Modifier.size(18.dp)); Spacer(Modifier.size(8.dp)); Text("Stalking help & resources (SPARC)")
+            }
+
+            Spacer(Modifier.height(16.dp))
+            Text(
+                "These open your phone, messages, or browser — VIGIL itself never connects to the internet. Resources shown are U.S.; check what's available where you are.",
+                style = MaterialTheme.typography.bodySmall,
+                color = MaterialTheme.colorScheme.onSurfaceVariant
+            )
+            Spacer(Modifier.height(24.dp))
+        }
+    }
+}
+
+@Composable
+private fun Step(n: Int, title: String, body: String) {
+    Row(Modifier.fillMaxWidth().padding(vertical = 9.dp)) {
+        Box(
+            Modifier.size(26.dp).clip(CircleShape).background(MaterialTheme.colorScheme.primary),
+            contentAlignment = Alignment.Center
+        ) { Text("$n", color = MaterialTheme.colorScheme.onPrimary, fontWeight = FontWeight.Bold, style = MaterialTheme.typography.labelMedium) }
+        Spacer(Modifier.size(14.dp))
+        Column(verticalArrangement = Arrangement.spacedBy(2.dp)) {
+            Text(title, fontWeight = FontWeight.SemiBold)
+            Text(body, style = MaterialTheme.typography.bodyMedium, color = MaterialTheme.colorScheme.onSurfaceVariant)
+        }
+    }
+}

app/src/main/res/xml/file_paths.xml

@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="utf-8"?>
+<paths>
+    <cache-path name="exports" path="exports/" />
+</paths>

docs/index.html

@@ -21,7 +21,7 @@
 <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
 <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700;800&family=JetBrains+Mono:wght@400;500;700&family=Space+Grotesk:wght@500;700&display=swap" rel="stylesheet">
 
-<link rel="stylesheet" href="style.css">
+<link rel="stylesheet" href="style.css?v=2">
 </head>
 <body>
 
@@ -40,6 +40,7 @@
     <div class="nav-links">
       <a href="#detects">What it detects</a>
       <a href="#decides">How it decides</a>
+      <a href="#screens">Screens</a>
       <a href="#clones">Clones</a>
       <a href="#download">Download</a>
       <a class="nav-github" href="https://github.com/KaraZajac/VIGIL" aria-label="GitHub">
@@ -69,7 +70,7 @@
     </p>
 
     <div class="phone-hero">
-      <img class="phone" src="img/vigil-main.png" width="1096" height="2560"
+      <img class="phone" src="img/vigil-main.png?v=2" width="1096" height="2280"
         alt="VIGIL main screen: a green &quot;You're clear — nothing has been following you&quot; card, a Stop Watching button, and a High/Medium/Low sensitivity selector." loading="eager">
     </div>
 
@@ -223,6 +224,37 @@
   </div>
 </section>
 
+<!-- ──────────────── SCREENSHOTS ──────────────── -->
+<section id="screens" class="section reveal">
+  <div class="container">
+    <div class="section-head">
+      <span class="section-tag">screenshots</span>
+      <h2>Spot it, then walk it down.</h2>
+      <p class="lead">No account, no map tiles, no cloud — it all runs on the
+      phone. See what's moving with you, wave off your own gear, and when
+      something's left over, home in on it.</p>
+    </div>
+
+    <div class="shots">
+      <figure class="shot">
+        <img class="phone" src="img/vigil-active.png" width="1096" height="2560"
+          alt="VIGIL active list: an ACTIVE (6) list of nearby Apple Find My and Google Find My Device trackers, each showing places seen, signal in dBm, time since last seen, and an It's-mine button." loading="lazy">
+        <figcaption><strong>The active list</strong>Every tracker seen moving with you — signal, places, and how long ago. Tap &ldquo;It's mine&rdquo; and your own gear drops out.</figcaption>
+      </figure>
+      <figure class="shot">
+        <img class="phone" src="img/vigil-locate.png" width="1096" height="2560"
+          alt="VIGIL locate screen for an Apple Find My tracker: a large pulsing radar icon reading Searching… walk around, no signal yet, with a Make-it-ring button." loading="lazy">
+        <figcaption><strong>Locate mode</strong>Pick a suspect and walk — the ripple strengthens as you close in. No signal yet? Keep moving.</figcaption>
+      </figure>
+      <figure class="shot">
+        <img class="phone" src="img/vigil-signal.png" width="1096" height="2560"
+          alt="VIGIL locate screen for a Google Find My Device tracker reading Close, minus 52 dBm, with a Make-it-ring button and a Ringing… listen for the tracker toast." loading="lazy">
+        <figcaption><strong>Getting warmer</strong>Live signal strength as you approach — &minus;52 dBm is close. &ldquo;Make it ring&rdquo; forces a silent tracker to give itself up.</figcaption>
+      </figure>
+    </div>
+  </div>
+</section>
+
 <!-- ──────────────── CLONES ──────────────── -->
 <section id="clones" class="section section-feature reveal">
   <div class="container">

docs/style.css

@@ -1089,3 +1089,35 @@ pre.code .prompt { color: var(--accent-hot); user-select: none; }
 /* VIGIL: logo mark in nav/footer (img instead of a glyph) */
 .nav-logo { display: inline-block; vertical-align: middle; border-radius: 7px; }
 .nav-brand .nav-logo { margin-right: 3px; }
+
+/* ============================================================
+   SCREENSHOTS GALLERY
+   ============================================================ */
+.shots {
+  display: grid;
+  grid-template-columns: repeat(3, 1fr);
+  gap: 2.6rem;
+  margin-top: 2.8rem;
+  align-items: start;
+}
+.shots .shot { margin: 0; display: flex; flex-direction: column; align-items: center; }
+.shots .phone { width: 260px; max-width: 100%; }
+.shots figcaption {
+  margin-top: 1.4rem;
+  max-width: 260px;
+  color: var(--text-muted);
+  font-size: 0.9rem;
+  line-height: 1.55;
+  text-align: center;
+}
+.shots figcaption strong {
+  display: block;
+  color: var(--text);
+  font-family: var(--display);
+  font-size: 1rem;
+  margin-bottom: 0.3rem;
+}
+@media (max-width: 820px) {
+  .shots { grid-template-columns: 1fr; gap: 3rem; }
+  .shots .phone { width: 256px; }
+}