blog: announce grpc-zero

Author: andreaTP

_posts/2025-09-19-grpc-zero.adoc

@@ -0,0 +1,100 @@
+---
+layout: post
+title: 'Quarkus gRPC Zero'
+date: 2025-09-19
+tags: quarkus grpc
+synopsis: 'gRPC code generation that runs on the JVM so you do not need native protoc binaries.'
+author: andreatp
+-------------------
+
+= Quarkus gRPC Zero
+
+*Make gRPC code generation portable: no native protoc, no surprises.*
+
+== TL;DR
+
+Quarkus gRPC Zero brings gRPC code generation into the JVM so you no longer need native 'protoc' binaries. Add the extension, build your project, and the generated stubs appear just like before.
+
+The important outcome is consistent, portable builds across developer machines, CI, containers, and even unusual architectures.
+
+== Why this matters
+
+If you have spent time wrestling with platform-specific `protoc` binaries, cross-compiled plugins, or flaky CI images, you know the cost: slow onboarding, fragile builds, extra Docker layers, and ongoing maintenance. Quarkus gRPC Zero removes that operational burden so teams can focus on APIs and features instead of shipping native binaries for every target OS and architecture.
+
+== What Quarkus gRPC Zero does
+
+Quarkus gRPC Zero runs the `protoc` compilation inside the JVM as a pure Java codegen step.
+
+From a developer point of view nothing changes: you keep writing `.proto` files, run your Quarkus build, and use the generated sources.
+
+The difference is that builds are portable and predictable on any JVM host.
+
+== Benefits
+
+* Portable builds that behave the same on laptops, CI, containers, and edge devices.
+* Simpler CI and smaller images because you do not need to package native executables.
+* Less maintenance for platform teams who no longer manage platform-specific toolchains.
+* A small, self-contained Java dependency that performs code generation.
+
+== Quick start
+
+Add the extension to your project. Replace 'VERSION' with the release you choose.
+
+[source,xml]
+----
+<dependency>
+  <groupId>io.quarkus</groupId>
+  <artifactId>quarkus-grpc</artifactId>
+  <exclusions>
+    <exclusion>
+      <groupId>io.quarkus</groupId>
+      <artifactId>quarkus-grpc-codegen</artifactId>
+    </exclusion>
+  </exclusions>
+</dependency>
+<dependency>
+  <groupId>io.quarkiverse.grpc.zero</groupId>
+  <artifactId>quarkus-grpc-zero</artifactId>
+  <version>VERSION</version>
+</dependency>
+----
+
+If you are migrating from an existing Quarkus gRPC setup, you need to exclude the 'quarkus-grpc-codegen' artifact from your 'quarkus-grpc' dependency and add 'quarkus-grpc-zero' instead.
+Build your project as usual and generated sources will appear during the build step.
+
+== Example workflow
+
+. Add the 'quarkus-grpc' dependency with exclusions for 'quarkus-grpc-codegen' and include 'quarkus-grpc-zero'.
+. Keep authoring '.proto' files as before.
+. Run the Quarkus build. Generated stubs will be produced on the JVM and compilation completes normally.
+
+Outcome: the developer ergonomics are unchanged, but there are no native tools to manage.
+
+== When to choose this extension
+
+* You want hermetic, reproducible builds with fewer external artifacts.
+* You support multiple platforms or unusual architectures and want to avoid maintaining binaries.
+
+== Current status and roadmap
+
+Quarkus gRPC Zero is ready for early adopters.
+
+It passes integration tests and works in typical Quarkus builds.
+We are actively improving the project and welcome feedback, real-world testing, and bug reports to guide stabilization and future features.
+
+== Try it and report any errors
+
+Please try Quarkus gRPC Zero in your projects.
+We want real-world feedback and we especially want to hear about any errors, edge cases, or surprising behavior you encounter.
+We are happy to quickly to turn things around to fix outstanding bugs.
+
+* Clone or add the extension to a test project.
+* Build on your laptop, in CI, and in any container or architecture you support.
+* If you see an error, open a ticket at the project repository: https://github.com/quarkiverse/quarkus-grpc-zero/issues[quarkiverse/quarkus-grpc-zero issues]
+
+*Call to action: try the extension today and report the results.* Your reports will directly shape the project and help us make code generation reliable for everyone.
+
+== Closing
+
+Quarkus gRPC Zero is about outcomes: consistent builds and no more native `protoc` maintenance.
+Try it, use it in your CI, and please report any feedback so we can make it production-ready for every environment.