diff --git a/.github/workflows/maven-central.yml b/.github/workflows/maven-central.yml
index 4031daaafb..31e89b6ea8 100644
--- a/.github/workflows/maven-central.yml
+++ b/.github/workflows/maven-central.yml
@@ -29,7 +29,7 @@ jobs:
         run: mvn clean install -DskipTests -q
       - name: Set up Maven Central
         uses: actions/setup-java@v4
-        with: # running setup-java again overwrites the settings.xml
+        with:
           java-version: 21
           distribution: 'temurin'
           server-id: central
@@ -44,3 +44,78 @@ jobs:
           CENTRAL_USERNAME: ${{ secrets.CENTRAL_USERNAME }}
           CENTRAL_TOKEN: ${{ secrets.CENTRAL_TOKEN }}
           MAVEN_GPG_PASSPHRASE: ${{ secrets.MAVEN_GPG_PASSPHRASE }}
+
+  update-release-notes:
+    name: Update GitHub Release Notes
+    needs: release
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Generate and Update Release Notes
+        continue-on-error: true
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          CURRENT_TAG=${{ github.ref_name }}
+          VERSION_NUM=${CURRENT_TAG#v}
+
+          # Calculate previous tag using version sorting
+          git fetch --tags --force
+          PREV_TAG=$(git tag --sort=-v:refname | grep -A 1 "^${CURRENT_TAG}$" | tail -n 1)
+
+          # Fetch milestone ID for the link
+          MILESTONE_ID=$(gh api repos/${{ github.repository }}/milestones -q ".[] | select(.title==\"$VERSION_NUM\") | .number")
+
+          # 1. Fetch NEW features (requires the 'feature' label)
+          gh issue list \
+            --repo ${{ github.repository }} \
+            --search "milestone:\"$VERSION_NUM\" label:feature" \
+            --limit 100 \
+            --json title,url \
+            --jq '.[] | "- [\(.title)](\(.url))"' > new_issues.md
+
+          # 2. Fetch OTHER changes (excludes 'feature' and 'dependencies')
+          gh issue list \
+            --repo ${{ github.repository }} \
+            --search "milestone:\"$VERSION_NUM\" -label:feature -label:dependencies" \
+            --limit 100 \
+            --json title,url \
+            --jq '.[] | "- [\(.title)](\(.url))"' > other_issues.md
+
+          # 3. Initialize the changelog file
+          > changelog.md
+
+          # 4. Conditionally add "What is new?" only if new_issues.md has content (-s)
+          if [ -s new_issues.md ]; then
+            echo "## What is new?" >> changelog.md
+            cat new_issues.md >> changelog.md
+            echo "" >> changelog.md
+          fi
+
+          # 5. Build the rest of the changelog ("Changes" is always present)
+          cat << EOF >> changelog.md
+          ## Changes
+          $(cat other_issues.md)
+
+          - [$CURRENT_TAG](https://github.com/jooby-project/jooby/tree/$CURRENT_TAG)
+          - [Issues](https://github.com/jooby-project/jooby/milestone/$MILESTONE_ID?closed=1)
+          - [Changelog](https://github.com/jooby-project/jooby/compare/$PREV_TAG...$CURRENT_TAG)
+          - [Dependencies](https://github.com/jooby-project/jooby/pulls?q=is%3Apr+label%3Adependencies+is%3Aclosed+milestone%3A$VERSION_NUM)
+
+          ## Support my work
+          - [Sponsor](https://github.com/sponsors/jknack)
+
+          ### Sponsors
+          - [@premium-minds](https://github.com/premium-minds)
+          - [@agentgt](https://github.com/agentgt)
+          - [@tipsy](https://github.com/tipsy)
+          EOF
+
+          # Overwrite the existing release notes
+          gh release edit $CURRENT_TAG --notes-file changelog.md
diff --git a/docs/asciidoc/core.adoc b/docs/asciidoc/core.adoc
index fd813fd0cf..b3c31b5a76 100644
--- a/docs/asciidoc/core.adoc
+++ b/docs/asciidoc/core.adoc
@@ -1,6 +1,6 @@
 == Core
 [.lead]
-The foundational building blocks of your Jooby application. This section covers how to bootstrap the server, manage application environments and configuration, and leverage the modular architecture that makes Jooby both lightweight and highly extensible.
+The heart of the Jooby development experience. This section defines the Request-Response Pipeline, covering everything from expressive routing and path patterns to managing the Context and crafting fluid responses. It is the essential guide to building the logic that powers your web applications.
 
 include::routing.adoc[]
 
diff --git a/docs/asciidoc/docinfo-footer.html b/docs/asciidoc/docinfo-footer.html
index 7ef6b48b49..081c2d2dd2 100644
--- a/docs/asciidoc/docinfo-footer.html
+++ b/docs/asciidoc/docinfo-footer.html
@@ -155,3 +155,31 @@
     }
   });
 </script>
+
+<script src="https://cdn.jsdelivr.net/npm/@docsearch/js@3"></script>
+
+<script>
+  document.addEventListener('DOMContentLoaded', function() {
+    // 1. Find Asciidoctor's auto-generated TOC
+    const toc = document.getElementById('toc');
+
+    if (toc) {
+      // 2. Create the search container dynamically
+      const searchContainer = document.createElement('div');
+      searchContainer.id = 'docsearch';
+
+      // 3. Inject it at the very top of the TOC, above the title
+      toc.insertBefore(searchContainer, toc.firstChild);
+
+      // 4. Initialize Algolia into that new container
+      docsearch({
+        appId: '9U2WK2CSJ7',
+        apiKey: '113e159f5c587fdac629948dd80dd993',
+        indexName: 'jooby',
+        container: '#docsearch'
+      });
+    } else {
+      console.warn("Could not find the #toc element to inject the search bar.");
+    }
+  });
+</script>
diff --git a/docs/asciidoc/docinfo.html b/docs/asciidoc/docinfo.html
index 27704b6ebf..a68b19183a 100644
--- a/docs/asciidoc/docinfo.html
+++ b/docs/asciidoc/docinfo.html
@@ -1,5 +1,7 @@
+<meta name="algolia-site-verification"  content="B92EF92B303805F4" />
 <link rel="preconnect" href="https://fonts.googleapis.com">
 <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@docsearch/css@3" />
 <link href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
 <script>
   // This MUST be in the <head>. It runs before the body is rendered, preventing the white flash.
diff --git a/docs/asciidoc/gRPC.adoc b/docs/asciidoc/gRPC.adoc
new file mode 100644
index 0000000000..3e5a1471da
--- /dev/null
+++ b/docs/asciidoc/gRPC.adoc
@@ -0,0 +1,157 @@
+==== gRPC
+
+The `jooby-grpc` module provides first-class, native support for https://grpc.io/[gRPC].
+
+Unlike traditional setups that require spinning up a separate gRPC server on a different port (often forcing a specific transport like Netty), this module embeds the `grpc-java` engine directly into Jooby.
+
+By using a custom native bridge, it allows you to run strictly-typed gRPC services alongside your standard REST API routes on the **exact same port**. It bypasses the standard HTTP/1.1 pipeline in favor of a highly optimized, native interceptor tailored for HTTP/2 multiplexing, reactive backpressure, and zero-copy byte framing. It works natively across Undertow, Netty, and Jetty.
+
+===== Usage
+
+gRPC strictly requires HTTP/2. Before installing the module, ensure your application is configured to use a supported server with HTTP/2 enabled.
+
+[source, xml, role="primary"]
+.Maven
+----
+<dependency>
+  <groupId>io.jooby</groupId>
+  <artifactId>jooby-grpc</artifactId>
+  <version>${jooby.version}</version>
+</dependency>
+----
+
+[source, gradle, role="secondary"]
+.Gradle
+----
+implementation 'io.jooby:jooby-grpc:${jooby.version}'
+----
+
+[source, java, role="primary"]
+.Java
+----
+import io.jooby.Jooby;
+import io.jooby.ServerOptions;
+import io.jooby.grpc.GrpcModule;
+
+public class App extends Jooby {
+  {
+    setServerOptions(new ServerOptions().setHttp2(true)); // <1>
+
+    install(new GrpcModule( // <2>
+        new GreeterService()
+    ));
+
+    get("/api/health", ctx -> "OK"); // <3>
+  }
+}
+----
+
+[source, kotlin, role="secondary"]
+.Kotlin
+----
+import io.jooby.ServerOptions
+import io.jooby.grpc.GrpcModule
+import io.jooby.kt.Kooby
+
+class App : Kooby({
+  serverOptions = ServerOptions().setHttp2(true) // <1>
+
+  install(GrpcModule( // <2>
+      GreeterService()
+  ))
+
+  get("/api/health") { "OK" } // <3>
+})
+----
+
+<1> Enable HTTP/2 on your server.
+<2> Install the module and explicitly register your services.
+<3> Standard REST routes still work on the exact same port!
+
+===== Dependency Injection
+
+If your gRPC services require external dependencies (like database repositories), you can register the service classes instead of pre-instantiated objects. The module will automatically provision them using your active Dependency Injection framework (e.g., Guice, Spring).
+
+[source, java, role="primary"]
+.Java
+----
+import io.jooby.Jooby;
+import io.jooby.di.GuiceModule;
+import io.jooby.grpc.GrpcModule;
+
+public class App extends Jooby {
+  {
+    install(new GuiceModule());
+
+    install(new GrpcModule(
+        GreeterService.class // <1>
+    ));
+  }
+}
+----
+
+[source, kotlin, role="secondary"]
+.Kotlin
+----
+import io.jooby.di.GuiceModule
+import io.jooby.grpc.GrpcModule
+import io.jooby.kt.Kooby
+
+class App : Kooby({
+  install(GuiceModule())
+
+  install(GrpcModule(
+      GreeterService::class.java // <1>
+  ))
+})
+----
+<1> Pass the class references. The DI framework will instantiate them.
+
+WARNING: gRPC services are registered as **Singletons**. Ensure your service implementations are thread-safe and do not hold request-scoped state in instance variables. Heavy blocking operations will safely run on background workers, protecting the native server's I/O event loops.
+
+===== Server Reflection
+
+If you want to use tools like `grpcurl` or Postman to interact with your services without providing the `.proto` files, you can easily enable gRPC Server Reflection.
+
+Include the `grpc-services` dependency in your build, and register the v1 reflection service alongside your own:
+
+[source, java, role="primary"]
+.Java
+----
+import io.grpc.protobuf.services.ProtoReflectionServiceV1;
+import io.jooby.Jooby;
+import io.jooby.grpc.GrpcModule;
+
+public class App extends Jooby {
+  {
+    install(new GrpcModule(
+        new GreeterService(),
+        ProtoReflectionServiceV1.newInstance() // <1>
+    ));
+  }
+}
+----
+
+[source, kotlin, role="secondary"]
+.Kotlin
+----
+import io.grpc.protobuf.services.ProtoReflectionServiceV1
+import io.jooby.grpc.GrpcModule
+import io.jooby.kt.Kooby
+
+class App : Kooby({
+  install(GrpcModule(
+      GreeterService(),
+      ProtoReflectionServiceV1.newInstance() // <1>
+  ))
+})
+----
+<1> Enables the modern `v1` reflection protocol for maximum compatibility with gRPC clients.
+
+===== Routing & Fallbacks
+
+The gRPC module intercepts requests natively before they reach Jooby's standard router.
+
+If a client attempts to call a gRPC method that does not exist, the request gracefully falls through to the standard Jooby router, returning a native `404 Not Found` (which gRPC clients will automatically translate to a Status `12 UNIMPLEMENTED`).
+
+If you misconfigure your server (e.g., attempting to run gRPC over HTTP/1.1), the fallback route will catch the request and throw an `IllegalStateException` to help you identify the missing configuration immediately.
diff --git a/docs/asciidoc/json-rpc.adoc b/docs/asciidoc/json-rpc.adoc
new file mode 100644
index 0000000000..c885afd392
--- /dev/null
+++ b/docs/asciidoc/json-rpc.adoc
@@ -0,0 +1,142 @@
+==== JSON-RPC
+
+Jooby provides full support for the JSON-RPC 2.0 specification, allowing you to build robust RPC APIs using standard Java and Kotlin controllers.
+
+The implementation leverages Jooby's Annotation Processing Tool (APT) to generate highly optimized, reflection-free dispatchers at compile time.
+
+===== Usage
+
+To expose a JSON-RPC endpoint, annotate your controller or service with `@JsonRpc`. You can optionally provide a namespace to the annotation, which will prefix all generated method names for that class.
+
+.JSON-RPC
+[source,java,role="primary"]
+----
+import io.jooby.rpc.jsonrpc.JsonRpc;
+
+@JsonRpc("movies")
+public class MovieService {
+
+  public Movie getById(int id) {
+    return database.stream()
+      .filter(m -> m.id() == id)
+      .findFirst()
+      .orElseThrow(() -> new NotFoundException("Movie not found: " + id));
+  }
+}
+----
+
+.Kotlin
+[source,kotlin,role="secondary"]
+----
+import io.jooby.rpc.jsonrpc.JsonRpc
+
+@JsonRpc("movies")
+class MovieService {
+
+  fun getById(id: Int): Movie {
+    return database.asSequence()
+      .filter { it.id == id }
+      .firstOrNull() ?: throw NotFoundException("Movie not found: $id")
+  }
+}
+----
+
+When the Jooby APT detects the `@JsonRpc` annotation, it generates a class ending in `Rpc_` (e.g., `MovieServiceRpc_`) that implements the `io.jooby.rpc.jsonrpc.JsonRpcService` interface.
+
+The annotation dictates how the protocol methods are named and exposed:
+
+* **Class Level:** Placing `@JsonRpc` on a class treats its public methods as JSON-RPC endpoints. An optional string value defines a namespace prefix for all methods within that class (e.g., `@JsonRpc("movies")`). If no value is provided, no namespace is applied.
+* **Method Level:** By default, the generated JSON-RPC method name is exactly the name of the Java/Kotlin method, prefixed by the class-level namespace if one is present (e.g., `movies.getById` or just `getById` if no namespace was set). You can also place `@JsonRpc("customName")` directly on specific methods to explicitly override this default naming convention.
+
+**Mixing Annotations:** You can freely mix standard REST annotations (like `@GET`, `@POST`) and `@JsonRpc` on the same class. The APT handles this by generating two entirely separate dispatchers: one standard MVC extension (e.g., `MovieService_`) and one JSON-RPC service (e.g., `MovieServiceRpc_`). They do not interfere with each other, allowing you to expose the exact same business logic over both REST and JSON-RPC simultaneously.
+
+===== Registration
+
+Register the generated `JsonRpcService` in your application using the `jsonrpc` method. You must also install a supported JSON engine.
+
+.JSON-RPC
+[source,java,role="primary"]
+----
+import io.jooby.Jooby;
+import io.jooby.jackson.JacksonModule;
+
+public class App extends Jooby {
+  {
+    install(new JacksonModule());      // <1>
+
+    jsonrpc(new MovieServiceRpc_());   // <2>
+
+    // Alternatively, you can override the default path:
+    // jsonrpc("/json-rpc", new MovieServiceRpc_());
+  }
+}
+----
+
+.Kotlin
+[source,kotlin,role="secondary"]
+----
+import io.jooby.kt.Kooby
+import io.jooby.jackson.JacksonModule
+
+class App : Kooby({
+  
+  install(JacksonModule())             // <1>
+
+  jsonrpc(MovieServiceRpc_())          // <2>
+
+  // Custom endpoint:
+  // jsonrpc("/json-rpc", MovieServiceRpc_())
+})
+----
+
+1. Install a JSON engine
+2. Register the generated JSON-RPC service
+
+===== JSON Engine Support
+
+The JSON-RPC extension delegates payload parsing and serialization to Jooby's standard JSON modules while enforcing strict JSON-RPC 2.0 compliance (such as the mutual exclusivity of `result` and `error` fields).
+
+Supported engines include:
+
+* **Jackson 2** (`JacksonModule`)
+* **Jackson 3** (`Jackson3Module`)
+* **Avaje JSON-B** (`AvajeJsonbModule`)
+
+No additional configuration is required. The generated dispatcher automatically hooks into the installed engine using the `JsonRpcParser` and `JsonRpcDecoder` interfaces, ensuring primitive types are strictly validated and parsed.
+
+===== Error Mapping
+
+Jooby seamlessly bridges standard Java application exceptions and HTTP status codes into the JSON-RPC 2.0 format using the `JsonRpcErrorCode` mapping. You do not need to throw custom protocol exceptions for standard failures.
+
+When an application exception is thrown (like a `NotFoundException` with an HTTP 404 status), the dispatcher catches it and translates it into a compliant JSON-RPC error. The standard HTTP status defines the error `code`, while the specific exception message is safely passed into the `data` field:
+
+[source,json]
+----
+{
+  "jsonrpc": "2.0",
+  "error": {
+    "code": -32004,
+    "message": "Not found",
+    "data": "Movie not found: 99"
+  },
+  "id": 1
+}
+----
+
+====== Standard Protocol Errors
+
+The engine handles core JSON-RPC 2.0 protocol errors automatically, returning HTTP 200 OK with the corresponding error payload:
+
+* `-32700`: Parse error (Malformed JSON)
+* `-32600`: Invalid Request (Missing version, ID, or malformed envelope)
+* `-32601`: Method not found
+* `-32602`: Invalid params (Missing arguments, type mismatches)
+* `-32603`: Internal error
+
+Application-defined errors map standard HTTP status codes to the `-32000` to `-32099` range (e.g., an HTTP 404 maps to `-32004`, an HTTP 401 maps to `-32001`).
+
+===== Batch Processing
+
+Batch processing is natively supported. Clients can send an array of JSON-RPC request objects, and the dispatcher will process them and return an array of corresponding response objects.
+
+In accordance with the specification, notifications (requests lacking an `id` field) are processed normally but generate no response payload, leaving no trace in the returned batch array.
diff --git a/docs/asciidoc/modules/langchain4j.adoc b/docs/asciidoc/modules/langchain4j.adoc
new file mode 100644
index 0000000000..a8a6abafdb
--- /dev/null
+++ b/docs/asciidoc/modules/langchain4j.adoc
@@ -0,0 +1,298 @@
+== LangChain4j
+
+AI and Large Language Model (LLM) integration using the https://github.com/langchain4j/langchain4j[LangChain4j] framework.
+
+This module automates the instantiation and registration of `ChatModel` and `StreamingChatModel` components based on your application configuration. It supports built-in providers (OpenAI, Anthropic, Ollama, Jlama), seamless fallback routing for high availability, and custom provider registration.
+
+=== Usage
+
+1) Add the dependency:
+
+[dependency, artifactId="jooby-langchain4j"]
+.
+
+2) Add the dependency for your chosen AI provider (e.g., OpenAI):
+
+[dependency, groupId="dev.langchain4j", artifactId="langchain4j-open-ai", version="${langchain4j.version}"]
+.
+
+3) Configure your models in `application.conf`:
+
+[source, hocon]
+----
+langchain4j {
+  models {
+    gpt-assistant {
+      provider = "openai"
+      api-key = ${OPENAI_API_KEY}
+      model-name = "gpt-4o-mini"
+      timeout = 30s
+    }
+  }
+}
+----
+
+4) Install the module and require the model:
+
+.Java
+[source, java, role="primary"]
+----
+import io.jooby.langchain4j.LangChain4jModule;
+import dev.langchain4j.model.chat.ChatModel;
+
+{
+  install(new LangChain4jModule());                                 <1>
+
+  get("/chat", ctx -> {
+    ChatModel ai = require(ChatModel.class);                        <2>
+    String prompt = ctx.query("q").value("Tell me a joke");
+    
+    return ai.chat(prompt);                                         <3>
+  });
+}
+----
+
+.Kotlin
+[source, kt, role="secondary"]
+----
+import io.jooby.langchain4j.LangChain4jModule
+import dev.langchain4j.model.chat.ChatModel
+
+{
+  install(LangChain4jModule())                                      <1>
+
+  get("/chat") {
+    val ai = require<ChatModel>()                                   <2>
+    val prompt = ctx.query("q").value("Tell me a joke")
+    
+    ai.chat(prompt)                                                 <3>
+  }
+}
+----
+
+<1> Install the LangChain4j module. It will automatically parse the configuration and build the models.
+<2> Request the default `ChatModel` from the service registry.
+<3> Execute the blocking chat request.
+
+=== Streaming Responses
+
+If your provider supports streaming, the module automatically registers a `StreamingChatModel` which pairs perfectly with Jooby's Server-Sent Events (SSE).
+
+.Java
+[source, java, role="primary"]
+----
+import dev.langchain4j.model.chat.StreamingChatModel;
+import dev.langchain4j.model.chat.response.StreamingChatResponseHandler;
+import dev.langchain4j.model.chat.response.ChatResponse;
+
+{
+  sse("/chat/stream", sse -> {
+    StreamingChatModel ai = require(StreamingChatModel.class);
+
+    ai.chat("Write a long story", new StreamingChatResponseHandler() {
+      @Override
+      public void onPartialResponse(String token) {
+        sse.send(token);                                            <1>
+      }
+
+      @Override
+      public void onCompleteResponse(ChatResponse response) {
+        sse.close();                                                <2>
+      }
+
+      @Override
+      public void onError(Throwable error) {
+        sse.send("[ERROR] " + error.getMessage());
+        sse.close();
+      }
+    });
+  });
+}
+----
+
+.Kotlin
+[source, kt, role="secondary"]
+----
+import dev.langchain4j.model.chat.StreamingChatModel
+import dev.langchain4j.model.chat.response.StreamingChatResponseHandler
+import dev.langchain4j.model.chat.response.ChatResponse
+
+{
+  sse("/chat/stream") { sse ->
+    val ai = require<StreamingChatModel>()
+
+    ai.chat("Write a long story", object : StreamingChatResponseHandler {
+      override fun onPartialResponse(token: String) {
+        sse.send(token)                                             <1>
+      }
+
+      override fun onCompleteResponse(response: ChatResponse) {
+        sse.close()                                                 <2>
+      }
+
+      override fun onError(error: Throwable) {
+        sse.send("[ERROR] ${error.message}")
+        sse.close()
+      }
+    })
+  }
+}
+----
+
+<1> Stream partial tokens back to the client as they are generated.
+<2> Close the SSE connection when the model finishes.
+
+=== Resilience & Fallbacks
+
+Network timeouts and API rate limits happen. You can configure a chain of fallbacks to ensure high availability. If the primary model fails, the module automatically routes the request to the next configured fallback.
+
+1) Configure the fallback chain in `application.conf`:
+
+[source, hocon]
+----
+langchain4j.models {
+  primary-agent {
+    provider = "openai"
+    api-key = ${OPENAI_API_KEY}
+    fallback = ["local-failover"]                                   <1>
+  }
+
+  local-failover {
+    provider = "jlama"
+    model-name = "tjake/Llama-3.2-1B-Instruct-JQ4"
+  }
+}
+----
+<1> Instructs the module to wrap `primary-agent` with a fallback decorator pointing to `local-failover`.
+
+2) Attach a listener to monitor when failovers occur:
+
+.Java
+[source, java, role="primary"]
+----
+import io.jooby.langchain4j.LangChain4jModule;
+
+{
+  install(new LangChain4jModule()
+    .failoverListener((modelName, error) -> {
+      System.err.println("Model " + modelName + " failed: " + error.getMessage());
+    })
+  );
+}
+----
+
+.Kotlin
+[source, kt, role="secondary"]
+----
+import io.jooby.langchain4j.LangChain4jModule
+
+{
+  install(LangChain4jModule()
+    .failoverListener { modelName, error -> 
+      println("Model $modelName failed: ${error.message}")
+    }
+  )
+}
+----
+
+=== Registering Custom Providers
+
+The module includes built-in support for `openai`, `anthropic`, `ollama`, and `jlama`. To add support for an unlisted provider (e.g., Google Vertex AI), you can register a custom `ChatModelFactory`.
+
+.Java
+[source, java, role="primary"]
+----
+import io.jooby.langchain4j.LangChain4jModule;
+import io.jooby.langchain4j.ChatModelFactory;
+import dev.langchain4j.model.chat.ChatModel;
+import dev.langchain4j.model.chat.StreamingChatModel;
+import com.typesafe.config.Config;
+
+{
+  install(new LangChain4jModule()
+    .register("vertex", new ChatModelFactory() {                    <1>
+      @Override
+      public ChatModel createChatModel(Config config) {
+        return VertexAiGeminiChatModel.builder()
+          .project(config.getString("project"))
+          .location(config.getString("location"))
+          .build();
+      }
+
+      @Override
+      public StreamingChatModel createStreamingModel(Config config) {
+        return VertexAiGeminiStreamingChatModel.builder()           <2>
+          .project(config.getString("project"))
+          .location(config.getString("location"))
+          .build();
+      }
+    })
+  );
+}
+----
+
+.Kotlin
+[source, kt, role="secondary"]
+----
+import io.jooby.langchain4j.LangChain4jModule
+import io.jooby.langchain4j.ChatModelFactory
+import dev.langchain4j.model.chat.ChatModel
+import dev.langchain4j.model.chat.StreamingChatModel
+import com.typesafe.config.Config
+
+{
+  install(LangChain4jModule()
+    .register("vertex", object : ChatModelFactory {                 <1>
+      override fun createChatModel(config: Config): ChatModel {
+        return VertexAiGeminiChatModel.builder()
+          .project(config.getString("project"))
+          .location(config.getString("location"))
+          .build()
+      }
+
+      override fun createStreamingModel(config: Config): StreamingChatModel {
+        return VertexAiGeminiStreamingChatModel.builder()           <2>
+          .project(config.getString("project"))
+          .location(config.getString("location"))
+          .build()
+      }
+    })
+  )
+}
+----
+<1> Register the custom provider name matching the `provider` key in your `.conf` file.
+<2> `createStreamingModel` is implemented as an optional default method in the interface. Not all providers support streaming. If your chosen provider does not support it, simply do not override this method (it returns `null` by default).
+
+==== Accessing the Concrete Implementation
+
+While you should generally interact with models via the standard `ChatModel` and `StreamingChatModel` interfaces, the module also registers the exact class implementation in Jooby's Service Registry.
+
+If you need to access provider-specific methods on the actual builder output, you can require the concrete class directly:
+
+.Java
+[source, java, role="primary"]
+----
+import dev.langchain4j.model.vertexai.VertexAiGeminiChatModel;
+
+{
+  get("/vertex-specific", ctx -> {
+    // Retrieve the exact underlying implementation
+    VertexAiGeminiChatModel gemini = require(VertexAiGeminiChatModel.class);
+    // ...
+  });
+}
+----
+
+.Kotlin
+[source, kt, role="secondary"]
+----
+import dev.langchain4j.model.vertexai.VertexAiGeminiChatModel
+
+{
+  get("/vertex-specific") {
+    // Retrieve the exact underlying implementation
+    val gemini = require<VertexAiGeminiChatModel>()
+    // ...
+  }
+}
+----
diff --git a/docs/asciidoc/modules/modules.adoc b/docs/asciidoc/modules/modules.adoc
index 8029f4b8be..3458e56617 100644
--- a/docs/asciidoc/modules/modules.adoc
+++ b/docs/asciidoc/modules/modules.adoc
@@ -6,6 +6,9 @@ Unlike other frameworks, Jooby modules **do not** create new layers of abstracti
 
 Modules are distributed as separate dependencies. Below is the catalog of officially supported Jooby modules:
 
+==== AI
+  * link:{uiVersion}/modules/langchain4j[LangChain4j]: Supercharge your Java application with the power of LLMs.
+
 ==== Cloud
   * link:{uiVersion}/modules/awssdkv2[AWS-SDK v2]: Amazon Web Service module SDK 2.
   * link:{uiVersion}/modules/aws[AWS SDK v1]: Amazon Web Service module SDK 1.
diff --git a/docs/asciidoc/rpc.adoc b/docs/asciidoc/rpc.adoc
new file mode 100644
index 0000000000..fb0a5820c3
--- /dev/null
+++ b/docs/asciidoc/rpc.adoc
@@ -0,0 +1,17 @@
+=== Remote Procedure Calls (RPC)
+
+While standard REST architectures focus on mapping HTTP methods to resources, Remote Procedure Call (RPC) architectures are designed around executing explicit actions or functions. RPC is often the preferred choice for strictly-typed client-server contracts, high-performance microservice communication, and scenarios where a strict resource-based REST model feels overly restrictive.
+
+Jooby provides first-class support for several RPC protocols. You can run any of these seamlessly alongside your standard HTTP routes on the exact same server instance, sharing the same underlying thread pools and I/O event loops.
+
+Depending on your client ecosystem and performance requirements, Jooby supports:
+
+* **gRPC**: A high-performance, strictly-typed protocol utilizing Protocol Buffers and HTTP/2 multiplexing. Ideal for backend-to-backend communication and polyglot microservices.
+* **JSON-RPC**: A lightweight, stateless, and simple JSON-encoded protocol. Excellent for rapid integrations and environments where standard JSON is preferred.
+* **tRPC**: A RPC implementation that provides end-to-end type safety directly between your Java backend and TypeScript clients, without requiring intermediate build steps or code generation.
+
+include::gRPC.adoc[]
+
+include::json-rpc.adoc[]
+
+include::tRPC.adoc[]
diff --git a/docs/asciidoc/tRPC.adoc b/docs/asciidoc/tRPC.adoc
new file mode 100644
index 0000000000..6f65633f89
--- /dev/null
+++ b/docs/asciidoc/tRPC.adoc
@@ -0,0 +1,252 @@
+==== tRPC
+
+The tRPC module provides end-to-end type safety by integrating the https://trpc.io/[tRPC] protocol directly into Jooby.
+
+Because the `io.jooby.trpc` package is included in Jooby core, there are no extra dependencies to add to your project. This integration allows you to write standard Java/Kotlin controllers and consume them directly in the browser using the official `@trpc/client`—complete with 100% type safety, autocomplete, and zero manual client generation.
+
+===== Usage
+
+Because tRPC relies heavily on JSON serialization to communicate with the frontend client, a JSON module **must** be installed prior to the `TrpcModule`.
+
+NOTE: Currently, Jooby only provides the required `TrpcParser` SPI implementation for two JSON engines: **Jackson 2/3** and **AvajeJsonbModule**. Using other JSON modules (like Gson) will result in a missing service exception at startup.
+
+.Java
+[source,java,role="primary"]
+----
+import io.jooby.Jooby;
+import io.jooby.json.JacksonModule;
+import io.jooby.rpc.trpc.TrpcModule;
+
+public class App extends Jooby {
+  {
+    install(new JacksonModule()); // <1>
+
+    install(new TrpcModule());    // <2>
+
+    install(new MovieService_()); // <3>
+  }
+}
+----
+
+.Kotlin
+[source,kotlin,role="secondary"]
+----
+import io.jooby.kt.Kooby
+import io.jooby.json.JacksonModule
+import io.jooby.rpc.trpc.TrpcModule
+
+class App : Kooby({
+  install(JacksonModule()) // <1>
+
+  install(TrpcModule())    // <2>
+
+  install(MovieService_()) // <3>
+})
+----
+
+1. Install a supported JSON engine (Jackson or Avaje)
+2. Install the tRPC extension
+3. Register your @Trpc annotated controllers (using the APT generated route)
+
+===== Writing a Service
+
+You can define your procedures using explicit tRPC annotations or a hybrid approach combining tRPC with standard HTTP methods:
+
+* **Explicit Annotations:** Use `@Trpc.Query` (maps to `GET`) and `@Trpc.Mutation` (maps to `POST`).
+* **Hybrid Annotations:** Combine the base `@Trpc` annotation with Jooby's standard HTTP annotations. A `@GET` resolves to a tRPC query, while state-changing methods (`@POST`, `@PUT`, `@DELETE`) resolve to tRPC mutations.
+
+.Java
+[source,java,role="primary"]
+----
+import io.jooby.annotation.Trpc;
+import io.jooby.annotation.DELETE;
+
+public record Movie(int id, String title, int year) {}
+
+@Trpc("movies") // Defines the 'movies' namespace
+public class MovieService {
+
+  // 1. Explicit tRPC Query
+  @Trpc.Query
+  public Movie getById(int id) {
+    return new Movie(id, "Pulp Fiction", 1994);
+  }
+
+  // 2. Explicit tRPC Mutation
+  @Trpc.Mutation
+  public Movie create(Movie movie) {
+    // Save to database logic here
+    return movie;
+  }
+
+  // 3. Hybrid Mutation
+  @Trpc
+  @DELETE
+  public void delete(int id) {
+    // Delete from database
+  }
+}
+----
+
+.Kotlin
+[source,kotlin,role="secondary"]
+----
+import io.jooby.annotation.Trpc
+import io.jooby.annotation.DELETE
+
+data class Movie(val id: Int, val title: String, val year: Int)
+
+@Trpc("movies") // Defines the 'movies' namespace
+class MovieService {
+
+  // 1. Explicit tRPC Query
+  @Trpc.Query
+  fun getById(id: Int): Movie {
+    return Movie(id, "Pulp Fiction", 1994)
+  }
+
+  // 2. Explicit tRPC Mutation
+  @Trpc.Mutation
+  fun create(movie: Movie): Movie {
+    // Save to database logic here
+    return movie
+  }
+
+  // 3. Hybrid Mutation
+  @Trpc
+  @DELETE
+  fun delete(id: Int) {
+    // Delete from database
+  }
+}
+----
+
+===== Build Configuration
+
+To generate the `trpc.d.ts` TypeScript definitions, you must configure the Jooby build plugin for your project. The generator parses your source code and emits the definitions during the compilation phase.
+
+.pom.xml
+[source,xml,role="primary",subs="verbatim,attributes"]
+----
+<plugin>
+  <groupId>io.jooby</groupId>
+  <artifactId>jooby-maven-plugin</artifactId>
+  <version>${jooby.version}</version>
+  <executions>
+    <execution>
+      <goals>
+        <goal>trpc</goal>
+      </goals>
+    </execution>
+  </executions>
+  <configuration>
+    <jsonLibrary>jackson2</jsonLibrary>
+    <outputDir>${project.build.outputDirectory}</outputDir>
+  </configuration>
+</plugin>
+----
+
+.build.gradle
+[source,groovy,role="secondary",subs="verbatim,attributes"]
+----
+plugins {
+  id 'io.jooby.trpc' version "${joobyVersion}"
+}
+
+trpc {
+  // Optional settings
+  jsonLibrary = 'jackson2'
+}
+----
+
+===== Consuming the API (Frontend)
+
+Once the project is compiled, the build plugin generates a `trpc.d.ts` file containing your exact `AppRouter` shape. You can then use the official client in your TypeScript frontend:
+
+[source,bash]
+----
+npm install @trpc/client
+----
+
+[source,typescript]
+----
+import { createTRPCProxyClient, httpLink } from '@trpc/client';
+import type { AppRouter } from './target/classes/trpc'; // Path to generated file
+
+// Initialize the strongly-typed client
+export const trpc = createTRPCProxyClient<AppRouter>({
+  links: [
+    httpLink({
+      url: 'http://localhost:8080/trpc',
+    }),
+  ],
+});
+
+// 100% Type-safe! IDEs will autocomplete namespaces, inputs, and outputs.
+const movie = await trpc.movies.getById.query(1);
+console.log(`Fetched: ${movie.title} (${movie.year})`);
+----
+
+===== Advanced Configuration
+
+====== Custom Exception Mapping
+The tRPC protocol expects specific JSON-RPC error codes (e.g., `-32600` for Bad Request). `TrpcModule` automatically registers a specialized error handler to format these errors.
+
+If you throw custom domain exceptions, you can map them directly to tRPC error codes using the service registry so the frontend client receives the correct error state:
+
+.Java
+[source,java,role="primary"]
+----
+import io.jooby.rpc.trpc.TrpcErrorCode;
+
+{
+  install(new TrpcModule());
+
+  // Map your custom business exception to a standard tRPC error code
+  getServices().mapOf(Class.class, TrpcErrorCode.class)
+    .put(IllegalArgumentException.class, TrpcErrorCode.BAD_REQUEST)
+    .put(MovieNotFoundException.class, TrpcErrorCode.NOT_FOUND);
+}
+----
+
+.Kotlin
+[source,kotlin,role="secondary"]
+----
+import io.jooby.kt.Kooby
+import io.jooby.rpc.trpc.TrpcModule
+import io.jooby.rpc.trpc.TrpcErrorCode
+
+class App : Kooby({
+  install(TrpcModule())
+
+  // Map your custom business exception to a standard tRPC error code
+  services.mapOf(Class::class.java, TrpcErrorCode::class.java)
+    .put(IllegalArgumentException::class.java, TrpcErrorCode.BAD_REQUEST)
+    .put(MovieNotFoundException::class.java, TrpcErrorCode.NOT_FOUND)
+})
+----
+
+====== Custom TypeScript Mappings
+Sometimes you have custom Java types (like `java.util.UUID` or `java.math.BigDecimal`) that you want translated into specific TypeScript primitives. You can define these overrides in your build tool:
+
+.Maven
+[source,xml,role="primary"]
+----
+<configuration>
+  <customTypeMappings>
+    <java.util.UUID>string</java.util.UUID>
+    <java.math.BigDecimal>number</java.math.BigDecimal>
+  </customTypeMappings>
+</configuration>
+----
+
+.Gradle
+[source,groovy,role="secondary"]
+----
+trpc {
+  customTypeMappings = [
+    'java.util.UUID': 'string',
+    'java.math.BigDecimal': 'number'
+  ]
+}
+----
diff --git a/docs/asciidoc/web.adoc b/docs/asciidoc/web.adoc
index 6f63aa8da1..3ea42db322 100644
--- a/docs/asciidoc/web.adoc
+++ b/docs/asciidoc/web.adoc
@@ -10,4 +10,6 @@ include::session.adoc[]
 
 include::server-sent-event.adoc[]
 
+include::rpc.adoc[]
+
 include::websocket.adoc[]
diff --git a/docs/js/styles/theme.css b/docs/js/styles/theme.css
index 0b781eb15e..3d52957fc4 100644
--- a/docs/js/styles/theme.css
+++ b/docs/js/styles/theme.css
@@ -13,13 +13,15 @@
   --bg-callout: #f3f4f6;
   --border-color: #e5e7eb;
 
-  --text-main: #374151;
+  /* Typography Colors (Adapts to Light Theme) */
+  --text-main: #334155;     /* Dark Slate */
   --text-muted: #6b7280;
+  --text-bold: #0f172a;     /* Near Black */
   --heading-color: #111827;
-  --link-color: var(--jooby-blue);
+  --link-color: #2563eb;    /* Bright Blue */
 
   /* Code Blocks */
-  --code-bg: #282c34; /* Update this to match Atom One Dark perfectly */
+  --code-bg: #282c34;
   --code-text: #ffffff;
   --code-inline-bg: #f1f5f9;
   --code-inline-text: #be185d;
@@ -29,67 +31,30 @@
   --content-max-width: 900px;
   --border-radius: 6px;
 
-  /* Modern Developer Font Stack */
+  /* Typography Stacks */
   --font-code: 'JetBrains Mono', ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace;
-  /* 1. The Modern Developer System Stack
-     This bypasses old default fonts and uses the highly-optimized UI font of whatever OS the user is on (San Francisco on Mac, Segoe UI on Windows, Roboto on Android) */
   --font-main: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Oxygen-Sans, Ubuntu, Cantarell, "Helvetica Neue", sans-serif;
 }
 
-body {
-  font-family: var(--font-main);
-  font-size: 16px; /* Ensure a solid base size */
-  line-height: 1.65; /* Gives the lines a bit more breathing room */
-
-  /* 2. Dark Mode Legibility Magic
-     These three properties stop the text from looking thin/jagged on dark backgrounds */
-  -webkit-font-smoothing: antialiased;
-  -moz-osx-font-smoothing: grayscale;
-  text-rendering: optimizeLegibility;
-
-  /* 3. A slightly crisper text color.
-     Pure white (#FFF) is too harsh, but a bright slate grey pops beautifully */
-  color: #e2e8f0;
-}
-
-/* Ensure standard paragraphs use the spacing properly */
-p {
-  margin-top: 0;
-  margin-bottom: 1.25rem;
-}
-
-/* Optional polish for your bold text to make it stand out better against the new crisp text */
-strong, b {
-  font-weight: 600;
-  color: #f8fafc; /* Slightly brighter than normal text */
-}
-
-pre.highlightjs, .highlightjs code {
-  background: var(--code-bg) !important;
-}
-
-/* Optional: Make the line under the tabs a bit softer to match the new color */
-.switch {
-  border-bottom: 1px solid rgba(255, 255, 255, 0.05);
-}
-
 html[data-theme="dark"] {
   --bg-main: #0f172a;
   --bg-surface: #1e293b;
   --bg-callout: #1e293b;
   --border-color: #334155;
 
-  --text-main: #cbd5e1;
+  /* Typography Colors (Adapts to Dark Theme) */
+  --text-main: #e2e8f0;     /* Light Slate */
   --text-muted: #94a3b8;
+  --text-bold: #f8fafc;     /* Near White */
   --heading-color: #f8fafc;
-  --link-color: #38bdf8;
+  --link-color: #60a5fa;    /* Light Blue */
 
   --code-inline-bg: #1e293b;
   --code-inline-text: #f472b6;
 }
 
 /* ==========================================================================
-   2. Base & Typography (TIGHTENED SPACING)
+   2. Base & Typography
    ========================================================================== */
 html { scroll-padding-top: 80px; }
 *, ::before, ::after { box-sizing: border-box; }
@@ -97,11 +62,14 @@ html { scroll-padding-top: 80px; }
 body {
   background: var(--bg-main);
   color: var(--text-main);
-  font-family: 'Open Sans', system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
-  line-height: 1.6;
+  font-family: var(--font-main);
+  font-size: 16px;
+  line-height: 1.65;
   margin: 0;
   padding: 0;
   -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
+  text-rendering: optimizeLegibility;
 }
 
 /* Tighter Headings */
@@ -116,33 +84,40 @@ h1, h2, h3, h4, h5, h6 {
 h1 { font-size: 2.5rem; margin-top: 1em; letter-spacing: -0.02em; }
 h2 { font-size: 1.875rem; border-bottom: 1px solid var(--border-color); padding-bottom: 0.3em; margin-top: 2em; }
 h3 { font-size: 1.5rem; }
-h4 { font-size: 1.25rem; } /* 20px */
-h5 { font-size: 1.125rem; } /* 18px - Just slightly larger than body text */
+h4 { font-size: 1.25rem; }
+h5 { font-size: 1.125rem; }
 
-/* Optional: Make h6 distinct since it's the same size as body text */
 h6 {
-  font-size: 1rem; /* 16px - Same as body */
+  font-size: 1rem;
   color: var(--text-muted);
   letter-spacing: 0.05em;
 }
 
-/* ASCIIDOCTOR FIX: Pull subheadings closer when they immediately follow a parent section */
+/* ASCIIDOCTOR FIX: Pull subheadings closer */
 .sectionbody > .sect2:first-child > h3,
 .sect2 > .sect3:first-child > h4,
 .sect3 > .sect4:first-child > h5 {
   margin-top: 0.75em;
 }
 
-p, table, blockquote { margin-top: 0; margin-bottom: 1rem; }
+p, table, blockquote { margin-top: 0; margin-bottom: 1.25rem; }
 
-a { color: var(--link-color); text-decoration: none; transition: color 0.15s ease; }
+strong, b { font-weight: 600; color: var(--text-bold); }
+
+a {
+  color: var(--link-color);
+  text-decoration: none;
+  font-weight: 500;
+  transition: color 0.15s ease;
+}
 a:hover { text-decoration: underline; color: var(--jooby-blue-hover); }
+
 hr { border: none; border-bottom: 1px solid var(--border-color); margin: 2rem 0; }
 
-/* ASCIIDOCTOR FIX: Fix bloated lists caused by <p> tags inside <li> */
+/* ASCIIDOCTOR FIX: Fix bloated lists */
 ul, ol, dl { margin-top: 0; margin-bottom: 1rem; }
 li { margin-bottom: 0.35rem; }
-.ulist li p, .olist li p, .dlist li p { margin-bottom: 0; } /* Kills the double-spacing */
+.ulist li p, .olist li p, .dlist li p { margin-bottom: 0; }
 
 /* ==========================================================================
    3. Main Content Layout
@@ -234,7 +209,6 @@ html[data-theme="dark"] #toc::-webkit-scrollbar-thumb:hover { background: #64748
    ========================================================================== */
 .admonitionblock { margin-bottom: 1.5rem; }
 
-/* Override Asciidoctor's rigid table layout with modern Flexbox */
 .admonitionblock > table,
 .admonitionblock > table > tbody,
 .admonitionblock > table > tbody > tr {
@@ -250,7 +224,6 @@ html[data-theme="dark"] #toc::-webkit-scrollbar-thumb:hover { background: #64748
   padding: 1.25rem;
 }
 
-/* Style the Left Column (Label & Icon) */
 .admonitionblock td.icon {
   border: none;
   padding: 0;
@@ -260,7 +233,6 @@ html[data-theme="dark"] #toc::-webkit-scrollbar-thumb:hover { background: #64748
   align-items: flex-start;
 }
 
-/* The Text "Note", "Tip", etc. */
 .admonitionblock td.icon .title {
   font-weight: 700;
   text-transform: uppercase;
@@ -272,7 +244,6 @@ html[data-theme="dark"] #toc::-webkit-scrollbar-thumb:hover { background: #64748
   gap: 0.5rem;
 }
 
-/* Style the Main Content */
 .admonitionblock td.content {
   border: none;
   padding: 0;
@@ -283,51 +254,26 @@ html[data-theme="dark"] #toc::-webkit-scrollbar-thumb:hover { background: #64748
 
 .admonitionblock td.content p:last-child { margin-bottom: 0; }
 
-/* --- Color Variants & Zero-Dependency CSS Icons --- */
+/* Variants */
+.admonitionblock.note { --admonition-color: var(--jooby-blue); --admonition-bg: rgba(33, 150, 243, 0.05); }
+.admonitionblock.note td.icon .title::before { content: url('data:image/svg+xml;utf8,<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="%232196f3" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="10"></circle><line x1="12" y1="16" x2="12" y2="12"></line><line x1="12" y1="8" x2="12.01" y2="8"></line></svg>'); display: block; width: 16px; height: 16px; }
 
-/* NOTE (Blue) */
-.admonitionblock.note {
-  --admonition-color: var(--jooby-blue);
-  --admonition-bg: rgba(33, 150, 243, 0.05); /* Subtle 5% tint */
-}
-.admonitionblock.note td.icon .title::before {
-  content: url('data:image/svg+xml;utf8,<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="%232196f3" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="10"></circle><line x1="12" y1="16" x2="12" y2="12"></line><line x1="12" y1="8" x2="12.01" y2="8"></line></svg>');
-  display: block; width: 16px; height: 16px;
-}
+.admonitionblock.tip { --admonition-color: #10b981; --admonition-bg: rgba(16, 185, 129, 0.05); }
+.admonitionblock.tip td.icon .title::before { content: url('data:image/svg+xml;utf8,<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="%2310b981" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round"><polygon points="13 2 3 14 12 14 11 22 21 10 12 10 13 2"></polygon></svg>'); display: block; width: 16px; height: 16px; }
 
-/* TIP (Green) */
-.admonitionblock.tip {
-  --admonition-color: #10b981;
-  --admonition-bg: rgba(16, 185, 129, 0.05);
-}
-.admonitionblock.tip td.icon .title::before {
-  content: url('data:image/svg+xml;utf8,<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="%2310b981" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round"><polygon points="13 2 3 14 12 14 11 22 21 10 12 10 13 2"></polygon></svg>');
-  display: block; width: 16px; height: 16px;
-}
+.admonitionblock.warning { --admonition-color: #f59e0b; --admonition-bg: rgba(245, 158, 11, 0.05); }
+.admonitionblock.warning td.icon .title::before { content: url('data:image/svg+xml;utf8,<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="%23f59e0b" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round"><path d="M10.29 3.86L1.82 18a2 2 0 0 0 1.71 3h16.94a2 2 0 0 0 1.71-3L13.71 3.86a2 2 0 0 0-3.42 0z"></path><line x1="12" y1="9" x2="12" y2="13"></line><line x1="12" y1="17" x2="12.01" y2="17"></line></svg>'); display: block; width: 16px; height: 16px; }
 
-/* WARNING (Orange/Yellow) */
-.admonitionblock.warning {
-  --admonition-color: #f59e0b;
-  --admonition-bg: rgba(245, 158, 11, 0.05);
-}
-.admonitionblock.warning td.icon .title::before {
-  content: url('data:image/svg+xml;utf8,<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="%23f59e0b" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round"><path d="M10.29 3.86L1.82 18a2 2 0 0 0 1.71 3h16.94a2 2 0 0 0 1.71-3L13.71 3.86a2 2 0 0 0-3.42 0z"></path><line x1="12" y1="9" x2="12" y2="13"></line><line x1="12" y1="17" x2="12.01" y2="17"></line></svg>');
-  display: block; width: 16px; height: 16px;
-}
-
-/* IMPORTANT (Red) */
-.admonitionblock.important {
-  --admonition-color: #ef4444;
-  --admonition-bg: rgba(239, 68, 68, 0.05);
-}
-.admonitionblock.important td.icon .title::before {
-  content: url('data:image/svg+xml;utf8,<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="%23ef4444" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="10"></circle><line x1="12" y1="8" x2="12" y2="12"></line><line x1="12" y1="16" x2="12.01" y2="16"></line></svg>');
-  display: block; width: 16px; height: 16px;
-}
+.admonitionblock.important { --admonition-color: #ef4444; --admonition-bg: rgba(239, 68, 68, 0.05); }
+.admonitionblock.important td.icon .title::before { content: url('data:image/svg+xml;utf8,<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="%23ef4444" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="10"></circle><line x1="12" y1="8" x2="12" y2="12"></line><line x1="12" y1="16" x2="12.01" y2="16"></line></svg>'); display: block; width: 16px; height: 16px; }
 
 /* ==========================================================================
    6. Code Blocks & Inline Code
    ========================================================================== */
+pre.highlightjs, .highlightjs code {
+  background: var(--code-bg) !important;
+}
+
 pre {
   position: relative;
   background: var(--code-bg);
@@ -335,19 +281,15 @@ pre {
   padding: 1rem 1.25rem;
   border-radius: var(--border-radius);
   overflow-x: auto;
-
-  /* Use the new font */
   font-family: var(--font-code);
   font-size: 0.85rem;
   font-weight: 400;
-  line-height: 1.6; /* Slightly increased for better code readability */
-  letter-spacing: -0.01em; /* Crisp rendering */
-
+  line-height: 1.6;
+  letter-spacing: -0.01em;
   margin-top: 0;
   margin-bottom: 1rem;
 }
 
-/* Also update your inline code blocks */
 :not(pre) > code {
   font-family: var(--font-code);
 }
@@ -359,25 +301,20 @@ pre code, pre .hljs {
   font-size: inherit;
 }
 
-/* ==========================================================================
-   6. Code Blocks & Inline Code
-   ========================================================================== */
-
-/* 1. Style the Title as a Mac/IDE File Tab */
+/* Style the Title as a Mac/IDE File Tab */
 .listingblock .title {
-  background-color: #21252b; /* Slightly darker than the code background */
-  color: #abb2bf; /* Muted terminal gray */
+  background-color: #21252b;
+  color: #abb2bf;
   font-family: var(--font-code);
   font-size: 0.78rem;
   padding: 0.5rem 1.25rem;
-  margin-bottom: 0; /* Connects it to the block below */
+  margin-bottom: 0;
   border-top-left-radius: var(--border-radius);
   border-top-right-radius: var(--border-radius);
   border-bottom: 1px solid rgba(0, 0, 0, 0.4);
   display: block;
 }
 
-/* 2. Remove the top rounded corners of the code block so it attaches perfectly */
 .listingblock .title + .content pre {
   border-top-left-radius: 0;
   border-top-right-radius: 0;
@@ -395,7 +332,7 @@ pre code, pre .hljs {
   background-color: var(--code-bg);
   border-radius: var(--border-radius) var(--border-radius) 0 0;
   overflow: hidden;
-  border-bottom: 1px solid #444;
+  border-bottom: 1px solid rgba(255, 255, 255, 0.05);
   margin-bottom: 0;
 }
 
@@ -483,15 +420,9 @@ html[data-theme="dark"] .theme-toggle .sun-icon { display: none; }
 /* ==========================================================================
    9. Header Anchor Links (Deep Linking)
    ========================================================================== */
-h2, h3, h4, h5, h6 {
-  position: relative;
-}
+h2, h3, h4, h5, h6 { position: relative; }
 
-h2 > a.anchor,
-h3 > a.anchor,
-h4 > a.anchor,
-h5 > a.anchor,
-h6 > a.anchor {
+h2 > a.anchor, h3 > a.anchor, h4 > a.anchor, h5 > a.anchor, h6 > a.anchor {
   position: absolute;
   left: -1.5rem;
   top: 0;
@@ -502,29 +433,16 @@ h6 > a.anchor {
   font-weight: 400;
 }
 
-h2 > a.anchor::before,
-h3 > a.anchor::before,
-h4 > a.anchor::before,
-h5 > a.anchor::before,
-h6 > a.anchor::before {
-  content: "#"; /* Modern hash symbol instead of the old section mark */
+h2 > a.anchor::before, h3 > a.anchor::before, h4 > a.anchor::before, h5 > a.anchor::before, h6 > a.anchor::before {
+  content: "#";
 }
 
-/* Show the anchor on hover */
-h2:hover > a.anchor,
-h3:hover > a.anchor,
-h4:hover > a.anchor,
-h5:hover > a.anchor,
-h6:hover > a.anchor {
-  opacity: 1;
-}
+h2:hover > a.anchor, h3:hover > a.anchor, h4:hover > a.anchor, h5:hover > a.anchor, h6:hover > a.anchor { opacity: 1; }
+h2 > a.anchor:hover, h3 > a.anchor:hover, h4 > a.anchor:hover, h5 > a.anchor:hover, h6 > a.anchor:hover { color: var(--jooby-blue); }
 
-h2 > a.anchor:hover,
-h3 > a.anchor:hover,
-h4 > a.anchor:hover,
-h5 > a.anchor:hover,
-h6 > a.anchor:hover {
-  color: var(--jooby-blue);
+h2 > a.anchor.copied::before, h3 > a.anchor.copied::before, h4 > a.anchor.copied::before,
+h5 > a.anchor.copied::before, h6 > a.anchor.copied::before {
+  content: "✓"; color: #10b981;
 }
 
 /* ==========================================================================
@@ -536,7 +454,6 @@ h6 > a.anchor:hover {
   letter-spacing: -0.03em;
   margin-top: 0;
   margin-bottom: 1rem;
-  /* Optional: A subtle gradient using Jooby's blue to accent */
   background: linear-gradient(135deg, var(--jooby-blue) 0%, #8b5cf6 100%);
   -webkit-background-clip: text;
   -webkit-text-fill-color: transparent;
@@ -551,50 +468,8 @@ h6 > a.anchor:hover {
 }
 
 /* ==========================================================================
-   12. Print Styles (For "Save to PDF")
+   11. Miscellaneous Badges
    ========================================================================== */
-@media print {
-  /* Force light theme for printing */
-  :root {
-    --bg-main: #ffffff !important;
-    --text-main: #000000 !important;
-    --heading-color: #000000 !important;
-  }
-
-  body {
-    background: white !important;
-    color: black !important;
-    font-size: 11pt; /* Better for paper */
-  }
-
-  /* Hide UI elements */
-  #toc, .theme-toggle, .clipboard, .version-selector, .switch {
-    display: none !important;
-  }
-
-  /* Reset layout constraints */
-  body.toc2, #content, #header, #footer {
-    padding: 0 !important;
-    margin: 0 !important;
-    max-width: 100% !important;
-  }
-
-  /* Prevent awkward page breaks */
-  h2, h3, h4, h5 { page-break-after: avoid; }
-  pre, blockquote, table, img { page-break-inside: avoid; }
-
-  /* Show link URLs explicitly on paper */
-  #content a::after {
-    content: " (" attr(href) ")";
-    font-size: 0.85em;
-    color: #666;
-  }
-  /* Don't print URLs for internal anchor links */
-  #content a[href^="#"]::after {
-    content: "";
-  }
-}
-
 .badge {
   display: inline-block;
   padding: 0.15em 0.5em;
@@ -612,76 +487,11 @@ h6 > a.anchor:hover {
 .badge.new { background: #10b981; color: #fff; }
 
 /* ==========================================================================
-   13. Callouts (Code Pointers)
-   ========================================================================== */
-
-/* 1. The badge INSIDE the code block (created via JavaScript) */
-.conum-badge {
-  display: inline-flex;
-  align-items: center;
-  justify-content: center;
-  width: 1.5rem;
-  height: 1.5rem;
-  border-radius: 50%;
-  background-color: var(--code-inline-text); /* The Pink/Red */
-  color: #ffffff;
-  font-size: 0.85rem;
-  font-weight: 700;
-  font-style: normal;
-}
-
-/* 2. The list BELOW the code block */
-.colist {
-  margin-top: 1rem;
-  margin-bottom: 1.5rem;
-}
-
-.colist table { border: none !important; background: transparent !important; margin: 0 !important;}
-.colist tr { background: transparent !important; }
-.colist td { border: none !important; padding: 0.4rem 0.5rem !important; vertical-align: top !important; color: var(--text-main); }
-.colist td:first-child { padding-left: 0 !important; width: 2.5rem !important; }
-
-/* The dark circle in the list below the code block */
-.colist .conum {
-  display: inline-flex !important;
-  align-items: center;
-  justify-content: center;
-  width: 1.5rem !important;
-  height: 1.5rem !important;
-  border-radius: 50% !important;
-  background-color: var(--text-main) !important;
-  color: var(--bg-main) !important;
-  font-size: 0.85rem !important;
-  font-weight: 700 !important;
-  font-style: normal !important;
-  position: relative;
-}
-
-/* Hide fallback text Asciidoctor injects */
-.colist i.conum[data-value] { color: transparent !important; }
-.colist i.conum[data-value]::after {
-  content: attr(data-value);
-  color: var(--bg-main) !important;
-  position: absolute;
-  top: 50%; left: 50%;
-  transform: translate(-50%, -50%);
-}
-.colist .conum + b { display: none !important; }
-
-/* ==========================================================================
-   13. Callouts (Code Pointers & Lists)
+   12. Callouts (Code Pointers & Lists)
    ========================================================================== */
+pre.highlightjs code { opacity: 0; transition: opacity 0.05s ease-out; }
+pre.highlightjs.badges-loaded code { opacity: 1; }
 
-/* 1. Prevent the Flash: Keep background solid, micro-fade the text only */
-pre.highlightjs code {
-  opacity: 0;
-  transition: opacity 0.05s ease-out;
-}
-pre.highlightjs.badges-loaded code {
-  opacity: 1;
-}
-
-/* 2. The Pink Badge INSIDE the code block */
 .conum-badge {
   display: inline-flex;
   align-items: center;
@@ -697,7 +507,6 @@ pre.highlightjs.badges-loaded code {
   flex-shrink: 0;
 }
 
-/* 3. The List BELOW the code block */
 .colist.arabic ol {
   list-style: none !important;
   padding-left: 0;
@@ -709,12 +518,10 @@ pre.highlightjs.badges-loaded code {
   margin-bottom: 1.25rem;
   counter-increment: colist-counter;
   position: relative;
-  /* This creates a "gutter" for the badge */
   padding-left: 2.5rem;
   min-height: 1.5rem;
 }
 
-/* Draws the Dark Badge */
 .colist.arabic li::before {
   content: counter(colist-counter);
   position: absolute;
@@ -732,40 +539,13 @@ pre.highlightjs.badges-loaded code {
   font-weight: 700;
 }
 
-/* Ensures all nested content (paragraphs, ulist, etc.) aligns to the right of the badge */
-.colist.arabic li > *:first-child {
-  display: block;
-  margin-top: 0;
-}
+.colist.arabic li > *:first-child { display: block; margin-top: 0; }
+.colist.arabic li p { margin-bottom: 0.5rem; line-height: 1.5rem; }
 
-.colist.arabic li p {
-  margin-bottom: 0.5rem;
-  line-height: 1.5rem;
-}
-
-/* Nested Bullet Lists */
-.colist.arabic li .ulist {
-  margin-top: 0.5rem;
-  margin-bottom: 0.5rem;
-}
-
-.colist.arabic li .ulist ul {
-  list-style: disc;
-  padding-left: 1.25rem; /* Standard bullet indentation */
-  margin: 0;
-}
-
-.colist.arabic li .ulist li {
-  padding-left: 0; /* Reset the callout padding for nested bullets */
-  margin-bottom: 0.25rem;
-  counter-increment: none;
-}
-
-.colist.arabic li .ulist li::before {
-  content: none; /* No badges on nested bullets */
-}
-
-/* --- Utilities --- */
+.colist.arabic li .ulist { margin-top: 0.5rem; margin-bottom: 0.5rem; }
+.colist.arabic li .ulist ul { list-style: disc; padding-left: 1.25rem; margin: 0; }
+.colist.arabic li .ulist li { padding-left: 0; margin-bottom: 0.25rem; counter-increment: none; }
+.colist.arabic li .ulist li::before { content: none; }
 
 .visually-hidden {
   position: absolute !important; width: 1px !important; height: 1px !important;
@@ -773,18 +553,11 @@ pre.highlightjs.badges-loaded code {
   clip: rect(0, 0, 0, 0) !important; white-space: nowrap !important; border: 0 !important;
 }
 
-h2 > a.anchor.copied::before, h3 > a.anchor.copied::before, h4 > a.anchor.copied::before,
-h5 > a.anchor.copied::before, h6 > a.anchor.copied::before {
-  content: "✓"; color: #10b981;
-}
-
 /* ==========================================================================
-   14. Tables
+   13. Tables
    ========================================================================== */
-
 table.tableblock {
   width: 100%;
-  /* Switch back to fixed to strictly honor [cols="1,1,4"] */
   table-layout: fixed !important;
   border-collapse: separate;
   border-spacing: 0;
@@ -794,9 +567,7 @@ table.tableblock {
   overflow: hidden;
 }
 
-/* 1. Reset all columns to allow wrapping by default */
-table.tableblock td,
-table.tableblock th {
+table.tableblock td, table.tableblock th {
   padding: 0.75rem 1.25rem;
   border-bottom: 1px solid var(--border-color);
   font-size: 0.9rem;
@@ -807,120 +578,53 @@ table.tableblock th {
   overflow-wrap: anywhere;
 }
 
-/* 2. Header Polish */
 table.tableblock thead th {
   background-color: var(--bg-surface);
   font-weight: 600;
   border-bottom: 2px solid var(--border-color);
   color: var(--heading-color);
-  white-space: nowrap; /* Keep headers clean on one line */
+  white-space: nowrap;
 }
 
-/* 3. Smart First Column Handling
-   If you have NOT defined specific columns, we force it to fit.
-   If you HAVE defined [cols], we let it wrap to fit your proportions. */
 table.tableblock:not(:has(colgroup col[style*="width"])) td:first-child {
   white-space: nowrap;
-  width: 1%; /* Shrink-wrap effect */
-}
-
-/* 4. Column Spacing & Visuals */
-table.tableblock td:first-child {
-  font-weight: 500;
-  color: var(--heading-color);
-}
-
-/* Ensure code blocks inside tables don't have extra margins */
-table.tableblock td p {
-  margin: 0;
-}
-table.tableblock td p + p {
-  margin-top: 0.5rem;
+  width: 1%;
 }
 
+table.tableblock td:first-child { font-weight: 500; color: var(--heading-color); }
+table.tableblock td p { margin: 0; }
+table.tableblock td p + p { margin-top: 0.5rem; }
 table.tableblock tbody tr:hover { background-color: var(--bg-callout); }
 table.tableblock tbody tr:last-child td { border-bottom: none; }
 
 /* ==========================================================================
-   15. Keyboard Shortcuts (kbd)
+   14. Keyboard Shortcuts (kbd)
    ========================================================================== */
 kbd {
   display: inline-block;
   padding: 0.1rem 0.4rem;
-  font-family: var(--font-code); /* Uses JetBrains Mono for that tech feel */
+  font-family: var(--font-code);
   font-size: 0.8rem;
   font-weight: 500;
   color: var(--text-main);
   background-color: var(--bg-surface);
-  /* The "3D" Key Effect */
   border: 1px solid var(--border-color);
   border-radius: 4px;
-  box-shadow:
-      0 1px 0 rgba(0, 0, 0, 0.2),
-      inset 0 0 0 2px var(--bg-main);
+  box-shadow: 0 1px 0 rgba(0, 0, 0, 0.2), inset 0 0 0 2px var(--bg-main);
   margin: 0 0.15rem;
   vertical-align: middle;
   line-height: 1.2;
 }
 
 /* ==========================================================================
-   16. Responsive / Mobile Adjustments
+   15. Responsive / Mobile Adjustments
    ========================================================================== */
 
-@media screen and (max-width: 768px) {
-  /* 1. Create a top bar so the button isn't just floating over text */
-  #header {
-    padding-top: 4rem !important; /* Push content down to clear the bar */
-  }
-
-  .mobile-nav-bar {
-    display: flex;
-    align-items: center;
-    justify-content: space-between;
-    position: fixed;
-    top: 0;
-    left: 0;
-    width: 100%;
-    height: 3.5rem;
-    background-color: var(--bg-main);
-    border-bottom: 1px solid var(--border-color);
-    padding: 0 1.5rem;
-    z-index: 10001; /* Higher than the sidebar */
-  }
-
-  /* 2. Reposition the button inside the new bar */
-  #menu-toggle {
-    position: static !important; /* Remove the fixed positioning from before */
-    margin-left: auto;
-  }
-}
-
-@media screen and (max-width: 768px) {
-  /* 1. Make tables scrollable horizontally without breaking the page */
-  .tableblock {
-    display: block;
-    width: 100%;
-    overflow-x: auto;
-    -webkit-overflow-scrolling: touch; /* Smooth scrolling on iOS */
-  }
-
-  /* 2. Prevent the "First Column" from taking up too much room on mobile */
-  table.tableblock td:first-child {
-    white-space: normal !important; /* Allow wrapping on small screens */
-    min-width: 120px;
-  }
-
-  /* 3. Slightly reduce padding to save precious horizontal space */
-  table.tableblock th,
-  table.tableblock td {
-    padding: 0.5rem 0.75rem !important;
-    font-size: 0.85rem;
-  }
-}
+/* Hidden elements on Desktop */
+.mobile-nav-bar { display: none; }
 
-/* Hamburger Button Styling */
 .hamburger {
-  display: none; /* Hidden by default on Desktop */
+  display: none;
   flex-direction: column;
   justify-content: space-around;
   width: 2rem;
@@ -941,130 +645,159 @@ kbd {
 }
 
 /* Animate Hamburger to X */
-.hamburger.open span:nth-child(1) {
-  transform: rotate(45deg) translate(5px, 5px);
-}
-.hamburger.open span:nth-child(2) {
-  opacity: 0;
-}
-.hamburger.open span:nth-child(3) {
-  transform: rotate(-45deg) translate(7px, -6px);
-}
+.hamburger.open span:nth-child(1) { transform: rotate(45deg) translate(5px, 5px); }
+.hamburger.open span:nth-child(2) { opacity: 0; }
+.hamburger.open span:nth-child(3) { transform: rotate(-45deg) translate(7px, -6px); }
 
 @media screen and (max-width: 768px) {
-  /* 1. Force the navigation to be a fixed mobile drawer */
+  /* Mobile Header Top Bar */
+  #header { padding-top: 4rem !important; }
+
+  .mobile-nav-bar {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    position: fixed;
+    top: 0;
+    left: 0;
+    width: 100%;
+    height: 3.5rem;
+    background-color: var(--bg-main);
+    border-bottom: 1px solid var(--border-color);
+    padding: 0 1.5rem;
+    z-index: 10001;
+  }
+
+  .hamburger { display: flex; }
+  #menu-toggle { position: static !important; margin-left: auto; }
+
+  /* Slide-out Sidebar Menu */
   #toc, .nav-container, #sidebar {
     position: fixed !important;
     top: 0 !important;
-    left: -100% !important; /* Start off-screen */
-    width: 80% !important; /* Take up most of the screen */
+    left: -100% !important;
+    width: 80% !important;
     max-width: 300px !important;
     height: 100vh !important;
-    background-color: var(--bg-main) !important; /* Ensure it's not transparent */
-    z-index: 9999 !important; /* Sit on top of everything */
+    background-color: var(--bg-main) !important;
+    z-index: 9999 !important;
     transition: left 0.3s ease-in-out !important;
-    display: block !important; /* Ensure it's not hidden with display:none */
+    display: block !important;
     box-shadow: 5px 0 15px rgba(0,0,0,0.5);
-    padding: 2rem 1rem !important;
+    padding: 4rem 1rem 2rem 1rem !important; /* Spaced to clear nav bar */
     overflow-y: auto !important;
   }
 
-  /* 2. Slide in when the 'active' class is applied */
-  #toc.active, .nav-container.active, #sidebar.active {
-    left: 0 !important;
-  }
-
-  /* 3. Ensure the hamburger button stays visible and on top */
-  #menu-toggle {
-    display: flex !important;
-    position: fixed !important;
-    top: 1rem;
-    right: 1rem;
-    z-index: 10000 !important;
-    background: var(--bg-surface);
-    padding: 5px;
-    border-radius: var(--border-radius);
-  }
-}
-
-@media screen and (max-width: 768px) {
-  .hamburger {
-    display: flex; /* Show on Mobile */
-    position: fixed;
-    top: 1rem;
-    right: 1rem;
-  }
+  #toc.active, .nav-container.active, #sidebar.active { left: 0 !important; }
 
-  /* Target your specific sidebar class (usually .nav-container or #toc) */
-  #sidebar, .nav-container {
-    position: fixed;
-    top: 0;
-    left: -100%; /* Hide off-screen */
-    width: 280px;
-    height: 100vh;
-    background: var(--bg-main);
-    transition: left 0.3s ease-in-out;
-    z-index: 1000;
-    box-shadow: 2px 0 10px rgba(0,0,0,0.3);
-  }
-
-  /* When the 'active' class is added via JS, slide it in */
-  #sidebar.active, .nav-container.active {
-    left: 0;
+  /* Mobile Tables */
+  .tableblock {
+    display: block;
+    width: 100%;
+    overflow-x: auto;
+    -webkit-overflow-scrolling: touch;
   }
+  table.tableblock td:first-child { white-space: normal !important; min-width: 120px; }
+  table.tableblock th, table.tableblock td { padding: 0.5rem 0.75rem !important; font-size: 0.85rem; }
 }
 
 /* ==========================================================================
-   17. Print Styles (Ink-Friendly PDF)
+   16. Print Styles (Ink-Friendly PDF)
    ========================================================================== */
-
 @media print {
-  /* 1. Force a clean white background and black text for legibility */
-  body {
-    background: white !important;
-    color: black !important;
-    font-size: 11pt;
-  }
-
-  /* 2. Remove the sidebar, header, and footer to focus on the content */
-  #header, #footer, #sidebar, .nav-container, .edit-link {
-    display: none !important;
-  }
+  body { background: white !important; color: black !important; font-size: 11pt; }
+  #header, #footer, #sidebar, .nav-container, .edit-link, .mobile-nav-bar, .theme-toggle, .clipboard, .switch { display: none !important; }
+  #content { width: 100% !important; margin: 0 !important; padding: 0 !important; }
+  body.toc2, #header, #footer { padding: 0 !important; max-width: 100% !important; }
 
-  #content {
-    width: 100% !important;
-    margin: 0 !important;
-    padding: 0 !important;
-  }
-
-  /* 3. Convert Code Blocks to a light theme for the printer */
   pre {
     background: #f5f5f5 !important;
     color: #333 !important;
     border: 1px solid #ddd !important;
-    page-break-inside: avoid; /* Prevents code from splitting across pages */
+    page-break-inside: avoid;
   }
+  pre code { color: #333 !important; }
 
-  pre code {
-    color: #333 !important;
-  }
+  table.tableblock { border: 1px solid #999 !important; page-break-inside: auto; }
+  tr { page-break-inside: avoid; page-break-after: auto; }
+  h2, h3, h4, h5 { page-break-after: avoid; }
+  pre, blockquote, img { page-break-inside: avoid; }
 
-  /* 4. Ensure Tables expand and borders are visible */
-  table.tableblock {
-    border: 1px solid #999 !important;
-    page-break-inside: auto;
-  }
+  a[href^="http"]:after { content: " (" attr(href) ")"; font-size: 90%; color: #666; }
+  #content a[href^="#"]::after { content: ""; }
+}
 
-  tr {
-    page-break-inside: avoid;
-    page-break-after: auto;
-  }
+/* ==========================================================================
+   18. Algolia DocSearch Overrides
+   ========================================================================== */
 
-  /* 5. Show the actual URL next to links (useful for paper) */
-  a[href^="http"]:after {
-    content: " (" attr(href) ")";
-    font-size: 90%;
-    color: #666;
-  }
+/* Light Theme (Default) */
+:root {
+  --docsearch-primary-color: var(--jooby-blue);
+  --docsearch-highlight-color: var(--jooby-blue);
+  --docsearch-text-color: var(--text-main);
+  --docsearch-muted-color: var(--text-muted);
+  --docsearch-searchbox-shadow: inset 0 0 0 2px var(--jooby-blue);
+  --docsearch-searchbox-focus-background: var(--bg-main);
+}
+
+/* Dark Theme Overrides */
+html[data-theme="dark"] {
+  --docsearch-text-color: var(--text-main);
+  --docsearch-container-background: rgba(15, 23, 42, 0.85); /* Slightly darker backdrop */
+  --docsearch-modal-background: var(--bg-surface);
+  --docsearch-modal-shadow: inset 1px 1px 0 0 #334155, 0 8px 24px 0 rgba(0,0,0,0.5);
+  --docsearch-searchbox-background: var(--bg-main);
+  --docsearch-searchbox-focus-background: var(--bg-main);
+  --docsearch-hit-color: var(--text-muted);
+  --docsearch-hit-active-color: var(--bg-main);
+  --docsearch-hit-background: var(--bg-main);
+}
+
+/* --- Seamless Button Integration --- */
+
+/* Force the button to fit your sidebar perfectly */
+.DocSearch-Button {
+  border-radius: var(--border-radius) !important;
+  background: var(--bg-main) !important;
+  border: 1px solid var(--border-color) !important;
+  box-shadow: none !important;
+  color: var(--text-muted) !important;
+  transition: all 0.2s ease;
+  width: 100% !important; /* Stretch to fill sidebar */
+  margin: 0 0 1.5rem 0 !important; /* Space below the button */
+  padding: 0 10px !important;
+  justify-content: flex-start !important; /* Align "Search" to the left */
+}
+
+/* Push the keyboard shortcut to the right edge */
+.DocSearch-Button-Keys {
+  margin-left: auto !important;
+  min-width: auto !important;
+}
+
+.DocSearch-Button:hover {
+  border-color: var(--jooby-blue) !important;
+  color: var(--jooby-blue) !important;
+  box-shadow: 0 2px 4px rgba(0,0,0,0.05) !important;
+}
+
+/* --- Keyboard Shortcut Keys (kbd) --- */
+.DocSearch-Button-Keys kbd {
+  font-family: var(--font-code);
+  background: var(--bg-surface) !important;
+  border: 1px solid var(--border-color) !important;
+  color: var(--text-muted) !important;
+  box-shadow: 0 1px 0 rgba(0, 0, 0, 0.2), inset 0 0 0 2px var(--bg-main) !important;
+  border-radius: 4px !important;
+  padding: 0.1rem 0.3rem !important;
+  width: auto !important;
+  height: auto !important;
+}
+
+/* Brighten the keys explicitly in Dark Mode */
+html[data-theme="dark"] .DocSearch-Button-Keys kbd {
+  color: #e2e8f0 !important;
+  background: #334155 !important;
 }
 
diff --git a/jooby/pom.xml b/jooby/pom.xml
index d6b781528e..ae1c1ebc0f 100644
--- a/jooby/pom.xml
+++ b/jooby/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>jooby-project</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby</artifactId>
   <name>jooby</name>
diff --git a/jooby/src/main/java/io/jooby/Jooby.java b/jooby/src/main/java/io/jooby/Jooby.java
index 44e833d3d0..fb6a341944 100644
--- a/jooby/src/main/java/io/jooby/Jooby.java
+++ b/jooby/src/main/java/io/jooby/Jooby.java
@@ -37,6 +37,8 @@
 import io.jooby.internal.RouterImpl;
 import io.jooby.output.OutputFactory;
 import io.jooby.problem.ProblemDetailsHandler;
+import io.jooby.rpc.jsonrpc.JsonRpcModule;
+import io.jooby.rpc.jsonrpc.JsonRpcService;
 import io.jooby.value.ValueFactory;
 
 /**
@@ -102,6 +104,8 @@ public class Jooby implements Router, Registry {
 
   private List<Locale> locales;
 
+  private Map<String, JsonRpcModule> dispatchers;
+
   private boolean lateInit;
 
   private String name;
@@ -383,7 +387,7 @@ public String getContextPath() {
    * @param factory Application factory.
    * @return This application.
    */
-  @NonNull public Jooby install(
+  public Jooby install(
       @NonNull String path,
       @NonNull Predicate<Context> predicate,
       @NonNull SneakyThrows.Supplier<Jooby> factory) {
@@ -426,7 +430,7 @@ public String getContextPath() {
    * @param factory Application factory.
    * @return This application.
    */
-  @NonNull public Jooby install(
+  public Jooby install(
       @NonNull Predicate<Context> predicate, @NonNull SneakyThrows.Supplier<Jooby> factory) {
     return install("/", predicate, factory);
   }
@@ -478,8 +482,7 @@ public Route.Set mount(@NonNull Predicate<Context> predicate, @NonNull Router su
   @Override
   public Route.Set mount(@NonNull String path, @NonNull Router router) {
     var rs = this.router.mount(path, router);
-    if (router instanceof Jooby) {
-      Jooby child = (Jooby) router;
+    if (router instanceof Jooby child) {
       child.registry = this.registry;
     }
     return rs;
@@ -490,19 +493,68 @@ public Route.Set mount(@NonNull Router router) {
     return mount("/", router);
   }
 
+  /**
+   * Mounts and registers a JSON-RPC service at the specified custom path.
+   *
+   * <p>This method initializes a JSON-RPC dispatcher for the given path if one does not already
+   * exist, installs the dispatcher module into the application, and binds the provided {@link
+   * JsonRpcService} to it. Multiple services can be added to the same path.
+   *
+   * @param path The URL path where the JSON-RPC endpoint will be exposed (e.g., "/api/rpc").
+   * @param service The {@link JsonRpcService} instance containing the RPC methods to expose. Must
+   *     not be null.
+   * @return This {@link Jooby} instance to allow for method chaining.
+   */
+  public Jooby jsonRpc(String path, @NonNull JsonRpcService service) {
+    if (dispatchers == null) {
+      dispatchers = new HashMap<>();
+    }
+    dispatchers
+        .computeIfAbsent(
+            Router.normalizePath(path),
+            normalizedPath -> {
+              var dispatcher = new JsonRpcModule(normalizedPath);
+              install(dispatcher);
+              return dispatcher;
+            })
+        .add(service);
+    return this;
+  }
+
+  /**
+   * Mounts and registers a JSON-RPC service at the default path {@code "/rpc"}.
+   *
+   * <p>This is a convenience method that delegates to {@link #jsonRpc(String, JsonRpcService)}
+   * using the default endpoint path.
+   *
+   * @param service The {@link JsonRpcService} instance containing the RPC methods to expose. Must
+   *     not be null.
+   * @return This {@link Jooby} instance to allow for method chaining.
+   */
+  public Jooby jsonRpc(@NonNull JsonRpcService service) {
+    return jsonRpc("/rpc", service);
+  }
+
   /**
    * Add controller routes.
    *
    * @param router Mvc extension.
    * @return Route set.
    */
-  @NonNull public Route.Set mvc(@NonNull Extension router) {
-    try {
-      int start = this.router.getRoutes().size();
-      router.install(this);
-      return new Route.Set(this.router.getRoutes().subList(start, this.router.getRoutes().size()));
-    } catch (Exception cause) {
-      throw SneakyThrows.propagate(cause);
+  public Route.Set mvc(@NonNull Extension router) {
+    if (router instanceof JsonRpcService jsonRpcService) {
+      jsonRpc(jsonRpcService);
+      // NOOP
+      return new Route.Set(Collections.emptyList());
+    } else {
+      try {
+        int start = this.router.getRoutes().size();
+        router.install(this);
+        return new Route.Set(
+            this.router.getRoutes().subList(start, this.router.getRoutes().size()));
+      } catch (Exception cause) {
+        throw SneakyThrows.propagate(cause);
+      }
     }
   }
 
@@ -1455,5 +1507,6 @@ private static void copyState(Jooby source, Jooby dest) {
     dest.readyCallbacks = source.readyCallbacks;
     dest.startingCallbacks = source.startingCallbacks;
     dest.stopCallbacks = source.stopCallbacks;
+    dest.dispatchers = source.dispatchers;
   }
 }
diff --git a/jooby/src/main/java/io/jooby/Router.java b/jooby/src/main/java/io/jooby/Router.java
index 802b9618d5..b07d64ef5a 100644
--- a/jooby/src/main/java/io/jooby/Router.java
+++ b/jooby/src/main/java/io/jooby/Router.java
@@ -908,7 +908,7 @@ static String leadingSlash(@Nullable String path) {
    * @param path Path to process.
    * @return Path without trailing slashes.
    */
-  static @NonNull String noTrailingSlash(@NonNull String path) {
+  static String noTrailingSlash(@NonNull String path) {
     StringBuilder buff = new StringBuilder(path);
     int i = buff.length() - 1;
     while (i > 0 && buff.charAt(i) == '/') {
@@ -927,7 +927,7 @@ static String leadingSlash(@Nullable String path) {
    * @param path Path to process.
    * @return Safe path pattern.
    */
-  static @NonNull String normalizePath(@Nullable String path) {
+  static String normalizePath(@Nullable String path) {
     if (path == null || path.length() == 0 || path.equals("/")) {
       return "/";
     }
diff --git a/jooby/src/main/java/io/jooby/ServerOptions.java b/jooby/src/main/java/io/jooby/ServerOptions.java
index 5ea3ab2a31..7e084053f4 100644
--- a/jooby/src/main/java/io/jooby/ServerOptions.java
+++ b/jooby/src/main/java/io/jooby/ServerOptions.java
@@ -290,7 +290,7 @@ public int getPort() {
    * @return True when SSL is enabled. Either bc the secure port, httpsOnly or SSL options are set.
    */
   public boolean isSSLEnabled() {
-    return securePort != null || ssl != null || httpsOnly;
+    return securePort != null || ssl != null || http2 == Boolean.TRUE || httpsOnly;
   }
 
   /**
diff --git a/jooby/src/main/java/io/jooby/StatusCode.java b/jooby/src/main/java/io/jooby/StatusCode.java
index 0292bcf902..92195514bd 100644
--- a/jooby/src/main/java/io/jooby/StatusCode.java
+++ b/jooby/src/main/java/io/jooby/StatusCode.java
@@ -738,6 +738,14 @@ public final class StatusCode {
   public static final StatusCode REQUEST_HEADER_FIELDS_TOO_LARGE =
       new StatusCode(REQUEST_HEADER_FIELDS_TOO_LARGE_CODE, "Request Header Fields Too Large");
 
+  /** {@code 499 The client aborted the request before completion}. */
+  public static final int CLIENT_CLOSED_REQUEST_CODE = 499;
+
+  /** {@code 499 The client aborted the request before completion}. */
+  public static final StatusCode CLIENT_CLOSED_REQUEST =
+      new StatusCode(
+          CLIENT_CLOSED_REQUEST_CODE, "The client aborted the request before completion");
+
   // --- 5xx Server Error ---
 
   /**
@@ -1025,6 +1033,7 @@ public static StatusCode valueOf(final int statusCode) {
       case PRECONDITION_REQUIRED_CODE -> PRECONDITION_REQUIRED;
       case TOO_MANY_REQUESTS_CODE -> TOO_MANY_REQUESTS;
       case REQUEST_HEADER_FIELDS_TOO_LARGE_CODE -> REQUEST_HEADER_FIELDS_TOO_LARGE;
+      case CLIENT_CLOSED_REQUEST_CODE -> CLIENT_CLOSED_REQUEST;
       case SERVER_ERROR_CODE -> SERVER_ERROR;
       case NOT_IMPLEMENTED_CODE -> NOT_IMPLEMENTED;
       case BAD_GATEWAY_CODE -> BAD_GATEWAY;
diff --git a/jooby/src/main/java/io/jooby/annotation/JsonRpc.java b/jooby/src/main/java/io/jooby/annotation/JsonRpc.java
new file mode 100644
index 0000000000..e0f0c0d681
--- /dev/null
+++ b/jooby/src/main/java/io/jooby/annotation/JsonRpc.java
@@ -0,0 +1,51 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.annotation;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * Marks a class or its methods as a JSON-RPC 2.0 endpoint.
+ *
+ * <h3>Discovery Rules:</h3>
+ *
+ * <ul>
+ *   <li><b>Implicit Mapping:</b> If a class is annotated with {@code @JsonRpc} and <b>no</b>
+ *       methods are explicitly annotated, <b>all</b> public methods are automatically exposed as
+ *       JSON-RPC endpoints.
+ *   <li><b>Explicit Mapping:</b> If at least <b>one</b> method in the class is explicitly annotated
+ *       with {@code @JsonRpc}, implicit mapping is disabled. <b>Only</b> the annotated methods will
+ *       be exposed, requiring you to map any other desired endpoints one by one.
+ * </ul>
+ *
+ * <h3>Naming & Routing Rules:</h3>
+ *
+ * <ul>
+ *   <li><b>Class Level (Namespace):</b> When applied to a class, the {@link #value()} defines the
+ *       namespace for all JSON-RPC methods within that class. If the annotation is present but the
+ *       value is empty (the default), <b>no namespace</b> is applied.
+ *   <li><b>Method Level (Method Name):</b> When applied to a method, the {@link #value()} defines
+ *       the exact RPC method name. If the value is empty, the actual Java/Kotlin method name is
+ *       used.
+ * </ul>
+ *
+ * <p>The final JSON-RPC method string expected by the dispatcher is formatted as {@code
+ * "namespace.methodName"} (or just {@code "methodName"} if no namespace exists).
+ */
+@Target({ElementType.TYPE, ElementType.METHOD})
+@Retention(RetentionPolicy.RUNTIME)
+public @interface JsonRpc {
+
+  /**
+   * The explicit namespace (when used on a class) or the explicit method name (when used on a
+   * method). * @return The overridden name, or an empty string to use the defaults (no namespace
+   * for classes, actual method name for methods).
+   */
+  String value() default "";
+}
diff --git a/jooby/src/main/java/io/jooby/annotation/Trpc.java b/jooby/src/main/java/io/jooby/annotation/Trpc.java
new file mode 100644
index 0000000000..a3988077ff
--- /dev/null
+++ b/jooby/src/main/java/io/jooby/annotation/Trpc.java
@@ -0,0 +1,111 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.annotation;
+
+import java.lang.annotation.Documented;
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * Marks a controller class or a specific route method for tRPC TypeScript generation.
+ *
+ * <p>When applied to a class, it defines a namespace for the tRPC router. All tRPC-annotated
+ * methods within the class will be grouped under this namespace in the generated TypeScript {@code
+ * AppRouter}.
+ *
+ * <p><b>Defining Procedures:</b>
+ *
+ * <p>There are two ways to expose a method as a tRPC procedure:
+ *
+ * <ul>
+ *   <li><b>Explicit tRPC Annotations:</b> Use {@link Trpc.Query} for read-only operations (mapped
+ *       to HTTP GET) and {@link Trpc.Mutation} for state-changing operations (mapped to HTTP POST).
+ *   <li><b>Hybrid HTTP Annotations:</b> Combine the base {@code @Trpc} annotation with standard
+ *       HTTP annotations. A {@code @GET} annotation maps to a query, while {@code @POST},
+ *       {@code @PUT}, {@code @PATCH}, and {@code @DELETE} map to a mutation.
+ * </ul>
+ *
+ * <p><b>Network Payloads:</b>
+ *
+ * <p>Because tRPC natively supports only a single input payload, Java methods with multiple
+ * parameters will automatically require a JSON array (Tuple) from the frontend client. Framework
+ * parameters like {@code io.jooby.Context} are ignored during payload calculation.
+ *
+ * <p><b>Example:</b>
+ *
+ * <pre>{@code
+ * @Trpc("movies") // Defines the 'movies' namespace
+ * public class MovieService {
+ *
+ * @Trpc.Query // Becomes 'movies.list' query
+ * public List<Movie> list() { ... }
+ *
+ * @Trpc // Hybrid approach: Becomes 'movies.delete' mutation
+ * @DELETE
+ * public void delete(int id) { ... }
+ * }
+ * }</pre>
+ */
+@Target({ElementType.TYPE, ElementType.METHOD})
+@Retention(RetentionPolicy.RUNTIME)
+@Documented
+public @interface Trpc {
+
+  /**
+   * Marks a method as a tRPC mutation.
+   *
+   * <p>Mutations are used for creating, updating, or deleting data. Under the hood, Jooby will
+   * automatically expose this method as an HTTP POST route on the {@code /trpc} endpoint.
+   */
+  @Target(ElementType.METHOD)
+  @Retention(RetentionPolicy.RUNTIME)
+  @Documented
+  @interface Mutation {
+    /**
+     * Custom name for the tRPC mutation.
+     *
+     * <p>This overrides the generated procedure name in the TypeScript router.
+     *
+     * @return The custom procedure name. Empty by default, which means the generator will use the
+     *     Java method name.
+     */
+    String value() default "";
+  }
+
+  /**
+   * Marks a method as a tRPC query.
+   *
+   * <p>Queries are strictly used for fetching data. Under the hood, Jooby will automatically expose
+   * this method as an HTTP GET route on the {@code /trpc} endpoint.
+   */
+  @Target(ElementType.METHOD)
+  @Retention(RetentionPolicy.RUNTIME)
+  @Documented
+  @interface Query {
+    /**
+     * Custom name for the tRPC query.
+     *
+     * <p>This overrides the generated procedure name in the TypeScript router.
+     *
+     * @return The custom procedure name. Empty by default, which means the generator will use the
+     *     Java method name.
+     */
+    String value() default "";
+  }
+
+  /**
+   * Custom name for the tRPC procedure or namespace.
+   *
+   * <p>If applied to a method, this overrides the generated procedure name. If applied to a class,
+   * this overrides the generated namespace in the {@code AppRouter}.
+   *
+   * @return The custom procedure or namespace name. Empty by default, which means the generator
+   *     will use the Java method or class name.
+   */
+  String value() default "";
+}
diff --git a/jooby/src/main/java/io/jooby/internal/x509/JdkSslContext.java b/jooby/src/main/java/io/jooby/internal/x509/JdkSslContext.java
index 3b30370968..0000224ccd 100644
--- a/jooby/src/main/java/io/jooby/internal/x509/JdkSslContext.java
+++ b/jooby/src/main/java/io/jooby/internal/x509/JdkSslContext.java
@@ -51,7 +51,6 @@ public abstract class JdkSslContext extends SslContext {
 
   static {
     SSLContext context;
-    int i;
     try {
       context = SSLContext.getInstance(PROTOCOL);
       context.init(null, null, null);
@@ -63,12 +62,11 @@ public abstract class JdkSslContext extends SslContext {
 
     // Choose the sensible default list of protocols.
     final String[] supportedProtocols = engine.getSupportedProtocols();
-    Set<String> supportedProtocolsSet = new HashSet<String>(supportedProtocols.length);
-    for (i = 0; i < supportedProtocols.length; ++i) {
-      supportedProtocolsSet.add(supportedProtocols[i]);
-    }
-    List<String> protocols = new ArrayList<String>();
-    addIfSupported(supportedProtocolsSet, protocols, "TLSv1.2", "TLSv1.1", "TLSv1");
+    Set<String> supportedProtocolsSet = new HashSet<>(Arrays.asList(supportedProtocols));
+    List<String> protocols = new ArrayList<>();
+
+    // Modernized for Java 21: prioritize TLS 1.3 and TLS 1.2
+    addIfSupported(supportedProtocolsSet, protocols, "TLSv1.3", "TLSv1.2");
 
     if (!protocols.isEmpty()) {
       PROTOCOLS = protocols.toArray(new String[0]);
@@ -78,26 +76,26 @@ public abstract class JdkSslContext extends SslContext {
 
     // Choose the sensible default list of cipher suites.
     final String[] supportedCiphers = engine.getSupportedCipherSuites();
-    SUPPORTED_CIPHERS = new HashSet<String>(supportedCiphers.length);
-    for (i = 0; i < supportedCiphers.length; ++i) {
-      SUPPORTED_CIPHERS.add(supportedCiphers[i]);
-    }
-    List<String> ciphers = new ArrayList<String>();
+    SUPPORTED_CIPHERS = new HashSet<>(Arrays.asList(supportedCiphers));
+    List<String> ciphers = new ArrayList<>();
+
     addIfSupported(
         SUPPORTED_CIPHERS,
         ciphers,
-        // XXX: Make sure to sync this list with OpenSslEngineFactory.
-        // GCM (Galois/Counter Mode) requires JDK 8.
+        // TLS 1.3 Ciphers
+        "TLS_AES_256_GCM_SHA384",
+        "TLS_AES_128_GCM_SHA256",
+        "TLS_CHACHA20_POLY1305_SHA256",
+        // Modern TLS 1.2 Ciphers
+        "TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384",
+        "TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384",
+        "TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256",
         "TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256",
         "TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA",
-        // AES256 requires JCE unlimited strength jurisdiction policy files.
         "TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA",
-        // GCM (Galois/Counter Mode) requires JDK 8.
         "TLS_RSA_WITH_AES_128_GCM_SHA256",
         "TLS_RSA_WITH_AES_128_CBC_SHA",
-        // AES256 requires JCE unlimited strength jurisdiction policy files.
-        "TLS_RSA_WITH_AES_256_CBC_SHA",
-        "SSL_RSA_WITH_3DES_EDE_CBC_SHA");
+        "TLS_RSA_WITH_AES_256_CBC_SHA");
 
     if (ciphers.isEmpty()) {
       // Use the default from JDK as fallback.
@@ -125,7 +123,6 @@ private static void addIfSupported(
     }
   }
 
-  /** Returns the JDK {@link SSLSessionContext} object held by this context. */
   @Override
   public final SSLSessionContext sessionContext() {
     return context().getServerSessionContext();
@@ -141,18 +138,6 @@ public final long sessionTimeout() {
     return sessionContext().getSessionTimeout();
   }
 
-  /**
-   * Build a {@link KeyManagerFactory} based upon a key file, key file password, and a certificate
-   * chain.
-   *
-   * @param certChainFile a X.509 certificate chain file in PEM format
-   * @param keyFile a PKCS#8 private key file in PEM format
-   * @param keyPassword the password of the {@code keyFile}. {@code null} if it's not
-   *     password-protected.
-   * @param kmf The existing {@link KeyManagerFactory} that will be used if not {@code null}
-   * @return A {@link KeyManagerFactory} based upon a key file, key file password, and a certificate
-   *     chain.
-   */
   protected static KeyManagerFactory buildKeyManagerFactory(
       final InputStream certChainFile, final InputStream keyFile, final String keyPassword)
       throws UnrecoverableKeyException,
@@ -171,19 +156,6 @@ protected static KeyManagerFactory buildKeyManagerFactory(
     return buildKeyManagerFactory(certChainFile, algorithm, keyFile, keyPassword);
   }
 
-  /**
-   * Build a {@link KeyManagerFactory} based upon a key algorithm, key file, key file password, and
-   * a certificate chain.
-   *
-   * @param certChainFile a X.509 certificate chain file in PEM format
-   * @param keyAlgorithm the standard name of the requested algorithm. See the Java Secure Socket
-   *     Extension Reference Guide for information about standard algorithm names.
-   * @param keyFile a PKCS#8 private key file in PEM format
-   * @param keyPassword the password of the {@code keyFile}. {@code null} if it's not
-   *     password-protected.
-   * @return A {@link KeyManagerFactory} based upon a key algorithm, key file, key file password,
-   *     and a certificate chain.
-   */
   protected static KeyManagerFactory buildKeyManagerFactory(
       final InputStream certChainFile,
       final String keyAlgorithm,
diff --git a/jooby/src/main/java/io/jooby/internal/x509/PemReader.java b/jooby/src/main/java/io/jooby/internal/x509/PemReader.java
index c96d36a88a..b37b3b1598 100644
--- a/jooby/src/main/java/io/jooby/internal/x509/PemReader.java
+++ b/jooby/src/main/java/io/jooby/internal/x509/PemReader.java
@@ -10,7 +10,6 @@
 import java.nio.ByteBuffer;
 import java.nio.charset.StandardCharsets;
 import java.security.KeyException;
-import java.security.KeyStore;
 import java.security.cert.CertificateException;
 import java.util.ArrayList;
 import java.util.Base64;
@@ -21,8 +20,7 @@
 import io.jooby.internal.IOUtils;
 
 /**
- * Reads a PEM file and converts it into a list of DERs so that they are imported into a {@link
- * KeyStore} easily.
+ * Reads a PEM file and converts it into a list of DERs.
  *
  * <p>Borrowed from <a href="http://netty.io">Netty</a>
  */
@@ -36,6 +34,7 @@ final class PemReader {
               + // Base64 text
               "-+END\\s+.*CERTIFICATE[^-]*-+", // Footer
           Pattern.CASE_INSENSITIVE);
+
   private static final Pattern KEY_PATTERN =
       Pattern.compile(
           "-+BEGIN\\s+.*PRIVATE\\s+KEY[^-]*-+(?:\\s|\\r|\\n)+"
@@ -49,13 +48,12 @@ static List<ByteBuffer> readCertificates(final InputStream file)
       throws CertificateException, IOException {
     String content = IOUtils.toString(file, StandardCharsets.UTF_8);
 
-    List<ByteBuffer> certs = new ArrayList<ByteBuffer>();
+    List<ByteBuffer> certs = new ArrayList<>();
     Matcher m = CERT_PATTERN.matcher(content);
     int start = 0;
     while (m.find(start)) {
       ByteBuffer buffer = ByteBuffer.wrap(decode(m.group(1)));
       certs.add(buffer);
-
       start = m.end();
     }
 
@@ -67,7 +65,8 @@ static List<ByteBuffer> readCertificates(final InputStream file)
   }
 
   private static byte[] decode(String value) {
-    return Base64.getDecoder().decode(value.replaceAll("(?:\\r\\n|\\n\\r|\\n|\\r)", ""));
+    // MimeDecoder automatically strips out \r and \n characters
+    return Base64.getMimeDecoder().decode(value);
   }
 
   static ByteBuffer readPrivateKey(final InputStream file) throws KeyException, IOException {
diff --git a/jooby/src/main/java/io/jooby/internal/x509/SslContext.java b/jooby/src/main/java/io/jooby/internal/x509/SslContext.java
index 0e81fae1df..7dd2b79c39 100644
--- a/jooby/src/main/java/io/jooby/internal/x509/SslContext.java
+++ b/jooby/src/main/java/io/jooby/internal/x509/SslContext.java
@@ -6,7 +6,6 @@
 package io.jooby.internal.x509;
 
 import java.io.ByteArrayInputStream;
-import java.io.File;
 import java.io.IOException;
 import java.io.InputStream;
 import java.nio.ByteBuffer;
@@ -45,27 +44,7 @@
  * SslHandler}. Internally, it is implemented via JDK's {@link SSLContext} or OpenSSL's {@code
  * SSL_CTX}.
  *
- * <h3>Making your server support SSL/TLS</h3>
- *
- * <pre>
- * // In your {@link ChannelInitializer}:
- * {@link ChannelPipeline} p = channel.pipeline();
- * {@link SslContext} sslCtx = {@link SslContextBuilder#forServer(File, File) SslContextBuilder.forServer(...)}.build();
- * p.addLast("ssl", {@link #newEngine(ByteBufAllocator) sslCtx.newEngine(channel.alloc())});
- * ...
- * </pre>
- *
- * <h3>Making your client support SSL/TLS</h3>
- *
- * <pre>
- * // In your {@link ChannelInitializer}:
- * {@link ChannelPipeline} p = channel.pipeline();
- * {@link SslContext} sslCtx = {@link SslContextBuilder#forClient() SslContextBuilder.forClient()}.build();
- * p.addLast("ssl", {@link #newEngine(ByteBufAllocator, String, int) sslCtx.newEngine(channel.alloc(), host, port)});
- * ...
- * </pre>
- *
- * Borrowed from <a href="http://netty.io">Netty</a>
+ * <p>Borrowed from <a href="http://netty.io">Netty</a>
  */
 public abstract class SslContext {
   static final CertificateFactory X509_CERT_FACTORY;
@@ -97,33 +76,14 @@ public static SslContext newServerContextInternal(
         sessionTimeout);
   }
 
-  /** Returns the size of the cache used for storing SSL session objects. */
   public abstract long sessionCacheSize();
 
   public abstract long sessionTimeout();
 
   public abstract SSLContext context();
 
-  /** Returns the {@link SSLSessionContext} object held by this context. */
   public abstract SSLSessionContext sessionContext();
 
-  /**
-   * Generates a key specification for an (encrypted) private key.
-   *
-   * @param password characters, if {@code null} or empty an unencrypted key is assumed
-   * @param key bytes of the DER encoded private key
-   * @return a key specification
-   * @throws IOException if parsing {@code key} fails
-   * @throws NoSuchAlgorithmException if the algorithm used to encrypt {@code key} is unkown
-   * @throws NoSuchPaddingException if the padding scheme specified in the decryption algorithm is
-   *     unkown
-   * @throws InvalidKeySpecException if the decryption key based on {@code password} cannot be
-   *     generated
-   * @throws InvalidKeyException if the decryption key based on {@code password} cannot be used to
-   *     decrypt {@code key}
-   * @throws InvalidAlgorithmParameterException if decryption algorithm parameters are somehow
-   *     faulty
-   */
   protected static PKCS8EncodedKeySpec generateKeySpec(final char[] password, final byte[] key)
       throws IOException,
           NoSuchAlgorithmException,
@@ -148,15 +108,6 @@ protected static PKCS8EncodedKeySpec generateKeySpec(final char[] password, fina
     return encryptedPrivateKeyInfo.getKeySpec(cipher);
   }
 
-  /**
-   * Generates a new {@link KeyStore}.
-   *
-   * @param certChainFile a X.509 certificate chain file in PEM format,
-   * @param keyFile a PKCS#8 private key file in PEM format,
-   * @param keyPasswordChars the password of the {@code keyFile}. {@code null} if it's not
-   *     password-protected.
-   * @return generated {@link KeyStore}.
-   */
   static KeyStore buildKeyStore(
       final InputStream certChainFile, final InputStream keyFile, final char[] keyPasswordChars)
       throws KeyStoreException,
@@ -189,30 +140,22 @@ static KeyStore buildKeyStore(
 
     CertificateFactory cf = CertificateFactory.getInstance("X.509");
     List<ByteBuffer> certs = PemReader.readCertificates(certChainFile);
-    List<Certificate> certChain = new ArrayList<Certificate>(certs.size());
+    List<Certificate> certChain = new ArrayList<>(certs.size());
 
     for (ByteBuffer buf : certs) {
       certChain.add(cf.generateCertificate(new ByteArrayInputStream(buf.array())));
     }
 
-    KeyStore ks = KeyStore.getInstance("JKS");
+    KeyStore ks = KeyStore.getInstance(KeyStore.getDefaultType());
     ks.load(null, null);
     ks.setKeyEntry("key", key, keyPasswordChars, certChain.toArray(new Certificate[0]));
     return ks;
   }
 
-  /**
-   * Build a {@link TrustManagerFactory} from a certificate chain file.
-   *
-   * @param certChainFile The certificate file to build from.
-   * @param trustManagerFactory The existing {@link TrustManagerFactory} that will be used if not
-   *     {@code null}.
-   * @return A {@link TrustManagerFactory} which contains the certificates in {@code certChainFile}
-   */
   protected static TrustManagerFactory buildTrustManagerFactory(
       final InputStream certChainFile, TrustManagerFactory trustManagerFactory)
       throws NoSuchAlgorithmException, CertificateException, KeyStoreException, IOException {
-    KeyStore ks = KeyStore.getInstance("JKS");
+    KeyStore ks = KeyStore.getInstance(KeyStore.getDefaultType());
     ks.load(null, null);
     CertificateFactory cf = CertificateFactory.getInstance("X.509");
 
@@ -225,7 +168,6 @@ protected static TrustManagerFactory buildTrustManagerFactory(
       ks.setCertificateEntry(principal.getName("RFC2253"), cert);
     }
 
-    // Set up trust manager factory to use our key store.
     if (trustManagerFactory == null) {
       trustManagerFactory =
           TrustManagerFactory.getInstance(TrustManagerFactory.getDefaultAlgorithm());
diff --git a/jooby/src/main/java/io/jooby/rpc/grpc/GrpcExchange.java b/jooby/src/main/java/io/jooby/rpc/grpc/GrpcExchange.java
new file mode 100644
index 0000000000..d6a56f4ff8
--- /dev/null
+++ b/jooby/src/main/java/io/jooby/rpc/grpc/GrpcExchange.java
@@ -0,0 +1,83 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.rpc.grpc;
+
+import java.nio.ByteBuffer;
+import java.util.Map;
+import java.util.function.Consumer;
+
+import edu.umd.cs.findbugs.annotations.Nullable;
+
+/**
+ * Server-agnostic abstraction for a native HTTP/2 gRPC exchange.
+ *
+ * <p>This interface bridges the gap between the underlying web server (Undertow, Netty, or Jetty)
+ * and the reactive gRPC processor. Because gRPC heavily relies on HTTP/2 multiplexing, asynchronous
+ * I/O, and trailing headers (trailers) to communicate status codes, standard HTTP/1.1 context
+ * abstractions are insufficient.
+ *
+ * <p>Native server interceptors wrap their respective request/response objects into this interface,
+ * allowing the {@link GrpcProcessor} to read headers, push zero-copy byte frames, and finalize the
+ * stream with standard gRPC trailers without knowing which server engine is actually running.
+ */
+public interface GrpcExchange {
+
+  /**
+   * Retrieves the requested URI path.
+   *
+   * <p>In gRPC, this dictates the routing and strictly follows the pattern: {@code
+   * /Fully.Qualified.ServiceName/MethodName}.
+   *
+   * @return The exact path of the incoming HTTP/2 request.
+   */
+  String getRequestPath();
+
+  /**
+   * Retrieves the value of the specified HTTP request header.
+   *
+   * @param name The name of the header (case-insensitive).
+   * @return The header value, or {@code null} if the header is not present.
+   */
+  @Nullable String getHeader(String name);
+
+  /**
+   * Retrieves all HTTP request headers.
+   *
+   * @return A map containing all headers provided by the client.
+   */
+  Map<String, String> getHeaders();
+
+  /**
+   * Writes a gRPC-framed byte payload to the underlying non-blocking socket.
+   *
+   * <p>This method must push the buffer to the native network layer without blocking the invoking
+   * thread (which is typically a background gRPC worker). The implementation is responsible for
+   * translating the ByteBuffer into the server's native data format and flushing it over the
+   * network.
+   *
+   * @param payload The properly framed 5-byte-prefixed gRPC payload to send.
+   * @param onFailure A callback invoked immediately if the asynchronous network write fails (e.g.,
+   *     if the client abruptly disconnects or the channel is closed).
+   */
+  void send(ByteBuffer payload, Consumer<Throwable> onFailure);
+
+  /**
+   * Closes the HTTP/2 stream by appending the mandatory gRPC trailing headers.
+   *
+   * <p>In the gRPC specification, a successful response or an application-level error is
+   * communicated not by standard HTTP status codes (which are always 200 OK), but by appending
+   * HTTP/2 trailers ({@code grpc-status} and {@code grpc-message}) at the very end of the stream.
+   *
+   * <p>Calling this method informs the native server to write those trailing headers and formally
+   * close the bidirectional stream.
+   *
+   * @param statusCode The gRPC integer status code (e.g., {@code 0} for OK, {@code 12} for
+   *     UNIMPLEMENTED, {@code 4} for DEADLINE_EXCEEDED).
+   * @param description An optional, human-readable status message detailing the result or error.
+   *     May be {@code null}.
+   */
+  void close(int statusCode, @Nullable String description);
+}
diff --git a/jooby/src/main/java/io/jooby/rpc/grpc/GrpcProcessor.java b/jooby/src/main/java/io/jooby/rpc/grpc/GrpcProcessor.java
new file mode 100644
index 0000000000..6161f0fa12
--- /dev/null
+++ b/jooby/src/main/java/io/jooby/rpc/grpc/GrpcProcessor.java
@@ -0,0 +1,51 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.rpc.grpc;
+
+import java.nio.ByteBuffer;
+import java.util.concurrent.Flow;
+
+import edu.umd.cs.findbugs.annotations.NonNull;
+
+/**
+ * Core Service Provider Interface (SPI) for the gRPC extension.
+ *
+ * <p>This processor acts as the bridge between the native HTTP/2 web servers and the embedded gRPC
+ * engine. It is designed to intercept and process gRPC exchanges at the lowest possible network
+ * level, completely bypassing Jooby's standard HTTP/1.1 routing pipeline. This architecture ensures
+ * strict HTTP/2 specification compliance, zero-copy buffering, and reactive backpressure.
+ */
+public interface GrpcProcessor {
+
+  /**
+   * Checks if the given URI path exactly matches a registered gRPC method.
+   *
+   * <p>Native server interceptors use this method as a lightweight, fail-fast guard. If this
+   * returns {@code true}, the server will hijack the request and upgrade it to a native gRPC
+   * stream. If {@code false}, the request safely falls through to the standard Jooby router
+   * (typically resulting in a standard HTTP 404 Not Found, which gRPC clients gracefully translate
+   * to Status 12 UNIMPLEMENTED).
+   *
+   * @param path The incoming request path (e.g., {@code /fully.qualified.Service/MethodName}).
+   * @return {@code true} if the path is mapped to an active gRPC service; {@code false} otherwise.
+   */
+  boolean isGrpcMethod(String path);
+
+  /**
+   * Initiates the reactive gRPC pipeline for an incoming HTTP/2 request.
+   *
+   * <p>When a valid gRPC request is intercepted, the native server wraps the underlying network
+   * connection into a {@link GrpcExchange} and passes it to this method. The processor uses this
+   * exchange to asynchronously send response headers, payload byte frames, and HTTP/2 trailers.
+   *
+   * @param exchange The native server exchange representing the bidirectional HTTP/2 stream.
+   * @return A reactive {@link Flow.Subscriber} that the native server must feed incoming request
+   *     payload {@link ByteBuffer} chunks into. Returns {@code null} if the exchange was rejected.
+   * @throws IllegalStateException If an unregistered path bypasses the {@link
+   *     #isGrpcMethod(String)} guard.
+   */
+  Flow.Subscriber<ByteBuffer> process(@NonNull GrpcExchange exchange);
+}
diff --git a/jooby/src/main/java/io/jooby/rpc/jsonrpc/JsonRpcDecoder.java b/jooby/src/main/java/io/jooby/rpc/jsonrpc/JsonRpcDecoder.java
new file mode 100644
index 0000000000..b7d75f3ab1
--- /dev/null
+++ b/jooby/src/main/java/io/jooby/rpc/jsonrpc/JsonRpcDecoder.java
@@ -0,0 +1,35 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.rpc.jsonrpc;
+
+/**
+ * A pre-resolved decoder used at runtime to deserialize JSON-RPC parameter nodes into complex Java
+ * objects.
+ *
+ * <p>This interface is heavily utilized by the Jooby Annotation Processor (APT). When compiling
+ * {@code @JsonRpc}-annotated controllers, the APT generates highly optimized routing code that
+ * resolves the appropriate {@code JsonRpcDecoder} for each method argument. By pre-resolving these
+ * decoders, Jooby efficiently parses incoming JSON arguments without incurring reflection overhead
+ * on every request.
+ *
+ * <p>Note: Primitive types and standard wrappers (like {@code int}, {@code String}, {@code
+ * boolean}) are typically handled directly by the {@link JsonRpcReader} rather than requiring a
+ * dedicated decoder.
+ *
+ * @param <T> The target Java type this decoder produces.
+ */
+public interface JsonRpcDecoder<T> {
+
+  /**
+   * Decodes a generic JSON node object into the target Java object.
+   *
+   * @param name The name of the parameter being decoded (useful for error reporting or wrapping).
+   * @param node The generic JSON node (e.g., a Map, List, or library-specific AST node)
+   *     representing this specific argument.
+   * @return The fully deserialized Java object.
+   */
+  T decode(String name, Object node);
+}
diff --git a/jooby/src/main/java/io/jooby/rpc/jsonrpc/JsonRpcErrorCode.java b/jooby/src/main/java/io/jooby/rpc/jsonrpc/JsonRpcErrorCode.java
new file mode 100644
index 0000000000..929b4306a2
--- /dev/null
+++ b/jooby/src/main/java/io/jooby/rpc/jsonrpc/JsonRpcErrorCode.java
@@ -0,0 +1,141 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.rpc.jsonrpc;
+
+import io.jooby.StatusCode;
+
+/**
+ * Standard JSON-RPC 2.0 Error Codes mapped to HTTP status codes.
+ *
+ * <p>The JSON-RPC 2.0 specification defines a specific set of integer codes for standard errors.
+ * This enumeration provides the canonical mapping between those JSON-RPC errors and Jooby's {@link
+ * StatusCode} for HTTP transport bindings.
+ */
+public enum JsonRpcErrorCode {
+
+  // --- Core JSON-RPC 2.0 Errors ---
+
+  /** The JSON sent is not a valid Request object. */
+  INVALID_REQUEST(-32600, "Invalid Request", StatusCode.BAD_REQUEST, true),
+
+  /**
+   * Invalid JSON was received by the server. An error occurred on the server while parsing the JSON
+   * text.
+   */
+  PARSE_ERROR(-32700, "Parse error", StatusCode.BAD_REQUEST, true),
+
+  /** The method does not exist / is not available. */
+  METHOD_NOT_FOUND(-32601, "Method not found", StatusCode.NOT_FOUND, true),
+
+  /** Invalid method parameter(s). */
+  INVALID_PARAMS(-32602, "Invalid params", StatusCode.BAD_REQUEST, true),
+
+  /** Internal JSON-RPC error. */
+  INTERNAL_ERROR(-32603, "Internal error", StatusCode.SERVER_ERROR, true),
+
+  // --- Implementation-defined Server Errors (-32000 to -32099) ---
+
+  /** Missing or invalid authentication. */
+  UNAUTHORIZED(-32001, "Unauthorized", StatusCode.UNAUTHORIZED, false),
+
+  /** Authenticated user lacks required permissions. */
+  FORBIDDEN(-32003, "Forbidden", StatusCode.FORBIDDEN, false),
+
+  /** The requested resource or procedure was not found (Business Logic). */
+  NOT_FOUND_ERROR(-32004, "Not found", StatusCode.NOT_FOUND, false),
+
+  /** State conflict, such as a duplicate database entry. */
+  CONFLICT(-32009, "Conflict", StatusCode.CONFLICT, false),
+
+  /** The client's preconditions were not met. */
+  PRECONDITION_FAILED(-32012, "Precondition failed", StatusCode.PRECONDITION_FAILED, false),
+
+  /**
+   * The payload format is valid, but the content is semantically incorrect (e.g., validation
+   * failed).
+   */
+  UNPROCESSABLE_CONTENT(-32022, "Unprocessable content", StatusCode.UNPROCESSABLE_ENTITY, false),
+
+  /** Rate limiting applied. */
+  TOO_MANY_REQUESTS(-32029, "Too many requests", StatusCode.TOO_MANY_REQUESTS, false);
+
+  private final int code;
+  private final String message;
+  private final StatusCode statusCode;
+  private final boolean protocol;
+
+  /**
+   * Defines a JSON-RPC error code mapping.
+   *
+   * @param code The JSON-RPC 2.0 integer code.
+   * @param message The standard error message.
+   * @param statusCode The HTTP status code to associate with this error.
+   * @param protocol True if this is a strict JSON-RPC 2.0 protocol error, false if
+   *     implementation-defined.
+   */
+  JsonRpcErrorCode(int code, String message, StatusCode statusCode, boolean protocol) {
+    this.code = code;
+    this.message = message;
+    this.statusCode = statusCode;
+    this.protocol = protocol;
+  }
+
+  /**
+   * Retrieves the JSON-RPC integer code.
+   *
+   * @return The integer code (e.g., -32600).
+   */
+  public int getCode() {
+    return code;
+  }
+
+  /**
+   * Retrieves the standard JSON-RPC error message.
+   *
+   * @return The error message.
+   */
+  public String getMessage() {
+    return message;
+  }
+
+  /**
+   * Retrieves the corresponding HTTP status code.
+   *
+   * @return The Jooby {@link StatusCode}.
+   */
+  public StatusCode getStatusCode() {
+    return statusCode;
+  }
+
+  /**
+   * Indicates if this error is a core JSON-RPC 2.0 protocol error.
+   *
+   * @return True for strict protocol errors (-32700 to -32603), false for implementation-defined
+   *     errors.
+   */
+  public boolean isProtocol() {
+    return protocol;
+  }
+
+  /**
+   * Resolves the closest JSON-RPC error code for a given Jooby HTTP status code.
+   *
+   * <p>If an exact match is not found for the provided HTTP status, this method falls back to
+   * {@link #INTERNAL_ERROR}.
+   *
+   * @param status The Jooby HTTP status code.
+   * @return The corresponding {@code JsonRpcErrorCode}, or {@code INTERNAL_ERROR} if no match
+   *     exists.
+   */
+  public static JsonRpcErrorCode of(StatusCode status) {
+    for (var errorCode : values()) {
+      if (!errorCode.protocol && errorCode.statusCode.value() == status.value()) {
+        return errorCode;
+      }
+    }
+    return INTERNAL_ERROR;
+  }
+}
diff --git a/jooby/src/main/java/io/jooby/rpc/jsonrpc/JsonRpcException.java b/jooby/src/main/java/io/jooby/rpc/jsonrpc/JsonRpcException.java
new file mode 100644
index 0000000000..9566a124a8
--- /dev/null
+++ b/jooby/src/main/java/io/jooby/rpc/jsonrpc/JsonRpcException.java
@@ -0,0 +1,74 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.rpc.jsonrpc;
+
+/**
+ * Exception thrown when a JSON-RPC error occurs during routing, parsing, or execution.
+ *
+ * <p>Contains standard JSON-RPC 2.0 error codes. When caught by the dispatcher, this exception
+ * should be transformed into a {@link JsonRpcResponse} containing the error details.
+ */
+public class JsonRpcException extends RuntimeException {
+  private final JsonRpcErrorCode code;
+
+  private final Object data;
+
+  /**
+   * Constructs a new JSON-RPC exception.
+   *
+   * @param code The integer error code (preferably one of the standard constants).
+   * @param message A short description of the error.
+   */
+  public JsonRpcException(JsonRpcErrorCode code, String message) {
+    super(message);
+    this.code = code;
+    this.data = null;
+  }
+
+  /**
+   * Constructs a new JSON-RPC exception.
+   *
+   * @param code The integer error code (preferably one of the standard constants).
+   * @param message A short description of the error.
+   * @param cause The underlying cause of the error.
+   */
+  public JsonRpcException(JsonRpcErrorCode code, String message, Throwable cause) {
+    super(message, cause);
+    this.code = code;
+    this.data = null;
+  }
+
+  /**
+   * Constructs a new JSON-RPC exception with additional error data.
+   *
+   * @param code The integer error code.
+   * @param message A short description of the error.
+   * @param data Additional data about the error (e.g., stack trace or validation messages).
+   */
+  public JsonRpcException(JsonRpcErrorCode code, String message, Object data) {
+    super(message);
+    this.code = code;
+    this.data = data;
+  }
+
+  /**
+   * Returns the JSON-RPC error code.
+   *
+   * @return The JSON-RPC error code.
+   */
+  public JsonRpcErrorCode getCode() {
+    return code;
+  }
+
+  /**
+   * Returns additional data regarding the error.
+   *
+   * @return Additional data regarding the error, or null if none was provided.
+   */
+  public Object getData() {
+    return data;
+  }
+}
diff --git a/jooby/src/main/java/io/jooby/rpc/jsonrpc/JsonRpcModule.java b/jooby/src/main/java/io/jooby/rpc/jsonrpc/JsonRpcModule.java
new file mode 100644
index 0000000000..632731ee69
--- /dev/null
+++ b/jooby/src/main/java/io/jooby/rpc/jsonrpc/JsonRpcModule.java
@@ -0,0 +1,236 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.rpc.jsonrpc;
+
+import java.util.*;
+
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+import io.jooby.*;
+import io.jooby.exception.MissingValueException;
+import io.jooby.exception.TypeMismatchException;
+
+/**
+ * Global Tier 1 Dispatcher for JSON-RPC 2.0 requests. *
+ *
+ * <p>This dispatcher acts as the central entry point for all JSON-RPC traffic. It manages the
+ * lifecycle of a request by:
+ *
+ * <ul>
+ *   <li>Parsing the incoming body into a {@link JsonRpcRequest} (supporting both single and batch
+ *       shapes).
+ *   <li>Iterating through registered {@link JsonRpcService} instances to find a matching namespace.
+ *   <li>Handling <strong>Notifications</strong> (requests without an {@code id}) by suppressing
+ *       responses.
+ *   <li>Unifying batch results into a single JSON array or a single object response as per the
+ *       spec.
+ * </ul>
+ *
+ * <p>*
+ *
+ * <p>Usage:
+ *
+ * <pre>{@code
+ * install(new JsonRpcDispatcher());
+ * services().put(JsonRpcService.class, new MyServiceRpc(new MyService()));
+ * }</pre>
+ *
+ * @author Edgar Espina
+ * @since 4.0.17
+ */
+public class JsonRpcModule implements Extension {
+  private final Logger log = LoggerFactory.getLogger(JsonRpcService.class);
+  private final Map<String, JsonRpcService> services = new HashMap<>();
+  private final String path;
+
+  public JsonRpcModule(String path) {
+    this.path = path;
+  }
+
+  public void add(JsonRpcService service) {
+    for (var method : service.getMethods()) {
+      this.services.put(method, service);
+    }
+  }
+
+  /**
+   * Installs the JSON-RPC handler at the default {@code /rpc} endpoint.
+   *
+   * @param app The Jooby application instance.
+   * @throws Exception If registration fails.
+   */
+  @Override
+  public void install(Jooby app) throws Exception {
+    app.post(path, this::handle);
+
+    // Initialize the custom exception mapping registry
+    app.getServices()
+        .mapOf(Class.class, JsonRpcErrorCode.class)
+        .put(MissingValueException.class, JsonRpcErrorCode.INVALID_PARAMS)
+        .put(TypeMismatchException.class, JsonRpcErrorCode.INVALID_PARAMS);
+  }
+
+  /**
+   * Main handler for the JSON-RPC protocol. *
+   *
+   * <p>This method implements the flattened iteration logic. Because {@link JsonRpcRequest}
+   * implements {@code Iterable}, this handler treats single requests and batch requests identically
+   * during processing.
+   *
+   * @param ctx The current Jooby context.
+   * @return A single {@link JsonRpcResponse}, a {@code List} of responses for batches, or an empty
+   *     string for notifications.
+   */
+  private Object handle(Context ctx) {
+    JsonRpcRequest input;
+    try {
+      input = ctx.body(JsonRpcRequest.class);
+    } catch (Exception e) {
+      // Spec: -32700 Parse error if the JSON is physically malformed.
+      return JsonRpcResponse.error(null, JsonRpcErrorCode.PARSE_ERROR, e);
+    }
+
+    List<JsonRpcResponse> responses = new ArrayList<>();
+
+    // Look up all generated *Rpc classes registered in the service registry
+
+    for (var request : input) {
+      var fullMethod = request.getMethod();
+
+      // Spec: -32600 Invalid Request if the method member is missing or null
+      if (fullMethod == null) {
+        responses.add(
+            JsonRpcResponse.error(request.getId(), JsonRpcErrorCode.INVALID_REQUEST, null));
+        continue;
+      }
+
+      try {
+        var targetService = services.get(fullMethod);
+        if (targetService != null) {
+          var result = targetService.execute(ctx, request);
+          // Spec: If the "id" is missing, it is a notification and no response is returned.
+          if (request.getId() != null) {
+            responses.add(JsonRpcResponse.success(request.getId(), result));
+          }
+        } else {
+          // Spec: -32601 Method not found
+          if (request.getId() != null) {
+            responses.add(
+                JsonRpcResponse.error(
+                    request.getId(),
+                    JsonRpcErrorCode.METHOD_NOT_FOUND,
+                    "Method not found: " + fullMethod));
+          }
+        }
+      } catch (JsonRpcException cause) {
+        log(ctx, request, cause);
+        // Domain-specific or protocol-level exceptions (e.g., -32602 Invalid Params)
+        if (request.getId() != null) {
+          responses.add(JsonRpcResponse.error(request.getId(), cause.getCode(), cause.getCause()));
+        }
+      } catch (Exception cause) {
+        log(ctx, request, cause);
+        // Spec: -32603 Internal error for unhandled application exceptions
+        if (request.getId() != null) {
+          responses.add(
+              JsonRpcResponse.error(request.getId(), computeErrorCode(ctx, cause), cause));
+        }
+      }
+    }
+
+    // Handle the case where all requests in a batch were notifications
+    if (responses.isEmpty()) {
+      ctx.setResponseCode(StatusCode.NO_CONTENT);
+      return "";
+    }
+
+    // Spec: Return an array only if the original request was a batch
+    return input.isBatch() ? responses : responses.getFirst();
+  }
+
+  private void log(Context ctx, JsonRpcRequest request, Throwable cause) {
+    JsonRpcErrorCode code;
+    boolean hasCause = true;
+    if (cause instanceof JsonRpcException rpcException) {
+      code = rpcException.getCode();
+      hasCause = false;
+    } else {
+      code = computeErrorCode(ctx, cause);
+    }
+    var type = code == JsonRpcErrorCode.INTERNAL_ERROR ? "server" : "client";
+    var message = "JSON-RPC {} error [{} {}] on method '{}' (id: {})";
+    switch (code) {
+      case INTERNAL_ERROR ->
+          log.error(
+              message,
+              type,
+              code.getCode(),
+              code.getMessage(),
+              request.getMethod(),
+              request.getId(),
+              cause);
+      case UNAUTHORIZED, FORBIDDEN, NOT_FOUND_ERROR ->
+          log.debug(
+              message,
+              type,
+              code.getCode(),
+              code.getMessage(),
+              request.getMethod(),
+              request.getId(),
+              cause);
+      default -> {
+        if (hasCause) {
+          log.warn(
+              message,
+              type,
+              code.getCode(),
+              code.getMessage(),
+              request.getMethod(),
+              request.getId(),
+              cause);
+        } else {
+          log.debug(
+              message,
+              type,
+              code.getCode(),
+              code.getMessage(),
+              request.getMethod(),
+              request.getId());
+        }
+      }
+    }
+  }
+
+  private JsonRpcErrorCode computeErrorCode(Context ctx, Throwable cause) {
+    JsonRpcErrorCode code;
+    // Attempt to look up any user-defined exception mappings from the registry
+    Map<Class<?>, JsonRpcErrorCode> customMapping =
+        ctx.require(Reified.map(Class.class, JsonRpcErrorCode.class));
+    code =
+        errorCode(customMapping, cause)
+            .orElseGet(() -> JsonRpcErrorCode.of(ctx.getRouter().errorCode(cause)));
+    return code;
+  }
+
+  /**
+   * Evaluates the given exception against the registered custom exception mappings.
+   *
+   * @param mappings A map of Exception classes to specific tRPC error codes.
+   * @param x The exception to evaluate.
+   * @return An {@code Optional} containing the matched {@code TrpcErrorCode}, or empty if no match
+   *     is found.
+   */
+  private Optional<JsonRpcErrorCode> errorCode(
+      Map<Class<?>, JsonRpcErrorCode> mappings, Throwable x) {
+    for (var mapping : mappings.entrySet()) {
+      if (mapping.getKey().isInstance(x)) {
+        return Optional.of(mapping.getValue());
+      }
+    }
+    return Optional.empty();
+  }
+}
diff --git a/jooby/src/main/java/io/jooby/rpc/jsonrpc/JsonRpcParser.java b/jooby/src/main/java/io/jooby/rpc/jsonrpc/JsonRpcParser.java
new file mode 100644
index 0000000000..c42732ab62
--- /dev/null
+++ b/jooby/src/main/java/io/jooby/rpc/jsonrpc/JsonRpcParser.java
@@ -0,0 +1,50 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.rpc.jsonrpc;
+
+import java.lang.reflect.Type;
+
+/**
+ * The core JSON parsing SPI (Service Provider Interface) for JSON-RPC.
+ *
+ * <p>This factory is implemented by Jooby's JSON modules (such as Jackson or Avaje) and serves as
+ * the bridge between the parsed JSON-RPC request and the application's Java objects.
+ *
+ * <p><b>Startup Optimization:</b>
+ *
+ * <p>The Jooby Annotation Processor (APT) generates highly optimized routing code that relies on
+ * this interface. At application startup, the generated routes use this parser to eagerly resolve
+ * and cache type-specific {@link JsonRpcDecoder}s. This ensures that during actual HTTP requests,
+ * arguments are deserialized with near-zero reflection overhead.
+ */
+public interface JsonRpcParser {
+
+  /**
+   * Resolves and caches a type-specific deserializer during route initialization.
+   *
+   * <p>This method is invoked by the APT-generated code when the application starts. By eagerly
+   * requesting a decoder for complex generic types, the framework avoids expensive reflection
+   * lookups during runtime request processing.
+   *
+   * @param type The target Java type (e.g., {@code List<Movie>}, {@code User}) to decode.
+   * @param <T> The expected Java type.
+   * @return A highly optimized decoder capable of parsing generic JSON nodes into the target type.
+   */
+  <T> JsonRpcDecoder<T> decoder(Type type);
+
+  /**
+   * Creates a stateful reader for extracting JSON-RPC arguments from the request parameters.
+   *
+   * <p>Because JSON-RPC 2.0 parameters can be either positional (a JSON Array) or named (a JSON
+   * Object), this reader manages the extraction context to hand off the correct JSON segment to the
+   * pre-resolved {@link JsonRpcDecoder}s or extract primitives.
+   *
+   * @param params The parsed parameter object (typically a List or Map depending on the underlying
+   *     JSON library) from the {@link JsonRpcRequest}.
+   * @return A reader for argument extraction.
+   */
+  JsonRpcReader reader(Object params);
+}
diff --git a/jooby/src/main/java/io/jooby/rpc/jsonrpc/JsonRpcReader.java b/jooby/src/main/java/io/jooby/rpc/jsonrpc/JsonRpcReader.java
new file mode 100644
index 0000000000..2f6bd6696b
--- /dev/null
+++ b/jooby/src/main/java/io/jooby/rpc/jsonrpc/JsonRpcReader.java
@@ -0,0 +1,109 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.rpc.jsonrpc;
+
+import io.jooby.exception.MissingValueException;
+
+/**
+ * A stateful reader used at runtime to extract arguments from JSON-RPC parameters.
+ *
+ * <p>When a JSON-RPC client sends a request, it packs the arguments into the {@code params} field
+ * as either an Array (positional) or an Object (named). This reader acts as a cursor or keyed
+ * accessor over that structure. The Jooby Annotation Processor (APT) generates routing code that
+ * calls the {@code next*()} methods on this interface sequentially, perfectly matching the
+ * parameters in the target Java method.
+ *
+ * <p><b>Zero-Boxing Performance:</b>
+ *
+ * <p>To maximize throughput, this interface provides dedicated methods for extracting primitive
+ * types (e.g., {@link #nextInt(String)}, {@link #nextBoolean(String)}). This allows the underlying
+ * JSON parser to read numbers and booleans without ever boxing them into heap-allocated objects
+ * like {@code Integer} or {@code Boolean}.
+ *
+ * <p>Because it may hold resources (depending on the JSON library implementation), it implements
+ * {@link AutoCloseable} and must be closed after the final argument is read.
+ */
+public interface JsonRpcReader extends AutoCloseable {
+
+  /**
+   * Evaluates the next parameter to determine if it is a literal {@code null} or missing.
+   *
+   * @param name The logical name of the parameter being evaluated (used for named lookup or
+   *     context).
+   * @return {@code true} if the parameter is null or missing; {@code false} otherwise.
+   */
+  boolean nextIsNull(String name);
+
+  /**
+   * Asserts that the next parameter is not null.
+   *
+   * <p>This is a fast-fail mechanism generated by the APT for non-nullable primitive arguments
+   * (e.g., {@code int}, {@code double}) or explicitly required parameters.
+   *
+   * @param name The logical name of the parameter.
+   * @throws MissingValueException If the parameter evaluates to null or is missing.
+   */
+  default void requireNext(String name) {
+    if (nextIsNull(name)) {
+      throw new MissingValueException(name);
+    }
+  }
+
+  /**
+   * Reads the next parameter as a primitive 32-bit integer.
+   *
+   * @param name The logical name of the parameter.
+   * @return The extracted integer value.
+   */
+  int nextInt(String name);
+
+  /**
+   * Reads the next parameter as a primitive 64-bit integer.
+   *
+   * @param name The logical name of the parameter.
+   * @return The extracted long value.
+   */
+  long nextLong(String name);
+
+  /**
+   * Reads the next parameter as a primitive boolean.
+   *
+   * @param name The logical name of the parameter.
+   * @return The extracted boolean value.
+   */
+  boolean nextBoolean(String name);
+
+  /**
+   * Reads the next parameter as a primitive 64-bit floating-point number.
+   *
+   * @param name The logical name of the parameter.
+   * @return The extracted double value.
+   */
+  double nextDouble(String name);
+
+  /**
+   * Reads the next parameter as a String.
+   *
+   * @param name The logical name of the parameter.
+   * @return The extracted String value, or {@code null} if the parameter is a JSON null.
+   */
+  String nextString(String name);
+
+  /**
+   * Reads the next parameter (which may be a complex JSON object or array) and deserializes it
+   * using a pre-resolved type decoder.
+   *
+   * <p>This method delegates the heavy lifting of mapping arbitrary JSON structures to the
+   * underlying JSON engine via the provided {@link JsonRpcDecoder}.
+   *
+   * @param name The logical name of the parameter.
+   * @param decoder The optimized decoder created during application startup to handle this specific
+   *     type.
+   * @param <T> The target Java type.
+   * @return The fully deserialized Java object, or {@code null} if the parameter is a JSON null.
+   */
+  <T> T nextObject(String name, JsonRpcDecoder<T> decoder);
+}
diff --git a/jooby/src/main/java/io/jooby/rpc/jsonrpc/JsonRpcRequest.java b/jooby/src/main/java/io/jooby/rpc/jsonrpc/JsonRpcRequest.java
new file mode 100644
index 0000000000..761a593851
--- /dev/null
+++ b/jooby/src/main/java/io/jooby/rpc/jsonrpc/JsonRpcRequest.java
@@ -0,0 +1,149 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.rpc.jsonrpc;
+
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.Iterator;
+import java.util.List;
+
+import edu.umd.cs.findbugs.annotations.NonNull;
+
+/**
+ * Represents a JSON-RPC 2.0 Request object, and simultaneously acts as an iterable container for
+ * batch requests.
+ *
+ * <p><b>Single vs. Batch Processing:</b> <br>
+ * To seamlessly support JSON-RPC batching without complicating the generated routing layer, this
+ * class implements {@code Iterable<JsonRpcRequest>}.
+ *
+ * <ul>
+ *   <li>If the payload is a <b>single request</b>, iterating over this object yields exactly one
+ *       element (itself).
+ *   <li>If the payload is a <b>batch request</b>, the underlying JSON library's custom deserializer
+ *       will flag this instance as a batch and populate it with the parsed requests. Iterating over
+ *       it will yield each underlying request.
+ * </ul>
+ *
+ * <p>This class is intentionally independent of any specific JSON library. The underlying JSON
+ * provider (like Jackson or Avaje) is responsible for deserializing the {@code params} field into a
+ * generic structure (e.g., a List or a Map) and populating the batch state.
+ */
+public class JsonRpcRequest implements Iterable<JsonRpcRequest> {
+
+  /** A String specifying the version of the JSON-RPC protocol. MUST be exactly "2.0". */
+  private String jsonrpc = "2.0";
+
+  /** A String containing the name of the method to be invoked. */
+  private String method;
+
+  /**
+   * A Structured value that holds the parameter values to be used during the invocation of the
+   * method. Can be omitted, an Array (positional), or an Object (named).
+   */
+  private Object params;
+
+  /**
+   * An identifier established by the Client that MUST contain a String, Number, or NULL value if
+   * included. If it is not included it is assumed to be a notification.
+   */
+  private Object id;
+
+  // --- Batch State ---
+  private boolean batch;
+  private List<JsonRpcRequest> requests;
+
+  public JsonRpcRequest() {}
+
+  public String getJsonrpc() {
+    return jsonrpc;
+  }
+
+  public void setJsonrpc(String jsonrpc) {
+    this.jsonrpc = jsonrpc;
+  }
+
+  public String getMethod() {
+    return method;
+  }
+
+  public void setMethod(String method) {
+    this.method = method;
+  }
+
+  public Object getParams() {
+    return params;
+  }
+
+  public void setParams(Object params) {
+    this.params = params;
+  }
+
+  public Object getId() {
+    return id;
+  }
+
+  public void setId(Object id) {
+    this.id = id;
+  }
+
+  /**
+   * Identifies if this request object is acting as a container for a JSON-RPC batch array.
+   *
+   * @return {@code true} if this represents a batch, {@code false} if it is a single request.
+   */
+  public boolean isBatch() {
+    return batch;
+  }
+
+  public void setBatch(boolean batch) {
+    this.batch = batch;
+  }
+
+  /**
+   * Returns the underlying requests if this instance represents a batch.
+   *
+   * @return A list of requests, or {@code null} if this is a single request.
+   */
+  public List<JsonRpcRequest> getRequests() {
+    return requests == null ? List.of() : requests;
+  }
+
+  /**
+   * Populates this request as a batch container.
+   *
+   * @param requests The list of requests parsed from a JSON array.
+   */
+  public void setRequests(List<JsonRpcRequest> requests) {
+    this.requests = requests;
+    this.batch = true;
+  }
+
+  /**
+   * Adds a request to this batch container. If this is the first request added, it automatically
+   * converts this instance into a batch.
+   *
+   * @param request The JSON-RPC request to add.
+   * @return This instance for method chaining.
+   */
+  public JsonRpcRequest add(JsonRpcRequest request) {
+    if (this.requests == null) {
+      this.requests = new ArrayList<>();
+      this.batch = true;
+    }
+    this.requests.add(request);
+    return this;
+  }
+
+  @Override
+  public @NonNull Iterator<JsonRpcRequest> iterator() {
+    if (batch) {
+      return getRequests().iterator();
+    }
+    // If it's not a batch, it iterates over itself exactly once.
+    return Collections.singletonList(this).iterator();
+  }
+}
diff --git a/jooby/src/main/java/io/jooby/rpc/jsonrpc/JsonRpcResponse.java b/jooby/src/main/java/io/jooby/rpc/jsonrpc/JsonRpcResponse.java
new file mode 100644
index 0000000000..408703716b
--- /dev/null
+++ b/jooby/src/main/java/io/jooby/rpc/jsonrpc/JsonRpcResponse.java
@@ -0,0 +1,130 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.rpc.jsonrpc;
+
+/**
+ * Represents a JSON-RPC 2.0 Response object.
+ *
+ * <p>When an RPC call is made, the Server MUST reply with a Response, except in the case of
+ * Notifications. The Response is expressed as a single JSON Object.
+ */
+public class JsonRpcResponse {
+
+  private String jsonrpc = "2.0";
+  private Object result;
+  private ErrorDetail error;
+  private Object id;
+
+  public JsonRpcResponse() {}
+
+  private JsonRpcResponse(Object id, Object result, ErrorDetail error) {
+    this.id = id;
+    this.result = result;
+    this.error = error;
+  }
+
+  /**
+   * Creates a successful JSON-RPC response.
+   *
+   * @param id The id from the corresponding request.
+   * @param result The result of the invoked method.
+   * @return A populated JsonRpcResponse.
+   */
+  public static JsonRpcResponse success(Object id, Object result) {
+    return new JsonRpcResponse(id, result, null);
+  }
+
+  /**
+   * Creates an error JSON-RPC response.
+   *
+   * @param id The id from the corresponding request.
+   * @param code The error code.
+   * @param data Additional data about the error.
+   * @return A populated JsonRpcResponse.
+   */
+  public static JsonRpcResponse error(Object id, JsonRpcErrorCode code, Object data) {
+    return new JsonRpcResponse(
+        id, null, new ErrorDetail(code.getCode(), code.getMessage(), data(data)));
+  }
+
+  private static Object data(Object data) {
+    if (data instanceof Throwable cause) {
+      return cause.getMessage();
+    }
+    return data;
+  }
+
+  public String getJsonrpc() {
+    return jsonrpc;
+  }
+
+  public void setJsonrpc(String jsonrpc) {
+    this.jsonrpc = jsonrpc;
+  }
+
+  public Object getResult() {
+    return result;
+  }
+
+  public void setResult(Object result) {
+    this.result = result;
+  }
+
+  public ErrorDetail getError() {
+    return error;
+  }
+
+  public void setError(ErrorDetail error) {
+    this.error = error;
+  }
+
+  public Object getId() {
+    return id;
+  }
+
+  public void setId(Object id) {
+    this.id = id;
+  }
+
+  /** Represents the error object inside a JSON-RPC response. */
+  public static class ErrorDetail {
+    private int code;
+    private String message;
+    private Object data;
+
+    public ErrorDetail() {}
+
+    public ErrorDetail(int code, String message, Object data) {
+      this.code = code;
+      this.message = message;
+      this.data = data;
+    }
+
+    public int getCode() {
+      return code;
+    }
+
+    public void setCode(int code) {
+      this.code = code;
+    }
+
+    public String getMessage() {
+      return message;
+    }
+
+    public void setMessage(String message) {
+      this.message = message;
+    }
+
+    public Object getData() {
+      return data;
+    }
+
+    public void setData(Object data) {
+      this.data = data;
+    }
+  }
+}
diff --git a/jooby/src/main/java/io/jooby/rpc/jsonrpc/JsonRpcService.java b/jooby/src/main/java/io/jooby/rpc/jsonrpc/JsonRpcService.java
new file mode 100644
index 0000000000..5bb6d154cf
--- /dev/null
+++ b/jooby/src/main/java/io/jooby/rpc/jsonrpc/JsonRpcService.java
@@ -0,0 +1,37 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.rpc.jsonrpc;
+
+import java.util.List;
+
+import edu.umd.cs.findbugs.annotations.NonNull;
+import io.jooby.Context;
+
+/**
+ * Interface for generated JSON-RPC service glue code (*Rpc classes).
+ *
+ * <p>This interface allows the global {@link JsonRpcModule} to coordinate multiple JSON-RPC
+ * services on a single endpoint by checking which service supports a specific method namespace.
+ */
+public interface JsonRpcService {
+
+  /**
+   * List all RPC method exposed by this service.
+   *
+   * @return All RPC method exposed by this service.
+   */
+  List<String> getMethods();
+
+  /**
+   * Executes the requested method using the provided context and request data.
+   *
+   * @param ctx The current Jooby context.
+   * @param req The individual JSON-RPC request object.
+   * @return The result of the method invocation.
+   * @throws Exception If an error occurs during execution.
+   */
+  Object execute(@NonNull Context ctx, @NonNull JsonRpcRequest req) throws Exception;
+}
diff --git a/jooby/src/main/java/io/jooby/rpc/trpc/TrpcDecoder.java b/jooby/src/main/java/io/jooby/rpc/trpc/TrpcDecoder.java
new file mode 100644
index 0000000000..2c52b0b229
--- /dev/null
+++ b/jooby/src/main/java/io/jooby/rpc/trpc/TrpcDecoder.java
@@ -0,0 +1,42 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.rpc.trpc;
+
+/**
+ * A pre-resolved decoder used at runtime to deserialize tRPC network payloads into complex Java
+ * objects.
+ *
+ * <p>This interface is heavily utilized by the Jooby Annotation Processor (APT). When compiling
+ * tRPC-annotated controllers, the APT generates highly optimized routing code that resolves the
+ * appropriate {@code TrpcDecoder} for each method argument. By pre-resolving these decoders, Jooby
+ * efficiently parses incoming JSON payloads without incurring reflection overhead on every request.
+ *
+ * <p>Note: Primitive types and standard wrappers (like {@code int}, {@code String}, {@code
+ * boolean}) are typically handled directly by the {@code TrpcReader} rather than requiring a
+ * dedicated decoder.
+ *
+ * @param <T> The target Java type this decoder produces.
+ */
+public interface TrpcDecoder<T> {
+
+  /**
+   * Decodes a raw byte array payload into the target Java object.
+   *
+   * @param name The name of the parameter being decoded (useful for error reporting or wrapping).
+   * @param payload The raw JSON byte array received from the network.
+   * @return The fully deserialized Java object.
+   */
+  T decode(String name, byte[] payload);
+
+  /**
+   * Decodes a string payload into the target Java object.
+   *
+   * @param name The name of the parameter being decoded (useful for error reporting or wrapping).
+   * @param payload The JSON string received from the network.
+   * @return The fully deserialized Java object.
+   */
+  T decode(String name, String payload);
+}
diff --git a/jooby/src/main/java/io/jooby/rpc/trpc/TrpcErrorCode.java b/jooby/src/main/java/io/jooby/rpc/trpc/TrpcErrorCode.java
new file mode 100644
index 0000000000..f242f50d58
--- /dev/null
+++ b/jooby/src/main/java/io/jooby/rpc/trpc/TrpcErrorCode.java
@@ -0,0 +1,119 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.rpc.trpc;
+
+import io.jooby.StatusCode;
+
+/**
+ * Maps standard Jooby HTTP status codes to official tRPC error codes.
+ *
+ * <p>The tRPC specification dictates that failed requests must return specific JSON-RPC style
+ * integer codes (e.g., -32600) in the JSON response payload, alongside the standard HTTP status
+ * codes. This enumeration defines the canonical mapping between Jooby's {@link StatusCode} and the
+ * expected tRPC error shape.
+ *
+ * <p>When an exception is thrown within a tRPC route, Jooby uses this mapping to format the error
+ * response so the frontend {@code @trpc/client} can correctly parse and reconstruct the {@code
+ * TRPCClientError}.
+ */
+public enum TrpcErrorCode {
+
+  /** Invalid routing or parameters. Mapped to HTTP 400. */
+  BAD_REQUEST(-32600, StatusCode.BAD_REQUEST),
+
+  /** The server received invalid JSON. Mapped to HTTP 400. */
+  PARSE_ERROR(-32700, StatusCode.BAD_REQUEST),
+
+  /** Internal server error. Mapped to HTTP 500. */
+  INTERNAL_SERVER_ERROR(-32603, StatusCode.SERVER_ERROR),
+
+  /** Missing or invalid authentication. Mapped to HTTP 401. */
+  UNAUTHORIZED(-32001, StatusCode.UNAUTHORIZED),
+
+  /** Authenticated user lacks required permissions. Mapped to HTTP 403. */
+  FORBIDDEN(-32003, StatusCode.FORBIDDEN),
+
+  /** The requested resource or tRPC procedure was not found. Mapped to HTTP 404. */
+  NOT_FOUND(-32004, StatusCode.NOT_FOUND),
+
+  /**
+   * The HTTP method used is not supported by the procedure (e.g., GET on a mutation). Mapped to
+   * HTTP 405.
+   */
+  METHOD_NOT_SUPPORTED(-32005, StatusCode.METHOD_NOT_ALLOWED),
+
+  /** The request took too long to process. Mapped to HTTP 408. */
+  TIMEOUT(-32008, StatusCode.REQUEST_TIMEOUT),
+
+  /** State conflict, such as a duplicate database entry. Mapped to HTTP 409. */
+  CONFLICT(-32009, StatusCode.CONFLICT),
+
+  /** The client's preconditions were not met. Mapped to HTTP 412. */
+  PRECONDITION_FAILED(-32012, StatusCode.PRECONDITION_FAILED),
+
+  /** The incoming request payload exceeds the allowed limits. Mapped to HTTP 413. */
+  PAYLOAD_TOO_LARGE(-32013, StatusCode.REQUEST_ENTITY_TOO_LARGE),
+
+  /** The payload format is valid, but the content is semantically incorrect. Mapped to HTTP 422. */
+  UNPROCESSABLE_CONTENT(-32022, StatusCode.UNPROCESSABLE_ENTITY),
+
+  /** Rate limiting applied. Mapped to HTTP 429. */
+  TOO_MANY_REQUESTS(-32029, StatusCode.TOO_MANY_REQUESTS),
+
+  /** The client disconnected before the server could respond. Mapped to HTTP 499. */
+  CLIENT_CLOSED_REQUEST(-32099, StatusCode.CLIENT_CLOSED_REQUEST);
+
+  private final int rpcCode;
+  private final StatusCode statusCode;
+
+  /**
+   * Defines a tRPC error code mapping.
+   *
+   * @param rpcCode The JSON-RPC 2.0 compatible integer code specified by tRPC.
+   * @param statusCode The HTTP status code to return in the response headers.
+   */
+  TrpcErrorCode(int rpcCode, StatusCode statusCode) {
+    this.rpcCode = rpcCode;
+    this.statusCode = statusCode;
+  }
+
+  /**
+   * Retrieves the JSON-RPC style integer code.
+   *
+   * @return The tRPC integer code (e.g., -32600).
+   */
+  public int getRpcCode() {
+    return rpcCode;
+  }
+
+  /**
+   * Retrieves the corresponding HTTP status code.
+   *
+   * @return The Jooby {@link StatusCode}.
+   */
+  public StatusCode getStatusCode() {
+    return statusCode;
+  }
+
+  /**
+   * Resolves the closest tRPC error code for a given Jooby HTTP status code.
+   *
+   * <p>If an exact match is not found for the provided HTTP status, this method falls back to
+   * {@link #INTERNAL_SERVER_ERROR}.
+   *
+   * @param status The Jooby HTTP status code.
+   * @return The corresponding {@code TrpcErrorCode}, or {@code INTERNAL_SERVER_ERROR} if no match
+   *     exists.
+   */
+  public static TrpcErrorCode of(StatusCode status) {
+    for (var code : values()) {
+      if (code.statusCode.value() == status.value()) {
+        return code;
+      }
+    }
+    return INTERNAL_SERVER_ERROR; // Fallback
+  }
+}
diff --git a/jooby/src/main/java/io/jooby/rpc/trpc/TrpcErrorHandler.java b/jooby/src/main/java/io/jooby/rpc/trpc/TrpcErrorHandler.java
new file mode 100644
index 0000000000..c3ca751d3c
--- /dev/null
+++ b/jooby/src/main/java/io/jooby/rpc/trpc/TrpcErrorHandler.java
@@ -0,0 +1,86 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.rpc.trpc;
+
+import java.util.Map;
+import java.util.Optional;
+
+import edu.umd.cs.findbugs.annotations.NonNull;
+import io.jooby.Context;
+import io.jooby.ErrorHandler;
+import io.jooby.Reified;
+import io.jooby.StatusCode;
+
+/**
+ * A specialized error handler that formats exceptions into tRPC-compliant JSON responses.
+ *
+ * <p>This handler strictly listens for requests where the path begins with {@code /trpc/}. When an
+ * exception occurs during a tRPC procedure, this handler ensures the response matches the exact
+ * JSON envelope expected by the frontend {@code @trpc/client}, preventing the client from crashing
+ * due to unexpected HTML or plain-text error pages.
+ *
+ * <p><b>Custom Exception Mapping:</b>
+ *
+ * <p>By default, this handler translates standard Jooby {@link StatusCode}s into their
+ * corresponding {@link TrpcErrorCode}. However, you can register a custom {@code Map<Class<?>,
+ * TrpcErrorCode>} in the Jooby registry to map your own domain-specific exceptions directly to tRPC
+ * codes.
+ *
+ * <p>If the thrown exception is already a {@link TrpcException}, it is rendered directly without
+ * modification.
+ */
+public class TrpcErrorHandler implements ErrorHandler {
+
+  /**
+   * Applies the tRPC error formatting if the request is a tRPC call.
+   *
+   * @param ctx The current routing context.
+   * @param cause The exception that was thrown during the request lifecycle.
+   * @param code The default HTTP status code resolved by Jooby.
+   */
+  @Override
+  public void apply(@NonNull Context ctx, @NonNull Throwable cause, @NonNull StatusCode code) {
+    if (ctx.getRequestPath().startsWith("/trpc/")) {
+      TrpcException trpcError;
+      if (cause instanceof TrpcException) {
+        trpcError = (TrpcException) cause;
+      } else {
+        // Attempt to look up any user-defined exception mappings from the registry
+        Map<Class<?>, TrpcErrorCode> customMapping =
+            ctx.require(Reified.map(Class.class, TrpcErrorCode.class));
+
+        // Extract the target procedure name from the URL path
+        var procedure = ctx.getRequestPath().replace("/trpc/", "");
+
+        // Build the tRPC exception, falling back to the default HTTP status mapping if no custom
+        // map matches
+        trpcError =
+            new TrpcException(
+                procedure, errorCode(customMapping, cause).orElse(TrpcErrorCode.of(code)), cause);
+      }
+
+      // Render the response using the exact structure expected by the @trpc/client
+      ctx.setResponseCode(trpcError.getStatusCode()).render(trpcError.toMap());
+    }
+  }
+
+  /**
+   * Evaluates the given exception against the registered custom exception mappings.
+   *
+   * @param mappings A map of Exception classes to specific tRPC error codes.
+   * @param x The exception to evaluate.
+   * @return An {@code Optional} containing the matched {@code TrpcErrorCode}, or empty if no match
+   *     is found.
+   */
+  private Optional<TrpcErrorCode> errorCode(Map<Class<?>, TrpcErrorCode> mappings, Throwable x) {
+    for (var mapping : mappings.entrySet()) {
+      if (mapping.getKey().isInstance(x)) {
+        return Optional.of(mapping.getValue());
+      }
+    }
+    return Optional.empty();
+  }
+}
diff --git a/jooby/src/main/java/io/jooby/rpc/trpc/TrpcException.java b/jooby/src/main/java/io/jooby/rpc/trpc/TrpcException.java
new file mode 100644
index 0000000000..e4d79030fd
--- /dev/null
+++ b/jooby/src/main/java/io/jooby/rpc/trpc/TrpcException.java
@@ -0,0 +1,134 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.rpc.trpc;
+
+import java.util.LinkedHashMap;
+import java.util.Map;
+import java.util.Objects;
+import java.util.Optional;
+
+import io.jooby.StatusCode;
+
+/**
+ * A specialized runtime exception that encapsulates a tRPC error.
+ *
+ * <p>This exception is thrown when a tRPC procedure fails, either due to framework-level issues
+ * (like invalid JSON parsing or missing arguments) or user-thrown domain errors. It holds all the
+ * necessary context—the procedure name, the specific {@link TrpcErrorCode}, and the underlying
+ * cause—required to construct a compliant tRPC error response.
+ *
+ * <p>The frontend {@code @trpc/client} relies on a very specific JSON envelope to correctly
+ * reconstruct the {@code TRPCClientError} on the client side. The {@link #toMap()} method handles
+ * translating this Java exception into that exact nested map structure.
+ */
+public class TrpcException extends RuntimeException {
+  private final String procedure;
+  private final TrpcErrorCode errorCode;
+
+  /**
+   * Constructs a new tRPC exception using a standard Jooby HTTP status code.
+   *
+   * @param procedure The name of the tRPC procedure that failed (e.g., "movies.getById").
+   * @param code The Jooby HTTP status code, which will be mapped to its closest tRPC equivalent.
+   * @param cause The underlying exception that caused this failure.
+   */
+  public TrpcException(String procedure, StatusCode code, Throwable cause) {
+    this(procedure, TrpcErrorCode.of(code), cause);
+  }
+
+  /**
+   * Constructs a new tRPC exception using a specific tRPC error code.
+   *
+   * @param procedure The name of the tRPC procedure that failed.
+   * @param code The explicit tRPC error code.
+   * @param cause The underlying exception that caused this failure.
+   */
+  public TrpcException(String procedure, TrpcErrorCode code, Throwable cause) {
+    super(procedure + ": " + code.name(), cause);
+    this.procedure = procedure;
+    this.errorCode = code;
+  }
+
+  /**
+   * Constructs a new tRPC exception without an underlying cause.
+   *
+   * @param procedure The name of the tRPC procedure that failed.
+   * @param code The explicit tRPC error code.
+   */
+  public TrpcException(String procedure, TrpcErrorCode code) {
+    super(procedure + ": " + code.name());
+    this.procedure = procedure;
+    this.errorCode = code;
+  }
+
+  /**
+   * Constructs a new tRPC exception using a standard Jooby HTTP status code without an underlying
+   * cause.
+   *
+   * @param procedure The name of the tRPC procedure that failed.
+   * @param code The Jooby HTTP status code.
+   */
+  public TrpcException(String procedure, StatusCode code) {
+    this(procedure, TrpcErrorCode.of(code));
+  }
+
+  /**
+   * Gets the HTTP status code associated with this error.
+   *
+   * @return The Jooby {@link StatusCode} to be set in the HTTP response headers.
+   */
+  public StatusCode getStatusCode() {
+    return errorCode.getStatusCode();
+  }
+
+  /**
+   * Gets the name of the tRPC procedure that threw this exception.
+   *
+   * @return The procedure name (e.g., "movies.getById").
+   */
+  public String getProcedure() {
+    return procedure;
+  }
+
+  /**
+   * Serializes the exception into the exact JSON structure expected by the tRPC protocol.
+   *
+   * <p>The resulting map translates into the following JSON shape:
+   *
+   * <pre>{@code
+   * {
+   * "error": {
+   * "message": "The descriptive error message",
+   * "code": -32600,
+   * "data": {
+   * "code": "BAD_REQUEST",
+   * "httpStatus": 400,
+   * "path": "movies.getById"
+   * }
+   * }
+   * }
+   * }</pre>
+   *
+   * @return A nested map representing the JSON error envelope.
+   */
+  public Map<String, Object> toMap() {
+    Map<String, Object> data = new LinkedHashMap<>();
+    data.put("code", errorCode.name());
+    data.put("httpStatus", errorCode.getStatusCode().value());
+    data.put("path", procedure);
+
+    Map<String, Object> error = new LinkedHashMap<>();
+    error.put(
+        "message",
+        Optional.ofNullable(getCause())
+            .map(Throwable::getMessage)
+            .filter(Objects::nonNull)
+            .orElse(errorCode.name()));
+    error.put("code", errorCode.getRpcCode());
+    error.put("data", data);
+    return Map.of("error", error);
+  }
+}
diff --git a/jooby/src/main/java/io/jooby/rpc/trpc/TrpcModule.java b/jooby/src/main/java/io/jooby/rpc/trpc/TrpcModule.java
new file mode 100644
index 0000000000..ed80262cad
--- /dev/null
+++ b/jooby/src/main/java/io/jooby/rpc/trpc/TrpcModule.java
@@ -0,0 +1,73 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.rpc.trpc;
+
+import edu.umd.cs.findbugs.annotations.NonNull;
+import io.jooby.Extension;
+import io.jooby.Jooby;
+
+/**
+ * Jooby extension that enables tRPC support for the application.
+ *
+ * <p>This module is responsible for bootstrapping the required tRPC infrastructure, specifically
+ * the specialized error handling and the parameter parsing mechanisms needed to handle tRPC network
+ * payloads.
+ *
+ * <p><b>Prerequisites:</b>
+ *
+ * <p>Because tRPC relies heavily on JSON serialization, a JSON module (such as {@code
+ * JacksonModule}, or {@code AvajeJsonbModule}) <b>must</b> be installed before installing this
+ * module. The JSON module automatically registers the underlying {@link TrpcParser} that this
+ * extension requires.
+ *
+ * <p><b>Usage:</b>
+ *
+ * <pre>{@code
+ * {
+ * // 1. Install a JSON engine (Prerequisite)
+ * install(new JacksonModule());
+ *
+ * // 2. Install the tRPC extension
+ * install(new TrpcModule());
+ *
+ * // 3. Register your @Trpc annotated controllers
+ * mvc(new MovieService_());
+ * }
+ * }</pre>
+ */
+public class TrpcModule implements Extension {
+
+  /**
+   * Installs the tRPC extension into the Jooby application.
+   *
+   * <p>During installation, this method performs the following setup:
+   *
+   * <ul>
+   *   <li>Validates that a {@link TrpcParser} is available in the service registry.
+   *   <li>Initializes the registry map for custom {@code Class} to {@link TrpcErrorCode} mappings,
+   *       allowing developers to map domain exceptions to specific tRPC errors.
+   *   <li>Registers the {@link TrpcErrorHandler} globally to intercept and correctly format
+   *       exceptions thrown from {@code /trpc/*} endpoints.
+   * </ul>
+   *
+   * @param app The current Jooby application.
+   * @throws Exception If a required service (such as the {@code TrpcParser}) is missing from the
+   *     registry.
+   */
+  @Override
+  public void install(@NonNull Jooby app) throws Exception {
+    var services = app.getServices();
+
+    // Ensure a JSON module has provided the necessary parser
+    services.require(TrpcParser.class);
+
+    // Initialize the custom exception mapping registry
+    services.mapOf(Class.class, TrpcErrorCode.class);
+
+    // Register the specialized JSON-RPC error formatter
+    app.error(new TrpcErrorHandler());
+  }
+}
diff --git a/jooby/src/main/java/io/jooby/rpc/trpc/TrpcParser.java b/jooby/src/main/java/io/jooby/rpc/trpc/TrpcParser.java
new file mode 100644
index 0000000000..851c544b08
--- /dev/null
+++ b/jooby/src/main/java/io/jooby/rpc/trpc/TrpcParser.java
@@ -0,0 +1,66 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.rpc.trpc;
+
+import java.lang.reflect.Type;
+
+/**
+ * The core JSON parsing SPI (Service Provider Interface) for tRPC.
+ *
+ * <p>This factory is implemented by Jooby's JSON modules (such as Jackson, Gson, JSON-B, or Avaje)
+ * and serves as the bridge between incoming tRPC network payloads and the application's Java
+ * objects.
+ *
+ * <p><b>Startup Optimization:</b>
+ *
+ * <p>The Jooby Annotation Processor (APT) generates highly optimized routing code that relies on
+ * this interface. At application startup, the generated routes use this parser to eagerly resolve
+ * and cache type-specific {@link TrpcDecoder}s. This ensures that during actual HTTP requests,
+ * payloads are deserialized with near-zero reflection overhead.
+ */
+public interface TrpcParser {
+
+  /**
+   * Resolves and caches a type-specific deserializer during route initialization.
+   *
+   * <p>This method is invoked by the APT-generated code when the application starts. By eagerly
+   * requesting a decoder for complex generic types, the framework avoids expensive reflection
+   * lookups during runtime request processing.
+   *
+   * @param type The target Java type (e.g., {@code List<Movie>}, {@code User}) to decode.
+   * @param <T> The expected Java type.
+   * @return A highly optimized decoder capable of parsing network payloads into the target type.
+   */
+  <T> TrpcDecoder<T> decoder(Type type);
+
+  /**
+   * Creates a stateful, sequential reader for extracting tRPC arguments from a raw byte payload.
+   *
+   * <p>Because tRPC network payloads can either be a single value or a JSON array (tuple) of
+   * multiple arguments, this reader manages the cursor position to sequentially hand off the
+   * correct JSON segment to the pre-resolved {@link TrpcDecoder}s.
+   *
+   * @param payload The raw JSON byte array received from the network.
+   * @param isTuple {@code true} if the payload is a JSON array representing multiple arguments;
+   *     {@code false} if it represents a single, standalone argument.
+   * @return A reader for sequential argument extraction.
+   */
+  TrpcReader reader(byte[] payload, boolean isTuple);
+
+  /**
+   * Creates a stateful, sequential reader for extracting tRPC arguments from a string payload.
+   *
+   * <p>Because tRPC network payloads can either be a single value or a JSON array (tuple) of
+   * multiple arguments, this reader manages the cursor position to sequentially hand off the
+   * correct JSON segment to the pre-resolved {@link TrpcDecoder}s.
+   *
+   * @param payload The JSON string received from the network.
+   * @param isTuple {@code true} if the payload is a JSON array representing multiple arguments;
+   *     {@code false} if it represents a single, standalone argument.
+   * @return A reader for sequential argument extraction.
+   */
+  TrpcReader reader(String payload, boolean isTuple);
+}
diff --git a/jooby/src/main/java/io/jooby/rpc/trpc/TrpcReader.java b/jooby/src/main/java/io/jooby/rpc/trpc/TrpcReader.java
new file mode 100644
index 0000000000..3963b55f3f
--- /dev/null
+++ b/jooby/src/main/java/io/jooby/rpc/trpc/TrpcReader.java
@@ -0,0 +1,109 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.rpc.trpc;
+
+import io.jooby.exception.MissingValueException;
+
+/**
+ * A stateful, sequential reader used at runtime to extract arguments from a tRPC network payload.
+ *
+ * <p>When a tRPC client sends a request for a multi-argument method, it packs the arguments into a
+ * JSON array (a tuple). This reader acts as a cursor over that array. The Jooby Annotation
+ * Processor (APT) generates routing code that calls the {@code next*()} methods on this interface
+ * sequentially, perfectly matching the order of parameters in the target Java method.
+ *
+ * <p><b>Zero-Boxing Performance:</b>
+ *
+ * <p>To maximize throughput, this interface provides dedicated methods for extracting primitive
+ * types (e.g., {@link #nextInt(String)}, {@link #nextBoolean(String)}). This allows the underlying
+ * JSON parser (like Jackson or AvajeJsonb) to read numbers and booleans directly off the byte
+ * stream without ever boxing them into heap-allocated objects like {@code Integer} or {@code
+ * Boolean}.
+ *
+ * <p>Because it holds resources (like an open {@code JsonParser}), it implements {@link
+ * AutoCloseable} and must be closed after the final argument is read.
+ */
+public interface TrpcReader extends AutoCloseable {
+
+  /**
+   * Peeks at the next token in the JSON stream to determine if it is a literal {@code null}.
+   *
+   * @param name The logical name of the parameter being evaluated (used for context or error
+   *     reporting).
+   * @return {@code true} if the next token is null; {@code false} otherwise.
+   */
+  boolean nextIsNull(String name);
+
+  /**
+   * Asserts that the next token in the sequence is not null.
+   *
+   * <p>This is a fast-fail mechanism generated by the APT for non-nullable primitive arguments
+   * (e.g., {@code int}, {@code double}) or explicitly required parameters.
+   *
+   * @param name The logical name of the parameter.
+   * @throws MissingValueException If the next token evaluates to null.
+   */
+  default void requireNext(String name) {
+    if (nextIsNull(name)) {
+      throw new MissingValueException(name);
+    }
+  }
+
+  /**
+   * Reads the next token in the stream as a primitive 32-bit integer.
+   *
+   * @param name The logical name of the parameter.
+   * @return The extracted integer value.
+   */
+  int nextInt(String name);
+
+  /**
+   * Reads the next token in the stream as a primitive 64-bit integer.
+   *
+   * @param name The logical name of the parameter.
+   * @return The extracted long value.
+   */
+  long nextLong(String name);
+
+  /**
+   * Reads the next token in the stream as a primitive boolean.
+   *
+   * @param name The logical name of the parameter.
+   * @return The extracted boolean value.
+   */
+  boolean nextBoolean(String name);
+
+  /**
+   * Reads the next token in the stream as a primitive 64-bit floating-point number.
+   *
+   * @param name The logical name of the parameter.
+   * @return The extracted double value.
+   */
+  double nextDouble(String name);
+
+  /**
+   * Reads the next token in the stream as a String.
+   *
+   * @param name The logical name of the parameter.
+   * @return The extracted String value, or {@code null} if the token is a JSON null.
+   */
+  String nextString(String name);
+
+  /**
+   * Reads the next token (which may be a complex JSON object or array) and deserializes it using a
+   * pre-resolved type decoder.
+   *
+   * <p>This method delegates the heavy lifting of mapping arbitrary JSON structures to the
+   * underlying JSON engine (Jackson, Gson, etc.) via the provided {@link TrpcDecoder}.
+   *
+   * @param name The logical name of the parameter.
+   * @param decoder The optimized decoder created during application startup to handle this specific
+   *     type.
+   * @param <T> The target Java type.
+   * @return The fully deserialized Java object, or {@code null} if the token is a JSON null.
+   */
+  <T> T nextObject(String name, TrpcDecoder<T> decoder);
+}
diff --git a/jooby/src/main/java/io/jooby/rpc/trpc/TrpcResponse.java b/jooby/src/main/java/io/jooby/rpc/trpc/TrpcResponse.java
new file mode 100644
index 0000000000..dc3fbeccb9
--- /dev/null
+++ b/jooby/src/main/java/io/jooby/rpc/trpc/TrpcResponse.java
@@ -0,0 +1,52 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.rpc.trpc;
+
+import edu.umd.cs.findbugs.annotations.NonNull;
+import edu.umd.cs.findbugs.annotations.Nullable;
+
+/**
+ * A standardized envelope for successful tRPC responses.
+ *
+ * <p>Unlike standard REST endpoints which might return raw JSON objects or arrays directly, the
+ * tRPC protocol requires all successful procedure calls to wrap their actual payload inside a
+ * specific JSON envelope (specifically, a {@code data} property).
+ *
+ * <p>This immutable record ensures that the Jooby routing engine serializes the returned Java
+ * objects into the exact shape expected by the frontend {@code @trpc/client}, preventing parsing
+ * errors on the browser side.
+ *
+ * @param <T> The type of the underlying data being returned.
+ * @param data The actual payload to serialize to the client, or {@code null} if the procedure has
+ *     no return value.
+ */
+public record TrpcResponse<T>(@Nullable T data) {
+
+  /**
+   * Wraps a non-null payload into a compliant tRPC success envelope.
+   *
+   * @param data The actual data to return to the client (e.g., a specific {@code Movie} or {@code
+   *     List<Movie>}).
+   * @param <T> The type of the data.
+   * @return A tRPC response envelope containing the provided data.
+   */
+  public static @NonNull <T> TrpcResponse<T> of(@NonNull T data) {
+    return new TrpcResponse<>(data);
+  }
+
+  /**
+   * Creates an empty tRPC success envelope.
+   *
+   * <p>This is typically used by the Jooby routing engine to construct compliant network responses
+   * for procedures that return {@code void} or explicitly return no data.
+   *
+   * @param <T> The inferred type (usually {@code Void} or {@code Object}).
+   * @return A tRPC response envelope where the data property is explicitly null.
+   */
+  public static @NonNull <T> TrpcResponse<T> empty() {
+    return new TrpcResponse<>(null);
+  }
+}
diff --git a/jooby/src/main/java/module-info.java b/jooby/src/main/java/module-info.java
index d8382ec3b5..ce4d5c509e 100644
--- a/jooby/src/main/java/module-info.java
+++ b/jooby/src/main/java/module-info.java
@@ -14,6 +14,10 @@
   exports io.jooby.problem;
   exports io.jooby.value;
   exports io.jooby.output;
+  /* rpc */
+  exports io.jooby.rpc.jsonrpc;
+  exports io.jooby.rpc.grpc;
+  exports io.jooby.rpc.trpc;
 
   uses io.jooby.Server;
   uses io.jooby.SslProvider;
diff --git a/modules/jooby-apt/pom.xml b/modules/jooby-apt/pom.xml
index 2ee8a6add5..1cb5531646 100644
--- a/modules/jooby-apt/pom.xml
+++ b/modules/jooby-apt/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-apt</artifactId>
   <name>jooby-apt</name>
@@ -25,6 +25,13 @@
       <scope>test</scope>
     </dependency>
 
+    <dependency>
+      <groupId>io.jooby</groupId>
+      <artifactId>jooby-jackson3</artifactId>
+      <version>${jooby.version}</version>
+      <scope>test</scope>
+    </dependency>
+
     <dependency>
       <groupId>jakarta.validation</groupId>
       <artifactId>jakarta.validation-api</artifactId>
@@ -76,6 +83,7 @@
       <scope>test</scope>
     </dependency>
 
+
     <dependency>
       <groupId>io.jooby</groupId>
       <artifactId>jooby-test</artifactId>
diff --git a/modules/jooby-apt/src/main/java/io/jooby/apt/JoobyProcessor.java b/modules/jooby-apt/src/main/java/io/jooby/apt/JoobyProcessor.java
index 5beba9abd5..0426a3b9d5 100644
--- a/modules/jooby-apt/src/main/java/io/jooby/apt/JoobyProcessor.java
+++ b/modules/jooby-apt/src/main/java/io/jooby/apt/JoobyProcessor.java
@@ -129,21 +129,71 @@ public boolean process(Set<? extends TypeElement> annotations, RoundEnvironment
     try {
       if (roundEnv.processingOver()) {
         context.debug("Output:");
-        context.getRouters().forEach(it -> context.debug("  %s.java", it.getGeneratedType()));
+        // Print all generated types for both REST and RPC
+        context
+            .getRouters()
+            .forEach(
+                it -> {
+                  if (it.hasRestRoutes()) {
+                    context.debug("  %s", it.getRestGeneratedType());
+                  }
+                  if (it.hasJsonRpcRoutes()) {
+                    context.debug("  %s", it.getRpcGeneratedType());
+                  }
+                });
         return false;
       } else {
         var routeMap = buildRouteRegistry(annotations, roundEnv);
         verifyBeanValidationDependency(routeMap.values());
         for (var router : routeMap.values()) {
           try {
+            // Track the router unconditionally so routes are available in processingOver
             context.add(router);
-            var sourceCode = router.toSourceCode(null);
-            var sourceLocation = router.getGeneratedFilename();
-            onGeneratedSource(
-                router.getGeneratedType(), toJavaFileObject(sourceLocation, sourceCode));
-            context.debug("router %s: %s", router.getTargetType(), router.getGeneratedType());
-            router.getRoutes().forEach(it -> context.debug("   %s", it));
-            writeSource(router, sourceLocation, sourceCode);
+
+            // 1. Generate Standard REST/tRPC File (e.g., MovieService_.java)
+            if (router.hasRestRoutes()) {
+              var restSource = router.getRestSourceCode(null);
+              if (restSource != null) {
+                var sourceLocation = router.getRestGeneratedFilename();
+                var generatedType = router.getRestGeneratedType();
+                onGeneratedSource(generatedType, toJavaFileObject(sourceLocation, restSource));
+
+                context.debug("router %s: %s", router.getTargetType(), generatedType);
+                router.getRoutes().stream()
+                    .filter(it -> !it.isJsonRpc())
+                    .forEach(it -> context.debug("   %s", it));
+
+                writeSource(
+                    router.isKt(),
+                    generatedType,
+                    sourceLocation,
+                    restSource,
+                    router.getTargetType());
+              }
+            }
+
+            // 2. Generate JSON-RPC File (e.g., MovieServiceRpc_.java)
+            if (router.hasJsonRpcRoutes()) {
+              var rpcSource = router.getRpcSourceCode(null);
+              if (rpcSource != null) {
+                var sourceLocation = router.getRpcGeneratedFilename();
+                var generatedType = router.getRpcGeneratedType();
+                onGeneratedSource(generatedType, toJavaFileObject(sourceLocation, rpcSource));
+
+                context.debug("jsonrpc router %s: %s", router.getTargetType(), generatedType);
+                router.getRoutes().stream()
+                    .filter(MvcRoute::isJsonRpc)
+                    .forEach(it -> context.debug("   %s", it));
+
+                writeSource(
+                    router.isKt(),
+                    generatedType,
+                    sourceLocation,
+                    rpcSource,
+                    router.getTargetType());
+              }
+            }
+
           } catch (IOException cause) {
             throw new RuntimeException("Unable to generate: " + router.getTargetType(), cause);
           }
@@ -157,25 +207,29 @@ public boolean process(Set<? extends TypeElement> annotations, RoundEnvironment
     }
   }
 
-  private void writeSource(MvcRouter router, String sourceLocation, String sourceCode)
+  private void writeSource(
+      boolean isKt,
+      String className,
+      String sourceLocation,
+      String sourceCode,
+      Element... originatingElements)
       throws IOException {
     var environment = context.getProcessingEnvironment();
     var filer = environment.getFiler();
-    if (router.isKt()) {
+    if (isKt) {
       var kapt = environment.getOptions().get("kapt.kotlin.generated");
       if (kapt != null) {
         var output = Paths.get(kapt, sourceLocation);
         Files.createDirectories(output.getParent());
         Files.writeString(output, sourceCode);
       } else {
-        var ktFile =
-            filer.createResource(SOURCE_OUTPUT, "", sourceLocation, router.getTargetType());
+        var ktFile = filer.createResource(SOURCE_OUTPUT, "", sourceLocation, originatingElements);
         try (var writer = ktFile.openWriter()) {
           writer.write(sourceCode);
         }
       }
     } else {
-      var javaFIle = filer.createSourceFile(router.getGeneratedType(), router.getTargetType());
+      var javaFIle = filer.createSourceFile(className, originatingElements);
       try (var writer = javaFIle.openWriter()) {
         writer.write(sourceCode);
       }
@@ -223,12 +277,18 @@ private Map<TypeElement, MvcRouter> buildRouteRegistry(
       for (var element : elements) {
         context.debug("  %s", element);
         if (element instanceof TypeElement typeElement) {
+          // FORCE INIT: Ensures MvcRouter constructor executes our JsonRpc class-level rules
+          registry.computeIfAbsent(typeElement, type -> new MvcRouter(context, type));
           buildRouteRegistry(registry, typeElement);
         } else if (element instanceof ExecutableElement method) {
-          buildRouteRegistry(registry, (TypeElement) method.getEnclosingElement());
+          TypeElement typeElement = (TypeElement) method.getEnclosingElement();
+          // FORCE INIT
+          registry.computeIfAbsent(typeElement, type -> new MvcRouter(context, type));
+          buildRouteRegistry(registry, typeElement);
         }
       }
     }
+
     // Remove all abstract router
     var abstractTypes =
         registry.entrySet().stream()
@@ -239,22 +299,51 @@ private Map<TypeElement, MvcRouter> buildRouteRegistry(
 
     // Generate unique method name by router
     for (var router : registry.values()) {
-      // Initialize with supports/create method from MvcFactory (avoid name collision)
-      var names = new HashSet<>();
-      for (var route : router.getRoutes()) {
-        if (!names.add(route.getMethodName())) {
+      // Split routes by their target generated classes to avoid false collisions
+      var restAndTrpcRoutes = router.getRoutes().stream().filter(r -> !r.isJsonRpc()).toList();
+
+      var rpcRoutes = router.getRoutes().stream().filter(MvcRoute::isJsonRpc).toList();
+
+      resolveGeneratedNames(restAndTrpcRoutes);
+      resolveGeneratedNames(rpcRoutes);
+    }
+    return registry;
+  }
+
+  private void resolveGeneratedNames(List<MvcRoute> routes) {
+    // Group by the actual target method name in the generated class
+    var grouped =
+        routes.stream()
+            .collect(
+                Collectors.groupingBy(
+                    route -> {
+                      String baseName = route.getMethodName();
+                      return route.isTrpc()
+                          ? "trpc"
+                              + Character.toUpperCase(baseName.charAt(0))
+                              + baseName.substring(1)
+                          : baseName;
+                    }));
+
+    for (var overloads : grouped.values()) {
+      if (overloads.size() == 1) {
+        // No conflict in this specific output file, use the clean original name
+        overloads.get(0).setGeneratedName(overloads.get(0).getMethodName());
+      } else {
+        // Conflict detected: generate names based on parameter types
+        for (var route : overloads) {
           var paramsString =
               route.getRawParameterTypes(true).stream()
                   .map(it -> it.substring(Math.max(0, it.lastIndexOf(".") + 1)))
                   .map(it -> Character.toUpperCase(it.charAt(0)) + it.substring(1))
                   .collect(Collectors.joining());
+
+          // A 0-arg method gets exactly the base name.
+          // Methods with args get the base name + their parameter types.
           route.setGeneratedName(route.getMethodName() + paramsString);
-        } else {
-          route.setGeneratedName(route.getMethodName());
         }
       }
     }
-    return registry;
   }
 
   /**
@@ -297,7 +386,7 @@ private void buildRouteRegistry(Map<TypeElement, MvcRouter> registry, TypeElemen
                 }
               });
       if (!currentType.equals(superType)) {
-        // edge-case #1: when controller has no method and extends another class which has.
+        // edge-case #1: when a controller has no method and extends another class which has.
         // edge-case #2: some odd usage a controller could be empty.
         // See https://github.com/jooby-project/jooby/issues/3656
         if (registry.containsKey(superType)) {
@@ -344,7 +433,7 @@ public Set<String> getSupportedOptions() {
    * <p>Example usage:
    *
    * <pre>public void run() {
-   *     throw sneakyThrow(new IOException("You don't need to catch me!"));
+   * throw sneakyThrow(new IOException("You don't need to catch me!"));
    * }</pre>
    *
    * <p>NB: The exception is not wrapped, ignored, swallowed, or redefined. The JVM actually does
diff --git a/modules/jooby-apt/src/main/java/io/jooby/internal/apt/CodeBlock.java b/modules/jooby-apt/src/main/java/io/jooby/internal/apt/CodeBlock.java
index 86e2c43d85..3fa2a04857 100644
--- a/modules/jooby-apt/src/main/java/io/jooby/internal/apt/CodeBlock.java
+++ b/modules/jooby-apt/src/main/java/io/jooby/internal/apt/CodeBlock.java
@@ -35,6 +35,10 @@ public static CharSequence semicolon(boolean kt) {
     return kt ? "" : ";";
   }
 
+  public static CharSequence var(boolean kt) {
+    return kt ? "val " : "var ";
+  }
+
   public static String indent(int count) {
     return " ".repeat(count);
   }
diff --git a/modules/jooby-apt/src/main/java/io/jooby/internal/apt/HttpMethod.java b/modules/jooby-apt/src/main/java/io/jooby/internal/apt/HttpMethod.java
index 4481b567a3..f7d2026edc 100644
--- a/modules/jooby-apt/src/main/java/io/jooby/internal/apt/HttpMethod.java
+++ b/modules/jooby-apt/src/main/java/io/jooby/internal/apt/HttpMethod.java
@@ -27,7 +27,15 @@ public enum HttpMethod implements AnnotationSupport {
   OPTIONS,
   PATCH,
   POST,
-  PUT;
+  PUT,
+  // Special
+  tRPC(
+      List.of(
+          "io.jooby.annotation.Trpc",
+          "io.jooby.annotation.Trpc.Mutation",
+          "io.jooby.annotation.Trpc.Query")),
+  JSON_RPC(List.of("io.jooby.annotation.JsonRpc"));
+
   private final List<String> annotations;
 
   HttpMethod(String... packages) {
@@ -36,13 +44,10 @@ public enum HttpMethod implements AnnotationSupport {
     this.annotations = packageList.stream().map(it -> it + "." + name()).toList();
   }
 
-  /**
-   * Look at path attribute over HTTP method annotation (like io.jooby.annotation.GET) or fallback
-   * to Path annotation.
-   *
-   * @param element Type or Method.
-   * @return Path.
-   */
+  HttpMethod(List<String> annotations) {
+    this.annotations = annotations;
+  }
+
   public List<String> path(Element element) {
     var path =
         annotations.stream()
@@ -54,28 +59,19 @@ public List<String> path(Element element) {
     return path.isEmpty() ? HttpPath.PATH.path(element) : path;
   }
 
-  /**
-   * Look at consumes attribute over HTTP method annotation (like io.jooby.annotation.GET) or
-   * fallback to Consumes annotation.
-   *
-   * @param element Type or Method.
-   * @return Consumes media type.
-   */
   public List<String> consumes(Element element) {
     return mediaType(element, HttpMediaType.Consumes, "consumes"::equals);
   }
 
-  /**
-   * Look at produces attribute over HTTP method annotation (like io.jooby.annotation.GET) or
-   * fallback to Produces annotation.
-   *
-   * @param element Type or Method.
-   * @return Produces media type.
-   */
   public List<String> produces(Element element) {
     return mediaType(element, HttpMediaType.Produces, "produces"::equals);
   }
 
+  public boolean matches(Element element) {
+    return annotations.stream()
+        .anyMatch(it -> AnnotationSupport.findAnnotationByName(element, it) != null);
+  }
+
   private List<String> mediaType(
       Element element, HttpMediaType mediaType, Predicate<String> filter) {
     var path =
diff --git a/modules/jooby-apt/src/main/java/io/jooby/internal/apt/HttpPath.java b/modules/jooby-apt/src/main/java/io/jooby/internal/apt/HttpPath.java
index 60e285d9e7..1be305048a 100644
--- a/modules/jooby-apt/src/main/java/io/jooby/internal/apt/HttpPath.java
+++ b/modules/jooby-apt/src/main/java/io/jooby/internal/apt/HttpPath.java
@@ -32,10 +32,14 @@ public List<String> getAnnotations() {
    * @return Path or empty list.
    */
   public List<String> path(Collection<TypeElement> hierarchy) {
+    return path(hierarchy, getAnnotations());
+  }
+
+  private List<String> path(Collection<TypeElement> hierarchy, List<String> annotations) {
     var prefix = Collections.<String>emptyList();
     var it = hierarchy.iterator();
     while (prefix.isEmpty() && it.hasNext()) {
-      prefix = path(it.next());
+      prefix = path(it.next(), annotations);
     }
     return prefix;
   }
@@ -47,7 +51,17 @@ public List<String> path(Collection<TypeElement> hierarchy) {
    * @return Path or empty list.
    */
   public List<String> path(Element element) {
-    return getAnnotations().stream()
+    return path(element, getAnnotations());
+  }
+
+  /**
+   * Find Path from method or class.
+   *
+   * @param element Method or Class.
+   * @return Path or empty list.
+   */
+  private List<String> path(Element element, List<String> annotations) {
+    return annotations.stream()
         .map(it -> AnnotationSupport.findAnnotationByName(element, it))
         .filter(Objects::nonNull)
         .findFirst()
diff --git a/modules/jooby-apt/src/main/java/io/jooby/internal/apt/MvcContext.java b/modules/jooby-apt/src/main/java/io/jooby/internal/apt/MvcContext.java
index 6a4a441a9c..3a19fd61f9 100644
--- a/modules/jooby-apt/src/main/java/io/jooby/internal/apt/MvcContext.java
+++ b/modules/jooby-apt/src/main/java/io/jooby/internal/apt/MvcContext.java
@@ -127,6 +127,10 @@ public boolean nonBlocking(TypeMirror returnType) {
     return entry != null;
   }
 
+  public ReactiveType getReactiveType(TypeMirror type) {
+    return findMappingHandler(type);
+  }
+
   private ReactiveType findMappingHandler(TypeMirror type) {
     for (var e : reactiveTypeMap.entrySet()) {
       var that = e.getKey();
diff --git a/modules/jooby-apt/src/main/java/io/jooby/internal/apt/MvcParameter.java b/modules/jooby-apt/src/main/java/io/jooby/internal/apt/MvcParameter.java
index 107f177516..6e8038a90d 100644
--- a/modules/jooby-apt/src/main/java/io/jooby/internal/apt/MvcParameter.java
+++ b/modules/jooby-apt/src/main/java/io/jooby/internal/apt/MvcParameter.java
@@ -37,6 +37,10 @@ public TypeDefinition getType() {
     return type;
   }
 
+  public String getName() {
+    return parameter.getSimpleName().toString();
+  }
+
   public String generateMapping(boolean kt) {
     var strategy =
         annotations.entrySet().stream()
diff --git a/modules/jooby-apt/src/main/java/io/jooby/internal/apt/MvcRoute.java b/modules/jooby-apt/src/main/java/io/jooby/internal/apt/MvcRoute.java
index b50423de28..97024e3337 100644
--- a/modules/jooby-apt/src/main/java/io/jooby/internal/apt/MvcRoute.java
+++ b/modules/jooby-apt/src/main/java/io/jooby/internal/apt/MvcRoute.java
@@ -11,6 +11,7 @@
 import static java.util.Optional.ofNullable;
 
 import java.util.*;
+import java.util.function.Consumer;
 import java.util.function.Function;
 import java.util.stream.Collectors;
 import java.util.stream.Stream;
@@ -31,6 +32,11 @@ public class MvcRoute {
   private final boolean suspendFun;
   private boolean uncheckedCast;
   private final boolean hasBeanValidation;
+  private final Set<String> pending = new HashSet<>();
+
+  private boolean isTrpc = false;
+  private boolean isJsonRpc = false;
+  private HttpMethod resolvedTrpcMethod = null;
 
   public MvcRoute(MvcContext context, MvcRouter router, ExecutableElement method) {
     this.context = context;
@@ -72,12 +78,15 @@ public String getProjection() {
           .findFirst()
           .orElse(null);
     }
-    // look inside the method annotation
     var httpMethod = annotationMap.values().iterator().next();
     var projection = AnnotationSupport.findAnnotationValue(httpMethod, "projection"::equals);
     return projection.stream().findFirst().orElse(null);
   }
 
+  public boolean isTrpc() {
+    return isTrpc;
+  }
+
   public boolean isProjection() {
     if (returnType.is(Types.PROJECTED)) {
       return false;
@@ -86,7 +95,6 @@ public boolean isProjection() {
     if (isProjection) {
       return true;
     }
-    // look inside the method annotation
     var httpMethod = annotationMap.values().iterator().next();
     var projection = AnnotationSupport.findAnnotationValue(httpMethod, "projection"::equals);
     return !projection.isEmpty();
@@ -123,6 +131,10 @@ public TypeMirror getReturnTypeHandler() {
   }
 
   public List<String> generateMapping(boolean kt) {
+    if (isJsonRpc) {
+      return Collections.emptyList();
+    }
+
     List<String> block = new ArrayList<>();
     var methodName = getGeneratedName();
     var returnType = getReturnType();
@@ -138,45 +150,62 @@ public List<String> generateMapping(boolean kt) {
                 + context.generateRouterName(router.getTargetType().getSimpleName().toString())
                 + "::"
             : "this::";
+
     for (var e : entries) {
       var lastHttpMethod = lastRoute && entries.get(entries.size() - 1).equals(e);
       var annotation = e.getKey();
       var httpMethod = HttpMethod.findByAnnotationName(annotation.getQualifiedName().toString());
+      var dslMethod = annotation.getSimpleName().toString().toLowerCase();
       var paths = context.path(router.getTargetType(), method, annotation);
+      var targetMethod = methodName;
+
+      if (httpMethod == HttpMethod.tRPC) {
+        resolvedTrpcMethod = trpcMethod(method);
+        if (resolvedTrpcMethod == null) {
+          throw new IllegalArgumentException(
+              "tRPC method not found: "
+                  + method.getSimpleName()
+                  + "() in "
+                  + router.getTargetType());
+        }
+        dslMethod = resolvedTrpcMethod.name().toLowerCase();
+        paths = List.of(trpcPath(method));
+        targetMethod =
+            "trpc" + targetMethod.substring(0, 1).toUpperCase() + targetMethod.substring(1);
+        this.isTrpc = true;
+      }
+
+      pending.add(targetMethod);
+
       for (var path : paths) {
-        var lastLine = lastHttpMethod && paths.get(paths.size() - 1).equals(path);
+        var lastLine = lastHttpMethod && paths.getLast().equals(path);
         block.add(javadocLink);
         block.add(
             statement(
                 isSuspendFun() ? "" : "app.",
-                annotation.getSimpleName().toString().toLowerCase(),
+                dslMethod,
                 "(",
                 string(leadingSlash(path)),
                 ", ",
                 context.pipeline(
-                    getReturnTypeHandler(), methodReference(kt, thisRef, methodName))));
+                    getReturnTypeHandler(), methodReference(kt, thisRef, targetMethod))));
         if (context.nonBlocking(getReturnTypeHandler()) || isSuspendFun()) {
           block.add(statement(indent(2), ".setNonBlocking(true)"));
         }
-        /* consumes */
         mediaType(httpMethod::consumes)
             .ifPresent(consumes -> block.add(statement(indent(2), ".setConsumes(", consumes, ")")));
-        /* produces */
         mediaType(httpMethod::produces)
             .ifPresent(produces -> block.add(statement(indent(2), ".setProduces(", produces, ")")));
-        /* dispatch */
         dispatch()
             .ifPresent(
                 dispatch ->
                     block.add(statement(indent(2), ".setExecutorKey(", string(dispatch), ")")));
-        /* attributes */
         attributeGenerator
             .toSourceCode(kt, this, 2)
             .ifPresent(
                 attributes -> block.add(statement(indent(2), ".setAttributes(", attributes, ")")));
         var lineSep = lastLine ? lineSeparator() : lineSeparator() + lineSeparator();
         if (context.generateMvcMethod()) {
-          /* mvcMethod */
           block.add(
               CodeBlock.of(
                   indent(2),
@@ -218,12 +247,6 @@ private String methodReference(boolean kt, String thisRef, String methodName) {
     return thisRef + methodName + ")";
   }
 
-  /**
-   * Ensure path start with a <code>/</code>(leading slash).
-   *
-   * @param path Path to process.
-   * @return Path with leading slash.
-   */
   static String leadingSlash(String path) {
     if (path == null || path.isEmpty() || path.equals("/")) {
       return "/";
@@ -231,32 +254,449 @@ static String leadingSlash(String path) {
     return path.charAt(0) == '/' ? path : "/" + path;
   }
 
-  public List<String> generateHandlerCall(boolean kt) {
+  public List<String> generateJsonRpcDispatchCase(boolean kt) {
     var buffer = new ArrayList<String>();
-    /* Parameters */
     var paramList = new StringJoiner(", ", "(", ")");
-    for (var parameter : getParameters(true)) {
-      String generatedParameter = parameter.generateMapping(kt);
-      if (parameter.isRequireBeanValidation()) {
-        generatedParameter =
-            CodeBlock.of(
-                "io.jooby.validation.BeanValidator.apply(", "ctx, ", generatedParameter, ")");
+
+    // Check if we have any parameters that actually need to be parsed from the JSON payload.
+    // We ignore Jooby's Context and Kotlin's Continuation since they are provided by the framework.
+    boolean needsReader =
+        parameters.stream()
+            .anyMatch(
+                p -> {
+                  String type = p.getType().toString();
+                  return !type.equals("io.jooby.Context")
+                      && !type.startsWith("kotlin.coroutines.Continuation");
+                });
+
+    if (needsReader) {
+      if (kt) {
+        buffer.add(statement(indent(8), "parser.reader(req.params).use { reader ->"));
+      } else {
+        buffer.add(statement(indent(8), "try (var reader = parser.reader(req.getParams())) {"));
       }
+    }
+
+    // This method will now be responsible for pushing "ctx" directly to paramList
+    // for Context parameters, instead of reading them from the JSON.
+    buffer.addAll(generateRpcParameter(kt, paramList::add, true));
+
+    // Dynamically adjust indentation based on whether the reader block was opened
+    int callIndent = needsReader ? 10 : 8;
+    var call = CodeBlock.of("c.", getMethodName(), paramList.toString());
 
-      paramList.add(generatedParameter);
+    if (returnType.isVoid()) {
+      buffer.add(statement(indent(callIndent), call, semicolon(kt)));
+      buffer.add(statement(indent(callIndent), kt ? "null" : "return null", semicolon(kt)));
+    } else {
+      buffer.add(statement(indent(callIndent), kt ? call : "return " + call, semicolon(kt)));
+    }
+
+    if (needsReader) {
+      buffer.add(statement(indent(8), "}"));
     }
-    var throwsException = !method.getThrownTypes().isEmpty();
-    var returnTypeGenerics =
-        getReturnType().getArgumentsString(kt, false, Set.of(TypeKind.TYPEVAR));
-    var returnTypeString = type(kt, getReturnType().toString());
-    var customReturnType = getReturnType();
-    if (customReturnType.isProjection()) {
-      // Override for projection
-      returnTypeGenerics = "";
-      returnTypeString = Types.PROJECTED + "<" + returnType + ">";
+
+    return buffer;
+  }
+
+  public List<String> generateHandlerCall(boolean kt) {
+    if (isJsonRpc) {
+      return Collections.emptyList();
     }
 
-    boolean nullable = false;
+    var buffer = new ArrayList<String>();
+    var methodName =
+        isTrpc
+            ? "trpc"
+                + getGeneratedName().substring(0, 1).toUpperCase()
+                + getGeneratedName().substring(1)
+            : getGeneratedName();
+
+    if (pending.contains(methodName)) {
+      var paramList = new StringJoiner(", ", "(", ")");
+      var returnTypeGenerics =
+          getReturnType().getArgumentsString(kt, false, Set.of(TypeKind.TYPEVAR));
+      var returnTypeString = type(kt, getReturnType().toString());
+      var customReturnType = getReturnType();
+
+      if (customReturnType.isProjection()) {
+        returnTypeGenerics = "";
+        returnTypeString = Types.PROJECTED + "<" + returnType + ">";
+      }
+
+      var reactive = isTrpc ? context.getReactiveType(returnType.getRawType()) : null;
+      var isReactiveVoid = false;
+      var innerReactiveType = "Object";
+
+      var methodReturnTypeString = returnTypeString;
+      if (isTrpc) {
+        if (reactive != null) {
+          var rawReactiveType = type(kt, returnType.getRawType().toString());
+          if (!returnType.getArguments().isEmpty()) {
+            innerReactiveType = type(kt, returnType.getArguments().get(0).getRawType().toString());
+            if (innerReactiveType.equals("java.lang.Void") || innerReactiveType.equals("Void")) {
+              isReactiveVoid = true;
+              innerReactiveType = kt ? "Unit" : "Void";
+            }
+          } else if (rawReactiveType.contains("Completable")) {
+            isReactiveVoid = true;
+            innerReactiveType = kt ? "Unit" : "Void";
+          }
+          methodReturnTypeString =
+              rawReactiveType + "<io.jooby.rpc.trpc.TrpcResponse<" + innerReactiveType + ">>";
+        } else {
+          methodReturnTypeString =
+              "io.jooby.rpc.trpc.TrpcResponse<"
+                  + (returnType.isVoid() ? (kt ? "Unit" : "Void") : returnTypeString)
+                  + ">";
+        }
+      }
+
+      var nullable =
+          methodCallHeader(
+              kt,
+              "ctx",
+              methodName,
+              buffer,
+              returnTypeGenerics,
+              methodReturnTypeString,
+              isTrpc || !method.getThrownTypes().isEmpty());
+
+      int controllerIndent = 2;
+
+      if (isTrpc && !parameters.isEmpty()) {
+        controllerIndent = 4;
+        buffer.add(
+            statement(
+                indent(2),
+                var(kt),
+                "parser = ctx.require(io.jooby.rpc.trpc.TrpcParser",
+                clazz(kt),
+                ")",
+                semicolon(kt)));
+
+        long trpcPayloadCount =
+            parameters.stream()
+                .filter(
+                    p -> {
+                      String type = p.getType().getRawType().toString();
+                      return !type.equals("io.jooby.Context")
+                          && !p.getType().is("kotlin.coroutines.Continuation");
+                    })
+                .count();
+        boolean isTuple = trpcPayloadCount > 1;
+
+        if (resolvedTrpcMethod == HttpMethod.GET) {
+          buffer.add(
+              statement(
+                  indent(2),
+                  var(kt),
+                  "input = ctx.query(",
+                  string("input"),
+                  ").value()",
+                  semicolon(kt)));
+
+          if (isTuple) {
+            if (kt) {
+              buffer.add(
+                  statement(
+                      indent(2),
+                      "if (input?.trim()?.let { it.startsWith('[') && it.endsWith(']') } != true)"
+                          + " throw IllegalArgumentException(",
+                      string("tRPC input for multiple arguments must be a JSON array (tuple)"),
+                      ")"));
+            } else {
+              buffer.add(
+                  statement(
+                      indent(2),
+                      "if (input == null || input.length() < 2 || input.charAt(0) != '[' ||"
+                          + " input.charAt(input.length() - 1) != ']') throw new"
+                          + " IllegalArgumentException(",
+                      string("tRPC input for multiple arguments must be a JSON array (tuple)"),
+                      ");"));
+            }
+          }
+        } else {
+          buffer.add(statement(indent(2), var(kt), "input = ctx.body().bytes()", semicolon(kt)));
+
+          if (isTuple) {
+            if (kt) {
+              buffer.add(
+                  statement(
+                      indent(2),
+                      "if (input.size < 2 || input[0] != '['.code.toByte() || input[input.size - 1]"
+                          + " != ']'.code.toByte()) throw IllegalArgumentException(",
+                      string("tRPC body for multiple arguments must be a JSON array (tuple)"),
+                      ")"));
+            } else {
+              buffer.add(
+                  statement(
+                      indent(2),
+                      "if (input.length < 2 || input[0] != '[' || input[input.length - 1] != ']')"
+                          + " throw new IllegalArgumentException(",
+                      string("tRPC body for multiple arguments must be a JSON array (tuple)"),
+                      ");"));
+            }
+          }
+        }
+
+        if (kt) {
+          buffer.add(
+              statement(
+                  indent(2),
+                  "parser.reader(input, ",
+                  String.valueOf(isTuple),
+                  ").use { reader -> "));
+        } else {
+          buffer.add(
+              statement(
+                  indent(2),
+                  "try (var reader = parser.reader(input, ",
+                  String.valueOf(isTuple),
+                  ")) {"));
+        }
+
+        buffer.addAll(generateRpcParameter(kt, paramList::add, false));
+      } else if (!isTrpc) {
+        for (var parameter : getParameters(true)) {
+          String generatedParameter = parameter.generateMapping(kt);
+          if (parameter.isRequireBeanValidation()) {
+            generatedParameter =
+                CodeBlock.of(
+                    "io.jooby.validation.BeanValidator.apply(", "ctx, ", generatedParameter, ")");
+          }
+          paramList.add(generatedParameter);
+        }
+      }
+
+      controllerVar(kt, buffer, controllerIndent);
+
+      if (returnType.isVoid()) {
+        String statusCode =
+            annotationMap.size() == 1
+                    && annotationMap
+                        .keySet()
+                        .iterator()
+                        .next()
+                        .getSimpleName()
+                        .toString()
+                        .equals("DELETE")
+                ? "NO_CONTENT"
+                : "OK";
+
+        if (annotationMap.size() == 1) {
+          buffer.add(
+              statement(
+                  indent(controllerIndent),
+                  "ctx.setResponseCode(io.jooby.StatusCode.",
+                  statusCode,
+                  ")",
+                  semicolon(kt)));
+        } else {
+          if (kt) {
+            buffer.add(
+                statement(
+                    indent(controllerIndent),
+                    "ctx.setResponseCode(if (ctx.getRoute().getMethod().equals(",
+                    string("DELETE"),
+                    ")) io.jooby.StatusCode.NO_CONTENT else io.jooby.StatusCode.OK)"));
+          } else {
+            buffer.add(
+                statement(
+                    indent(controllerIndent),
+                    "ctx.setResponseCode(ctx.getRoute().getMethod().equals(",
+                    string("DELETE"),
+                    ") ? io.jooby.StatusCode.NO_CONTENT: io.jooby.StatusCode.OK)",
+                    semicolon(false)));
+          }
+        }
+
+        buffer.add(
+            statement(
+                indent(controllerIndent),
+                "c.",
+                this.method.getSimpleName(),
+                paramList.toString(),
+                semicolon(kt)));
+
+        if (isTrpc) {
+          buffer.add(
+              statement(
+                  indent(controllerIndent),
+                  "return io.jooby.rpc.trpc.TrpcResponse.empty()",
+                  semicolon(kt)));
+        } else {
+          buffer.add(
+              statement(indent(controllerIndent), "return ctx.getResponseCode()", semicolon(kt)));
+        }
+      } else if (returnType.is("io.jooby.StatusCode")) {
+        buffer.add(
+            statement(
+                indent(controllerIndent),
+                kt ? "val" : "var",
+                " statusCode = c.",
+                this.method.getSimpleName(),
+                paramList.toString(),
+                semicolon(kt)));
+        buffer.add(
+            statement(indent(controllerIndent), "ctx.setResponseCode(statusCode)", semicolon(kt)));
+
+        if (isTrpc) {
+          buffer.add(
+              statement(
+                  indent(controllerIndent),
+                  "return io.jooby.rpc.trpc.TrpcResponse.of(statusCode)",
+                  semicolon(kt)));
+        } else {
+          buffer.add(statement(indent(controllerIndent), "return statusCode", semicolon(kt)));
+        }
+      } else {
+        var castStr =
+            customReturnType.isProjection()
+                ? ""
+                : customReturnType.getArgumentsString(kt, false, Set.of(TypeKind.TYPEVAR));
+
+        var needsCast =
+            !castStr.isEmpty()
+                || (kt
+                    && !customReturnType.isProjection()
+                    && !customReturnType.getArguments().isEmpty());
+
+        var kotlinNotEnoughTypeInformation = !castStr.isEmpty() && kt ? "<Any>" : "";
+        var call =
+            of(
+                "c.",
+                this.method.getSimpleName(),
+                kotlinNotEnoughTypeInformation,
+                paramList.toString());
+
+        if (needsCast) {
+          setUncheckedCast(true);
+          call = kt ? call + " as " + returnTypeString : "(" + returnTypeString + ") " + call;
+        }
+
+        if (customReturnType.isProjection()) {
+          var projected =
+              of(Types.PROJECTED, ".wrap(", call, ").include(", string(getProjection()), ")");
+          if (isTrpc) {
+            buffer.add(
+                statement(
+                    indent(controllerIndent),
+                    "return io.jooby.rpc.trpc.TrpcResponse.of(",
+                    projected,
+                    ")",
+                    semicolon(kt)));
+          } else {
+            buffer.add(
+                statement(
+                    indent(controllerIndent),
+                    "return ",
+                    projected,
+                    kt && nullable ? "!!" : "",
+                    semicolon(kt)));
+          }
+        } else {
+
+          if (isTrpc && reactive != null) {
+            if (isReactiveVoid) {
+              var handler = reactive.handlerType();
+              if (handler.contains("Reactor")) {
+                buffer.add(
+                    statement(
+                        indent(controllerIndent),
+                        "return ",
+                        call,
+                        ".then(reactor.core.publisher.Mono.just(io.jooby.rpc.trpc.TrpcResponse.empty()))",
+                        semicolon(kt)));
+              } else if (handler.contains("Mutiny")) {
+                buffer.add(
+                    statement(
+                        indent(controllerIndent),
+                        "return ",
+                        call,
+                        ".replaceWith(io.jooby.rpc.trpc.TrpcResponse.empty())",
+                        semicolon(kt)));
+              } else if (handler.contains("ReactiveSupport")) {
+                buffer.add(
+                    statement(
+                        indent(controllerIndent),
+                        "return ",
+                        call,
+                        ".thenApply(x -> io.jooby.rpc.trpc.TrpcResponse.empty())",
+                        semicolon(kt)));
+              } else if (handler.contains("Reactivex")) {
+                buffer.add(
+                    statement(
+                        indent(controllerIndent),
+                        "return ",
+                        call,
+                        ".toSingleDefault(io.jooby.rpc.trpc.TrpcResponse.empty())",
+                        semicolon(kt)));
+              } else {
+                buffer.add(
+                    statement(
+                        indent(controllerIndent),
+                        "return ",
+                        call,
+                        ".map(x -> io.jooby.rpc.trpc.TrpcResponse.empty())",
+                        semicolon(kt)));
+              }
+            } else {
+              buffer.add(
+                  statement(
+                      indent(controllerIndent),
+                      "return ",
+                      call,
+                      reactive.mapOperator(),
+                      semicolon(kt)));
+            }
+          } else if (isTrpc) {
+            buffer.add(
+                statement(
+                    indent(controllerIndent),
+                    "return io.jooby.rpc.trpc.TrpcResponse.of(",
+                    call,
+                    kt && nullable ? "!!" : "",
+                    ")",
+                    semicolon(kt)));
+          } else {
+            buffer.add(
+                statement(
+                    indent(controllerIndent),
+                    "return ",
+                    call,
+                    kt && nullable ? "!!" : "",
+                    semicolon(kt)));
+          }
+        }
+      }
+
+      if (isTrpc && !parameters.isEmpty()) {
+        buffer.add(statement(indent(2), "}"));
+      }
+
+      buffer.add(statement("}", lineSeparator()));
+
+      if (uncheckedCast) {
+        if (kt) {
+          buffer.addFirst(statement("@Suppress(\"UNCHECKED_CAST\")"));
+        } else {
+          buffer.addFirst(statement("@SuppressWarnings(\"unchecked\")"));
+        }
+      }
+    }
+    return buffer;
+  }
+
+  private boolean methodCallHeader(
+      boolean kt,
+      String contextVarname,
+      String methodName,
+      ArrayList<String> buffer,
+      String returnTypeGenerics,
+      String returnTypeString,
+      boolean throwsException) {
+    var nullable = false;
     if (kt) {
       nullable =
           method.getAnnotationMirrors().stream()
@@ -272,18 +712,20 @@ public List<String> generateHandlerCall(boolean kt) {
                 "suspend ",
                 "fun ",
                 returnTypeGenerics,
-                getGeneratedName(),
+                methodName,
                 "(handler: io.jooby.kt.HandlerContext): ",
                 returnTypeString,
                 " {"));
-        buffer.add(statement(indent(2), "val ctx = handler.ctx"));
+        buffer.add(statement(indent(2), "val ", contextVarname, " = handler.ctx"));
       } else {
         buffer.add(
             statement(
                 "fun ",
                 returnTypeGenerics,
-                getGeneratedName(),
-                "(ctx: io.jooby.Context): ",
+                methodName,
+                "(",
+                contextVarname,
+                ": io.jooby.Context): ",
                 returnTypeString,
                 " {"));
       }
@@ -294,104 +736,280 @@ public List<String> generateHandlerCall(boolean kt) {
               returnTypeGenerics,
               returnTypeString,
               " ",
-              getGeneratedName(),
-              "(io.jooby.Context ctx) ",
+              methodName,
+              "(io.jooby.Context ",
+              contextVarname,
+              ") ",
               throwsException ? "throws Exception {" : "{"));
     }
-    if (returnType.isVoid()) {
-      String statusCode;
-      if (annotationMap.size() == 1) {
-        statusCode =
-            annotationMap.keySet().iterator().next().getSimpleName().toString().equals("DELETE")
-                ? "NO_CONTENT"
-                : "OK";
-      } else {
-        statusCode = null;
-      }
-      if (statusCode != null) {
-        buffer.add(
-            statement(
-                indent(2),
-                "ctx.setResponseCode(io.jooby.StatusCode.",
-                statusCode,
-                ")",
-                semicolon(kt)));
-      } else {
-        if (kt) {
-          buffer.add(
-              statement(
-                  indent(2),
-                  "ctx.setResponseCode(if (ctx.getRoute().getMethod().equals(",
-                  string("DELETE"),
-                  ")) io.jooby.StatusCode.NO_CONTENT else io.jooby.StatusCode.OK)"));
-        } else {
-          buffer.add(
-              statement(
-                  indent(2),
-                  "ctx.setResponseCode(ctx.getRoute().getMethod().equals(",
-                  string("DELETE"),
-                  ") ? io.jooby.StatusCode.NO_CONTENT: io.jooby.StatusCode.OK)",
-                  semicolon(false)));
-        }
-      }
-      controllerVar(kt, buffer);
-      buffer.add(
-          statement(
-              indent(2), "c.", this.method.getSimpleName(), paramList.toString(), semicolon(kt)));
-      buffer.add(statement(indent(2), "return ctx.getResponseCode()", semicolon(kt)));
-    } else if (returnType.is("io.jooby.StatusCode")) {
-      controllerVar(kt, buffer);
-      buffer.add(
-          statement(
-              indent(2),
-              kt ? "val" : "var",
-              " statusCode = c.",
-              this.method.getSimpleName(),
-              paramList.toString(),
-              semicolon(kt)));
-      buffer.add(statement(indent(2), "ctx.setResponseCode(statusCode)", semicolon(kt)));
-      buffer.add(statement(indent(2), "return statusCode", semicolon(kt)));
-    } else {
-      controllerVar(kt, buffer);
-      var cast =
-          customReturnType.isProjection()
-              ? ""
-              : customReturnType.getArgumentsString(kt, false, Set.of(TypeKind.TYPEVAR));
-      var kotlinNotEnoughTypeInformation = !cast.isEmpty() && kt ? "<Any>" : "";
-      var call =
-          of(
-              "c.",
-              this.method.getSimpleName(),
-              kotlinNotEnoughTypeInformation,
-              paramList.toString());
-      if (!cast.isEmpty()) {
-        setUncheckedCast(true);
-        call = kt ? call + " as " + returnTypeString : "(" + returnTypeString + ") " + call;
-      }
-      if (customReturnType.isProjection()) {
-        var projected =
-            of(Types.PROJECTED, ".wrap(", call, ").include(", string(getProjection()), ")");
-        buffer.add(
-            statement(indent(2), "return ", projected, kt && nullable ? "!!" : "", semicolon(kt)));
-      } else {
-        buffer.add(
-            statement(indent(2), "return ", call, kt && nullable ? "!!" : "", semicolon(kt)));
-      }
-    }
-    buffer.add(statement("}", System.lineSeparator()));
-    if (uncheckedCast) {
-      if (kt) {
-        buffer.add(0, statement("@Suppress(\"UNCHECKED_CAST\")"));
-      } else {
-        buffer.add(0, statement("@SuppressWarnings(\"unchecked\")"));
+    return nullable;
+  }
+
+  private List<String> generateRpcParameter(
+      boolean kt, Consumer<String> arguments, boolean isJsonRpc) {
+    var statements = new ArrayList<String>();
+    var decoderInterface =
+        isJsonRpc ? "io.jooby.rpc.jsonrpc.JsonRpcDecoder" : "io.jooby.rpc.trpc.TrpcDecoder";
+    int baseIndent = isJsonRpc ? 10 : 4;
+
+    for (var parameter : parameters) {
+      var paramenterName = parameter.getName();
+      var type = type(kt, parameter.getType().toString());
+      boolean isNullable = parameter.isNullable(kt);
+
+      switch (parameter.getType().getRawType().toString()) {
+        case "io.jooby.Context":
+          arguments.accept("ctx");
+          break;
+        case "int",
+        "long",
+        "double",
+        "boolean",
+        "java.lang.String",
+        "java.lang.Integer",
+        "java.lang.Long",
+        "java.lang.Double",
+        "java.lang.Boolean":
+          var simpleType = type.startsWith("java.lang.") ? type.substring(10) : type;
+          if (simpleType.equals("Integer") || simpleType.equals("int")) simpleType = "Int";
+          var readName =
+              "next" + Character.toUpperCase(simpleType.charAt(0)) + simpleType.substring(1);
+
+          if (isNullable) {
+            if (kt) {
+              statements.add(
+                  statement(
+                      indent(baseIndent),
+                      "val ",
+                      paramenterName,
+                      " = if (reader.nextIsNull(",
+                      string(paramenterName),
+                      ")) null else reader.",
+                      readName,
+                      "(",
+                      string(paramenterName),
+                      ")"));
+            } else {
+              statements.add(
+                  statement(
+                      indent(baseIndent),
+                      var(kt),
+                      paramenterName,
+                      " = reader.nextIsNull(",
+                      string(paramenterName),
+                      ") ? null : reader.",
+                      readName,
+                      "(",
+                      string(paramenterName),
+                      ")",
+                      semicolon(kt)));
+            }
+          } else {
+            statements.add(
+                statement(
+                    indent(baseIndent),
+                    var(kt),
+                    paramenterName,
+                    " = reader.",
+                    readName,
+                    "(",
+                    string(paramenterName),
+                    ")",
+                    semicolon(kt)));
+          }
+          arguments.accept(paramenterName);
+          break;
+        case "byte",
+        "short",
+        "float",
+        "char",
+        "java.lang.Byte",
+        "java.lang.Short",
+        "java.lang.Float",
+        "java.lang.Character":
+          var isChar = type.equals("char") || type.equals("java.lang.Character");
+          var isFloat = type.equals("float") || type.equals("java.lang.Float");
+          var readMethod = isFloat ? "nextDouble" : (isChar ? "nextString" : "nextInt");
+
+          if (isNullable) {
+            if (kt) {
+              var ktCast =
+                  isChar
+                      ? "?.get(0)"
+                      : "?.to"
+                          + Character.toUpperCase(type.replace("java.lang.", "").charAt(0))
+                          + type.replace("java.lang.", "").substring(1)
+                          + "()";
+              statements.add(
+                  statement(
+                      indent(baseIndent),
+                      "val ",
+                      paramenterName,
+                      " = if (reader.nextIsNull(",
+                      string(paramenterName),
+                      ")) null else reader.",
+                      readMethod,
+                      "(",
+                      string(paramenterName),
+                      ")",
+                      ktCast));
+            } else {
+              var targetType = type.replace("java.lang.", "");
+              var javaPrefix = isChar ? "" : "(" + targetType + ") ";
+              var javaSuffix = isChar ? ".charAt(0)" : "";
+              statements.add(
+                  statement(
+                      indent(baseIndent),
+                      var(kt),
+                      paramenterName,
+                      " = reader.nextIsNull(",
+                      string(paramenterName),
+                      ") ? null : ",
+                      javaPrefix,
+                      "reader.",
+                      readMethod,
+                      "(",
+                      string(paramenterName),
+                      ")",
+                      javaSuffix,
+                      semicolon(kt)));
+            }
+          } else {
+            if (kt) {
+              var ktCast =
+                  isChar
+                      ? "[0]"
+                      : ".to"
+                          + Character.toUpperCase(type.replace("java.lang.", "").charAt(0))
+                          + type.replace("java.lang.", "").substring(1)
+                          + "()";
+              statements.add(
+                  statement(
+                      indent(baseIndent),
+                      var(kt),
+                      paramenterName,
+                      " = reader.",
+                      readMethod,
+                      "(",
+                      string(paramenterName),
+                      ")",
+                      ktCast,
+                      semicolon(kt)));
+            } else {
+              var targetType = type.replace("java.lang.", "");
+              var javaPrefix = isChar ? "" : "(" + targetType + ") ";
+              var javaSuffix = isChar ? ".charAt(0)" : "";
+              statements.add(
+                  statement(
+                      indent(baseIndent),
+                      var(kt),
+                      paramenterName,
+                      " = ",
+                      javaPrefix,
+                      "reader.",
+                      readMethod,
+                      "(",
+                      string(paramenterName),
+                      ")",
+                      javaSuffix,
+                      semicolon(kt)));
+            }
+          }
+          arguments.accept(paramenterName);
+          break;
+        default:
+          if (kt) {
+            statements.add(
+                statement(
+                    indent(baseIndent),
+                    "val ",
+                    paramenterName,
+                    "Decoder: ",
+                    decoderInterface,
+                    "<",
+                    type,
+                    "> = parser.decoder(",
+                    parameter.getType().toSourceCode(kt),
+                    ")",
+                    semicolon(kt)));
+            if (isNullable) {
+              statements.add(
+                  statement(
+                      indent(baseIndent),
+                      "val ",
+                      paramenterName,
+                      " = if (reader.nextIsNull(",
+                      string(paramenterName),
+                      ")) null else reader.nextObject(",
+                      string(paramenterName),
+                      ", ",
+                      paramenterName,
+                      "Decoder)"));
+            } else {
+              statements.add(
+                  statement(
+                      indent(baseIndent),
+                      "val ",
+                      paramenterName,
+                      " = reader.nextObject(",
+                      string(paramenterName),
+                      ", ",
+                      paramenterName,
+                      "Decoder)",
+                      semicolon(kt)));
+            }
+          } else {
+            statements.add(
+                statement(
+                    indent(baseIndent),
+                    decoderInterface,
+                    "<",
+                    type,
+                    "> ",
+                    paramenterName,
+                    "Decoder = parser.decoder(",
+                    parameter.getType().toSourceCode(kt),
+                    ")",
+                    semicolon(kt)));
+            if (isNullable) {
+              statements.add(
+                  statement(
+                      indent(baseIndent),
+                      parameter.getType().toString(),
+                      " ",
+                      paramenterName,
+                      " = reader.nextIsNull(",
+                      string(paramenterName),
+                      ") ? null : reader.nextObject(",
+                      string(paramenterName),
+                      ", ",
+                      paramenterName,
+                      "Decoder)",
+                      semicolon(kt)));
+            } else {
+              statements.add(
+                  statement(
+                      indent(baseIndent),
+                      parameter.getType().toString(),
+                      " ",
+                      paramenterName,
+                      " = reader.nextObject(",
+                      string(paramenterName),
+                      ", ",
+                      paramenterName,
+                      "Decoder)",
+                      semicolon(kt)));
+            }
+          }
+          arguments.accept(paramenterName);
+          break;
       }
     }
-    return buffer;
+    return statements;
   }
 
-  private void controllerVar(boolean kt, List<String> buffer) {
-    buffer.add(
-        statement(indent(2), kt ? "val" : "var", " c = this.factory.apply(ctx)", semicolon(kt)));
+  private void controllerVar(boolean kt, List<String> buffer, int indent) {
+    buffer.add(statement(indent(indent), var(kt), "c = this.factory.apply(ctx)", semicolon(kt)));
   }
 
   public String getGeneratedName() {
@@ -403,10 +1021,27 @@ public void setGeneratedName(String generatedName) {
   }
 
   public MvcRoute addHttpMethod(TypeElement annotation) {
-    var annotationMirror =
-        ofNullable(findAnnotationByName(this.method, annotation.getQualifiedName().toString()))
-            .orElseThrow(() -> new IllegalArgumentException("Annotation not found: " + annotation));
+    String annotationName = annotation.getQualifiedName().toString();
+    var annotationMirror = findAnnotationByName(this.method, annotationName);
+
+    // Fallback to the class-level annotation if the method isn't explicitly annotated
+    if (annotationMirror == null) {
+      annotationMirror = findAnnotationByName(this.method.getEnclosingElement(), annotationName);
+    }
+
+    if (annotationMirror == null) {
+      throw new IllegalArgumentException("Annotation not found: " + annotation);
+    }
+
     annotationMap.put(annotation, annotationMirror);
+
+    var httpMethod = HttpMethod.findByAnnotationName(annotationName);
+    if (httpMethod == HttpMethod.tRPC) {
+      this.isTrpc = true;
+    }
+    if (httpMethod == HttpMethod.JSON_RPC) {
+      this.isJsonRpc = true;
+    }
     return this;
   }
 
@@ -438,7 +1073,6 @@ public List<String> getJavaMethodSignature(boolean kt) {
         .map(
             it -> {
               var type = it.getType();
-              // Kotlin requires his own types for primitives
               if (kt && type.isPrimitive()) {
                 return type(kt, type.getRawType().toString());
               }
@@ -452,15 +1086,31 @@ public String getMethodName() {
     return getMethod().getSimpleName().toString();
   }
 
+  public String getJsonRpcMethodName() {
+    var annotation = AnnotationSupport.findAnnotationByName(method, "io.jooby.annotation.JsonRpc");
+    if (annotation != null) {
+      var val =
+          AnnotationSupport.findAnnotationValue(annotation, VALUE).stream().findFirst().orElse("");
+      if (!val.isEmpty()) return val;
+    }
+    return getMethodName();
+  }
+
+  public boolean isJsonRpc() {
+    return isJsonRpc;
+  }
+
   @Override
   public int hashCode() {
-    return method.toString().hashCode();
+    return Objects.hash(method.toString(), isTrpc, isJsonRpc);
   }
 
   @Override
   public boolean equals(Object obj) {
     if (obj instanceof MvcRoute that) {
-      return this.method.toString().equals(that.method.toString());
+      return this.method.toString().equals(that.method.toString())
+          && this.isTrpc == that.isTrpc
+          && this.isJsonRpc == that.isJsonRpc;
     }
     return false;
   }
@@ -513,11 +1163,6 @@ private Optional<String> mediaType(Function<Element, List<String>> lookup) {
             .collect(Collectors.joining(", ", "java.util.List.of(", ")")));
   }
 
-  /**
-   * Kotlin suspend function has a <code>kotlin.coroutines.Continuation</code> as last parameter.
-   *
-   * @return True for Kotlin suspend function.
-   */
   public boolean isSuspendFun() {
     return suspendFun;
   }
@@ -544,4 +1189,58 @@ public void setUncheckedCast(boolean value) {
   public boolean hasBeanValidation() {
     return hasBeanValidation;
   }
+
+  private HttpMethod trpcMethod(Element element) {
+    if (AnnotationSupport.findAnnotationByName(element, "io.jooby.annotation.Trpc.Query") != null) {
+      return HttpMethod.GET;
+    }
+    if (AnnotationSupport.findAnnotationByName(element, "io.jooby.annotation.Trpc.Mutation")
+        != null) {
+      return HttpMethod.POST;
+    }
+
+    var trpc = AnnotationSupport.findAnnotationByName(element, "io.jooby.annotation.Trpc");
+    if (trpc != null) {
+      if (HttpMethod.GET.matches(element)) {
+        return HttpMethod.GET;
+      }
+      if (HttpMethod.POST.matches(element)
+          || HttpMethod.PUT.matches(element)
+          || HttpMethod.PATCH.matches(element)
+          || HttpMethod.DELETE.matches(element)) {
+        return HttpMethod.POST;
+      }
+      throw new IllegalArgumentException(
+          "tRPC procedure missing HTTP mapping. Method "
+              + element.getSimpleName()
+              + "() in "
+              + element.getEnclosingElement().getSimpleName()
+              + " is annotated with @Trpc but lacks a valid HTTP method annotation.");
+    }
+    return null;
+  }
+
+  public String trpcPath(Element element) {
+    var namespace =
+        Optional.ofNullable(
+                AnnotationSupport.findAnnotationByName(
+                    element.getEnclosingElement(), "io.jooby.annotation.Trpc"))
+            .flatMap(it -> findAnnotationValue(it, VALUE).stream().findFirst())
+            .map(it -> it + ".")
+            .orElse("");
+
+    var procedure =
+        Stream.of(
+                "io.jooby.annotation.Trpc.Query",
+                "io.jooby.annotation.Trpc.Mutation",
+                "io.jooby.annotation.Trpc")
+            .map(it -> AnnotationSupport.findAnnotationByName(element, it))
+            .filter(Objects::nonNull)
+            .findFirst()
+            .flatMap(it -> findAnnotationValue(it, VALUE).stream().findFirst())
+            .orElse(element.getSimpleName().toString());
+    return Stream.of("trpc", namespace + procedure)
+        .map(segment -> segment.startsWith("/") ? segment.substring(1) : segment)
+        .collect(Collectors.joining("/", "/", ""));
+  }
 }
diff --git a/modules/jooby-apt/src/main/java/io/jooby/internal/apt/MvcRouter.java b/modules/jooby-apt/src/main/java/io/jooby/internal/apt/MvcRouter.java
index 5a2005dd60..f3f347d105 100644
--- a/modules/jooby-apt/src/main/java/io/jooby/internal/apt/MvcRouter.java
+++ b/modules/jooby-apt/src/main/java/io/jooby/internal/apt/MvcRouter.java
@@ -5,9 +5,9 @@
  */
 package io.jooby.internal.apt;
 
+import static io.jooby.internal.apt.AnnotationSupport.VALUE;
 import static io.jooby.internal.apt.AnnotationSupport.findAnnotationByName;
-import static io.jooby.internal.apt.CodeBlock.indent;
-import static io.jooby.internal.apt.CodeBlock.semicolon;
+import static io.jooby.internal.apt.CodeBlock.*;
 import static java.util.Collections.emptyList;
 
 import java.io.IOException;
@@ -19,7 +19,6 @@
 import java.util.stream.Stream;
 
 import javax.lang.model.element.*;
-import javax.tools.JavaFileObject;
 
 public class MvcRouter {
   private final MvcContext context;
@@ -33,6 +32,58 @@ public class MvcRouter {
   public MvcRouter(MvcContext context, TypeElement clazz) {
     this.context = context;
     this.clazz = clazz;
+
+    // JSON-RPC Method Discovery Logic
+    var classJsonRpcAnno =
+        AnnotationSupport.findAnnotationByName(clazz, "io.jooby.annotation.JsonRpc");
+
+    List<ExecutableElement> explicitlyAnnotated = new ArrayList<>();
+    List<ExecutableElement> allPublicMethods = new ArrayList<>();
+
+    for (var enclosed : clazz.getEnclosedElements()) {
+      if (enclosed.getKind() == ElementKind.METHOD) {
+        var method = (ExecutableElement) enclosed;
+        var modifiers = method.getModifiers();
+
+        // Only consider public, non-static, non-abstract methods
+        if (modifiers.contains(Modifier.PUBLIC)
+            && !modifiers.contains(Modifier.STATIC)
+            && !modifiers.contains(Modifier.ABSTRACT)) {
+
+          // Ignore standard Java Object methods
+          String methodName = method.getSimpleName().toString();
+          if (methodName.equals("toString")
+              || methodName.equals("hashCode")
+              || methodName.equals("equals")
+              || methodName.equals("clone")) {
+            continue;
+          }
+
+          allPublicMethods.add(method);
+          var methodJsonRpcAnno =
+              AnnotationSupport.findAnnotationByName(method, "io.jooby.annotation.JsonRpc");
+          if (methodJsonRpcAnno != null) {
+            explicitlyAnnotated.add(method);
+          }
+        }
+      }
+    }
+
+    if (!explicitlyAnnotated.isEmpty()) {
+      // Rule 2: If one or more methods are explicitly annotated, ONLY expose those methods.
+      for (var method : explicitlyAnnotated) {
+        var methodAnno =
+            AnnotationSupport.findAnnotationByName(method, "io.jooby.annotation.JsonRpc");
+        TypeElement annoElement = (TypeElement) methodAnno.getAnnotationType().asElement();
+        put(annoElement, method);
+      }
+    } else if (classJsonRpcAnno != null) {
+      // Rule 1: Class is annotated, but no specific methods are. Expose ALL public methods.
+      var annoElement = (TypeElement) classJsonRpcAnno.getAnnotationType().asElement();
+      for (var method : allPublicMethods) {
+        put(annoElement, method);
+      }
+    }
   }
 
   public MvcRouter(TypeElement clazz, MvcRouter parent) {
@@ -57,17 +108,26 @@ public TypeElement getTargetType() {
   }
 
   public String getGeneratedType() {
-    return context.generateRouterName(getTargetType().getQualifiedName().toString());
+    String baseName = getTargetType().getQualifiedName().toString();
+    String name = isJsonRpc() ? baseName + "Rpc" : baseName;
+    return context.generateRouterName(name);
   }
 
   public String getGeneratedFilename() {
-    return getGeneratedType().replace('.', '/')
-        + (isKt() ? ".kt" : JavaFileObject.Kind.SOURCE.extension);
+    return getGeneratedType().replace('.', '/') + (isKt() ? ".kt" : ".java");
   }
 
   public MvcRouter put(TypeElement httpMethod, ExecutableElement route) {
-    var routeKey = route.toString();
+    var isTrpc =
+        HttpMethod.findByAnnotationName(httpMethod.getQualifiedName().toString())
+            == HttpMethod.tRPC;
+    var isJsonRpc =
+        HttpMethod.findByAnnotationName(httpMethod.getQualifiedName().toString())
+            == HttpMethod.JSON_RPC;
+
+    var routeKey = (isTrpc ? "trpc" : (isJsonRpc ? "jsonrpc" : "")) + route.toString();
     var existing = routes.get(routeKey);
+
     if (existing == null) {
       routes.put(routeKey, new MvcRoute(context, this, route).addHttpMethod(httpMethod));
     } else {
@@ -95,33 +155,77 @@ public String getPackageName() {
     return pkgEnd > 0 ? classname.substring(0, pkgEnd) : "";
   }
 
+  public boolean isJsonRpc() {
+    return getRoutes().stream().anyMatch(MvcRoute::isJsonRpc);
+  }
+
+  public String getJsonRpcNamespace() {
+    var annotation = AnnotationSupport.findAnnotationByName(clazz, "io.jooby.annotation.JsonRpc");
+    if (annotation != null) {
+      return AnnotationSupport.findAnnotationValue(annotation, VALUE).stream()
+          .findFirst()
+          .orElse("");
+    }
+    return "";
+  }
+
+  public boolean hasRestRoutes() {
+    return getRoutes().stream().anyMatch(it -> !it.isJsonRpc());
+  }
+
+  public boolean hasJsonRpcRoutes() {
+    return getRoutes().stream().anyMatch(MvcRoute::isJsonRpc);
+  }
+
+  public String getRestGeneratedType() {
+    return context.generateRouterName(getTargetType().getQualifiedName().toString());
+  }
+
+  public String getRpcGeneratedType() {
+    return context.generateRouterName(getTargetType().getQualifiedName().toString() + "Rpc");
+  }
+
+  public String getRestGeneratedFilename() {
+    return getRestGeneratedType().replace('.', '/') + (isKt() ? ".kt" : ".java");
+  }
+
+  public String getRpcGeneratedFilename() {
+    return getRpcGeneratedType().replace('.', '/') + (isKt() ? ".kt" : ".java");
+  }
+
   /**
    * Generate the controller extension for MVC controller:
    *
    * <pre>{@code
    * public class Controller_ implements MvcExtension {
-   *     ....
+   * ....
    * }
    *
    * }</pre>
    *
-   * @return
+   * @return The source code to write, or null if the controller only contains JSON-RPC routes.
    */
-  public String toSourceCode(Boolean generateKotlin) throws IOException {
+  public String getRestSourceCode(Boolean generateKotlin) throws IOException {
+    var mvcRoutes = this.routes.values().stream().filter(it -> !it.isJsonRpc()).toList();
+
+    if (mvcRoutes.isEmpty()) {
+      return null; // Safety check if called on a JSON-RPC-only controller
+    }
+
     var kt = generateKotlin == Boolean.TRUE || isKt();
-    var generateTypeName = context.generateRouterName(getTargetType().getSimpleName().toString());
+    var generateTypeName = getTargetType().getSimpleName().toString();
+    var generatedClass = context.generateRouterName(generateTypeName);
+
     try (var in = getClass().getResourceAsStream("Source" + (kt ? ".kt" : ".java"))) {
       Objects.requireNonNull(in);
-      var routes = this.routes.values();
-      var suspended = routes.stream().filter(MvcRoute::isSuspendFun).toList();
-      var noSuspended = routes.stream().filter(it -> !it.isSuspendFun()).toList();
+      var suspended = mvcRoutes.stream().filter(MvcRoute::isSuspendFun).toList();
+      var noSuspended = mvcRoutes.stream().filter(it -> !it.isSuspendFun()).toList();
       var buffer = new StringBuilder();
       context.generateStaticImports(
           this,
           (owner, fn) ->
               buffer.append(
-                  CodeBlock.statement(
-                      "import ", kt ? "" : "static ", owner, ".", fn, semicolon(kt))));
+                  statement("import ", kt ? "" : "static ", owner, ".", fn, semicolon(kt))));
       var imports = buffer.toString();
       buffer.setLength(0);
 
@@ -139,13 +243,13 @@ public String toSourceCode(Boolean generateKotlin) throws IOException {
             .append(System.lineSeparator());
       }
       if (!suspended.isEmpty()) {
-        buffer.append(CodeBlock.statement(indent(6), "val kooby = app as io.jooby.kt.Kooby"));
-        buffer.append(CodeBlock.statement(indent(6), "kooby.coroutine {"));
+        buffer.append(statement(indent(6), "val kooby = app as io.jooby.kt.Kooby"));
+        buffer.append(statement(indent(6), "kooby.coroutine {"));
         suspended.stream()
             .flatMap(it -> it.generateMapping(kt).stream())
             .forEach(line -> buffer.append(CodeBlock.indent(8)).append(line));
         trimr(buffer);
-        buffer.append(System.lineSeparator()).append(CodeBlock.statement(indent(6), "}"));
+        buffer.append(System.lineSeparator()).append(statement(indent(6), "}"));
       }
       noSuspended.stream()
           .flatMap(it -> it.generateMapping(kt).stream())
@@ -159,19 +263,281 @@ public String toSourceCode(Boolean generateKotlin) throws IOException {
           .append(System.lineSeparator());
       // end install
 
-      routes.stream()
+      mvcRoutes.stream()
           .flatMap(it -> it.generateHandlerCall(kt).stream())
           .forEach(line -> buffer.append(CodeBlock.indent(4)).append(line));
+
       return new String(in.readAllBytes(), StandardCharsets.UTF_8)
           .replace("${packageName}", getPackageName())
           .replace("${imports}", imports)
-          .replace("${className}", getTargetType().getSimpleName())
-          .replace("${generatedClassName}", generateTypeName)
-          .replace("${constructors}", constructors(generateTypeName, kt))
+          .replace("${className}", generateTypeName)
+          .replace("${generatedClassName}", generatedClass)
+          .replace("${constructors}", constructors(generatedClass, kt))
           .replace("${methods}", trimr(buffer));
     }
   }
 
+  public String getRpcSourceCode(Boolean generateKotlin) {
+    if (!hasJsonRpcRoutes()) {
+      return null;
+    }
+    return generateJsonRpcService(generateKotlin == Boolean.TRUE || isKt());
+  }
+
+  private String generateJsonRpcService(boolean kt) {
+    var buffer = new StringBuilder();
+    var generateTypeName = getTargetType().getSimpleName().toString();
+    var rpcClassName = context.generateRouterName(generateTypeName + "Rpc");
+    var namespace = getJsonRpcNamespace();
+    var packageName = getPackageName();
+
+    var rpcRoutes = getRoutes().stream().filter(MvcRoute::isJsonRpc).toList();
+
+    List<String> fullMethods = new ArrayList<>();
+    for (MvcRoute route : rpcRoutes) {
+      String routeName = route.getJsonRpcMethodName();
+      fullMethods.add(namespace.isEmpty() ? routeName : namespace + "." + routeName);
+    }
+
+    String methodListString =
+        fullMethods.stream().map(m -> "\"" + m + "\"").collect(Collectors.joining(", "));
+
+    buffer.append(statement("package ", packageName, semicolon(kt)));
+    buffer.append(System.lineSeparator());
+
+    buffer.append(
+        statement(
+            "@io.jooby.annotation.Generated(", generateTypeName, kt ? "::class" : ".class", ")"));
+
+    if (kt) {
+      buffer.append(
+          statement(
+              "class ",
+              rpcClassName,
+              " : io.jooby.rpc.jsonrpc.JsonRpcService, io.jooby.Extension {"));
+      buffer.append(
+          statement(
+              indent(2),
+              "protected lateinit var factory: (io.jooby.Context) -> ",
+              generateTypeName));
+
+      String ktConstructors = constructors(rpcClassName, true).toString().replaceAll("(?m)^  ", "");
+      buffer.append(ktConstructors);
+      buffer.append(System.lineSeparator());
+
+      buffer.append(statement(indent(2), "constructor(instance: ", generateTypeName, ") {"));
+      buffer.append(statement(indent(4), "setup { ctx -> instance }"));
+      buffer.append(statement(indent(2), "}"));
+      buffer.append(System.lineSeparator());
+
+      buffer.append(
+          statement(
+              indent(2),
+              "constructor(provider: io.jooby.SneakyThrows.Supplier<",
+              generateTypeName,
+              ">) {"));
+      buffer.append(statement(indent(4), "setup { ctx -> provider.get() }"));
+      buffer.append(statement(indent(2), "}"));
+      buffer.append(System.lineSeparator());
+
+      buffer.append(
+          statement(
+              indent(2),
+              "constructor(provider: io.jooby.SneakyThrows.Function<Class<",
+              generateTypeName,
+              ">, ",
+              generateTypeName,
+              ">) {"));
+      buffer.append(
+          statement(
+              indent(4), "setup { ctx -> provider.apply(", generateTypeName, "::class.java) }"));
+      buffer.append(statement(indent(2), "}"));
+      buffer.append(System.lineSeparator());
+
+      buffer.append(
+          statement(
+              indent(2),
+              "private fun setup(factory: (io.jooby.Context) -> ",
+              generateTypeName,
+              ") {"));
+      buffer.append(statement(indent(4), "this.factory = factory"));
+      buffer.append(statement(indent(2), "}"));
+      buffer.append(System.lineSeparator());
+
+      buffer.append(statement(indent(2), "override fun install(app: io.jooby.Jooby) {"));
+      buffer.append(
+          statement(
+              indent(4),
+              "app.services.listOf(io.jooby.rpc.jsonrpc.JsonRpcService::class.java).add(this)"));
+      buffer.append(statement(indent(2), "}"));
+      buffer.append(System.lineSeparator());
+
+      buffer.append(statement(indent(2), "override fun getMethods(): List<String> {"));
+      buffer.append(statement(indent(4), "return listOf(", methodListString, ")"));
+      buffer.append(statement(indent(2), "}"));
+      buffer.append(System.lineSeparator());
+
+      buffer.append(statement(indent(2), "@Throws(Exception::class)"));
+      buffer.append(
+          statement(
+              indent(2),
+              "override fun execute(ctx: io.jooby.Context, req:"
+                  + " io.jooby.rpc.jsonrpc.JsonRpcRequest): Any? {"));
+      buffer.append(statement(indent(4), "val c = factory(ctx)"));
+      buffer.append(statement(indent(4), "val method = req.method"));
+      buffer.append(
+          statement(
+              indent(4),
+              var(kt),
+              "parser = ctx.require(io.jooby.rpc.jsonrpc.JsonRpcParser",
+              clazz(kt),
+              ")",
+              semicolon(kt)));
+      buffer.append(statement(indent(4), "return when(method) {"));
+
+      for (int i = 0; i < rpcRoutes.size(); i++) {
+        buffer.append(statement(indent(6), "\"", fullMethods.get(i), "\" -> {"));
+        rpcRoutes.get(i).generateJsonRpcDispatchCase(true).forEach(buffer::append);
+        buffer.append(statement(indent(6), "}"));
+      }
+
+      buffer.append(
+          statement(
+              indent(6),
+              "else -> throw"
+                  + " io.jooby.rpc.jsonrpc.JsonRpcException(io.jooby.rpc.jsonrpc.JsonRpcErrorCode.METHOD_NOT_FOUND,"
+                  + " \"Method not found: $method\")"));
+      buffer.append(statement(indent(4), "}"));
+      buffer.append(statement(indent(2), "}"));
+
+    } else {
+      buffer.append(
+          statement(
+              "public class ",
+              rpcClassName,
+              " implements io.jooby.rpc.jsonrpc.JsonRpcService, io.jooby.Extension {"));
+      buffer.append(
+          statement(
+              indent(2),
+              "protected java.util.function.Function<io.jooby.Context, ",
+              generateTypeName,
+              "> factory",
+              semicolon(kt)));
+
+      String javaConstructors =
+          constructors(rpcClassName, false).toString().replaceAll("(?m)^  ", "");
+      buffer.append(javaConstructors);
+      buffer.append(System.lineSeparator());
+
+      buffer.append(
+          statement(indent(2), "public ", rpcClassName, "(", generateTypeName, " instance) {"));
+      buffer.append(statement(indent(4), "setup(ctx -> instance)", semicolon(kt)));
+      buffer.append(statement(indent(2), "}"));
+      buffer.append(System.lineSeparator());
+
+      buffer.append(
+          statement(
+              indent(2),
+              "public ",
+              rpcClassName,
+              "(io.jooby.SneakyThrows.Supplier<",
+              generateTypeName,
+              "> provider) {"));
+      buffer.append(
+          statement(
+              indent(4), "setup(ctx -> (", generateTypeName, ") provider.get())", semicolon(kt)));
+      buffer.append(statement(indent(2), "}"));
+      buffer.append(System.lineSeparator());
+
+      buffer.append(
+          statement(
+              indent(2),
+              "public ",
+              rpcClassName,
+              "(io.jooby.SneakyThrows.Function<Class<",
+              generateTypeName,
+              ">, ",
+              generateTypeName,
+              "> provider) {"));
+      buffer.append(
+          statement(
+              indent(4),
+              "setup(ctx -> provider.apply(",
+              generateTypeName,
+              ".class))",
+              semicolon(kt)));
+      buffer.append(statement(indent(2), "}"));
+      buffer.append(System.lineSeparator());
+
+      buffer.append(
+          statement(
+              indent(2),
+              "private void setup(java.util.function.Function<io.jooby.Context, ",
+              generateTypeName,
+              "> factory) {"));
+      buffer.append(statement(indent(4), "this.factory = factory", semicolon(kt)));
+      buffer.append(statement(indent(2), "}"));
+      buffer.append(System.lineSeparator());
+
+      buffer.append(statement(indent(2), "@Override"));
+      buffer.append(
+          statement(indent(2), "public void install(io.jooby.Jooby app) throws Exception {"));
+      buffer.append(
+          statement(
+              indent(4),
+              "app.getServices().listOf(io.jooby.rpc.jsonrpc.JsonRpcService.class).add(this)",
+              semicolon(kt)));
+      buffer.append(statement(indent(2), "}"));
+      buffer.append(System.lineSeparator());
+
+      buffer.append(statement(indent(2), "@Override"));
+      buffer.append(statement(indent(2), "public java.util.List<String> getMethods() {"));
+      buffer.append(
+          statement(indent(4), "return java.util.List.of(", methodListString, ")", semicolon(kt)));
+      buffer.append(statement(indent(2), "}"));
+      buffer.append(System.lineSeparator());
+
+      buffer.append(statement(indent(2), "@Override"));
+      buffer.append(
+          statement(
+              indent(2),
+              "public Object execute(io.jooby.Context ctx, io.jooby.rpc.jsonrpc.JsonRpcRequest req)"
+                  + " throws Exception {"));
+      buffer.append(
+          statement(indent(4), generateTypeName, " c = factory.apply(ctx)", semicolon(kt)));
+      buffer.append(statement(indent(4), "String method = req.getMethod()", semicolon(kt)));
+      buffer.append(
+          statement(
+              indent(4),
+              var(kt),
+              "parser = ctx.require(io.jooby.rpc.jsonrpc.JsonRpcParser",
+              clazz(kt),
+              ")",
+              semicolon(kt)));
+      buffer.append(statement(indent(4), "switch(method) {"));
+
+      for (int i = 0; i < rpcRoutes.size(); i++) {
+        buffer.append(statement(indent(6), "case \"", fullMethods.get(i), "\": {"));
+        rpcRoutes.get(i).generateJsonRpcDispatchCase(false).forEach(buffer::append);
+        buffer.append(statement(indent(6), "}"));
+      }
+
+      buffer.append(
+          statement(
+              indent(6),
+              "default: throw new"
+                  + " io.jooby.rpc.jsonrpc.JsonRpcException(io.jooby.rpc.jsonrpc.JsonRpcErrorCode.METHOD_NOT_FOUND,"
+                  + " \"Method not found: \" + method)",
+              semicolon(kt)));
+      buffer.append(statement(indent(4), "}"));
+      buffer.append(statement(indent(2), "}"));
+    }
+
+    buffer.append(statement("}"));
+
+    return buffer.toString();
+  }
+
   private StringBuilder trimr(StringBuilder buffer) {
     var i = buffer.length() - 1;
     while (i > 0 && Character.isWhitespace(buffer.charAt(i))) {
diff --git a/modules/jooby-apt/src/main/java/io/jooby/internal/apt/ParameterGenerator.java b/modules/jooby-apt/src/main/java/io/jooby/internal/apt/ParameterGenerator.java
index 34f1e07d9b..599bf7a6db 100644
--- a/modules/jooby-apt/src/main/java/io/jooby/internal/apt/ParameterGenerator.java
+++ b/modules/jooby-apt/src/main/java/io/jooby/internal/apt/ParameterGenerator.java
@@ -5,14 +5,15 @@
  */
 package io.jooby.internal.apt;
 
-import javax.lang.model.element.*;
+import static io.jooby.internal.apt.AnnotationSupport.findAnnotationValue;
+import static io.jooby.internal.apt.Types.BUILT_IN;
+import static java.util.stream.Collectors.joining;
+
 import java.util.*;
 import java.util.function.Predicate;
 import java.util.stream.Stream;
 
-import static io.jooby.internal.apt.AnnotationSupport.findAnnotationValue;
-import static io.jooby.internal.apt.Types.BUILT_IN;
-import static java.util.stream.Collectors.joining;
+import javax.lang.model.element.*;
 
 public enum ParameterGenerator {
   ContextParam("getAttribute", "io.jooby.annotation.ContextParam", "jakarta.ws.rs.core.Context") {
@@ -440,11 +441,13 @@ protected String defaultValue(VariableElement parameter, AnnotationMirror annota
       var sources = findAnnotationValue(annotation, AnnotationSupport.VALUE);
       return sources.isEmpty() ? "" : CodeBlock.of(", ", CodeBlock.string(sources.getFirst()));
     } else if (annotationType.startsWith("jakarta.ws.rs")) {
-      var defaultValueAnnotation = AnnotationSupport.findAnnotationByName(
-          parameter, "jakarta.ws.rs.DefaultValue");
+      var defaultValueAnnotation =
+          AnnotationSupport.findAnnotationByName(parameter, "jakarta.ws.rs.DefaultValue");
       if (defaultValueAnnotation != null) {
         var defaultValue = findAnnotationValue(defaultValueAnnotation, AnnotationSupport.VALUE);
-        return defaultValue.isEmpty() ? "" : CodeBlock.of(", ", CodeBlock.string(defaultValue.getFirst()));
+        return defaultValue.isEmpty()
+            ? ""
+            : CodeBlock.of(", ", CodeBlock.string(defaultValue.getFirst()));
       }
     }
     return "";
diff --git a/modules/jooby-apt/src/main/java/io/jooby/internal/apt/ReactiveType.java b/modules/jooby-apt/src/main/java/io/jooby/internal/apt/ReactiveType.java
index e30366b2fc..0dd86579fe 100644
--- a/modules/jooby-apt/src/main/java/io/jooby/internal/apt/ReactiveType.java
+++ b/modules/jooby-apt/src/main/java/io/jooby/internal/apt/ReactiveType.java
@@ -13,11 +13,14 @@ public class ReactiveType {
   private final String handlerType;
   private final String handler;
   private final Set<String> reactiveTypes;
+  private final String mapOperator;
 
-  private ReactiveType(String handlerType, String handler, Set<String> reactiveTypes) {
+  private ReactiveType(
+      String handlerType, String handler, Set<String> reactiveTypes, String mapOperator) {
     this.handlerType = handlerType;
     this.handler = handler;
     this.reactiveTypes = reactiveTypes;
+    this.mapOperator = mapOperator;
   }
 
   public Set<String> reactiveTypes() {
@@ -32,27 +35,35 @@ public String handler() {
     return handler;
   }
 
+  public String mapOperator() {
+    return mapOperator;
+  }
+
   public static List<ReactiveType> supportedTypes() {
     return List.of(
         new ReactiveType(
             "io.jooby.ReactiveSupport",
             "concurrent",
-            Set.of("java.util.concurrent.Flow", "java.util.concurrent.CompletionStage")),
+            Set.of("java.util.concurrent.Flow", "java.util.concurrent.CompletionStage"),
+            ".thenApply(io.jooby.rpc.trpc.TrpcResponse::of)"),
         // Vertx
         new ReactiveType(
             "io.jooby.vertx.VertxHandler",
             "vertx",
-            Set.of("io.vertx.core.Future", "io.vertx.core.Promise", "io.vertx.core.buffer.Buffer")),
+            Set.of("io.vertx.core.Future", "io.vertx.core.Promise", "io.vertx.core.buffer.Buffer"),
+            ".map(io.jooby.rpc.trpc.TrpcResponse::of)"),
         // Mutiny
         new ReactiveType(
             "io.jooby.mutiny.Mutiny",
             "mutiny",
-            Set.of("io.smallrye.mutiny.Uni", "io.smallrye.mutiny.Multi")),
+            Set.of("io.smallrye.mutiny.Uni", "io.smallrye.mutiny.Multi"),
+            ".map(io.jooby.rpc.trpc.TrpcResponse::of)"),
         // Reactor
         new ReactiveType(
             "io.jooby.reactor.Reactor",
             "reactor",
-            Set.of("reactor.core.publisher.Flux", "reactor.core.publisher.Mono")),
+            Set.of("reactor.core.publisher.Flux", "reactor.core.publisher.Mono"),
+            ".map(io.jooby.rpc.trpc.TrpcResponse::of)"),
         // Rxjava
         new ReactiveType(
             "io.jooby.rxjava3.Reactivex",
@@ -60,8 +71,9 @@ public static List<ReactiveType> supportedTypes() {
             Set.of(
                 "io.reactivex.rxjava3.core.Flowable",
                 "io.reactivex.rxjava3.core.Maybe",
-                "io.reactivex.rxjava3.core.Observable",
                 "io.reactivex.rxjava3.core.Single",
-                "io.reactivex.rxjava3.disposables.Disposable")));
+                "io.reactivex.rxjava3.core.Observable",
+                "io.reactivex.rxjava3.core.Completable"),
+            ".map(io.jooby.rpc.trpc.TrpcResponse::of)"));
   }
 }
diff --git a/modules/jooby-apt/src/test/java/io/jooby/apt/ProcessorRunner.java b/modules/jooby-apt/src/test/java/io/jooby/apt/ProcessorRunner.java
index ab3c3005ef..15f39a62da 100644
--- a/modules/jooby-apt/src/test/java/io/jooby/apt/ProcessorRunner.java
+++ b/modules/jooby-apt/src/test/java/io/jooby/apt/ProcessorRunner.java
@@ -79,7 +79,7 @@ protected void onGeneratedSource(String classname, JavaFileObject source) {
       javaFiles.put(classname, source);
       try {
         // Generate kotlin source code inside the compiler scope... avoid false positive errors
-        kotlinFiles.put(classname, context.getRouters().get(0).toSourceCode(true));
+        kotlinFiles.put(classname, context.getRouters().get(0).getRestSourceCode(true));
       } catch (IOException e) {
         SneakyThrows.propagate(e);
       }
diff --git a/modules/jooby-apt/src/test/java/tests/i3761/C3761Jakarta.java b/modules/jooby-apt/src/test/java/tests/i3761/C3761Jakarta.java
index aadae957bd..3dd6c500e0 100644
--- a/modules/jooby-apt/src/test/java/tests/i3761/C3761Jakarta.java
+++ b/modules/jooby-apt/src/test/java/tests/i3761/C3761Jakarta.java
@@ -8,8 +8,8 @@
 import io.jooby.annotation.GET;
 import io.jooby.annotation.Path;
 import jakarta.ws.rs.DefaultValue;
-import jakarta.ws.rs.QueryParam;
 import jakarta.ws.rs.FormParam;
+import jakarta.ws.rs.QueryParam;
 
 @Path("/3761")
 public class C3761Jakarta {
diff --git a/modules/jooby-apt/src/test/java/tests/i3761/Issue3761.java b/modules/jooby-apt/src/test/java/tests/i3761/Issue3761.java
index 963f350c74..8cb4621f31 100644
--- a/modules/jooby-apt/src/test/java/tests/i3761/Issue3761.java
+++ b/modules/jooby-apt/src/test/java/tests/i3761/Issue3761.java
@@ -5,10 +5,11 @@
  */
 package tests.i3761;
 
-import io.jooby.apt.ProcessorRunner;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
 import org.junit.jupiter.api.Test;
 
-import static org.junit.jupiter.api.Assertions.assertTrue;
+import io.jooby.apt.ProcessorRunner;
 
 public class Issue3761 {
   @Test
@@ -26,11 +27,8 @@ public void shouldGenerateJakartaDefaultValues() throws Exception {
   private static void assertSourceCodeRespectDefaultValues(String source) {
     assertTrue(source.contains("return c.number(ctx.query(\"num\", \"5\").intValue());"));
     assertTrue(source.contains("return c.unset(ctx.query(\"unset\").valueOrNull());"));
-    assertTrue(
-        source.contains("return c.emptySet(ctx.query(\"emptySet\", \"\").value());"));
-    assertTrue(
-        source.contains("return c.string(ctx.query(\"stringVal\", \"Hello\").value());"));
-    assertTrue(
-        source.contains("return c.bool(ctx.form(\"boolVal\", \"false\").booleanValue());"));
+    assertTrue(source.contains("return c.emptySet(ctx.query(\"emptySet\", \"\").value());"));
+    assertTrue(source.contains("return c.string(ctx.query(\"stringVal\", \"Hello\").value());"));
+    assertTrue(source.contains("return c.bool(ctx.form(\"boolVal\", \"false\").booleanValue());"));
   }
 }
diff --git a/modules/jooby-apt/src/test/java/tests/i3863/Issue3863.java b/modules/jooby-apt/src/test/java/tests/i3863/Issue3863.java
new file mode 100644
index 0000000000..6c333fdd6e
--- /dev/null
+++ b/modules/jooby-apt/src/test/java/tests/i3863/Issue3863.java
@@ -0,0 +1,77 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package tests.i3863;
+
+import static org.assertj.core.api.Assertions.assertThat;
+
+import org.junit.Assert;
+import org.junit.jupiter.api.Test;
+
+import io.jooby.apt.ProcessorRunner;
+
+public class Issue3863 {
+  @Test
+  public void trpcOnTopLevelDoesNothingByItSelf() throws Exception {
+    new ProcessorRunner(new TopLevelTrpcDoesNothingByItSelf()).withSourceCode(Assert::assertNull);
+  }
+
+  @Test
+  public void trpcQuery() throws Exception {
+    new ProcessorRunner(new SpecificTrpcAnnotation())
+        .withSourceCode(
+            source -> {
+              assertThat(source)
+                  .contains("app.get(\"/trpc/users.getUserById\", this::trpcGetUserById);")
+                  .contains("app.post(\"/trpc/users.createUser\", this::trpcCreateUser);");
+            });
+  }
+
+  @Test
+  public void mixedAnnotation() throws Exception {
+    new ProcessorRunner(new MixedTrpcAnnotation())
+        .withSourceCode(
+            source -> {
+              assertThat(source)
+                  // tRPC
+                  .contains("app.get(\"/trpc/users.getUserById\", this::trpcGetUserById);")
+                  .contains("app.post(\"/trpc/users.createUser\", this::trpcCreateUser);")
+                  // REST
+                  .contains("app.get(\"/api/users/{id}\", this::getUserById);")
+                  .contains("app.post(\"/api/users\", this::createUser);");
+            });
+  }
+
+  @Test
+  public void mixedMutation() throws Exception {
+    new ProcessorRunner(new MixedMutation())
+        .withSourceCode(
+            source -> {
+              assertThat(source)
+                  // tRPC
+                  .contains("app.post(\"/trpc/users.createUser\", this::trpcCreateUser);")
+                  .contains("app.post(\"/trpc/users.updateUser\", this::trpcUpdateUser);")
+                  .contains("app.post(\"/trpc/users.patchUser\", this::trpcPatchUser);")
+                  .contains("app.post(\"/trpc/users.deleteUser\", this::trpcDeleteUser);")
+                  // REST
+                  .contains("app.post(\"/\", this::createUser);")
+                  .contains("app.put(\"/\", this::updateUser);")
+                  .contains("app.patch(\"/\", this::patchUser);")
+                  .contains("app.delete(\"/\", this::deleteUser);");
+            });
+  }
+
+  @Test
+  public void overloadTrpc() throws Exception {
+    new ProcessorRunner(new OverloadTrpc())
+        .withSourceCode(
+            source -> {
+              assertThat(source)
+                  // tRPC
+                  .contains("app.get(\"/trpc/users.ping\", this::trpcPing);")
+                  .contains("app.get(\"/trpc/users.ping\", this::trpcPingInteger);");
+            });
+  }
+}
diff --git a/modules/jooby-apt/src/test/java/tests/i3863/MixedMutation.java b/modules/jooby-apt/src/test/java/tests/i3863/MixedMutation.java
new file mode 100644
index 0000000000..4d8300625a
--- /dev/null
+++ b/modules/jooby-apt/src/test/java/tests/i3863/MixedMutation.java
@@ -0,0 +1,34 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package tests.i3863;
+
+import io.jooby.annotation.*;
+
+@Trpc("users")
+public class MixedMutation {
+
+  @Trpc
+  @POST
+  public U3863 createUser(U3863 payload) {
+    return null;
+  }
+
+  @Trpc
+  @PUT
+  public U3863 updateUser(U3863 payload) {
+    return null;
+  }
+
+  @Trpc
+  @PATCH
+  public U3863 patchUser(U3863 payload) {
+    return null;
+  }
+
+  @Trpc
+  @DELETE
+  public void deleteUser(U3863 payload) {}
+}
diff --git a/modules/jooby-apt/src/test/java/tests/i3863/MixedTrpcAnnotation.java b/modules/jooby-apt/src/test/java/tests/i3863/MixedTrpcAnnotation.java
new file mode 100644
index 0000000000..d0618e8d02
--- /dev/null
+++ b/modules/jooby-apt/src/test/java/tests/i3863/MixedTrpcAnnotation.java
@@ -0,0 +1,26 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package tests.i3863;
+
+import io.jooby.Context;
+import io.jooby.annotation.*;
+
+@Trpc("users")
+@Path("/api/users")
+public class MixedTrpcAnnotation {
+
+  @Trpc
+  @GET("/{id}")
+  public U3863 getUserById(Context ctx, @PathParam long id) {
+    return null;
+  }
+
+  @Trpc
+  @POST
+  public U3863 createUser(U3863 payload) {
+    return null;
+  }
+}
diff --git a/modules/jooby-apt/src/test/java/tests/i3863/OverloadTrpc.java b/modules/jooby-apt/src/test/java/tests/i3863/OverloadTrpc.java
new file mode 100644
index 0000000000..e6a7ed4447
--- /dev/null
+++ b/modules/jooby-apt/src/test/java/tests/i3863/OverloadTrpc.java
@@ -0,0 +1,22 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package tests.i3863;
+
+import io.jooby.annotation.Trpc;
+
+@Trpc("users")
+public class OverloadTrpc {
+
+  @Trpc.Query
+  public String ping() {
+    return null;
+  }
+
+  @Trpc.Query
+  public String ping(Integer since) {
+    return null;
+  }
+}
diff --git a/modules/jooby-apt/src/test/java/tests/i3863/SpecificTrpcAnnotation.java b/modules/jooby-apt/src/test/java/tests/i3863/SpecificTrpcAnnotation.java
new file mode 100644
index 0000000000..7b61b891ca
--- /dev/null
+++ b/modules/jooby-apt/src/test/java/tests/i3863/SpecificTrpcAnnotation.java
@@ -0,0 +1,23 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package tests.i3863;
+
+import io.jooby.Context;
+import io.jooby.annotation.Trpc;
+
+@Trpc("users")
+public class SpecificTrpcAnnotation {
+
+  @Trpc.Query
+  public U3863 getUserById(Context ctx, long id) {
+    return null;
+  }
+
+  @Trpc.Mutation
+  public U3863 createUser(U3863 payload) {
+    return null;
+  }
+}
diff --git a/modules/jooby-apt/src/test/java/tests/i3863/TopLevelTrpcDoesNothingByItSelf.java b/modules/jooby-apt/src/test/java/tests/i3863/TopLevelTrpcDoesNothingByItSelf.java
new file mode 100644
index 0000000000..0df25fada1
--- /dev/null
+++ b/modules/jooby-apt/src/test/java/tests/i3863/TopLevelTrpcDoesNothingByItSelf.java
@@ -0,0 +1,21 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package tests.i3863;
+
+import io.jooby.Context;
+import io.jooby.annotation.Trpc;
+
+@Trpc("users")
+public class TopLevelTrpcDoesNothingByItSelf {
+
+  public String ping(Integer year) {
+    return null;
+  }
+
+  public U3863 findUser(Context ctx, long id) {
+    return null;
+  }
+}
diff --git a/modules/jooby-apt/src/test/java/tests/i3863/U3863.java b/modules/jooby-apt/src/test/java/tests/i3863/U3863.java
new file mode 100644
index 0000000000..d8a96d53d7
--- /dev/null
+++ b/modules/jooby-apt/src/test/java/tests/i3863/U3863.java
@@ -0,0 +1,8 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package tests.i3863;
+
+public record U3863(long id, String name) {}
diff --git a/modules/jooby-apt/src/test/java/tests/i3864/CustomNaming.java b/modules/jooby-apt/src/test/java/tests/i3864/CustomNaming.java
new file mode 100644
index 0000000000..272594fc2a
--- /dev/null
+++ b/modules/jooby-apt/src/test/java/tests/i3864/CustomNaming.java
@@ -0,0 +1,26 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package tests.i3864;
+
+import io.jooby.annotation.JsonRpc;
+
+@JsonRpc("movies")
+public class CustomNaming {
+
+  @JsonRpc("getById")
+  public String rpcMethod1() {
+    return "1";
+  }
+
+  @JsonRpc("create")
+  public String rpcMethod2() {
+    return rpcMethod3();
+  }
+
+  private String rpcMethod3() {
+    return "1";
+  }
+}
diff --git a/modules/jooby-apt/src/test/java/tests/i3864/DIService.java b/modules/jooby-apt/src/test/java/tests/i3864/DIService.java
new file mode 100644
index 0000000000..fa74d08077
--- /dev/null
+++ b/modules/jooby-apt/src/test/java/tests/i3864/DIService.java
@@ -0,0 +1,20 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package tests.i3864;
+
+import io.jooby.annotation.JsonRpc;
+import jakarta.inject.Inject;
+
+@JsonRpc
+public class DIService {
+
+  @Inject
+  public DIService(CustomNaming value) {}
+
+  public String rpcMethod1() {
+    return "1";
+  }
+}
diff --git a/modules/jooby-apt/src/test/java/tests/i3864/DefaultMapping.java b/modules/jooby-apt/src/test/java/tests/i3864/DefaultMapping.java
new file mode 100644
index 0000000000..5ae97461c7
--- /dev/null
+++ b/modules/jooby-apt/src/test/java/tests/i3864/DefaultMapping.java
@@ -0,0 +1,23 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package tests.i3864;
+
+import io.jooby.annotation.JsonRpc;
+
+@JsonRpc("default")
+public class DefaultMapping {
+  public String rpcMethod1() {
+    return "1";
+  }
+
+  public String rpcMethod2() {
+    return rpcMethod3();
+  }
+
+  private String rpcMethod3() {
+    return "1";
+  }
+}
diff --git a/modules/jooby-apt/src/test/java/tests/i3864/EmptyNamespace.java b/modules/jooby-apt/src/test/java/tests/i3864/EmptyNamespace.java
new file mode 100644
index 0000000000..52f517a4f7
--- /dev/null
+++ b/modules/jooby-apt/src/test/java/tests/i3864/EmptyNamespace.java
@@ -0,0 +1,19 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package tests.i3864;
+
+import io.jooby.annotation.JsonRpc;
+
+@JsonRpc
+public class EmptyNamespace {
+  public String rpcMethod1() {
+    return "1";
+  }
+
+  public String rpcMethod2() {
+    return "1";
+  }
+}
diff --git a/modules/jooby-apt/src/test/java/tests/i3864/ExplicitMapping.java b/modules/jooby-apt/src/test/java/tests/i3864/ExplicitMapping.java
new file mode 100644
index 0000000000..107cb4e99d
--- /dev/null
+++ b/modules/jooby-apt/src/test/java/tests/i3864/ExplicitMapping.java
@@ -0,0 +1,25 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package tests.i3864;
+
+import io.jooby.annotation.JsonRpc;
+
+@JsonRpc("explicit")
+public class ExplicitMapping {
+
+  @JsonRpc("onlyThis")
+  public String rpcMethod1() {
+    return "1";
+  }
+
+  public String rpcMethod2() {
+    return rpcMethod3();
+  }
+
+  private String rpcMethod3() {
+    return "1";
+  }
+}
diff --git a/modules/jooby-apt/src/test/java/tests/i3864/Issue3868.java b/modules/jooby-apt/src/test/java/tests/i3864/Issue3868.java
new file mode 100644
index 0000000000..0a545e471d
--- /dev/null
+++ b/modules/jooby-apt/src/test/java/tests/i3864/Issue3868.java
@@ -0,0 +1,105 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package tests.i3864;
+
+import static org.assertj.core.api.Assertions.assertThat;
+
+import org.junit.jupiter.api.Test;
+
+import io.jooby.apt.ProcessorRunner;
+
+public class Issue3868 {
+  @Test
+  public void topLevelAnnotationMakeAllPublicJSONRPC() throws Exception {
+    new ProcessorRunner(new DefaultMapping())
+        .withSourceCode(
+            source -> {
+              assertThat(source)
+                  .contains(
+                      "public class DefaultMappingRpc_ implements"
+                          + " io.jooby.rpc.jsonrpc.JsonRpcService, io.jooby.Extension {")
+                  .contains("public java.util.List<String> getMethods() {")
+                  .contains(
+                      "return java.util.List.of(\"default.rpcMethod1\", \"default.rpcMethod2\")")
+                  .contains(
+                      "public Object execute(io.jooby.Context ctx,"
+                          + " io.jooby.rpc.jsonrpc.JsonRpcRequest req) throws Exception {");
+            });
+  }
+
+  @Test
+  public void emptyNamespaceMustGenerateMethodNameOnly() throws Exception {
+    new ProcessorRunner(new EmptyNamespace())
+        .withSourceCode(
+            source -> {
+              assertThat(source)
+                  .contains("return java.util.List.of(\"rpcMethod1\", \"rpcMethod2\")");
+            });
+  }
+
+  @Test
+  public void explicitMappingTurnOffDefaultMapping() throws Exception {
+    new ProcessorRunner(new ExplicitMapping())
+        .withSourceCode(
+            source -> {
+              assertThat(source).contains("return java.util.List.of(\"explicit.onlyThis\")");
+            });
+  }
+
+  @Test
+  public void customNaming() throws Exception {
+    new ProcessorRunner(new CustomNaming())
+        .withSourceCode(
+            source -> {
+              assertThat(source)
+                  .contains("return java.util.List.of(\"movies.getById\", \"movies.create\")");
+            });
+  }
+
+  @Test
+  public void shouldInjectContext() throws Exception {
+    new ProcessorRunner(new WithContext())
+        .withSourceCode(
+            source -> {
+              assertThat(source).contains("return c.rpcMethod1(ctx, value);");
+            });
+  }
+
+  @Test
+  public void shouldFollowNullability() throws Exception {
+    new ProcessorRunner(new NullSupport())
+        .withSourceCode(
+            source -> {
+              assertThat(source)
+                  .contains(
+                      "return java.util.List.of(\"nullableInt\", \"requiredInt\","
+                          + " \"requiredString\");")
+                  // (Integer nullInt)
+                  .contains(
+                      "var nullInt = reader.nextIsNull(\"nullInt\") ? null :"
+                          + " reader.nextInt(\"nullInt\");")
+                  // (int nonnullInt)
+                  .contains("var nonnullInt = reader.nextInt(\"nonnullInt\");")
+                  // (@Nonnull String nonnullStr)
+                  .contains("var nonnullStr = reader.nextString(\"nonnullStr\");");
+            });
+  }
+
+  @Test
+  public void shouldGenerateDefaultConstructorForDI() throws Exception {
+    new ProcessorRunner(new DIService(null))
+        .withSourceCode(
+            source -> {
+              assertThat(source)
+                  .containsIgnoringNewLines(
+                      "public DIServiceRpc_() {\n" + "    this(DIService.class);\n" + "  }")
+                  .containsIgnoringNewLines(
+                      "public DIServiceRpc_(Class<DIService> type) {\n"
+                          + "    setup(ctx -> ctx.require(type));\n"
+                          + "  }");
+            });
+  }
+}
diff --git a/modules/jooby-apt/src/test/java/tests/i3864/NullSupport.java b/modules/jooby-apt/src/test/java/tests/i3864/NullSupport.java
new file mode 100644
index 0000000000..be25a2df70
--- /dev/null
+++ b/modules/jooby-apt/src/test/java/tests/i3864/NullSupport.java
@@ -0,0 +1,25 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package tests.i3864;
+
+import edu.umd.cs.findbugs.annotations.NonNull;
+import io.jooby.annotation.JsonRpc;
+
+@JsonRpc
+public class NullSupport {
+
+  public String nullableInt(Integer nullInt) {
+    return "1";
+  }
+
+  public String requiredInt(int nonnullInt) {
+    return "1";
+  }
+
+  public String requiredString(@NonNull String nonnullStr) {
+    return "1";
+  }
+}
diff --git a/modules/jooby-apt/src/test/java/tests/i3864/WithContext.java b/modules/jooby-apt/src/test/java/tests/i3864/WithContext.java
new file mode 100644
index 0000000000..93162b2e1d
--- /dev/null
+++ b/modules/jooby-apt/src/test/java/tests/i3864/WithContext.java
@@ -0,0 +1,17 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package tests.i3864;
+
+import io.jooby.Context;
+import io.jooby.annotation.JsonRpc;
+
+@JsonRpc("movies")
+public class WithContext {
+
+  public String rpcMethod1(Context ctx, Integer value) {
+    return "1";
+  }
+}
diff --git a/modules/jooby-avaje-inject/pom.xml b/modules/jooby-avaje-inject/pom.xml
index 4180caa86e..d6f877b5b9 100644
--- a/modules/jooby-avaje-inject/pom.xml
+++ b/modules/jooby-avaje-inject/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-avaje-inject</artifactId>
   <name>jooby-avaje-inject</name>
diff --git a/modules/jooby-avaje-jsonb/pom.xml b/modules/jooby-avaje-jsonb/pom.xml
index 409ca6cf0c..f875687d40 100644
--- a/modules/jooby-avaje-jsonb/pom.xml
+++ b/modules/jooby-avaje-jsonb/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-avaje-jsonb</artifactId>
   <name>jooby-avaje-jsonb</name>
diff --git a/modules/jooby-avaje-jsonb/src/main/java/io/jooby/avaje/jsonb/AvajeJsonbModule.java b/modules/jooby-avaje-jsonb/src/main/java/io/jooby/avaje/jsonb/AvajeJsonbModule.java
index e5e10ef7ff..e9543b3842 100644
--- a/modules/jooby-avaje-jsonb/src/main/java/io/jooby/avaje/jsonb/AvajeJsonbModule.java
+++ b/modules/jooby-avaje-jsonb/src/main/java/io/jooby/avaje/jsonb/AvajeJsonbModule.java
@@ -10,12 +10,19 @@
 import java.util.*;
 
 import edu.umd.cs.findbugs.annotations.NonNull;
+import io.avaje.json.JsonDataException;
 import io.avaje.json.JsonWriter;
 import io.avaje.jsonb.JsonView;
 import io.avaje.jsonb.Jsonb;
 import io.jooby.*;
-import io.jooby.internal.avaje.jsonb.BufferedJsonOutput;
+import io.jooby.internal.avaje.jsonb.*;
 import io.jooby.output.Output;
+import io.jooby.rpc.jsonrpc.JsonRpcParser;
+import io.jooby.rpc.jsonrpc.JsonRpcRequest;
+import io.jooby.rpc.jsonrpc.JsonRpcResponse;
+import io.jooby.rpc.trpc.TrpcErrorCode;
+import io.jooby.rpc.trpc.TrpcParser;
+import io.jooby.rpc.trpc.TrpcResponse;
 
 /**
  * JSON module using Avaje-JsonB: <a
@@ -68,7 +75,7 @@ public class AvajeJsonbModule implements Extension, MessageDecoder, MessageEncod
   /**
    * Creates a new module and use an Avaje-JsonB instance.
    *
-   * @param jsonb Gson to use.
+   * @param jsonb JsonB to use.
    */
   public AvajeJsonbModule(@NonNull Jsonb jsonb) {
     this.jsonb = jsonb;
@@ -76,7 +83,7 @@ public AvajeJsonbModule(@NonNull Jsonb jsonb) {
 
   /** Creates a new Avaje-JsonB module. */
   public AvajeJsonbModule() {
-    this(Jsonb.builder().build());
+    this(builder().build());
   }
 
   @Override
@@ -84,11 +91,19 @@ public void install(@NonNull Jooby application) throws Exception {
     application.decoder(MediaType.json, this);
     application.encoder(MediaType.json, this);
 
-    ServiceRegistry services = application.getServices();
+    var services = application.getServices();
     services.put(Jsonb.class, jsonb);
+    // tRpc
+    services.put(TrpcParser.class, new AvajeTrpcParser(jsonb));
+    application.errorCode(JsonDataException.class, StatusCode.BAD_REQUEST);
+    services
+        .mapOf(Class.class, TrpcErrorCode.class)
+        .put(JsonDataException.class, TrpcErrorCode.BAD_REQUEST);
+    // JSON-RPC
+    services.put(JsonRpcParser.class, new AvajeJsonRpcParser(jsonb));
   }
 
-  @NonNull @Override
+  @Override
   public Object decode(@NonNull Context ctx, @NonNull Type type) throws Exception {
     Body body = ctx.body();
     if (body.isInMemory()) {
@@ -143,4 +158,13 @@ private void encodeProjection(JsonWriter writer, Projected<?> projected) {
     var view = (JsonView<Object>) jsonbType.view(viewString);
     view.toJson(value, writer);
   }
+
+  public static Jsonb.Builder builder() {
+    var jsonb = Jsonb.builder();
+    jsonb.add(TrpcResponse.class, AvajeTrpcResponseAdapter::new);
+    jsonb.add(JsonRpcRequest.class, AvajeJsonRpcRequestAdapter::new);
+    jsonb.add(JsonRpcResponse.class, AvajeJsonRpcResponseAdapter::new);
+    jsonb.add(JsonRpcResponse.ErrorDetail.class, AvajeJsonRpcErrorAdapter::new);
+    return jsonb;
+  }
 }
diff --git a/modules/jooby-avaje-jsonb/src/main/java/io/jooby/internal/avaje/jsonb/AvajeJsonRpcDecoder.java b/modules/jooby-avaje-jsonb/src/main/java/io/jooby/internal/avaje/jsonb/AvajeJsonRpcDecoder.java
new file mode 100644
index 0000000000..354270f049
--- /dev/null
+++ b/modules/jooby-avaje-jsonb/src/main/java/io/jooby/internal/avaje/jsonb/AvajeJsonRpcDecoder.java
@@ -0,0 +1,41 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.internal.avaje.jsonb;
+
+import java.lang.reflect.Type;
+
+import io.avaje.jsonb.JsonType;
+import io.avaje.jsonb.Jsonb;
+import io.jooby.exception.MissingValueException;
+import io.jooby.exception.TypeMismatchException;
+import io.jooby.rpc.jsonrpc.JsonRpcDecoder;
+
+public class AvajeJsonRpcDecoder<T> implements JsonRpcDecoder<T> {
+
+  private final Jsonb jsonb;
+  private final Type type;
+  private final JsonType<T> typeAdapter;
+
+  public AvajeJsonRpcDecoder(Jsonb jsonb, Type type) {
+    this.jsonb = jsonb;
+    this.type = type;
+    this.typeAdapter = jsonb.type(type);
+  }
+
+  @Override
+  public T decode(String name, Object node) {
+    try {
+      if (node == null) {
+        throw new MissingValueException(name);
+      }
+      // Convert the Map/List/primitive back to JSON, then to the target type
+      // This leverages Avaje's exact mappings without needing a tree traversal model
+      return typeAdapter.fromJson(jsonb.toJson(node));
+    } catch (Exception x) {
+      throw new TypeMismatchException(name, type, x);
+    }
+  }
+}
diff --git a/modules/jooby-avaje-jsonb/src/main/java/io/jooby/internal/avaje/jsonb/AvajeJsonRpcErrorAdapter.java b/modules/jooby-avaje-jsonb/src/main/java/io/jooby/internal/avaje/jsonb/AvajeJsonRpcErrorAdapter.java
new file mode 100644
index 0000000000..0f239fd5ed
--- /dev/null
+++ b/modules/jooby-avaje-jsonb/src/main/java/io/jooby/internal/avaje/jsonb/AvajeJsonRpcErrorAdapter.java
@@ -0,0 +1,44 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.internal.avaje.jsonb;
+
+import io.avaje.json.JsonAdapter;
+import io.avaje.json.JsonReader;
+import io.avaje.json.JsonWriter;
+import io.avaje.jsonb.Jsonb;
+import io.jooby.rpc.jsonrpc.JsonRpcResponse.ErrorDetail;
+
+public class AvajeJsonRpcErrorAdapter implements JsonAdapter<ErrorDetail> {
+
+  private final Jsonb jsonb;
+
+  public AvajeJsonRpcErrorAdapter(Jsonb jsonb) {
+    this.jsonb = jsonb;
+  }
+
+  @Override
+  public void toJson(JsonWriter writer, ErrorDetail error) {
+    writer.beginObject();
+
+    writer.name("code");
+    writer.value(error.getCode());
+
+    writer.name("message");
+    writer.value(error.getMessage());
+
+    if (error.getData() != null) {
+      writer.name("data");
+      jsonb.adapter(Object.class).toJson(writer, error.getData());
+    }
+
+    writer.endObject();
+  }
+
+  @Override
+  public ErrorDetail fromJson(JsonReader reader) {
+    throw new UnsupportedOperationException("Servers don't deserialize error responses");
+  }
+}
diff --git a/modules/jooby-avaje-jsonb/src/main/java/io/jooby/internal/avaje/jsonb/AvajeJsonRpcParser.java b/modules/jooby-avaje-jsonb/src/main/java/io/jooby/internal/avaje/jsonb/AvajeJsonRpcParser.java
new file mode 100644
index 0000000000..683967005a
--- /dev/null
+++ b/modules/jooby-avaje-jsonb/src/main/java/io/jooby/internal/avaje/jsonb/AvajeJsonRpcParser.java
@@ -0,0 +1,33 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.internal.avaje.jsonb;
+
+import java.lang.reflect.Type;
+
+import io.avaje.jsonb.Jsonb;
+import io.jooby.rpc.jsonrpc.JsonRpcDecoder;
+import io.jooby.rpc.jsonrpc.JsonRpcParser;
+import io.jooby.rpc.jsonrpc.JsonRpcReader;
+
+public class AvajeJsonRpcParser implements JsonRpcParser {
+
+  private final Jsonb jsonb;
+
+  public AvajeJsonRpcParser(Jsonb jsonb) {
+    this.jsonb = jsonb;
+  }
+
+  @Override
+  public <T> JsonRpcDecoder<T> decoder(Type type) {
+    return new AvajeJsonRpcDecoder<>(jsonb, type);
+  }
+
+  @Override
+  public JsonRpcReader reader(Object params) {
+    // params will be either a List (positional) or a Map (named)
+    return new AvajeJsonRpcReader(params);
+  }
+}
diff --git a/modules/jooby-avaje-jsonb/src/main/java/io/jooby/internal/avaje/jsonb/AvajeJsonRpcReader.java b/modules/jooby-avaje-jsonb/src/main/java/io/jooby/internal/avaje/jsonb/AvajeJsonRpcReader.java
new file mode 100644
index 0000000000..332d303af4
--- /dev/null
+++ b/modules/jooby-avaje-jsonb/src/main/java/io/jooby/internal/avaje/jsonb/AvajeJsonRpcReader.java
@@ -0,0 +1,108 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.internal.avaje.jsonb;
+
+import java.util.List;
+import java.util.Map;
+
+import io.jooby.exception.MissingValueException;
+import io.jooby.exception.TypeMismatchException;
+import io.jooby.rpc.jsonrpc.JsonRpcDecoder;
+import io.jooby.rpc.jsonrpc.JsonRpcReader;
+
+public class AvajeJsonRpcReader implements JsonRpcReader {
+
+  private final Map<String, Object> map;
+  private final List<Object> list;
+  private int index = 0;
+
+  @SuppressWarnings("unchecked")
+  public AvajeJsonRpcReader(Object params) {
+    if (params instanceof List) {
+      this.list = (List<Object>) params;
+      this.map = null;
+    } else if (params instanceof Map) {
+      this.map = (Map<String, Object>) params;
+      this.list = null;
+    } else {
+      this.map = null;
+      this.list = null;
+    }
+  }
+
+  private Object peek(String name) {
+    if (list != null && index < list.size()) {
+      return list.get(index);
+    } else if (map != null) {
+      return map.get(name);
+    }
+    return null;
+  }
+
+  private Object consume(String name) {
+    if (list != null && index < list.size()) {
+      return list.get(index++);
+    } else if (map != null) {
+      return map.get(name);
+    }
+    return null;
+  }
+
+  private Object require(String name) {
+    Object value = consume(name);
+    if (value == null) {
+      throw new MissingValueException(name);
+    }
+    return value;
+  }
+
+  @Override
+  public boolean nextIsNull(String name) {
+    return peek(name) == null;
+  }
+
+  @Override
+  public int nextInt(String name) {
+    Object val = require(name);
+    if (val instanceof Number n) return n.intValue();
+    throw new TypeMismatchException(name, int.class);
+  }
+
+  @Override
+  public long nextLong(String name) {
+    Object val = require(name);
+    if (val instanceof Number n) return n.longValue();
+    throw new TypeMismatchException(name, long.class);
+  }
+
+  @Override
+  public boolean nextBoolean(String name) {
+    Object val = require(name);
+    if (val instanceof Boolean b) return b;
+    throw new TypeMismatchException(name, boolean.class);
+  }
+
+  @Override
+  public double nextDouble(String name) {
+    Object val = require(name);
+    if (val instanceof Number n) return n.doubleValue();
+    throw new TypeMismatchException(name, double.class);
+  }
+
+  @Override
+  public String nextString(String name) {
+    return require(name).toString();
+  }
+
+  @Override
+  public <T> T nextObject(String name, JsonRpcDecoder<T> decoder) {
+    var val = require(name);
+    return decoder.decode(name, val);
+  }
+
+  @Override
+  public void close() {}
+}
diff --git a/modules/jooby-avaje-jsonb/src/main/java/io/jooby/internal/avaje/jsonb/AvajeJsonRpcRequestAdapter.java b/modules/jooby-avaje-jsonb/src/main/java/io/jooby/internal/avaje/jsonb/AvajeJsonRpcRequestAdapter.java
new file mode 100644
index 0000000000..d4db2c8480
--- /dev/null
+++ b/modules/jooby-avaje-jsonb/src/main/java/io/jooby/internal/avaje/jsonb/AvajeJsonRpcRequestAdapter.java
@@ -0,0 +1,101 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.internal.avaje.jsonb;
+
+import java.util.List;
+import java.util.Map;
+
+import io.avaje.json.JsonAdapter;
+import io.avaje.json.JsonReader;
+import io.avaje.json.JsonWriter;
+import io.avaje.jsonb.JsonType;
+import io.avaje.jsonb.Jsonb;
+import io.jooby.rpc.jsonrpc.JsonRpcRequest;
+
+public class AvajeJsonRpcRequestAdapter implements JsonAdapter<JsonRpcRequest> {
+
+  private final JsonType<Object> anyType;
+
+  public AvajeJsonRpcRequestAdapter(Jsonb jsonb) {
+    // The Object.class adapter parses JSON arrays to Lists and objects to Maps
+    this.anyType = jsonb.type(Object.class);
+  }
+
+  @Override
+  public JsonRpcRequest fromJson(JsonReader reader) {
+    Object payload = anyType.fromJson(reader);
+
+    if (payload instanceof List<?> list) {
+      // Spec: Empty array must return a single Invalid Request object (-32600)
+      if (list.isEmpty()) {
+        JsonRpcRequest invalid = new JsonRpcRequest();
+        invalid.setMethod(null);
+        invalid.setBatch(false);
+        return invalid;
+      }
+
+      JsonRpcRequest batch = new JsonRpcRequest();
+      for (Object element : list) {
+        batch.add(parseSingle(element));
+      }
+      return batch;
+    } else {
+      return parseSingle(payload);
+    }
+  }
+
+  private JsonRpcRequest parseSingle(Object node) {
+    JsonRpcRequest req = new JsonRpcRequest();
+
+    if (!(node instanceof Map<?, ?> map)) {
+      req.setMethod(null); // Triggers -32600 Invalid Request
+      return req;
+    }
+
+    // 1. Extract ID
+    Object idVal = map.get("id");
+    if (idVal != null) {
+      if (idVal instanceof Number n) {
+        req.setId(n);
+      } else if (idVal instanceof String s) {
+        req.setId(s);
+      }
+    }
+
+    // 2. Validate JSON-RPC version
+    Object versionVal = map.get("jsonrpc");
+    if (!"2.0".equals(versionVal)) {
+      req.setMethod(null);
+      return req;
+    }
+
+    // 3. Extract Method
+    Object methodVal = map.get("method");
+    if (methodVal instanceof String s) {
+      req.setMethod(s);
+    } else {
+      req.setMethod(null);
+    }
+
+    // 4. Extract Params (Must be Map or List per spec)
+    Object paramsVal = map.get("params");
+    if (paramsVal != null) {
+      if (paramsVal instanceof Map || paramsVal instanceof List) {
+        req.setParams(paramsVal);
+      } else {
+        req.setMethod(null); // Primitive params -> -32600
+      }
+    }
+
+    return req;
+  }
+
+  @Override
+  public void toJson(JsonWriter writer, JsonRpcRequest value) {
+    // We only deserialize inbound requests, servers don't emit them
+    throw new UnsupportedOperationException("Serialization of JsonRpcRequest is not required");
+  }
+}
diff --git a/modules/jooby-avaje-jsonb/src/main/java/io/jooby/internal/avaje/jsonb/AvajeJsonRpcResponseAdapter.java b/modules/jooby-avaje-jsonb/src/main/java/io/jooby/internal/avaje/jsonb/AvajeJsonRpcResponseAdapter.java
new file mode 100644
index 0000000000..f696b91143
--- /dev/null
+++ b/modules/jooby-avaje-jsonb/src/main/java/io/jooby/internal/avaje/jsonb/AvajeJsonRpcResponseAdapter.java
@@ -0,0 +1,57 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.internal.avaje.jsonb;
+
+import io.avaje.json.JsonAdapter;
+import io.avaje.json.JsonReader;
+import io.avaje.json.JsonWriter;
+import io.avaje.jsonb.Jsonb;
+import io.jooby.rpc.jsonrpc.JsonRpcResponse;
+
+public class AvajeJsonRpcResponseAdapter implements JsonAdapter<JsonRpcResponse> {
+
+  private final Jsonb jsonb;
+
+  public AvajeJsonRpcResponseAdapter(Jsonb jsonb) {
+    this.jsonb = jsonb;
+  }
+
+  @Override
+  public void toJson(JsonWriter writer, JsonRpcResponse response) {
+    writer.beginObject();
+
+    writer.name("jsonrpc");
+    writer.value("2.0");
+
+    if (response.getError() != null) {
+      writer.name("error");
+      writePOJO(writer, response.getError());
+    } else {
+      writer.name("result");
+      if (response.getResult() == null) {
+        writer.nullValue();
+      } else {
+        writePOJO(writer, response.getResult());
+      }
+    }
+
+    writer.name("id");
+    var id = response.getId();
+    writer.jsonValue(id);
+
+    writer.endObject();
+  }
+
+  private void writePOJO(JsonWriter writer, Object item) {
+    JsonAdapter<Object> itemAdapter = jsonb.adapter(Object.class);
+    itemAdapter.toJson(writer, item);
+  }
+
+  @Override
+  public JsonRpcResponse fromJson(JsonReader reader) {
+    throw new UnsupportedOperationException("Servers don't deserialize responses");
+  }
+}
diff --git a/modules/jooby-avaje-jsonb/src/main/java/io/jooby/internal/avaje/jsonb/AvajeTrpcDecoder.java b/modules/jooby-avaje-jsonb/src/main/java/io/jooby/internal/avaje/jsonb/AvajeTrpcDecoder.java
new file mode 100644
index 0000000000..a318e838aa
--- /dev/null
+++ b/modules/jooby-avaje-jsonb/src/main/java/io/jooby/internal/avaje/jsonb/AvajeTrpcDecoder.java
@@ -0,0 +1,28 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.internal.avaje.jsonb;
+
+import io.avaje.jsonb.JsonType;
+import io.jooby.rpc.trpc.TrpcDecoder;
+
+public class AvajeTrpcDecoder<T> implements TrpcDecoder<T> {
+
+  final JsonType<T> typeAdapter;
+
+  public AvajeTrpcDecoder(JsonType<T> typeAdapter) {
+    this.typeAdapter = typeAdapter;
+  }
+
+  @Override
+  public T decode(String name, byte[] payload) {
+    return typeAdapter.fromJson(payload);
+  }
+
+  @Override
+  public T decode(String name, String payload) {
+    return typeAdapter.fromJson(payload);
+  }
+}
diff --git a/modules/jooby-avaje-jsonb/src/main/java/io/jooby/internal/avaje/jsonb/AvajeTrpcParser.java b/modules/jooby-avaje-jsonb/src/main/java/io/jooby/internal/avaje/jsonb/AvajeTrpcParser.java
new file mode 100644
index 0000000000..1c95ad4bae
--- /dev/null
+++ b/modules/jooby-avaje-jsonb/src/main/java/io/jooby/internal/avaje/jsonb/AvajeTrpcParser.java
@@ -0,0 +1,38 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.internal.avaje.jsonb;
+
+import java.lang.reflect.Type;
+
+import io.avaje.jsonb.Jsonb;
+import io.jooby.rpc.trpc.TrpcDecoder;
+import io.jooby.rpc.trpc.TrpcParser;
+import io.jooby.rpc.trpc.TrpcReader;
+
+public class AvajeTrpcParser implements TrpcParser {
+
+  private final Jsonb jsonb;
+
+  public AvajeTrpcParser(Jsonb jsonb) {
+    this.jsonb = jsonb;
+  }
+
+  @Override
+  public <T> TrpcDecoder<T> decoder(Type type) {
+    // Avaje resolves the AOT-generated adapter here
+    return new AvajeTrpcDecoder<>(jsonb.type(type));
+  }
+
+  @Override
+  public TrpcReader reader(byte[] payload, boolean isTuple) {
+    return new AvajeTrpcReader(jsonb.reader(payload), isTuple);
+  }
+
+  @Override
+  public TrpcReader reader(String payload, boolean isTuple) {
+    return new AvajeTrpcReader(jsonb.reader(payload), isTuple);
+  }
+}
diff --git a/modules/jooby-avaje-jsonb/src/main/java/io/jooby/internal/avaje/jsonb/AvajeTrpcReader.java b/modules/jooby-avaje-jsonb/src/main/java/io/jooby/internal/avaje/jsonb/AvajeTrpcReader.java
new file mode 100644
index 0000000000..362d89ab97
--- /dev/null
+++ b/modules/jooby-avaje-jsonb/src/main/java/io/jooby/internal/avaje/jsonb/AvajeTrpcReader.java
@@ -0,0 +1,118 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.internal.avaje.jsonb;
+
+import io.avaje.json.JsonReader;
+import io.jooby.exception.MissingValueException;
+import io.jooby.rpc.trpc.TrpcDecoder;
+import io.jooby.rpc.trpc.TrpcReader;
+
+public class AvajeTrpcReader implements TrpcReader {
+  private final JsonReader reader;
+  private boolean hasPeeked = false;
+  private final boolean isTuple;
+  private boolean isFirstRead = true;
+
+  public AvajeTrpcReader(JsonReader reader, boolean isTuple) {
+    this.reader = reader;
+    this.isTuple = isTuple;
+    if (isTuple) {
+      reader.beginArray();
+    }
+  }
+
+  @Override
+  public boolean nextIsNull(String name) {
+    if (!hasPeeked) {
+      ensureNextState(name);
+      hasPeeked = true;
+    }
+
+    if (reader.isNullValue()) {
+      reader.skipValue();
+      hasPeeked = false;
+      return true;
+    }
+
+    return false;
+  }
+
+  private void ensureNextState(String name) {
+    if (isTuple) {
+      if (!reader.hasNextElement()) {
+        throw new MissingValueException(name);
+      }
+    } else {
+      if (!isFirstRead) {
+        throw new MissingValueException(name);
+      }
+      isFirstRead = false;
+    }
+  }
+
+  private void ensureNext(String name) {
+    if (hasPeeked) {
+      hasPeeked = false;
+      return;
+    }
+    ensureNextState(name);
+  }
+
+  private void ensureNonNull(String name) {
+    if (reader.isNullValue()) throw new MissingValueException(name);
+  }
+
+  @Override
+  public int nextInt(String name) {
+    ensureNext(name);
+    ensureNonNull(name);
+    return reader.readInt();
+  }
+
+  @Override
+  public long nextLong(String name) {
+    ensureNext(name);
+    ensureNonNull(name);
+    return reader.readLong();
+  }
+
+  @Override
+  public boolean nextBoolean(String name) {
+    ensureNext(name);
+    ensureNonNull(name);
+    return reader.readBoolean();
+  }
+
+  @Override
+  public double nextDouble(String name) {
+    ensureNext(name);
+    ensureNonNull(name);
+    return reader.readDouble();
+  }
+
+  @Override
+  public String nextString(String name) {
+    ensureNext(name);
+    ensureNonNull(name);
+    return reader.readString();
+  }
+
+  @Override
+  public <T> T nextObject(String name, TrpcDecoder<T> decoder) {
+    ensureNext(name);
+    ensureNonNull(name);
+    AvajeTrpcDecoder<T> avajeDecoder = (AvajeTrpcDecoder<T>) decoder;
+    return avajeDecoder.typeAdapter.fromJson(reader);
+  }
+
+  @Override
+  public void close() {
+    if (isTuple) {
+      reader.endArray();
+    }
+    reader.close();
+  }
+}
diff --git a/modules/jooby-avaje-jsonb/src/main/java/io/jooby/internal/avaje/jsonb/AvajeTrpcResponseAdapter.java b/modules/jooby-avaje-jsonb/src/main/java/io/jooby/internal/avaje/jsonb/AvajeTrpcResponseAdapter.java
new file mode 100644
index 0000000000..baa479f733
--- /dev/null
+++ b/modules/jooby-avaje-jsonb/src/main/java/io/jooby/internal/avaje/jsonb/AvajeTrpcResponseAdapter.java
@@ -0,0 +1,49 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.internal.avaje.jsonb;
+
+import io.avaje.json.JsonAdapter;
+import io.avaje.json.JsonReader;
+import io.avaje.json.JsonWriter;
+import io.avaje.jsonb.Jsonb;
+import io.jooby.rpc.trpc.TrpcResponse;
+
+public class AvajeTrpcResponseAdapter implements JsonAdapter<TrpcResponse> {
+
+  private final Jsonb jsonb;
+
+  public AvajeTrpcResponseAdapter(Jsonb jsonb) {
+    this.jsonb = jsonb;
+  }
+
+  @Override
+  public void toJson(JsonWriter writer, TrpcResponse envelope) {
+    writer.beginObject();
+    writer.name("result");
+
+    writer.beginObject();
+    var data = envelope.data();
+
+    if (data != null) {
+      writer.name("data");
+      writePOJO(writer, data);
+    }
+
+    writer.endObject();
+    writer.endObject();
+  }
+
+  private void writePOJO(JsonWriter writer, Object item) {
+    JsonAdapter<Object> itemAdapter = jsonb.adapter(Object.class);
+    itemAdapter.toJson(writer, item);
+  }
+
+  @Override
+  public TrpcResponse<?> fromJson(JsonReader reader) {
+    // We only serialize out, tRPC clients don't send this envelope to the server
+    throw new UnsupportedOperationException("Deserialization of TrpcEnvelope is not required");
+  }
+}
diff --git a/modules/jooby-avaje-validator/pom.xml b/modules/jooby-avaje-validator/pom.xml
index c30788ec2b..d5c8a582c3 100644
--- a/modules/jooby-avaje-validator/pom.xml
+++ b/modules/jooby-avaje-validator/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-avaje-validator</artifactId>
   <name>jooby-avaje-validator</name>
diff --git a/modules/jooby-awssdk-v1/pom.xml b/modules/jooby-awssdk-v1/pom.xml
index 82d2ff98ea..da4252b05b 100644
--- a/modules/jooby-awssdk-v1/pom.xml
+++ b/modules/jooby-awssdk-v1/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-awssdk-v1</artifactId>
   <name>jooby-awssdk-v1</name>
diff --git a/modules/jooby-awssdk-v2/pom.xml b/modules/jooby-awssdk-v2/pom.xml
index 8b4fb9ff15..a8cdcbf6a6 100644
--- a/modules/jooby-awssdk-v2/pom.xml
+++ b/modules/jooby-awssdk-v2/pom.xml
@@ -6,13 +6,13 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-awssdk-v2</artifactId>
   <name>jooby-awssdk-v2</name>
 
   <properties>
-    <awssdk.version>2.42.4</awssdk.version>
+    <awssdk.version>2.42.13</awssdk.version>
   </properties>
 
   <dependencyManagement>
diff --git a/modules/jooby-bom/pom.xml b/modules/jooby-bom/pom.xml
index 3cba8f7fc9..e57f49a10b 100644
--- a/modules/jooby-bom/pom.xml
+++ b/modules/jooby-bom/pom.xml
@@ -7,14 +7,14 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
 
   <groupId>io.jooby</groupId>
   <artifactId>jooby-bom</artifactId>
   <name>jooby-bom</name>
   <packaging>pom</packaging>
-  <version>4.0.16</version>
+  <version>4.1.0</version>
   <description>Jooby (Bill of Materials)</description>
   <url>https://jooby.io</url>
 
@@ -115,6 +115,11 @@
       <artifactId>jooby-graphql</artifactId>
       <version>${project.version}</version>
     </dependency>
+    <dependency>
+      <groupId>io.jooby</groupId>
+      <artifactId>jooby-grpc</artifactId>
+      <version>${project.version}</version>
+    </dependency>
     <dependency>
       <groupId>io.jooby</groupId>
       <artifactId>jooby-gson</artifactId>
diff --git a/modules/jooby-caffeine/pom.xml b/modules/jooby-caffeine/pom.xml
index a6c318be9b..f9e1ad5101 100644
--- a/modules/jooby-caffeine/pom.xml
+++ b/modules/jooby-caffeine/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-caffeine</artifactId>
   <name>jooby-caffeine</name>
diff --git a/modules/jooby-camel/pom.xml b/modules/jooby-camel/pom.xml
index b05c86f2c2..6bc1bab5e9 100644
--- a/modules/jooby-camel/pom.xml
+++ b/modules/jooby-camel/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-camel</artifactId>
   <name>jooby-camel</name>
diff --git a/modules/jooby-cli/pom.xml b/modules/jooby-cli/pom.xml
index 4e931f8a9b..bfafd5eec5 100644
--- a/modules/jooby-cli/pom.xml
+++ b/modules/jooby-cli/pom.xml
@@ -6,14 +6,14 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-cli</artifactId>
   <name>jooby-cli</name>
 
   <properties>
     <Module-Name>io.jooby.cli</Module-Name>
-    <jline.version>3.30.6</jline.version>
+    <jline.version>3.30.8</jline.version>
     <picocli.version>4.7.7</picocli.version>
     <cli.dependencies>${project.build.outputDirectory}${file.separator}dependencies.properties</cli.dependencies>
   </properties>
diff --git a/modules/jooby-commons-email/pom.xml b/modules/jooby-commons-email/pom.xml
index b648eba77c..b7ef6a69dd 100644
--- a/modules/jooby-commons-email/pom.xml
+++ b/modules/jooby-commons-email/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-commons-email</artifactId>
   <name>jooby-commons-email</name>
diff --git a/modules/jooby-conscrypt/pom.xml b/modules/jooby-conscrypt/pom.xml
index 5deeb9a6d8..6fd32ec2a7 100644
--- a/modules/jooby-conscrypt/pom.xml
+++ b/modules/jooby-conscrypt/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-conscrypt</artifactId>
   <name>jooby-conscrypt</name>
diff --git a/modules/jooby-db-scheduler/pom.xml b/modules/jooby-db-scheduler/pom.xml
index c19f0a776c..a274216bba 100644
--- a/modules/jooby-db-scheduler/pom.xml
+++ b/modules/jooby-db-scheduler/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-db-scheduler</artifactId>
   <name>jooby-db-scheduler</name>
diff --git a/modules/jooby-distribution/pom.xml b/modules/jooby-distribution/pom.xml
index 4b16a1d559..2018ba7455 100644
--- a/modules/jooby-distribution/pom.xml
+++ b/modules/jooby-distribution/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-distribution</artifactId>
   <name>jooby-distribution</name>
diff --git a/modules/jooby-ebean/pom.xml b/modules/jooby-ebean/pom.xml
index 4e9a33afd4..d047cc0459 100644
--- a/modules/jooby-ebean/pom.xml
+++ b/modules/jooby-ebean/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-ebean</artifactId>
   <name>jooby-ebean</name>
diff --git a/modules/jooby-flyway/pom.xml b/modules/jooby-flyway/pom.xml
index ff6f5b2f6a..ba7571fdd2 100644
--- a/modules/jooby-flyway/pom.xml
+++ b/modules/jooby-flyway/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-flyway</artifactId>
   <name>jooby-flyway</name>
diff --git a/modules/jooby-freemarker/pom.xml b/modules/jooby-freemarker/pom.xml
index 3fe53adefa..b6a6234381 100644
--- a/modules/jooby-freemarker/pom.xml
+++ b/modules/jooby-freemarker/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-freemarker</artifactId>
   <name>jooby-freemarker</name>
diff --git a/modules/jooby-gradle-plugin/build.gradle b/modules/jooby-gradle-plugin/build.gradle
index 15e01f2317..70f69d5f3e 100644
--- a/modules/jooby-gradle-plugin/build.gradle
+++ b/modules/jooby-gradle-plugin/build.gradle
@@ -26,6 +26,7 @@ group = "io.jooby"
 dependencies {
   implementation "io.jooby:jooby-run:$version"
   implementation "io.jooby:jooby-openapi:$version"
+  implementation "io.jooby:jooby-trpc:$version"
   implementation "com.github.spotbugs:spotbugs-annotations:4.7.2"
 }
 
@@ -33,9 +34,9 @@ dependencies {
 gradlePlugin {
   website = 'https://jooby.io'
   vcsUrl = 'https://github.com/jooby-project/jooby'
-  description = 'Jooby is a modern, performant and easy to use web framework for Java and Kotlin ' +
-      'built on top of your favorite web server. The joobyRun task allows to restart your ' +
-      'application on code changes without exiting the JVM'
+  description = 'Jooby is a modular, high-performance web framework for Java and Kotlin. Designed ' +
+      'for simplicity and speed, it gives you the freedom to build on your favorite server with a ' +
+      'clean, modern API.'
   plugins {
     joobyRun {
       id = 'io.jooby.run'
@@ -51,5 +52,12 @@ gradlePlugin {
       tags = ['jooby', 'openAPI']
       description = 'Generates an Open-API compatible output from your application'
     }
+    trpc {
+      id = 'io.jooby.trpc'
+      implementationClass = 'io.jooby.gradle.JoobyPlugin'
+      displayName = 'Jooby tRPC plugin'
+      tags = ['jooby', 'trpc', 'typescript']
+      description = 'Generates a tRPC-compatible TypeScript API definition from your application'
+    }
   }
 }
diff --git a/modules/jooby-gradle-plugin/src/main/java/io/jooby/gradle/JoobyPlugin.java b/modules/jooby-gradle-plugin/src/main/java/io/jooby/gradle/JoobyPlugin.java
index 8145c88d97..786a0956ec 100644
--- a/modules/jooby-gradle-plugin/src/main/java/io/jooby/gradle/JoobyPlugin.java
+++ b/modules/jooby-gradle-plugin/src/main/java/io/jooby/gradle/JoobyPlugin.java
@@ -28,6 +28,7 @@ public JoobyPlugin() {
 
   @Override public void apply(Project project) {
     openAPI(project);
+    trpc(project);
 
     joobyRun(project);
     joobyTestRun(project);
@@ -64,4 +65,16 @@ private void openAPI(Project project) {
 
     project.getTasks().create(openAPIOptions);
   }
+
+  private void trpc(Project project) {
+    Map<String, Object> options = new HashMap<>();
+    options.put(Task.TASK_TYPE, OpenAPITask.class);
+    options.put(Task.TASK_DEPENDS_ON, "classes");
+    options.put(Task.TASK_NAME, "tRPC");
+    options
+        .put(Task.TASK_DESCRIPTION, "tRPC Generator");
+    options.put(Task.TASK_GROUP, "jooby");
+
+    project.getTasks().create(options);
+  }
 }
diff --git a/modules/jooby-gradle-plugin/src/main/java/io/jooby/gradle/TrpcTask.java b/modules/jooby-gradle-plugin/src/main/java/io/jooby/gradle/TrpcTask.java
new file mode 100644
index 0000000000..74c2442954
--- /dev/null
+++ b/modules/jooby-gradle-plugin/src/main/java/io/jooby/gradle/TrpcTask.java
@@ -0,0 +1,166 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.gradle;
+
+import cz.habarta.typescript.generator.DateMapping;
+import cz.habarta.typescript.generator.EnumMapping;
+import cz.habarta.typescript.generator.JsonLibrary;
+import io.jooby.trpc.TrpcGenerator;
+import org.gradle.api.tasks.Input;
+import org.gradle.api.tasks.Optional;
+import org.gradle.api.tasks.TaskAction;
+
+import java.io.File;
+import java.util.List;
+import java.util.Map;
+
+/**
+ * Generate a tRpc script file from a jooby application.
+ *
+ * Usage: https://jooby.io/modules/trpc
+ *
+ * @author edgar
+ * @since 4.0.17
+ */
+public class TrpcTask extends BaseTask {
+
+  private Map<String, String> customTypeMappings;
+
+  private Map<String, String> customTypeNaming;
+
+  private JsonLibrary jsonLibrary = JsonLibrary.jackson2;
+
+  private DateMapping mapDate = DateMapping.asString;
+
+  private EnumMapping mapEnum = EnumMapping.asInlineUnion;
+
+  private File outputDir;
+
+  private String outputFile = "trpc.d.ts";
+
+  private List<String> importDeclarations;
+
+  /**
+   * Creates a tRPC task.
+   */
+  public TrpcTask() {}
+
+  /**
+   * Generate tRPC files from Jooby application.
+   *
+   * @throws Throwable If something goes wrong.
+   */
+  @TaskAction
+  public void generate() throws Throwable {
+    var projects = getProjects();
+    var classLoader = createClassLoader(projects);
+
+    // Default to the compiled classes directory if the user hasn't overridden outputDir
+    var outDir = outputDir != null ? outputDir.toPath() : classes(getProject(), false);
+
+    var generator = new TrpcGenerator();
+    generator.setClassLoader(classLoader);
+    generator.setOutputDir(outDir);
+    generator.setOutputFile(outputFile);
+
+    if (customTypeMappings != null) {
+      generator.setCustomTypeMappings(customTypeMappings);
+    }
+    generator.setJsonLibrary(jsonLibrary);
+    generator.setMapDate(mapDate);
+    generator.setMapEnum(mapEnum);
+    if (importDeclarations != null) {
+      generator.setImportDeclarations(importDeclarations);
+    }
+    if (customTypeNaming != null) {
+      generator.setCustomTypeNaming(customTypeNaming);
+    }
+
+    getLogger().info("Generating: " + outDir.resolve(outputFile));
+
+    generator.generate();
+  }
+
+  @Input
+  @Optional
+  public Map<String, String> getCustomTypeMappings() {
+    return customTypeMappings;
+  }
+
+  public void setCustomTypeMappings(Map<String, String> customTypeMappings) {
+    this.customTypeMappings = customTypeMappings;
+  }
+
+  @Input
+  @Optional
+  public Map<String, String> getCustomTypeNaming() {
+    return customTypeNaming;
+  }
+
+  public void setCustomTypeNaming(Map<String, String> customTypeNaming) {
+    this.customTypeNaming = customTypeNaming;
+  }
+
+  @Input
+  @Optional
+  public JsonLibrary getJsonLibrary() {
+    return jsonLibrary;
+  }
+
+  public void setJsonLibrary(JsonLibrary jsonLibrary) {
+    this.jsonLibrary = jsonLibrary;
+  }
+
+  @Input
+  @Optional
+  public DateMapping getMapDate() {
+    return mapDate;
+  }
+
+  public void setMapDate(DateMapping mapDate) {
+    this.mapDate = mapDate;
+  }
+
+  @Input
+  @Optional
+  public EnumMapping getMapEnum() {
+    return mapEnum;
+  }
+
+  public void setMapEnum(EnumMapping mapEnum) {
+    this.mapEnum = mapEnum;
+  }
+
+  @Input
+  @Optional
+  public File getOutputDir() {
+    return outputDir;
+  }
+
+  public void setOutputDir(File outputDir) {
+    this.outputDir = outputDir;
+  }
+
+  @Input
+  @Optional
+  public String getOutputFile() {
+    return outputFile;
+  }
+
+  public void setOutputFile(String outputFile) {
+    this.outputFile = outputFile;
+  }
+
+  @Input
+  @Optional
+  public List<String> getImportDeclarations() {
+    return importDeclarations;
+  }
+
+  public void setImportDeclarations(List<String> importDeclarations) {
+    this.importDeclarations = importDeclarations;
+  }
+}
diff --git a/modules/jooby-gradle-setup/pom.xml b/modules/jooby-gradle-setup/pom.xml
index f3484c813a..f285be429b 100644
--- a/modules/jooby-gradle-setup/pom.xml
+++ b/modules/jooby-gradle-setup/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-gradle-setup</artifactId>
   <name>jooby-gradle-setup</name>
diff --git a/modules/jooby-graphiql/pom.xml b/modules/jooby-graphiql/pom.xml
index e2034de259..1bbc3bcb59 100644
--- a/modules/jooby-graphiql/pom.xml
+++ b/modules/jooby-graphiql/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-graphiql</artifactId>
   <name>jooby-graphiql</name>
diff --git a/modules/jooby-graphql/pom.xml b/modules/jooby-graphql/pom.xml
index 120fedd68b..50892af380 100644
--- a/modules/jooby-graphql/pom.xml
+++ b/modules/jooby-graphql/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-graphql</artifactId>
   <name>jooby-graphql</name>
diff --git a/modules/jooby-grpc/pom.xml b/modules/jooby-grpc/pom.xml
new file mode 100644
index 0000000000..e8365d8e68
--- /dev/null
+++ b/modules/jooby-grpc/pom.xml
@@ -0,0 +1,67 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
+
+  <modelVersion>4.0.0</modelVersion>
+
+  <parent>
+    <groupId>io.jooby</groupId>
+    <artifactId>modules</artifactId>
+    <version>4.1.0</version>
+  </parent>
+  <artifactId>jooby-grpc</artifactId>
+  <name>jooby-grpc</name>
+
+  <dependencies>
+    <dependency>
+      <groupId>io.jooby</groupId>
+      <artifactId>jooby</artifactId>
+      <version>${jooby.version}</version>
+    </dependency>
+
+    <dependency>
+      <groupId>org.slf4j</groupId>
+      <artifactId>jul-to-slf4j</artifactId>
+      <version>${slf4j.version}</version> </dependency>
+
+    <dependency>
+      <groupId>io.grpc</groupId>
+      <artifactId>grpc-protobuf</artifactId>
+      <version>${grpc.version}</version>
+    </dependency>
+    <dependency>
+      <groupId>io.grpc</groupId>
+      <artifactId>grpc-stub</artifactId>
+      <version>${grpc.version}</version>
+    </dependency>
+    <dependency>
+      <groupId>io.grpc</groupId>
+      <artifactId>grpc-inprocess</artifactId>
+      <version>${grpc.version}</version>
+    </dependency>
+    <dependency>
+      <groupId>io.grpc</groupId>
+      <artifactId>grpc-services</artifactId>
+      <version>${grpc.version}</version>
+    </dependency>
+
+    <!-- Test dependencies -->
+    <dependency>
+      <groupId>org.junit.jupiter</groupId>
+      <artifactId>junit-jupiter-engine</artifactId>
+      <scope>test</scope>
+    </dependency>
+
+    <dependency>
+      <groupId>org.jacoco</groupId>
+      <artifactId>org.jacoco.agent</artifactId>
+      <classifier>runtime</classifier>
+      <scope>test</scope>
+    </dependency>
+
+    <dependency>
+      <groupId>org.mockito</groupId>
+      <artifactId>mockito-core</artifactId>
+      <scope>test</scope>
+    </dependency>
+  </dependencies>
+</project>
diff --git a/modules/jooby-grpc/src/main/java/io/jooby/grpc/GrpcModule.java b/modules/jooby-grpc/src/main/java/io/jooby/grpc/GrpcModule.java
new file mode 100644
index 0000000000..cd52e5b375
--- /dev/null
+++ b/modules/jooby-grpc/src/main/java/io/jooby/grpc/GrpcModule.java
@@ -0,0 +1,195 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.grpc;
+
+import java.util.*;
+
+import org.slf4j.bridge.SLF4JBridgeHandler;
+
+import edu.umd.cs.findbugs.annotations.NonNull;
+import io.grpc.BindableService;
+import io.grpc.MethodDescriptor;
+import io.grpc.inprocess.InProcessChannelBuilder;
+import io.grpc.inprocess.InProcessServerBuilder;
+import io.jooby.*;
+import io.jooby.internal.grpc.DefaultGrpcProcessor;
+import io.jooby.rpc.grpc.GrpcProcessor;
+
+/**
+ * Native gRPC extension for Jooby. *
+ *
+ * <p>This module allows you to run strictly-typed gRPC services alongside standard Jooby HTTP
+ * routes on the exact same port. It completely bypasses standard HTTP/1.1 pipelines in favor of a
+ * highly optimized, reactive, native interceptor tailored for HTTP/2 multiplexing and trailing
+ * headers.
+ *
+ * <h3>Usage</h3>
+ *
+ * <p>gRPC requires HTTP/2. Ensure your Jooby application is configured to use a supported server
+ * with HTTP/2 enabled.
+ *
+ * <pre>{@code
+ * import io.jooby.Jooby;
+ * import io.jooby.ServerOptions;
+ * import io.jooby.grpc.GrpcModule;
+ * * public class App extends Jooby {
+ * {
+ * setServerOptions(new ServerOptions().setHttp2(true).setSecurePort(8443));
+ * * // Install the extension and register your services
+ * install(new GrpcModule(new GreeterService()));
+ * }
+ * }
+ * }</pre>
+ *
+ * <h3>Dependency Injection</h3>
+ *
+ * <p>If your gRPC services require external dependencies (like repositories or configuration), you
+ * can register the service classes instead of instances. The module will automatically provision
+ * them using Jooby's DI registry (e.g., Guice, Spring) during the application startup phase.
+ *
+ * <pre>{@code
+ * public class App extends Jooby {
+ * {
+ * install(new GuiceModule());
+ * * // Pass the class reference. Guice will instantiate it!
+ * install(new GrpcModule(GreeterService.class));
+ * }
+ * }
+ * }</pre>
+ *
+ * *
+ *
+ * <p><strong>Note:</strong> gRPC services are inherently registered as Singletons. Ensure your
+ * service implementations are thread-safe and do not hold request-scoped state in instance
+ * variables.
+ *
+ * <h3>Logging</h3>
+ *
+ * <p>gRPC internally uses {@code java.util.logging}. This module automatically installs the {@link
+ * SLF4JBridgeHandler} to redirect all internal gRPC logs to your configured SLF4J backend.
+ */
+public class GrpcModule implements Extension {
+  private final List<BindableService> services = new ArrayList<>();
+  private final List<Class<? extends BindableService>> serviceClasses = new ArrayList<>();
+
+  static {
+    // Optionally remove existing handlers attached to the j.u.l root logger
+    SLF4JBridgeHandler.removeHandlersForRootLogger();
+    // Install the SLF4J bridge
+    SLF4JBridgeHandler.install();
+  }
+
+  /**
+   * Creates a new gRPC module with pre-instantiated service objects. * @param services One or more
+   * fully instantiated gRPC services.
+   */
+  public GrpcModule(BindableService... services) {
+    this.services.addAll(Arrays.asList(services));
+  }
+
+  /**
+   * Creates a new gRPC module with service classes to be provisioned via Dependency Injection.
+   * * @param serviceClasses One or more gRPC service classes to be resolved from the Jooby
+   * registry.
+   */
+  @SafeVarargs
+  public GrpcModule(Class<? extends BindableService>... serviceClasses) {
+    bind(serviceClasses);
+  }
+
+  /**
+   * Registers additional gRPC service classes to be provisioned via Dependency Injection. * @param
+   * serviceClasses One or more gRPC service classes to be resolved from the Jooby registry.
+   *
+   * @return This module for chaining.
+   */
+  @SafeVarargs
+  public final GrpcModule bind(Class<? extends BindableService>... serviceClasses) {
+    this.serviceClasses.addAll(List.of(serviceClasses));
+    return this;
+  }
+
+  /**
+   * Installs the gRPC extension into the Jooby application. *
+   *
+   * <p>This method sets up the {@link GrpcProcessor} SPI, registers native fallback routes, and
+   * defers DI resolution and the starting of the embedded in-process gRPC server to the {@code
+   * onStarting} lifecycle hook. * @param app The target Jooby application.
+   *
+   * @throws Exception If an error occurs during installation.
+   */
+  @Override
+  public void install(@NonNull Jooby app) throws Exception {
+    var serverName = app.getName();
+    var builder = InProcessServerBuilder.forName(serverName);
+    final Map<String, MethodDescriptor<?, ?>> registry = new HashMap<>();
+
+    // 1. Register user-provided services
+    for (var service : services) {
+      bindService(app, builder, registry, service);
+    }
+
+    var services = app.getServices();
+    var processor = new DefaultGrpcProcessor(registry);
+    services.put(GrpcProcessor.class, processor);
+
+    // Lazy init service from DI.
+    app.onStarting(
+        () -> {
+          for (Class<? extends BindableService> serviceClass : serviceClasses) {
+            var service = app.require(serviceClass);
+            bindService(app, builder, registry, service);
+          }
+          var grpcServer = builder.build().start();
+
+          // KEEP .directExecutor() here!
+          // This ensures that when the background gRPC worker finishes, it instantly pushes
+          // the response back to Undertow/Netty without wasting time on another thread hop.
+          var channel = InProcessChannelBuilder.forName(serverName).directExecutor().build();
+          processor.setChannel(channel);
+
+          app.onStop(channel::shutdownNow);
+          app.onStop(grpcServer::shutdownNow);
+        });
+  }
+
+  /**
+   * Internal helper to register a service with the gRPC builder, extract its method descriptors,
+   * and map a fail-fast route in the Jooby router.
+   *
+   * @param app The target Jooby application.
+   * @param server The in-process server builder.
+   * @param registry The method descriptor registry.
+   * @param service The provisioned gRPC service to bind.
+   */
+  private static void bindService(
+      Jooby app,
+      InProcessServerBuilder server,
+      Map<String, MethodDescriptor<?, ?>> registry,
+      BindableService service) {
+    server.addService(service);
+    for (var method : service.bindService().getMethods()) {
+      var descriptor = method.getMethodDescriptor();
+      String methodFullName = descriptor.getFullMethodName();
+      registry.put(methodFullName, descriptor);
+      String routePath = "/" + methodFullName;
+
+      // Map a fallback route. If a request hits this, it means the native SPI interceptor
+      // failed to upgrade the request, typically due to a missing HTTP/2 configuration.
+      app.post(
+          routePath,
+          ctx -> {
+            throw new IllegalStateException(
+                "gRPC request reached the standard HTTP router for: "
+                    + routePath
+                    + ". "
+                    + "This means the native gRPC server interceptor was bypassed. "
+                    + "Ensure you are running with HTTP/2 enabled, "
+                    + "and that the GrpcProcessor SPI is correctly loaded.");
+          });
+    }
+  }
+}
diff --git a/modules/jooby-grpc/src/main/java/io/jooby/internal/grpc/DefaultGrpcProcessor.java b/modules/jooby-grpc/src/main/java/io/jooby/internal/grpc/DefaultGrpcProcessor.java
new file mode 100644
index 0000000000..f58358b017
--- /dev/null
+++ b/modules/jooby-grpc/src/main/java/io/jooby/internal/grpc/DefaultGrpcProcessor.java
@@ -0,0 +1,238 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.internal.grpc;
+
+import java.io.ByteArrayInputStream;
+import java.io.IOException;
+import java.io.InputStream;
+import java.nio.ByteBuffer;
+import java.util.Map;
+import java.util.concurrent.Flow;
+import java.util.concurrent.atomic.AtomicBoolean;
+
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+import edu.umd.cs.findbugs.annotations.NonNull;
+import io.grpc.CallOptions;
+import io.grpc.ManagedChannel;
+import io.grpc.MethodDescriptor;
+import io.grpc.Status;
+import io.grpc.stub.ClientCallStreamObserver;
+import io.grpc.stub.ClientCalls;
+import io.grpc.stub.ClientResponseObserver;
+import io.jooby.rpc.grpc.GrpcExchange;
+import io.jooby.rpc.grpc.GrpcProcessor;
+
+public class DefaultGrpcProcessor implements GrpcProcessor {
+
+  // Minimal Marshaller to pass raw bytes through the bridge
+  private static class RawMarshaller implements MethodDescriptor.Marshaller<byte[]> {
+    @Override
+    public InputStream stream(byte[] value) {
+      return new ByteArrayInputStream(value);
+    }
+
+    @Override
+    public byte[] parse(InputStream stream) {
+      try {
+        return stream.readAllBytes();
+      } catch (IOException e) {
+        throw new RuntimeException(e);
+      }
+    }
+  }
+
+  private final Logger log = LoggerFactory.getLogger(getClass());
+  private ManagedChannel channel;
+  private final Map<String, MethodDescriptor<?, ?>> registry;
+
+  public DefaultGrpcProcessor(Map<String, MethodDescriptor<?, ?>> registry) {
+    this.registry = registry;
+  }
+
+  public void setChannel(ManagedChannel channel) {
+    this.channel = channel;
+  }
+
+  @Override
+  public boolean isGrpcMethod(String path) {
+    // gRPC paths typically come in as "/package.Service/Method"
+    // Our registry stores them as "package.Service/Method"
+    String methodName = path.startsWith("/") ? path.substring(1) : path;
+
+    // Quick O(1) hash map lookup
+    return registry.get(methodName) != null;
+  }
+
+  @Override
+  public @NonNull Flow.Subscriber<ByteBuffer> process(@NonNull GrpcExchange exchange) {
+    // Route paths: /{package.Service}/{Method}
+    String path = exchange.getRequestPath();
+    // Remove the leading slash to match the gRPC method registry format
+    var descriptor = registry.get(path.substring(1));
+
+    if (descriptor == null) {
+      // MUST never occur, it is guarded by {@link #isGrpcMethod}
+      throw new IllegalStateException(
+          "Unregistered gRPC method: '"
+              + path
+              + "'. "
+              + "This request bypassed the GrpcProcessor.isGrpcMethod() guard, "
+              + "indicating a bug or misconfiguration in the native server interceptor.");
+    }
+
+    var method =
+        MethodDescriptor.<byte[], byte[]>newBuilder()
+            .setType(descriptor.getType())
+            .setFullMethodName(descriptor.getFullMethodName())
+            .setRequestMarshaller(new RawMarshaller())
+            .setResponseMarshaller(new RawMarshaller())
+            .build();
+
+    var callOptions = extractCallOptions(exchange);
+    var metadata = extractMetadata(exchange);
+
+    var interceptedChannel =
+        io.grpc.ClientInterceptors.intercept(
+            channel, io.grpc.stub.MetadataUtils.newAttachHeadersInterceptor(metadata));
+
+    var call = interceptedChannel.newCall(method, callOptions);
+    var isFinished = new AtomicBoolean(false);
+
+    boolean isUnaryOrServerStreaming =
+        method.getType() == MethodDescriptor.MethodType.UNARY
+            || method.getType() == MethodDescriptor.MethodType.SERVER_STREAMING;
+
+    var requestBridge = new GrpcRequestBridge(call, method.getType());
+
+    var responseObserver =
+        new ClientResponseObserver<byte[], byte[]>() {
+
+          @Override
+          public void beforeStart(ClientCallStreamObserver<byte[]> requestStream) {
+            if (!isUnaryOrServerStreaming) {
+              // requestStream.disableAutoInboundFlowControl();
+              // Wire the readiness callback securely to the bridge
+              requestStream.setOnReadyHandler(requestBridge::onGrpcReady);
+              requestBridge.setRequestObserver(requestStream);
+            }
+          }
+
+          @Override
+          public void onNext(byte[] value) {
+            if (isFinished.get()) return;
+
+            ByteBuffer framed = addGrpcHeader(value);
+
+            exchange.send(
+                framed,
+                cause -> {
+                  if (cause != null) {
+                    onError(cause);
+                  }
+                });
+          }
+
+          @Override
+          public void onError(Throwable t) {
+            if (isFinished.compareAndSet(false, true)) {
+              log.debug("gRPC stream error", t);
+              Status status = Status.fromThrowable(t);
+              exchange.close(status.getCode().value(), status.getDescription());
+            }
+          }
+
+          @Override
+          public void onCompleted() {
+            if (isFinished.compareAndSet(false, true)) {
+              exchange.close(Status.OK.getCode().value(), null);
+            }
+          }
+        };
+
+    // 2. Inject the observer to break the circular dependency
+    requestBridge.setResponseObserver(responseObserver);
+
+    if (!isUnaryOrServerStreaming) {
+      ClientCalls.asyncBidiStreamingCall(call, responseObserver);
+    }
+
+    return requestBridge;
+  }
+
+  /** Extracts the grpc-timeout header and applies it to CallOptions. */
+  private CallOptions extractCallOptions(GrpcExchange exchange) {
+    CallOptions options = CallOptions.DEFAULT;
+    String timeout = exchange.getHeader("grpc-timeout");
+
+    if (timeout == null || timeout.isEmpty()) {
+      return options;
+    }
+
+    try {
+      var unit = timeout.charAt(timeout.length() - 1);
+      var value = Long.parseLong(timeout.substring(0, timeout.length() - 1));
+
+      var timeUnit =
+          switch (unit) {
+            case 'H' -> java.util.concurrent.TimeUnit.HOURS;
+            case 'M' -> java.util.concurrent.TimeUnit.MINUTES;
+            case 'S' -> java.util.concurrent.TimeUnit.SECONDS;
+            case 'm' -> java.util.concurrent.TimeUnit.MILLISECONDS;
+            case 'u' -> java.util.concurrent.TimeUnit.MICROSECONDS;
+            case 'n' -> java.util.concurrent.TimeUnit.NANOSECONDS;
+            default -> null;
+          };
+
+      if (timeUnit != null) {
+        options = options.withDeadlineAfter(value, timeUnit);
+      }
+    } catch (Exception e) {
+      log.debug("Failed to parse grpc-timeout header: {}", timeout);
+    }
+
+    return options;
+  }
+
+  /** Maps standard HTTP headers from the GrpcExchange into gRPC Metadata. */
+  private io.grpc.Metadata extractMetadata(GrpcExchange exchange) {
+    var metadata = new io.grpc.Metadata();
+
+    for (var header : exchange.getHeaders().entrySet()) {
+      var key = header.getKey().toLowerCase();
+
+      if (key.startsWith(":")
+          || key.startsWith("grpc-")
+          || key.equals("content-type")
+          || key.equals("te")) {
+        continue;
+      }
+
+      if (key.endsWith("-bin")) {
+        io.grpc.Metadata.Key<byte[]> metaKey =
+            io.grpc.Metadata.Key.of(key, io.grpc.Metadata.BINARY_BYTE_MARSHALLER);
+        byte[] decoded = java.util.Base64.getDecoder().decode(header.getValue());
+        metadata.put(metaKey, decoded);
+      } else {
+        io.grpc.Metadata.Key<String> metaKey =
+            io.grpc.Metadata.Key.of(key, io.grpc.Metadata.ASCII_STRING_MARSHALLER);
+        metadata.put(metaKey, header.getValue());
+      }
+    }
+    return metadata;
+  }
+
+  /** Prepends the 5-byte gRPC header and returns a ready-to-write ByteBuffer. */
+  private ByteBuffer addGrpcHeader(byte[] payload) {
+    var buffer = ByteBuffer.allocate(5 + payload.length);
+    buffer.put((byte) 0); // Compressed flag (0 = none)
+    buffer.putInt(payload.length);
+    buffer.put(payload);
+    buffer.flip(); // Prepare the buffer for reading by the server socket
+    return buffer;
+  }
+}
diff --git a/modules/jooby-grpc/src/main/java/io/jooby/internal/grpc/GrpcDeframer.java b/modules/jooby-grpc/src/main/java/io/jooby/internal/grpc/GrpcDeframer.java
new file mode 100644
index 0000000000..e011293c0f
--- /dev/null
+++ b/modules/jooby-grpc/src/main/java/io/jooby/internal/grpc/GrpcDeframer.java
@@ -0,0 +1,65 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.internal.grpc;
+
+import java.nio.ByteBuffer;
+import java.util.function.Consumer;
+
+public class GrpcDeframer {
+  private enum State {
+    HEADER,
+    PAYLOAD
+  }
+
+  private State state = State.HEADER;
+  private final ByteBuffer headerBuffer = ByteBuffer.allocate(5);
+  private ByteBuffer payloadBuffer;
+
+  /** Processes a chunk of data directly from the server's native ByteBuffer. */
+  public void process(ByteBuffer input, Consumer<byte[]> onMessage) {
+    while (input.hasRemaining()) {
+      if (state == State.HEADER) {
+        int toRead = Math.min(headerBuffer.remaining(), input.remaining());
+
+        // Bulk read into header buffer
+        int oldLimit = input.limit();
+        input.limit(input.position() + toRead);
+        headerBuffer.put(input);
+        input.limit(oldLimit);
+
+        if (!headerBuffer.hasRemaining()) {
+          headerBuffer.flip();
+          headerBuffer.get(); // skip compressed flag
+          int length = headerBuffer.getInt();
+
+          if (length == 0) {
+            onMessage.accept(new byte[0]);
+            headerBuffer.clear();
+          } else {
+            payloadBuffer = ByteBuffer.allocate(length);
+            state = State.PAYLOAD;
+          }
+        }
+      } else if (state == State.PAYLOAD) {
+        int toRead = Math.min(payloadBuffer.remaining(), input.remaining());
+
+        // Bulk read into payload buffer
+        int oldLimit = input.limit();
+        input.limit(input.position() + toRead);
+        payloadBuffer.put(input);
+        input.limit(oldLimit);
+
+        if (!payloadBuffer.hasRemaining()) {
+          // The full gRPC message is assembled. Emit it.
+          onMessage.accept(payloadBuffer.array());
+          headerBuffer.clear();
+          payloadBuffer = null;
+          state = State.HEADER;
+        }
+      }
+    }
+  }
+}
diff --git a/modules/jooby-grpc/src/main/java/io/jooby/internal/grpc/GrpcRequestBridge.java b/modules/jooby-grpc/src/main/java/io/jooby/internal/grpc/GrpcRequestBridge.java
new file mode 100644
index 0000000000..4a65e74bd3
--- /dev/null
+++ b/modules/jooby-grpc/src/main/java/io/jooby/internal/grpc/GrpcRequestBridge.java
@@ -0,0 +1,121 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.internal.grpc;
+
+import java.nio.ByteBuffer;
+import java.util.concurrent.Flow.Subscriber;
+import java.util.concurrent.Flow.Subscription;
+import java.util.concurrent.atomic.AtomicBoolean;
+
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+import io.grpc.ClientCall;
+import io.grpc.MethodDescriptor;
+import io.grpc.stub.ClientCallStreamObserver;
+import io.grpc.stub.ClientCalls;
+import io.grpc.stub.ClientResponseObserver;
+
+public class GrpcRequestBridge implements Subscriber<ByteBuffer> {
+
+  private final Logger log = LoggerFactory.getLogger(getClass());
+  private final GrpcDeframer deframer = new GrpcDeframer();
+  private final AtomicBoolean completed = new AtomicBoolean(false);
+
+  private final ClientCall<byte[], byte[]> call;
+  private final MethodDescriptor.MethodType methodType;
+  private final boolean isUnaryOrServerStreaming;
+
+  private ClientResponseObserver<byte[], byte[]> responseObserver;
+  private ClientCallStreamObserver<byte[]> requestObserver;
+  private Subscription subscription;
+  private byte[] singlePayload;
+
+  public GrpcRequestBridge(
+      ClientCall<byte[], byte[]> call, MethodDescriptor.MethodType methodType) {
+    this.call = call;
+    this.methodType = methodType;
+    this.isUnaryOrServerStreaming =
+        methodType == MethodDescriptor.MethodType.UNARY
+            || methodType == MethodDescriptor.MethodType.SERVER_STREAMING;
+  }
+
+  public void setResponseObserver(ClientResponseObserver<byte[], byte[]> responseObserver) {
+    this.responseObserver = responseObserver;
+  }
+
+  public void setRequestObserver(ClientCallStreamObserver<byte[]> requestObserver) {
+    this.requestObserver = requestObserver;
+  }
+
+  public void onGrpcReady() {
+    if (subscription != null
+        && requestObserver != null
+        && requestObserver.isReady()
+        && !completed.get()) {
+      subscription.request(1);
+    }
+  }
+
+  @Override
+  public void onSubscribe(Subscription subscription) {
+    this.subscription = subscription;
+    // Initial demand to kick off the network body reader
+    subscription.request(1);
+  }
+
+  @Override
+  public void onNext(ByteBuffer item) {
+    try {
+      deframer.process(
+          item,
+          msg -> {
+            if (isUnaryOrServerStreaming) {
+              singlePayload = msg;
+            } else {
+              requestObserver.onNext(msg);
+            }
+          });
+
+      if (isUnaryOrServerStreaming) {
+        subscription.request(1); // Keep reading until EOF for unary/server-streaming
+      } else if (requestObserver != null && requestObserver.isReady()) {
+        subscription.request(1); // Ask for more if the streaming gRPC buffer is ready
+      }
+    } catch (Throwable t) {
+      subscription.cancel();
+      onError(t);
+    }
+  }
+
+  @Override
+  public void onError(Throwable throwable) {
+    if (completed.compareAndSet(false, true)) {
+      log.error("Error in gRPC request stream", throwable);
+      if (requestObserver != null) {
+        requestObserver.onError(throwable);
+      } else if (responseObserver != null) {
+        responseObserver.onError(throwable);
+      }
+    }
+  }
+
+  @Override
+  public void onComplete() {
+    if (completed.compareAndSet(false, true)) {
+      if (isUnaryOrServerStreaming) {
+        byte[] payload = singlePayload == null ? new byte[0] : singlePayload;
+        if (methodType == MethodDescriptor.MethodType.UNARY) {
+          ClientCalls.asyncUnaryCall(call, payload, responseObserver);
+        } else {
+          ClientCalls.asyncServerStreamingCall(call, payload, responseObserver);
+        }
+      } else if (requestObserver != null) {
+        requestObserver.onCompleted();
+      }
+    }
+  }
+}
diff --git a/modules/jooby-grpc/src/main/java/module-info.java b/modules/jooby-grpc/src/main/java/module-info.java
new file mode 100644
index 0000000000..83978449fc
--- /dev/null
+++ b/modules/jooby-grpc/src/main/java/module-info.java
@@ -0,0 +1,18 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+/** GraphQL module. */
+module io.jooby.grpc {
+  exports io.jooby.grpc;
+
+  requires io.jooby;
+  requires static com.github.spotbugs.annotations;
+  requires typesafe.config;
+  requires org.slf4j;
+  requires jul.to.slf4j;
+  requires io.grpc;
+  requires io.grpc.inprocess;
+  requires io.grpc.stub;
+}
diff --git a/modules/jooby-grpc/src/test/java/io/jooby/grpc/DefaultGrpcProcessorTest.java b/modules/jooby-grpc/src/test/java/io/jooby/grpc/DefaultGrpcProcessorTest.java
new file mode 100644
index 0000000000..a003cb99ff
--- /dev/null
+++ b/modules/jooby-grpc/src/test/java/io/jooby/grpc/DefaultGrpcProcessorTest.java
@@ -0,0 +1,221 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.grpc;
+
+import static org.junit.jupiter.api.Assertions.assertArrayEquals;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.ArgumentMatchers.anyInt;
+import static org.mockito.Mockito.mock;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.when;
+
+import java.nio.ByteBuffer;
+import java.util.Base64;
+import java.util.Map;
+import java.util.concurrent.Flow;
+
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Test;
+import org.mockito.ArgumentCaptor;
+
+import io.grpc.CallOptions;
+import io.grpc.ClientCall;
+import io.grpc.ManagedChannel;
+import io.grpc.Metadata;
+import io.grpc.MethodDescriptor;
+import io.grpc.Status;
+import io.jooby.internal.grpc.DefaultGrpcProcessor;
+import io.jooby.internal.grpc.GrpcRequestBridge;
+import io.jooby.rpc.grpc.GrpcExchange;
+
+public class DefaultGrpcProcessorTest {
+
+  private ManagedChannel channel;
+  private Map<String, MethodDescriptor<?, ?>> registry;
+  private GrpcExchange exchange;
+  private ClientCall<byte[], byte[]> call;
+  private DefaultGrpcProcessor bridge;
+
+  @BeforeEach
+  @SuppressWarnings("unchecked")
+  public void setUp() {
+    channel = mock(ManagedChannel.class);
+    registry = mock(Map.class);
+    exchange = mock(GrpcExchange.class);
+    call = mock(ClientCall.class);
+
+    // The interceptor wraps the channel, but eventually delegates to the real one
+    when(channel.newCall(any(MethodDescriptor.class), any(CallOptions.class))).thenReturn(call);
+
+    bridge = new DefaultGrpcProcessor(registry);
+    bridge.setChannel(channel);
+  }
+
+  @Test
+  @DisplayName(
+      "Should throw IllegalStateException if an unknown method bypasses the isGrpcMethod guard")
+  public void shouldRejectUnknownMethod() {
+    when(exchange.getRequestPath()).thenReturn("/unknown.Service/Method");
+    when(registry.get("unknown.Service/Method")).thenReturn(null);
+
+    // Assert that the bridge correctly identifies the illegal state
+    IllegalStateException exception =
+        org.junit.jupiter.api.Assertions.assertThrows(
+            IllegalStateException.class, () -> bridge.process(exchange));
+
+    // Ensure the exchange wasn't manipulated or closed, because the framework
+    // should crash the thread instead of trying to gracefully close a gRPC stream.
+    verify(exchange, org.mockito.Mockito.never()).close(anyInt(), any());
+  }
+
+  @Test
+  @DisplayName("Should successfully bridge a valid Bidi-Streaming gRPC call")
+  public void shouldProcessValidStreamingCall() {
+    setupValidMethod("test.Chat/Stream", MethodDescriptor.MethodType.BIDI_STREAMING);
+
+    Flow.Subscriber<ByteBuffer> subscriber = bridge.process(exchange);
+
+    assertNotNull(subscriber);
+    assertTrue(subscriber instanceof GrpcRequestBridge);
+
+    // Verify call was actually created
+    verify(channel).newCall(any(MethodDescriptor.class), any(CallOptions.class));
+  }
+
+  @Test
+  @DisplayName("Should parse grpc-timeout header into CallOptions deadline")
+  public void shouldParseGrpcTimeout() {
+    setupValidMethod("test.Chat/TimeoutCall", MethodDescriptor.MethodType.UNARY);
+
+    // 1000m = 1000 milliseconds
+    when(exchange.getHeader("grpc-timeout")).thenReturn("1000m");
+
+    bridge.process(exchange);
+
+    ArgumentCaptor<CallOptions> optionsCaptor = ArgumentCaptor.forClass(CallOptions.class);
+    verify(channel).newCall(any(MethodDescriptor.class), optionsCaptor.capture());
+
+    CallOptions options = optionsCaptor.getValue();
+    assertNotNull(options.getDeadline());
+    assertTrue(options.getDeadline().isExpired() == false, "Deadline should be in the future");
+  }
+
+  @Test
+  @DisplayName("Should correctly deframe and send gRPC payload to the client")
+  public void shouldFrameAndSendResponsePayload() {
+    setupValidMethod("test.Chat/Stream", MethodDescriptor.MethodType.BIDI_STREAMING);
+    bridge.process(exchange);
+
+    // Capture the internal listener that gRPC uses to push data back to us
+    ArgumentCaptor<ClientCall.Listener<byte[]>> listenerCaptor =
+        ArgumentCaptor.forClass(ClientCall.Listener.class);
+    verify(call).start(listenerCaptor.capture(), any(Metadata.class));
+    ClientCall.Listener<byte[]> responseListener = listenerCaptor.getValue();
+
+    // Simulate the server pushing a payload back
+    byte[] serverResponse = "hello".getBytes();
+    responseListener.onMessage(serverResponse);
+
+    // Verify our bridge framed it with the 5-byte header and sent it to Jooby
+    ArgumentCaptor<ByteBuffer> bufferCaptor = ArgumentCaptor.forClass(ByteBuffer.class);
+    verify(exchange).send(bufferCaptor.capture(), any());
+
+    ByteBuffer framedBuffer = bufferCaptor.getValue();
+    assertEquals(5 + serverResponse.length, framedBuffer.limit());
+    assertEquals((byte) 0, framedBuffer.get(), "Compressed flag should be 0");
+    assertEquals(serverResponse.length, framedBuffer.getInt(), "Length should match payload");
+
+    byte[] capturedPayload = new byte[serverResponse.length];
+    framedBuffer.get(capturedPayload);
+    assertArrayEquals(serverResponse, capturedPayload);
+  }
+
+  @Test
+  @DisplayName("Should close exchange with HTTP/2 trailing status when server throws error")
+  public void shouldCloseExchangeOnError() {
+    setupValidMethod("test.Chat/Stream", MethodDescriptor.MethodType.BIDI_STREAMING);
+    bridge.process(exchange);
+
+    ArgumentCaptor<ClientCall.Listener<byte[]>> listenerCaptor =
+        ArgumentCaptor.forClass(ClientCall.Listener.class);
+    verify(call).start(listenerCaptor.capture(), any(Metadata.class));
+    ClientCall.Listener<byte[]> responseListener = listenerCaptor.getValue();
+
+    // Simulate an internal server error from the gRPC engine
+    Status errorStatus = Status.INVALID_ARGUMENT.withDescription("Bad data");
+    responseListener.onClose(errorStatus, new Metadata());
+
+    // Verify it mapped down to the core exchange SPI
+    verify(exchange).close(errorStatus.getCode().value(), "Bad data");
+  }
+
+  @Test
+  @DisplayName("Should gracefully close exchange with Status 0 on completion")
+  public void shouldCloseExchangeOnComplete() {
+    setupValidMethod("test.Chat/Stream", MethodDescriptor.MethodType.BIDI_STREAMING);
+    bridge.process(exchange);
+
+    ArgumentCaptor<ClientCall.Listener<byte[]>> listenerCaptor =
+        ArgumentCaptor.forClass(ClientCall.Listener.class);
+    verify(call).start(listenerCaptor.capture(), any(Metadata.class));
+    ClientCall.Listener<byte[]> responseListener = listenerCaptor.getValue();
+
+    // Simulate clean completion
+    responseListener.onClose(Status.OK, new Metadata());
+
+    verify(exchange).close(Status.OK.getCode().value(), null);
+  }
+
+  @Test
+  @DisplayName("Should extract and decode custom metadata headers")
+  public void shouldExtractMetadata() {
+    // CRITICAL FIX: Use BIDI_STREAMING instead of UNARY.
+    // Unary delays call.start() until the request stream completes. Bidi starts immediately.
+    setupValidMethod("test.Chat/Headers", MethodDescriptor.MethodType.BIDI_STREAMING);
+
+    Map<String, String> incomingHeaders =
+        Map.of(
+            "x-custom-id",
+            "12345",
+            "x-custom-bin",
+            Base64.getEncoder().encodeToString("binary_data".getBytes()));
+    when(exchange.getHeaders()).thenReturn(incomingHeaders);
+
+    bridge.process(exchange);
+
+    // Verify that the metadata was extracted and attached to the call
+    ArgumentCaptor<Metadata> metadataCaptor = ArgumentCaptor.forClass(Metadata.class);
+    verify(call).start(any(), metadataCaptor.capture());
+
+    Metadata metadata = metadataCaptor.getValue();
+
+    assertEquals(
+        "12345", metadata.get(Metadata.Key.of("x-custom-id", Metadata.ASCII_STRING_MARSHALLER)));
+    assertArrayEquals(
+        "binary_data".getBytes(),
+        metadata.get(Metadata.Key.of("x-custom-bin", Metadata.BINARY_BYTE_MARSHALLER)));
+  }
+
+  /** Helper to mock out a valid MethodDescriptor in the registry. */
+  @SuppressWarnings("unchecked")
+  private void setupValidMethod(String methodPath, MethodDescriptor.MethodType type) {
+    MethodDescriptor<byte[], byte[]> descriptor =
+        MethodDescriptor.<byte[], byte[]>newBuilder()
+            .setType(type)
+            .setFullMethodName(methodPath)
+            .setRequestMarshaller(mock(MethodDescriptor.Marshaller.class))
+            .setResponseMarshaller(mock(MethodDescriptor.Marshaller.class))
+            .build();
+
+    when(exchange.getRequestPath()).thenReturn("/" + methodPath);
+    //noinspection rawtypes
+    when(registry.get(methodPath)).thenReturn((MethodDescriptor) descriptor);
+  }
+}
diff --git a/modules/jooby-grpc/src/test/java/io/jooby/grpc/GrpcDeframerTest.java b/modules/jooby-grpc/src/test/java/io/jooby/grpc/GrpcDeframerTest.java
new file mode 100644
index 0000000000..5239681cc9
--- /dev/null
+++ b/modules/jooby-grpc/src/test/java/io/jooby/grpc/GrpcDeframerTest.java
@@ -0,0 +1,126 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.grpc;
+
+import static org.junit.jupiter.api.Assertions.*;
+
+import java.nio.ByteBuffer;
+import java.util.ArrayList;
+import java.util.List;
+
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+
+import io.jooby.internal.grpc.GrpcDeframer;
+
+public class GrpcDeframerTest {
+
+  private GrpcDeframer deframer;
+  private List<byte[]> outputMessages;
+
+  @BeforeEach
+  public void setUp() {
+    deframer = new GrpcDeframer();
+    outputMessages = new ArrayList<>();
+  }
+
+  @Test
+  public void shouldParseSingleCompleteMessage() {
+    byte[] payload = "hello grpc".getBytes();
+    ByteBuffer frame = createGrpcFrame(payload);
+
+    deframer.process(frame, msg -> outputMessages.add(msg));
+
+    assertEquals(1, outputMessages.size());
+    assertArrayEquals(payload, outputMessages.get(0));
+  }
+
+  @Test
+  public void shouldParseFragmentedHeader() {
+    byte[] payload = "fragmented header".getBytes();
+    byte[] frame = createGrpcFrame(payload).array();
+
+    // Send the first 2 bytes of the header
+    deframer.process(ByteBuffer.wrap(frame, 0, 2), msg -> outputMessages.add(msg));
+    assertEquals(0, outputMessages.size(), "Should not emit message yet");
+
+    // Send the rest of the header and the payload
+    deframer.process(ByteBuffer.wrap(frame, 2, frame.length - 2), msg -> outputMessages.add(msg));
+
+    assertEquals(1, outputMessages.size());
+    assertArrayEquals(payload, outputMessages.get(0));
+  }
+
+  @Test
+  public void shouldParseFragmentedPayload() {
+    byte[] payload = "this is a very long payload that gets split".getBytes();
+    byte[] frame = createGrpcFrame(payload).array();
+
+    // Send the 5-byte header + first 10 bytes of payload (15 bytes total)
+    deframer.process(ByteBuffer.wrap(frame, 0, 15), msg -> outputMessages.add(msg));
+    assertEquals(0, outputMessages.size(), "Should not emit message until full payload arrives");
+
+    // Send the remainder of the payload
+    deframer.process(ByteBuffer.wrap(frame, 15, frame.length - 15), msg -> outputMessages.add(msg));
+
+    assertEquals(1, outputMessages.size());
+    assertArrayEquals(payload, outputMessages.get(0));
+  }
+
+  @Test
+  public void shouldParseMultipleMessagesInSingleBuffer() {
+    byte[] payload1 = "message 1".getBytes();
+    byte[] payload2 = "message 2".getBytes();
+
+    ByteBuffer frame1 = createGrpcFrame(payload1);
+    ByteBuffer frame2 = createGrpcFrame(payload2);
+
+    // Combine both frames into a single buffer
+    ByteBuffer combined = ByteBuffer.allocate(frame1.capacity() + frame2.capacity());
+    combined.put(frame1).put(frame2);
+    combined.flip();
+
+    deframer.process(combined, msg -> outputMessages.add(msg));
+
+    assertEquals(2, outputMessages.size());
+    assertArrayEquals(payload1, outputMessages.get(0));
+    assertArrayEquals(payload2, outputMessages.get(1));
+  }
+
+  @Test
+  public void shouldHandleZeroLengthPayload() {
+    byte[] payload = new byte[0];
+    ByteBuffer frame = createGrpcFrame(payload);
+
+    deframer.process(frame, msg -> outputMessages.add(msg));
+
+    assertEquals(1, outputMessages.size());
+    assertArrayEquals(payload, outputMessages.get(0));
+  }
+
+  @Test
+  public void shouldHandleExtremeFragmentationByteByByte() {
+    byte[] payload = "byte by byte".getBytes();
+    byte[] frame = createGrpcFrame(payload).array();
+
+    for (byte b : frame) {
+      deframer.process(ByteBuffer.wrap(new byte[] {b}), msg -> outputMessages.add(msg));
+    }
+
+    assertEquals(1, outputMessages.size());
+    assertArrayEquals(payload, outputMessages.get(0));
+  }
+
+  /** Helper to wrap a raw payload in the standard 5-byte gRPC framing. */
+  private ByteBuffer createGrpcFrame(byte[] payload) {
+    ByteBuffer buffer = ByteBuffer.allocate(5 + payload.length);
+    buffer.put((byte) 0); // Compressed flag
+    buffer.putInt(payload.length); // Length
+    buffer.put(payload); // Data
+    buffer.flip();
+    return buffer;
+  }
+}
diff --git a/modules/jooby-grpc/src/test/java/io/jooby/grpc/GrpcRequestBridgeTest.java b/modules/jooby-grpc/src/test/java/io/jooby/grpc/GrpcRequestBridgeTest.java
new file mode 100644
index 0000000000..2d6ed11699
--- /dev/null
+++ b/modules/jooby-grpc/src/test/java/io/jooby/grpc/GrpcRequestBridgeTest.java
@@ -0,0 +1,159 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.grpc;
+
+import static org.junit.jupiter.api.Assertions.assertArrayEquals;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.ArgumentMatchers.anyLong;
+import static org.mockito.Mockito.mock;
+import static org.mockito.Mockito.never;
+import static org.mockito.Mockito.reset;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.when;
+
+import java.nio.ByteBuffer;
+import java.util.concurrent.Flow.Subscription;
+
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Test;
+import org.mockito.ArgumentCaptor;
+
+import io.grpc.ClientCall;
+import io.grpc.MethodDescriptor;
+import io.grpc.stub.ClientCallStreamObserver;
+import io.grpc.stub.ClientResponseObserver;
+import io.jooby.internal.grpc.GrpcRequestBridge;
+
+public class GrpcRequestBridgeTest {
+
+  private ClientCall<byte[], byte[]> call;
+  private Subscription subscription;
+  private ClientCallStreamObserver<byte[]> requestObserver;
+  private ClientResponseObserver<byte[], byte[]> responseObserver;
+  private GrpcRequestBridge bridge;
+
+  @BeforeEach
+  @SuppressWarnings("unchecked")
+  public void setUp() {
+    call = mock(ClientCall.class);
+    subscription = mock(Subscription.class);
+    requestObserver = mock(ClientCallStreamObserver.class);
+    responseObserver = mock(ClientResponseObserver.class);
+
+    // Default to BIDI_STREAMING to test standard flow-control and backpressure
+    bridge = new GrpcRequestBridge(call, MethodDescriptor.MethodType.BIDI_STREAMING);
+    bridge.setRequestObserver(requestObserver);
+    bridge.setResponseObserver(responseObserver);
+  }
+
+  @Test
+  @DisplayName("Should request initial demand (1) upon subscription")
+  public void shouldRequestInitialDemandOnSubscribe() {
+    bridge.onSubscribe(subscription);
+
+    verify(subscription).request(1);
+  }
+
+  @Test
+  @DisplayName("Should forward payload to requestObserver and request more if gRPC buffer is ready")
+  public void shouldSendMessageAndRequestMoreIfReady() {
+    bridge.onSubscribe(subscription);
+    reset(subscription); // Clear the initial request(1) counter
+
+    when(requestObserver.isReady()).thenReturn(true);
+
+    byte[] payload = "test".getBytes();
+    ByteBuffer frame = createFrame(payload);
+
+    bridge.onNext(frame);
+
+    ArgumentCaptor<byte[]> captor = ArgumentCaptor.forClass(byte[].class);
+    verify(requestObserver).onNext(captor.capture());
+    assertArrayEquals(payload, captor.getValue(), "The deframed payload should match exactly");
+
+    // Because isReady() is true, it should demand the next network chunk
+    verify(subscription).request(1);
+  }
+
+  @Test
+  @DisplayName(
+      "Should forward payload but apply backpressure (do not request) if gRPC is not ready")
+  public void shouldNotRequestMoreIfNotReady() {
+    bridge.onSubscribe(subscription);
+    reset(subscription);
+
+    when(requestObserver.isReady()).thenReturn(false);
+
+    byte[] payload = "test".getBytes();
+    bridge.onNext(createFrame(payload));
+
+    verify(requestObserver).onNext(any());
+
+    // Since isReady() is false, it should NOT request more data, effectively applying backpressure
+    verify(subscription, never()).request(anyLong());
+  }
+
+  @Test
+  @DisplayName("Should complete the requestObserver when the network stream completes")
+  public void shouldCompleteRequestObserverOnComplete() {
+    bridge.onSubscribe(subscription);
+    bridge.onComplete();
+
+    verify(requestObserver).onCompleted();
+  }
+
+  @Test
+  @DisplayName("Should propagate network errors to the requestObserver")
+  public void shouldPropagateErrorToObserver() {
+    bridge.onSubscribe(subscription);
+    Throwable error = new RuntimeException("Stream network failure");
+
+    bridge.onError(error);
+
+    verify(requestObserver).onError(error);
+  }
+
+  @Test
+  @DisplayName("Unary calls should accumulate payload without forwarding until EOF")
+  public void shouldHandleUnaryCallsDifferently() {
+    bridge = new GrpcRequestBridge(call, MethodDescriptor.MethodType.UNARY);
+    bridge.setResponseObserver(responseObserver);
+    bridge.onSubscribe(subscription);
+    reset(subscription);
+
+    byte[] payload = "unary".getBytes();
+    bridge.onNext(createFrame(payload));
+
+    // For Unary and Server Streaming, chunks are NOT passed via onNext
+    verify(requestObserver, never()).onNext(any());
+
+    // It should keep requesting data from the network until EOF is reached
+    verify(subscription).request(1);
+  }
+
+  @Test
+  @DisplayName("onGrpcReady callback should trigger network demand if stream is active")
+  public void shouldRequestMoreOnGrpcReady() {
+    bridge.onSubscribe(subscription);
+    reset(subscription);
+
+    when(requestObserver.isReady()).thenReturn(true);
+
+    bridge.onGrpcReady();
+
+    verify(subscription).request(1);
+  }
+
+  private ByteBuffer createFrame(byte[] payload) {
+    ByteBuffer frame = ByteBuffer.allocate(5 + payload.length);
+    frame.put((byte) 0); // Uncompressed flag
+    frame.putInt(payload.length);
+    frame.put(payload);
+    frame.flip(); // Prepare buffer for reading
+    return frame;
+  }
+}
diff --git a/modules/jooby-gson/pom.xml b/modules/jooby-gson/pom.xml
index 8ed17eb338..1cf6e93815 100644
--- a/modules/jooby-gson/pom.xml
+++ b/modules/jooby-gson/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-gson</artifactId>
   <name>jooby-gson</name>
diff --git a/modules/jooby-guice/pom.xml b/modules/jooby-guice/pom.xml
index a8a6afe8f3..4638437674 100644
--- a/modules/jooby-guice/pom.xml
+++ b/modules/jooby-guice/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-guice</artifactId>
   <name>jooby-guice</name>
diff --git a/modules/jooby-handlebars/pom.xml b/modules/jooby-handlebars/pom.xml
index 5c0d7a89f8..df87a86569 100644
--- a/modules/jooby-handlebars/pom.xml
+++ b/modules/jooby-handlebars/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-handlebars</artifactId>
   <name>jooby-handlebars</name>
diff --git a/modules/jooby-hibernate-validator/pom.xml b/modules/jooby-hibernate-validator/pom.xml
index a1d658b579..bf8a0dfb80 100644
--- a/modules/jooby-hibernate-validator/pom.xml
+++ b/modules/jooby-hibernate-validator/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-hibernate-validator</artifactId>
   <name>jooby-hibernate-validator</name>
diff --git a/modules/jooby-hibernate/pom.xml b/modules/jooby-hibernate/pom.xml
index 91c07d0072..6db6b9a3fd 100644
--- a/modules/jooby-hibernate/pom.xml
+++ b/modules/jooby-hibernate/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-hibernate</artifactId>
   <name>jooby-hibernate</name>
diff --git a/modules/jooby-hikari/pom.xml b/modules/jooby-hikari/pom.xml
index 515a16bf56..4f877d5d81 100644
--- a/modules/jooby-hikari/pom.xml
+++ b/modules/jooby-hikari/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-hikari</artifactId>
   <name>jooby-hikari</name>
diff --git a/modules/jooby-jackson/pom.xml b/modules/jooby-jackson/pom.xml
index 80bc59429e..b4672a3248 100644
--- a/modules/jooby-jackson/pom.xml
+++ b/modules/jooby-jackson/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-jackson</artifactId>
   <name>jooby-jackson</name>
@@ -71,6 +71,10 @@
       <version>1.37</version>
       <scope>test</scope>
     </dependency>
+    <dependency>
+      <groupId>jakarta.json.bind</groupId>
+      <artifactId>jakarta.json.bind-api</artifactId>
+    </dependency>
   </dependencies>
 
   <build>
diff --git a/modules/jooby-jackson/src/main/java/io/jooby/internal/jackson/JacksonJsonRpcDecoder.java b/modules/jooby-jackson/src/main/java/io/jooby/internal/jackson/JacksonJsonRpcDecoder.java
new file mode 100644
index 0000000000..e03a33e682
--- /dev/null
+++ b/modules/jooby-jackson/src/main/java/io/jooby/internal/jackson/JacksonJsonRpcDecoder.java
@@ -0,0 +1,38 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.internal.jackson;
+
+import java.lang.reflect.Type;
+
+import com.fasterxml.jackson.databind.JavaType;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.fasterxml.jackson.databind.ObjectMapper;
+import io.jooby.exception.MissingValueException;
+import io.jooby.exception.TypeMismatchException;
+import io.jooby.rpc.jsonrpc.JsonRpcDecoder;
+
+public class JacksonJsonRpcDecoder<T> implements JsonRpcDecoder<T> {
+
+  private final ObjectMapper mapper;
+  private final JavaType javaType;
+
+  public JacksonJsonRpcDecoder(ObjectMapper mapper, Type type) {
+    this.mapper = mapper;
+    this.javaType = mapper.constructType(type);
+  }
+
+  @Override
+  public T decode(String name, Object node) {
+    try {
+      if (node == null || ((JsonNode) node).isNull() || ((JsonNode) node).isMissingNode()) {
+        throw new MissingValueException(name);
+      }
+      return mapper.treeToValue((JsonNode) node, javaType);
+    } catch (Exception x) {
+      throw new TypeMismatchException(name, javaType, x);
+    }
+  }
+}
diff --git a/modules/jooby-jackson/src/main/java/io/jooby/internal/jackson/JacksonJsonRpcParser.java b/modules/jooby-jackson/src/main/java/io/jooby/internal/jackson/JacksonJsonRpcParser.java
new file mode 100644
index 0000000000..20558663c7
--- /dev/null
+++ b/modules/jooby-jackson/src/main/java/io/jooby/internal/jackson/JacksonJsonRpcParser.java
@@ -0,0 +1,35 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.internal.jackson;
+
+import java.lang.reflect.Type;
+
+import com.fasterxml.jackson.databind.JsonNode;
+import com.fasterxml.jackson.databind.ObjectMapper;
+import io.jooby.rpc.jsonrpc.JsonRpcDecoder;
+import io.jooby.rpc.jsonrpc.JsonRpcParser;
+import io.jooby.rpc.jsonrpc.JsonRpcReader;
+
+public class JacksonJsonRpcParser implements JsonRpcParser {
+
+  private final ObjectMapper mapper;
+
+  public JacksonJsonRpcParser(ObjectMapper mapper) {
+    this.mapper = mapper;
+  }
+
+  @Override
+  public <T> JsonRpcDecoder<T> decoder(Type type) {
+    return new JacksonJsonRpcDecoder<>(mapper, type);
+  }
+
+  @Override
+  public JsonRpcReader reader(Object params) {
+    // The JsonRpcRequestDeserializer stores the params field as a JsonNode
+    JsonNode node = (JsonNode) params;
+    return new JacksonJsonRpcReader(node);
+  }
+}
diff --git a/modules/jooby-jackson/src/main/java/io/jooby/internal/jackson/JacksonJsonRpcReader.java b/modules/jooby-jackson/src/main/java/io/jooby/internal/jackson/JacksonJsonRpcReader.java
new file mode 100644
index 0000000000..692ac4844e
--- /dev/null
+++ b/modules/jooby-jackson/src/main/java/io/jooby/internal/jackson/JacksonJsonRpcReader.java
@@ -0,0 +1,116 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.internal.jackson;
+
+import com.fasterxml.jackson.databind.JsonNode;
+import io.jooby.exception.MissingValueException;
+import io.jooby.exception.TypeMismatchException;
+import io.jooby.rpc.jsonrpc.JsonRpcDecoder;
+import io.jooby.rpc.jsonrpc.JsonRpcReader;
+
+public class JacksonJsonRpcReader implements JsonRpcReader {
+
+  private final JsonNode params;
+  private final boolean isArray;
+  private int index = 0;
+
+  public JacksonJsonRpcReader(JsonNode params) {
+    this.params = params;
+    this.isArray = params != null && params.isArray();
+  }
+
+  private JsonNode peekNode(String name) {
+    if (params == null) {
+      return null;
+    }
+    if (isArray) {
+      return params.get(index);
+    } else if (params.isObject()) {
+      return params.get(name);
+    }
+    return null;
+  }
+
+  private JsonNode consumeNode(String name) {
+    if (params == null) {
+      return null;
+    }
+    if (isArray) {
+      return params.get(index++);
+    } else if (params.isObject()) {
+      return params.get(name);
+    }
+    return null;
+  }
+
+  private JsonNode requireNode(String name) {
+    JsonNode node = consumeNode(name);
+    if (node == null || node.isNull() || node.isMissingNode()) {
+      throw new MissingValueException(name);
+    }
+    return node;
+  }
+
+  @Override
+  public boolean nextIsNull(String name) {
+    JsonNode node = peekNode(name);
+    return node == null || node.isNull();
+  }
+
+  @Override
+  public int nextInt(String name) {
+    var node = requireNode(name);
+    if (node.isNumber()) {
+      return node.intValue();
+    }
+    throw new TypeMismatchException(name, int.class);
+  }
+
+  @Override
+  public long nextLong(String name) {
+    var node = requireNode(name);
+    if (node.isNumber()) {
+      return node.longValue();
+    }
+    throw new TypeMismatchException(name, long.class);
+  }
+
+  @Override
+  public boolean nextBoolean(String name) {
+    var node = requireNode(name);
+    if (node.isBoolean()) {
+      return node.booleanValue();
+    }
+    throw new TypeMismatchException(name, boolean.class);
+  }
+
+  @Override
+  public double nextDouble(String name) {
+    var node = requireNode(name);
+    if (node.isNumber()) {
+      return node.doubleValue();
+    }
+    throw new TypeMismatchException(name, double.class);
+  }
+
+  @Override
+  public String nextString(String name) {
+    var node = requireNode(name);
+    if (node.isTextual()) {
+      return node.textValue();
+    }
+    throw new TypeMismatchException(name, String.class);
+  }
+
+  @Override
+  public <T> T nextObject(String name, JsonRpcDecoder<T> decoder) {
+    var node = requireNode(name);
+    return decoder.decode(name, node);
+  }
+
+  @Override
+  public void close() {}
+}
diff --git a/modules/jooby-jackson/src/main/java/io/jooby/internal/jackson/JacksonJsonRpcRequestDeserializer.java b/modules/jooby-jackson/src/main/java/io/jooby/internal/jackson/JacksonJsonRpcRequestDeserializer.java
new file mode 100644
index 0000000000..185a8ca117
--- /dev/null
+++ b/modules/jooby-jackson/src/main/java/io/jooby/internal/jackson/JacksonJsonRpcRequestDeserializer.java
@@ -0,0 +1,94 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.internal.jackson;
+
+import java.io.IOException;
+
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.fasterxml.jackson.databind.deser.std.StdDeserializer;
+import com.fasterxml.jackson.databind.node.ArrayNode;
+import io.jooby.rpc.jsonrpc.JsonRpcRequest;
+
+public class JacksonJsonRpcRequestDeserializer extends StdDeserializer<JsonRpcRequest> {
+
+  public JacksonJsonRpcRequestDeserializer() {
+    super(JsonRpcRequest.class);
+  }
+
+  @Override
+  public JsonRpcRequest deserialize(JsonParser p, DeserializationContext ctxt) throws IOException {
+    // Jackson 2 standard way to read the tree
+    JsonNode node = p.getCodec().readTree(p);
+
+    if (node.isArray()) {
+      var arrayNode = (ArrayNode) node;
+
+      // Spec: Empty array must return a single Invalid Request object (-32600)
+      if (arrayNode.isEmpty()) {
+        JsonRpcRequest invalid = new JsonRpcRequest();
+        invalid.setMethod(null); // Acts as a flag for Invalid Request
+        invalid.setBatch(false); // Force single return shape
+        return invalid;
+      }
+
+      JsonRpcRequest batch = new JsonRpcRequest();
+      for (JsonNode element : arrayNode) {
+        batch.add(parseSingle(element));
+      }
+      return batch;
+    } else {
+      return parseSingle(node);
+    }
+  }
+
+  private JsonRpcRequest parseSingle(JsonNode node) {
+    var req = new JsonRpcRequest();
+
+    if (!node.isObject()) {
+      req.setMethod(null);
+      return req;
+    }
+
+    // 1. Extract ID if present (crucial for error echoing)
+    JsonNode idNode = node.get("id");
+    if (idNode != null && !idNode.isNull()) {
+      if (idNode.isNumber()) {
+        req.setId(idNode.numberValue());
+      } else if (idNode.isTextual()) { // Jackson 2 uses isTextual()
+        req.setId(idNode.asText()); // Jackson 2 uses asText() instead of asString()
+      }
+    }
+
+    // 2. Validate JSON-RPC version
+    JsonNode versionNode = node.get("jsonrpc");
+    if (versionNode == null || !versionNode.isTextual() || !"2.0".equals(versionNode.asText())) {
+      req.setMethod(null); // Triggers -32600 Invalid Request
+      return req;
+    }
+
+    // 3. Extract Method
+    JsonNode methodNode = node.get("method");
+    if (methodNode != null && methodNode.isTextual()) {
+      req.setMethod(methodNode.asText());
+    } else {
+      req.setMethod(null); // Triggers -32600 Invalid Request
+    }
+
+    // 4. Extract Params (Must be an Array or an Object per spec)
+    JsonNode paramsNode = node.get("params");
+    if (paramsNode != null && !paramsNode.isNull()) {
+      if (paramsNode.isArray() || paramsNode.isObject()) {
+        req.setParams(paramsNode); // Keep as JsonNode for the Reader later
+      } else {
+        req.setMethod(null); // Primitive params are invalid -> -32600
+      }
+    }
+
+    return req;
+  }
+}
diff --git a/modules/jooby-jackson/src/main/java/io/jooby/internal/jackson/JacksonJsonRpcResponseSerializer.java b/modules/jooby-jackson/src/main/java/io/jooby/internal/jackson/JacksonJsonRpcResponseSerializer.java
new file mode 100644
index 0000000000..494e155e16
--- /dev/null
+++ b/modules/jooby-jackson/src/main/java/io/jooby/internal/jackson/JacksonJsonRpcResponseSerializer.java
@@ -0,0 +1,42 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.internal.jackson;
+
+import java.io.IOException;
+
+import com.fasterxml.jackson.core.JsonGenerator;
+import com.fasterxml.jackson.databind.SerializerProvider;
+import com.fasterxml.jackson.databind.ser.std.StdSerializer;
+import io.jooby.rpc.jsonrpc.JsonRpcResponse;
+
+public class JacksonJsonRpcResponseSerializer extends StdSerializer<JsonRpcResponse> {
+
+  public JacksonJsonRpcResponseSerializer() {
+    super(JsonRpcResponse.class);
+  }
+
+  @Override
+  public void serialize(JsonRpcResponse response, JsonGenerator gen, SerializerProvider provider)
+      throws IOException {
+    gen.writeStartObject();
+
+    gen.writeStringField("jsonrpc", "2.0");
+
+    if (response.getError() != null) {
+      gen.writeObjectField("error", response.getError());
+    } else {
+      gen.writeObjectField("result", response.getResult());
+    }
+
+    if (response.getId() == null) {
+      gen.writeNullField("id");
+    } else {
+      gen.writeObjectField("id", response.getId());
+    }
+
+    gen.writeEndObject();
+  }
+}
diff --git a/modules/jooby-jackson/src/main/java/io/jooby/jackson/JacksonProjectedSerializer.java b/modules/jooby-jackson/src/main/java/io/jooby/internal/jackson/JacksonProjectedSerializer.java
similarity index 95%
rename from modules/jooby-jackson/src/main/java/io/jooby/jackson/JacksonProjectedSerializer.java
rename to modules/jooby-jackson/src/main/java/io/jooby/internal/jackson/JacksonProjectedSerializer.java
index 13fce9d27a..ba3158877c 100644
--- a/modules/jooby-jackson/src/main/java/io/jooby/jackson/JacksonProjectedSerializer.java
+++ b/modules/jooby-jackson/src/main/java/io/jooby/internal/jackson/JacksonProjectedSerializer.java
@@ -3,7 +3,7 @@
  * Apache License Version 2.0 https://jooby.io/LICENSE.txt
  * Copyright 2014 Edgar Espina
  */
-package io.jooby.jackson;
+package io.jooby.internal.jackson;
 
 import java.io.IOException;
 import java.util.Map;
@@ -17,6 +17,7 @@
 import com.fasterxml.jackson.databind.ser.impl.SimpleFilterProvider;
 import io.jooby.Projected;
 import io.jooby.Projection;
+import io.jooby.jackson.JacksonModule;
 
 public class JacksonProjectedSerializer extends JsonSerializer<Projected> {
   private final Map<Projection<?>, ObjectWriter> writerCache = new ConcurrentHashMap<>();
diff --git a/modules/jooby-jackson/src/main/java/io/jooby/jackson/JacksonProjectionFilter.java b/modules/jooby-jackson/src/main/java/io/jooby/internal/jackson/JacksonProjectionFilter.java
similarity index 99%
rename from modules/jooby-jackson/src/main/java/io/jooby/jackson/JacksonProjectionFilter.java
rename to modules/jooby-jackson/src/main/java/io/jooby/internal/jackson/JacksonProjectionFilter.java
index f6650e4e40..4fe6d8faa9 100644
--- a/modules/jooby-jackson/src/main/java/io/jooby/jackson/JacksonProjectionFilter.java
+++ b/modules/jooby-jackson/src/main/java/io/jooby/internal/jackson/JacksonProjectionFilter.java
@@ -3,7 +3,7 @@
  * Apache License Version 2.0 https://jooby.io/LICENSE.txt
  * Copyright 2014 Edgar Espina
  */
-package io.jooby.jackson;
+package io.jooby.internal.jackson;
 
 import java.util.ArrayDeque;
 import java.util.Deque;
diff --git a/modules/jooby-jackson/src/main/java/io/jooby/internal/jackson/JacksonTrpcDecoder.java b/modules/jooby-jackson/src/main/java/io/jooby/internal/jackson/JacksonTrpcDecoder.java
new file mode 100644
index 0000000000..8cb2967ce3
--- /dev/null
+++ b/modules/jooby-jackson/src/main/java/io/jooby/internal/jackson/JacksonTrpcDecoder.java
@@ -0,0 +1,39 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.internal.jackson;
+
+import java.io.IOException;
+
+import com.fasterxml.jackson.databind.ObjectReader;
+import io.jooby.SneakyThrows;
+import io.jooby.rpc.trpc.TrpcDecoder;
+
+public class JacksonTrpcDecoder<T> implements TrpcDecoder<T> {
+
+  final ObjectReader reader;
+
+  public JacksonTrpcDecoder(ObjectReader reader) {
+    this.reader = reader;
+  }
+
+  @Override
+  public T decode(String name, byte[] payload) {
+    try {
+      return reader.readValue(payload);
+    } catch (IOException x) {
+      throw SneakyThrows.propagate(x);
+    }
+  }
+
+  @Override
+  public T decode(String name, String payload) {
+    try {
+      return reader.readValue(payload);
+    } catch (IOException x) {
+      throw SneakyThrows.propagate(x);
+    }
+  }
+}
diff --git a/modules/jooby-jackson/src/main/java/io/jooby/internal/jackson/JacksonTrpcParser.java b/modules/jooby-jackson/src/main/java/io/jooby/internal/jackson/JacksonTrpcParser.java
new file mode 100644
index 0000000000..7ed11e685b
--- /dev/null
+++ b/modules/jooby-jackson/src/main/java/io/jooby/internal/jackson/JacksonTrpcParser.java
@@ -0,0 +1,51 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.internal.jackson;
+
+import java.io.IOException;
+import java.lang.reflect.Type;
+
+import com.fasterxml.jackson.databind.DeserializationFeature;
+import com.fasterxml.jackson.databind.ObjectMapper;
+import io.jooby.SneakyThrows;
+import io.jooby.rpc.trpc.TrpcDecoder;
+import io.jooby.rpc.trpc.TrpcParser;
+import io.jooby.rpc.trpc.TrpcReader;
+
+public class JacksonTrpcParser implements TrpcParser {
+
+  private final ObjectMapper mapper;
+
+  public JacksonTrpcParser(ObjectMapper mapper) {
+    this.mapper = mapper;
+  }
+
+  @Override
+  public <T> TrpcDecoder<T> decoder(Type type) {
+    // Resolve the type exactly once at startup
+    var javaType = mapper.constructType(type);
+    var reader = mapper.readerFor(javaType).without(DeserializationFeature.FAIL_ON_TRAILING_TOKENS);
+    return new JacksonTrpcDecoder<>(reader);
+  }
+
+  @Override
+  public TrpcReader reader(byte[] payload, boolean isTuple) {
+    try {
+      return new JacksonTrpcReader(mapper.createParser(payload), isTuple);
+    } catch (IOException e) {
+      throw SneakyThrows.propagate(e);
+    }
+  }
+
+  @Override
+  public TrpcReader reader(String payload, boolean isTuple) {
+    try {
+      return new JacksonTrpcReader(mapper.createParser(payload), isTuple);
+    } catch (IOException e) {
+      throw SneakyThrows.propagate(e);
+    }
+  }
+}
diff --git a/modules/jooby-jackson/src/main/java/io/jooby/internal/jackson/JacksonTrpcReader.java b/modules/jooby-jackson/src/main/java/io/jooby/internal/jackson/JacksonTrpcReader.java
new file mode 100644
index 0000000000..e316dada21
--- /dev/null
+++ b/modules/jooby-jackson/src/main/java/io/jooby/internal/jackson/JacksonTrpcReader.java
@@ -0,0 +1,153 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.internal.jackson;
+
+import java.io.IOException;
+
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.core.JsonToken;
+import io.jooby.SneakyThrows;
+import io.jooby.exception.MissingValueException;
+import io.jooby.rpc.trpc.TrpcDecoder;
+import io.jooby.rpc.trpc.TrpcReader;
+
+public class JacksonTrpcReader implements TrpcReader {
+  private final JsonParser parser;
+  private boolean hasPeeked = false;
+  private final boolean isTuple;
+  private boolean isFirstRead = true;
+
+  public JacksonTrpcReader(JsonParser parser, boolean isTuple) {
+    this.parser = parser;
+    this.isTuple = isTuple;
+    var token = nextToken();
+    if (isTuple && token != JsonToken.START_ARRAY) {
+      throw new IllegalArgumentException("Expected tRPC tuple array");
+    }
+  }
+
+  private JsonToken nextToken() {
+    try {
+      return parser.nextToken();
+    } catch (IOException e) {
+      throw SneakyThrows.propagate(e);
+    }
+  }
+
+  @Override
+  public boolean nextIsNull(String name) {
+    if (!hasPeeked) {
+      advance(name);
+      hasPeeked = true;
+    }
+
+    if (parser.currentToken() == JsonToken.VALUE_NULL) {
+      hasPeeked = false; // Consume the null token
+      return true;
+    }
+
+    return false;
+  }
+
+  private void ensureNext(String name) {
+    if (hasPeeked) {
+      hasPeeked = false;
+      return;
+    }
+    advance(name);
+  }
+
+  private void ensureNonNull(String name) {
+    if (parser.currentToken() == JsonToken.VALUE_NULL) throw new MissingValueException(name);
+  }
+
+  private void advance(String name) {
+    // If it's a seamless raw value, we are ALREADY on the token. Do not advance.
+    if (!isTuple) {
+      if (!isFirstRead) throw new MissingValueException(name);
+      isFirstRead = false;
+      // The constructor already positioned us on the root token. Do not advance.
+      return;
+    }
+
+    var token = nextToken();
+    if (token == JsonToken.END_ARRAY || token == null) {
+      throw new MissingValueException(name);
+    }
+  }
+
+  @Override
+  public int nextInt(String name) {
+    ensureNext(name);
+    ensureNonNull(name);
+    try {
+      return parser.getIntValue();
+    } catch (IOException e) {
+      throw SneakyThrows.propagate(e);
+    }
+  }
+
+  @Override
+  public long nextLong(String name) {
+    ensureNext(name);
+    ensureNonNull(name);
+    try {
+      return parser.getLongValue();
+    } catch (IOException e) {
+      throw SneakyThrows.propagate(e);
+    }
+  }
+
+  @Override
+  public boolean nextBoolean(String name) {
+    ensureNext(name);
+    ensureNonNull(name);
+    try {
+      return parser.getBooleanValue();
+    } catch (IOException e) {
+      throw SneakyThrows.propagate(e);
+    }
+  }
+
+  @Override
+  public double nextDouble(String name) {
+    ensureNext(name);
+    ensureNonNull(name);
+    try {
+      return parser.getDoubleValue();
+    } catch (IOException e) {
+      throw SneakyThrows.propagate(e);
+    }
+  }
+
+  @Override
+  public String nextString(String name) {
+    ensureNext(name);
+    ensureNonNull(name);
+    try {
+      return parser.getText();
+    } catch (IOException e) {
+      throw SneakyThrows.propagate(e);
+    }
+  }
+
+  @Override
+  public <T> T nextObject(String name, TrpcDecoder<T> decoder) {
+    try {
+      ensureNext(name);
+      ensureNonNull(name);
+      JacksonTrpcDecoder<T> jacksonDecoder = (JacksonTrpcDecoder<T>) decoder;
+      return jacksonDecoder.reader.readValue(parser);
+    } catch (IOException e) {
+      throw SneakyThrows.propagate(e);
+    }
+  }
+
+  @Override
+  public void close() throws Exception {
+    parser.close();
+  }
+}
diff --git a/modules/jooby-jackson/src/main/java/io/jooby/internal/jackson/JacksonTrpcResponseSerializer.java b/modules/jooby-jackson/src/main/java/io/jooby/internal/jackson/JacksonTrpcResponseSerializer.java
new file mode 100644
index 0000000000..68e939da8b
--- /dev/null
+++ b/modules/jooby-jackson/src/main/java/io/jooby/internal/jackson/JacksonTrpcResponseSerializer.java
@@ -0,0 +1,38 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.internal.jackson;
+
+import java.io.IOException;
+
+import com.fasterxml.jackson.core.JsonGenerator;
+import com.fasterxml.jackson.databind.SerializerProvider;
+import com.fasterxml.jackson.databind.ser.std.StdSerializer;
+import io.jooby.rpc.trpc.TrpcResponse;
+
+public class JacksonTrpcResponseSerializer extends StdSerializer<TrpcResponse> {
+  public JacksonTrpcResponseSerializer() {
+    super(TrpcResponse.class);
+  }
+
+  @Override
+  public void serialize(TrpcResponse value, JsonGenerator gen, SerializerProvider provider)
+      throws IOException {
+    gen.writeStartObject(); // {
+
+    gen.writeFieldName("result");
+    gen.writeStartObject(); // "result": {
+
+    var data = value.data();
+    // Only write the "data" key if the method actually returned something (not void/Unit)
+    if (data != null) {
+      gen.writeFieldName("data");
+      gen.writePOJO(data);
+    }
+
+    gen.writeEndObject();
+    gen.writeEndObject();
+  }
+}
diff --git a/modules/jooby-jackson/src/main/java/io/jooby/jackson/JacksonModule.java b/modules/jooby-jackson/src/main/java/io/jooby/jackson/JacksonModule.java
index fd8e960342..5cae4e6464 100644
--- a/modules/jooby-jackson/src/main/java/io/jooby/jackson/JacksonModule.java
+++ b/modules/jooby-jackson/src/main/java/io/jooby/jackson/JacksonModule.java
@@ -5,8 +5,6 @@
  */
 package io.jooby.jackson;
 
-import static com.fasterxml.jackson.databind.ser.impl.SimpleBeanPropertyFilter.*;
-
 import java.io.InputStream;
 import java.lang.reflect.Type;
 import java.util.HashMap;
@@ -18,10 +16,9 @@
 
 import com.fasterxml.jackson.annotation.JsonFilter;
 import com.fasterxml.jackson.core.JsonParseException;
-import com.fasterxml.jackson.databind.JsonNode;
+import com.fasterxml.jackson.databind.*;
 import com.fasterxml.jackson.databind.Module;
-import com.fasterxml.jackson.databind.ObjectMapper;
-import com.fasterxml.jackson.databind.ObjectWriter;
+import com.fasterxml.jackson.databind.exc.MismatchedInputException;
 import com.fasterxml.jackson.databind.json.JsonMapper;
 import com.fasterxml.jackson.databind.module.SimpleModule;
 import com.fasterxml.jackson.databind.ser.impl.SimpleFilterProvider;
@@ -31,7 +28,14 @@
 import com.fasterxml.jackson.module.paramnames.ParameterNamesModule;
 import edu.umd.cs.findbugs.annotations.NonNull;
 import io.jooby.*;
+import io.jooby.internal.jackson.*;
 import io.jooby.output.Output;
+import io.jooby.rpc.jsonrpc.JsonRpcErrorCode;
+import io.jooby.rpc.jsonrpc.JsonRpcParser;
+import io.jooby.rpc.jsonrpc.JsonRpcRequest;
+import io.jooby.rpc.jsonrpc.JsonRpcResponse;
+import io.jooby.rpc.trpc.TrpcParser;
+import io.jooby.rpc.trpc.TrpcResponse;
 
 /**
  * JSON module using Jackson: https://jooby.io/modules/jackson2.
@@ -149,6 +153,17 @@ public void install(@NonNull Jooby application) {
 
     // Parsing exception as 400
     application.errorCode(JsonParseException.class, StatusCode.BAD_REQUEST);
+    application.errorCode(MismatchedInputException.class, StatusCode.BAD_REQUEST);
+
+    // tRPC
+    services.put(TrpcParser.class, new JacksonTrpcParser(mapper));
+
+    // JSON-RPC
+    services.put(JsonRpcParser.class, new JacksonJsonRpcParser(mapper));
+    services
+        .mapOf(Class.class, JsonRpcErrorCode.class)
+        .put(MismatchedInputException.class, JsonRpcErrorCode.INVALID_PARAMS)
+        .put(DatabindException.class, JsonRpcErrorCode.INVALID_PARAMS);
 
     // Filter
     var defaultProvider = new SimpleFilterProvider().setFailOnUnknownId(false);
@@ -213,7 +228,7 @@ public Object decode(Context ctx, Type type) throws Exception {
    * @param modules Extra/additional modules to install.
    * @return Object mapper instance.
    */
-  public static @NonNull ObjectMapper create(Module... modules) {
+  public static ObjectMapper create(Module... modules) {
     JsonMapper.Builder builder =
         JsonMapper.builder()
             .addModule(new ParameterNamesModule())
@@ -221,6 +236,12 @@ public Object decode(Context ctx, Type type) throws Exception {
             .addModule(new JavaTimeModule());
 
     Stream.of(modules).forEach(builder::addModule);
+    // RPC
+    var rpc = new SimpleModule();
+    rpc.addSerializer(TrpcResponse.class, new JacksonTrpcResponseSerializer());
+    rpc.addDeserializer(JsonRpcRequest.class, new JacksonJsonRpcRequestDeserializer());
+    rpc.addSerializer(JsonRpcResponse.class, new JacksonJsonRpcResponseSerializer());
+    builder.addModule(rpc);
 
     return builder.build();
   }
diff --git a/modules/jooby-jackson3/pom.xml b/modules/jooby-jackson3/pom.xml
index aa4e989af9..887614f0c1 100644
--- a/modules/jooby-jackson3/pom.xml
+++ b/modules/jooby-jackson3/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-jackson3</artifactId>
   <name>jooby-jackson3</name>
diff --git a/modules/jooby-jackson3/src/main/java/io/jooby/internal/jackson3/JacksonJsonRpcDecoder.java b/modules/jooby-jackson3/src/main/java/io/jooby/internal/jackson3/JacksonJsonRpcDecoder.java
new file mode 100644
index 0000000000..4f8c0d2166
--- /dev/null
+++ b/modules/jooby-jackson3/src/main/java/io/jooby/internal/jackson3/JacksonJsonRpcDecoder.java
@@ -0,0 +1,38 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.internal.jackson3;
+
+import java.lang.reflect.Type;
+
+import io.jooby.exception.MissingValueException;
+import io.jooby.exception.TypeMismatchException;
+import io.jooby.rpc.jsonrpc.JsonRpcDecoder;
+import tools.jackson.databind.JavaType;
+import tools.jackson.databind.JsonNode;
+import tools.jackson.databind.ObjectMapper;
+
+public class JacksonJsonRpcDecoder<T> implements JsonRpcDecoder<T> {
+
+  private final ObjectMapper mapper;
+  private final JavaType javaType;
+
+  public JacksonJsonRpcDecoder(ObjectMapper mapper, Type type) {
+    this.mapper = mapper;
+    this.javaType = mapper.constructType(type);
+  }
+
+  @Override
+  public T decode(String name, Object node) {
+    try {
+      if (node == null || ((JsonNode) node).isNull() || ((JsonNode) node).isMissingNode()) {
+        throw new MissingValueException(name);
+      }
+      return mapper.treeToValue((JsonNode) node, javaType);
+    } catch (Exception x) {
+      throw new TypeMismatchException(name, javaType, x);
+    }
+  }
+}
diff --git a/modules/jooby-jackson3/src/main/java/io/jooby/internal/jackson3/JacksonJsonRpcParser.java b/modules/jooby-jackson3/src/main/java/io/jooby/internal/jackson3/JacksonJsonRpcParser.java
new file mode 100644
index 0000000000..06bb7d233a
--- /dev/null
+++ b/modules/jooby-jackson3/src/main/java/io/jooby/internal/jackson3/JacksonJsonRpcParser.java
@@ -0,0 +1,35 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.internal.jackson3;
+
+import java.lang.reflect.Type;
+
+import io.jooby.rpc.jsonrpc.JsonRpcDecoder;
+import io.jooby.rpc.jsonrpc.JsonRpcParser;
+import io.jooby.rpc.jsonrpc.JsonRpcReader;
+import tools.jackson.databind.JsonNode;
+import tools.jackson.databind.ObjectMapper;
+
+public class JacksonJsonRpcParser implements JsonRpcParser {
+
+  private final ObjectMapper mapper;
+
+  public JacksonJsonRpcParser(ObjectMapper mapper) {
+    this.mapper = mapper;
+  }
+
+  @Override
+  public <T> JsonRpcDecoder<T> decoder(Type type) {
+    return new JacksonJsonRpcDecoder<>(mapper, type);
+  }
+
+  @Override
+  public JsonRpcReader reader(Object params) {
+    // The JsonRpcRequestDeserializer stores the params field as a JsonNode
+    JsonNode node = (JsonNode) params;
+    return new JacksonJsonRpcReader(node);
+  }
+}
diff --git a/modules/jooby-jackson3/src/main/java/io/jooby/internal/jackson3/JacksonJsonRpcReader.java b/modules/jooby-jackson3/src/main/java/io/jooby/internal/jackson3/JacksonJsonRpcReader.java
new file mode 100644
index 0000000000..bf1ad7e966
--- /dev/null
+++ b/modules/jooby-jackson3/src/main/java/io/jooby/internal/jackson3/JacksonJsonRpcReader.java
@@ -0,0 +1,116 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.internal.jackson3;
+
+import io.jooby.exception.MissingValueException;
+import io.jooby.exception.TypeMismatchException;
+import io.jooby.rpc.jsonrpc.JsonRpcDecoder;
+import io.jooby.rpc.jsonrpc.JsonRpcReader;
+import tools.jackson.databind.JsonNode;
+
+public class JacksonJsonRpcReader implements JsonRpcReader {
+
+  private final JsonNode params;
+  private final boolean isArray;
+  private int index = 0;
+
+  public JacksonJsonRpcReader(JsonNode params) {
+    this.params = params;
+    this.isArray = params != null && params.isArray();
+  }
+
+  private JsonNode peekNode(String name) {
+    if (params == null) {
+      return null;
+    }
+    if (isArray) {
+      return params.get(index);
+    } else if (params.isObject()) {
+      return params.get(name);
+    }
+    return null;
+  }
+
+  private JsonNode consumeNode(String name) {
+    if (params == null) {
+      return null;
+    }
+    if (isArray) {
+      return params.get(index++);
+    } else if (params.isObject()) {
+      return params.get(name);
+    }
+    return null;
+  }
+
+  private JsonNode requireNode(String name) {
+    JsonNode node = consumeNode(name);
+    if (node == null || node.isNull() || node.isMissingNode()) {
+      throw new MissingValueException(name);
+    }
+    return node;
+  }
+
+  @Override
+  public boolean nextIsNull(String name) {
+    JsonNode node = peekNode(name);
+    return node == null || node.isNull();
+  }
+
+  @Override
+  public int nextInt(String name) {
+    var node = requireNode(name);
+    if (node.isInt()) {
+      return node.asInt();
+    }
+    throw new TypeMismatchException(name, int.class);
+  }
+
+  @Override
+  public long nextLong(String name) {
+    var node = requireNode(name);
+    if (node.isLong()) {
+      return node.longValue();
+    }
+    throw new TypeMismatchException(name, long.class);
+  }
+
+  @Override
+  public boolean nextBoolean(String name) {
+    var node = requireNode(name);
+    if (node.isBoolean()) {
+      return node.booleanValue();
+    }
+    throw new TypeMismatchException(name, boolean.class);
+  }
+
+  @Override
+  public double nextDouble(String name) {
+    var node = requireNode(name);
+    if (node.isDouble()) {
+      return node.asDouble();
+    }
+    throw new TypeMismatchException(name, double.class);
+  }
+
+  @Override
+  public String nextString(String name) {
+    var node = requireNode(name);
+    if (node.isString()) {
+      return node.asString();
+    }
+    throw new TypeMismatchException(name, String.class);
+  }
+
+  @Override
+  public <T> T nextObject(String name, JsonRpcDecoder<T> decoder) {
+    var node = requireNode(name);
+    return decoder.decode(name, node);
+  }
+
+  @Override
+  public void close() {}
+}
diff --git a/modules/jooby-jackson3/src/main/java/io/jooby/internal/jackson3/JacksonJsonRpcRequestDeserializer.java b/modules/jooby-jackson3/src/main/java/io/jooby/internal/jackson3/JacksonJsonRpcRequestDeserializer.java
new file mode 100644
index 0000000000..a20eb35ad7
--- /dev/null
+++ b/modules/jooby-jackson3/src/main/java/io/jooby/internal/jackson3/JacksonJsonRpcRequestDeserializer.java
@@ -0,0 +1,91 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.internal.jackson3;
+
+import io.jooby.rpc.jsonrpc.JsonRpcRequest;
+import tools.jackson.core.JsonParser;
+import tools.jackson.databind.DeserializationContext;
+import tools.jackson.databind.JsonNode;
+import tools.jackson.databind.deser.std.StdDeserializer;
+import tools.jackson.databind.node.ArrayNode;
+
+public class JacksonJsonRpcRequestDeserializer extends StdDeserializer<JsonRpcRequest> {
+
+  public JacksonJsonRpcRequestDeserializer() {
+    super(JsonRpcRequest.class);
+  }
+
+  @Override
+  public JsonRpcRequest deserialize(JsonParser p, DeserializationContext ctxt) {
+    JsonNode node = p.readValueAsTree();
+
+    if (node.isArray()) {
+      var arrayNode = (ArrayNode) node;
+
+      // Spec: Empty array must return a single Invalid Request object (-32600)
+      if (arrayNode.isEmpty()) {
+        JsonRpcRequest invalid = new JsonRpcRequest();
+        invalid.setMethod(null); // Acts as a flag for Invalid Request
+        invalid.setBatch(false); // Force single return shape
+        return invalid;
+      }
+
+      JsonRpcRequest batch = new JsonRpcRequest();
+      for (JsonNode element : arrayNode) {
+        batch.add(parseSingle(element));
+      }
+      return batch;
+    } else {
+      return parseSingle(node);
+    }
+  }
+
+  private JsonRpcRequest parseSingle(JsonNode node) {
+    var req = new JsonRpcRequest();
+
+    if (!node.isObject()) {
+      req.setMethod(null);
+      return req;
+    }
+
+    // 1. Extract ID if present (crucial for error echoing)
+    JsonNode idNode = node.get("id");
+    if (idNode != null && !idNode.isNull()) {
+      if (idNode.isNumber()) {
+        req.setId(idNode.numberValue());
+      } else if (idNode.isString()) {
+        req.setId(idNode.asString());
+      }
+    }
+
+    // 2. Validate JSON-RPC version
+    JsonNode versionNode = node.get("jsonrpc");
+    if (versionNode == null || !versionNode.isString() || !"2.0".equals(versionNode.asString())) {
+      req.setMethod(null); // Triggers -32600 Invalid Request
+      return req;
+    }
+
+    // 3. Extract Method
+    JsonNode methodNode = node.get("method");
+    if (methodNode != null && methodNode.isString()) {
+      req.setMethod(methodNode.asString());
+    } else {
+      req.setMethod(null); // Triggers -32600 Invalid Request
+    }
+
+    // 4. Extract Params (Must be an Array or an Object per spec)
+    JsonNode paramsNode = node.get("params");
+    if (paramsNode != null && !paramsNode.isNull()) {
+      if (paramsNode.isArray() || paramsNode.isObject()) {
+        req.setParams(paramsNode); // Keep as JsonNode for the Reader later
+      } else {
+        req.setMethod(null); // Primitive params are invalid -> -32600
+      }
+    }
+
+    return req;
+  }
+}
diff --git a/modules/jooby-jackson3/src/main/java/io/jooby/internal/jackson3/JacksonJsonRpcResponseSerializer.java b/modules/jooby-jackson3/src/main/java/io/jooby/internal/jackson3/JacksonJsonRpcResponseSerializer.java
new file mode 100644
index 0000000000..45dc5b3ea4
--- /dev/null
+++ b/modules/jooby-jackson3/src/main/java/io/jooby/internal/jackson3/JacksonJsonRpcResponseSerializer.java
@@ -0,0 +1,42 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.internal.jackson3;
+
+import io.jooby.rpc.jsonrpc.JsonRpcResponse;
+import tools.jackson.core.JacksonException;
+import tools.jackson.core.JsonGenerator;
+import tools.jackson.databind.SerializationContext;
+import tools.jackson.databind.ser.std.StdSerializer;
+
+public class JacksonJsonRpcResponseSerializer extends StdSerializer<JsonRpcResponse> {
+
+  public JacksonJsonRpcResponseSerializer() {
+    super(JsonRpcResponse.class);
+  }
+
+  @Override
+  public void serialize(JsonRpcResponse response, JsonGenerator gen, SerializationContext ctxt)
+      throws JacksonException {
+    gen.writeStartObject();
+    gen.writeName("jsonrpc");
+    gen.writeString("2.0");
+
+    if (response.getError() != null) {
+      gen.writeName("error");
+      gen.writePOJO(response.getError());
+    } else {
+      gen.writeName("result");
+      gen.writePOJO(response.getResult());
+    }
+    if (response.getId() == null) {
+      gen.writeNullProperty("id");
+    } else {
+      gen.writePOJOProperty("id", response.getId());
+    }
+
+    gen.writeEndObject();
+  }
+}
diff --git a/modules/jooby-jackson3/src/main/java/io/jooby/jackson3/JacksonProjectionFilter.java b/modules/jooby-jackson3/src/main/java/io/jooby/internal/jackson3/JacksonProjectionFilter.java
similarity index 98%
rename from modules/jooby-jackson3/src/main/java/io/jooby/jackson3/JacksonProjectionFilter.java
rename to modules/jooby-jackson3/src/main/java/io/jooby/internal/jackson3/JacksonProjectionFilter.java
index ce74da8e85..d3fcd5df03 100644
--- a/modules/jooby-jackson3/src/main/java/io/jooby/jackson3/JacksonProjectionFilter.java
+++ b/modules/jooby-jackson3/src/main/java/io/jooby/internal/jackson3/JacksonProjectionFilter.java
@@ -3,7 +3,7 @@
  * Apache License Version 2.0 https://jooby.io/LICENSE.txt
  * Copyright 2014 Edgar Espina
  */
-package io.jooby.jackson3;
+package io.jooby.internal.jackson3;
 
 import java.util.ArrayList;
 import java.util.Collections;
diff --git a/modules/jooby-jackson3/src/main/java/io/jooby/internal/jackson3/JacksonTrpcDecoder.java b/modules/jooby-jackson3/src/main/java/io/jooby/internal/jackson3/JacksonTrpcDecoder.java
new file mode 100644
index 0000000000..a1d3b84210
--- /dev/null
+++ b/modules/jooby-jackson3/src/main/java/io/jooby/internal/jackson3/JacksonTrpcDecoder.java
@@ -0,0 +1,28 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.internal.jackson3;
+
+import io.jooby.rpc.trpc.TrpcDecoder;
+import tools.jackson.databind.ObjectReader;
+
+public class JacksonTrpcDecoder<T> implements TrpcDecoder<T> {
+
+  final ObjectReader reader;
+
+  public JacksonTrpcDecoder(ObjectReader reader) {
+    this.reader = reader;
+  }
+
+  @Override
+  public T decode(String name, byte[] payload) {
+    return reader.readValue(payload);
+  }
+
+  @Override
+  public T decode(String name, String payload) {
+    return reader.readValue(payload);
+  }
+}
diff --git a/modules/jooby-jackson3/src/main/java/io/jooby/internal/jackson3/JacksonTrpcParser.java b/modules/jooby-jackson3/src/main/java/io/jooby/internal/jackson3/JacksonTrpcParser.java
new file mode 100644
index 0000000000..c85ef8d977
--- /dev/null
+++ b/modules/jooby-jackson3/src/main/java/io/jooby/internal/jackson3/JacksonTrpcParser.java
@@ -0,0 +1,43 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.internal.jackson3;
+
+import java.lang.reflect.Type;
+
+import io.jooby.rpc.trpc.TrpcDecoder;
+import io.jooby.rpc.trpc.TrpcParser;
+import io.jooby.rpc.trpc.TrpcReader;
+import tools.jackson.databind.DeserializationFeature;
+import tools.jackson.databind.ObjectMapper;
+
+public class JacksonTrpcParser implements TrpcParser {
+
+  private final ObjectMapper mapper;
+
+  public JacksonTrpcParser(ObjectMapper mapper) {
+    this.mapper = mapper;
+  }
+
+  @Override
+  public <T> TrpcDecoder<T> decoder(Type type) {
+    // Resolve the type exactly once at startup
+    var javaType = mapper.constructType(type);
+    // FIX: Tell Jackson not to panic when it sees the ']' or ',' immediately following the object
+    // in the stream.
+    var reader = mapper.readerFor(javaType).without(DeserializationFeature.FAIL_ON_TRAILING_TOKENS);
+    return new JacksonTrpcDecoder<>(reader);
+  }
+
+  @Override
+  public TrpcReader reader(byte[] payload, boolean isTuple) {
+    return new JacksonTrpcReader(mapper.createParser(payload), isTuple);
+  }
+
+  @Override
+  public TrpcReader reader(String payload, boolean isTuple) {
+    return new JacksonTrpcReader(mapper.createParser(payload), isTuple);
+  }
+}
diff --git a/modules/jooby-jackson3/src/main/java/io/jooby/internal/jackson3/JacksonTrpcReader.java b/modules/jooby-jackson3/src/main/java/io/jooby/internal/jackson3/JacksonTrpcReader.java
new file mode 100644
index 0000000000..29d285876d
--- /dev/null
+++ b/modules/jooby-jackson3/src/main/java/io/jooby/internal/jackson3/JacksonTrpcReader.java
@@ -0,0 +1,118 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.internal.jackson3;
+
+import io.jooby.exception.MissingValueException;
+import io.jooby.rpc.trpc.TrpcDecoder;
+import io.jooby.rpc.trpc.TrpcReader;
+import tools.jackson.core.JsonParser;
+import tools.jackson.core.JsonToken;
+
+public class JacksonTrpcReader implements TrpcReader {
+  private final JsonParser parser;
+  private boolean hasPeeked = false;
+  private final boolean isTuple;
+  private boolean isFirstRead = true;
+
+  public JacksonTrpcReader(JsonParser parser, boolean isTuple) {
+    this.parser = parser;
+    this.isTuple = isTuple;
+    var token = parser.nextToken();
+    if (isTuple && token != tools.jackson.core.JsonToken.START_ARRAY) {
+      throw new IllegalArgumentException("Expected tRPC tuple array");
+    }
+  }
+
+  @Override
+  public boolean nextIsNull(String name) {
+    if (!hasPeeked) {
+      advance(name);
+      hasPeeked = true;
+    }
+
+    if (parser.currentToken() == JsonToken.VALUE_NULL) {
+      hasPeeked = false; // Consume the null token
+      return true;
+    }
+
+    return false;
+  }
+
+  private void ensureNext(String name) {
+    if (hasPeeked) {
+      hasPeeked = false;
+      return;
+    }
+    advance(name);
+  }
+
+  private void ensureNonNull(String name) {
+    if (parser.currentToken() == JsonToken.VALUE_NULL) throw new MissingValueException(name);
+  }
+
+  private void advance(String name) {
+    // If it's a seamless raw value, we are ALREADY on the token. Do not advance.
+    if (!isTuple) {
+      if (!isFirstRead) throw new MissingValueException(name);
+      isFirstRead = false;
+      // The constructor already positioned us on the root token. Do not advance.
+      return;
+    }
+
+    var token = parser.nextToken();
+    if (token == tools.jackson.core.JsonToken.END_ARRAY || token == null) {
+      throw new MissingValueException(name);
+    }
+  }
+
+  @Override
+  public int nextInt(String name) {
+    ensureNext(name);
+    ensureNonNull(name);
+    return parser.getIntValue();
+  }
+
+  @Override
+  public long nextLong(String name) {
+    ensureNext(name);
+    ensureNonNull(name);
+    return parser.getLongValue();
+  }
+
+  @Override
+  public boolean nextBoolean(String name) {
+    ensureNext(name);
+    ensureNonNull(name);
+    return parser.getBooleanValue();
+  }
+
+  @Override
+  public double nextDouble(String name) {
+    ensureNext(name);
+    ensureNonNull(name);
+    return parser.getDoubleValue();
+  }
+
+  @Override
+  public String nextString(String name) {
+    ensureNext(name);
+    ensureNonNull(name);
+    return parser.getString();
+  }
+
+  @Override
+  public <T> T nextObject(String name, TrpcDecoder<T> decoder) {
+    ensureNext(name);
+    ensureNonNull(name);
+    JacksonTrpcDecoder<T> jacksonDecoder = (JacksonTrpcDecoder<T>) decoder;
+    return jacksonDecoder.reader.readValue(parser);
+  }
+
+  @Override
+  public void close() {
+    parser.close();
+  }
+}
diff --git a/modules/jooby-jackson3/src/main/java/io/jooby/internal/jackson3/JacksonTrpcResponseSerializer.java b/modules/jooby-jackson3/src/main/java/io/jooby/internal/jackson3/JacksonTrpcResponseSerializer.java
new file mode 100644
index 0000000000..2676d1607c
--- /dev/null
+++ b/modules/jooby-jackson3/src/main/java/io/jooby/internal/jackson3/JacksonTrpcResponseSerializer.java
@@ -0,0 +1,37 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.internal.jackson3;
+
+import io.jooby.rpc.trpc.TrpcResponse;
+import tools.jackson.core.JacksonException;
+import tools.jackson.core.JsonGenerator;
+import tools.jackson.databind.SerializationContext;
+import tools.jackson.databind.ser.std.StdSerializer;
+
+public class JacksonTrpcResponseSerializer extends StdSerializer<TrpcResponse> {
+  public JacksonTrpcResponseSerializer() {
+    super(TrpcResponse.class);
+  }
+
+  @Override
+  public void serialize(TrpcResponse value, JsonGenerator gen, SerializationContext provider)
+      throws JacksonException {
+    gen.writeStartObject(); // {
+
+    gen.writeName("result");
+    gen.writeStartObject(); // "result": {
+
+    var data = value.data();
+    // Only write the "data" key if the method actually returned something (not void/Unit)
+    if (data != null) {
+      gen.writeName("data");
+      gen.writePOJO(data);
+    }
+
+    gen.writeEndObject();
+    gen.writeEndObject();
+  }
+}
diff --git a/modules/jooby-jackson3/src/main/java/io/jooby/jackson3/Jackson3Module.java b/modules/jooby-jackson3/src/main/java/io/jooby/jackson3/Jackson3Module.java
index 32b92b5884..d18a131c4a 100644
--- a/modules/jooby-jackson3/src/main/java/io/jooby/jackson3/Jackson3Module.java
+++ b/modules/jooby-jackson3/src/main/java/io/jooby/jackson3/Jackson3Module.java
@@ -17,13 +17,20 @@
 import com.fasterxml.jackson.annotation.JsonFilter;
 import edu.umd.cs.findbugs.annotations.NonNull;
 import io.jooby.*;
+import io.jooby.internal.jackson3.*;
 import io.jooby.output.Output;
+import io.jooby.rpc.jsonrpc.JsonRpcErrorCode;
+import io.jooby.rpc.jsonrpc.JsonRpcParser;
+import io.jooby.rpc.jsonrpc.JsonRpcRequest;
+import io.jooby.rpc.jsonrpc.JsonRpcResponse;
+import io.jooby.rpc.trpc.TrpcErrorCode;
+import io.jooby.rpc.trpc.TrpcParser;
+import io.jooby.rpc.trpc.TrpcResponse;
 import tools.jackson.core.exc.StreamReadException;
-import tools.jackson.databind.JacksonModule;
-import tools.jackson.databind.JsonNode;
-import tools.jackson.databind.ObjectMapper;
-import tools.jackson.databind.ObjectWriter;
+import tools.jackson.databind.*;
+import tools.jackson.databind.exc.MismatchedInputException;
 import tools.jackson.databind.json.JsonMapper;
+import tools.jackson.databind.module.SimpleModule;
 import tools.jackson.databind.ser.std.SimpleFilterProvider;
 import tools.jackson.databind.type.TypeFactory;
 
@@ -141,9 +148,25 @@ public void install(@NonNull Jooby application) {
     Class mapperType = mapper.getClass();
     services.put(mapperType, mapper);
     services.put(ObjectMapper.class, mapper);
+    // tRPC
+    services.put(TrpcParser.class, new JacksonTrpcParser(mapper));
+    services
+        .mapOf(Class.class, TrpcErrorCode.class)
+        .put(StreamReadException.class, TrpcErrorCode.BAD_REQUEST)
+        .put(MismatchedInputException.class, TrpcErrorCode.BAD_REQUEST)
+        .put(DatabindException.class, TrpcErrorCode.BAD_REQUEST);
+
+    // JSON-RPC
+    services.put(JsonRpcParser.class, new JacksonJsonRpcParser(mapper));
+    services
+        .mapOf(Class.class, JsonRpcErrorCode.class)
+        .put(StreamReadException.class, JsonRpcErrorCode.INVALID_PARAMS)
+        .put(MismatchedInputException.class, JsonRpcErrorCode.INVALID_PARAMS)
+        .put(DatabindException.class, JsonRpcErrorCode.INVALID_PARAMS);
 
     // Parsing exception as 400
     application.errorCode(StreamReadException.class, StatusCode.BAD_REQUEST);
+    application.errorCode(DatabindException.class, StatusCode.BAD_REQUEST);
 
     application.onStarting(() -> onStarting(application, services, mapperType));
 
@@ -217,6 +240,11 @@ public static ObjectMapper create(JacksonModule... modules) {
     JsonMapper.Builder builder = JsonMapper.builder();
 
     Stream.of(modules).forEach(builder::addModule);
+    var rpcModule = new SimpleModule();
+    rpcModule.addSerializer(TrpcResponse.class, new JacksonTrpcResponseSerializer());
+    rpcModule.addSerializer(JsonRpcResponse.class, new JacksonJsonRpcResponseSerializer());
+    rpcModule.addDeserializer(JsonRpcRequest.class, new JacksonJsonRpcRequestDeserializer());
+    builder.addModule(rpcModule);
 
     return builder.build();
   }
diff --git a/modules/jooby-jackson3/src/test/java/io/jooby/jackson3/Jackson3JsonModuleTest.java b/modules/jooby-jackson3/src/test/java/io/jooby/jackson3/Jackson3JsonModuleTest.java
index d54ad90ae0..db3bc6132a 100644
--- a/modules/jooby-jackson3/src/test/java/io/jooby/jackson3/Jackson3JsonModuleTest.java
+++ b/modules/jooby-jackson3/src/test/java/io/jooby/jackson3/Jackson3JsonModuleTest.java
@@ -16,13 +16,13 @@
 
 import org.junit.jupiter.api.Test;
 
-import tools.jackson.databind.ObjectMapper;
-import tools.jackson.dataformat.xml.XmlMapper;
 import io.jooby.Body;
 import io.jooby.Context;
 import io.jooby.MediaType;
 import io.jooby.output.OutputFactory;
 import io.jooby.output.OutputOptions;
+import tools.jackson.databind.ObjectMapper;
+import tools.jackson.dataformat.xml.XmlMapper;
 
 public class Jackson3JsonModuleTest {
 
diff --git a/modules/jooby-jasypt/pom.xml b/modules/jooby-jasypt/pom.xml
index da4fd2dacc..cbcdd849b3 100644
--- a/modules/jooby-jasypt/pom.xml
+++ b/modules/jooby-jasypt/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-jasypt</artifactId>
   <name>jooby-jasypt</name>
diff --git a/modules/jooby-jdbi/pom.xml b/modules/jooby-jdbi/pom.xml
index 39dd6522f7..0fe7fba813 100644
--- a/modules/jooby-jdbi/pom.xml
+++ b/modules/jooby-jdbi/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-jdbi</artifactId>
   <name>jooby-jdbi</name>
diff --git a/modules/jooby-jetty/pom.xml b/modules/jooby-jetty/pom.xml
index f0026fa07f..2c7f112278 100644
--- a/modules/jooby-jetty/pom.xml
+++ b/modules/jooby-jetty/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-jetty</artifactId>
   <name>jooby-jetty</name>
diff --git a/modules/jooby-jetty/src/main/java/io/jooby/internal/jetty/JettyGrpcExchange.java b/modules/jooby-jetty/src/main/java/io/jooby/internal/jetty/JettyGrpcExchange.java
new file mode 100644
index 0000000000..4259a20a37
--- /dev/null
+++ b/modules/jooby-jetty/src/main/java/io/jooby/internal/jetty/JettyGrpcExchange.java
@@ -0,0 +1,100 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.internal.jetty;
+
+import java.nio.ByteBuffer;
+import java.util.HashMap;
+import java.util.Map;
+import java.util.function.Consumer;
+
+import org.eclipse.jetty.http.HttpFields;
+import org.eclipse.jetty.server.Request;
+import org.eclipse.jetty.server.Response;
+import org.eclipse.jetty.util.Callback;
+
+import io.jooby.rpc.grpc.GrpcExchange;
+
+public class JettyGrpcExchange implements GrpcExchange {
+
+  private final Request request;
+  private final Response response;
+  private final Callback jettyCallback;
+  private boolean headersSent = false;
+
+  // Create a mutable trailers object that Jetty will pull from at the end of the stream
+  private final HttpFields.Mutable trailers = HttpFields.build();
+
+  public JettyGrpcExchange(Request request, Response response, Callback jettyCallback) {
+    this.request = request;
+    this.response = response;
+    this.jettyCallback = jettyCallback;
+
+    response.getHeaders().put("Content-Type", "application/grpc");
+
+    // Register the supplier BEFORE the response commits
+    response.setTrailersSupplier(() -> trailers);
+  }
+
+  @Override
+  public String getRequestPath() {
+    return request.getHttpURI().getPath();
+  }
+
+  @Override
+  public String getHeader(String name) {
+    return request.getHeaders().get(name);
+  }
+
+  @Override
+  public Map<String, String> getHeaders() {
+    Map<String, String> map = new HashMap<>();
+    for (var field : request.getHeaders()) {
+      map.put(field.getName(), field.getValue());
+    }
+    return map;
+  }
+
+  @Override
+  public void send(ByteBuffer payload, Consumer<Throwable> callback) {
+    headersSent = true;
+
+    response.write(
+        false,
+        payload,
+        new Callback() {
+          @Override
+          public void succeeded() {
+            callback.accept(null);
+          }
+
+          @Override
+          public void failed(Throwable x) {
+            callback.accept(x);
+          }
+        });
+  }
+
+  @Override
+  public void close(int statusCode, String description) {
+    if (headersSent) {
+      // Trailers-Appended: Data was sent, populate the mutable trailers object
+      trailers.add("grpc-status", String.valueOf(statusCode));
+      if (description != null) {
+        trailers.add("grpc-message", description);
+      }
+
+      // Complete stream. Jetty will automatically read from the supplier we registered earlier.
+      response.write(true, ByteBuffer.allocate(0), jettyCallback);
+    } else {
+      // Trailers-Only: No data was sent, trailers become standard HTTP headers.
+      response.getHeaders().put("grpc-status", String.valueOf(statusCode));
+      if (description != null) {
+        response.getHeaders().put("grpc-message", description);
+      }
+      response.write(true, ByteBuffer.allocate(0), jettyCallback);
+    }
+  }
+}
diff --git a/modules/jooby-jetty/src/main/java/io/jooby/internal/jetty/JettyGrpcHandler.java b/modules/jooby-jetty/src/main/java/io/jooby/internal/jetty/JettyGrpcHandler.java
new file mode 100644
index 0000000000..d25acc587f
--- /dev/null
+++ b/modules/jooby-jetty/src/main/java/io/jooby/internal/jetty/JettyGrpcHandler.java
@@ -0,0 +1,51 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.internal.jetty;
+
+import org.eclipse.jetty.server.Handler;
+import org.eclipse.jetty.server.Request;
+import org.eclipse.jetty.server.Response;
+import org.eclipse.jetty.util.Callback;
+
+import io.jooby.rpc.grpc.GrpcProcessor;
+
+public class JettyGrpcHandler extends Handler.Wrapper {
+
+  private final GrpcProcessor processor;
+
+  public JettyGrpcHandler(Handler next, GrpcProcessor processor) {
+    this.processor = processor;
+    setHandler(next);
+  }
+
+  @Override
+  public boolean handle(Request request, Response response, Callback callback) throws Exception {
+    var contentType = request.getHeaders().get("Content-Type");
+
+    if (processor.isGrpcMethod(request.getHttpURI().getPath())
+        && contentType != null
+        && contentType.startsWith("application/grpc")) {
+
+      if (!"HTTP/2.0".equals(request.getConnectionMetaData().getProtocol())) {
+        response.setStatus(426); // Upgrade Required
+        response.getHeaders().put("Connection", "Upgrade");
+        response.getHeaders().put("Upgrade", "h2c");
+        callback.succeeded();
+        return true;
+      }
+
+      var exchange = new JettyGrpcExchange(request, response, callback);
+      var subscriber = processor.process(exchange);
+
+      new JettyGrpcInputBridge(request, subscriber, callback).start();
+
+      return true;
+    }
+
+    // not grpc, move next
+    return super.handle(request, response, callback);
+  }
+}
diff --git a/modules/jooby-jetty/src/main/java/io/jooby/internal/jetty/JettyGrpcInputBridge.java b/modules/jooby-jetty/src/main/java/io/jooby/internal/jetty/JettyGrpcInputBridge.java
new file mode 100644
index 0000000000..a78101553a
--- /dev/null
+++ b/modules/jooby-jetty/src/main/java/io/jooby/internal/jetty/JettyGrpcInputBridge.java
@@ -0,0 +1,91 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.internal.jetty;
+
+import java.nio.ByteBuffer;
+import java.util.concurrent.CancellationException;
+import java.util.concurrent.Flow;
+import java.util.concurrent.atomic.AtomicLong;
+
+import org.eclipse.jetty.server.Request;
+import org.eclipse.jetty.util.Callback;
+
+public class JettyGrpcInputBridge implements Flow.Subscription, Runnable {
+
+  private final Request request;
+  private final Flow.Subscriber<ByteBuffer> subscriber;
+  private final Callback callback;
+  private final AtomicLong demand = new AtomicLong();
+
+  public JettyGrpcInputBridge(
+      Request request, Flow.Subscriber<ByteBuffer> subscriber, Callback callback) {
+    this.request = request;
+    this.subscriber = subscriber;
+    this.callback = callback;
+  }
+
+  public void start() {
+    subscriber.onSubscribe(this);
+  }
+
+  @Override
+  public void request(long n) {
+    if (n <= 0) {
+      subscriber.onError(new IllegalArgumentException("Demand must be positive"));
+      return;
+    }
+
+    if (demand.getAndAdd(n) == 0) {
+      run();
+    }
+  }
+
+  @Override
+  public void cancel() {
+    demand.set(0);
+    callback.failed(new CancellationException("gRPC stream cancelled by client"));
+  }
+
+  @Override
+  public void run() {
+    try {
+      while (demand.get() > 0) {
+        var chunk = request.read();
+
+        if (chunk == null) {
+          request.demand(this);
+          return;
+        }
+
+        try {
+          var failure = chunk.getFailure();
+          if (failure != null) {
+            subscriber.onError(failure);
+            callback.failed(failure);
+            return;
+          }
+
+          var buffer = chunk.getByteBuffer();
+          if (buffer != null && buffer.hasRemaining()) {
+            subscriber.onNext(buffer);
+            demand.decrementAndGet();
+          }
+
+          if (chunk.isLast()) {
+            subscriber.onComplete();
+            return;
+          }
+
+        } finally {
+          chunk.release();
+        }
+      }
+    } catch (Throwable t) {
+      subscriber.onError(t);
+      callback.failed(t);
+    }
+  }
+}
diff --git a/modules/jooby-jetty/src/main/java/io/jooby/internal/jetty/http2/JettyHttp2Configurer.java b/modules/jooby-jetty/src/main/java/io/jooby/internal/jetty/http2/JettyHttp2Configurer.java
index ab3b8d50cc..1a1d03d459 100644
--- a/modules/jooby-jetty/src/main/java/io/jooby/internal/jetty/http2/JettyHttp2Configurer.java
+++ b/modules/jooby-jetty/src/main/java/io/jooby/internal/jetty/http2/JettyHttp2Configurer.java
@@ -5,8 +5,6 @@
  */
 package io.jooby.internal.jetty.http2;
 
-import java.util.Arrays;
-import java.util.Collections;
 import java.util.List;
 
 import org.eclipse.jetty.alpn.server.ALPNServerConnectionFactory;
@@ -25,13 +23,23 @@ public class JettyHttp2Configurer {
   public List<ConnectionFactory> configure(HttpConfiguration input) {
     if (input.getCustomizer(SecureRequestCustomizer.class) != null) {
       ALPNServerConnectionFactory alpn = new ALPNServerConnectionFactory(H2, H2_17, HTTP_1_1);
-      alpn.setDefaultProtocol(HTTP_1_1);
+      alpn.setDefaultProtocol(H2);
 
-      HTTP2ServerConnectionFactory https2 = new HTTP2ServerConnectionFactory(input);
+      HTTP2ServerConnectionFactory h2 = new HTTP2ServerConnectionFactory(input);
+      h2.setInitialStreamRecvWindow(1024 * 1024);
+      h2.setInitialSessionRecvWindow(10 * 1024 * 1024);
 
-      return Arrays.asList(alpn, https2);
+      // FIX: Set Max Concurrent Streams higher if you have many bidi clients
+      h2.setMaxConcurrentStreams(1000);
+      return List.of(alpn, h2);
     } else {
-      return Collections.singletonList(new HTTP2CServerConnectionFactory(input));
+      var h2c = new HTTP2CServerConnectionFactory(input);
+      h2c.setInitialStreamRecvWindow(1024 * 1024);
+      h2c.setInitialSessionRecvWindow(10 * 1024 * 1024);
+
+      // FIX: Set Max Concurrent Streams higher if you have many bidi clients
+      h2c.setMaxConcurrentStreams(1000);
+      return List.of(h2c);
     }
   }
 }
diff --git a/modules/jooby-jetty/src/main/java/io/jooby/jetty/JettyServer.java b/modules/jooby-jetty/src/main/java/io/jooby/jetty/JettyServer.java
index 6188177e03..4a55a9b6ab 100644
--- a/modules/jooby-jetty/src/main/java/io/jooby/jetty/JettyServer.java
+++ b/modules/jooby-jetty/src/main/java/io/jooby/jetty/JettyServer.java
@@ -32,11 +32,10 @@
 import edu.umd.cs.findbugs.annotations.NonNull;
 import io.jooby.*;
 import io.jooby.exception.StartupException;
-import io.jooby.internal.jetty.JettyHandler;
-import io.jooby.internal.jetty.JettyHttpExpectAndContinueHandler;
-import io.jooby.internal.jetty.PrefixHandler;
+import io.jooby.internal.jetty.*;
 import io.jooby.internal.jetty.http2.JettyHttp2Configurer;
 import io.jooby.output.OutputFactory;
+import io.jooby.rpc.grpc.GrpcProcessor;
 
 /**
  * Web server implementation using <a href="https://www.eclipse.org/jetty/">Jetty</a>.
@@ -303,12 +302,17 @@ private List<Map.Entry<String, Handler>> createHandler(
               if (options.isExpectContinue() == Boolean.TRUE) {
                 handler = new JettyHttpExpectAndContinueHandler(handler);
               }
+              GrpcProcessor grpcProcessor =
+                  application.getServices().getOrNull(GrpcProcessor.class);
+              if (grpcProcessor != null) {
+                handler = new JettyGrpcHandler(handler, grpcProcessor);
+              }
               return Map.entry(application.getContextPath(), handler);
             })
         .toList();
   }
 
-  @NonNull @Override
+  @Override
   public List<String> getLoggerOff() {
     return List.of(
         "org.eclipse.jetty.server.Server",
diff --git a/modules/jooby-jetty/src/main/java/module-info.java b/modules/jooby-jetty/src/main/java/module-info.java
index e10ff88cd1..8b1a6e495b 100644
--- a/modules/jooby-jetty/src/main/java/module-info.java
+++ b/modules/jooby-jetty/src/main/java/module-info.java
@@ -18,6 +18,7 @@
   requires org.eclipse.jetty.http2.server;
   requires org.eclipse.jetty.websocket.server;
   requires java.desktop;
+  requires org.eclipse.jetty.http;
 
   provides Server with
       JettyServer;
diff --git a/modules/jooby-jstachio/pom.xml b/modules/jooby-jstachio/pom.xml
index a964fb17ff..fbe1f92ede 100644
--- a/modules/jooby-jstachio/pom.xml
+++ b/modules/jooby-jstachio/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-jstachio</artifactId>
   <name>jooby-jstachio</name>
diff --git a/modules/jooby-jte/pom.xml b/modules/jooby-jte/pom.xml
index 48aa7ccfa2..837d924392 100644
--- a/modules/jooby-jte/pom.xml
+++ b/modules/jooby-jte/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-jte</artifactId>
   <name>jooby-jte</name>
diff --git a/modules/jooby-jwt/pom.xml b/modules/jooby-jwt/pom.xml
index f678afdc39..600fdd5741 100644
--- a/modules/jooby-jwt/pom.xml
+++ b/modules/jooby-jwt/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-jwt</artifactId>
   <name>jooby-jwt</name>
diff --git a/modules/jooby-kafka/pom.xml b/modules/jooby-kafka/pom.xml
index eab93e6182..1f72329637 100644
--- a/modules/jooby-kafka/pom.xml
+++ b/modules/jooby-kafka/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-kafka</artifactId>
   <name>jooby-kafka</name>
diff --git a/modules/jooby-kotlin/pom.xml b/modules/jooby-kotlin/pom.xml
index 24a195024a..c902a922f8 100644
--- a/modules/jooby-kotlin/pom.xml
+++ b/modules/jooby-kotlin/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-kotlin</artifactId>
   <name>jooby-kotlin</name>
diff --git a/modules/jooby-langchain4j/pom.xml b/modules/jooby-langchain4j/pom.xml
new file mode 100644
index 0000000000..74f093246b
--- /dev/null
+++ b/modules/jooby-langchain4j/pom.xml
@@ -0,0 +1,82 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
+
+  <modelVersion>4.0.0</modelVersion>
+
+  <parent>
+    <groupId>io.jooby</groupId>
+    <artifactId>modules</artifactId>
+    <version>4.1.0</version>
+  </parent>
+  <artifactId>jooby-langchain4j</artifactId>
+  <name>jooby-langchain4j</name>
+
+  <dependencies>
+    <dependency>
+      <groupId>io.jooby</groupId>
+      <artifactId>jooby</artifactId>
+      <version>${jooby.version}</version>
+    </dependency>
+
+    <dependency>
+      <groupId>dev.langchain4j</groupId>
+      <artifactId>langchain4j-core</artifactId>
+    </dependency>
+
+    <dependency>
+      <groupId>dev.langchain4j</groupId>
+      <artifactId>langchain4j-open-ai</artifactId>
+      <optional>true</optional>
+    </dependency>
+
+    <dependency>
+      <groupId>dev.langchain4j</groupId>
+      <artifactId>langchain4j-anthropic</artifactId>
+      <optional>true</optional>
+    </dependency>
+
+    <dependency>
+      <groupId>dev.langchain4j</groupId>
+      <artifactId>langchain4j-ollama</artifactId>
+      <optional>true</optional>
+    </dependency>
+
+    <dependency>
+      <groupId>dev.langchain4j</groupId>
+      <artifactId>langchain4j-jlama</artifactId>
+      <optional>true</optional>
+    </dependency>
+
+    <!-- Test dependencies -->
+    <dependency>
+      <groupId>org.junit.jupiter</groupId>
+      <artifactId>junit-jupiter-engine</artifactId>
+      <scope>test</scope>
+    </dependency>
+
+    <dependency>
+      <groupId>org.mockito</groupId>
+      <artifactId>mockito-core</artifactId>
+      <scope>test</scope>
+    </dependency>
+
+    <dependency>
+      <groupId>org.jacoco</groupId>
+      <artifactId>org.jacoco.agent</artifactId>
+      <classifier>runtime</classifier>
+      <scope>test</scope>
+    </dependency>
+  </dependencies>
+
+  <dependencyManagement>
+    <dependencies>
+      <dependency>
+        <groupId>dev.langchain4j</groupId>
+        <artifactId>langchain4j-bom</artifactId>
+        <version>1.12.2</version>
+        <type>pom</type>
+        <scope>import</scope>
+      </dependency>
+    </dependencies>
+  </dependencyManagement>
+</project>
diff --git a/modules/jooby-langchain4j/src/main/java/io/jooby/internal/langchain4j/BuiltInModel.java b/modules/jooby-langchain4j/src/main/java/io/jooby/internal/langchain4j/BuiltInModel.java
new file mode 100644
index 0000000000..a144e41942
--- /dev/null
+++ b/modules/jooby-langchain4j/src/main/java/io/jooby/internal/langchain4j/BuiltInModel.java
@@ -0,0 +1,177 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.internal.langchain4j;
+
+import java.time.Duration;
+
+import com.typesafe.config.Config;
+import dev.langchain4j.model.anthropic.AnthropicChatModel;
+import dev.langchain4j.model.anthropic.AnthropicStreamingChatModel;
+import dev.langchain4j.model.chat.ChatModel;
+import dev.langchain4j.model.chat.StreamingChatModel;
+import dev.langchain4j.model.jlama.JlamaChatModel;
+import dev.langchain4j.model.jlama.JlamaStreamingChatModel;
+import dev.langchain4j.model.ollama.OllamaChatModel;
+import dev.langchain4j.model.ollama.OllamaStreamingChatModel;
+import dev.langchain4j.model.openai.OpenAiChatModel;
+import dev.langchain4j.model.openai.OpenAiStreamingChatModel;
+import edu.umd.cs.findbugs.annotations.NonNull;
+import io.jooby.langchain4j.ChatModelFactory;
+
+/**
+ * Enumeration of built-in LangChain4j model providers supported by the Jooby extension. Each
+ * constant implements {@link ChatModelFactory} to provide provider-specific instantiation logic.
+ */
+public enum BuiltInModel implements ChatModelFactory {
+  OPENAI {
+    @Override
+    public ChatModel createChatModel(@NonNull Config config) {
+      check("dev.langchain4j.model.openai.OpenAiChatModel", "langchain4j-open-ai");
+      return OpenAiChatModel.builder()
+          .apiKey(config.getString("api-key"))
+          .modelName(config.hasPath("model-name") ? config.getString("model-name") : "gpt-4o-mini")
+          .timeout(getTimeout(config, Duration.ofSeconds(60)))
+          .temperature(getTemp(config))
+          .build();
+    }
+
+    @Override
+    public StreamingChatModel createStreamingModel(@NonNull Config config) {
+      return OpenAiStreamingChatModel.builder()
+          .apiKey(config.getString("api-key"))
+          .modelName(config.hasPath("model-name") ? config.getString("model-name") : "gpt-4o-mini")
+          .timeout(getStreamTimeout(config))
+          .temperature(getTemp(config))
+          .build();
+    }
+  },
+
+  ANTHROPIC {
+    @Override
+    public ChatModel createChatModel(@NonNull Config config) {
+      check("dev.langchain4j.model.anthropic.AnthropicChatModel", "langchain4j-anthropic");
+      return AnthropicChatModel.builder()
+          .apiKey(config.getString("api-key"))
+          .modelName(
+              config.hasPath("model-name")
+                  ? config.getString("model-name")
+                  : "claude-3-5-sonnet-latest")
+          .timeout(getTimeout(config, Duration.ofSeconds(60)))
+          .temperature(getTemp(config))
+          .build();
+    }
+
+    @Override
+    public StreamingChatModel createStreamingModel(@NonNull Config config) {
+      return AnthropicStreamingChatModel.builder()
+          .apiKey(config.getString("api-key"))
+          .modelName(
+              config.hasPath("model-name")
+                  ? config.getString("model-name")
+                  : "claude-3-5-sonnet-latest")
+          .timeout(getStreamTimeout(config))
+          .temperature(getTemp(config))
+          .build();
+    }
+  },
+
+  OLLAMA {
+    @Override
+    public ChatModel createChatModel(@NonNull Config config) {
+      check("dev.langchain4j.model.ollama.OllamaChatModel", "langchain4j-ollama");
+      return OllamaChatModel.builder()
+          .baseUrl(config.getString("base-url"))
+          .modelName(config.getString("model-name"))
+          .timeout(getTimeout(config, Duration.ofSeconds(60)))
+          .build();
+    }
+
+    @Override
+    public StreamingChatModel createStreamingModel(@NonNull Config config) {
+      return OllamaStreamingChatModel.builder()
+          .baseUrl(config.getString("base-url"))
+          .modelName(config.getString("model-name"))
+          .timeout(getStreamTimeout(config))
+          .build();
+    }
+  },
+
+  JLAMA {
+    @Override
+    public ChatModel createChatModel(@NonNull Config config) {
+      check("dev.langchain4j.model.jlama.JlamaChatModel", "langchain4j-jlama");
+      return JlamaChatModel.builder()
+          .modelName(config.getString("model-name"))
+          .workingDirectory(getOrCreateWorkingDir(config))
+          .build();
+    }
+
+    @Override
+    public StreamingChatModel createStreamingModel(@NonNull Config config) {
+      return JlamaStreamingChatModel.builder()
+          .modelName(config.getString("model-name"))
+          .workingDirectory(getOrCreateWorkingDir(config))
+          .build();
+    }
+  };
+
+  /**
+   * Resolves a built-in provider by name.
+   *
+   * @param name The provider name (e.g. "openai").
+   * @return The corresponding enum constant.
+   * @throws IllegalArgumentException if provider is unknown.
+   */
+  public static BuiltInModel resolve(String name) {
+    try {
+      return valueOf(name.toUpperCase());
+    } catch (IllegalArgumentException e) {
+      throw new IllegalArgumentException("Unsupported LangChain4j provider: " + name);
+    }
+  }
+
+  // --- Helper Methods for Enum Implementation ---
+
+  protected void check(String className, String artifact) {
+    try {
+      Class.forName(className);
+    } catch (ClassNotFoundException e) {
+      throw new IllegalStateException(
+          "Provider dependency missing. Add 'dev.langchain4j:" + artifact + "' to your project.");
+    }
+  }
+
+  protected Duration getTimeout(Config config, Duration defaultValue) {
+    return config.hasPath("timeout") ? config.getDuration("timeout") : defaultValue;
+  }
+
+  protected Duration getStreamTimeout(Config config) {
+    return config.hasPath("streaming-timeout")
+        ? config.getDuration("streaming-timeout")
+        : Duration.ofSeconds(10);
+  }
+
+  protected double getTemp(Config config) {
+    return config.hasPath("temperature") ? config.getDouble("temperature") : 0.7;
+  }
+
+  protected java.nio.file.Path getOrCreateWorkingDir(Config config) {
+    java.nio.file.Path path =
+        config.hasPath("working-dir")
+            ? java.nio.file.Paths.get(config.getString("working-dir"))
+            : java.nio.file.Paths.get(System.getProperty("user.dir"), "models");
+
+    try {
+      // Jlama explicitly requires the directory to exist before booting
+      if (!java.nio.file.Files.exists(path)) {
+        java.nio.file.Files.createDirectories(path);
+      }
+      return path;
+    } catch (java.io.IOException e) {
+      throw new IllegalStateException("Failed to create a working directory at: " + path, e);
+    }
+  }
+}
diff --git a/modules/jooby-langchain4j/src/main/java/io/jooby/internal/langchain4j/FallbackChatModel.java b/modules/jooby-langchain4j/src/main/java/io/jooby/internal/langchain4j/FallbackChatModel.java
new file mode 100644
index 0000000000..b036b5e280
--- /dev/null
+++ b/modules/jooby-langchain4j/src/main/java/io/jooby/internal/langchain4j/FallbackChatModel.java
@@ -0,0 +1,40 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.internal.langchain4j;
+
+import dev.langchain4j.model.chat.ChatModel;
+import dev.langchain4j.model.chat.request.ChatRequest;
+import dev.langchain4j.model.chat.response.ChatResponse;
+import io.jooby.langchain4j.FailoverListener;
+
+/**
+ * Decorator for {@link ChatModel} that provides failover logic. Catching exceptions from the
+ * primary model and routing to a fallback instance.
+ */
+public class FallbackChatModel implements ChatModel {
+  private final String name;
+  private final ChatModel primary;
+  private final ChatModel fallback;
+  private final FailoverListener listener;
+
+  public FallbackChatModel(
+      String name, ChatModel primary, ChatModel fallback, FailoverListener listener) {
+    this.name = name;
+    this.primary = primary;
+    this.fallback = fallback;
+    this.listener = listener;
+  }
+
+  @Override
+  public ChatResponse chat(ChatRequest request) {
+    try {
+      return primary.chat(request);
+    } catch (Exception e) {
+      listener.onFailover(name, e);
+      return fallback.chat(request);
+    }
+  }
+}
diff --git a/modules/jooby-langchain4j/src/main/java/io/jooby/internal/langchain4j/FallbackStreamingChatModel.java b/modules/jooby-langchain4j/src/main/java/io/jooby/internal/langchain4j/FallbackStreamingChatModel.java
new file mode 100644
index 0000000000..aae7191f6b
--- /dev/null
+++ b/modules/jooby-langchain4j/src/main/java/io/jooby/internal/langchain4j/FallbackStreamingChatModel.java
@@ -0,0 +1,64 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.internal.langchain4j;
+
+import dev.langchain4j.model.chat.StreamingChatModel;
+import dev.langchain4j.model.chat.request.ChatRequest;
+import dev.langchain4j.model.chat.response.StreamingChatResponseHandler;
+import io.jooby.langchain4j.FailoverListener;
+
+/**
+ * Decorator for {@link StreamingChatModel} handling asynchronous failover. Fallback triggers only
+ * if the error occurs before the first token is received.
+ */
+public class FallbackStreamingChatModel implements StreamingChatModel {
+  private final String name;
+  private final StreamingChatModel primary;
+  private final StreamingChatModel fallback;
+  private final FailoverListener fallbackListener;
+
+  public FallbackStreamingChatModel(
+      String name,
+      StreamingChatModel primary,
+      StreamingChatModel fallback,
+      FailoverListener fallbackListener) {
+    this.name = name;
+    this.primary = primary;
+    this.fallback = fallback;
+    this.fallbackListener = fallbackListener;
+  }
+
+  @Override
+  public void chat(ChatRequest request, StreamingChatResponseHandler handler) {
+    primary.chat(
+        request,
+        new StreamingChatResponseHandler() {
+          private boolean started = false;
+
+          @Override
+          public void onPartialResponse(String token) {
+            started = true;
+            handler.onPartialResponse(token);
+          }
+
+          @Override
+          public void onCompleteResponse(
+              dev.langchain4j.model.chat.response.ChatResponse response) {
+            handler.onCompleteResponse(response);
+          }
+
+          @Override
+          public void onError(Throwable error) {
+            if (!started) {
+              fallbackListener.onFailover(name, error);
+              fallback.chat(request, handler);
+            } else {
+              handler.onError(error);
+            }
+          }
+        });
+  }
+}
diff --git a/modules/jooby-langchain4j/src/main/java/io/jooby/langchain4j/ChatModelFactory.java b/modules/jooby-langchain4j/src/main/java/io/jooby/langchain4j/ChatModelFactory.java
new file mode 100644
index 0000000000..ed9cffad65
--- /dev/null
+++ b/modules/jooby-langchain4j/src/main/java/io/jooby/langchain4j/ChatModelFactory.java
@@ -0,0 +1,41 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.langchain4j;
+
+import com.typesafe.config.Config;
+import dev.langchain4j.model.chat.ChatModel;
+import dev.langchain4j.model.chat.StreamingChatModel;
+import edu.umd.cs.findbugs.annotations.NonNull;
+import edu.umd.cs.findbugs.annotations.Nullable;
+
+/**
+ * Factory contract for creating LangChain4j chat models from Jooby configuration. Implementations
+ * map {@link Config} keys to specific model builder methods.
+ *
+ * @author edgar
+ * @since 1.0.0
+ */
+public interface ChatModelFactory {
+
+  /**
+   * Creates a blocking chat model.
+   *
+   * @param config The configuration block for this model.
+   * @return A non-null instance of a {@link ChatModel}.
+   */
+  ChatModel createChatModel(@NonNull Config config);
+
+  /**
+   * Creates a streaming chat model. Returns {@code null} if the provider does not support
+   * streaming.
+   *
+   * @param config The configuration block for this model.
+   * @return A {@link StreamingChatModel} or {@code null}.
+   */
+  @Nullable default StreamingChatModel createStreamingModel(@NonNull Config config) {
+    return null;
+  }
+}
diff --git a/modules/jooby-langchain4j/src/main/java/io/jooby/langchain4j/FailoverListener.java b/modules/jooby-langchain4j/src/main/java/io/jooby/langchain4j/FailoverListener.java
new file mode 100644
index 0000000000..aab388f2e8
--- /dev/null
+++ b/modules/jooby-langchain4j/src/main/java/io/jooby/langchain4j/FailoverListener.java
@@ -0,0 +1,18 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.langchain4j;
+
+/** Listener for failover events in a model chain. */
+@FunctionalInterface
+public interface FailoverListener {
+  /**
+   * Called when a primary model fails and the system switches to a fallback.
+   *
+   * @param modelName The name of the model that failed.
+   * @param error The exception that triggered the fallback.
+   */
+  void onFailover(String modelName, Throwable error);
+}
diff --git a/modules/jooby-langchain4j/src/main/java/io/jooby/langchain4j/LangChain4jModule.java b/modules/jooby-langchain4j/src/main/java/io/jooby/langchain4j/LangChain4jModule.java
new file mode 100644
index 0000000000..c72d869f20
--- /dev/null
+++ b/modules/jooby-langchain4j/src/main/java/io/jooby/langchain4j/LangChain4jModule.java
@@ -0,0 +1,214 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.langchain4j;
+
+import java.util.*;
+
+import org.slf4j.LoggerFactory;
+
+import dev.langchain4j.model.chat.ChatModel;
+import dev.langchain4j.model.chat.StreamingChatModel;
+import io.jooby.Extension;
+import io.jooby.Jooby;
+import io.jooby.ServiceKey;
+import io.jooby.internal.langchain4j.BuiltInModel;
+import io.jooby.internal.langchain4j.FallbackChatModel;
+import io.jooby.internal.langchain4j.FallbackStreamingChatModel;
+
+/**
+ * Jooby Extension for LangChain4j.
+ *
+ * <p>This module provides seamless integration between Jooby and the LangChain4j 1.x ecosystem,
+ * automatically instantiating and registering {@link dev.langchain4j.model.chat.ChatModel} and
+ * {@link dev.langchain4j.model.chat.StreamingChatModel} components based on your application
+ * configuration.
+ *
+ * <h3>Installation</h3>
+ *
+ * <p>Install the module inside your Jooby application:
+ *
+ * <pre>{@code
+ * {
+ *   install(new LangChain4jModule());
+ *   get("/chat", ctx -> {
+ *     ChatModel ai = require(ChatModel.class);
+ *     return ai.chat("Hello world!");
+ *   });
+ *   }
+ * }</pre>
+ *
+ * <h3>Configuration</h3>
+ *
+ * <p>Models are defined in your {@code application.conf} under the {@code langchain4j.models} key.
+ * The module automatically creates both blocking and streaming interfaces if the provider supports
+ * them.
+ *
+ * <pre>{@code
+ * langchain4j {
+ *   models {
+ *   # The name of the registered service will be "gpt-assistant"
+ *     gpt-assistant {
+ *       provider = "openai"
+ *       api-key = ${OPENAI_API_KEY}
+ *       model-name = "gpt-4o-mini"
+ *       timeout = 30s
+ *       temperature = 0.7
+ *    }
+ *   }
+ * }
+ * }</pre>
+ *
+ * <h3>Resilience & Fallback Routing</h3>
+ *
+ * <p>You can define a chain of fallbacks to ensure high availability. If the primary model fails
+ * (e.g., due to rate limits or network timeouts), the module automatically and silently routes the
+ * request to the next configured fallback.
+ *
+ * <pre>{@code
+ * langchain4j.models {
+ *   primary-agent {
+ *     provider = "openai"
+ *     api-key = "..."
+ *     fallback = ["local-failover"]
+ *   }
+ *   local-failover {
+ *     provider = "jlama"
+ *     model-name = "tjake/Llama-3.2-1B-Instruct-JQ4"
+ *   }
+ * }
+ * }</pre>
+ *
+ * <p>To track when these failovers occur, attach a listener during module installation:
+ *
+ * <pre>{@code
+ * install(new LangChain4jModule()
+ *   .failoverListener((modelName, error) -> {
+ *     log.warn("Model {} failed, switching to fallback. Reason: {}", modelName, error.getMessage());
+ *    })
+ * );
+ * }</pre>
+ *
+ * <h3>Custom Providers</h3>
+ *
+ * <p>The extension includes built-in support for popular providers like OpenAI, Anthropic, Ollama,
+ * and Jlama. To add support for an unlisted provider (e.g., Google Vertex AI), register a custom
+ * {@link io.jooby.langchain4j.ChatModelFactory}:
+ *
+ * <pre>{@code
+ * install(new LangChain4jModule()
+ *   .register("vertex", new ChatModelFactory() {
+ *     @Override
+ *     public ChatModel createChatModel(Config config) {
+ *       return VertexAiGeminiChatModel.builder()
+ *          .project(config.getString("project"))
+ *          .location(config.getString("location"))
+ *          .build();
+ *     }
+ *   }));
+ * }</pre>
+ *
+ * <h3>Dependency Management</h3>
+ *
+ * <p>To keep your application lightweight, the heavy provider SDKs (like {@code
+ * langchain4j-open-ai} or {@code langchain4j-jlama}) are marked as <strong>optional</strong>. You
+ * must explicitly add the dependencies for the specific providers you intend to use to your
+ * project's {@code pom.xml} or {@code build.gradle}.
+ *
+ * @author edgar
+ * @since 4.1.0
+ */
+public class LangChain4jModule implements Extension {
+  private FailoverListener failoverListener;
+  private final Map<String, ChatModelFactory> factories = new HashMap<>();
+
+  /**
+   * Registers a custom provider factory.
+   *
+   * @param provider The provider name (e.g., "vertex").
+   * @param factory The factory implementation.
+   * @return This module.
+   */
+  public LangChain4jModule register(String provider, ChatModelFactory factory) {
+    factories.put(provider.toLowerCase(), factory);
+    return this;
+  }
+
+  /**
+   * Listener for failover events in a model chain. Called when a primary model fails and the system
+   * switches to a fallback.
+   *
+   * @param failoverListener Failover listener.
+   * @return This module.
+   */
+  public LangChain4jModule failoverListener(FailoverListener failoverListener) {
+    this.failoverListener = failoverListener;
+    return this;
+  }
+
+  @SuppressWarnings({"rawtypes", "unchecked"})
+  @Override
+  public void install(Jooby app) {
+    var config = app.getConfig();
+
+    if (!config.hasPath("langchain4j.models")) {
+      throw new IllegalStateException(
+          "LangChain4j module installed, but no models found in configuration. Please define at"
+              + " least one model under the 'langchain4j.models' key in your application.conf");
+    }
+
+    var modelsConfig = config.getConfig("langchain4j.models");
+    Map<String, ChatModel> blockingMap = new HashMap<>();
+    Map<String, StreamingChatModel> streamingMap = new HashMap<>();
+
+    if (failoverListener == null) {
+      failoverListener =
+          (name, error) -> {
+            LoggerFactory.getLogger(getClass())
+                .error("execution of '{}' resulted in exception", name, error);
+          };
+    }
+
+    // 1. Creation
+    for (var name : modelsConfig.root().keySet()) {
+      var mConf = modelsConfig.getConfig(name);
+      var provider = mConf.getString("provider").toLowerCase();
+      var f =
+          factories.containsKey(provider)
+              ? factories.get(provider)
+              : BuiltInModel.resolve(provider);
+
+      blockingMap.put(name, f.createChatModel(mConf));
+      streamingMap.put(name, f.createStreamingModel(mConf));
+    }
+
+    var services = app.getServices();
+    // 2. Chaining & Registration
+    for (var name : modelsConfig.root().keySet()) {
+      var mConf = modelsConfig.getConfig(name);
+      var b = blockingMap.get(name);
+      var s = streamingMap.get(name);
+
+      if (mConf.hasPath("fallback")) {
+        for (var fbName : mConf.getStringList("fallback")) {
+          b = new FallbackChatModel(name, b, blockingMap.get(fbName), failoverListener);
+          if (s != null)
+            s = new FallbackStreamingChatModel(name, s, streamingMap.get(fbName), failoverListener);
+        }
+      }
+
+      services.put(ServiceKey.key(ChatModel.class, name), b);
+      if (s != null) services.put(ServiceKey.key(StreamingChatModel.class, name), s);
+
+      // Set defaults
+      services.putIfAbsent(ChatModel.class, b);
+      services.putIfAbsent((Class) b.getClass(), b);
+      if (s != null) {
+        services.putIfAbsent(StreamingChatModel.class, s);
+        services.putIfAbsent((Class) s.getClass(), s);
+      }
+    }
+  }
+}
diff --git a/modules/jooby-langchain4j/src/main/java/io/jooby/langchain4j/package-info.java b/modules/jooby-langchain4j/src/main/java/io/jooby/langchain4j/package-info.java
new file mode 100644
index 0000000000..48d5c35797
--- /dev/null
+++ b/modules/jooby-langchain4j/src/main/java/io/jooby/langchain4j/package-info.java
@@ -0,0 +1,104 @@
+/**
+ * Jooby Extension for LangChain4j.
+ *
+ * <p>This module provides seamless integration between Jooby and the LangChain4j 1.x ecosystem,
+ * automatically instantiating and registering {@link dev.langchain4j.model.chat.ChatModel} and
+ * {@link dev.langchain4j.model.chat.StreamingChatModel} components based on your application
+ * configuration.
+ *
+ * <h3>Installation</h3>
+ *
+ * <p>Install the module inside your Jooby application:
+ *
+ * <pre>{@code
+ * {
+ *   install(new LangChain4jModule());
+ *   get("/chat", ctx -> {
+ *     ChatModel ai = require(ChatModel.class);
+ *     return ai.chat("Hello world!");
+ *   });
+ *   }
+ * }</pre>
+ *
+ * <h3>Configuration</h3>
+ *
+ * <p>Models are defined in your {@code application.conf} under the {@code langchain4j.models} key.
+ * The module automatically creates both blocking and streaming interfaces if the provider supports
+ * them.
+ *
+ * <pre>{@code
+ * langchain4j {
+ *   models {
+ *   # The name of the registered service will be "gpt-assistant"
+ *     gpt-assistant {
+ *       provider = "openai"
+ *       api-key = ${OPENAI_API_KEY}
+ *       model-name = "gpt-4o-mini"
+ *       timeout = 30s
+ *       temperature = 0.7
+ *    }
+ *   }
+ * }
+ * }</pre>
+ *
+ * <h3>Resilience & Fallback Routing</h3>
+ *
+ * <p>You can define a chain of fallbacks to ensure high availability. If the primary model fails
+ * (e.g., due to rate limits or network timeouts), the module automatically and silently routes the
+ * request to the next configured fallback.
+ *
+ * <pre>{@code
+ * langchain4j.models {
+ *   primary-agent {
+ *     provider = "openai"
+ *     api-key = "..."
+ *     fallback = ["local-failover"]
+ *   }
+ *   local-failover {
+ *     provider = "jlama"
+ *     model-name = "tjake/Llama-3.2-1B-Instruct-JQ4"
+ *   }
+ * }
+ * }</pre>
+ *
+ * <p>To track when these failovers occur, attach a listener during module installation:
+ *
+ * <pre>{@code
+ * install(new LangChain4jModule()
+ *   .failoverListener((modelName, error) -> {
+ *     log.warn("Model {} failed, switching to fallback. Reason: {}", modelName, error.getMessage());
+ *    })
+ * );
+ * }</pre>
+ *
+ * <h3>Custom Providers</h3>
+ *
+ * <p>The extension includes built-in support for popular providers like OpenAI, Anthropic, Ollama,
+ * and Jlama. To add support for an unlisted provider (e.g., Google Vertex AI), register a custom
+ * {@link io.jooby.langchain4j.ChatModelFactory}:
+ *
+ * <pre>{@code
+ * install(new LangChain4jModule()
+ *   .register("vertex", new ChatModelFactory() {
+ *     @Override
+ *     public ChatModel createChatModel(Config config) {
+ *       return VertexAiGeminiChatModel.builder()
+ *          .project(config.getString("project"))
+ *          .location(config.getString("location"))
+ *          .build();
+ *     }
+ *   }));
+ * }</pre>
+ *
+ * <h3>Dependency Management</h3>
+ *
+ * <p>To keep your application lightweight, the heavy provider SDKs (like {@code
+ * langchain4j-open-ai} or {@code langchain4j-jlama}) are marked as <strong>optional</strong>. You
+ * must explicitly add the dependencies for the specific providers you intend to use to your
+ * project's {@code pom.xml} or {@code build.gradle}.
+ *
+ * @author edgar
+ * @since 4.1.0
+ */
+@edu.umd.cs.findbugs.annotations.ReturnValuesAreNonnullByDefault
+package io.jooby.langchain4j;
diff --git a/modules/jooby-langchain4j/src/main/java/module-info.java b/modules/jooby-langchain4j/src/main/java/module-info.java
new file mode 100644
index 0000000000..96e341145e
--- /dev/null
+++ b/modules/jooby-langchain4j/src/main/java/module-info.java
@@ -0,0 +1,15 @@
+module io.jooby.langchain4j {
+  exports io.jooby.langchain4j;
+
+  requires io.jooby;
+  requires static com.github.spotbugs.annotations;
+  requires org.slf4j;
+  requires typesafe.config;
+  requires langchain4j.core;
+
+  // Optional provider modules
+  requires static langchain4j.open.ai;
+  requires static langchain4j.anthropic;
+  requires static langchain4j.ollama;
+  requires static langchain4j.jlama;
+}
diff --git a/modules/jooby-langchain4j/src/test/java/io/jooby/internal/langchain4j/BuiltInModelTest.java b/modules/jooby-langchain4j/src/test/java/io/jooby/internal/langchain4j/BuiltInModelTest.java
new file mode 100644
index 0000000000..5b42ae28d9
--- /dev/null
+++ b/modules/jooby-langchain4j/src/test/java/io/jooby/internal/langchain4j/BuiltInModelTest.java
@@ -0,0 +1,68 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.internal.langchain4j;
+
+import static org.junit.jupiter.api.Assertions.*;
+
+import java.util.Map;
+
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Test;
+
+import com.typesafe.config.Config;
+import com.typesafe.config.ConfigFactory;
+
+class BuiltInModelTest {
+
+  @Test
+  @DisplayName("Should resolve enum ignoring case")
+  void resolveEnum() {
+    assertEquals(BuiltInModel.OPENAI, BuiltInModel.resolve("openai"));
+    assertEquals(BuiltInModel.ANTHROPIC, BuiltInModel.resolve("Anthropic"));
+    assertEquals(BuiltInModel.OLLAMA, BuiltInModel.resolve("OLLAMA"));
+    assertEquals(BuiltInModel.JLAMA, BuiltInModel.resolve("jLama"));
+  }
+
+  @Test
+  @DisplayName("Should throw exception for unknown provider")
+  void resolveUnknown() {
+    IllegalArgumentException exception =
+        assertThrows(
+            IllegalArgumentException.class,
+            () -> {
+              BuiltInModel.resolve("vertex");
+            });
+    assertTrue(exception.getMessage().contains("Unsupported LangChain4j provider"));
+  }
+
+  @Test
+  @DisplayName("Should parse timeout and temp values using internal helpers")
+  void testConfigurationHelpers() {
+    Config config = ConfigFactory.parseMap(Map.of("timeout", "15s", "temperature", 0.5));
+
+    // Access helper methods via an enum instance
+    BuiltInModel tester = BuiltInModel.OPENAI;
+
+    assertEquals(15, tester.getTimeout(config, null).getSeconds());
+    assertEquals(0.5, tester.getTemp(config));
+  }
+
+  @Test
+  @DisplayName("Missing dependency check should throw IllegalStateException")
+  void missingDependencyCheck() {
+    BuiltInModel tester = BuiltInModel.OPENAI;
+
+    IllegalStateException exception =
+        assertThrows(
+            IllegalStateException.class,
+            () -> {
+              // Intentionally passing a garbage class name to force the ClassNotFoundException
+              tester.check("dev.langchain4j.fake.MissingClass", "langchain4j-fake");
+            });
+
+    assertTrue(exception.getMessage().contains("Provider dependency missing"));
+  }
+}
diff --git a/modules/jooby-langchain4j/src/test/java/io/jooby/internal/langchain4j/FallbackChatModelTest.java b/modules/jooby-langchain4j/src/test/java/io/jooby/internal/langchain4j/FallbackChatModelTest.java
new file mode 100644
index 0000000000..8f2fb27a4c
--- /dev/null
+++ b/modules/jooby-langchain4j/src/test/java/io/jooby/internal/langchain4j/FallbackChatModelTest.java
@@ -0,0 +1,88 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.internal.langchain4j;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertThrows;
+import static org.mockito.Mockito.*;
+
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Test;
+
+import dev.langchain4j.data.message.UserMessage;
+import dev.langchain4j.model.chat.ChatModel;
+import dev.langchain4j.model.chat.request.ChatRequest;
+import dev.langchain4j.model.chat.response.ChatResponse;
+import io.jooby.langchain4j.FailoverListener;
+
+class FallbackChatModelTest {
+
+  private ChatRequest createValidRequest() {
+    return ChatRequest.builder().messages(UserMessage.from("Hello")).build();
+  }
+
+  @Test
+  @DisplayName("Should return primary response when primary succeeds")
+  void primarySucceeds() {
+    ChatModel primary = mock(ChatModel.class);
+    ChatModel fallback = mock(ChatModel.class);
+    FailoverListener listener = mock(FailoverListener.class);
+    ChatRequest request = createValidRequest();
+
+    // Mock the response to bypass builder validation
+    ChatResponse response = mock(ChatResponse.class);
+
+    when(primary.chat(request)).thenReturn(response);
+
+    FallbackChatModel model = new FallbackChatModel("test-model", primary, fallback, listener);
+    ChatResponse result = model.chat(request);
+
+    assertEquals(response, result);
+    verify(primary).chat(request);
+    verifyNoInteractions(fallback);
+    verifyNoInteractions(listener);
+  }
+
+  @Test
+  @DisplayName("Should trigger listener and use fallback when primary fails")
+  void primaryFailsFallbackSucceeds() {
+    ChatModel primary = mock(ChatModel.class);
+    ChatModel fallback = mock(ChatModel.class);
+    FailoverListener listener = mock(FailoverListener.class);
+    ChatRequest request = createValidRequest();
+
+    // Mock the response to bypass builder validation
+    ChatResponse fallbackResponse = mock(ChatResponse.class);
+    RuntimeException apiError = new RuntimeException("API Rate Limit");
+
+    when(primary.chat(request)).thenThrow(apiError);
+    when(fallback.chat(request)).thenReturn(fallbackResponse);
+
+    FallbackChatModel model = new FallbackChatModel("test-model", primary, fallback, listener);
+    ChatResponse result = model.chat(request);
+
+    assertEquals(fallbackResponse, result);
+    verify(listener).onFailover("test-model", apiError);
+    verify(fallback).chat(request);
+  }
+
+  @Test
+  @DisplayName("Should throw exception if both primary and fallback fail")
+  void bothFail() {
+    ChatModel primary = mock(ChatModel.class);
+    ChatModel fallback = mock(ChatModel.class);
+    FailoverListener listener = mock(FailoverListener.class);
+    ChatRequest request = createValidRequest();
+
+    when(primary.chat(request)).thenThrow(new RuntimeException("Primary Down"));
+    when(fallback.chat(request)).thenThrow(new RuntimeException("Fallback Down"));
+
+    FallbackChatModel model = new FallbackChatModel("test-model", primary, fallback, listener);
+
+    assertThrows(RuntimeException.class, () -> model.chat(request));
+    verify(listener).onFailover(eq("test-model"), any(RuntimeException.class));
+  }
+}
diff --git a/modules/jooby-langchain4j/src/test/java/io/jooby/internal/langchain4j/FallbackStreamingChatModelTest.java b/modules/jooby-langchain4j/src/test/java/io/jooby/internal/langchain4j/FallbackStreamingChatModelTest.java
new file mode 100644
index 0000000000..efa7647aeb
--- /dev/null
+++ b/modules/jooby-langchain4j/src/test/java/io/jooby/internal/langchain4j/FallbackStreamingChatModelTest.java
@@ -0,0 +1,112 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.internal.langchain4j;
+
+import static org.mockito.Mockito.*;
+
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Test;
+
+import dev.langchain4j.data.message.UserMessage;
+import dev.langchain4j.model.chat.StreamingChatModel;
+import dev.langchain4j.model.chat.request.ChatRequest;
+import dev.langchain4j.model.chat.response.ChatResponse;
+import dev.langchain4j.model.chat.response.StreamingChatResponseHandler;
+import io.jooby.langchain4j.FailoverListener;
+
+class FallbackStreamingChatModelTest {
+
+  private ChatRequest createValidRequest() {
+    return ChatRequest.builder().messages(UserMessage.from("Hello")).build();
+  }
+
+  @Test
+  @DisplayName("Should trigger fallback if primary fails before first token")
+  void failsBeforeTokens() {
+    StreamingChatModel primary = mock(StreamingChatModel.class);
+    StreamingChatModel fallback = mock(StreamingChatModel.class);
+    FailoverListener listener = mock(FailoverListener.class);
+    StreamingChatResponseHandler originalHandler = mock(StreamingChatResponseHandler.class);
+    ChatRequest request = createValidRequest();
+
+    doAnswer(
+            invocation -> {
+              StreamingChatResponseHandler internalHandler = invocation.getArgument(1);
+              internalHandler.onError(new RuntimeException("Connection Timeout"));
+              return null;
+            })
+        .when(primary)
+        .chat(eq(request), any());
+
+    FallbackStreamingChatModel model =
+        new FallbackStreamingChatModel("stream-ai", primary, fallback, listener);
+    model.chat(request, originalHandler);
+
+    verify(listener).onFailover(eq("stream-ai"), any(RuntimeException.class));
+    verify(fallback).chat(eq(request), eq(originalHandler));
+    verify(originalHandler, never()).onError(any());
+  }
+
+  @Test
+  @DisplayName("Should NOT trigger fallback if primary fails mid-stream")
+  void failsMidStream() {
+    StreamingChatModel primary = mock(StreamingChatModel.class);
+    StreamingChatModel fallback = mock(StreamingChatModel.class);
+    FailoverListener listener = mock(FailoverListener.class);
+    StreamingChatResponseHandler originalHandler = mock(StreamingChatResponseHandler.class);
+    ChatRequest request = createValidRequest();
+
+    doAnswer(
+            invocation -> {
+              StreamingChatResponseHandler internalHandler = invocation.getArgument(1);
+              internalHandler.onPartialResponse("Hello");
+              internalHandler.onError(new RuntimeException("Connection Dropped"));
+              return null;
+            })
+        .when(primary)
+        .chat(eq(request), any());
+
+    FallbackStreamingChatModel model =
+        new FallbackStreamingChatModel("stream-ai", primary, fallback, listener);
+    model.chat(request, originalHandler);
+
+    verify(originalHandler).onPartialResponse("Hello");
+    verifyNoInteractions(listener);
+    verifyNoInteractions(fallback);
+    verify(originalHandler).onError(any(RuntimeException.class));
+  }
+
+  @Test
+  @DisplayName("Should pass successful completion down to original handler")
+  void successfulCompletion() {
+    StreamingChatModel primary = mock(StreamingChatModel.class);
+    StreamingChatModel fallback = mock(StreamingChatModel.class);
+    FailoverListener listener = mock(FailoverListener.class);
+    StreamingChatResponseHandler originalHandler = mock(StreamingChatResponseHandler.class);
+    ChatRequest request = createValidRequest();
+
+    // Mock the response to bypass builder validation
+    ChatResponse completeResponse = mock(ChatResponse.class);
+
+    doAnswer(
+            invocation -> {
+              StreamingChatResponseHandler internalHandler = invocation.getArgument(1);
+              internalHandler.onPartialResponse("Done");
+              internalHandler.onCompleteResponse(completeResponse);
+              return null;
+            })
+        .when(primary)
+        .chat(eq(request), any());
+
+    FallbackStreamingChatModel model =
+        new FallbackStreamingChatModel("stream-ai", primary, fallback, listener);
+    model.chat(request, originalHandler);
+
+    verify(originalHandler).onPartialResponse("Done");
+    verify(originalHandler).onCompleteResponse(completeResponse);
+    verifyNoInteractions(fallback);
+  }
+}
diff --git a/modules/jooby-langchain4j/src/test/java/io/jooby/langchain4j/LangChain4jModuleTest.java b/modules/jooby-langchain4j/src/test/java/io/jooby/langchain4j/LangChain4jModuleTest.java
new file mode 100644
index 0000000000..16cb1120ca
--- /dev/null
+++ b/modules/jooby-langchain4j/src/test/java/io/jooby/langchain4j/LangChain4jModuleTest.java
@@ -0,0 +1,111 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.langchain4j;
+
+import static org.junit.jupiter.api.Assertions.*;
+import static org.mockito.Mockito.*;
+
+import java.util.Map;
+
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Test;
+
+import com.typesafe.config.Config;
+import com.typesafe.config.ConfigFactory;
+import dev.langchain4j.model.chat.ChatModel;
+import dev.langchain4j.model.chat.StreamingChatModel;
+import edu.umd.cs.findbugs.annotations.NonNull;
+import io.jooby.Environment;
+import io.jooby.Jooby;
+import io.jooby.ServiceKey;
+import io.jooby.ServiceRegistry;
+import io.jooby.internal.langchain4j.FallbackChatModel;
+
+class LangChain4jModuleTest {
+
+  @Test
+  @DisplayName("Should parse config and register custom factory models")
+  void customFactoryRegistration() {
+    var app =
+        createApp(
+            ConfigFactory.parseMap(
+                Map.of(
+                    "langchain4j.models.my-agent.provider", "custom",
+                    "langchain4j.models.my-agent.api-key", "secret")));
+
+    ChatModelFactory mockFactory = mock(ChatModelFactory.class);
+    ChatModel mockChatModel = mock(ChatModel.class);
+    StreamingChatModel mockStreamModel = mock(StreamingChatModel.class);
+
+    when(mockFactory.createChatModel(any())).thenReturn(mockChatModel);
+    when(mockFactory.createStreamingModel(any())).thenReturn(mockStreamModel);
+
+    LangChain4jModule module = new LangChain4jModule().register("custom", mockFactory);
+
+    module.install(app);
+
+    ServiceRegistry services = app.getServices();
+
+    // Check specific named registration
+    assertEquals(mockChatModel, services.get(ChatModel.class));
+    assertEquals(mockStreamModel, services.get(StreamingChatModel.class));
+
+    // Check default (unnamed) registration since it's the first/only model
+    assertEquals(mockChatModel, services.get(ChatModel.class));
+    assertEquals(mockStreamModel, services.get(StreamingChatModel.class));
+  }
+
+  @NonNull private static Jooby createApp(Config config) {
+    var app = new Jooby();
+    var environment = mock(Environment.class);
+    when(environment.getConfig()).thenReturn(config);
+    app.setEnvironment(environment);
+    return app;
+  }
+
+  @Test
+  @DisplayName("Should wrap models in Fallback decorators when configured")
+  void fallbackChainingRegistration() {
+    Jooby app =
+        createApp(
+            ConfigFactory.parseMap(
+                Map.of(
+                    "langchain4j.models.primary.provider", "custom",
+                    "langchain4j.models.primary.fallback", java.util.List.of("secondary"),
+                    "langchain4j.models.secondary.provider", "custom")));
+
+    ChatModelFactory mockFactory = mock(ChatModelFactory.class);
+    when(mockFactory.createChatModel(any())).thenReturn(mock(ChatModel.class));
+
+    LangChain4jModule module = new LangChain4jModule().register("custom", mockFactory);
+    module.install(app);
+
+    ServiceRegistry services = app.getServices();
+    ChatModel primaryModel = services.get(ServiceKey.key(ChatModel.class, "primary"));
+    ChatModel secondaryModel = services.get(ServiceKey.key(ChatModel.class, "secondary"));
+
+    // The secondary should be standard, but the primary should be wrapped in the decorator
+    assertFalse(secondaryModel instanceof FallbackChatModel);
+    assertInstanceOf(FallbackChatModel.class, primaryModel);
+  }
+
+  @Test
+  @DisplayName("Should fail fast if langchain4j.models configuration is missing")
+  void missingConfigurationFailsFast() {
+    Jooby app = createApp(ConfigFactory.empty());
+
+    LangChain4jModule module = new LangChain4jModule();
+
+    IllegalStateException exception =
+        assertThrows(
+            IllegalStateException.class,
+            () -> {
+              module.install(app);
+            });
+
+    assertTrue(exception.getMessage().contains("no models found in configuration"));
+  }
+}
diff --git a/modules/jooby-log4j/pom.xml b/modules/jooby-log4j/pom.xml
index 4d8d916f5a..a6833cec32 100644
--- a/modules/jooby-log4j/pom.xml
+++ b/modules/jooby-log4j/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-log4j</artifactId>
   <name>jooby-log4j</name>
diff --git a/modules/jooby-logback/pom.xml b/modules/jooby-logback/pom.xml
index b82e84ed39..4d18572faa 100644
--- a/modules/jooby-logback/pom.xml
+++ b/modules/jooby-logback/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-logback</artifactId>
   <name>jooby-logback</name>
diff --git a/modules/jooby-maven-plugin/pom.xml b/modules/jooby-maven-plugin/pom.xml
index 41844833ae..a49b2197d8 100644
--- a/modules/jooby-maven-plugin/pom.xml
+++ b/modules/jooby-maven-plugin/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-maven-plugin</artifactId>
   <name>jooby-maven-plugin</name>
@@ -29,6 +29,12 @@
       <version>${jooby.version}</version>
     </dependency>
 
+    <dependency>
+      <groupId>io.jooby</groupId>
+      <artifactId>jooby-trpc</artifactId>
+      <version>${jooby.version}</version>
+    </dependency>
+
     <dependency>
       <groupId>org.apache.maven</groupId>
       <artifactId>maven-plugin-api</artifactId>
diff --git a/modules/jooby-maven-plugin/src/main/java/io/jooby/maven/TrpcMojo.java b/modules/jooby-maven-plugin/src/main/java/io/jooby/maven/TrpcMojo.java
new file mode 100644
index 0000000000..bd767ff292
--- /dev/null
+++ b/modules/jooby-maven-plugin/src/main/java/io/jooby/maven/TrpcMojo.java
@@ -0,0 +1,143 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.maven;
+
+import static org.apache.maven.plugins.annotations.LifecyclePhase.PROCESS_CLASSES;
+import static org.apache.maven.plugins.annotations.ResolutionScope.COMPILE_PLUS_RUNTIME;
+
+import java.io.File;
+import java.util.List;
+import java.util.Map;
+
+import org.apache.maven.plugins.annotations.Mojo;
+import org.apache.maven.plugins.annotations.Parameter;
+import org.apache.maven.project.MavenProject;
+
+import cz.habarta.typescript.generator.DateMapping;
+import cz.habarta.typescript.generator.EnumMapping;
+import cz.habarta.typescript.generator.JsonLibrary;
+import edu.umd.cs.findbugs.annotations.NonNull;
+import io.jooby.trpc.TrpcGenerator;
+
+/**
+ * Generate a tRpc script file from a jooby application.
+ *
+ * <p>Usage: https://jooby.io/modules/trpc
+ *
+ * @author edgar
+ * @since 4.0.17
+ */
+@Mojo(
+    name = "tRPC",
+    threadSafe = true,
+    requiresDependencyResolution = COMPILE_PLUS_RUNTIME,
+    aggregator = true,
+    defaultPhase = PROCESS_CLASSES)
+public class TrpcMojo extends BaseMojo {
+
+  /** Custom mapping overrides translating Java types to raw TypeScript strings. */
+  @Parameter private Map<String, String> customTypeMappings;
+
+  @Parameter private Map<String, String> customTypeNaming;
+
+  /** The target JSON library used to parse field annotations. Defaults to jackson2. */
+  @Parameter(defaultValue = "jackson2", property = "jooby.trpc.jsonLibrary")
+  private JsonLibrary jsonLibrary = JsonLibrary.jackson2;
+
+  @Parameter(defaultValue = "asString", property = "jooby.trpc.mapDate")
+  private DateMapping mapDate = DateMapping.asString;
+
+  @Parameter(defaultValue = "asInlineUnion", property = "jooby.trpc.mapEnum")
+  private EnumMapping mapEnum = EnumMapping.asInlineUnion;
+
+  @Parameter(defaultValue = "${project.build.outputDirectory}", property = "jooby.trpc.outputDir")
+  private File outputDir;
+
+  @Parameter(defaultValue = "trpc.d.ts", property = "jooby.trpc.outputFile")
+  private String outputFile;
+
+  @Parameter private List<String> importDeclarations;
+
+  @Override
+  protected void doExecute(@NonNull List<MavenProject> projects, @NonNull String mainClass)
+      throws Exception {
+    var classLoader = createClassLoader(projects);
+
+    var generator = new TrpcGenerator();
+    generator.setClassLoader(classLoader);
+    generator.setOutputDir(outputDir.toPath());
+    generator.setOutputFile(outputFile);
+
+    if (customTypeMappings != null) {
+      generator.setCustomTypeMappings(customTypeMappings);
+    }
+    generator.setJsonLibrary(jsonLibrary);
+    generator.setMapDate(mapDate);
+    generator.setMapEnum(mapEnum);
+    if (importDeclarations != null) {
+      generator.setImportDeclarations(importDeclarations);
+    }
+    if (customTypeNaming != null) {
+      generator.setCustomTypeNaming(customTypeNaming);
+    }
+
+    getLog().info("Generating: " + outputDir.toPath().resolve(outputFile));
+
+    generator.generate();
+  }
+
+  public String getOutputFile() {
+    return outputFile;
+  }
+
+  public void setOutputFile(String outputFile) {
+    this.outputFile = outputFile;
+  }
+
+  public File getOutputDir() {
+    return outputDir;
+  }
+
+  public void setOutputDir(File outputDir) {
+    this.outputDir = outputDir;
+  }
+
+  public Map<String, String> getCustomTypeMappings() {
+    return customTypeMappings;
+  }
+
+  public void setCustomTypeMappings(Map<String, String> customTypeMappings) {
+    this.customTypeMappings = customTypeMappings;
+  }
+
+  public Map<String, String> getCustomTypeNaming() {
+    return customTypeNaming;
+  }
+
+  public void setCustomTypeNaming(Map<String, String> customTypeNaming) {
+    this.customTypeNaming = customTypeNaming;
+  }
+
+  public JsonLibrary getJsonLibrary() {
+    return jsonLibrary;
+  }
+
+  public DateMapping getMapDate() {
+    return mapDate;
+  }
+
+  public EnumMapping getMapEnum() {
+    return mapEnum;
+  }
+
+  public List<String> getImportDeclarations() {
+    return importDeclarations;
+  }
+
+  public void setImportDeclarations(List<String> importDeclarations) {
+    this.importDeclarations = importDeclarations;
+  }
+}
diff --git a/modules/jooby-metrics/pom.xml b/modules/jooby-metrics/pom.xml
index 49def3c1b3..551589b3e8 100644
--- a/modules/jooby-metrics/pom.xml
+++ b/modules/jooby-metrics/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-metrics</artifactId>
   <name>jooby-metrics</name>
diff --git a/modules/jooby-mutiny/pom.xml b/modules/jooby-mutiny/pom.xml
index 8395662b4c..9681543dc7 100644
--- a/modules/jooby-mutiny/pom.xml
+++ b/modules/jooby-mutiny/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-mutiny</artifactId>
   <name>jooby-mutiny</name>
diff --git a/modules/jooby-netty/pom.xml b/modules/jooby-netty/pom.xml
index f1e56b022c..cff8f4313b 100644
--- a/modules/jooby-netty/pom.xml
+++ b/modules/jooby-netty/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-netty</artifactId>
   <name>jooby-netty</name>
diff --git a/modules/jooby-netty/src/main/java/io/jooby/internal/netty/NettyContext.java b/modules/jooby-netty/src/main/java/io/jooby/internal/netty/NettyContext.java
index 91d2496e92..a49bad2776 100644
--- a/modules/jooby-netty/src/main/java/io/jooby/internal/netty/NettyContext.java
+++ b/modules/jooby-netty/src/main/java/io/jooby/internal/netty/NettyContext.java
@@ -37,7 +37,6 @@
 
 import org.slf4j.Logger;
 
-import com.typesafe.config.Config;
 import edu.umd.cs.findbugs.annotations.NonNull;
 import edu.umd.cs.findbugs.annotations.Nullable;
 import io.jooby.*;
@@ -51,7 +50,6 @@
 import io.netty.handler.codec.http.cookie.ServerCookieDecoder;
 import io.netty.handler.codec.http.multipart.*;
 import io.netty.handler.codec.http.websocketx.WebSocketDecoderConfig;
-import io.netty.handler.codec.http.websocketx.WebSocketServerHandshaker;
 import io.netty.handler.codec.http.websocketx.WebSocketServerHandshakerFactory;
 import io.netty.handler.ssl.SslHandler;
 import io.netty.handler.stream.ChunkedNioFile;
@@ -412,16 +410,65 @@ public Context onComplete(@NonNull Route.Complete task) {
     return this;
   }
 
+  //  @NonNull @Override
+  //  public Context upgrade(WebSocket.Initializer handler) {
+  //    try {
+  //      responseStarted = true;
+  //      Config conf = getRouter().getConfig();
+  //      int maxSize =
+  //          conf.hasPath("websocket.maxSize")
+  //              ? conf.getBytes("websocket.maxSize").intValue()
+  //              : WebSocket.MAX_BUFFER_SIZE;
+  //      String webSocketURL = getProtocol() + "://" + req.headers().get(HttpHeaderNames.HOST) +
+  // path;
+  //      var config =
+  //          WebSocketDecoderConfig.newBuilder()
+  //              .allowExtensions(true)
+  //              .allowMaskMismatch(false)
+  //              .withUTF8Validator(false)
+  //              .maxFramePayloadLength(maxSize)
+  //              .build();
+  //      webSocket = new NettyWebSocket(this);
+  //      handler.init(Context.readOnly(this), webSocket);
+  //      var webSocketRequest =
+  //          new DefaultFullHttpRequest(
+  //              HTTP_1_1,
+  //              req.method(),
+  //              req.uri(),
+  //              Unpooled.EMPTY_BUFFER,
+  //              req.headers(),
+  //              EmptyHttpHeaders.INSTANCE);
+  //      var codec = ctx.pipeline().get(NettyServerCodec.class);
+  //      codec.webSocketHandshake(ctx);
+  //      WebSocketServerHandshakerFactory factory =
+  //          new WebSocketServerHandshakerFactory(webSocketURL, null, config);
+  //      WebSocketServerHandshaker handshaker = factory.newHandshaker(webSocketRequest);
+  //      handshaker.handshake(ctx.channel(), webSocketRequest);
+  //      webSocket.fireConnect();
+  //      long timeout =
+  //          conf.hasPath("websocket.idleTimeout")
+  //              ? conf.getDuration("websocket.idleTimeout", MILLISECONDS)
+  //              : MINUTES.toMillis(5);
+  //      if (timeout > 0) {
+  //        IdleStateHandler idle = new IdleStateHandler(timeout, 0, 0, MILLISECONDS);
+  //        ctx.pipeline().addBefore("handler", "idle", idle);
+  //      }
+  //    } catch (Throwable x) {
+  //      sendError(x);
+  //    }
+  //    return this;
+  //  }
   @NonNull @Override
   public Context upgrade(WebSocket.Initializer handler) {
     try {
       responseStarted = true;
-      Config conf = getRouter().getConfig();
+      var conf = getRouter().getConfig();
       int maxSize =
           conf.hasPath("websocket.maxSize")
               ? conf.getBytes("websocket.maxSize").intValue()
               : WebSocket.MAX_BUFFER_SIZE;
-      String webSocketURL = getProtocol() + "://" + req.headers().get(HttpHeaderNames.HOST) + path;
+      var webSocketURL = getProtocol() + "://" + req.headers().get(HttpHeaderNames.HOST) + path;
+
       var config =
           WebSocketDecoderConfig.newBuilder()
               .allowExtensions(true)
@@ -429,8 +476,10 @@ public Context upgrade(WebSocket.Initializer handler) {
               .withUTF8Validator(false)
               .maxFramePayloadLength(maxSize)
               .build();
+
       webSocket = new NettyWebSocket(this);
       handler.init(Context.readOnly(this), webSocket);
+
       var webSocketRequest =
           new DefaultFullHttpRequest(
               HTTP_1_1,
@@ -439,21 +488,36 @@ public Context upgrade(WebSocket.Initializer handler) {
               Unpooled.EMPTY_BUFFER,
               req.headers(),
               EmptyHttpHeaders.INSTANCE);
+
       var codec = ctx.pipeline().get(NettyServerCodec.class);
       codec.webSocketHandshake(ctx);
-      WebSocketServerHandshakerFactory factory =
-          new WebSocketServerHandshakerFactory(webSocketURL, null, config);
-      WebSocketServerHandshaker handshaker = factory.newHandshaker(webSocketRequest);
+
+      var factory = new WebSocketServerHandshakerFactory(webSocketURL, null, config);
+      var handshaker = factory.newHandshaker(webSocketRequest);
+
+      if (handshaker == null) {
+        WebSocketServerHandshakerFactory.sendUnsupportedVersionResponse(ctx.channel());
+        return this;
+      }
+
       handshaker.handshake(ctx.channel(), webSocketRequest);
       webSocket.fireConnect();
+
       long timeout =
           conf.hasPath("websocket.idleTimeout")
               ? conf.getDuration("websocket.idleTimeout", MILLISECONDS)
               : MINUTES.toMillis(5);
+
       if (timeout > 0) {
         IdleStateHandler idle = new IdleStateHandler(timeout, 0, 0, MILLISECONDS);
-        ctx.pipeline().addBefore("handler", "idle", idle);
+        // If the global server timeout is already there, replace it. Otherwise, add it.
+        if (ctx.pipeline().get(IdleStateHandler.class) != null) {
+          ctx.pipeline().replace(IdleStateHandler.class, "idle", idle);
+        } else {
+          ctx.pipeline().addBefore("handler", "idle", idle);
+        }
       }
+
     } catch (Throwable x) {
       sendError(x);
     }
diff --git a/modules/jooby-netty/src/main/java/io/jooby/internal/netty/NettyDateService.java b/modules/jooby-netty/src/main/java/io/jooby/internal/netty/NettyDateService.java
index d769e481b0..bbf329943e 100644
--- a/modules/jooby-netty/src/main/java/io/jooby/internal/netty/NettyDateService.java
+++ b/modules/jooby-netty/src/main/java/io/jooby/internal/netty/NettyDateService.java
@@ -8,18 +8,25 @@
 import java.time.ZoneOffset;
 import java.time.ZonedDateTime;
 import java.time.format.DateTimeFormatter;
-import java.util.concurrent.ScheduledExecutorService;
-import java.util.concurrent.TimeUnit;
+import java.util.concurrent.*;
+
+import io.netty.util.concurrent.DefaultThreadFactory;
 
 public class NettyDateService implements Runnable {
   private static final int DATE_INTERVAL = 1000;
-  private CharSequence date;
+  private final ScheduledExecutorService scheduler;
+  // Make volatile for thread visibility across EventLoop threads
+  private volatile CharSequence date;
+  private final ScheduledFuture<?> future;
 
-  public NettyDateService(ScheduledExecutorService scheduler) {
+  public NettyDateService() {
+    this.scheduler =
+        Executors.newSingleThreadScheduledExecutor(new DefaultThreadFactory("http-date-keeper"));
     this.date =
         new NettyString(
             DateTimeFormatter.RFC_1123_DATE_TIME.format(ZonedDateTime.now(ZoneOffset.UTC)));
-    scheduler.scheduleAtFixedRate(this, DATE_INTERVAL, DATE_INTERVAL, TimeUnit.MILLISECONDS);
+    this.future =
+        scheduler.scheduleAtFixedRate(this, DATE_INTERVAL, DATE_INTERVAL, TimeUnit.MILLISECONDS);
   }
 
   public CharSequence date() {
@@ -32,4 +39,17 @@ public void run() {
         new NettyString(
             DateTimeFormatter.RFC_1123_DATE_TIME.format(ZonedDateTime.now(ZoneOffset.UTC)));
   }
+
+  // Allow the server to gracefully terminate the background task
+  public void stop() {
+    try {
+      if (this.future != null) {
+        this.future.cancel(false);
+      }
+    } catch (Exception ignored) {
+      if (scheduler != null) {
+        scheduler.shutdown();
+      }
+    }
+  }
 }
diff --git a/modules/jooby-netty/src/main/java/io/jooby/internal/netty/NettyGrpcExchange.java b/modules/jooby-netty/src/main/java/io/jooby/internal/netty/NettyGrpcExchange.java
new file mode 100644
index 0000000000..1802ecd0cd
--- /dev/null
+++ b/modules/jooby-netty/src/main/java/io/jooby/internal/netty/NettyGrpcExchange.java
@@ -0,0 +1,130 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.internal.netty;
+
+import java.net.URLEncoder;
+import java.nio.ByteBuffer;
+import java.nio.charset.StandardCharsets;
+import java.util.HashMap;
+import java.util.Map;
+import java.util.concurrent.atomic.AtomicBoolean;
+import java.util.function.Consumer;
+
+import io.jooby.rpc.grpc.GrpcExchange;
+import io.netty.buffer.Unpooled;
+import io.netty.channel.ChannelFutureListener;
+import io.netty.channel.ChannelHandlerContext;
+import io.netty.handler.codec.http.DefaultHttpContent;
+import io.netty.handler.codec.http.DefaultHttpResponse;
+import io.netty.handler.codec.http.DefaultLastHttpContent;
+import io.netty.handler.codec.http.HttpHeaderNames;
+import io.netty.handler.codec.http.HttpRequest;
+import io.netty.handler.codec.http.HttpResponse;
+import io.netty.handler.codec.http.HttpResponseStatus;
+import io.netty.handler.codec.http.HttpVersion;
+import io.netty.handler.codec.http.LastHttpContent;
+
+public class NettyGrpcExchange implements GrpcExchange {
+
+  private final ChannelHandlerContext ctx;
+  private final HttpRequest request;
+
+  private final AtomicBoolean headersSent = new AtomicBoolean(false);
+
+  public NettyGrpcExchange(ChannelHandlerContext ctx, HttpRequest request) {
+    this.ctx = ctx;
+    this.request = request;
+  }
+
+  @Override
+  public String getRequestPath() {
+    String uri = request.uri();
+    int queryIndex = uri.indexOf('?');
+    return queryIndex > 0 ? uri.substring(0, queryIndex) : uri;
+  }
+
+  @Override
+  public String getHeader(String name) {
+    return request.headers().get(name);
+  }
+
+  @Override
+  public Map<String, String> getHeaders() {
+    Map<String, String> map = new HashMap<>();
+    for (Map.Entry<String, String> entry : request.headers()) {
+      map.put(entry.getKey(), entry.getValue());
+    }
+    return map;
+  }
+
+  private void sendHeadersIfNecessary() {
+    if (headersSent.compareAndSet(false, true)) {
+      // Send the initial HTTP/2 HEADERS frame (Status 200)
+      HttpResponse response = new DefaultHttpResponse(HttpVersion.HTTP_1_1, HttpResponseStatus.OK);
+      response.headers().set(HttpHeaderNames.CONTENT_TYPE, "application/grpc");
+      ctx.write(response);
+    }
+  }
+
+  @Override
+  public void send(ByteBuffer payload, Consumer<Throwable> callback) {
+    sendHeadersIfNecessary();
+
+    // Wrap the NIO ByteBuffer in a Netty ByteBuf without copying
+    var chunk = new DefaultHttpContent(Unpooled.wrappedBuffer(payload));
+
+    // Write and flush, then map Netty's Future to your single-lambda callback
+    ctx.writeAndFlush(chunk)
+        .addListener(
+            future -> {
+              if (future.isSuccess()) {
+                callback.accept(null);
+              } else {
+                callback.accept(future.cause());
+              }
+            });
+  }
+
+  @Override
+  public void close(int statusCode, String description) {
+    var encodedDescription = encodeGrpcMessage(description);
+
+    // If headers were already sent, we just need to send the final trailers
+    if (headersSent.get()) {
+      LastHttpContent lastContent = new DefaultLastHttpContent();
+      lastContent.trailingHeaders().set("grpc-status", String.valueOf(statusCode));
+
+      if (encodedDescription != null) {
+        lastContent.trailingHeaders().set("grpc-message", encodedDescription);
+      }
+
+      ctx.writeAndFlush(lastContent).addListener(ChannelFutureListener.CLOSE);
+
+    } else {
+      // Trailers-Only fast path: Headers and trailers combined
+      var response = new DefaultHttpResponse(HttpVersion.HTTP_1_1, HttpResponseStatus.OK);
+      response.headers().set(HttpHeaderNames.CONTENT_TYPE, "application/grpc");
+      response.headers().set("grpc-status", String.valueOf(statusCode));
+
+      if (encodedDescription != null) {
+        response.headers().set("grpc-message", encodedDescription);
+      }
+
+      ctx.write(response);
+      ctx.writeAndFlush(LastHttpContent.EMPTY_LAST_CONTENT)
+          .addListener(ChannelFutureListener.CLOSE);
+    }
+  }
+
+  /** gRPC specification requires the grpc-message trailer to be percent-encoded. */
+  private static String encodeGrpcMessage(String description) {
+    if (description == null) {
+      return null;
+    }
+    // URLEncoder uses '+' for spaces, but gRPC strictly expects '%20'
+    return URLEncoder.encode(description, StandardCharsets.UTF_8).replace("+", "%20");
+  }
+}
diff --git a/modules/jooby-netty/src/main/java/io/jooby/internal/netty/NettyGrpcHandler.java b/modules/jooby-netty/src/main/java/io/jooby/internal/netty/NettyGrpcHandler.java
new file mode 100644
index 0000000000..dc931be151
--- /dev/null
+++ b/modules/jooby-netty/src/main/java/io/jooby/internal/netty/NettyGrpcHandler.java
@@ -0,0 +1,109 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.internal.netty;
+
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+import io.jooby.rpc.grpc.GrpcProcessor;
+import io.netty.channel.ChannelFutureListener;
+import io.netty.channel.ChannelHandlerContext;
+import io.netty.channel.ChannelInboundHandlerAdapter;
+import io.netty.handler.codec.http.*;
+import io.netty.util.ReferenceCountUtil;
+
+public class NettyGrpcHandler extends ChannelInboundHandlerAdapter {
+
+  private static final Logger log = LoggerFactory.getLogger(NettyGrpcHandler.class);
+
+  private final GrpcProcessor processor;
+  private final boolean isHttp2;
+
+  // State for the current stream
+  private boolean isGrpc = false;
+  private NettyGrpcInputBridge inputBridge;
+
+  public NettyGrpcHandler(GrpcProcessor processor, boolean isHttp2) {
+    this.processor = processor;
+    this.isHttp2 = isHttp2;
+  }
+
+  @Override
+  public void channelRead(ChannelHandlerContext ctx, Object msg) throws Exception {
+
+    // 1. Intercept the initial Request headers
+    if (msg instanceof HttpRequest req) {
+      var contentType = req.headers().get(HttpHeaderNames.CONTENT_TYPE);
+      var path = req.uri();
+      int queryIndex = path.indexOf('?');
+      path = queryIndex > 0 ? path.substring(0, queryIndex) : path;
+
+      if (processor.isGrpcMethod(path)
+          && contentType != null
+          && contentType.startsWith("application/grpc")) {
+
+        if (!isHttp2) {
+          // gRPC requires HTTP/2. Reject HTTP/1.1 calls immediately.
+          var response =
+              new DefaultFullHttpResponse(
+                  HttpVersion.HTTP_1_1, HttpResponseStatus.UPGRADE_REQUIRED);
+          response.headers().set(HttpHeaderNames.CONNECTION, HttpHeaderValues.UPGRADE);
+          response.headers().set(HttpHeaderNames.UPGRADE, "h2c");
+          ctx.writeAndFlush(response).addListener(ChannelFutureListener.CLOSE);
+          ReferenceCountUtil.release(msg);
+          return;
+        }
+
+        // This prevents leaking state on rejected HTTP/1.1 connections.
+        isGrpc = true;
+
+        // We will implement NettyGrpcExchange in the next step
+        var exchange = new NettyGrpcExchange(ctx, req);
+        var subscriber = processor.process(exchange);
+
+        inputBridge = new NettyGrpcInputBridge(ctx, subscriber);
+        inputBridge.start();
+
+        ReferenceCountUtil.release(msg); // We consumed the headers
+        return;
+      }
+    }
+
+    // 2. Intercept subsequent body chunks for this gRPC stream
+    if (isGrpc && msg instanceof HttpContent chunk) {
+      try {
+        if (inputBridge != null) {
+          inputBridge.onChunk(chunk);
+        }
+      } finally {
+        // Always release Netty's direct memory buffers
+        ReferenceCountUtil.release(chunk);
+      }
+      return;
+    }
+
+    // Not a gRPC request. Pass down the pipeline to Jooby's NettyHandler
+    super.channelRead(ctx, msg);
+  }
+
+  @Override
+  public void channelInactive(ChannelHandlerContext ctx) throws Exception {
+    if (isGrpc && inputBridge != null) {
+      inputBridge.cancel(); // Client disconnected abruptly
+    }
+    super.channelInactive(ctx);
+  }
+
+  @Override
+  public void exceptionCaught(ChannelHandlerContext ctx, Throwable cause) throws Exception {
+    log.debug("gRPC stream exception caught", cause);
+    if (isGrpc) {
+      ctx.close();
+    } else {
+      super.exceptionCaught(ctx, cause);
+    }
+  }
+}
diff --git a/modules/jooby-netty/src/main/java/io/jooby/internal/netty/NettyGrpcInputBridge.java b/modules/jooby-netty/src/main/java/io/jooby/internal/netty/NettyGrpcInputBridge.java
new file mode 100644
index 0000000000..71436a9692
--- /dev/null
+++ b/modules/jooby-netty/src/main/java/io/jooby/internal/netty/NettyGrpcInputBridge.java
@@ -0,0 +1,89 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.internal.netty;
+
+import java.nio.ByteBuffer;
+import java.util.concurrent.Flow;
+import java.util.concurrent.atomic.AtomicLong;
+
+import io.netty.buffer.ByteBuf;
+import io.netty.channel.ChannelHandlerContext;
+import io.netty.handler.codec.http.HttpContent;
+import io.netty.handler.codec.http.LastHttpContent;
+
+public class NettyGrpcInputBridge implements Flow.Subscription {
+
+  private final ChannelHandlerContext ctx;
+  private final Flow.Subscriber<ByteBuffer> subscriber;
+  private final AtomicLong demand = new AtomicLong();
+
+  public NettyGrpcInputBridge(ChannelHandlerContext ctx, Flow.Subscriber<ByteBuffer> subscriber) {
+    this.ctx = ctx;
+    this.subscriber = subscriber;
+  }
+
+  public void start() {
+    // Disable auto-read. We will manually request reads based on gRPC demand.
+    ctx.channel().config().setAutoRead(false);
+    subscriber.onSubscribe(this);
+  }
+
+  @Override
+  public void request(long n) {
+    if (n <= 0) {
+      subscriber.onError(new IllegalArgumentException("Demand must be positive"));
+      return;
+    }
+
+    if (demand.getAndAdd(n) == 0) {
+      // We transitioned from 0 to n demand, trigger a read from the socket
+      ctx.read();
+    }
+  }
+
+  @Override
+  public void cancel() {
+    demand.set(0);
+    ctx.close(); // Abort the connection
+  }
+
+  public void onChunk(HttpContent chunk) {
+    try {
+      ByteBuf content = chunk.content();
+      if (content.isReadable()) {
+
+        // Copy the bytes. content.nioBuffer() shares memory with the ByteBuf,
+        // which gets released in the finally block of NettyGrpcHandler.
+        // We must copy it to an unmanaged heap buffer to prevent use-after-free corruption.
+        byte[] bytes = new byte[content.readableBytes()];
+        content.readBytes(bytes);
+        ByteBuffer buffer = ByteBuffer.wrap(bytes);
+
+        // If onNext synchronously calls request(1), that request() will see demand transition
+        // from 0 to 1 and safely trigger ctx.read().
+        long currentDemand = demand.decrementAndGet();
+
+        // Pass the isolated buffer to the gRPC deframer
+        subscriber.onNext(buffer);
+
+        if (currentDemand > 0) {
+          // Still have demand from previous requests, ask Netty for the next chunk
+          ctx.read();
+        }
+      }
+
+      if (chunk instanceof LastHttpContent) {
+        subscriber.onComplete();
+      } else if (demand.get() > 0 && !content.isReadable()) {
+        // Edge case: Empty chunk but not LastHttpContent, read next
+        ctx.read();
+      }
+    } catch (Throwable t) {
+      subscriber.onError(t);
+      ctx.close();
+    }
+  }
+}
diff --git a/modules/jooby-netty/src/main/java/io/jooby/internal/netty/NettyHandler.java b/modules/jooby-netty/src/main/java/io/jooby/internal/netty/NettyHandler.java
index 327d3416ca..5798f04fc4 100644
--- a/modules/jooby-netty/src/main/java/io/jooby/internal/netty/NettyHandler.java
+++ b/modules/jooby-netty/src/main/java/io/jooby/internal/netty/NettyHandler.java
@@ -21,6 +21,7 @@
 import io.netty.handler.codec.http.multipart.*;
 import io.netty.handler.codec.http.websocketx.WebSocketFrame;
 import io.netty.handler.timeout.IdleStateEvent;
+import io.netty.util.ReferenceCountUtil;
 
 public class NettyHandler extends ChannelInboundHandlerAdapter {
   private final Logger log = LoggerFactory.getLogger(NettyServer.class);
@@ -65,6 +66,7 @@ public void handlerAdded(ChannelHandlerContext ctx) throws Exception {
   public void channelRead(ChannelHandlerContext ctx, Object msg) {
     if (isHttpRequest(msg)) {
       this.read = true;
+      this.chunkSize = 0;
       var req = (HttpRequest) msg;
       var path = pathOnly(req.uri());
       var app = contextSelector.select(path);
@@ -84,9 +86,20 @@ public void channelRead(ChannelHandlerContext ctx, Object msg) {
         // possibly body:
         long contentLength = contentLength(req);
         if (contentLength > 0 || isTransferEncodingChunked(req)) {
-          context.httpDataFactory = new DefaultHttpDataFactory(bufferSize);
-          context.httpDataFactory.setBaseDir(app.getTmpdir().toString());
-          context.setDecoder(newDecoder(req, context.httpDataFactory, maxFormFields));
+          if (req.getClass() == DefaultFullHttpRequest.class) {
+            // HTTP2 aggregates all into a full http request.
+            if (((DefaultFullHttpRequest) req).content().readableBytes() > maxRequestSize) {
+              release(req);
+              router.match(context).execute(context, Route.REQUEST_ENTITY_TOO_LARGE);
+              return;
+            }
+            // full body is here move
+            router.match(context).execute(context);
+          } else {
+            context.httpDataFactory = new DefaultHttpDataFactory(bufferSize);
+            context.httpDataFactory.setBaseDir(app.getTmpdir().toString());
+            context.setDecoder(newDecoder(req, context.httpDataFactory, maxFormFields));
+          }
         } else {
           // no body, move on
           router.match(context).execute(context);
@@ -116,6 +129,8 @@ public void channelRead(ChannelHandlerContext ctx, Object msg) {
     } else if (isWebSocketFrame(msg)) {
       if (context.webSocket != null) {
         context.webSocket.handleFrame((WebSocketFrame) msg);
+      } else {
+        release(msg);
       }
     }
   }
@@ -140,8 +155,14 @@ public void writeChunks(Object header, Object body, Object last, ChannelPromise
       channelContext.write(header, voidPromise);
       // Body
       channelContext.write(body, voidPromise);
+
       // Finish
-      channelContext.writeAndFlush(last, promise);
+      if (this.read) {
+        this.flush = true;
+        channelContext.write(last, promise); // Defer flush
+      } else {
+        channelContext.writeAndFlush(last, promise); // Immediate flush
+      }
     } else {
       this.channelContext.executor().execute(() -> writeChunks(header, body, last, promise));
     }
@@ -159,16 +180,22 @@ public void writeChunks(Object header, Object body, ChannelPromise promise) {
     if (this.channelContext.executor().inEventLoop()) {
       // Headers
       channelContext.write(header, channelContext.voidPromise());
+
       // Body + Last
-      channelContext.writeAndFlush(body, promise);
+      if (this.read) {
+        this.flush = true;
+        channelContext.write(body, promise); // Defer flush
+      } else {
+        channelContext.writeAndFlush(body, promise); // Immediate flush
+      }
     } else {
       this.channelContext.executor().execute(() -> writeChunks(header, body, promise));
     }
   }
 
-  private void release(HttpContent ref) {
-    if (ref.refCnt() > 0) {
-      ref.release();
+  private void release(Object ref) {
+    if (ReferenceCountUtil.refCnt(ref) > 0) {
+      ReferenceCountUtil.release(ref);
     }
   }
 
@@ -217,7 +244,13 @@ public void exceptionCaught(ChannelHandlerContext ctx, Throwable cause) {
         }
       }
     } finally {
-      ctx.close();
+      try {
+        if (context != null) {
+          resetDecoderState(context, true); // Force decoder cleanup on failure
+        }
+      } finally {
+        ctx.close();
+      }
     }
   }
 
diff --git a/modules/jooby-netty/src/main/java/io/jooby/internal/netty/NettyPipeline.java b/modules/jooby-netty/src/main/java/io/jooby/internal/netty/NettyPipeline.java
index 61437319a0..4c9da3997c 100644
--- a/modules/jooby-netty/src/main/java/io/jooby/internal/netty/NettyPipeline.java
+++ b/modules/jooby-netty/src/main/java/io/jooby/internal/netty/NettyPipeline.java
@@ -9,6 +9,7 @@
 import java.util.concurrent.ScheduledExecutorService;
 
 import io.jooby.Context;
+import io.jooby.rpc.grpc.GrpcProcessor;
 import io.netty.buffer.ByteBuf;
 import io.netty.channel.*;
 import io.netty.channel.socket.SocketChannel;
@@ -32,6 +33,8 @@ public class NettyPipeline extends ChannelInitializer<SocketChannel> {
   private final boolean http2;
   private final boolean expectContinue;
   private final Integer compressionLevel;
+  private final NettyDateService dateService;
+  private final GrpcProcessor grpcProcessor;
 
   public NettyPipeline(
       SslContext sslContext,
@@ -43,7 +46,9 @@ public NettyPipeline(
       boolean defaultHeaders,
       boolean http2,
       boolean expectContinue,
-      Integer compressionLevel) {
+      Integer compressionLevel,
+      NettyDateService dateService,
+      GrpcProcessor grpcProcessor) {
     this.sslContext = sslContext;
     this.decoderConfig = decoderConfig;
     this.contextSelector = contextSelector;
@@ -54,6 +59,8 @@ public NettyPipeline(
     this.http2 = http2;
     this.expectContinue = expectContinue;
     this.compressionLevel = compressionLevel;
+    this.dateService = dateService;
+    this.grpcProcessor = grpcProcessor;
   }
 
   @Override
@@ -74,6 +81,12 @@ public void initChannel(SocketChannel ch) {
   private void setupHttp11(ChannelPipeline p) {
     p.addLast("codec", createServerCodec());
     addCommonHandlers(p);
+
+    // Inject gRPC handler (isHttp2 = false to trigger 426 Upgrade Required)
+    if (grpcProcessor != null) {
+      p.addLast("grpc", new NettyGrpcHandler(grpcProcessor, false));
+    }
+
     p.addLast("handler", createHandler(p.channel().eventLoop()));
   }
 
@@ -99,7 +112,36 @@ private void setupHttp11Upgrade(ChannelPipeline pipeline) {
             protocol -> "h2c".equals(protocol.toString()) ? createH2CUpgradeCodec() : null,
             (int) maxRequestSize));
 
+    pipeline.addLast(
+        "h2upgrade-cleaner",
+        new ChannelInboundHandlerAdapter() {
+          @Override
+          public void userEventTriggered(ChannelHandlerContext ctx, Object evt) throws Exception {
+            if (evt instanceof HttpServerUpgradeHandler.UpgradeEvent) {
+              ChannelPipeline p = ctx.pipeline();
+
+              // Strip out HTTP/1.1 handlers that are no longer needed on the parent channel.
+              // The Http2StreamInitializer will attach new ones for the multiplexed child channels.
+              if (p.context("grpc") != null) p.remove("grpc");
+              if (p.context("handler") != null) p.remove("handler");
+              if (p.context("expect-continue") != null) p.remove("expect-continue");
+              if (p.context("compressor") != null) p.remove("compressor");
+              if (p.context("ws-compressor") != null) p.remove("ws-compressor");
+
+              // Remove this cleaner itself so it doesn't linger
+              p.remove(this);
+            }
+            super.userEventTriggered(ctx, evt);
+          }
+        });
+
     addCommonHandlers(pipeline);
+
+    // Inject gRPC handler (isHttp2 = false to trigger 426 Upgrade Required)
+    if (grpcProcessor != null) {
+      pipeline.addLast("grpc", new NettyGrpcHandler(grpcProcessor, false));
+    }
+
     pipeline.addLast("handler", createHandler(pipeline.channel().eventLoop()));
   }
 
@@ -128,7 +170,7 @@ private Http2ServerUpgradeCodec createH2CUpgradeCodec() {
 
   private NettyHandler createHandler(ScheduledExecutorService executor) {
     return new NettyHandler(
-        new NettyDateService(executor),
+        dateService,
         contextSelector,
         maxRequestSize,
         maxFormFields,
@@ -193,6 +235,12 @@ private static class Http2StreamInitializer extends ChannelInitializer<Channel>
     @Override
     protected void initChannel(Channel ch) {
       ch.pipeline().addLast("http2", new Http2StreamFrameToHttpObjectCodec(true));
+
+      // Inject gRPC handler (isHttp2 = true). This handles the actual multiplexed gRPC traffic.
+      if (pipeline.grpcProcessor != null) {
+        ch.pipeline().addLast("grpc", new NettyGrpcHandler(pipeline.grpcProcessor, true));
+      }
+
       ch.pipeline().addLast("handler", pipeline.createHandler(ch.eventLoop()));
     }
   }
diff --git a/modules/jooby-netty/src/main/java/io/jooby/internal/netty/NettyWebSocket.java b/modules/jooby-netty/src/main/java/io/jooby/internal/netty/NettyWebSocket.java
index 09a7b0287b..56daa86829 100644
--- a/modules/jooby-netty/src/main/java/io/jooby/internal/netty/NettyWebSocket.java
+++ b/modules/jooby-netty/src/main/java/io/jooby/internal/netty/NettyWebSocket.java
@@ -273,8 +273,9 @@ void handleFrame(WebSocketFrame frame) {
         netty
             .ctx
             .channel()
-            .writeAndFlush(new PongWebSocketFrame(frame.content()))
+            .writeAndFlush(new PongWebSocketFrame(frame.content().retain()))
             .addListener(new WriteCallbackAdaptor(this, WriteCallback.NOOP));
+        frame.release();
       } else if (frame instanceof CloseWebSocketFrame) {
         handleClose(toWebSocketCloseStatus((CloseWebSocketFrame) frame));
       }
diff --git a/modules/jooby-netty/src/main/java/io/jooby/netty/NettyServer.java b/modules/jooby-netty/src/main/java/io/jooby/netty/NettyServer.java
index da2d1c5c5f..d770730c67 100644
--- a/modules/jooby-netty/src/main/java/io/jooby/netty/NettyServer.java
+++ b/modules/jooby-netty/src/main/java/io/jooby/netty/NettyServer.java
@@ -22,6 +22,7 @@
 import io.jooby.exception.StartupException;
 import io.jooby.internal.netty.*;
 import io.jooby.output.OutputFactory;
+import io.jooby.rpc.grpc.GrpcProcessor;
 import io.netty.bootstrap.ServerBootstrap;
 import io.netty.buffer.ByteBufAllocator;
 import io.netty.channel.ChannelOption;
@@ -61,6 +62,7 @@ public class NettyServer extends Server.Base {
   private NettyOutputFactory outputFactory;
   private boolean singleEventLoopGroup =
       System.getProperty("io.netty.eventLoopGroup", "parent-child").equals("single");
+  private NettyDateService dateLoop;
 
   /**
    * Creates a server.
@@ -147,15 +149,23 @@ public Server start(@NonNull Jooby... application) {
             new NettyEventLoopGroupImpl(
                 transport, singleEventLoopGroup, options.getIoThreads(), worker);
       }
+      this.dateLoop = new NettyDateService();
 
       fireStart(List.of(application), eventLoop.worker());
 
       var outputFactory = (NettyOutputFactory) getOutputFactory();
       var allocator = outputFactory.getAllocator();
       var http2 = options.isHttp2() == Boolean.TRUE;
+
+      // Retrieve the GrpcProcessor from the application's service registry
+      GrpcProcessor grpcProcessor =
+          http2 ? applications.get(0).getServices().getOrNull(GrpcProcessor.class) : null;
+
       /* Bootstrap: */
       if (!options.isHttpsOnly()) {
-        var http = newBootstrap(allocator, transport, newPipeline(options, null, http2), eventLoop);
+        var http =
+            newBootstrap(
+                allocator, transport, newPipeline(options, null, http2, grpcProcessor), eventLoop);
         http.bind(options.getHost(), options.getPort()).get();
       }
 
@@ -168,7 +178,11 @@ public Server start(@NonNull Jooby... application) {
         var clientAuth = sslOptions.getClientAuth();
         var sslContext = wrap(javaSslContext, toClientAuth(clientAuth), protocol, http2);
         var https =
-            newBootstrap(allocator, transport, newPipeline(options, sslContext, http2), eventLoop);
+            newBootstrap(
+                allocator,
+                transport,
+                newPipeline(options, sslContext, http2, grpcProcessor),
+                eventLoop);
         portInUse = options.getSecurePort();
         https.bind(options.getHost(), portInUse).get();
       } else if (options.isHttpsOnly()) {
@@ -214,7 +228,8 @@ private ClientAuth toClientAuth(SslOptions.ClientAuth clientAuth) {
     };
   }
 
-  private NettyPipeline newPipeline(ServerOptions options, SslContext sslContext, boolean http2) {
+  private NettyPipeline newPipeline(
+      ServerOptions options, SslContext sslContext, boolean http2, GrpcProcessor grpcProcessor) {
     var decoderConfig =
         new HttpDecoderConfig()
             .setMaxInitialLineLength(_4KB)
@@ -232,7 +247,9 @@ private NettyPipeline newPipeline(ServerOptions options, SslContext sslContext,
         options.getDefaultHeaders(),
         http2,
         options.isExpectContinue() == Boolean.TRUE,
-        options.getCompressionLevel());
+        options.getCompressionLevel(),
+        dateLoop,
+        grpcProcessor);
   }
 
   @Override
@@ -241,6 +258,10 @@ public synchronized Server stop() {
     // only for jooby build where close events may take longer.
     NettyWebSocket.all.clear();
 
+    if (this.dateLoop != null) {
+      this.dateLoop.stop();
+    }
+
     if (eventLoop != null) {
       eventLoop.shutdown();
     }
diff --git a/modules/jooby-netty/src/main/java/module-info.java b/modules/jooby-netty/src/main/java/module-info.java
index 5f9e7f16e4..0831e5136c 100644
--- a/modules/jooby-netty/src/main/java/module-info.java
+++ b/modules/jooby-netty/src/main/java/module-info.java
@@ -25,7 +25,6 @@
   requires static io.netty.transport.classes.epoll;
   requires static io.netty.transport.classes.kqueue;
   requires static io.netty.transport.classes.io_uring;
-  requires java.desktop;
 
   provides Server with
       NettyServer;
diff --git a/modules/jooby-openapi/pom.xml b/modules/jooby-openapi/pom.xml
index 89fb3ca557..f13c57f93e 100644
--- a/modules/jooby-openapi/pom.xml
+++ b/modules/jooby-openapi/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-openapi</artifactId>
   <name>jooby-openapi</name>
diff --git a/modules/jooby-openapi/src/main/java/io/jooby/internal/openapi/AnnotationParser.java b/modules/jooby-openapi/src/main/java/io/jooby/internal/openapi/AnnotationParser.java
index 27edcd6b71..1538e8cad4 100644
--- a/modules/jooby-openapi/src/main/java/io/jooby/internal/openapi/AnnotationParser.java
+++ b/modules/jooby-openapi/src/main/java/io/jooby/internal/openapi/AnnotationParser.java
@@ -130,7 +130,8 @@ public Optional<String> getJakartaDefaultValue(List<AnnotationNode> annotations)
           Stream.of(annotations()).filter(it -> it.getName().startsWith("jakarta.ws.rs")).toList();
       for (var a : annotations) {
         if (a.values != null) {
-          var matches = names.stream().anyMatch(it -> "Ljakarta/ws/rs/DefaultValue;".equals(a.desc));
+          var matches =
+              names.stream().anyMatch(it -> "Ljakarta/ws/rs/DefaultValue;".equals(a.desc));
           if (matches) {
             return AnnotationUtils.findAnnotationValue(a, "value").map(Objects::toString);
           }
diff --git a/modules/jooby-openapi/src/main/java/io/jooby/internal/openapi/ParameterExt.java b/modules/jooby-openapi/src/main/java/io/jooby/internal/openapi/ParameterExt.java
index 36cbae6cd8..b75d583e50 100644
--- a/modules/jooby-openapi/src/main/java/io/jooby/internal/openapi/ParameterExt.java
+++ b/modules/jooby-openapi/src/main/java/io/jooby/internal/openapi/ParameterExt.java
@@ -25,6 +25,7 @@ public class ParameterExt extends Parameter {
   @JsonIgnore private boolean single = true;
 
   @JsonIgnore private List<AnnotationNode> annotations = List.of();
+  @JsonIgnore private boolean defaultValueSet;
 
   public void setJavaType(String javaType) {
     this.javaType = javaType;
@@ -34,6 +35,10 @@ public String getJavaType() {
     return javaType;
   }
 
+  public boolean isDefaultValueSet() {
+    return defaultValueSet;
+  }
+
   public Object getDefaultValue() {
     if (defaultValue != null) {
       if (javaType.equals(boolean.class.getName())) {
@@ -58,6 +63,7 @@ public void setSingle(boolean single) {
 
   public void setDefaultValue(Object defaultValue) {
     this.defaultValue = defaultValue;
+    this.defaultValueSet = true;
   }
 
   @Override
diff --git a/modules/jooby-openapi/src/main/java/io/jooby/internal/openapi/RouteParser.java b/modules/jooby-openapi/src/main/java/io/jooby/internal/openapi/RouteParser.java
index ca5dc2ab1b..01c1f88ca0 100644
--- a/modules/jooby-openapi/src/main/java/io/jooby/internal/openapi/RouteParser.java
+++ b/modules/jooby-openapi/src/main/java/io/jooby/internal/openapi/RouteParser.java
@@ -195,7 +195,9 @@ private List<Parameter> checkParameters(ParserContext ctx, List<Parameter> param
         Optional.ofNullable(ctx.schema(javaType))
             .ifPresent(
                 schema -> {
-                  schema.setDefault(paramExt.getDefaultValue());
+                  if (paramExt.isDefaultValueSet()) {
+                    schema.setDefault(paramExt.getDefaultValue());
+                  }
                   parameter.setSchema(schema);
                 });
       }
diff --git a/modules/jooby-openapi/src/main/java/io/jooby/internal/openapi/projection/SchemaPruner.java b/modules/jooby-openapi/src/main/java/io/jooby/internal/openapi/projection/SchemaPruner.java
index f54de228ff..69a5e92e78 100644
--- a/modules/jooby-openapi/src/main/java/io/jooby/internal/openapi/projection/SchemaPruner.java
+++ b/modules/jooby-openapi/src/main/java/io/jooby/internal/openapi/projection/SchemaPruner.java
@@ -120,7 +120,9 @@ private static void copyMetadata(Schema<?> source, Schema<?> target) {
     target.setTitle(source.getTitle());
     target.setDescription(source.getDescription());
     target.setFormat(source.getFormat());
-    target.setDefault(source.getDefault());
+    if (source.getDefaultSetFlag()) {
+      target.setDefault(source.getDefault());
+    }
     if (source.getExample() != null) {
       target.setExample(source.getExample());
     }
diff --git a/modules/jooby-openapi/src/main/java/io/jooby/openapi/OpenAPIGenerator.java b/modules/jooby-openapi/src/main/java/io/jooby/openapi/OpenAPIGenerator.java
index 8f9046e07f..5b65339e9c 100644
--- a/modules/jooby-openapi/src/main/java/io/jooby/openapi/OpenAPIGenerator.java
+++ b/modules/jooby-openapi/src/main/java/io/jooby/openapi/OpenAPIGenerator.java
@@ -142,7 +142,7 @@ public List<Path> write(
     }
   }
 
-  private Logger log = LoggerFactory.getLogger(getClass());
+  private final Logger log = LoggerFactory.getLogger(getClass());
 
   private Set<DebugOption> debug;
 
diff --git a/modules/jooby-openapi/src/test/java/issues/i3835/App3835Jakarta.java b/modules/jooby-openapi/src/test/java/issues/i3835/App3835Jakarta.java
index 300ae3631c..f0fdf53f30 100644
--- a/modules/jooby-openapi/src/test/java/issues/i3835/App3835Jakarta.java
+++ b/modules/jooby-openapi/src/test/java/issues/i3835/App3835Jakarta.java
@@ -5,10 +5,10 @@
  */
 package issues.i3835;
 
-import io.jooby.Jooby;
-
 import static io.jooby.openapi.MvcExtensionGenerator.toMvcExtension;
 
+import io.jooby.Jooby;
+
 public class App3835Jakarta extends Jooby {
   {
     mvc(toMvcExtension(C3835Jakarta.class));
diff --git a/modules/jooby-openapi/src/test/java/issues/i3835/C3835Jakarta.java b/modules/jooby-openapi/src/test/java/issues/i3835/C3835Jakarta.java
index 1734cef8bc..e2bc17c744 100644
--- a/modules/jooby-openapi/src/test/java/issues/i3835/C3835Jakarta.java
+++ b/modules/jooby-openapi/src/test/java/issues/i3835/C3835Jakarta.java
@@ -5,14 +5,14 @@
  */
 package issues.i3835;
 
+import java.util.List;
+import java.util.Map;
+
 import jakarta.ws.rs.DefaultValue;
 import jakarta.ws.rs.GET;
 import jakarta.ws.rs.Path;
 import jakarta.ws.rs.QueryParam;
 
-import java.util.List;
-import java.util.Map;
-
 @Path("/3835")
 public class C3835Jakarta {
 
diff --git a/modules/jooby-pac4j/pom.xml b/modules/jooby-pac4j/pom.xml
index 41b609c9b8..6674e7fd12 100644
--- a/modules/jooby-pac4j/pom.xml
+++ b/modules/jooby-pac4j/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-pac4j</artifactId>
   <name>jooby-pac4j</name>
diff --git a/modules/jooby-pebble/pom.xml b/modules/jooby-pebble/pom.xml
index b6614d5b40..bb168b15e7 100644
--- a/modules/jooby-pebble/pom.xml
+++ b/modules/jooby-pebble/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-pebble</artifactId>
   <name>jooby-pebble</name>
diff --git a/modules/jooby-quartz/pom.xml b/modules/jooby-quartz/pom.xml
index 07ab7c2b5d..ba37cc5fb9 100644
--- a/modules/jooby-quartz/pom.xml
+++ b/modules/jooby-quartz/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-quartz</artifactId>
   <name>jooby-quartz</name>
diff --git a/modules/jooby-reactor/pom.xml b/modules/jooby-reactor/pom.xml
index 0f07fbbd89..0b3691fad7 100644
--- a/modules/jooby-reactor/pom.xml
+++ b/modules/jooby-reactor/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-reactor</artifactId>
   <name>jooby-reactor</name>
@@ -26,7 +26,7 @@
     <dependency>
       <groupId>io.projectreactor</groupId>
       <artifactId>reactor-core</artifactId>
-      <version>3.8.3</version>
+      <version>3.8.4</version>
     </dependency>
 
     <!-- Test dependencies -->
diff --git a/modules/jooby-redis/pom.xml b/modules/jooby-redis/pom.xml
index 4cab040da8..087e9fd7bf 100644
--- a/modules/jooby-redis/pom.xml
+++ b/modules/jooby-redis/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-redis</artifactId>
   <name>jooby-redis</name>
diff --git a/modules/jooby-redoc/pom.xml b/modules/jooby-redoc/pom.xml
index 5e41fc411b..d567b08208 100644
--- a/modules/jooby-redoc/pom.xml
+++ b/modules/jooby-redoc/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-redoc</artifactId>
   <name>jooby-redoc</name>
diff --git a/modules/jooby-rocker/pom.xml b/modules/jooby-rocker/pom.xml
index f3b894163c..738a1e05d0 100644
--- a/modules/jooby-rocker/pom.xml
+++ b/modules/jooby-rocker/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-rocker</artifactId>
   <name>jooby-rocker</name>
diff --git a/modules/jooby-run/pom.xml b/modules/jooby-run/pom.xml
index 1de34adc7f..3501025d33 100644
--- a/modules/jooby-run/pom.xml
+++ b/modules/jooby-run/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-run</artifactId>
   <name>jooby-run</name>
diff --git a/modules/jooby-rxjava3/pom.xml b/modules/jooby-rxjava3/pom.xml
index e053dbcf5b..2378fb681f 100644
--- a/modules/jooby-rxjava3/pom.xml
+++ b/modules/jooby-rxjava3/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-rxjava3</artifactId>
   <name>jooby-rxjava3</name>
diff --git a/modules/jooby-stork/pom.xml b/modules/jooby-stork/pom.xml
index 04e7fb33e8..a1af068585 100644
--- a/modules/jooby-stork/pom.xml
+++ b/modules/jooby-stork/pom.xml
@@ -4,7 +4,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
 
   <artifactId>jooby-stork</artifactId>
diff --git a/modules/jooby-swagger-ui/package-lock.json b/modules/jooby-swagger-ui/package-lock.json
index 00948a416e..611f5d1450 100644
--- a/modules/jooby-swagger-ui/package-lock.json
+++ b/modules/jooby-swagger-ui/package-lock.json
@@ -9,7 +9,7 @@
       "version": "4.0.0",
       "license": "ASF",
       "dependencies": {
-        "swagger-ui-dist": "^5.31.2"
+        "swagger-ui-dist": "^5.32.0"
       }
     },
     "node_modules/@scarf/scarf": {
@@ -20,9 +20,9 @@
       "license": "Apache-2.0"
     },
     "node_modules/swagger-ui-dist": {
-      "version": "5.31.2",
-      "resolved": "https://registry.npmjs.org/swagger-ui-dist/-/swagger-ui-dist-5.31.2.tgz",
-      "integrity": "sha512-uIoesCjDcxnAKj/C/HG5pjHZMQs2K/qmqpUlwLxxaVryGKlgm8Ri+VOza5xywAqf//pgg/hW16RYa6dDuTCOSg==",
+      "version": "5.32.0",
+      "resolved": "https://registry.npmjs.org/swagger-ui-dist/-/swagger-ui-dist-5.32.0.tgz",
+      "integrity": "sha512-nKZB0OuDvacB0s/lC2gbge+RigYvGRGpLLMWMFxaTUwfM+CfndVk9Th2IaTinqXiz6Mn26GK2zriCpv6/+5m3Q==",
       "license": "Apache-2.0",
       "dependencies": {
         "@scarf/scarf": "=1.4.0"
diff --git a/modules/jooby-swagger-ui/package.json b/modules/jooby-swagger-ui/package.json
index ce24a7a792..fa7244423f 100644
--- a/modules/jooby-swagger-ui/package.json
+++ b/modules/jooby-swagger-ui/package.json
@@ -4,7 +4,7 @@
   "private": true,
   "license": "ASF",
   "dependencies": {
-    "swagger-ui-dist": "^5.31.2"
+    "swagger-ui-dist": "^5.32.0"
   },
   "scarfSettings": {
     "enabled": false
diff --git a/modules/jooby-swagger-ui/pom.xml b/modules/jooby-swagger-ui/pom.xml
index 93935c2ffe..ec2c2bad84 100644
--- a/modules/jooby-swagger-ui/pom.xml
+++ b/modules/jooby-swagger-ui/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-swagger-ui</artifactId>
   <name>jooby-swagger-ui</name>
diff --git a/modules/jooby-test/pom.xml b/modules/jooby-test/pom.xml
index 0552096161..4df0a07bff 100644
--- a/modules/jooby-test/pom.xml
+++ b/modules/jooby-test/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-test</artifactId>
   <name>jooby-test</name>
diff --git a/modules/jooby-thymeleaf/pom.xml b/modules/jooby-thymeleaf/pom.xml
index 755986cba1..d50c9b2dc9 100644
--- a/modules/jooby-thymeleaf/pom.xml
+++ b/modules/jooby-thymeleaf/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-thymeleaf</artifactId>
   <name>jooby-thymeleaf</name>
diff --git a/modules/jooby-trpc/pom.xml b/modules/jooby-trpc/pom.xml
new file mode 100644
index 0000000000..f28c0a4ec7
--- /dev/null
+++ b/modules/jooby-trpc/pom.xml
@@ -0,0 +1,142 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
+
+  <modelVersion>4.0.0</modelVersion>
+
+  <parent>
+    <groupId>io.jooby</groupId>
+    <artifactId>modules</artifactId>
+    <version>4.1.0</version>
+  </parent>
+  <artifactId>jooby-trpc</artifactId>
+  <name>jooby-trpc</name>
+
+  <dependencies>
+    <dependency>
+      <groupId>io.jooby</groupId>
+      <artifactId>jooby</artifactId>
+      <version>${jooby.version}</version>
+    </dependency>
+
+    <!-- JAXRS -->
+    <dependency>
+      <groupId>jakarta.ws.rs</groupId>
+      <artifactId>jakarta.ws.rs-api</artifactId>
+    </dependency>
+
+    <dependency>
+      <groupId>io.github.classgraph</groupId>
+      <artifactId>classgraph</artifactId>
+      <version>4.8.184</version>
+    </dependency>
+
+    <dependency>
+      <groupId>cz.habarta.typescript-generator</groupId>
+      <artifactId>typescript-generator-core</artifactId>
+      <version>3.2.1263</version>
+    </dependency>
+
+    <!-- Test dependencies -->
+    <dependency>
+      <groupId>org.junit.jupiter</groupId>
+      <artifactId>junit-jupiter-engine</artifactId>
+      <scope>test</scope>
+    </dependency>
+
+    <dependency>
+      <groupId>org.jacoco</groupId>
+      <artifactId>org.jacoco.agent</artifactId>
+      <classifier>runtime</classifier>
+      <scope>test</scope>
+    </dependency>
+
+    <dependency>
+      <groupId>org.slf4j</groupId>
+      <artifactId>slf4j-simple</artifactId>
+      <version>${slf4j.version}</version>
+      <scope>test</scope>
+    </dependency>
+
+    <dependency>
+      <groupId>io.jooby</groupId>
+      <artifactId>jooby-kotlin</artifactId>
+      <version>${jooby.version}</version>
+      <scope>test</scope>
+    </dependency>
+
+    <dependency>
+      <groupId>org.jetbrains.kotlin</groupId>
+      <artifactId>kotlin-stdlib</artifactId>
+      <scope>test</scope>
+    </dependency>
+
+    <dependency>
+      <groupId>org.jetbrains.kotlin</groupId>
+      <artifactId>kotlin-reflect</artifactId>
+      <scope>test</scope>
+    </dependency>
+
+    <dependency>
+      <groupId>org.mockito</groupId>
+      <artifactId>mockito-core</artifactId>
+      <scope>test</scope>
+    </dependency>
+    <dependency>
+      <groupId>io.projectreactor</groupId>
+      <artifactId>reactor-core</artifactId>
+      <version>3.8.4</version>
+    </dependency>
+    <dependency>
+      <groupId>org.assertj</groupId>
+      <artifactId>assertj-core</artifactId>
+      <version>3.27.7</version>
+      <scope>test</scope>
+    </dependency>
+  </dependencies>
+
+  <build>
+    <plugins>
+      <plugin>
+        <groupId>org.jetbrains.kotlin</groupId>
+        <artifactId>kotlin-maven-plugin</artifactId>
+        <executions>
+          <execution>
+            <id>compile</id>
+            <phase>none</phase>
+          </execution>
+          <execution>
+            <id>test-compile</id>
+            <configuration>
+              <sourceDirs>
+                <sourceDir>${project.basedir}/src/test/kotlin</sourceDir>
+                <sourceDir>${project.basedir}/src/test/java</sourceDir>
+              </sourceDirs>
+            </configuration>
+          </execution>
+        </executions>
+      </plugin>
+
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-compiler-plugin</artifactId>
+        <version>${maven-compiler-plugin.version}</version>
+        <configuration>
+          <proc>none</proc>
+        </configuration>
+        <executions>
+          <execution>
+            <id>default-testCompile</id>
+            <phase>none</phase>
+          </execution>
+          <execution>
+            <id>java-test-compile</id>
+            <goals>
+              <goal>testCompile</goal>
+            </goals>
+            <phase>test-compile</phase>
+          </execution>
+        </executions>
+      </plugin>
+    </plugins>
+  </build>
+</project>
diff --git a/modules/jooby-trpc/src/main/java/io/jooby/trpc/TrpcGenerator.java b/modules/jooby-trpc/src/main/java/io/jooby/trpc/TrpcGenerator.java
new file mode 100644
index 0000000000..0052180766
--- /dev/null
+++ b/modules/jooby-trpc/src/main/java/io/jooby/trpc/TrpcGenerator.java
@@ -0,0 +1,748 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.trpc;
+
+import java.io.IOException;
+import java.lang.annotation.Annotation;
+import java.lang.reflect.AnnotatedElement;
+import java.lang.reflect.Method;
+import java.lang.reflect.ParameterizedType;
+import java.lang.reflect.Type;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.nio.file.StandardOpenOption;
+import java.util.ArrayList;
+import java.util.LinkedHashMap;
+import java.util.LinkedHashSet;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+import cz.habarta.typescript.generator.DateMapping;
+import cz.habarta.typescript.generator.EnumMapping;
+import cz.habarta.typescript.generator.Input;
+import cz.habarta.typescript.generator.JsonLibrary;
+import cz.habarta.typescript.generator.Output;
+import cz.habarta.typescript.generator.Settings;
+import cz.habarta.typescript.generator.TypeScriptFileType;
+import cz.habarta.typescript.generator.TypeScriptGenerator;
+import cz.habarta.typescript.generator.TypeScriptOutputKind;
+import io.github.classgraph.ClassGraph;
+
+/**
+ * A generator that orchestrates {@code typescript-generator} to produce a tRPC-compatible
+ * TypeScript API definition from compiled Jooby controllers.
+ *
+ * <p>This tool bypasses the standard REST scanner of {@code typescript-generator}. Instead, it:
+ *
+ * <ol>
+ *   <li>Scans the classpath via the provided ClassLoader for controllers marked with {@code @Trpc}.
+ *   <li>Extracts only the input and return types (DTOs) of the matching methods.
+ *   <li>Feeds those data models to the generator to produce clean TypeScript interfaces.
+ *   <li>Uses a fast, recursive type resolver to accurately map Java methods to tRPC {@code { input,
+ *       output }} shapes.
+ *   <li>Appends a strict {@code AppRouter} definition to the generated file.
+ * </ol>
+ */
+public class TrpcGenerator {
+
+  private static final Set<String> WRAPPERS =
+      Set.of(
+          // Protocol Envelope
+          "io.jooby.trpc.TrpcResponse",
+          // JDK Async
+          "java.util.concurrent.CompletableFuture",
+          "java.util.concurrent.CompletionStage",
+          "java.util.concurrent.Future",
+          // Reactor
+          "reactor.core.publisher.Mono",
+          "reactor.core.publisher.Flux",
+          // Mutiny
+          "io.smallrye.mutiny.Uni",
+          "io.smallrye.mutiny.Multi",
+          // RxJava 2 & 3
+          "io.reactivex.Single",
+          "io.reactivex.Maybe",
+          "io.reactivex.Observable",
+          "io.reactivex.Flowable",
+          "io.reactivex.Completable",
+          "io.reactivex.rxjava3.core.Single",
+          "io.reactivex.rxjava3.core.Maybe",
+          "io.reactivex.rxjava3.core.Observable",
+          "io.reactivex.rxjava3.core.Flowable",
+          "io.reactivex.rxjava3.core.Completable");
+
+  private final Logger log = LoggerFactory.getLogger(getClass());
+
+  private ClassLoader classLoader = getClass().getClassLoader();
+  private Path outputDir;
+  private String outputFile = "trpc.d.ts";
+
+  private final Set<Class<?>> manualControllers = new LinkedHashSet<>();
+
+  private JsonLibrary jsonLibrary = JsonLibrary.jackson2;
+  private Map<String, String> customTypeMappings = new LinkedHashMap<>();
+  private Map<String, String> customTypeNaming = new LinkedHashMap<>();
+  private List<String> importDeclarations = new ArrayList<>();
+  private DateMapping mapDate = DateMapping.asString;
+  private EnumMapping mapEnum = EnumMapping.asInlineUnion;
+
+  /**
+   * Executes the full TypeScript and tRPC generation pipeline.
+   *
+   * @throws IOException If an I/O error occurs reading classes or writing the output file.
+   * @throws IllegalStateException If {@code outputDir} is not configured or if no controllers are
+   *     found.
+   */
+  public void generate() throws IOException {
+    if (outputDir == null) {
+      throw new IllegalStateException("outputDir is required to generate the TypeScript file.");
+    }
+
+    var finalOutput = outputDir.resolve(outputFile);
+    if (!Files.exists(outputDir)) {
+      Files.createDirectories(outputDir);
+    }
+
+    var controllers = discoverControllers();
+    controllers.addAll(manualControllers);
+
+    if (controllers.isEmpty()) {
+      throw new IllegalStateException(
+          "No controllers were found to generate. "
+              + "Ensure the 'classLoader' has access to compiled classes, "
+              + "or use 'addController(Class)' to manually register controllers for unit testing.");
+    }
+
+    // 1. Extract ONLY the Data Models (Inputs/Outputs)
+    var typesToGenerate = new LinkedHashSet<Type>();
+    for (var controller : controllers) {
+      for (var method : controller.getDeclaredMethods()) {
+        if (isTrpcAnnotated(method)) {
+          addTypeToGenerate(typesToGenerate, method.getGenericReturnType());
+          for (var param : method.getGenericParameterTypes()) {
+            String typeName = param.getTypeName();
+            if (!typeName.equals("io.jooby.Context")
+                && !typeName.startsWith("kotlin.coroutines.Continuation")) {
+              addTypeToGenerate(typesToGenerate, param);
+            }
+          }
+        }
+      }
+    }
+
+    var settings = new Settings();
+    settings.outputFileType = TypeScriptFileType.declarationFile;
+    settings.outputKind = TypeScriptOutputKind.module;
+    settings.classLoader = classLoader;
+    settings.jsonLibrary = this.jsonLibrary;
+    settings.mapDate = this.mapDate;
+    settings.mapEnum = this.mapEnum;
+    if (customTypeMappings != null) settings.customTypeMappings.putAll(customTypeMappings);
+    if (customTypeNaming != null) settings.customTypeNaming.putAll(customTypeNaming);
+    if (importDeclarations != null) settings.importDeclarations.addAll(importDeclarations);
+
+    // 2. Generate standard interfaces (DTOs only)
+    if (!typesToGenerate.isEmpty()) {
+      TypeScriptGenerator.setLogger(asSlf4j(log));
+
+      /// FIREWALL: Force the generator to ignore all reactive wrappers if discovered indirectly.
+      // typescript-generator strictly demands exact generic signatures (e.g. Future<V>).
+      // We dynamically append the type variables using reflection to satisfy its parser.
+      for (var wrapper : WRAPPERS) {
+        try {
+          var clazz = Class.forName(wrapper, false, classLoader);
+          var key = new StringBuilder(wrapper);
+          var typeParams = clazz.getTypeParameters();
+
+          if (typeParams.length > 0) {
+            key.append("<");
+            for (int i = 0; i < typeParams.length; i++) {
+              if (i > 0) key.append(", ");
+              key.append(typeParams[i].getName());
+            }
+            key.append(">");
+          }
+
+          settings.customTypeMappings.put(key.toString(), "any");
+        } catch (ClassNotFoundException | NoClassDefFoundError ignored) {
+          // Class not on classpath, safe to ignore
+        }
+      }
+
+      var generator = new TypeScriptGenerator(settings);
+      var input = Input.from(typesToGenerate.toArray(new Type[0]));
+      generator.generateTypeScript(input, Output.to(finalOutput.toFile()));
+    }
+
+    // Safety net: If typescript-generator skipped generation (e.g., only primitive types), create
+    // the base file.
+    if (!Files.exists(finalOutput)) {
+      Files.writeString(finalOutput, "/* tslint:disable */\n/* eslint-disable */\n\n");
+    }
+
+    // 3. Append the exact tRPC AppRouter
+    appendTrpcRouter(finalOutput, controllers);
+  }
+
+  private static cz.habarta.typescript.generator.Logger asSlf4j(Logger log) {
+    return new cz.habarta.typescript.generator.Logger() {
+      @Override
+      protected void write(Level level, String message) {
+        switch (level) {
+          case Info -> log.info(message);
+          case Warning -> log.warn(message.replace("Warning: ", ""));
+          case Error -> log.error(message.replace("Error: ", ""));
+          case Debug -> log.debug(message.replace("Debug: ", ""));
+          case Verbose -> log.trace(message);
+        }
+      }
+    };
+  }
+
+  private void addTypeToGenerate(Set<Type> types, Type type) {
+    if (type == void.class || type == Void.class) return;
+
+    if (type instanceof ParameterizedType pt) {
+      var rawName = pt.getRawType().getTypeName();
+
+      // Unwrap async and protocol wrapper types
+      if (WRAPPERS.contains(rawName) && pt.getActualTypeArguments().length > 0) {
+        addTypeToGenerate(types, pt.getActualTypeArguments()[0]);
+        return;
+      }
+
+      // Decompose standard generic types to ensure inner DTOs are discovered safely
+      addTypeToGenerate(types, pt.getRawType());
+      for (Type arg : pt.getActualTypeArguments()) {
+        addTypeToGenerate(types, arg);
+      }
+      return;
+    } else if (type instanceof Class<?> clazz) {
+      // Ignore bare async types (like RxJava Completable) that signify void
+      if (WRAPPERS.contains(clazz.getName())) return;
+
+      if (clazz.isArray()) {
+        addTypeToGenerate(types, clazz.getComponentType());
+        return;
+      }
+    } else if (type instanceof java.lang.reflect.WildcardType wt) {
+      for (Type bound : wt.getUpperBounds()) {
+        if (bound != Object.class) addTypeToGenerate(types, bound);
+      }
+      return;
+    } else if (type instanceof java.lang.reflect.GenericArrayType gat) {
+      addTypeToGenerate(types, gat.getGenericComponentType());
+      return;
+    }
+
+    types.add(type);
+  }
+
+  /**
+   * Constructs and appends the tRPC {@code AppRouter} mapping to the bottom of the generated file.
+   *
+   * @param finalOutput The path to the generated output file.
+   * @param controllers The set of validated controller classes.
+   * @throws IOException If file writing fails.
+   */
+  private void appendTrpcRouter(Path finalOutput, Set<Class<?>> controllers) throws IOException {
+    var ts = new StringBuilder();
+
+    ts.append("\n// --- tRPC Router Mapping ---\n\n");
+    ts.append("export type AppRouter = {\n");
+
+    // 1. Group by namespace using a TreeMap to guarantee deterministic alphabetical order
+    Map<String, List<Method>> namespaces = new java.util.TreeMap<>();
+
+    for (var controller : controllers) {
+      var namespace = extractNamespace(controller);
+      String key = namespace == null ? "" : namespace;
+
+      namespaces.computeIfAbsent(key, k -> new ArrayList<>());
+
+      for (var method : controller.getDeclaredMethods()) {
+        if (isTrpcAnnotated(method)) {
+          namespaces.get(key).add(method);
+        }
+      }
+    }
+
+    // 2. Generate the TypeScript output
+    for (var entry : namespaces.entrySet()) {
+      String namespace = entry.getKey();
+      List<Method> methods = entry.getValue();
+
+      if (methods.isEmpty()) continue;
+
+      String indent = "  ";
+      if (!namespace.isEmpty()) {
+        ts.append("  ").append(namespace).append(": {\n");
+        indent = "    ";
+      }
+
+      // Separate into queries and mutations for deterministic grouping
+      List<Method> queries = new ArrayList<>();
+      List<Method> mutations = new ArrayList<>();
+
+      for (Method m : methods) {
+        if (isMutation(m)) {
+          mutations.add(m);
+        } else {
+          queries.add(m);
+        }
+      }
+
+      // Sort alphabetically by procedure name to prevent reflection-order test flakiness
+      java.util.Comparator<Method> byName = java.util.Comparator.comparing(this::getProcedureName);
+      queries.sort(byName);
+      mutations.sort(byName);
+
+      if (!queries.isEmpty()) {
+        ts.append(indent).append("// queries\n");
+        for (Method method : queries) {
+          appendProcedure(ts, indent, method);
+        }
+      }
+
+      if (!mutations.isEmpty()) {
+        if (!queries.isEmpty()) ts.append("\n"); // Add a blank line between groups if both exist
+        ts.append(indent).append("// mutations\n");
+        for (Method method : mutations) {
+          appendProcedure(ts, indent, method);
+        }
+      }
+
+      if (!namespace.isEmpty()) {
+        ts.append("  };\n");
+      }
+    }
+
+    ts.append("};\n");
+    Files.writeString(finalOutput, ts.toString(), StandardOpenOption.APPEND);
+  }
+
+  private void appendProcedure(StringBuilder ts, String indent, Method method) {
+    // Filter out framework parameters so they don't appear in the TypeScript signature
+    var payloadParams = new ArrayList<Type>();
+    for (var p : method.getGenericParameterTypes()) {
+      String typeName = p.getTypeName();
+      if (!typeName.equals("io.jooby.Context")
+          && !typeName.startsWith("kotlin.coroutines.Continuation")) {
+        payloadParams.add(p);
+      }
+    }
+
+    String tsInput = "void";
+    if (payloadParams.size() == 1) {
+      tsInput = resolveTsType(payloadParams.get(0));
+    } else if (payloadParams.size() > 1) {
+      var tuple = new ArrayList<String>();
+      for (var p : payloadParams) tuple.add(resolveTsType(p));
+      tsInput = "[" + String.join(", ", tuple) + "]";
+    }
+
+    String tsOutput = resolveTsType(method.getGenericReturnType());
+    String procedureName = getProcedureName(method);
+
+    ts.append(indent)
+        .append(procedureName)
+        .append(": { input: ")
+        .append(tsInput)
+        .append("; ")
+        .append("output: ")
+        .append(tsOutput)
+        .append(" };\n");
+  }
+
+  private boolean isMutation(Method method) {
+    // 1. Explicit tRPC mutation annotation
+    if (getAnnotation(method, "io.jooby.annotation.Trpc$Mutation") != null) {
+      return true;
+    }
+    // 2. Explicit tRPC query annotation
+    if (getAnnotation(method, "io.jooby.annotation.Trpc$Query") != null) {
+      return false;
+    }
+
+    // 3. Base @Trpc combined with standard HTTP mutation annotations
+    String[] httpMutations = {
+      "io.jooby.annotation.POST", "io.jooby.annotation.PUT",
+      "io.jooby.annotation.PATCH", "io.jooby.annotation.DELETE",
+      "jakarta.ws.rs.POST", "jakarta.ws.rs.PUT",
+      "jakarta.ws.rs.PATCH", "jakarta.ws.rs.DELETE",
+      "javax.ws.rs.POST", "javax.ws.rs.PUT",
+      "javax.ws.rs.PATCH", "javax.ws.rs.DELETE"
+    };
+
+    for (String ann : httpMutations) {
+      if (getAnnotation(method, ann) != null) {
+        return true;
+      }
+    }
+
+    return false; // Default to query
+  }
+
+  /**
+   * Fast, recursive type resolver to map Java types directly to TypeScript signatures. Understands
+   * Jooby async types, standard collections, and primitive mappings.
+   *
+   * @param type The Java type to evaluate.
+   * @return A valid TypeScript string representation of the type.
+   */
+  private String resolveTsType(Type type) {
+    if (type == void.class || type == Void.class) return "void";
+
+    if (type instanceof ParameterizedType pt) {
+      var raw = pt.getRawType();
+      var rawName = raw.getTypeName();
+
+      // Unwrap async and protocol wrapper types
+      if (WRAPPERS.contains(rawName) && pt.getActualTypeArguments().length > 0) {
+        return resolveTsType(pt.getActualTypeArguments()[0]);
+      }
+
+      if (raw instanceof Class<?> clazz) {
+        if (java.util.Collection.class.isAssignableFrom(clazz)) {
+          return resolveTsType(pt.getActualTypeArguments()[0]) + "[]";
+        }
+        if (java.util.Map.class.isAssignableFrom(clazz)) {
+          return "{ [index: string]: " + resolveTsType(pt.getActualTypeArguments()[1]) + " }";
+        }
+        if (java.util.Optional.class.isAssignableFrom(clazz)) {
+          return resolveTsType(pt.getActualTypeArguments()[0]) + " | null";
+        }
+
+        // Handle generic DTOs
+        var args = pt.getActualTypeArguments();
+        var tsArgs = new ArrayList<String>();
+        for (var arg : args) tsArgs.add(resolveTsType(arg));
+        return getClassName(clazz) + "<" + String.join(", ", tsArgs) + ">";
+      }
+    }
+
+    if (type instanceof java.lang.reflect.WildcardType wt) {
+      if (wt.getUpperBounds().length > 0 && wt.getUpperBounds()[0] != Object.class) {
+        return resolveTsType(wt.getUpperBounds()[0]);
+      }
+      return "any";
+    }
+
+    if (type instanceof java.lang.reflect.GenericArrayType gat) {
+      return resolveTsType(gat.getGenericComponentType()) + "[]";
+    }
+
+    if (type instanceof Class<?> clazz) {
+      if (clazz.isArray()) {
+        if (clazz.getComponentType() == byte.class)
+          return "string"; // Common byte[] to base64 string
+        return resolveTsType(clazz.getComponentType()) + "[]";
+      }
+
+      // Handle bare async types (like RxJava Completable) as void returns
+      if (WRAPPERS.contains(clazz.getName())) return "void";
+
+      if (clazz == String.class
+          || clazz == char.class
+          || clazz == Character.class
+          || clazz.getName().equals("java.util.UUID")) return "string";
+      if (clazz == boolean.class || clazz == Boolean.class) return "boolean";
+      if (Number.class.isAssignableFrom(clazz) || clazz.isPrimitive()) return "number";
+
+      if (java.util.Date.class.isAssignableFrom(clazz)
+          || clazz.getName().startsWith("java.time.")) {
+        return mapDate == DateMapping.asString
+            ? "string"
+            : (mapDate == DateMapping.asNumber ? "number" : "Date");
+      }
+
+      return getClassName(clazz);
+    }
+
+    return "any";
+  }
+
+  /**
+   * Evaluates the custom mappings to determine the appropriate TypeScript interface name.
+   *
+   * @param clazz The Java class being resolved.
+   * @return The target TypeScript interface name.
+   */
+  private String getClassName(Class<?> clazz) {
+    var fqn = clazz.getName();
+    if (customTypeMappings != null && customTypeMappings.containsKey(fqn)) {
+      return customTypeMappings.get(fqn);
+    }
+    if (customTypeNaming != null && customTypeNaming.containsKey(fqn)) {
+      return customTypeNaming.get(fqn);
+    }
+    return clazz.getSimpleName();
+  }
+
+  /**
+   * Scans the classloader to load and validate controller classes.
+   *
+   * @return A set of valid controller classes found on disk.
+   */
+  private Set<Class<?>> discoverControllers() {
+    var controllers = new LinkedHashSet<Class<?>>();
+
+    var classGraph =
+        new ClassGraph()
+            .enableClassInfo()
+            .enableAnnotationInfo()
+            .enableMethodInfo()
+            .ignoreClassVisibility();
+
+    if (classLoader != null) {
+      classGraph.overrideClassLoaders(classLoader);
+    }
+
+    try (var scanResult = classGraph.scan()) {
+      for (var classInfo : scanResult.getAllClasses()) {
+        try {
+          var clazz = classInfo.loadClass(false); // loads without initializing!
+
+          if (isTrpcAnnotated(clazz)) {
+            controllers.add(clazz);
+          } else {
+            // Check methods if the class itself isn't annotated
+            for (var method : clazz.getDeclaredMethods()) {
+              if (isTrpcAnnotated(method)) {
+                controllers.add(clazz);
+                break;
+              }
+            }
+          }
+        } catch (Throwable ignored) {
+          // Safely ignore classes that throw LinkageError or NoClassDefFoundError
+        }
+      }
+    }
+
+    return controllers;
+  }
+
+  /** Retrieves an annotation safely, supporting nested annotation syntax differences. */
+  private Annotation getAnnotation(AnnotatedElement element, String annotationName) {
+    for (Annotation a : element.getAnnotations()) {
+      String name = a.annotationType().getName();
+      if (name.equals(annotationName)
+          || name.replace('$', '.').equals(annotationName.replace('$', '.'))) {
+        return a;
+      }
+    }
+    return null;
+  }
+
+  /**
+   * ClassLoader-agnostic check to see if an element has a Trpc annotation. Matches the APT
+   * precedence.
+   *
+   * @param element The class or method to inspect.
+   * @return True if annotated with `@Trpc`, `@Trpc.Query`, or `@Trpc.Mutation`.
+   */
+  private boolean isTrpcAnnotated(AnnotatedElement element) {
+    return getAnnotation(element, "io.jooby.annotation.Trpc") != null
+        || getAnnotation(element, "io.jooby.annotation.Trpc$Query") != null
+        || getAnnotation(element, "io.jooby.annotation.Trpc$Mutation") != null;
+  }
+
+  /**
+   * Evaluates the exact tRPC procedure name based on annotation values, defaulting to the method
+   * name. Respects the precedence hierarchy: .Query / .Mutation > Base @Trpc.
+   */
+  private String getProcedureName(Method method) {
+    String[] procedureAnnotations = {
+      "io.jooby.annotation.Trpc$Query",
+      "io.jooby.annotation.Trpc$Mutation",
+      "io.jooby.annotation.Trpc"
+    };
+
+    for (String annName : procedureAnnotations) {
+      Annotation a = getAnnotation(method, annName);
+      if (a != null) {
+        try {
+          var valueMethod = a.annotationType().getMethod("value");
+          var value = (String) valueMethod.invoke(a);
+          if (value != null && !value.isBlank()) {
+            return value;
+          }
+        } catch (Exception ignored) {
+        }
+      }
+    }
+    return method.getName();
+  }
+
+  /**
+   * Extracts the target namespace for the tRPC router based on the controller. If the class is not
+   * annotated with @Trpc, or if its value is empty, it returns null (indicating the methods belong
+   * to the root namespace).
+   *
+   * @param controller The controller class.
+   * @return The determined namespace string, or null for root-level.
+   */
+  private String extractNamespace(Class<?> controller) {
+    Annotation trpc = getAnnotation(controller, "io.jooby.annotation.Trpc");
+    if (trpc != null) {
+      try {
+        var method = trpc.annotationType().getMethod("value");
+        var value = (String) method.invoke(trpc);
+        if (value != null && !value.isBlank()) {
+          return value;
+        }
+      } catch (Exception ignored) {
+      }
+    }
+    return null; // Root namespace
+  }
+
+  // --- Configuration API (Getters, Setters, and Builders) ---
+
+  /**
+   * Explicitly adds a controller class to the generation pipeline. Highly recommended for unit
+   * testing to avoid classpath scanning issues.
+   *
+   * @param controller The controller class to analyze.
+   */
+  public void addController(Class<?> controller) {
+    this.manualControllers.add(controller);
+  }
+
+  /**
+   * @return The class loader used to load compiled controllers.
+   */
+  public ClassLoader getClassLoader() {
+    return classLoader;
+  }
+
+  /**
+   * @param classLoader The class loader used to load compiled controllers. Defaults to context
+   *     class loader.
+   */
+  public void setClassLoader(ClassLoader classLoader) {
+    if (classLoader != null) this.classLoader = classLoader;
+  }
+
+  /**
+   * @return The destination directory for the generated TypeScript file.
+   */
+  public Path getOutputDir() {
+    return outputDir;
+  }
+
+  /**
+   * @param outputDir The destination directory for the generated TypeScript file.
+   */
+  public void setOutputDir(Path outputDir) {
+    this.outputDir = outputDir;
+  }
+
+  /**
+   * @return The name of the generated TypeScript file.
+   */
+  public String getOutputFile() {
+    return outputFile;
+  }
+
+  /**
+   * @param outputFile The name of the generated TypeScript file. Defaults to {@code trpc.d.ts}.
+   */
+  public void setOutputFile(String outputFile) {
+    if (outputFile != null && !outputFile.isBlank()) this.outputFile = outputFile;
+  }
+
+  /**
+   * @return The target JSON library for data model generation.
+   */
+  public JsonLibrary getJsonLibrary() {
+    return jsonLibrary;
+  }
+
+  /**
+   * @param jsonLibrary The target JSON library used to parse field annotations. Defaults to Jackson
+   *     2.
+   */
+  public void setJsonLibrary(JsonLibrary jsonLibrary) {
+    if (jsonLibrary != null) this.jsonLibrary = jsonLibrary;
+  }
+
+  /**
+   * @return Custom mapping overrides translating Java types to raw TypeScript strings.
+   */
+  public Map<String, String> getCustomTypeMappings() {
+    return customTypeMappings;
+  }
+
+  /**
+   * @param customTypeMappings Custom mapping overrides translating Java types to raw TypeScript
+   *     strings.
+   */
+  public void setCustomTypeMappings(Map<String, String> customTypeMappings) {
+    this.customTypeMappings = customTypeMappings;
+  }
+
+  /**
+   * @return Custom overrides for generating specific TypeScript interface names.
+   */
+  public Map<String, String> getCustomTypeNaming() {
+    return customTypeNaming;
+  }
+
+  /**
+   * @param customTypeNaming Custom overrides for generating specific TypeScript interface names.
+   */
+  public void setCustomTypeNaming(Map<String, String> customTypeNaming) {
+    this.customTypeNaming = customTypeNaming;
+  }
+
+  /**
+   * @return Raw import statements appended to the top of the generated file.
+   */
+  public List<String> getImportDeclarations() {
+    return importDeclarations;
+  }
+
+  /**
+   * @param importDeclarations Raw import statements appended to the top of the generated file.
+   */
+  public void setImportDeclarations(List<String> importDeclarations) {
+    this.importDeclarations = importDeclarations;
+  }
+
+  /**
+   * @return The mapping strategy applied to Java date types.
+   */
+  public DateMapping getMapDate() {
+    return mapDate;
+  }
+
+  /**
+   * @param mapDate The mapping strategy applied to Java date types.
+   */
+  public void setMapDate(DateMapping mapDate) {
+    this.mapDate = mapDate;
+  }
+
+  /**
+   * @return The mapping strategy applied to Java enum types.
+   */
+  public EnumMapping getMapEnum() {
+    return mapEnum;
+  }
+
+  /**
+   * @param mapEnum The mapping strategy applied to Java enum types.
+   */
+  public void setMapEnum(EnumMapping mapEnum) {
+    this.mapEnum = mapEnum;
+  }
+}
diff --git a/modules/jooby-trpc/src/test/java/io/jooby/trpc/i3863/C3863.java b/modules/jooby-trpc/src/test/java/io/jooby/trpc/i3863/C3863.java
new file mode 100644
index 0000000000..1c7347cfa2
--- /dev/null
+++ b/modules/jooby-trpc/src/test/java/io/jooby/trpc/i3863/C3863.java
@@ -0,0 +1,45 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.trpc.i3863;
+
+import java.util.concurrent.CompletableFuture;
+
+import io.jooby.Context;
+import io.jooby.annotation.*;
+import reactor.core.publisher.Mono;
+
+@Path("/users")
+@Trpc("users") // Custom namespace
+public class C3863 {
+
+  @GET("/{id}")
+  @Trpc
+  public U3863 getUser(Context ctx, String id) {
+    return new U3863(id, "user");
+  }
+
+  @POST
+  @Trpc
+  public U3863 createUser(U3863 user) {
+    return user;
+  }
+
+  @PUT
+  @Trpc
+  public CompletableFuture<U3863> createFuture(U3863 user) {
+    return CompletableFuture.completedFuture(user);
+  }
+
+  @Trpc.Mutation
+  public Mono<U3863> createMono(U3863 user) {
+    return Mono.just(user);
+  }
+
+  @GET("/internal")
+  public String internalEndpoint() {
+    return "This should not be exposed to tRPC";
+  }
+}
diff --git a/modules/jooby-trpc/src/test/java/io/jooby/trpc/i3863/TrpcGeneratorTest.java b/modules/jooby-trpc/src/test/java/io/jooby/trpc/i3863/TrpcGeneratorTest.java
new file mode 100644
index 0000000000..2d4174e373
--- /dev/null
+++ b/modules/jooby-trpc/src/test/java/io/jooby/trpc/i3863/TrpcGeneratorTest.java
@@ -0,0 +1,71 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.trpc.i3863;
+
+import static org.assertj.core.api.Assertions.assertThat;
+import static org.junit.jupiter.api.Assertions.*;
+
+import java.nio.file.Files;
+import java.nio.file.Paths;
+
+import org.junit.jupiter.api.Test;
+
+import io.jooby.trpc.TrpcGenerator;
+
+class TrpcGeneratorTest {
+
+  @Test
+  void shouldGenerateTrpcRouterAndModels() throws Exception {
+    var generator = new TrpcGenerator();
+    var outputDir = Paths.get("target");
+
+    // Dynamically locate the test-classes directory where the sample is compiled
+    var testClassesDir =
+        Paths.get(C3863.class.getProtectionDomain().getCodeSource().getLocation().toURI());
+
+    generator.setOutputDir(outputDir);
+    generator.setOutputFile("api.d.ts");
+
+    generator.generate();
+
+    var outputFile = outputDir.resolve("api.d.ts");
+    assertTrue(Files.exists(outputFile), "TypeScript file should be generated");
+
+    var actualContent = Files.readString(outputFile);
+
+    var expectedContent =
+        """
+        /* tslint:disable */
+        /* eslint-disable */
+
+        export interface U3863 {
+            id: string;
+            name: string;
+        }
+
+        // --- tRPC Router Mapping ---
+
+        export type AppRouter = {
+          users: {
+            // queries
+            getUser: { input: string; output: U3863 };
+
+            // mutations
+            createFuture: { input: U3863; output: U3863 };
+            createMono: { input: U3863; output: U3863 };
+            createUser: { input: U3863; output: U3863 };
+          };
+        };
+        """;
+
+    // Strip out the dynamic timestamp comment line
+    var cleanActual =
+        actualContent.replaceAll("// Generated using typescript-generator.*\\r?\\n", "");
+
+    // Assert with normalized newlines to avoid \r\n vs \n test flakes
+    assertThat(cleanActual).isEqualToNormalizingNewlines(expectedContent);
+  }
+}
diff --git a/modules/jooby-trpc/src/test/java/io/jooby/trpc/i3863/U3863.java b/modules/jooby-trpc/src/test/java/io/jooby/trpc/i3863/U3863.java
new file mode 100644
index 0000000000..55d1467b37
--- /dev/null
+++ b/modules/jooby-trpc/src/test/java/io/jooby/trpc/i3863/U3863.java
@@ -0,0 +1,8 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.trpc.i3863;
+
+public record U3863(String id, String name) {}
diff --git a/modules/jooby-undertow/pom.xml b/modules/jooby-undertow/pom.xml
index 99493b903f..25c1004e2b 100644
--- a/modules/jooby-undertow/pom.xml
+++ b/modules/jooby-undertow/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-undertow</artifactId>
   <name>jooby-undertow</name>
diff --git a/modules/jooby-undertow/src/main/java/io/jooby/internal/undertow/UndertowGrpcExchange.java b/modules/jooby-undertow/src/main/java/io/jooby/internal/undertow/UndertowGrpcExchange.java
new file mode 100644
index 0000000000..b2508f2511
--- /dev/null
+++ b/modules/jooby-undertow/src/main/java/io/jooby/internal/undertow/UndertowGrpcExchange.java
@@ -0,0 +1,173 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.internal.undertow;
+
+import java.io.IOException;
+import java.nio.ByteBuffer;
+import java.util.HashMap;
+import java.util.Map;
+import java.util.function.Consumer;
+
+import org.xnio.channels.StreamSinkChannel;
+
+import io.jooby.rpc.grpc.GrpcExchange;
+import io.undertow.server.HttpServerExchange;
+import io.undertow.server.protocol.http.HttpAttachments;
+import io.undertow.util.HeaderMap;
+import io.undertow.util.HeaderValues;
+import io.undertow.util.Headers;
+import io.undertow.util.HttpString;
+
+public class UndertowGrpcExchange implements GrpcExchange {
+
+  private final HttpServerExchange exchange;
+  private boolean headersSent = false;
+  private StreamSinkChannel responseChannel;
+
+  public UndertowGrpcExchange(HttpServerExchange exchange) {
+    this.exchange = exchange;
+  }
+
+  @Override
+  public String getRequestPath() {
+    return exchange.getRequestPath();
+  }
+
+  @Override
+  public String getHeader(String name) {
+    return exchange.getRequestHeaders().getFirst(name);
+  }
+
+  @Override
+  public Map<String, String> getHeaders() {
+    Map<String, String> map = new HashMap<>();
+    for (HeaderValues values : exchange.getRequestHeaders()) {
+      map.put(values.getHeaderName().toString(), values.getFirst());
+    }
+    return map;
+  }
+
+  @Override
+  public void send(ByteBuffer payload, Consumer<Throwable> callback) {
+    if (!headersSent) {
+      exchange.getResponseHeaders().put(Headers.CONTENT_TYPE, "application/grpc");
+      this.responseChannel = exchange.getResponseChannel();
+      headersSent = true;
+    }
+
+    // Write and immediately flush to prevent bidirectional deadlocks
+    doWriteAndFlush(payload, callback);
+  }
+
+  private void doWriteAndFlush(ByteBuffer payload, Consumer<Throwable> callback) {
+    try {
+      int res = responseChannel.write(payload);
+
+      if (payload.hasRemaining()) {
+        // Wait for socket to become writable
+        responseChannel
+            .getWriteSetter()
+            .set(
+                ch -> {
+                  try {
+                    ch.write(payload);
+                    if (!payload.hasRemaining()) {
+                      ch.suspendWrites();
+                      doFlush(callback); // Proceed to flush
+                    }
+                  } catch (IOException e) {
+                    ch.suspendWrites();
+                    callback.accept(e);
+                  }
+                });
+        responseChannel.resumeWrites();
+      } else {
+        // Written fully, proceed to flush immediately
+        doFlush(callback);
+      }
+    } catch (IOException e) {
+      callback.accept(e);
+    }
+  }
+
+  private void doFlush(Consumer<Throwable> callback) {
+    try {
+      if (responseChannel.flush()) {
+        callback.accept(null); // Fully flushed to network
+      } else {
+        // Wait for socket to become flushable
+        responseChannel
+            .getWriteSetter()
+            .set(
+                ch -> {
+                  try {
+                    if (ch.flush()) {
+                      ch.suspendWrites();
+                      callback.accept(null);
+                    }
+                  } catch (IOException e) {
+                    ch.suspendWrites();
+                    callback.accept(e);
+                  }
+                });
+        responseChannel.resumeWrites();
+      }
+    } catch (IOException e) {
+      callback.accept(e);
+    }
+  }
+
+  @Override
+  public void close(int statusCode, String description) {
+    if (headersSent) {
+      exchange.putAttachment(
+          HttpAttachments.RESPONSE_TRAILER_SUPPLIER,
+          () -> {
+            HeaderMap trailers = new HeaderMap();
+            trailers.put(HttpString.tryFromString("grpc-status"), String.valueOf(statusCode));
+            if (description != null) {
+              trailers.put(HttpString.tryFromString("grpc-message"), description);
+            }
+            return trailers;
+          });
+
+      try {
+        responseChannel.shutdownWrites();
+        if (!responseChannel.flush()) {
+          responseChannel
+              .getWriteSetter()
+              .set(
+                  ch -> {
+                    try {
+                      if (ch.flush()) {
+                        ch.suspendWrites();
+                        exchange.endExchange();
+                      }
+                    } catch (IOException ignored) {
+                      ch.suspendWrites();
+                      exchange.endExchange();
+                    }
+                  });
+          responseChannel.resumeWrites();
+        } else {
+          exchange.endExchange();
+        }
+      } catch (IOException e) {
+        exchange.endExchange();
+      }
+
+    } else {
+      exchange.getResponseHeaders().put(Headers.CONTENT_TYPE, "application/grpc");
+      exchange
+          .getResponseHeaders()
+          .put(HttpString.tryFromString("grpc-status"), String.valueOf(statusCode));
+      if (description != null) {
+        exchange.getResponseHeaders().put(HttpString.tryFromString("grpc-message"), description);
+      }
+      exchange.endExchange();
+    }
+  }
+}
diff --git a/modules/jooby-undertow/src/main/java/io/jooby/internal/undertow/UndertowGrpcHandler.java b/modules/jooby-undertow/src/main/java/io/jooby/internal/undertow/UndertowGrpcHandler.java
new file mode 100644
index 0000000000..2d2144178f
--- /dev/null
+++ b/modules/jooby-undertow/src/main/java/io/jooby/internal/undertow/UndertowGrpcHandler.java
@@ -0,0 +1,54 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.internal.undertow;
+
+import io.jooby.rpc.grpc.GrpcProcessor;
+import io.undertow.server.HttpHandler;
+import io.undertow.server.HttpServerExchange;
+import io.undertow.util.Headers;
+import io.undertow.util.Protocols;
+
+public class UndertowGrpcHandler implements HttpHandler {
+
+  private final HttpHandler next;
+  private final GrpcProcessor processor;
+
+  public UndertowGrpcHandler(HttpHandler next, GrpcProcessor processor) {
+    this.next = next;
+    this.processor = processor;
+  }
+
+  @Override
+  public void handleRequest(HttpServerExchange exchange) throws Exception {
+    var contentType = exchange.getRequestHeaders().getFirst(Headers.CONTENT_TYPE);
+
+    if (processor.isGrpcMethod(exchange.getRequestPath())
+        && contentType != null
+        && contentType.startsWith("application/grpc")) {
+
+      // gRPC strictly requires HTTP/2
+      if (!exchange.getProtocol().equals(Protocols.HTTP_2_0)) {
+        exchange.setStatusCode(426); // Upgrade Required
+        exchange.getResponseHeaders().put(Headers.CONNECTION, "Upgrade");
+        exchange.getResponseHeaders().put(Headers.UPGRADE, "h2c");
+        exchange.endExchange();
+        return;
+      }
+
+      var grpcExchange = new UndertowGrpcExchange(exchange);
+      var subscriber = processor.process(grpcExchange);
+
+      // Starts the reactive pipeline and acquires the XNIO channel
+      var inputBridge = new UndertowGrpcInputBridge(exchange, subscriber);
+      inputBridge.start();
+
+      return; // Fully handled, do not pass to the standard router
+    }
+
+    // Not a gRPC request, delegate to the next handler in the chain
+    next.handleRequest(exchange);
+  }
+}
diff --git a/modules/jooby-undertow/src/main/java/io/jooby/internal/undertow/UndertowGrpcInputBridge.java b/modules/jooby-undertow/src/main/java/io/jooby/internal/undertow/UndertowGrpcInputBridge.java
new file mode 100644
index 0000000000..84d05a0293
--- /dev/null
+++ b/modules/jooby-undertow/src/main/java/io/jooby/internal/undertow/UndertowGrpcInputBridge.java
@@ -0,0 +1,96 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.internal.undertow;
+
+import java.nio.ByteBuffer;
+import java.util.concurrent.Flow;
+import java.util.concurrent.atomic.AtomicLong;
+
+import org.xnio.ChannelListener;
+import org.xnio.IoUtils;
+import org.xnio.channels.StreamSourceChannel;
+
+import io.undertow.server.HttpServerExchange;
+
+public class UndertowGrpcInputBridge
+    implements Flow.Subscription, ChannelListener<StreamSourceChannel> {
+
+  private final HttpServerExchange exchange;
+  private final Flow.Subscriber<ByteBuffer> subscriber;
+  private final AtomicLong demand = new AtomicLong();
+  private StreamSourceChannel channel;
+
+  private final ByteBuffer buffer = ByteBuffer.allocate(8192);
+
+  public UndertowGrpcInputBridge(
+      HttpServerExchange exchange, Flow.Subscriber<ByteBuffer> subscriber) {
+    this.exchange = exchange;
+    this.subscriber = subscriber;
+  }
+
+  public void start() {
+    this.channel = exchange.getRequestChannel();
+    this.channel.getReadSetter().set(this);
+    subscriber.onSubscribe(this);
+  }
+
+  @Override
+  public void request(long n) {
+    if (n <= 0) {
+      subscriber.onError(new IllegalArgumentException("Demand must be positive"));
+      return;
+    }
+
+    if (demand.getAndAdd(n) == 0 && channel != null) {
+      // CRITICAL FIX: wakeupReads() forces the listener to fire immediately,
+      // draining any data that arrived in the same packet as the headers.
+      channel.wakeupReads();
+    }
+  }
+
+  @Override
+  public void cancel() {
+    demand.set(0);
+    IoUtils.safeClose(channel);
+    exchange.endExchange();
+  }
+
+  @Override
+  public void handleEvent(StreamSourceChannel channel) {
+    try {
+      while (demand.get() > 0) {
+        buffer.clear();
+        int res = channel.read(buffer);
+
+        if (res == -1) {
+          channel.suspendReads();
+          subscriber.onComplete();
+          return;
+        } else if (res == 0) {
+          // Buffer drained, waiting for more data from the network
+          return;
+        }
+
+        buffer.flip();
+        ByteBuffer chunk = ByteBuffer.allocate(buffer.remaining());
+        chunk.put(buffer);
+        chunk.flip();
+
+        subscriber.onNext(chunk);
+        demand.decrementAndGet();
+      }
+
+      if (demand.get() == 0) {
+        channel.suspendReads();
+      }
+
+    } catch (Throwable t) {
+      subscriber.onError(t);
+      IoUtils.safeClose(channel);
+      exchange.endExchange();
+    }
+  }
+}
diff --git a/modules/jooby-undertow/src/main/java/io/jooby/undertow/UndertowServer.java b/modules/jooby-undertow/src/main/java/io/jooby/undertow/UndertowServer.java
index f335a220ed..8ca7addfd1 100644
--- a/modules/jooby-undertow/src/main/java/io/jooby/undertow/UndertowServer.java
+++ b/modules/jooby-undertow/src/main/java/io/jooby/undertow/UndertowServer.java
@@ -18,9 +18,11 @@
 import edu.umd.cs.findbugs.annotations.NonNull;
 import io.jooby.*;
 import io.jooby.exception.StartupException;
+import io.jooby.internal.undertow.UndertowGrpcHandler;
 import io.jooby.internal.undertow.UndertowHandler;
 import io.jooby.internal.undertow.UndertowWebSocket;
 import io.jooby.output.OutputFactory;
+import io.jooby.rpc.grpc.GrpcProcessor;
 import io.undertow.Undertow;
 import io.undertow.UndertowOptions;
 import io.undertow.server.HttpHandler;
@@ -101,6 +103,13 @@ public Server start(@NonNull Jooby... application) {
               options.getMaxRequestSize(),
               options.getDefaultHeaders());
 
+      GrpcProcessor grpcProcessor =
+          applications.get(0).getServices().getOrNull(GrpcProcessor.class);
+
+      if (grpcProcessor != null) {
+        handler = new UndertowGrpcHandler(handler, grpcProcessor);
+      }
+
       if (options.getCompressionLevel() != null) {
         int compressionLevel = options.getCompressionLevel();
         handler =
@@ -154,7 +163,7 @@ public Server start(@NonNull Jooby... application) {
         builder.addHttpListener(options.getPort(), options.getHost());
       }
 
-      // HTTP @
+      // HTTP/2
       builder.setServerOption(ENABLE_HTTP2, options.isHttp2() == Boolean.TRUE);
       var classLoader = this.applications.get(0).getClassLoader();
       SSLContext sslContext = options.getSSLContext(classLoader);
diff --git a/modules/jooby-vertx-mysql-client/pom.xml b/modules/jooby-vertx-mysql-client/pom.xml
index 2fd0564a9f..844bd7a74c 100644
--- a/modules/jooby-vertx-mysql-client/pom.xml
+++ b/modules/jooby-vertx-mysql-client/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-vertx-mysql-client</artifactId>
   <name>jooby-vertx-mysql-client</name>
diff --git a/modules/jooby-vertx-pg-client/pom.xml b/modules/jooby-vertx-pg-client/pom.xml
index 685056b626..39095850bb 100644
--- a/modules/jooby-vertx-pg-client/pom.xml
+++ b/modules/jooby-vertx-pg-client/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-vertx-pg-client</artifactId>
   <name>jooby-vertx-pg-client</name>
diff --git a/modules/jooby-vertx-sql-client/pom.xml b/modules/jooby-vertx-sql-client/pom.xml
index d7f0ac67d6..c6d04200f8 100644
--- a/modules/jooby-vertx-sql-client/pom.xml
+++ b/modules/jooby-vertx-sql-client/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-vertx-sql-client</artifactId>
   <name>jooby-vertx-sql-client</name>
diff --git a/modules/jooby-vertx/pom.xml b/modules/jooby-vertx/pom.xml
index e091423053..5a086f7306 100644
--- a/modules/jooby-vertx/pom.xml
+++ b/modules/jooby-vertx/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-vertx</artifactId>
   <name>jooby-vertx</name>
diff --git a/modules/jooby-whoops/pom.xml b/modules/jooby-whoops/pom.xml
index 42614abab1..2599fb2ab2 100644
--- a/modules/jooby-whoops/pom.xml
+++ b/modules/jooby-whoops/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-whoops</artifactId>
   <name>jooby-whoops</name>
diff --git a/modules/jooby-yasson/pom.xml b/modules/jooby-yasson/pom.xml
index 6f9a5f4681..fb301ad3ab 100644
--- a/modules/jooby-yasson/pom.xml
+++ b/modules/jooby-yasson/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>modules</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>jooby-yasson</artifactId>
   <name>jooby-yasson</name>
diff --git a/modules/pom.xml b/modules/pom.xml
index 9510e9ab68..da1708f668 100644
--- a/modules/pom.xml
+++ b/modules/pom.xml
@@ -4,7 +4,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>jooby-project</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
 
   <artifactId>modules</artifactId>
@@ -32,6 +32,11 @@
     <module>jooby-swagger-ui</module>
     <module>jooby-redoc</module>
 
+    <module>jooby-langchain4j</module>
+
+    <!-- tRCP !-->
+    <module>jooby-trpc</module>
+
     <!-- data -->
     <module>jooby-hikari</module>
     <module>jooby-jdbi</module>
@@ -63,6 +68,8 @@
     <module>jooby-thymeleaf</module>
     <module>jooby-camel</module>
 
+    <module>jooby-grpc</module>
+
     <!-- validation -->
     <module>jooby-avaje-validator</module>
     <module>jooby-hibernate-validator</module>
diff --git a/pom.xml b/pom.xml
index 6aa5a44b26..055010deef 100644
--- a/pom.xml
+++ b/pom.xml
@@ -4,7 +4,7 @@
   <modelVersion>4.0.0</modelVersion>
   <groupId>io.jooby</groupId>
   <artifactId>jooby-project</artifactId>
-  <version>4.0.16</version>
+  <version>4.1.0</version>
   <packaging>pom</packaging>
 
   <name>jooby-project</name>
@@ -78,7 +78,7 @@
     <jdbi.version>3.51.0</jdbi.version>
     <flyway.version>11.20.1</flyway.version>
     <graphql-java.version>25.0</graphql-java.version>
-    <lettuce.version>7.4.0.RELEASE</lettuce.version>
+    <lettuce.version>7.5.0.RELEASE</lettuce.version>
     <commons-pool2.version>2.13.1</commons-pool2.version>
     <kafka.version>4.2.0</kafka.version>
     <caffeine.version>3.2.3</caffeine.version>
@@ -87,6 +87,7 @@
 
     <!-- dependency injection -->
     <guice.version>7.0.0</guice.version>
+    <grpc.version>1.79.0</grpc.version>
 
     <!-- logging -->
     <logback-classic.version>1.5.32</logback-classic.version>
@@ -107,13 +108,13 @@
 
     <!-- Server -->
     <undertow.version>2.3.23.Final</undertow.version>
-    <jetty.version>12.1.6</jetty.version>
+    <jetty.version>12.1.7</jetty.version>
     <netty.version>4.2.10.Final</netty.version>
     <vertx.version>5.0.8</vertx.version>
 
     <!--OpenAPI-->
-    <swagger.version>2.2.43</swagger.version>
-    <swagger-parser.version>2.1.38</swagger-parser.version>
+    <swagger.version>2.2.45</swagger.version>
+    <swagger-parser.version>2.1.39</swagger-parser.version>
     <redoc.version>2.0.0-rc.20</redoc.version>
 
     <!-- SSL -->
@@ -122,7 +123,7 @@
     <!-- avaje -->
     <avaje.inject.version>12.4</avaje.inject.version>
     <avaje.jsonb.version>3.11</avaje.jsonb.version>
-    <avaje.validator.version>2.16</avaje.validator.version>
+    <avaje.validator.version>2.17</avaje.validator.version>
 
     <!-- jakarta -->
     <jakarta.inject.version>2.0.1.MR</jakarta.inject.version>
@@ -133,10 +134,10 @@
     <!-- Misc -->
     <okhttp.version>5.3.2</okhttp.version>
     <jsonwebtoken.version>0.13.0</jsonwebtoken.version>
-    <pac4j.version>6.3.1</pac4j.version>
+    <pac4j.version>6.3.3</pac4j.version>
     <quartz.version>2.5.2</quartz.version>
     <cron-utils.version>9.2.1</cron-utils.version>
-    <bucket4j-core.version>8.16.1</bucket4j-core.version>
+    <bucket4j-core.version>8.17.0</bucket4j-core.version>
     <aws-java-sdk.version>1.12.797</aws-java-sdk.version>
     <camel.version>4.17.0</camel.version>
     <jasypt.version>1.9.3</jasypt.version>
@@ -153,7 +154,7 @@
     <junit.version>6.0.3</junit.version>
     <rest-assured.version>6.0.0</rest-assured.version>
     <assertj-core.version>3.27.7</assertj-core.version>
-    <mockito.version>5.22.0</mockito.version>
+    <mockito.version>5.23.0</mockito.version>
     <maven.m2.repo>${user.home}${file.separator}.m2${file.separator}repository</maven.m2.repo>
     <mockito.agent>org${file.separator}mockito${file.separator}mockito-core${file.separator}${mockito.version}${file.separator}mockito-core-${mockito.version}.jar</mockito.agent>
     <argLine>-javaagent:${maven.m2.repo}${file.separator}${mockito.agent}</argLine>
@@ -174,18 +175,18 @@
     <maven-assembly-plugin.version>3.8.0</maven-assembly-plugin.version>
     <maven-tiles-plugin.version>2.43</maven-tiles-plugin.version>
     <maven-compiler-plugin.version>3.15.0</maven-compiler-plugin.version>
-    <maven-core.version>3.9.12</maven-core.version>
+    <maven-core.version>3.9.14</maven-core.version>
     <maven-enforcer-plugin.version>3.6.2</maven-enforcer-plugin.version>
     <maven-gpg-plugin.version>3.2.8</maven-gpg-plugin.version>
     <maven-jar-plugin.version>3.5.0</maven-jar-plugin.version>
     <maven-javadoc-plugin.version>3.12.0</maven-javadoc-plugin.version>
     <archetype-packaging.version>3.2.1</archetype-packaging.version>
     <maven-plugin-annotations.version>3.15.2</maven-plugin-annotations.version>
-    <maven-plugin-api.version>3.9.12</maven-plugin-api.version>
+    <maven-plugin-api.version>3.9.14</maven-plugin-api.version>
     <maven-plugin-plugin.version>3.15.2</maven-plugin-plugin.version>
     <maven-project.version>2.2.1</maven-project.version>
-    <maven-resources-plugin.version>3.4.0</maven-resources-plugin.version>
-    <maven-shade-plugin.version>3.6.1</maven-shade-plugin.version>
+    <maven-resources-plugin.version>3.5.0</maven-resources-plugin.version>
+    <maven-shade-plugin.version>3.6.2</maven-shade-plugin.version>
     <maven-site-plugin.version>3.8.2</maven-site-plugin.version>
     <maven-source-plugin.version>3.4.0</maven-source-plugin.version>
     <maven-surefire-plugin.version>3.5.5</maven-surefire-plugin.version>
@@ -211,7 +212,7 @@
     <maven.compiler.target>21</maven.compiler.target>
     <maven.compiler.release>21</maven.compiler.release>
     <maven.build.timestamp.format>yyyy-MM-dd HH:mm:ssa</maven.build.timestamp.format>
-    <project.build.outputTimestamp>2026-03-02T16:38:34Z</project.build.outputTimestamp>
+    <project.build.outputTimestamp>2026-03-16T14:41:20Z</project.build.outputTimestamp>
     <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
 
     <pre-commit-hook>etc${file.separator}source${file.separator}formatter.sh</pre-commit-hook>
@@ -336,6 +337,12 @@
         <version>${jooby.version}</version>
       </dependency>
 
+      <dependency>
+        <groupId>io.jooby</groupId>
+        <artifactId>jooby-langchain4j</artifactId>
+        <version>${jooby.version}</version>
+      </dependency>
+
       <dependency>
         <groupId>io.jooby</groupId>
         <artifactId>jooby-openapi</artifactId>
@@ -1533,7 +1540,7 @@
           <plugin>
             <groupId>com.diffplug.spotless</groupId>
             <artifactId>spotless-maven-plugin</artifactId>
-            <version>3.2.1</version>
+            <version>3.3.0</version>
             <configuration>
               <upToDateChecking>
                 <enabled>true</enabled>
diff --git a/tests/pom.xml b/tests/pom.xml
index 9a69f4e060..bd40b4501b 100644
--- a/tests/pom.xml
+++ b/tests/pom.xml
@@ -6,7 +6,7 @@
   <parent>
     <groupId>io.jooby</groupId>
     <artifactId>jooby-project</artifactId>
-    <version>4.0.16</version>
+    <version>4.1.0</version>
   </parent>
   <artifactId>tests</artifactId>
   <name>tests</name>
@@ -116,6 +116,11 @@
       <artifactId>jooby-guice</artifactId>
       <version>${jooby.version}</version>
     </dependency>
+    <dependency>
+      <groupId>io.jooby</groupId>
+      <artifactId>jooby-grpc</artifactId>
+      <version>${jooby.version}</version>
+    </dependency>
     <dependency>
       <groupId>io.jooby</groupId>
       <artifactId>jooby-pac4j</artifactId>
@@ -174,6 +179,30 @@
       <artifactId>kotlin-reflect</artifactId>
     </dependency>
 
+    <dependency>
+      <groupId>io.grpc</groupId>
+      <artifactId>grpc-services</artifactId>
+      <version>${grpc.version}</version>
+    </dependency>
+
+    <dependency>
+      <groupId>io.grpc</groupId>
+      <artifactId>grpc-servlet</artifactId>
+      <version>${grpc.version}</version>
+    </dependency>
+
+    <dependency>
+      <groupId>io.grpc</groupId>
+      <artifactId>grpc-netty-shaded</artifactId>
+      <version>${grpc.version}</version>
+    </dependency>
+
+    <dependency>
+      <groupId>io.grpc</groupId>
+      <artifactId>grpc-okhttp</artifactId>
+      <version>${grpc.version}</version>
+    </dependency>
+
     <dependency>
       <groupId>org.slf4j</groupId>
       <artifactId>jcl-over-slf4j</artifactId>
@@ -201,7 +230,12 @@
       <artifactId>assertj-core</artifactId>
       <scope>test</scope>
     </dependency>
-
+    <dependency>
+      <groupId>com.jayway.jsonpath</groupId>
+      <artifactId>json-path</artifactId>
+      <version>3.0.0</version>
+      <scope>test</scope>
+    </dependency>
     <dependency>
       <groupId>org.mockito</groupId>
       <artifactId>mockito-core</artifactId>
@@ -291,7 +325,33 @@
   </dependencies>
 
   <build>
+    <extensions>
+      <extension>
+        <groupId>kr.motd.maven</groupId>
+        <artifactId>os-maven-plugin</artifactId>
+        <version>1.7.1</version>
+      </extension>
+    </extensions>
     <plugins>
+      <plugin>
+        <groupId>org.xolstice.maven.plugins</groupId>
+        <artifactId>protobuf-maven-plugin</artifactId>
+        <version>0.6.1</version>
+        <configuration>
+          <protocArtifact>com.google.protobuf:protoc:3.25.1:exe:${os.detected.classifier}</protocArtifact>
+          <pluginId>grpc-java</pluginId>
+          <pluginArtifact>io.grpc:protoc-gen-grpc-java:${grpc.version}:exe:${os.detected.classifier}</pluginArtifact>
+        </configuration>
+        <executions>
+          <execution>
+            <goals>
+              <goal>compile</goal>
+              <goal>compile-custom</goal>
+            </goals>
+          </execution>
+        </executions>
+      </plugin>
+
       <plugin>
         <groupId>org.jetbrains.kotlin</groupId>
         <artifactId>kotlin-maven-plugin</artifactId>
diff --git a/tests/src/main/proto/chat.proto b/tests/src/main/proto/chat.proto
new file mode 100644
index 0000000000..2c1e7c36d5
--- /dev/null
+++ b/tests/src/main/proto/chat.proto
@@ -0,0 +1,17 @@
+syntax = "proto3";
+
+package io.jooby.i3875;
+
+option java_package = "io.jooby.i3875";
+option java_multiple_files = true;
+
+service ChatService {
+  // BiDi: Client sends a stream of messages,
+  // Server responds to each one individually.
+  rpc ChatStream (stream ChatMessage) returns (stream ChatMessage);
+}
+
+message ChatMessage {
+  string user = 1;
+  string text = 2;
+}
diff --git a/tests/src/main/proto/hello.proto b/tests/src/main/proto/hello.proto
new file mode 100644
index 0000000000..80f776555b
--- /dev/null
+++ b/tests/src/main/proto/hello.proto
@@ -0,0 +1,22 @@
+syntax = "proto3";
+
+package io.jooby.i3875;
+
+option java_package = "io.jooby.i3875";
+option java_multiple_files = true;
+
+// The request message containing the user's name.
+message HelloRequest {
+  string name = 1;
+}
+
+// The response message containing the greetings
+message HelloReply {
+  string message = 1;
+}
+
+// The greeting service definition.
+service Greeter {
+  // Sends a greeting
+  rpc SayHello (HelloRequest) returns (HelloReply) {}
+}
diff --git a/tests/src/test/java/io/jooby/i3863/AbstractTrpcProtocolTest.java b/tests/src/test/java/io/jooby/i3863/AbstractTrpcProtocolTest.java
new file mode 100644
index 0000000000..7c81b20d30
--- /dev/null
+++ b/tests/src/test/java/io/jooby/i3863/AbstractTrpcProtocolTest.java
@@ -0,0 +1,246 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.i3863;
+
+import static org.assertj.core.api.Assertions.assertThat;
+
+import java.util.Map;
+
+import com.jayway.jsonpath.JsonPath;
+import io.jooby.Jooby;
+import io.jooby.junit.ServerTest;
+import io.jooby.junit.ServerTestRunner;
+import io.jooby.rpc.trpc.TrpcModule;
+
+public abstract class AbstractTrpcProtocolTest {
+
+  /**
+   * Subclasses must provide the specific JSON engine module (e.g., JacksonModule,
+   * AvajeJsonbModule).
+   */
+  protected abstract void installJsonEngine(Jooby app);
+
+  // Helper to keep test setup DRY
+  private void setupApp(Jooby app) {
+    installJsonEngine(app);
+    app.install(new TrpcModule());
+    app.mvc(new MovieService_());
+  }
+
+  @ServerTest
+  void shouldHandleBasicAndMultiArgumentCalls(ServerTestRunner runner) {
+    runner
+        .define(this::setupApp)
+        .ready(
+            http -> {
+              // Ping (No Arguments)
+              http.get(
+                  "/trpc/movies.ping",
+                  rsp -> {
+                    assertThat(rsp.code()).isEqualTo(200);
+                    assertThat(rsp.body().string())
+                        .isEqualToIgnoringNewLines("{\"result\":{\"data\":\"pong\"}}");
+                  });
+
+              // GetById (Single Primitive Argument - Seamless)
+              http.get(
+                  "/trpc/movies.getById?input=1",
+                  rsp -> {
+                    assertThat(rsp.code()).isEqualTo(200);
+                    assertThat(rsp.body().string())
+                        .isEqualToIgnoringNewLines(
+                            "{\"result\":{\"data\":{\"id\":1,\"title\":\"The"
+                                + " Godfather\",\"year\":1972}}}");
+                  });
+
+              // GetById (Not found)
+              http.get(
+                  "/trpc/movies.getById?input=13",
+                  rsp -> {
+                    assertThat(rsp.code()).isEqualTo(404);
+                    assertThat(rsp.body().string())
+                        .isEqualToIgnoringNewLines(
+                            """
+                            {"error":{"message":"Movie not found: 13","code":-32004,"data":{"code":"NOT_FOUND","httpStatus":404,"path":"movies.getById"}}}
+                            """);
+                  });
+
+              // Search (Multi-Argument Tuple)
+              http.get(
+                  "/trpc/movies.search?input=[\"Pulp Fiction\", 1994]",
+                  rsp -> {
+                    assertThat(rsp.code()).isEqualTo(200);
+                    assertThat(rsp.body().string())
+                        .isEqualToIgnoringNewLines(
+                            "{\"result\":{\"data\":[{\"id\":2,\"title\":\"Pulp"
+                                + " Fiction\",\"year\":1994}]}}");
+                  });
+
+              // AddReview (Multi-Argument Mutation)
+              http.postJson(
+                  "/trpc/movies.addReview",
+                  "[\"The Godfather\", 5, \"Amazing\"]",
+                  rsp -> {
+                    var json = rsp.body().string();
+                    assertThat(rsp.code()).isEqualTo(200);
+                    assertThat(JsonPath.<String>read(json, "$.result.data.status"))
+                        .isEqualTo("published");
+                    assertThat(JsonPath.<Integer>read(json, "$.result.data.rating")).isEqualTo(5);
+                  });
+            });
+  }
+
+  @ServerTest
+  void shouldHandleSeamlessVsTupleWrappers(ServerTestRunner runner) {
+    runner
+        .define(this::setupApp)
+        .ready(
+            http -> {
+              // Create (Strict Seamless Payload for single argument)
+              http.postJson(
+                  "/trpc/movies.create",
+                  "{\"id\": 1, \"title\": \"The Matrix\", \"year\": 1999}",
+                  rsp -> {
+                    String json = rsp.body().string();
+                    assertThat(rsp.code()).isEqualTo(200);
+                    assertThat(JsonPath.<String>read(json, "$.result.data.title"))
+                        .isEqualTo("The Matrix");
+                  });
+
+              // BulkCreate (Single argument that is inherently an array)
+              http.get(
+                  "/trpc/movies.bulkCreate",
+                  Map.of("input", "[{\"id\": 1, \"title\": \"The Matrix\", \"year\": 1999}]"),
+                  rsp -> {
+                    String json = rsp.body().string();
+                    assertThat(rsp.code()).isEqualTo(200);
+                    assertThat(JsonPath.<String>read(json, "$.result.data[0]"))
+                        .isEqualTo("Created: The Matrix");
+                  });
+            });
+  }
+
+  @ServerTest
+  void shouldHandleReactiveAndVoidTypes(ServerTestRunner runner) {
+    runner
+        .define(this::setupApp)
+        .ready(
+            http -> {
+              // CreateMono (Reactive Pipeline)
+              http.postJson(
+                  "/trpc/movies.createMono",
+                  "{\"id\": 1, \"title\": \"The Matrix\", \"year\": 1999}",
+                  rsp -> {
+                    String json = rsp.body().string();
+                    assertThat(rsp.code()).isEqualTo(200);
+                    assertThat(JsonPath.<Integer>read(json, "$.result.data.id")).isEqualTo(1);
+                  });
+
+              // ResetIndex (Void return type)
+              http.post(
+                  "/trpc/movies.resetIndex",
+                  rsp -> {
+                    assertThat(rsp.code()).isEqualTo(200);
+                    assertThat(rsp.body().string()).contains("\"result\"");
+                  });
+            });
+  }
+
+  @ServerTest
+  void shouldHandleErrorsAndEdgeCases(ServerTestRunner runner) {
+    runner
+        .define(this::setupApp)
+        .ready(
+            http -> {
+              // Error: Type Mismatch
+              http.postJson(
+                  "/trpc/movies.addReview",
+                  "[\"The Godfather\", \"FIVE_STARS\", \"Amazing\"]",
+                  rsp -> {
+                    String json = rsp.body().string();
+                    assertThat(rsp.code()).isEqualTo(400);
+                    assertThat(JsonPath.<String>read(json, "$.error.data.code"))
+                        .isEqualTo("BAD_REQUEST");
+                    assertThat(JsonPath.<String>read(json, "$.error.message")).isNotEmpty();
+                  });
+
+              // Error: Missing Tuple Wrapper (Multi-argument method given a raw string)
+              http.get(
+                  "/trpc/movies.search?input=\"Pulp Fiction\"",
+                  rsp -> {
+                    String json = rsp.body().string();
+                    assertThat(rsp.code()).isEqualTo(400);
+                    assertThat(JsonPath.<String>read(json, "$.error.message"))
+                        .contains("tRPC input for multiple arguments must be a JSON array (tuple)");
+                  });
+
+              // Error: Procedure Not Found (404)
+              http.get(
+                  "/trpc/movies.doesNotExist",
+                  rsp -> {
+                    String json = rsp.body().string();
+                    assertThat(rsp.code()).isEqualTo(404);
+                    assertThat(JsonPath.<String>read(json, "$.error.data.code"))
+                        .isEqualTo("NOT_FOUND");
+                  });
+            });
+  }
+
+  @ServerTest
+  void shouldHandleNullabilityValidation(ServerTestRunner runner) {
+    runner
+        .define(this::setupApp)
+        .ready(
+            http -> {
+              // Validating a nullable parameter is accepted (Integer)
+              http.get(
+                  "/trpc/movies.search?input=[\"The Godfather\", null]",
+                  rsp -> {
+                    assertThat(rsp.code()).isEqualTo(200);
+                    assertThat(rsp.body().string()).contains("\"The Godfather\"");
+                  });
+
+              // Validating a required (primitive) parameter rejects null (Seamless path)
+              http.get(
+                  "/trpc/movies.getById?input=null",
+                  rsp -> {
+                    String json = rsp.body().string();
+                    assertThat(rsp.code()).isEqualTo(400);
+                    assertThat(JsonPath.<String>read(json, "$.error.data.code"))
+                        .isEqualTo("BAD_REQUEST");
+                  });
+
+              // Validating MissingValueException (Not enough arguments in the tuple)
+              http.postJson(
+                  "/trpc/movies.addReview",
+                  "[\"The Godfather\", 5]",
+                  rsp -> {
+                    String json = rsp.body().string();
+                    assertThat(rsp.code()).isEqualTo(400);
+                    assertThat(JsonPath.<String>read(json, "$.error.message"))
+                        .containsIgnoringCase("comment");
+                  });
+
+              // Validating explicit null on an Object/POJO
+              http.postJson(
+                  "/trpc/movies.updateMetadata",
+                  "[1, null]",
+                  rsp -> {
+                    assertThat(rsp.code()).isEqualTo(200);
+                    assertThat(rsp.body().string()).contains("\"result\"");
+                  });
+
+              // Delete Movie
+              http.postJson(
+                  "/trpc/movies.deleteMovie",
+                  "1",
+                  rsp -> {
+                    assertThat(rsp.code()).isEqualTo(200);
+                    assertThat(rsp.body().string()).contains("\"result\"");
+                  });
+            });
+  }
+}
diff --git a/tests/src/test/java/io/jooby/i3863/AvajeTrpcProtocolTest.java b/tests/src/test/java/io/jooby/i3863/AvajeTrpcProtocolTest.java
new file mode 100644
index 0000000000..5fe78d9de0
--- /dev/null
+++ b/tests/src/test/java/io/jooby/i3863/AvajeTrpcProtocolTest.java
@@ -0,0 +1,16 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.i3863;
+
+import io.jooby.Jooby;
+import io.jooby.avaje.jsonb.AvajeJsonbModule;
+
+public class AvajeTrpcProtocolTest extends AbstractTrpcProtocolTest {
+  @Override
+  protected void installJsonEngine(Jooby app) {
+    app.install(new AvajeJsonbModule());
+  }
+}
diff --git a/tests/src/test/java/io/jooby/i3863/Jackson2TrpcProtocolTest.java b/tests/src/test/java/io/jooby/i3863/Jackson2TrpcProtocolTest.java
new file mode 100644
index 0000000000..8e90d41c14
--- /dev/null
+++ b/tests/src/test/java/io/jooby/i3863/Jackson2TrpcProtocolTest.java
@@ -0,0 +1,16 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.i3863;
+
+import io.jooby.Jooby;
+import io.jooby.jackson.JacksonModule;
+
+public class Jackson2TrpcProtocolTest extends AbstractTrpcProtocolTest {
+  @Override
+  protected void installJsonEngine(Jooby app) {
+    app.install(new JacksonModule());
+  }
+}
diff --git a/tests/src/test/java/io/jooby/i3863/Jackson3TrpcProtocolTest.java b/tests/src/test/java/io/jooby/i3863/Jackson3TrpcProtocolTest.java
new file mode 100644
index 0000000000..f5dad5f885
--- /dev/null
+++ b/tests/src/test/java/io/jooby/i3863/Jackson3TrpcProtocolTest.java
@@ -0,0 +1,16 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.i3863;
+
+import io.jooby.Jooby;
+import io.jooby.jackson3.Jackson3Module;
+
+public class Jackson3TrpcProtocolTest extends AbstractTrpcProtocolTest {
+  @Override
+  protected void installJsonEngine(Jooby app) {
+    app.install(new Jackson3Module());
+  }
+}
diff --git a/tests/src/test/java/io/jooby/i3863/Metadata.java b/tests/src/test/java/io/jooby/i3863/Metadata.java
new file mode 100644
index 0000000000..8e8996ba47
--- /dev/null
+++ b/tests/src/test/java/io/jooby/i3863/Metadata.java
@@ -0,0 +1,11 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.i3863;
+
+import io.avaje.jsonb.Json;
+
+@Json
+public record Metadata(String releaseDate) {}
diff --git a/tests/src/test/java/io/jooby/i3863/Movie.java b/tests/src/test/java/io/jooby/i3863/Movie.java
new file mode 100644
index 0000000000..a5c4238799
--- /dev/null
+++ b/tests/src/test/java/io/jooby/i3863/Movie.java
@@ -0,0 +1,11 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.i3863;
+
+import io.avaje.jsonb.Json;
+
+@Json
+public record Movie(int id, String title, int year) {}
diff --git a/tests/src/test/java/io/jooby/i3863/MovieService.java b/tests/src/test/java/io/jooby/i3863/MovieService.java
new file mode 100644
index 0000000000..55e00837db
--- /dev/null
+++ b/tests/src/test/java/io/jooby/i3863/MovieService.java
@@ -0,0 +1,94 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.i3863;
+
+import java.util.List;
+import java.util.Map;
+import java.util.stream.Collectors;
+
+import edu.umd.cs.findbugs.annotations.NonNull;
+import io.jooby.annotation.*;
+import io.jooby.exception.NotFoundException;
+import reactor.core.publisher.Mono;
+
+@Trpc("movies")
+@Path("/api/movies")
+public class MovieService {
+
+  private final List<Movie> database =
+      List.of(new Movie(1, "The Godfather", 1972), new Movie(2, "Pulp Fiction", 1994));
+
+  /** Procedure: movies.create Takes a single complex object. */
+  @Trpc.Mutation
+  @POST("/create")
+  public Movie create(Movie movie) {
+    // In a real app, save to DB. For now, just return it.
+    return movie;
+  }
+
+  /** Procedure: movies.create Takes a single complex object. */
+  @Trpc.Mutation
+  public Mono<Movie> createMono(Movie movie) {
+    // In a real app, save to DB. For now, just return it.
+    return Mono.just(movie);
+  }
+
+  @Trpc.Mutation
+  @PUT
+  public void resetIndex() {}
+
+  /** Procedure: movies.bulkCreate Takes a List of complex objects. */
+  @Trpc.Query
+  public List<String> bulkCreate(List<Movie> movies) {
+    return movies.stream().map(m -> "Created: " + m.title()).collect(Collectors.toList());
+  }
+
+  /** Procedure: movies.ping */
+  @Trpc.Query
+  public String ping() {
+    return "pong";
+  }
+
+  /** Procedure: movies.getById Single primitive argument */
+  @Trpc
+  @GET("/{id}")
+  public @NonNull Movie getById(@PathParam int id) {
+    return database.stream()
+        .filter(m -> m.id() == id)
+        .findFirst()
+        .orElseThrow(() -> new NotFoundException("Movie not found: " + id));
+  }
+
+  /** Procedure: movies.search Multi-argument (Tuple) */
+  @Trpc.Query
+  public List<Movie> search(String title, Integer year) {
+    return database.stream()
+        .filter(m -> m.title().contains(title) && (year == null || m.year() == year))
+        .toList();
+  }
+
+  /** Procedure: movies.addReview Mix of String and int (Mutation) */
+  @Trpc.Mutation
+  public Map<String, Object> addReview(String movieTitle, int stars, String comment) {
+    // Business logic...
+    return Map.of(
+        "title", movieTitle,
+        "rating", stars,
+        "status", "published");
+  }
+
+  /** Procedure: movies.addReview Mix of String and int (Mutation) */
+  @Trpc
+  @PUT("/{id}/metadata")
+  public Metadata updateMetadata(@PathParam int id, Metadata metadata) {
+    // Business logic...
+    return metadata;
+  }
+
+  @Trpc
+  @DELETE("/{id}")
+  public void deleteMovie(@PathParam int id) {}
+}
diff --git a/tests/src/test/java/io/jooby/i3868/AbstractJsonRpcProtocolTest.java b/tests/src/test/java/io/jooby/i3868/AbstractJsonRpcProtocolTest.java
new file mode 100644
index 0000000000..af9edcffc3
--- /dev/null
+++ b/tests/src/test/java/io/jooby/i3868/AbstractJsonRpcProtocolTest.java
@@ -0,0 +1,400 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.i3868;
+
+import static org.assertj.core.api.Assertions.assertThat;
+
+import java.util.List;
+import java.util.Map;
+
+import com.jayway.jsonpath.JsonPath;
+import io.jooby.Jooby;
+import io.jooby.junit.ServerTest;
+import io.jooby.junit.ServerTestRunner;
+
+public abstract class AbstractJsonRpcProtocolTest {
+
+  /**
+   * Subclasses must provide the specific JSON engine module (e.g., JacksonModule, Jackson3Module).
+   */
+  protected abstract void installJsonEngine(Jooby app);
+
+  // Helper to keep test setup DRY
+  private void setupApp(Jooby app) {
+    installJsonEngine(app);
+    app.mvc(new MovieService_());
+    app.mvc(new MovieServiceRpc_());
+  }
+
+  @ServerTest
+  void shouldHandleSingleRequests(ServerTestRunner runner) {
+    runner
+        .define(this::setupApp)
+        .ready(
+            http -> {
+              // GetById (Positional Arguments Array)
+              http.postJson(
+                  "/rpc",
+                  """
+                  {
+                    "jsonrpc": "2.0",
+                    "method": "movies.getById",
+                    "params": [1],
+                    "id": 1
+                  }
+                  """,
+                  rsp -> {
+                    String json = rsp.body().string();
+                    assertThat(rsp.code()).isEqualTo(200);
+
+                    // Spec: Success must have 'result' and must NOT have 'error'
+                    Map<String, Object> root = JsonPath.read(json, "$");
+                    assertThat(root).containsKey("result").doesNotContainKey("error");
+
+                    assertThat(JsonPath.<Integer>read(json, "$.id")).isEqualTo(1);
+                    assertThat(JsonPath.<String>read(json, "$.result.title"))
+                        .isEqualTo("The Godfather");
+                  });
+
+              // Search (Named Arguments Object)
+              http.postJson(
+                  "/rpc",
+                  """
+                  {
+                    "jsonrpc": "2.0",
+                    "method": "movies.search",
+                    "params": {"title": "Pulp Fiction", "year": 1994},
+                    "id": 2
+                  }
+                  """,
+                  rsp -> {
+                    String json = rsp.body().string();
+                    assertThat(rsp.code()).isEqualTo(200);
+
+                    Map<String, Object> root = JsonPath.read(json, "$");
+                    assertThat(root).containsKey("result").doesNotContainKey("error");
+
+                    assertThat(JsonPath.<Integer>read(json, "$.id")).isEqualTo(2);
+                    assertThat(JsonPath.<Integer>read(json, "$.result[0].id")).isEqualTo(2);
+                    assertThat(JsonPath.<String>read(json, "$.result[0].title"))
+                        .isEqualTo("Pulp Fiction");
+                  });
+
+              // Create (Complex Object passed by position)
+              http.postJson(
+                  "/rpc",
+                  """
+                  {
+                    "jsonrpc": "2.0",
+                    "method": "movies.create",
+                    "params": [{"id": 3, "title": "Goodfellas", "year": 1990}],
+                    "id": 3
+                  }
+                  """,
+                  rsp -> {
+                    String json = rsp.body().string();
+                    assertThat(rsp.code()).isEqualTo(200);
+
+                    Map<String, Object> root = JsonPath.read(json, "$");
+                    assertThat(root).containsKey("result").doesNotContainKey("error");
+
+                    assertThat(JsonPath.<String>read(json, "$.result.title"))
+                        .isEqualTo("Goodfellas");
+                  });
+            });
+  }
+
+  @ServerTest
+  void shouldHandleNotifications(ServerTestRunner runner) {
+    runner
+        .define(this::setupApp)
+        .ready(
+            http -> {
+              http.postJson(
+                  "/rpc",
+                  """
+                  {
+                    "jsonrpc": "2.0",
+                    "method": "movies.deleteMovie",
+                    "params": [1]
+                  }
+                  """,
+                  rsp -> {
+                    assertThat(rsp.code()).isEqualTo(204); // No Content
+                    assertThat(rsp.body().string()).isEmpty();
+                  });
+            });
+  }
+
+  @ServerTest
+  void shouldHandleErrors(ServerTestRunner runner) {
+    runner
+        .define(this::setupApp)
+        .ready(
+            http -> {
+              // Method Not Found (-32601)
+              http.postJson(
+                  "/rpc",
+                  """
+                  {
+                    "jsonrpc": "2.0",
+                    "method": "movies.unknownMethod",
+                    "params": [],
+                    "id": 4
+                  }
+                  """,
+                  rsp -> {
+                    String json = rsp.body().string();
+                    assertThat(rsp.code()).isEqualTo(200);
+
+                    // Spec: Error must have 'error' and must NOT have 'result'
+                    Map<String, Object> root = JsonPath.read(json, "$");
+                    assertThat(root).containsKey("error").doesNotContainKey("result");
+
+                    assertThat(JsonPath.<Integer>read(json, "$.error.code")).isEqualTo(-32601);
+                    assertThat(JsonPath.<String>read(json, "$.error.message"))
+                        .contains("Method not found");
+                  });
+
+              // Invalid Request (-32600)
+              http.postJson(
+                  "/rpc",
+                  """
+                  {
+                    "method": "movies.getById",
+                    "params": [1],
+                    "id": 5
+                  }
+                  """,
+                  rsp -> {
+                    String json = rsp.body().string();
+                    assertThat(rsp.code()).isEqualTo(200);
+
+                    Map<String, Object> root = JsonPath.read(json, "$");
+                    assertThat(root).containsKey("error").doesNotContainKey("result");
+
+                    assertThat(JsonPath.<Integer>read(json, "$.error.code")).isEqualTo(-32600);
+                  });
+
+              // Parse Error (-32700)
+              http.postJson(
+                  "/rpc",
+                  "[{ malformed json... ",
+                  rsp -> {
+                    String json = rsp.body().string();
+                    assertThat(rsp.code()).isEqualTo(200);
+
+                    Map<String, Object> root = JsonPath.read(json, "$");
+                    assertThat(root).containsKey("error").doesNotContainKey("result");
+
+                    assertThat(JsonPath.<Integer>read(json, "$.error.code")).isEqualTo(-32700);
+                  });
+
+              // Application Exception Bubbling (-32004)
+              http.postJson(
+                  "/rpc",
+                  """
+                  {
+                    "jsonrpc": "2.0",
+                    "method": "movies.getById",
+                    "params": [99],
+                    "id": 6
+                  }
+                  """,
+                  rsp -> {
+                    String json = rsp.body().string();
+                    assertThat(rsp.code()).isEqualTo(200);
+
+                    Map<String, Object> root = JsonPath.read(json, "$");
+                    assertThat(root).containsKey("error").doesNotContainKey("result");
+
+                    assertThat(JsonPath.<String>read(json, "$.error.message"))
+                        .contains("Not found");
+                    assertThat(JsonPath.<String>read(json, "$.error.data"))
+                        .contains("Movie not found: 99");
+                  });
+            });
+  }
+
+  @ServerTest
+  void shouldHandleInvalidParams(ServerTestRunner runner) {
+    runner
+        .define(this::setupApp)
+        .ready(
+            http -> {
+              // 1. Missing Argument (Named)
+              http.postJson(
+                  "/rpc",
+                  """
+                  {"jsonrpc": "2.0", "method": "movies.search", "params": {"title": "Pulp Fiction"}, "id": 10}
+                  """,
+                  rsp -> {
+                    String json = rsp.body().string();
+                    assertThat(rsp.code()).isEqualTo(200);
+
+                    Map<String, Object> root = JsonPath.read(json, "$");
+                    assertThat(root).containsKey("error").doesNotContainKey("result");
+
+                    assertThat(JsonPath.<Integer>read(json, "$.error.code")).isEqualTo(-32602);
+                  });
+
+              // 2. Missing Argument (Positional)
+              http.postJson(
+                  "/rpc",
+                  """
+                  {"jsonrpc": "2.0", "method": "movies.search", "params": ["Pulp Fiction"], "id": 11}
+                  """,
+                  rsp -> {
+                    String json = rsp.body().string();
+                    assertThat(rsp.code()).isEqualTo(200);
+
+                    Map<String, Object> root = JsonPath.read(json, "$");
+                    assertThat(root).containsKey("error").doesNotContainKey("result");
+
+                    assertThat(JsonPath.<Integer>read(json, "$.error.code")).isEqualTo(-32602);
+                  });
+
+              // 3. Type Mismatch
+              http.postJson(
+                  "/rpc",
+                  """
+                  {"jsonrpc": "2.0", "method": "movies.search", "params": {"title": "Pulp Fiction", "year": "ninety-four"}, "id": 12}
+                  """,
+                  rsp -> {
+                    String json = rsp.body().string();
+                    assertThat(rsp.code()).isEqualTo(200);
+
+                    Map<String, Object> root = JsonPath.read(json, "$");
+                    assertThat(root).containsKey("error").doesNotContainKey("result");
+
+                    assertThat(JsonPath.<Integer>read(json, "$.error.code")).isEqualTo(-32602);
+                  });
+
+              // 4. Empty Params (Array)
+              http.postJson(
+                  "/rpc",
+                  """
+                  {"jsonrpc": "2.0", "method": "movies.getById", "params": [], "id": 13}
+                  """,
+                  rsp -> {
+                    String json = rsp.body().string();
+                    assertThat(rsp.code()).isEqualTo(200);
+
+                    Map<String, Object> root = JsonPath.read(json, "$");
+                    assertThat(root).containsKey("error").doesNotContainKey("result");
+
+                    assertThat(JsonPath.<Integer>read(json, "$.error.code")).isEqualTo(-32602);
+                  });
+
+              // 5. Omitted Params Object entirely
+              http.postJson(
+                  "/rpc",
+                  """
+                  {"jsonrpc": "2.0", "method": "movies.getById", "id": 14}
+                  """,
+                  rsp -> {
+                    String json = rsp.body().string();
+                    assertThat(rsp.code()).isEqualTo(200);
+
+                    Map<String, Object> root = JsonPath.read(json, "$");
+                    assertThat(root).containsKey("error").doesNotContainKey("result");
+
+                    assertThat(JsonPath.<Integer>read(json, "$.error.code")).isEqualTo(-32602);
+                  });
+            });
+  }
+
+  @ServerTest
+  void shouldHandleBatchProcessing(ServerTestRunner runner) {
+    runner
+        .define(this::setupApp)
+        .ready(
+            http -> {
+              http.postJson(
+                  "/rpc",
+                  """
+                  [
+                    {"jsonrpc": "2.0", "method": "movies.getById", "params": [1], "id": "req-1"},
+                    {"jsonrpc": "2.0", "method": "movies.getById", "params": [2], "id": "req-2"},
+                    {"jsonrpc": "2.0", "method": "movies.deleteMovie", "params": [3]}
+                  ]
+                  """,
+                  rsp -> {
+                    String json = rsp.body().string();
+                    assertThat(rsp.code()).isEqualTo(200);
+                    assertThat(json).startsWith("[");
+
+                    // Assert length is exactly 2 (notification should be dropped)
+                    assertThat(JsonPath.<Integer>read(json, "$.length()")).isEqualTo(2);
+
+                    // Assert mutual exclusivity on the individual batch elements
+                    Map<String, Object> element0 = JsonPath.read(json, "$[0]");
+                    Map<String, Object> element1 = JsonPath.read(json, "$[1]");
+
+                    // Both should be successes
+                    assertThat(element0).containsKey("result").doesNotContainKey("error");
+                    assertThat(element1).containsKey("result").doesNotContainKey("error");
+
+                    // Order-agnostic assertions using JsonPath filters!
+                    List<String> req1Title =
+                        JsonPath.read(json, "$[?(@.id == 'req-1')].result.title");
+                    assertThat(req1Title).containsExactly("The Godfather");
+
+                    List<String> req2Id = JsonPath.read(json, "$[?(@.id == 'req-2')].id");
+                    assertThat(req2Id).containsExactly("req-2");
+
+                    // Notification (deleteMovie) should leave no trace in the response
+                    assertThat(json).doesNotContain("deleteMovie");
+                  });
+            });
+  }
+
+  @ServerTest
+  void shouldHandleBatchEdgeCases(ServerTestRunner runner) {
+    runner
+        .define(this::setupApp)
+        .ready(
+            http -> {
+              // Edge Case 1: Empty Array
+              http.postJson(
+                  "/rpc",
+                  "[]",
+                  rsp -> {
+                    String json = rsp.body().string();
+                    assertThat(rsp.code()).isEqualTo(200);
+                    assertThat(json).doesNotStartWith("["); // MUST be a single object
+
+                    Map<String, Object> root = JsonPath.read(json, "$");
+                    assertThat(root).containsKey("error").doesNotContainKey("result");
+
+                    assertThat(JsonPath.<Integer>read(json, "$.error.code")).isEqualTo(-32600);
+                    assertThat(JsonPath.<String>read(json, "$.error.message"))
+                        .containsIgnoringCase("Invalid Request");
+                  });
+
+              // Edge Case 2: Array containing completely invalid data
+              http.postJson(
+                  "/rpc",
+                  "[1, 2, 3]",
+                  rsp -> {
+                    String json = rsp.body().string();
+                    assertThat(rsp.code()).isEqualTo(200);
+                    assertThat(json).startsWith("[");
+                    assertThat(JsonPath.<Integer>read(json, "$.length()")).isEqualTo(3);
+
+                    // Check mutual exclusivity on all error elements in the batch
+                    List<Map<String, Object>> array = JsonPath.read(json, "$");
+                    for (Map<String, Object> element : array) {
+                      assertThat(element).containsKey("error").doesNotContainKey("result");
+                    }
+
+                    // All three elements should be Invalid Request errors
+                    List<Integer> errorCodes = JsonPath.read(json, "$[*].error.code");
+                    assertThat(errorCodes).containsExactly(-32600, -32600, -32600);
+                  });
+            });
+  }
+}
diff --git a/tests/src/test/java/io/jooby/i3868/AvajeJsonRpcProtocolTest.java b/tests/src/test/java/io/jooby/i3868/AvajeJsonRpcProtocolTest.java
new file mode 100644
index 0000000000..bafad8410f
--- /dev/null
+++ b/tests/src/test/java/io/jooby/i3868/AvajeJsonRpcProtocolTest.java
@@ -0,0 +1,16 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.i3868;
+
+import io.jooby.Jooby;
+import io.jooby.avaje.jsonb.AvajeJsonbModule;
+
+public class AvajeJsonRpcProtocolTest extends AbstractJsonRpcProtocolTest {
+  @Override
+  protected void installJsonEngine(Jooby app) {
+    app.install(new AvajeJsonbModule());
+  }
+}
diff --git a/tests/src/test/java/io/jooby/i3868/Jackson2JsonRpcProtocolTest.java b/tests/src/test/java/io/jooby/i3868/Jackson2JsonRpcProtocolTest.java
new file mode 100644
index 0000000000..0b8d6d6e9b
--- /dev/null
+++ b/tests/src/test/java/io/jooby/i3868/Jackson2JsonRpcProtocolTest.java
@@ -0,0 +1,16 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.i3868;
+
+import io.jooby.Jooby;
+import io.jooby.jackson.JacksonModule;
+
+public class Jackson2JsonRpcProtocolTest extends AbstractJsonRpcProtocolTest {
+  @Override
+  protected void installJsonEngine(Jooby app) {
+    app.install(new JacksonModule());
+  }
+}
diff --git a/tests/src/test/java/io/jooby/i3868/Jackson3JsonRpcProtocolTest.java b/tests/src/test/java/io/jooby/i3868/Jackson3JsonRpcProtocolTest.java
new file mode 100644
index 0000000000..f2b766aa18
--- /dev/null
+++ b/tests/src/test/java/io/jooby/i3868/Jackson3JsonRpcProtocolTest.java
@@ -0,0 +1,16 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.i3868;
+
+import io.jooby.Jooby;
+import io.jooby.jackson3.Jackson3Module;
+
+public class Jackson3JsonRpcProtocolTest extends AbstractJsonRpcProtocolTest {
+  @Override
+  protected void installJsonEngine(Jooby app) {
+    app.install(new Jackson3Module());
+  }
+}
diff --git a/tests/src/test/java/io/jooby/i3868/MovieService.java b/tests/src/test/java/io/jooby/i3868/MovieService.java
new file mode 100644
index 0000000000..5c5ba7b266
--- /dev/null
+++ b/tests/src/test/java/io/jooby/i3868/MovieService.java
@@ -0,0 +1,42 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.i3868;
+
+import java.util.List;
+
+import edu.umd.cs.findbugs.annotations.NonNull;
+import io.jooby.annotation.*;
+import io.jooby.exception.NotFoundException;
+import io.jooby.i3863.Movie;
+
+@JsonRpc("movies")
+@Path("/api/movies")
+public class MovieService {
+
+  private final List<Movie> database =
+      List.of(new Movie(1, "The Godfather", 1972), new Movie(2, "Pulp Fiction", 1994));
+
+  /** Procedure: movies.create Takes a single complex object. */
+  @POST
+  @Trpc
+  public Movie create(Movie movie) {
+    // In a real app, save to DB. For now, just return it.
+    return movie;
+  }
+
+  public @NonNull Movie getById(int id) {
+    return database.stream()
+        .filter(m -> m.id() == id)
+        .findFirst()
+        .orElseThrow(() -> new NotFoundException("Movie not found: " + id));
+  }
+
+  public List<Movie> search(String title, int year) {
+    return database.stream().filter(m -> m.title().contains(title) && (m.year() == year)).toList();
+  }
+
+  public void deleteMovie(int id) {}
+}
diff --git a/tests/src/test/java/io/jooby/i3875/EchoChatService.java b/tests/src/test/java/io/jooby/i3875/EchoChatService.java
new file mode 100644
index 0000000000..676bf7baba
--- /dev/null
+++ b/tests/src/test/java/io/jooby/i3875/EchoChatService.java
@@ -0,0 +1,37 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.i3875;
+
+import io.grpc.stub.StreamObserver;
+
+public class EchoChatService extends ChatServiceGrpc.ChatServiceImplBase {
+
+  @Override
+  public StreamObserver<ChatMessage> chatStream(StreamObserver<ChatMessage> responseObserver) {
+    return new StreamObserver<ChatMessage>() {
+      @Override
+      public void onNext(ChatMessage request) {
+        ChatMessage response =
+            ChatMessage.newBuilder()
+                .setUser("Server")
+                .setText("Echo: " + request.getText())
+                .build();
+
+        responseObserver.onNext(response);
+      }
+
+      @Override
+      public void onError(Throwable t) {
+        System.err.println("Stream error: " + t.getMessage());
+      }
+
+      @Override
+      public void onCompleted() {
+        responseObserver.onCompleted();
+      }
+    };
+  }
+}
diff --git a/tests/src/test/java/io/jooby/i3875/EchoGreeterService.java b/tests/src/test/java/io/jooby/i3875/EchoGreeterService.java
new file mode 100644
index 0000000000..c76922aee3
--- /dev/null
+++ b/tests/src/test/java/io/jooby/i3875/EchoGreeterService.java
@@ -0,0 +1,25 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.i3875;
+
+import io.grpc.stub.StreamObserver;
+
+public class EchoGreeterService extends GreeterGrpc.GreeterImplBase {
+
+  private final EchoService echoService;
+
+  @jakarta.inject.Inject
+  public EchoGreeterService(EchoService echoService) {
+    this.echoService = echoService;
+  }
+
+  @Override
+  public void sayHello(HelloRequest req, StreamObserver<HelloReply> responseObserver) {
+    HelloReply reply = HelloReply.newBuilder().setMessage(echoService.echo(req.getName())).build();
+    responseObserver.onNext(reply);
+    responseObserver.onCompleted();
+  }
+}
diff --git a/tests/src/test/java/io/jooby/i3875/EchoService.java b/tests/src/test/java/io/jooby/i3875/EchoService.java
new file mode 100644
index 0000000000..25d44d594e
--- /dev/null
+++ b/tests/src/test/java/io/jooby/i3875/EchoService.java
@@ -0,0 +1,13 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.i3875;
+
+public class EchoService {
+
+  public String echo(String value) {
+    return "Hello " + value;
+  }
+}
diff --git a/tests/src/test/java/io/jooby/i3875/GrpcTest.java b/tests/src/test/java/io/jooby/i3875/GrpcTest.java
new file mode 100644
index 0000000000..fd2a8a6de1
--- /dev/null
+++ b/tests/src/test/java/io/jooby/i3875/GrpcTest.java
@@ -0,0 +1,380 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package io.jooby.i3875;
+
+import static org.assertj.core.api.Assertions.assertThat;
+
+import java.nio.charset.StandardCharsets;
+import java.util.concurrent.CopyOnWriteArrayList;
+import java.util.concurrent.CountDownLatch;
+import java.util.concurrent.TimeUnit;
+
+import io.grpc.ManagedChannelBuilder;
+import io.grpc.Status;
+import io.grpc.StatusRuntimeException;
+import io.grpc.protobuf.services.ProtoReflectionServiceV1;
+import io.grpc.reflection.v1.ServerReflectionGrpc;
+import io.grpc.reflection.v1.ServerReflectionRequest;
+import io.grpc.reflection.v1.ServerReflectionResponse;
+import io.grpc.stub.StreamObserver;
+import io.jooby.Jooby;
+import io.jooby.ServerOptions;
+import io.jooby.grpc.GrpcModule;
+import io.jooby.guice.GuiceModule;
+import io.jooby.junit.ServerTest;
+import io.jooby.junit.ServerTestRunner;
+
+public class GrpcTest {
+
+  private void setupApp(Jooby app) {
+    app.install(new GuiceModule());
+
+    app.install(
+        new GrpcModule(new EchoChatService(), ProtoReflectionServiceV1.newInstance())
+            .bind(EchoGreeterService.class));
+  }
+
+  @ServerTest
+  void shouldHandleUnaryRequests(ServerTestRunner runner) {
+    runner
+        .options(new ServerOptions().setHttp2(true).setSecurePort(8443))
+        .define(this::setupApp)
+        .ready(
+            http -> {
+              var channel =
+                  ManagedChannelBuilder.forAddress("localhost", runner.getAllocatedPort())
+                      .usePlaintext()
+                      .build();
+
+              try {
+                var stub = GreeterGrpc.newBlockingStub(channel);
+                var response =
+                    stub.sayHello(HelloRequest.newBuilder().setName("Pablo Marmol").build());
+
+                assertThat(response.getMessage()).isEqualTo("Hello Pablo Marmol");
+              } finally {
+                channel.shutdown();
+              }
+            });
+  }
+
+  @ServerTest
+  void shouldHandleDeadlineExceeded(ServerTestRunner runner) {
+    runner
+        .options(new ServerOptions().setHttp2(true).setSecurePort(8443))
+        .define(this::setupApp)
+        .ready(
+            http -> {
+              var channel =
+                  ManagedChannelBuilder.forAddress("localhost", runner.getAllocatedPort())
+                      .usePlaintext()
+                      .build();
+
+              try {
+                // Attach an impossibly short deadline (1 millisecond) to the stub
+                var stub =
+                    GreeterGrpc.newBlockingStub(channel)
+                        .withDeadlineAfter(1, TimeUnit.MILLISECONDS);
+
+                var exception =
+                    org.junit.jupiter.api.Assertions.assertThrows(
+                        StatusRuntimeException.class,
+                        () ->
+                            stub.sayHello(
+                                HelloRequest.newBuilder().setName("Pablo Marmol").build()));
+
+                // Assert that the bridge correctly caught the timeout and returned Status 4
+                assertThat(exception.getStatus().getCode())
+                    .isEqualTo(Status.Code.DEADLINE_EXCEEDED);
+              } finally {
+                channel.shutdown();
+              }
+            });
+  }
+
+  @ServerTest
+  void shouldHandleBidiStreaming(ServerTestRunner runner) {
+    runner
+        .options(new ServerOptions().setHttp2(true).setSecurePort(8443))
+        .define(this::setupApp)
+        .ready(
+            http -> {
+              var channel =
+                  ManagedChannelBuilder.forAddress("localhost", runner.getAllocatedPort())
+                      .usePlaintext()
+                      .build();
+
+              try {
+                var asyncStub = ChatServiceGrpc.newStub(channel);
+                var responses = new CopyOnWriteArrayList<String>();
+                var latch = new CountDownLatch(1);
+
+                StreamObserver<ChatMessage> responseObserver =
+                    new StreamObserver<>() {
+                      @Override
+                      public void onNext(ChatMessage value) {
+                        responses.add(value.getText());
+                      }
+
+                      @Override
+                      public void onError(Throwable t) {
+                        latch.countDown();
+                      }
+
+                      @Override
+                      public void onCompleted() {
+                        latch.countDown();
+                      }
+                    };
+
+                var requestObserver = asyncStub.chatStream(responseObserver);
+
+                requestObserver.onNext(
+                    ChatMessage.newBuilder().setUser("JavaClient").setText("Ping 1").build());
+
+                // Add a tiny delay to prevent CI thread-scheduler race conditions
+                // where the server closes the stream before Undertow finishes flushing Ping 2.
+                Thread.sleep(50);
+
+                requestObserver.onNext(
+                    ChatMessage.newBuilder().setUser("JavaClient").setText("Ping 2").build());
+
+                // Allow Ping 2 to reach the server before sending the close signal
+                Thread.sleep(50);
+
+                requestObserver.onCompleted();
+
+                // Wait for the server stream to gracefully complete
+                boolean completed = latch.await(5, TimeUnit.SECONDS);
+
+                assertThat(completed).isTrue();
+                assertThat(responses).containsExactly("Echo: Ping 1", "Echo: Ping 2");
+
+              } catch (InterruptedException e) {
+                Thread.currentThread().interrupt();
+              } finally {
+                channel.shutdown();
+              }
+            });
+  }
+
+  @ServerTest
+  void shouldHandleServerStreaming(ServerTestRunner runner) {
+    runner
+        .options(new ServerOptions().setHttp2(true).setSecurePort(8443))
+        .define(this::setupApp)
+        .ready(
+            http -> {
+              var channel =
+                  ManagedChannelBuilder.forAddress("localhost", runner.getAllocatedPort())
+                      .usePlaintext()
+                      .build();
+
+              try {
+                var asyncStub = ChatServiceGrpc.newStub(channel);
+                var responses = new CopyOnWriteArrayList<String>();
+                var latch = new CountDownLatch(1);
+
+                StreamObserver<ChatMessage> responseObserver =
+                    new StreamObserver<>() {
+                      @Override
+                      public void onNext(ChatMessage value) {
+                        responses.add(value.getText());
+                      }
+
+                      @Override
+                      public void onError(Throwable t) {
+                        latch.countDown();
+                      }
+
+                      @Override
+                      public void onCompleted() {
+                        latch.countDown();
+                      }
+                    };
+
+                // Assuming a server-streaming method exists: rpc ServerStream(ChatMessage) returns
+                // (stream ChatMessage)
+                // asyncStub.serverStream(ChatMessage.newBuilder().setText("Trigger").build(),
+                // responseObserver);
+                //
+                // boolean completed = latch.await(5, TimeUnit.SECONDS);
+                // assertThat(completed).isTrue();
+                // assertThat(responses.size()).isGreaterThan(1);
+
+              } finally {
+                channel.shutdown();
+              }
+            });
+  }
+
+  @ServerTest
+  void shouldHandleReflection(ServerTestRunner runner) {
+    runner
+        .options(new ServerOptions().setHttp2(true).setSecurePort(8443))
+        .define(this::setupApp)
+        .ready(
+            http -> {
+              var channel =
+                  ManagedChannelBuilder.forAddress("localhost", runner.getAllocatedPort())
+                      .usePlaintext()
+                      .build();
+
+              try {
+                var stub = ServerReflectionGrpc.newStub(channel);
+                var registeredServices = new CopyOnWriteArrayList<String>();
+                var latch = new CountDownLatch(1);
+
+                StreamObserver<ServerReflectionResponse> responseObserver =
+                    new StreamObserver<>() {
+                      @Override
+                      public void onNext(ServerReflectionResponse response) {
+                        response
+                            .getListServicesResponse()
+                            .getServiceList()
+                            .forEach(s -> registeredServices.add(s.getName()));
+                      }
+
+                      @Override
+                      public void onError(Throwable t) {
+                        latch.countDown();
+                      }
+
+                      @Override
+                      public void onCompleted() {
+                        latch.countDown();
+                      }
+                    };
+
+                var requestObserver = stub.serverReflectionInfo(responseObserver);
+
+                requestObserver.onNext(
+                    ServerReflectionRequest.newBuilder()
+                        .setListServices("")
+                        .setHost("localhost")
+                        .build());
+                requestObserver.onCompleted();
+
+                boolean completed = latch.await(5, TimeUnit.SECONDS);
+
+                assertThat(completed).isTrue();
+                assertThat(registeredServices)
+                    .contains(
+                        "io.jooby.i3875.Greeter",
+                        "io.jooby.i3875.ChatService",
+                        "grpc.reflection.v1.ServerReflection");
+
+              } catch (InterruptedException e) {
+                Thread.currentThread().interrupt();
+              } finally {
+                channel.shutdown();
+              }
+            });
+  }
+
+  @ServerTest
+  void shouldHandleGrpcurlReflection(ServerTestRunner runner) {
+    org.junit.jupiter.api.Assumptions.assumeTrue(
+        isGrpcurlInstalled(), "grpcurl is not installed. Skipping strict HTTP/2 compliance test.");
+
+    runner
+        .options(new ServerOptions().setHttp2(true).setSecurePort(8443))
+        .define(this::setupApp)
+        .ready(
+            http -> {
+              try {
+                var pb =
+                    new ProcessBuilder(
+                        "grpcurl", "-plaintext", "localhost:" + runner.getAllocatedPort(), "list");
+
+                var process = pb.start();
+                var output =
+                    new String(process.getInputStream().readAllBytes(), StandardCharsets.UTF_8);
+                var error =
+                    new String(process.getErrorStream().readAllBytes(), StandardCharsets.UTF_8);
+
+                int exitCode = process.waitFor();
+
+                assertThat(exitCode)
+                    .withFailMessage("grpcurl failed with error: " + error)
+                    .isEqualTo(0);
+
+                assertThat(output)
+                    .contains(
+                        "io.jooby.i3875.Greeter",
+                        "io.jooby.i3875.ChatService",
+                        "grpc.reflection.v1.ServerReflection");
+
+              } catch (Exception e) {
+                throw new RuntimeException("Failed to execute grpcurl test", e);
+              }
+            });
+  }
+
+  /**
+   * When a gRPC client requests a method that doesn't exist, our native handlers will ignore it.
+   * Jooby's core router will then catch it and return a standard HTTP 404 Not Found. According to
+   * the gRPC-over-HTTP/2 specification, the gRPC client will automatically translate a pure HTTP
+   * 404 into a gRPC UNIMPLEMENTED (Status Code 12) exception.
+   *
+   * @param runner Sever runner.
+   */
+  @ServerTest
+  void shouldHandleMethodNotFound(ServerTestRunner runner) {
+    runner
+        .options(new ServerOptions().setHttp2(true).setSecurePort(8443))
+        .define(this::setupApp)
+        .ready(
+            http -> {
+              var channel =
+                  ManagedChannelBuilder.forAddress("localhost", runner.getAllocatedPort())
+                      .usePlaintext()
+                      .build();
+
+              try {
+                // 1. Create a fake method descriptor for a non-existent method
+                var unknownMethod =
+                    io.grpc.MethodDescriptor.<HelloRequest, HelloReply>newBuilder()
+                        .setType(io.grpc.MethodDescriptor.MethodType.UNARY)
+                        .setFullMethodName("io.jooby.i3875.Greeter/UnknownMethod")
+                        .setRequestMarshaller(
+                            io.grpc.protobuf.ProtoUtils.marshaller(
+                                HelloRequest.getDefaultInstance()))
+                        .setResponseMarshaller(
+                            io.grpc.protobuf.ProtoUtils.marshaller(HelloReply.getDefaultInstance()))
+                        .build();
+
+                // 2. Execute the call manually and expect an exception
+                var exception =
+                    org.junit.jupiter.api.Assertions.assertThrows(
+                        io.grpc.StatusRuntimeException.class,
+                        () ->
+                            io.grpc.stub.ClientCalls.blockingUnaryCall(
+                                channel,
+                                unknownMethod,
+                                io.grpc.CallOptions.DEFAULT,
+                                HelloRequest.newBuilder().setName("Pablo Marmol").build()));
+
+                // 3. Assert that Jooby's HTTP 404 is correctly translated by the gRPC client into
+                // UNIMPLEMENTED
+                assertThat(exception.getStatus().getCode())
+                    .isEqualTo(io.grpc.Status.Code.UNIMPLEMENTED);
+
+              } finally {
+                channel.shutdown();
+              }
+            });
+  }
+
+  private boolean isGrpcurlInstalled() {
+    try {
+      var process = new ProcessBuilder("grpcurl", "-version").start();
+      return process.waitFor() == 0;
+    } catch (Exception e) {
+      return false;
+    }
+  }
+}
diff --git a/tests/src/test/java/io/jooby/test/Http2Test.java b/tests/src/test/java/io/jooby/test/Http2Test.java
index f0405aeda1..89796b2e35 100644
--- a/tests/src/test/java/io/jooby/test/Http2Test.java
+++ b/tests/src/test/java/io/jooby/test/Http2Test.java
@@ -42,7 +42,7 @@ public class Http2Test {
   @ServerTest
   public void h2body(ServerTestRunner runner) {
     runner
-        .options(new ServerOptions().setHttp2(true).setSecurePort(8443))
+        .options(new ServerOptions().setHttp2(true))
         .define(
             app -> {
               app.install(new JacksonModule());
diff --git a/tests/src/test/java/io/jooby/test/WebClient.java b/tests/src/test/java/io/jooby/test/WebClient.java
index 8236117b5f..8ed789c3c9 100644
--- a/tests/src/test/java/io/jooby/test/WebClient.java
+++ b/tests/src/test/java/io/jooby/test/WebClient.java
@@ -5,6 +5,8 @@
  */
 package io.jooby.test;
 
+import static okhttp3.RequestBody.create;
+
 import java.io.IOException;
 import java.net.SocketTimeoutException;
 import java.nio.charset.StandardCharsets;
@@ -14,6 +16,7 @@
 import java.security.cert.X509Certificate;
 import java.util.ArrayList;
 import java.util.List;
+import java.util.Map;
 import java.util.concurrent.*;
 import java.util.concurrent.atomic.AtomicBoolean;
 import java.util.function.BiConsumer;
@@ -225,10 +228,16 @@ public Request invoke(String method, String path) {
   }
 
   public Request invoke(String method, String path, RequestBody body) {
-    okhttp3.Request.Builder req = new okhttp3.Request.Builder();
+    return invoke(method, path, Map.of(), body);
+  }
+
+  public Request invoke(String method, String path, Map<String, Object> query, RequestBody body) {
+    var req = new okhttp3.Request.Builder();
     req.method(method, body);
     setRequestHeaders(req);
-    req.url(scheme + "://localhost:" + port + path);
+    var url = HttpUrl.parse(scheme + "://localhost:" + port + path).newBuilder();
+    query.forEach((name, value) -> url.addQueryParameter(name, value.toString()));
+    req.url(url.build());
     return new Request(req);
   }
 
@@ -245,7 +254,11 @@ private void setRequestHeaders(okhttp3.Request.Builder req) {
   }
 
   public Request get(String path) {
-    return invoke("GET", path, null);
+    return get(path, Map.of());
+  }
+
+  public Request get(String path, Map<String, Object> query) {
+    return invoke("GET", path, query, null);
   }
 
   public ServerSentMessageIterator sse(String path) {
@@ -294,6 +307,11 @@ public void get(String path, SneakyThrows.Consumer<Response> callback) {
     get(path).execute(callback);
   }
 
+  public void get(
+      String path, Map<String, Object> query, SneakyThrows.Consumer<Response> callback) {
+    get(path, query).execute(callback);
+  }
+
   public void syncWebSocket(String path, SneakyThrows.Consumer<BlockingWebSocket> consumer) {
     okhttp3.Request.Builder req = new okhttp3.Request.Builder();
     req.url("ws://localhost:" + port + path);
@@ -359,6 +377,10 @@ public void post(String path, RequestBody form, SneakyThrows.Consumer<Response>
     post(path, form).execute(callback);
   }
 
+  public void postJson(String path, String json, SneakyThrows.Consumer<Response> callback) {
+    post(path, create(json, MediaType.parse("application/json"))).execute(callback);
+  }
+
   public Request put(String path) {
     return invoke("put", path, EMPTY_BODY);
   }
diff --git a/tests/src/test/kotlin/i3863/KMovieService.kt b/tests/src/test/kotlin/i3863/KMovieService.kt
new file mode 100644
index 0000000000..2f6de68d1f
--- /dev/null
+++ b/tests/src/test/kotlin/i3863/KMovieService.kt
@@ -0,0 +1,71 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package i3863
+
+import io.jooby.annotation.Trpc
+import io.jooby.annotation.Trpc.Mutation
+import io.jooby.i3863.Metadata
+import io.jooby.i3863.Movie
+import java.util.stream.Collectors
+
+@Trpc("movies")
+class KMovieService {
+  private val database =
+    listOf<Movie?>(Movie(1, "The Godfather", 1972), Movie(2, "Pulp Fiction", 1994))
+
+  /** Procedure: movies.create Takes a single complex object. */
+  @Mutation
+  fun create(movie: Movie?): Movie? {
+    // In a real app, save to DB. For now, just return it.
+    return movie
+  }
+
+  @Mutation fun resetIndex() {}
+
+  /** Procedure: movies.bulkCreate Takes a List of complex objects. */
+  @Trpc.Query
+  fun bulkCreate(movies: List<Movie>): List<String> {
+    return movies
+      .stream()
+      .map<String?> { m: Movie -> "Created: " + m.title }
+      .collect(Collectors.toList())
+  }
+
+  /** Procedure: movies.ping */
+  @Trpc.Query
+  fun ping(): String {
+    return "pong"
+  }
+
+  /** Procedure: movies.getById Single primitive argument */
+  @Trpc.Query
+  fun getById(id: Int): Movie? {
+    return database.stream().filter { m: Movie? -> m!!.id == id }.findFirst().orElse(null)
+  }
+
+  /** Procedure: movies.search Multi-argument (Tuple) */
+  @Trpc.Query
+  fun search(title: String, year: Int?): List<Movie?> {
+    return database
+      .stream()
+      .filter { m: Movie? -> m!!.title.contains(title) && (year == null || m.year == year) }
+      .toList()
+  }
+
+  /** Procedure: movies.addReview Mix of String and int (Mutation) */
+  @Mutation
+  fun addReview(movieTitle: String, stars: Int, comment: String?): Map<String, Any> {
+    // Business logic...
+    return mapOf("title" to movieTitle, "rating" to stars, "status" to "published")
+  }
+
+  /** Procedure: movies.addReview Mix of String and int (Mutation) */
+  @Mutation
+  fun updateMetadata(id: Int, metadata: Metadata?): Metadata? {
+    // Business logic...
+    return metadata
+  }
+}
diff --git a/tests/src/test/kotlin/i3868/KtMovieService.kt b/tests/src/test/kotlin/i3868/KtMovieService.kt
new file mode 100644
index 0000000000..2bd8888185
--- /dev/null
+++ b/tests/src/test/kotlin/i3868/KtMovieService.kt
@@ -0,0 +1,40 @@
+/*
+ * Jooby https://jooby.io
+ * Apache License Version 2.0 https://jooby.io/LICENSE.txt
+ * Copyright 2014 Edgar Espina
+ */
+package i3868
+
+import io.jooby.annotation.*
+import io.jooby.exception.NotFoundException
+import io.jooby.i3863.Movie
+import java.util.function.Supplier
+
+@JsonRpc("movies")
+@Path("/api/movies")
+class KtMovieService {
+  private val database: List<Movie> =
+    listOf(Movie(1, "The Godfather", 1972), Movie(2, "Pulp Fiction", 1994))
+
+  /** Procedure: movies.create Takes a single complex object. */
+  @POST
+  @Trpc
+  fun create(movie: Movie): Movie {
+    // In a real app, save to DB. For now, just return it.
+    return movie
+  }
+
+  fun getById(id: Int): Movie {
+    return database
+      .stream()
+      .filter { m: Movie -> m.id == id }
+      .findFirst()
+      .orElseThrow<NotFoundException?>(Supplier { NotFoundException("Movie not found: " + id) })
+  }
+
+  fun search(title: String, year: Int): List<Movie> {
+    return database.stream().filter { m -> m.title.contains(title) && (m.year == year) }.toList()
+  }
+
+  fun deleteMovie(id: Int) {}
+}