Error when trying to run "npx create-docus my-docs"

[stefanobartoletti]

I'm trying to run npx create-docus my-docs as explained in the docs here https://docus.dev/en/getting-started/installation

I'm not able to successfully run it and start the boilerplate, I'm getting this error:

~> npx create-docus docs

 ERROR  Invalid command, must be named                                                                                     17:13:39

    at runCommand (/home/stefano/.npm/_npx/9dc7c25246b1c6e5/node_modules/nuxi/dist/shared/nuxi.Cf5T5t4X.mjs:681:11)
    at Object.setup (/home/stefano/.npm/_npx/9dc7c25246b1c6e5/node_modules/create-docus/dist/main.mjs:34:13)
    at async runCommand (/home/stefano/.npm/_npx/9dc7c25246b1c6e5/node_modules/citty/dist/index.mjs:288:5)
    at async runMain (/home/stefano/.npm/_npx/9dc7c25246b1c6e5/node_modules/citty/dist/index.mjs:445:7) 



 ERROR  Invalid command, must be named                                                                                     17:13:39

I've tried both running it in an existing project (to create inside a /docs subfolder) and in an empty location, but the output is the same.

I'm not exactly sure about what's going on, as the logged info only reports errors from npm packages involved with create-docus and not something local.

If it is relevant, some environmental context:

~> npx envinfo

  System:
    OS: Linux 6.17 openSUSE Tumbleweed 20251002
    CPU: (32) x64 AMD Ryzen 9 7945HX with Radeon Graphics
    Memory: 19.34 GB / 30.52 GB
    Container: Yes
    Shell: 5.3.3 - /bin/bash
  Binaries:
    Node: 22.14.0 - /home/stefano/.nvm/versions/node/v22.14.0/bin/node
    npm: 10.9.2 - /home/stefano/.nvm/versions/node/v22.14.0/bin/npm
    pnpm: 10.18.0 - /home/stefano/.nvm/versions/node/v22.14.0/bin/pnpm

[Profesor08]

Same issue. Found this project interesting, but it fails on installation...

npx create-docus docus-dev-example

 ERROR  Invalid command, must be named                                                                        12:56:46

    at runCommand (/npm-cache/_npx/9dc7c25246b1c6e5/node_modules/nuxi/dist/shared/nuxi.Cf5T5t4X.mjs:681:11)
    at Object.setup (/npm-cache/_npx/9dc7c25246b1c6e5/node_modules/create-docus/dist/main.mjs:34:13)
    at async runCommand (/npm-cache/_npx/9dc7c25246b1c6e5/node_modules/citty/dist/index.mjs:288:5)
    at async runMain (/npm-cache/_npx/9dc7c25246b1c6e5/node_modules/citty/dist/index.mjs:445:7)

  System:
    OS: Windows 11 10.0.26100
    CPU: (24) x64 AMD Ryzen 9 3900XT 12-Core Processor
    Memory: 10.18 GB / 31.92 GB
  Binaries:
    Node: 22.14.0 - C:\Program Files\nodejs\node.EXE
    npm: 9.7.2 - C:\Program Files\nodejs\npm.CMD
    pnpm: 10.15.0 - C:\Users\prof\AppData\Local\pnpm\pnpm.EXE

[guillecro]

+1, confirming its also happening with npx create-docus my-docs -t i18n

[iqlal]

same here (+1)

[rywils]

Same issue here.

[reques6e]

same here.

 ERROR  Invalid command, must be named                                                                                                                  17:55:59  

    at runCommand (/C:/Users/Reques6e/AppData/Local/npm-cache/_npx/beed29078a8cc61e/node_modules/nuxi/dist/shared/nuxi.CM8jcyGe.mjs:690:11)
    at Object.setup (/C:/Users/Reques6e/AppData/Local/npm-cache/_npx/beed29078a8cc61e/node_modules/create-docus/dist/main.mjs:34:13)
    at async runCommand (/C:/Users/Reques6e/AppData/Local/npm-cache/_npx/beed29078a8cc61e/node_modules/citty/dist/index.mjs:288:5)
    at async runMain (/C:/Users/Reques6e/AppData/Local/npm-cache/_npx/beed29078a8cc61e/node_modules/citty/dist/index.mjs:445:7)



 ERROR  Invalid command, must be named   

[larbish]

Seems to be introduced in nuxi v3.29.0 .

I've pinned it until it's fixed so it should now be working.