Renders empty HTML

[henhal]

Describe the bug

I installed AsyncAPI today to render some HTML from my spec, and have run into nothing but problems.

At first I tried using npx to invoke it:

$ npx asyncapi generate fromTemplate api/asyncapi.yml @asyncapi/html-template -o ./out

This returns without any errors, but nothing happens. Nothing at all.

I then, reluctantly, installed asyncapi globally using npm i -g and gave it another try.

$ asyncapi generate fromTemplate api/asyncapi.yml @asyncapi/html-template -o ./out

This processes my spec for a while, then announces that my HTML is found at ./out. And yes, there's an index.html and some js, but the rendered HTML is completely blank. An empty, white page.

So I went to the only AsyncAPI studio and validated my spec, and yes, it's valid - and HTML is rendered properly in the sidebar.

Obviously I'm doing something wrong, but in that case documentation is clearly not sufficient. I followed the instructions to install and render HTML from a very simple spec, and the output is void.

I also tried your own hello example with same results.

To Reproduce

Steps to reproduce the behavior:

1. Create a simple hello world document
2. Install asyncapi
3. Attempt to render from the HTML template
4. Observe the blank HTML output

Expected behavior

The rendered HTML should not be, ehrm, empty.

Sample document

asyncapi: 2.6.0
info:
  title: Hello world application
  version: '0.1.0'
channels:
  hello:
    publish:
      message:
        payload:
          type: string
          pattern: '^hello .+$'

[github-actions]

Welcome to AsyncAPI. Thanks a lot for reporting your first issue. Please check out our contributors guide and the instructions about a basic recommended setup useful for opening a pull request.
Keep in mind there are also other channels you can use to interact with AsyncAPI community. For more details check out this issue.

[henhal]

Ok so it seems this is related to the 1.0.0 release of template-html:
See this issue:
asyncapi/html-template#456

If using @asyncapi/[email protected], it works.

The npx problem still stands, though.

[grudelsud]

same here, had an empty output after validating the yaml with the online studio tool

specifying template version fixes the problem, the following command produces a working single html:

asyncapi generate fromTemplate ./docs/sqs/sqs_docs.yaml @asyncapi/[email protected] --param singleFile=true -o ./docs/sqs --force-write

for debug purposes, this is my output from asyncapi --version

@asyncapi/cli/0.60.0 darwin-x64 node-v21.1.0

[jonaslagoni]

Lets close this issue and continue in asyncapi/html-template#456 as this has nothing to do with the spec :)

[derberg]

Let's continue in asyncapi/html-template#456