nextworks 0.1.0-alpha.3 → 0.1.0-alpha.4

package/README.md

@@ -9,10 +9,10 @@ Nextworks is a CLI that installs **modular Next.js building blocks** into your a
 
 > **Status:** early‑access alpha. Expect rough edges and breaking changes between alpha releases.
 >
-> In this alpha, the most reliable setup is to install **Blocks** first using the default command:
+> In this alpha, the most reliable setup is to install **Blocks** first using:
 >
 > ```bash
-> npx nextworks add blocks
+> npx nextworks add blocks --sections --templates
 > ```
 >
 > and then add **Auth Core**, **Forms**, and **Data** on top. Partial setups (e.g. Auth/Data without Blocks) may require manual tweaks and are not yet fully supported.
@@ -52,10 +52,10 @@ From your app root:
 ### 1) Install Blocks (UI kit)
 
 ```bash
-npx nextworks add blocks
+npx nextworks add blocks --sections --templates
 ```
 
-This copies by default:
+This copies:
 
 - `components/ui/*` (core UI primitives)
 - `components/sections/*` (reusable sections)
@@ -148,14 +148,18 @@ Then visit:
 
 ## Advanced Blocks installs
 
-By default, `npx nextworks add blocks` installs **core UI primitives, sections, and templates** so the example routes under `/templates/*` work out of the box.
+For a full UI kit including core primitives, sections, and templates, use:
+
+```bash
+npx nextworks add blocks --sections --templates
+```
 
 If you want finer control:
 
 - `npx nextworks add blocks --ui-only` – install core UI primitives only (no sections/templates).
 - `npx nextworks add blocks --sections` – install core + sections only.
 - `npx nextworks add blocks --templates` – install core + templates only.
-- `npx nextworks add blocks --sections --templates` – same as the default (core + sections + templates).
+- `npx nextworks add blocks --sections --templates` – install core + sections + templates.
 
 ---
 
@@ -168,7 +172,7 @@ You can add a short “Nextworks setup” section to your app README:
 
 1. Install and run the CLI from your Next.js app root:
 
-   npx nextworks add blocks
+   npx nextworks add blocks --sections --templates
    npx nextworks add auth-core
 
 2. Copy environment variables:

package/dist/kits/auth-core/.nextworks/docs/AUTH_CORE_README.md

@@ -8,10 +8,10 @@ npx nextworks add auth-core
 
 > **Alpha note**
 >
-> In this early alpha, the Auth Core kit is tested and supported on top of the default **Blocks** install. For the smoothest experience, run:
+> In this early alpha, the Auth Core kit is tested and supported on top of a **Blocks** install that includes sections and templates. For the smoothest experience, run:
 >
 > ```bash
-> npx nextworks add blocks
+> npx nextworks add blocks --sections --templates
 > npx nextworks add auth-core
 > ```
 >

package/dist/kits/auth-core/.nextworks/docs/AUTH_QUICKSTART.md

@@ -2,10 +2,10 @@
 
 Follow these steps to get email/password auth (and optional GitHub OAuth) running in under 5 minutes.
 
-If you are using the `nextworks` CLI in your own app, the recommended alpha setup is to install Blocks first, then Auth Core:
+If you are using the `nextworks` CLI in your own app, the recommended alpha setup is to install Blocks with sections and templates first, then Auth Core:
 
 ```bash
-npx nextworks add blocks
+npx nextworks add blocks --sections --templates
 npx nextworks add auth-core
 ```
 

package/dist/kits/blocks/.nextworks/docs/BLOCKS_QUICKSTART.md

@@ -8,17 +8,17 @@ This document explains the Blocks kit: prebuilt UI sections, templates and core
 > If you are using the `nextworks` CLI in your own app, you can install this Blocks kit by running:
 >
 > ```bash
-> npx nextworks add blocks
+> npx nextworks add blocks --sections --templates
 > ```
 >
-> By default this installs **core UI primitives, sections, and page templates**, so the example templates work out of the box. The CLI will copy files into your project under `components/`, `app/templates/`, `lib/`, and `public/` as described below.
+> This installs **core UI primitives, sections, and page templates**, so the example templates work out of the box. The CLI will copy files into your project under `components/`, `app/templates/`, `lib/`, and `public/` as described below.
 >
 > Advanced:
 >
 > - `npx nextworks add blocks --ui-only` → install core UI primitives only (no sections/templates).
 > - `npx nextworks add blocks --sections` → install core + sections only.
 > - `npx nextworks add blocks --templates` → install core + templates only.
