prepare library & sample modules

Author: softartdev

.gitignore

@@ -3,13 +3,12 @@
 /local.properties
 /.idea
 .DS_Store
-build/
-/captures
+build
+*/build
+captures
 .externalNativeBuild
 .cxx
-iosApp/Podfile.lock
-iosApp/Pods/*
-iosApp/iosApp.xcworkspace/*
-iosApp/iosApp.xcodeproj/*
-!iosApp/iosApp.xcodeproj/project.pbxproj
-shared/shared.podspec
+xcuserdata/
+Pods/
+*.jks
+*yarn.lock

.run/desktopApp.run.xml

@@ -0,0 +1,24 @@
+# Kronos Multiplatform Library
+
+Development in progress
+
+## Before running!
+ - check your system with (KDoctor)[https://github.com/Kotlin/kdoctor]
+ - add `local.properties` file to the project root and set a path to Android SDK there
+ - run `./gradlew podInstall` in the project root
+
+### Android
+To run the application on android device/emulator:  
+ - open project in Android Studio and run imported android run configuration
+
+To build the application bundle:
+ - run `./gradlew :composeApp:assembleDebug`
+ - find `.apk` file in `composeApp/build/outputs/apk/debug/composeApp-debug.apk`
+
+### Desktop
+Run the desktop application: `./gradlew :composeApp:run`
+
+### iOS
+To run the application on iPhone device/simulator:
+ - Open `iosApp/iosApp.xcworkspace` in Xcode and run standard configuration
+ - Or use (Kotlin Multiplatform Mobile plugin)[https://plugins.jetbrains.com/plugin/14936-kotlin-multiplatform-mobile] for Android Studio