Update README.md

README.md

@@ -1,2 +1,44 @@
-# dhis2-mobile-ui
-Compose Multiplatform DHIS2 Mobile UI components library
+# DHIS2 Mobile UI
+
+> **@dhis2/dhis2-mobile-ui** is a [Compose Multiplatform](https://www.jetbrains.com/lp/compose-multiplatform/) DHIS2 design system library for [Kotlin Multiplatform](https://kotlinlang.org/docs/multiplatform.html) applications.
+
+This library currently supports **desktop** and **Android** targets, in the next versions it will support **iOS** and **web**.
+
+## Installation
+
+In the module **build.gradle.kts**:
+
+```kotlin
+dependencies {
+  implementation("org.hisp.dhis.mobile:designsystem:1.0-SNAPSHOT")
+}
+```
+
+# Usage
+
+```kotlin
+setContent {
+    DHIS2Theme {
+        // A surface container using the 'background' color from the theme
+        Surface(
+            modifier = Modifier.fillMaxSize(),
+            color = SurfaceColor.Container
+        ) {
+            Components()
+        }
+    }
+}
+```
+
+```kotlin
+Button(
+    text = provideStringResource("show_more"),
+    icon = {
+        Icon(
+            painter = provideDHIS2Icon(resourceName = "dhis2_blood_a_n_positive"),
+            contentDescription = ""
+        )
+    },
+    style = ButtonStyle.KEYBOARDKEY
+) {}
+```