[BUG] Missing CSS/JS when generating without `singleFile`

[Shurtu-gal]

Describe the bug.

When generating docs with @asyncapi/html-template version 3.3.0+, the generated index.html references CSS and JS files, but they are not created in the output folder when singleFile is not used.

With 3.2.0, both singleFile=true and singleFile=false modes worked correctly. Starting with 3.3.0, only singleFile=true works.

Tip

I suspect the issue is with the new conditional generation added.

Expected behavior

• If singleFile=true: generate one standalone HTML file with bundled CSS/JS (works fine in 3.3.1 also).
• If singleFile=false (or not passed): generate index.html + referenced css/ and js/ assets (broken in 3.3.0+).

Screenshots

How to Reproduce

1. Run: ./bin/run generate fromTemplate asyncapi.yaml @asyncapi/html-template -o ../docs --use-new-generator --force-write

2. Example spec (simplified):

asyncapi: 3.0.0
info:
  title: Account Service
  version: 1.0.0
channels:
  userSignedup:
    address: user/signedup
    messages:
      UserSignedUp:
        $ref: '#/components/messages/UserSignedUp'
components:
  messages:
    UserSignedUp:
      payload:
        type: object
        properties:
          email:
            type: string

3. Open the generated index.html in the browser.

4. Notice that it references CSS/JS files, but none are generated.

🖥️ Device Information [optional]

• Operating System (OS):
• Browser:
• Browser Version:

👀 Have you checked for similar open issues?

• I checked and didn't find similar issue

🏢 Have you read the Contributing Guidelines?

• I have read the Contributing Guidelines

Are you willing to work on this issue ?

None

[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.

[georgyturevich]

I have the same issue.

Versions of asyncapi/html-template/generator are bellow:

$ asyncapi --version
@asyncapi/cli/3.5.2 linux-x64 node-v24.7.0

$ npm list -g @asyncapi/html-template
/home/georgii/.nvm/versions/node/v24.7.0/lib
└─┬ @asyncapi/cli@3.5.2
  └─┬ generator-v2@npm:@asyncapi/generator@2.8.3
    └── @asyncapi/html-template@3.3.1

[batchu5]

is it still valid?? I would like to work on this
@Shurtu-gal

[Shurtu-gal]

I believe so.

[batchu5]

okay I'm working on it

[batchu5]

I think it is working now not an bug anymore

[Shurtu-gal]

I think it is working now not an bug anymore

Please try with version 3.3.0

[batchu5]

@Shurtu-gal I tried using html-template version 3.3.0. The CSS and JS files are generated, but index.html isn’t referencing them. It only contains inline script and CSS instead of linking to the external files.

but you said, When generating docs with @asyncapi/html-template version 3.3.0+, the generated index.html references CSS and JS files, but they are not created in the output folder when singleFile is not used.

the command I used : asyncapi generate fromTemplate asyncapi.yaml @asyncapi/html-template@3.3.0 --use-new-generator -o output -p singleFile=false

Am i doing something wrong?

[Shurtu-gal]

No that might also be an issue.

[batchu5]

@Shurtu-gal I have checked with version 3.3.0 by cloning the repo and switching to branch v3.3.1

this is package.json

example.yml is the code you provided
and generated the output using command npm run test:example

I'm not getting any error

[Shurtu-gal]

Yeah, test won't give the error. To reproduce it, need to run with generator.

[derberg]

checked with latest 3.3.1

Problem might be in https://github.com/asyncapi/generator/blob/master/apps/generator/lib/templates/config/loader.js#L47. Tests should be checked for loadDefaultValues.

in html-template config https://github.com/asyncapi/html-template/blob/master/package.json#L90-L93 singleFile default is false. So if you do not pass this parameter, false value should be injected with context into generation process.

This false default value is critical for another setting (conditional generation): https://github.com/asyncapi/html-template/blob/master/package.json#L63-L75 which means that required css and js folders will be rendered in output only fi singleFile is set to false.

asyncapi generate fromTemplate test/spec/asyncapi_v3.yml ./ -o dupa --use-new-generator --force-write -p singleFile=false works as expected, false goes through, so directories are there. Of course flah singleFile=true works as well.

---

Problem is that during generation in case like asyncapi generate fromTemplate test/spec/asyncapi_v3.yml ./ -o dupa --use-new-generator --force-write the template gets singleFile as undefined (doesn't get it at all). I can only see the following defaults

{
  "outFilename": "index.html",
  "pdfTimeout": 30000
}

So there is for sure a bug in generator, it is not handling default values set to false