Open in CodeSandbox Web Editor | VS Code | VS Code Insiders

I would like to update the behaviour to scanning ~/modules/<module-name>/module.ts so user can have the same structure as https://github.com/nuxt/starter/tree/module/src

Also, modules tends to include files so a directory is better for separation of concerns.

This way it's easier to extract when then want to publish their package to the Nuxt community

Well actually I would prefer~/modules/<module-name>/index.ts which makes the most sense.

Why did we decide to go with module.ts on https://github.com/nuxt/starter/tree/module/src ?

For module builder package template, top-level index is reserved for util exports.

BTW for local scanning, {name}/{index,module}.ts seems a good idea since it is not a package with such reservations.

I will try to keep it simple to modules/{name}/index.ts then 😊

Explaining to rename to module.ts when packaging in order to let them export utils makes perfect sense.

I guess we could also support top-level file for very simple modules?

I'm okay with either convention in local dir. Each has cons and pros.

I'm against this idea. Although auto registering modules inside ~/modules folder is convenient, not everytime the developer would want to load the modules in alphabetical order.

not everytime the developer would want to load the modules in alphabetical order.

I fully agree, and because of that, when you manually specify them in modules[] in configuration, they will be kept in your custom order.

@HigherOrderLogic well you can do:

modules/
  1.c-module/
  2.d-module/

Similar to what we have in Nuxt Content for ordering links in the generated navigation.

Might be worth adding to the docs?

How to ignore local modules that I don't want to be automatically registered

You can use a different directory, nest them in a folder under ~/modules, or change dir.modules.

Regarding ordering, from the PR I understand that local modules load after nuxt.options.modules (maybe need to mention that in the docs) - is there a possibility to have one before (like the first loaded module possibly)? Not sure if adding the local module path to nuxt.options.modules could double-load it (if in dir.modules).

How to ignore local modules that I don't want to be automatically registered

We can also add functionality for prepending filename with . to ignore through a PR you think? 🙂

actually I would prefer~/modules//index.ts which makes the most sense.

The thing (for me at least) was to have consistent file-scanning in Nuxt (like #18418) because when the behaviour is different, it tends to confuse (me at least); though this PR has been long-released now. 😅

(Sorry for continuing the thread!)

I think we already respect current ignore option when scanning modules.

And if local modules are added to nuxt.options.modules then they will run at that point and not be rerun later on (just like with nuxt.options.plugins.