diff --git a/README.md b/README.md
index 6903a21..12a9fd3 100644
--- a/README.md
+++ b/README.md
@@ -11,17 +11,52 @@ streaming, forward-only result sets over ClickHouse SQL.
 > [What works today](#what-works-today).
 
 ```java
-try (Connection connection = DriverManager.getConnection("jdbc:chdb::memory:");
-        PreparedStatement statement = connection.prepareStatement(
-                "SELECT count() FROM url(?, 'JSONEachRow') WHERE status = 200")) {
-    statement.setString(1, "https://example.com/logs.jsonl");
-    try (ResultSet rs = statement.executeQuery()) {
-        rs.next();
-        System.out.println(rs.getLong(1));
+import java.sql.Connection;
+import java.sql.DriverManager;
+import java.sql.ResultSet;
+import java.sql.Statement;
+
+public class Hello {
+    public static void main(String[] args) throws Exception {
+        try (Connection connection = DriverManager.getConnection("jdbc:chdb::memory:");
+                Statement statement = connection.createStatement();
+                ResultSet results = statement.executeQuery("SELECT 1")) {
+            results.next();
+            System.out.println(results.getInt(1));
+        }
     }
 }
 ```
 
+```bash
+javac Hello.java
+java -cp .:chdb-jdbc-<version>.jar:chdb-native-<your platform>-<version>.jar Hello
+```
+
+No `Class.forName`: the driver registers itself. You need the driver **and the native package
+for the platform you run on** — `chdb-native-linux-x86_64-gnu`, `chdb-native-linux-aarch64-gnu`,
+`chdb-native-macos-aarch64` or `chdb-native-macos-x86_64`. See [Installing](#installing), which
+is where those jars come from; in a Maven project, declare the native package and skip the
+classpath entirely.
+
+A query can still reach the network when you ask it to — it is the engine that is in-process,
+not the data:
+
+```java
+"SELECT count() FROM url('https://example.com/logs.jsonl', 'JSONEachRow') WHERE status = 200"
+```
+
+[`QuickStart.java`](chdb-examples/src/main/java/org/chdb/examples/QuickStart.java) is the
+longer version — parameters, types, streaming. From a source checkout it needs the native
+package built first ([Building from source](#building-from-source)):
+
+```bash
+mvn -pl chdb-jdbc compile
+scripts/build-native.sh <platform>
+mvn -pl chdb-examples -am compile
+mvn -pl chdb-examples exec:java -Dexec.mainClass=org.chdb.examples.QuickStart
+```
+
 ## Support matrix
 
 Every one of the four platforms builds, passes the full test suite on Java 11, 17, 21 and 25,