buildx-cli 1.8.24 → 1.8.25

package/README.md

@@ -236,6 +236,7 @@ Key options:
 - `--react-stack <vite|next|expo-web>`: required when `--app react`
 - `--out-dir <path>`: output workspace directory (default `./<project-id>`)
 - `--overwrite`: allow writing into non-empty output directory
+- `--use-existing`: allow using existing `project_id` without creating a new backend project
 - `--dry-run`: compute output without writing files or calling APIs
 - `--json`: print machine-readable result
 
@@ -256,8 +257,25 @@ npx buildx-cli project:init --project-id hello-world --name "Hello World" --app
 
 # backend + Expo app
 npx buildx-cli project:init --project-id hello-world --name "Hello World" --app expo
+
+# existing backend project id (reuse backend, scaffold local files)
+npx buildx-cli project:init --project-id hello-world --name "Hello World" --app next --use-existing
 ```
 
+Existing project behavior:
+- CLI checks existing project IDs before create.
+- If `project_id` already exists:
+  - interactive mode asks for confirmation to continue with existing backend.
+  - with `--use-existing`, CLI skips confirmation and continues directly.
+  - with `--json` and no `--use-existing`, CLI exits with error (no interactive prompt in JSON mode).
+
+Next.js starter behavior (`--app next`):
+- public/private route split remains (`app/(public)` and `app/(private)`).
+- root app shell includes a reusable navbar.
+- includes built-in theme mode setup (`light|dark|system`) with toggle.
+- includes built-in locale setup (`en|th`) with selector.
+- auth screens use shared UI pack components without forcing full-screen background, so page/layout background is controlled by the generated app.
+
 #### `project:add-pack`
 Add Buildx pack dependencies into an existing project package.
 

package/dist/README.md

@@ -236,6 +236,7 @@ Key options:
 - `--react-stack <vite|next|expo-web>`: required when `--app react`
 - `--out-dir <path>`: output workspace directory (default `./<project-id>`)
 - `--overwrite`: allow writing into non-empty output directory
+- `--use-existing`: allow using existing `project_id` without creating a new backend project
 - `--dry-run`: compute output without writing files or calling APIs
 - `--json`: print machine-readable result
 
@@ -256,8 +257,25 @@ npx buildx-cli project:init --project-id hello-world --name "Hello World" --app
 
 # backend + Expo app
 npx buildx-cli project:init --project-id hello-world --name "Hello World" --app expo
+
+# existing backend project id (reuse backend, scaffold local files)
+npx buildx-cli project:init --project-id hello-world --name "Hello World" --app next --use-existing
 ```
 
+Existing project behavior:
+- CLI checks existing project IDs before create.
+- If `project_id` already exists:
+  - interactive mode asks for confirmation to continue with existing backend.
+  - with `--use-existing`, CLI skips confirmation and continues directly.
+  - with `--json` and no `--use-existing`, CLI exits with error (no interactive prompt in JSON mode).
+
+Next.js starter behavior (`--app next`):
+- public/private route split remains (`app/(public)` and `app/(private)`).
+- root app shell includes a reusable navbar.
+- includes built-in theme mode setup (`light|dark|system`) with toggle.
+- includes built-in locale setup (`en|th`) with selector.
+- auth screens use shared UI pack components without forcing full-screen background, so page/layout background is controlled by the generated app.
+
 #### `project:add-pack`
 Add Buildx pack dependencies into an existing project package.