-> - `npx nextworks add blocks --sections --templates` → same as the default (core + sections + templates).
+> - `npx nextworks add blocks --sections --templates` → install core + sections + templates.
 
 What’s included
 

package/dist/kits/blocks/.nextworks/docs/BLOCKS_README.md

@@ -12,9 +12,9 @@ What the kit includes
 Install behavior
 
 > **Alpha note**
-> Other kits (Auth Core, Forms, Data) are currently tested and supported on top of a default Blocks install. For the smoothest experience, run `npx nextworks add blocks` before adding additional kits.
+> Other kits (Auth Core, Forms, Data) are currently tested and supported on top of a Blocks install that includes sections and templates. For the smoothest experience, run `npx nextworks add blocks --sections --templates` before adding additional kits.
 
-- By default, running `npx nextworks add blocks` installs **core UI primitives, sections, and templates** so the example templates work out of the box.
+- For a full UI kit, run `npx nextworks add blocks --sections --templates` to install **core UI primitives, sections, and templates** so the example templates work out of the box.
 - You can pass flags to control what gets installed:
   - `npx nextworks add blocks --ui-only` → core UI primitives only (no sections/templates).
   - `npx nextworks add blocks --sections` → core + sections only.

package/dist/kits/data/.nextworks/docs/DATA_QUICKSTART.md

@@ -7,10 +7,10 @@ Prerequisites
 - A running PostgreSQL database and `DATABASE_URL` set in `.env`.
 - Auth kit installed and configured (NextAuth + Prisma). The Data kit relies on NextAuth session for access control.
   - In the monorepo, this is already wired up.
-  - In your own app via the CLI, the recommended alpha setup is to install Blocks + Auth Core + Forms first, then Data:
+  - In your own app via the CLI, the recommended alpha setup is to install Blocks (with sections + templates) + Auth Core + Forms first, then Data:
 
     ```bash
-    npx nextworks add blocks
+    npx nextworks add blocks --sections --templates
     npx nextworks add auth-core
     npx nextworks add forms
     npx nextworks add data

package/dist/kits/data/.nextworks/docs/DATA_README.md

@@ -10,10 +10,10 @@ and is packaged with its own kit dependencies metadata.
 
 > **Alpha note**
 >
-> In this early alpha, the Data kit is tested and supported on top of the default **Blocks** and **Auth Core** (and Forms) installs. For the smoothest experience, run:
+> In this early alpha, the Data kit is tested and supported on top of **Blocks** (with sections + templates), **Auth Core**, and **Forms**. For the smoothest experience, run:
 >
 > ```bash
-> npx nextworks add blocks
+> npx nextworks add blocks --sections --templates
 > npx nextworks add auth-core
 > npx nextworks add forms
 > npx nextworks add data

package/dist/kits/forms/.nextworks/docs/FORMS_QUICKSTART.md

@@ -2,10 +2,10 @@
 
 This short doc points to the minimal example that demonstrates how to use the Forms primitives with Select, Checkbox and Switch components. It also documents the ApiResult pattern for mapping server field errors into react-hook-form and points to the per-field async validation helper used in the signup form.
 
-> To add these examples and primitives to your own app via the CLI, the recommended alpha setup is to install Blocks first, then Forms:
+> To add these examples and primitives to your own app via the CLI, the recommended alpha setup is to install Blocks with sections and templates first, then Forms:
 >
 > ```bash
-> npx nextworks add blocks
+> npx nextworks add blocks --sections --templates
 > npx nextworks add forms
 > ```
 >

package/dist/kits/forms/.nextworks/docs/FORMS_README.md

@@ -26,10 +26,10 @@ Notes
 
 > **Alpha note**
 >
-> In this early alpha, Forms is tested on top of the default **Blocks** install. For the smoothest experience, install Blocks first:
+> In this early alpha, Forms is tested on top of a **Blocks** install that includes sections and templates. For the smoothest experience, install Blocks first:
 >
 > ```bash
-> npx nextworks add blocks
+> npx nextworks add blocks --sections --templates
 > npx nextworks add forms
 > ```
 >

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nextworks",
-  "version": "0.1.0-alpha.3",
+  "version": "0.1.0-alpha.4",
   "description": "Nextworks CLI - Feature kits installer for Next.js apps",
   "main": "dist/index.js",
   "bin": {