feat: add CLI v5 usage and expand generator compatibility for html-template (#766)

Varadraj75 · derberg · web-flow · commit 98281ae90e76 · 2026-01-06T15:55:41.000+01:00
Co-authored-by: Varadraj75 &lt;agrawalvaradraj2007@gmail.com&gt;
Co-authored-by: Lukasz Gornicki &lt;lpgornicki@gmail.com&gt;
diff --git a/README.md b/README.md
@@ -44,6 +44,12 @@ asyncapi generate fromTemplate <asyncapi.yaml> @asyncapi/html-template@2.3.14
 asyncapi generate fromTemplate <asyncapi.yaml> @asyncapi/html-template@3.0.0 --use-new-generator
 ```
 
+> If you use template version v3.5 with AsyncAPI Generator v3 and AsyncAPI CLI v5
+
+```bash
+asyncapi generate fromTemplate <asyncapi.yaml> @asyncapi/html-template@3.5.0
+```
+
 You can replace `<asyncapi.yaml>` with local path or URL pointing to [any AsyncAPI document](https://raw.githubusercontent.com/asyncapi/spec/refs/heads/master/examples/streetlights-kafka-asyncapi.yml).
 Look into [Releases](/asyncapi/html-template/releases) of this template to pick up the version you need. It is not recommended to always use the latest in production. Always use a specific version.
 
diff --git a/package.json b/package.json
@@ -59,7 +59,7 @@
   "generator": {
     "renderer": "react",
     "apiVersion": "v3",
-    "generator": ">=2.0.0 <3.0.0",
+    "generator": ">=2.0.0 <4.0.0",
     "conditionalGeneration": {
       "css": {
         "parameter": "singleFile",

-Original file line number
+Diff line change
 asyncapi generate fromTemplate <asyncapi.yaml> @asyncapi/[email protected] --use-new-generator
 ```
 +> If you use template version v3.5 with AsyncAPI Generator v3 and AsyncAPI CLI v5
++
 +```bash
 +asyncapi generate fromTemplate <asyncapi.yaml> @asyncapi/[email protected]
 +```
++
 You can replace `<asyncapi.yaml>` with local path or URL pointing to [any AsyncAPI document](https://raw.githubusercontent.com/asyncapi/spec/refs/heads/master/examples/streetlights-kafka-asyncapi.yml).
 Look into [Releases](/asyncapi/html-template/releases) of this template to pick up the version you need. It is not recommended to always use the latest in production. Always use a specific version.