buildx-cli 1.8.24 → 1.8.26

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,45 @@ 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.
+- default web UI stack is HeroUI (`@heroui/react`) as primary component framework.
+- auth screens use shared UI pack components without forcing full-screen background, so page/layout background is controlled by the generated app.
+
+Expo starter behavior (`--app expo`):
+- scaffold base runs `npx create-expo-app@latest` (TypeScript template) first.
+- mobile-first scaffold with HeroUI Native (`heroui-native`) provider and starter controls.
+- starter provider defaults disable animated-style helper noise for custom-style scaffolds:
+  - `isAnimatedStyleActive={false}`
+  - `config.devInfo.stylingPrinciples=false`
+- includes required `heroui-native` peer dependencies: `uniwind`, `tailwind-merge`, `tailwind-variants`, `react-native-gesture-handler`, `@gorhom/bottom-sheet`.
+- includes `react-native-worklets` dependency required by current `react-native-reanimated` chain.
+- keeps auth state split (public/private view) and uses shared Buildx auth provider wiring.
+- includes starter auth flows on mobile:
+  - sign-in (username/password)
+  - sign-up (name/email/tel support)
+  - EOTP request + verify
+  - forgot/reset password
+- private change-password form
+- after Buildx dependency rewiring, CLI runs install to ensure added packages are available immediately.
+- CLI also runs `expo install` for native compatibility packages (`react-native-reanimated`, `react-native-safe-area-context`, `react-native-screens`, `react-native-svg`, `react-native-worklets`, `react-native-gesture-handler`, `@gorhom/bottom-sheet`) to align with Expo SDK expectations.
+- generated Expo app includes `global.css` setup for Uniwind + HeroUI Native styles and wraps app with `GestureHandlerRootView`.
+
 #### `project:add-pack`
 Add Buildx pack dependencies into an existing project package.
 
@@ -281,14 +319,17 @@ Generated auth-aware structure:
 - Next.js scaffold source:
   - `project:init --app next` runs `npx create-next-app@latest` first (TypeScript + App Router)
   - then applies Buildx auth/public-private route wiring and maintenance scripts
+  - then runs dependency install to ensure added Buildx/HeroUI packages are present before first `dev`
 - Next.js template uses route groups for separation:
   - `app/(public)/...` (sign-in/sign-up/forgot-password)
   - `app/(private)/...` (protected dashboard)
-  - preserves create-next-app root `app/layout.tsx` (no hard overwrite)
+  - rewrites root `app/layout.tsx` and starter shell to include provider wiring (auth + theme + locale)
   - starter root `app/page.tsx` includes generic `Dashboard`, `Sign in`, and `Sign up` links with usage description
 - Expo template uses auth-state route split in `App.tsx`:
+  - `project:init --app expo` runs `npx create-expo-app@latest` first
   - public screen tree for unauthenticated users
   - private screen tree for authenticated users
+  - mobile-first baseline with `heroui-native` provider
 - Scaffold layout is single-level:
   - app package files are generated at workspace root (no `apps/web` nesting)
   - `buildx/` artifacts are generated at root level alongside app files
@@ -296,7 +337,7 @@ Generated auth-aware structure:
 UI package dependency resolution:
 - generated apps depend on package from env `BUILDX_UI_PACKS_PACKAGE`
 - default package name is `buildx-react-ui-packs`
-- default package version is `^1.8.3` (override via `BUILDX_UI_PACKS_VERSION`)
+- default package version/tag is `latest` (override via `BUILDX_UI_PACKS_VERSION`)
 - set a scoped package before seeding when unscoped npm name is unavailable:
   - `BUILDX_UI_PACKS_PACKAGE=@your-scope/buildx-react-ui-packs npx buildx-cli project:init ...`
 
@@ -305,6 +346,8 @@ Notes:
 - Use `--dry-run` to preview file plan without running scaffold commands.
 - Generated projects are package-manager agnostic (no forced `packageManager` lock in generated `package.json`).
 - Next `app/globals.css` is normalized with Tailwind `@source` to include UI pack classes from `node_modules` (prevents missing utilities like `grid-cols-2` from shared components).
