"serve" command not listed

[dandv]

Documentation is

• Missing
• Outdated
• Confusing
• Not sure?

Explain in Detail

https://vitejs.dev/config/#conditional-config mentions "If the config needs to conditionally determine options based on the command (serve or build)", but serve is not listed at https://vitejs.dev/guide/cli.html

Your Suggestion for Changes

List serve at https://vitejs.dev/guide/cli.html

Reproduction

No response

Steps to reproduce

No response

[sapphi-red]

It is important to note that in Vite's API the command value is serve during dev (in the cli vite, vite dev, and vite serve are aliases), and build when building for production (vite build).
https://vitejs.dev/config/#conditional-config:~:text=It%20is%20important%20to%20note%20that%20in%20Vite%27s%20API%20the%20command%20value%20is%20serve%20during%20dev%20(in%20the%20cli%20vite%2C%20vite%20dev%2C%20and%20vite%20serve%20are%20aliases)%2C%20and%20build%20when%20building%20for%20production%20(vite%20build).

There's a explanation of this just below. I agree it's confusing. Ideally, it'd be nice to rename serve to dev, but that's a breaking change and we want to avoid that. Do you have any ideas on how to improve this?

[dandv]

Do you have any ideas on how to improve this?

Since dev is not mentioned either, how about changing "https://vitejs.dev/guide/cli.html" to start with,

Start Vite dev server in the current directory. vite dev and vite serve are aliases for vite, maintained for backwards compatibility.

[bluwy]

Updating the CLI page sounds fine to me, but I'd remove the maintained for backwards compatibility part. I don't think it's worth the breaking change to remove it in the future (as the wording seems to imply that).