buildx-cli 1.8.18 → 1.8.20

package/README.md

@@ -160,6 +160,12 @@ Lists available projects for the authenticated account.
 npx buildx-cli projects:list
 ```
 
+Filter by product key (`project.product.key`):
+
+```bash
+npx buildx-cli projects:list --product-key approval
+```
+
 #### `projects:set-default <project-id>`
 Sets default project used by commands when `--project-id` is not provided.
 
@@ -213,6 +219,65 @@ Validate locale format before saving.
 npx buildx-cli projects:locale:validate --default-language en-US --timezone UTC
 ```
 
+#### `project:init`
+Initialize a new Buildx project and optional app scaffold.
+
+Modes:
+- `plain`: creates standalone project via `POST /projects`.
+- `product`: tries `POST /product/:product_key/projects`, then falls back to `plain` when product creation is denied (for example non-root auth).
+
+Key options:
+- `--project-id <id>`: target project ID (required)
+- `--name <name>`: project name (required)
+- `--description <text>`: project description (optional)
+- `--product-key <key>`: enable product mode first, with fallback to plain mode
+- `--app <none|next|expo|react>`: app scaffold target (default `none`)
+- `--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
+- `--dry-run`: compute output without writing files or calling APIs
+- `--json`: print machine-readable result
+
+Examples:
+
+```bash
+# backend only (plain mode)
+npx buildx-cli project:init --project-id hello-world --name "Hello World"
+
+# product mode first, fallback to plain when not allowed
+npx buildx-cli project:init --project-id hello-world --name "Hello World" --product-key approval
+
+# backend + Next.js app
+npx buildx-cli project:init --project-id hello-world --name "Hello World" --app next
+
+# backend + Expo app
+npx buildx-cli project:init --project-id hello-world --name "Hello World" --app expo
+```
+
+Generated auth-aware structure:
+- Next.js template uses route groups for separation:
+  - `app/(public)/...` (sign-in/sign-up/forgot-password)
+  - `app/(private)/...` (protected dashboard)
+- Expo template uses auth-state route split in `App.tsx`:
+  - public screen tree for unauthenticated users
+  - private screen tree for authenticated users
+
+### New Project Maintenance
+
+After `project:init`, use these commands to maintain local/remote artifact parity:
+
+```bash
+# schema lifecycle
+npx buildx-cli schema:pull --project-id <project-id>
+npx buildx-cli schema:diff --project-id <project-id>
+npx buildx-cli schema:push --project-id <project-id> --dry-run
+
+# function lifecycle
+npx buildx-cli function:pull --project-id <project-id>
+npx buildx-cli function:diff --project-id <project-id>
+npx buildx-cli function:push --project-id <project-id> --dry-run
+```
+
 ### Users
 
 #### `user:list`
@@ -333,6 +398,7 @@ Behavior:
 
 Key options:
 - `-p, --project-id <id>`
+- `--product-key <key>` push to all projects where `project.product.key` matches (cannot be used with `--project-id`)
 - `-t, --target-dir <path>`
 - `--collections-file <path>` (when no `--target-dir`)
 - `--filter <pattern...>`
@@ -341,6 +407,7 @@ Key options:
 
 ```bash
 npx buildx-cli schema:push --project-id hello-world --target-dir ./.sandbox/buildx-cli --dry-run
+npx buildx-cli schema:push --product-key approval --target-dir ./.sandbox/buildx-cli --dry-run
 ```
 
 #### `schema:types:convert`
@@ -478,6 +545,7 @@ Behavior:
 
 Key options:
 - `-p, --project-id <id>`
+- `--product-key <key>` push to all projects where `project.product.key` matches (cannot be used with `--project-id`)
 - `-t, --target-dir <path>`
 - `--functions-dir <path>` (when no `--target-dir`)
 - `-n, --name <function-name>` for a single function
@@ -489,6 +557,7 @@ Key options:
 
 ```bash
 npx buildx-cli function:push --project-id hello-world --target-dir ./.sandbox/buildx-cli --dry-run