+- Next starter includes `@heroui/react` by default.
+- Expo starter includes `heroui-native` by default.
 
 ### New Project Maintenance
 

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,45 @@ 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.
+- default web UI stack is HeroUI (`@heroui/react`) as primary component framework.
+- auth screens use shared UI pack components without forcing full-screen background, so page/layout background is controlled by the generated app.
+
+Expo starter behavior (`--app expo`):
+- scaffold base runs `npx create-expo-app@latest` (TypeScript template) first.
+- mobile-first scaffold with HeroUI Native (`heroui-native`) provider and starter controls.
+- starter provider defaults disable animated-style helper noise for custom-style scaffolds:
+  - `isAnimatedStyleActive={false}`
+  - `config.devInfo.stylingPrinciples=false`
+- includes required `heroui-native` peer dependencies: `uniwind`, `tailwind-merge`, `tailwind-variants`, `react-native-gesture-handler`, `@gorhom/bottom-sheet`.
+- includes `react-native-worklets` dependency required by current `react-native-reanimated` chain.
+- keeps auth state split (public/private view) and uses shared Buildx auth provider wiring.
+- includes starter auth flows on mobile:
+  - sign-in (username/password)
+  - sign-up (name/email/tel support)
+  - EOTP request + verify
+  - forgot/reset password
+- private change-password form
+- after Buildx dependency rewiring, CLI runs install to ensure added packages are available immediately.
+- CLI also runs `expo install` for native compatibility packages (`react-native-reanimated`, `react-native-safe-area-context`, `react-native-screens`, `react-native-svg`, `react-native-worklets`, `react-native-gesture-handler`, `@gorhom/bottom-sheet`) to align with Expo SDK expectations.
+- generated Expo app includes `global.css` setup for Uniwind + HeroUI Native styles and wraps app with `GestureHandlerRootView`.
+
 #### `project:add-pack`
 Add Buildx pack dependencies into an existing project package.
 
@@ -281,14 +319,17 @@ Generated auth-aware structure:
 - Next.js scaffold source:
   - `project:init --app next` runs `npx create-next-app@latest` first (TypeScript + App Router)
   - then applies Buildx auth/public-private route wiring and maintenance scripts
+  - then runs dependency install to ensure added Buildx/HeroUI packages are present before first `dev`
 - Next.js template uses route groups for separation:
   - `app/(public)/...` (sign-in/sign-up/forgot-password)
   - `app/(private)/...` (protected dashboard)
-  - preserves create-next-app root `app/layout.tsx` (no hard overwrite)
+  - rewrites root `app/layout.tsx` and starter shell to include provider wiring (auth + theme + locale)
   - starter root `app/page.tsx` includes generic `Dashboard`, `Sign in`, and `Sign up` links with usage description
 - Expo template uses auth-state route split in `App.tsx`:
+  - `project:init --app expo` runs `npx create-expo-app@latest` first
   - public screen tree for unauthenticated users
   - private screen tree for authenticated users
+  - mobile-first baseline with `heroui-native` provider
 - Scaffold layout is single-level:
   - app package files are generated at workspace root (no `apps/web` nesting)
   - `buildx/` artifacts are generated at root level alongside app files
@@ -296,7 +337,7 @@ Generated auth-aware structure:
 UI package dependency resolution:
 - generated apps depend on package from env `BUILDX_UI_PACKS_PACKAGE`
 - default package name is `buildx-react-ui-packs`
-- default package version is `^1.8.3` (override via `BUILDX_UI_PACKS_VERSION`)
+- default package version/tag is `latest` (override via `BUILDX_UI_PACKS_VERSION`)
 - set a scoped package before seeding when unscoped npm name is unavailable:
   - `BUILDX_UI_PACKS_PACKAGE=@your-scope/buildx-react-ui-packs npx buildx-cli project:init ...`
 
@@ -305,6 +346,8 @@ Notes:
 - Use `--dry-run` to preview file plan without running scaffold commands.
 - Generated projects are package-manager agnostic (no forced `packageManager` lock in generated `package.json`).
 - Next `app/globals.css` is normalized with Tailwind `@source` to include UI pack classes from `node_modules` (prevents missing utilities like `grid-cols-2` from shared components).
+- Next starter includes `@heroui/react` by default.
+- Expo starter includes `heroui-native` by default.
 
 ### New Project Maintenance