wip: new project dir

wip: android test with README

Author: joe-p

.gitignore

@@ -1,4 +1,7 @@
 /target
+*.dylib
+*.a
+*.so
 .zed/
 .venv/
 crates/**/dist/
@@ -18,7 +21,6 @@ build/
 *.iml
 local.properties
 gradle-wrapper.jar
-*.so
 
 # Insta snapshot testing
 *.snap.new
@@ -32,4 +34,5 @@ AGENTS.md
 .opencode/
 .references/
 .kiro/
+.kotlin/
 

packages/android/algokit_transact/.gitattributes

@@ -0,0 +1,12 @@
+#
+# https://help.github.com/articles/dealing-with-line-endings/
+#
+# Linux start script should use lf
+/gradlew        text eol=lf
+
+# These are Windows script files and should use crlf
+*.bat           text eol=crlf
+
+# Binary files should be left untouched
+*.jar           binary
+

packages/android/algokit_transact/.gitignore

@@ -1,17 +1,5 @@
-*.iml
+# Ignore Gradle project-specific cache directory
 .gradle
-**/local.properties
-**/.idea/caches
-**/.idea/libraries
-**/.idea/misc.xml
-**/.idea/modules.xml
-**/.idea/workspace.xml
-**/.idea/navEditor.xml
-**/.idea/assetWizardSettings.xml
-.DS_Store
-**/build
-**/captures
-.externalNativeBuild
-.cxx
-local.properties
 
+# Ignore Gradle build output directory
+build

packages/android/algokit_transact/README.md

@@ -0,0 +1,43 @@
+# algokit_transact
+
+## Building
+
+```sh
+cargo pkg transact kt
+```
+
+## Testing
+
+### Host
+
+```sh
+./gradlew test
+```
+
+### Android
+
+First you need a connected android device. You can either use a phsyical device or start an emulator.
+
+To see available emulators:
+
+```sh
+~/Library/Android/sdk/emulator/emulator -list-avds
+```
+
+Then start the emulator:
+
+```sh
+~/Library/Android/sdk/emulator/emulator -avd <emulator_name>
+```
+
+Or to start the first one:
+
+```sh
+~/Library/Android/sdk/emulator/emulator -avd `~/Library/Android/sdk/emulator/emulator -list-avds | head -n 1`
+```
+
+Then run the tests:
+
+```sh
+./gradlew connectedAndroidTest
+```