Merge 5af2eef7cf into d10bb853a6

.gitignore

@@ -16,3 +16,4 @@
 local.properties
 /app/libs/yggdrasil.aar
 /app/libs/yggdrasil-sources.jar
+.idea

README.md

@@ -0,0 +1,58 @@
+# Yggdrasil Android
+
+Reference implementation for connecting to the Yggdrasil Network from Android devices
+
+# Build
+
+Download this repository and
+the [Go Yggdrasil repository](https://github.com/yggdrasil-network/yggdrasil-go).
+
+```
+git clone git@github.com:yggdrasil-network/yggdrasil-android.git
+git clone git@github.com:yggdrasil-network/yggdrasil-go.git
+
+# or
+
+git clone https://github.com/yggdrasil-network/yggdrasil-android.git
+git clone https://github.com/yggdrasil-network/yggdrasil-go.git
+```
+
+## Generate the Android artifact (.aar) from the Go repository
+
+Build the Android artifact from the `yggdrasil-go` repo.
+
+```
+# from yggdrasil-go
+./contrib/mobile/build -a
+```
+
+If you check the folder, there should now be a `yggdrasil-sources.jar` and `yggdrasil.aar` there.
+
+## Move the Android artifact to the Android repository
+
+From the Android repo, copy `yggdrasil.aar` into the `app/libs` folder.
+
+```
+# from yggdrasil-android
+cp ../yggdrasil-go/yggdrasil.aar app/libs/
+```
+
+## Build and install the Android app
+
+With your Android device connected or emulator running, build and install the app.
+
+```
+# from yggdrasil-android
+./gradlew :app:installDebug
+```
+
+# Configure
+
+## Peer
+
+Add a peer from the [public peer list](https://publicpeers.neilalexander.dev/). Make sure to change
+the "enable" toggle from off to on to make sure the peer(s) get picked up.
+
+## Explore
+
+Try out pages from the [list of services](https://yggdrasil-network.github.io/services.html).