@stacksjs/defaults 0.70.251 → 0.70.253

package/ai/skills/stacks-buddy/SKILL.md

@@ -126,15 +126,26 @@ buddy dev -o/--docs          # docs only
 buddy dev -s/--system-tray   # system tray only
 buddy dev -i/--interactive   # interactive server selection menu
 buddy dev -l/--with-localhost # include localhost URL in output
+buddy dev --browser          # open the browser app instead of a configured native window
+buddy dev --site             # open the marketing site instead of the detected app entry
 buddy dev -p/--project [name]
 buddy dev --verbose
 ```
 
+When `config/app.ts` defines `appPath` (for example, `/dashboard`), plain
+`buddy dev` treats it as the primary application URL. Set `devLaunch: 'native'`
+for a desktop app to open that URL in a Craft window by default. Use
+`buddy dev --browser` to open the application in a browser or `buddy dev --site`
+to force the marketing homepage for that session. Without `appPath`, Buddy
+detects common application views and falls back to `/` for site-only projects.
+Set `STACKS_DEV_NO_OPEN=1` when the browser should remain closed.
+
 Sub-commands with aliases:
 ```bash
 buddy dev:components         # component library dev server
 buddy dev:docs               # documentation dev server
 buddy dev:desktop            # desktop app dev server
+buddy dev:native             # equivalent native desktop app flow
 buddy dev:api                # API dev server
 buddy dev:frontend           # frontend dev server (aliases: dev:pages, dev:views)
 buddy dev:dashboard          # dashboard dev server (alias: dev:admin)

package/ai/skills/stacks-development/SKILL.md

@@ -79,6 +79,8 @@ buddy/src/commands/
 - `buddy dev` -- Start ALL dev servers in parallel (frontend, API, docs, dashboard + reverse proxy if custom domain)
 - `buddy dev [server]` -- Start a specific server: `frontend`, `api`, `components`, `dashboard`, `desktop`, `system-tray`, `docs`
 - `buddy dev -i` / `--interactive` -- Interactive prompt to choose which server to start
+- `buddy dev --browser` -- Override a configured native launch and open the browser app
+- `buddy dev --site` -- Open the marketing site instead of the app or native window
 - `buddy dev --verbose` -- Show detailed output including proxy info and dependency logs
 - `buddy dev:frontend` (aliases: `dev:pages`, `dev:views`) -- Frontend only
 - `buddy dev:api` -- API server only
@@ -86,6 +88,7 @@ buddy/src/commands/
 - `buddy dev:docs` -- Documentation server only
 - `buddy dev:components` -- Vue component library dev server
 - `buddy dev:desktop` -- Desktop app dev server
+- `buddy dev:native` -- Equivalent native app development flow
 - `buddy dev:system-tray` (alias: `dev:tray`) -- System tray dev server
 
 ### Build Commands
@@ -111,17 +114,18 @@ buddy/src/commands/
 
 ### Unified Dev Server (`buddy dev` with no arguments)
 When `buddy dev` runs without a specific server flag, `startDevelopmentServer()` in `dev.ts`:
-1. Reads port configuration from env vars (`PORT`, `PORT_API`, `PORT_DOCS`, `PORT_ADMIN`)
-2. Detects custom domain from `APP_URL` (e.g., `stacks.localhost`)
-3. Prints Vite-style banner with URLs for Frontend, API, Docs, Dashboard
-4. Sets `STACKS_PROXY_MANAGED=1` to prevent subprocesses from starting their own proxies
-5. Starts all servers in parallel via `Promise.all()`:
+1. Reads `config/app.ts` `devLaunch`; `native` opens `appPath` in Craft, while `browser` keeps the browser default
+2. Reads port configuration from env vars (`PORT`, `PORT_API`, `PORT_DOCS`, `PORT_ADMIN`)
+3. Detects custom domain from `APP_URL` (e.g., `stacks.localhost`)
+4. Prints Vite-style banner with URLs for Frontend, API, Docs, Dashboard
+5. Sets `STACKS_PROXY_MANAGED=1` to prevent subprocesses from starting their own proxies
+6. Starts all servers in parallel via `Promise.all()`:
    - `runFrontendDevServer()` -- STX template server on port 3000
    - `runApiDevServer()` -- bun-router API on port 3008
    - `runDocsDevServer()` -- bunpress docs on port 3006
    - `runDashboardDevServer()` -- STX + Craft native window on port 3002
    - `startReverseProxy()` -- rpx HTTPS proxy on port 443 (only if custom domain set)
-6. Registers SIGINT/SIGTERM handlers that `SIGKILL` the entire process group
+7. Registers SIGINT/SIGTERM handlers that `SIGKILL` the entire process group
 
 ### Action Execution (`runAction` in helpers/utils.ts)
 - Dev actions (paths starting with `dev/`) automatically get `--watch` flag via `bun --watch`

package/ide/vscode/package.json

@@ -2,7 +2,7 @@
   "publisher": "Stacks",
   "name": "vscode-stacks",
   "displayName": "Stacks",
-  "version": "0.70.251",
+  "version": "0.70.253",
   "description": "A modern Stacks development environment.",
   "license": "MIT",
   "funding": "https://github.com/sponsors/chrisbbreuer",

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/defaults",
   "type": "module",
   "sideEffects": false,
-  "version": "0.70.251",
+  "version": "0.70.253",
   "description": "The complete managed Stacks application scaffold, including runtime defaults, AI guidance, editor metadata, and npm-backed project support files.",
   "author": "Chris Breuer",
   "license": "MIT",