+npx buildx-cli function:push --product-key approval --target-dir ./.sandbox/buildx-cli --dry-run
 ```
 
 #### `function:list`

package/dist/README.md

@@ -160,6 +160,12 @@ Lists available projects for the authenticated account.
 npx buildx-cli projects:list
 ```
 
+Filter by product key (`project.product.key`):
+
+```bash
+npx buildx-cli projects:list --product-key approval
+```
+
 #### `projects:set-default <project-id>`
 Sets default project used by commands when `--project-id` is not provided.
 
@@ -213,6 +219,65 @@ Validate locale format before saving.
 npx buildx-cli projects:locale:validate --default-language en-US --timezone UTC
 ```
 
+#### `project:init`
+Initialize a new Buildx project and optional app scaffold.
+
+Modes:
+- `plain`: creates standalone project via `POST /projects`.
+- `product`: tries `POST /product/:product_key/projects`, then falls back to `plain` when product creation is denied (for example non-root auth).
+
+Key options:
+- `--project-id <id>`: target project ID (required)
+- `--name <name>`: project name (required)
+- `--description <text>`: project description (optional)
+- `--product-key <key>`: enable product mode first, with fallback to plain mode
+- `--app <none|next|expo|react>`: app scaffold target (default `none`)
+- `--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
+- `--dry-run`: compute output without writing files or calling APIs
+- `--json`: print machine-readable result
+
+Examples:
+
+```bash
+# backend only (plain mode)
+npx buildx-cli project:init --project-id hello-world --name "Hello World"
+
+# product mode first, fallback to plain when not allowed
+npx buildx-cli project:init --project-id hello-world --name "Hello World" --product-key approval
+
+# backend + Next.js app
+npx buildx-cli project:init --project-id hello-world --name "Hello World" --app next
+
+# backend + Expo app
+npx buildx-cli project:init --project-id hello-world --name "Hello World" --app expo
+```
+
+Generated auth-aware structure:
+- Next.js template uses route groups for separation:
+  - `app/(public)/...` (sign-in/sign-up/forgot-password)
+  - `app/(private)/...` (protected dashboard)
+- Expo template uses auth-state route split in `App.tsx`:
+  - public screen tree for unauthenticated users
+  - private screen tree for authenticated users
+
+### New Project Maintenance
+
+After `project:init`, use these commands to maintain local/remote artifact parity:
+
+```bash
+# schema lifecycle
+npx buildx-cli schema:pull --project-id <project-id>
+npx buildx-cli schema:diff --project-id <project-id>
+npx buildx-cli schema:push --project-id <project-id> --dry-run
+
+# function lifecycle
+npx buildx-cli function:pull --project-id <project-id>
+npx buildx-cli function:diff --project-id <project-id>
+npx buildx-cli function:push --project-id <project-id> --dry-run
+```
+
 ### Users
 
 #### `user:list`
@@ -333,6 +398,7 @@ Behavior:
 
 Key options:
 - `-p, --project-id <id>`
+- `--product-key <key>` push to all projects where `project.product.key` matches (cannot be used with `--project-id`)
 - `-t, --target-dir <path>`
 - `--collections-file <path>` (when no `--target-dir`)
 - `--filter <pattern...>`
@@ -341,6 +407,7 @@ Key options:
 
 ```bash
 npx buildx-cli schema:push --project-id hello-world --target-dir ./.sandbox/buildx-cli --dry-run
+npx buildx-cli schema:push --product-key approval --target-dir ./.sandbox/buildx-cli --dry-run
 ```
 
 #### `schema:types:convert`
@@ -478,6 +545,7 @@ Behavior:
 
 Key options:
 - `-p, --project-id <id>`
+- `--product-key <key>` push to all projects where `project.product.key` matches (cannot be used with `--project-id`)
 - `-t, --target-dir <path>`
 - `--functions-dir <path>` (when no `--target-dir`)
 - `-n, --name <function-name>` for a single function
@@ -489,6 +557,7 @@ Key options:
 
 ```bash
 npx buildx-cli function:push --project-id hello-world --target-dir ./.sandbox/buildx-cli --dry-run
+npx buildx-cli function:push --product-key approval --target-dir ./.sandbox/buildx-cli --dry-run
 ```
 
 #### `function:list`