address pr review feedback

Author: marandaneto

README.md

@@ -1,3 +1,13 @@
+[![GH Workflow](https://img.shields.io/github/actions/workflow/status/PostHog/posthog-android/build.yml?branch=main)](https://github.com/PostHog/posthog-android/actions)
+
+| Packages        | Maven Central                                                                                                                                                                                  | Min Version    |
+|-----------------| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- |
+| posthog-android | [![Maven Central](https://maven-badges.herokuapp.com/sonatype-central/com.posthog/posthog-android/badge.svg)](https://maven-badges.herokuapp.com/sonatype-central/com.posthog/posthog-android) | Android API 21 |
+| posthog-android-surveys-compose | [![Maven Central](https://maven-badges.herokuapp.com/sonatype-central/com.posthog/posthog-android-surveys-compose/badge.svg)](https://maven-badges.herokuapp.com/sonatype-central/com.posthog/posthog-android-surveys-compose) | Android API 23 · `0.x` |
+| posthog (core)  | [![Maven Central](https://maven-badges.herokuapp.com/sonatype-central/com.posthog/posthog/badge.svg)](https://maven-badges.herokuapp.com/sonatype-central/com.posthog/posthog)                 | Java 8         |
+| posthog-server  | [![Maven Central](https://maven-badges.herokuapp.com/sonatype-central/com.posthog/posthog-server/badge.svg)](https://maven-badges.herokuapp.com/sonatype-central/com.posthog/posthog-server)                 | Java 8         |
+| posthog-android-gradle-plugin  | [![Maven Central](https://maven-badges.herokuapp.com/sonatype-central/com.posthog/posthog-android-gradle-plugin/badge.svg)](https://maven-badges.herokuapp.com/sonatype-central/com.posthog/posthog-android-gradle-plugin)                 | Java 8         |
+
 # PostHog Android and JVM SDKs
 
 Please see the main [PostHog docs](https://posthog.com/docs).

posthog-samples/posthog-java-sample/README.md

@@ -7,3 +7,28 @@ SDK usage examples and code snippets live in the official documentation so they
 ## Documentation
 
 - [Java library docs](https://posthog.com/docs/libraries/java)
+
+## Local setup
+
+Copy the example properties file and add your PostHog project API key:
+
+```bash
+cp src/main/resources/application.properties.example src/main/resources/application.properties
+```
+
+```properties
+posthog.api.key=phc_your_project_api_key_here
+posthog.host=https://us.i.posthog.com
+```
+
+For local feature flag evaluation, export a personal API key:
+
+```bash
+export POSTHOG_PERSONAL_API_KEY=phx_your_personal_api_key_here
+```
+
+Run the interactive sample from the repository root:
+
+```bash
+./gradlew :posthog-samples:posthog-java-sample:run --console=plain
+```

posthog-samples/posthog-spring-sample/README.md

@@ -7,3 +7,24 @@ SDK usage examples and code snippets live in the official documentation so they
 ## Documentation
 
 - [Java library docs](https://posthog.com/docs/libraries/java)
+
+## Local setup
+
+Update `src/main/resources/application.properties` with your PostHog project API key:
+
+```properties
+posthog.api.key=phc_your_project_api_key_here
+posthog.host=https://us.i.posthog.com
+```
+
+Run the Spring Boot sample from the repository root:
+
+```bash
+./gradlew :posthog-samples:posthog-spring-sample:bootRun
+```
+
+Then trigger the sample endpoint:
+
+```bash
+curl -X POST http://localhost:8080/api/action
+```