From 58f660aeae2138200f786b8a62f3482f95af6365 Mon Sep 17 00:00:00 2001 From: Claude Date: Sat, 29 Aug 2026 14:03:15 +0000 Subject: [PATCH] fix(docs): correct os dev default port from 3002 to 3000 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit `reference/cli.mdx:70` claimed `os dev` defaults to port 3002. PR #143 measured the real behavior (against @objectstack/cli 17.1.0) and landed it in quickstart.mdx: os dev asks for 3000, the same port os start uses, and binds the next free port on collision. Re-verified here against 17.2.0's shipped source (packages/cli/src/commands/dev.ts, `requestedPort = port ?? '3000'`) — the default and the collision/rebind behavior are unchanged. Corrects line 70's comment and adds a short note under the block carrying the collision behavior, since that is the part that surprises a reader running `os dev` alongside `os start`. Also updates the -p example on line 71 from 4002 to 4000, since 4002 read as "3002 plus a bit." Fixes #229 --- content/docs/reference/cli.mdx | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/content/docs/reference/cli.mdx b/content/docs/reference/cli.mdx index 70d3570..062fb1e 100644 --- a/content/docs/reference/cli.mdx +++ b/content/docs/reference/cli.mdx @@ -67,10 +67,14 @@ Watches `objectstack.config.ts` and `src/`. Recompiles + reloads on save. Used as the npm `dev` script in scaffolded projects. ```bash -os dev # port 3002 by default -os dev -p 4002 +os dev # port 3000 by default +os dev -p 4000 ``` +Note `os dev` asks for the same port `os start` uses (3000). If that port +is taken it binds the next free one and says so: +`↪ server bound to port 3001 (requested 3000)`. + ## Project commands ### `os init` — scaffold a new project