initial commit

android-app/README.md

@@ -0,0 +1,31 @@
+# clipsync Android App
+
+Android client scaffold is now initialized in this directory.
+
+## Implemented scaffold
+
+- Kotlin Android app module (`app/`)
+- Launcher activity with service controls
+- Foreground service (`SyncService`) with persistent notification
+- UDP discovery listener loop (`UdpDiscoveryListener`) on default port `45821`
+
+## Current package layout
+
+- `app/src/main/java/org/clipsync/android/`
+	- `MainActivity.kt`
+	- `service/SyncService.kt`
+	- `discovery/UdpDiscoveryListener.kt`
+
+## Build files
+
+- `settings.gradle.kts`
+- `build.gradle.kts`
+- `app/build.gradle.kts`
+
+## Next Android steps
+
+1. Parse discovery JSON and keep an in-memory peer list for UI.
+2. Add manual connect screen (`IP:port`) and connect action.
+3. Implement TCP framing + HELLO/PAIR_REQUEST flow.
+4. Add clipboard monitor/apply path.
+5. Persist paired peers in local storage.