Repository navigation
manage project structure with CLI #58
Description
This is a superset of #57 and a requirement of devtools vision.
Nuxt heavily depends on filesystem structure to configure project. As a result, we introduce filesystem entities such as pages, components, composables and plugins.
However, it is not easy to manage such entities. Creating a page, see what components are scanned, what plugins are available, what pages are there and mapped to which routes, etc.
The idea is to expose entity namespaces from nuxi cli to manage these. Some examples:
nuxi pages add <name>
nuxi pages show
nuxi pages update /blog/* --meta title="Blog:"
nuxi plugins add <name>
nuxi plugins show
nuxi plugins disable <name>
nuxi composables showRelated: nuxi module * (https://github.com/nuxt/framework/discussions/569)
By exposing this functionality from CLI (and later an API service), they can be used both for CLI lovers and also nuxt devtools to easily manage entities without duplicating logic.
Roadmap:
- Scaffold shortcuts for
nuxi add <template> <name>asnuxi <template> add <name> - Implement show for each
- Update utilities - penging unjs template (@pi0) (meanwhile ideas welcome)
- Wait for devtools to share vision and next steps
Entities we can start with:
- component
- composable
- layout
- middleware
- page
- plugin
- api
Activity
atinux commentedon Mar 25, 2022
One note for shortcuts:
apiandmiddlewarewon't take ans(nuxi middleware add auth).I really like the idea, how and where would you see the implementation?
pi0 commentedon Mar 25, 2022
indeed :) Update generic comment
Nothing is stopping to implement shortcuts for
<entity> addand then<entity> showcommands. We can have a new nuxi subcommand for each entity likenuxi/src/commands/pages.tsand a utility asnuxi/src/entity/pages.tsthat holds implementation.Next step, we need a proper utility from unjs, especially for modifications and properly test it before using it in cli. In the meantime, ideas more than welcome about what updates we could imagine. For me, could imagine adding static page meta and rename (apart from config modification. it is out of scope)
The rest needs a poc of devtools and CLI api service.
Diizzayy commentedon Mar 25, 2022
@pi0 @atinux I'll begin working on the underlying implementation for entity shortcuts
nuxi <entity> <add/show>The unjs templating util will be an integral part of way forward ( ie: proper testing and extension ) so it'll be interesting to see how we can best construct a robust solution!
mlcsthor commentedon Mar 27, 2022
Do you think it would be possible to add a custom template system? For example add this in the Nuxt config:
and then run
nuxi add custom MyCustom