Add an node ace add command

[Julien-R44]

This PR adds the node ace add {packageName} command to the core, allowing users to install and configure a package in a single command.

With V5, we often had feedback from people complaining that X or Y package wasn't working, because they'd forgotten to type node ace configure after installing their package.

This command would avoid this. can be used like :

node ace add @adonisjs/cache

each unknown argument will be passed to the configure command. So we can do something like this :

node ace add @adonisjs/lucid --db=sqlite

if this is a dev dependency we can use the -D flag

node ace add -D adonis-sail

I've also handled the two special cases, edge and vine, which can be installed like this:

node ace add edge
node ace add vinejs

[thetutlage]

I remember we had a similar command in v4 and then many folks started criticising that AdonisJS uses its own package manager vs utilizing npm or yarn.

I suspect, if we get the same feedback again.

---

Re: People missing to run the configure command. I think, it was more of an UI issue that anything else. In v6 docs, this is how the installation section of a package looks like.

[RomainLanz]

I remember we had a similar command in v4 and then many folks started criticising that AdonisJS uses its own package manager vs utilizing npm or yarn.

I suspect, if we get the same feedback again.

I don't think we should consider this feedback. If someone's comments seem illogical or uninformed, it's not our responsibility.

Adding a node ace add command is a nice DX improvement, even for those who are aware they'll need to follow up with the configure step.

[Julien-R44]

I also think that people are now more used to this kind of CLI commands. Some popular framework has adopted the same. for example Astro : https://docs.astro.build/en/guides/integrations-guide/#automatic-integration-setup. Vue CLI ( now deprecated ), Expo, Redwood also have something like that

[thetutlage]

Cool. How do we accept and pass other CLI args to the spawned process?

[Julien-R44]

Are you talking about the arguments to be passed on to the package manager?
In that case, I'm not sure it's necessary. Except for --save-dev, which the node ace add command accepts. If you need to install an adonis package in dev only, you can do :

node ace add --dev @adonisjs/assembler

I'll add the -D alias for this

[Julien-R44]

Should be ready to merge

• added -D alias for adding as a dev dependency
• each unknown argument will be passed to the configure command. So we can do something like node ace add @adonisjs/lucid --db=sqlite.

[thetutlage]

Looks good to me. We will need some documentation for it and maybe a blog post too, explaining why we added this command and some quick examples.

[Julien-R44]

Should we also replace all the two-step package installation instructions with just a single node ace add in the documentation?

[RomainLanz]

Should we also replace all the two-step package installation instructions with just a single node ace add in the documentation?

Yes, I believe it makes sense, and we made this command to avoid people having to do two commands.

[Julien-R44]

Send a draft PR for the documentation :

adonisjs/v6-docs#44

Let's merge in the meantime