[Content]: How to change the local dev port from 3000 or 3001 to something else?

[bjesuiter]

📚 Subject area/topic

/solid-start/reference/config/define-config.mdx

📋 Page(s) affected (or suggested, for new content)

https://docs.solidjs.com/solid-start/reference/config/define-config

📋 Description of content that is out-of-date or incorrect

I want to change the local port for vinxie, but i don't find how!

🖥️ Reproduction in StackBlitz (if reporting incorrect content or code samples)

No response

[bjesuiter]

I found it, i can simply pass --port to vinxi dev
=> I think, this should be documented somewhere, because my first intuition would be to set this in the app.config

[brenelz]

We currently have a callout linking to vinxi docs on this page. Thinking this is sufficient?

https://vinxi.vercel.app/api/cli.html

[jtmueller]

@brenelz I would argue that's not sufficient, if only because when I searched for how to configure the local dev port for SolidStart, I ended up on this issue and not any official documentation for SolidStart.

Not everyone is going to think to search on "vinxi" instead of "SolidStart" when working with SolidStart (I didn't) so I think it's worth specifically mentioning things devs commonly want to know, in the SolidStart docs - even when it amounts to passing a parameter to vinxi.

[jbeck111]

When evaluating SolidStart and SvelteKit side by side, the lack of clear guidance on this gave me a poor impression of SolidStart. It made me wonder what other gaps there will be in the documentation?

I went to the Vinxi docs but was not really looking for CLI commands, because as a longtime Solid and earlier Vue user, I was conditioned to (and prefer) the Vite way of setting the port configuration declaratively through the vite.config.ts file. So I thought there must be some way to do it in app.config.ts. But that lead to a fruitless, time-wasting search through unfriendly docs and typescript interfaces. Finally I had to lower my expectations, and pass the port with the dev command in package.json - even though it does not make sense to have an app.config.ts file which can't be used to specify configuration.

If there is to be no help in the SolidStart docs, then at least the default package.json dev script could be changed from "vinxi dev" to "vinxi dev --port 3000". That would provide a useful clue.