Initial public release.

subapp-mine/README.md

@@ -0,0 +1,49 @@
+# KTag Mine Subapp
+
+A Jetpack Compose Android application that acts as a proximity-triggered "mine" for KTag laser tag devices. When an enemy device comes within range, the mine automatically tags it with configurable damage.
+
+## How It Works
+
+The Mine scans for nearby KTag devices broadcasting Status packets via BLE. When a device matching the target team enters the configured RSSI threshold, the mine:
+
+1. Triggers a "BOOM!" explosion animation with haptic feedback
+2. Broadcasts a Tag packet to damage the target device
+3. Enters a rearm countdown period
+4. Returns to armed state, ready to tag again
+
+## State Machine
+
+The mine operates using a three-state machine:
+
+| State | Description | Display |
+|-------|-------------|---------|
+| **Armed** | Ready to tag incoming devices | "ARMED" watermark |
+| **Tagging** | Explosion animation playing | BOOM! animation |
+| **Rearming** | Countdown before re-arming | Countdown number |
+
+## Settings
+
+Access settings via the gear icon in the app bar.
+
+| Setting | Description | Default |
+|---------|-------------|---------|
+| **Minimum RSSI** | Signal strength threshold for triggering (-120 = far, 0 = close) | -60 dBm |
+| **Damage Applied** | Amount of damage dealt to tagged devices | 100 |
+| **Target Team** | Which team(s) to target (Red, Blue, or All) | All |
+| **Time to Rearm** | Seconds before mine can tag again after detonation | 5 seconds |
+
+## UI Elements
+
+- **Status Bar**: Shows current target team, damage, and RSSI threshold
+- **Device List**: Displays detected KTag devices with:
+  - Device name and BLE address
+  - Current RSSI signal strength
+  - Status: IN RANGE, OUT OF RANGE, TAGGED, or TAGGED OUT
+- **Watermark**: Large centered text showing current state (ARMED or countdown)
+- **Explosion Animation**: Full-screen animation with expanding rings and "BOOM!" text
+
+## Permissions
+
+- `BLUETOOTH_SCAN` / `BLUETOOTH_CONNECT` - BLE operations
+- `ACCESS_COARSE_LOCATION` - Required for BLE scanning on older Android versions
+- `VIBRATE` - Haptic feedback on explosion