docs: create README.md file for renderer modules

Author: GerardPaligot

docs/create-renderer.md

@@ -113,5 +113,4 @@ JsonForm(
 ```
 
 For more details, see the [API reference](api/index.html) and the source code of the 
-[Material3](../renderers/material3/) and [Cupertino](../renderers/cupertino/) renderers for 
-inspiration.
+material3 and cupertino modules.

renderers/cupertino/README.md

@@ -0,0 +1,54 @@
+# Cupertino Renderer
+
+This module provides a Cupertino-style renderer. It enables you to render dynamic forms using 
+Cupertino (Apple-like) components, fully compatible with Kotlin Multiplatform and Compose 
+Multiplatform projects.
+
+## Usage
+
+Add the dependency to your project:
+
+```kotlin
+dependencies {
+    implementation("com.paligot.jsonforms.kotlin:cupertino:<version>")
+}
+```
+
+In your Compose code, use the Cupertino renderer functions in the `JsonForm` component:
+
+```kotlin
+import com.paligot.jsonforms.cupertino.*
+
+JsonForm(
+    schema = schema,
+    uiSchema = uiSchema,
+    state = formState,
+    layoutContent = { CupertinoLayout(content = it) },
+    stringContent = { scope ->
+        CupertinoStringProperty(
+            value = formState[scope.id].value as String?,
+            error = formState.error(scope.id).value,
+            onValueChange = { formState[scope.id] = it }
+        )
+    },
+    numberContent = { scope ->
+        CupertinoNumberProperty(
+            value = formState[scope.id].value as String?,
+            error = formState.error(scope.id).value,
+            onValueChange = { formState[scope.id] = it }
+        )
+    },
+    booleanContent = { scope ->
+        CupertinoBooleanProperty(
+            value = formState[scope.id].value as Boolean? ?: false,
+            onValueChange = { formState[scope.id] = it }
+        )
+    }
+)
+```
+
+## Reference
+
+- [Usage guide](../../docs/usage.md)
+- [Custom rendering guide](../../docs/custom-rendering.md)
+- [Create a renderer guide](../../docs/create-renderer.md)

renderers/material3/README.md

@@ -0,0 +1,54 @@
+# Material3 Renderer
+
+This module provides a Material Design 3 (Material You) renderer. It enables you to render dynamic 
+forms using Material3 components, fully compatible with Kotlin Multiplatform and Compose 
+Multiplatform projects.
+
+## Usage
+
+Add the dependency to your project:
+
+```kotlin
+dependencies {
+    implementation("com.paligot.jsonforms.kotlin:material3:<version>")
+}
+```
+
+In your Compose code, use the Material3 renderer functions in the `JsonForm` component:
+
+```kotlin
+import com.paligot.jsonforms.material3.*
+
+JsonForm(
+    schema = schema,
+    uiSchema = uiSchema,
+    state = formState,
+    layoutContent = { Material3Layout(content = it) },
+    stringContent = { scope ->
+        Material3StringProperty(
+            value = formState[scope.id].value as String?,
+            error = formState.error(scope.id).value,
+            onValueChange = { formState[scope.id] = it }
+        )
+    },
+    numberContent = { scope ->
+        Material3NumberProperty(
+            value = formState[scope.id].value as String?,
+            error = formState.error(scope.id).value,
+            onValueChange = { formState[scope.id] = it }
+        )
+    },
+    booleanContent = { scope ->
+        Material3BooleanProperty(
+            value = formState[scope.id].value as Boolean? ?: false,
+            onValueChange = { formState[scope.id] = it }
+        )
+    }
+)
+```
+
+## Reference
+
+- [Usage guide](../../docs/usage.md)
+- [Custom rendering guide](../../docs/custom-rendering.md)
+- [Create a renderer guide](../../docs/create-renderer.md)