create-nextly-app 0.0.2-alpha.7 → 0.0.2-alpha.71

package/README.md

@@ -30,22 +30,46 @@ bun create nextly-app@alpha my-app
 The CLI walks you through:
 
 1. Project name (or `.` to install in the current directory)
-2. Template (`blank` or `blog`)
+2. Template (`blank`, `blog` or `plugin`)
 3. Schema approach (`code-first` or `visual`), only for templates that support both
 4. Database (`sqlite`, `postgresql`, or `mysql`)
 5. Database connection string (skipped for SQLite)
 
+### Which release a project gets
+
+A project gets the release of Nextly its CLI belongs to: `create-nextly-app@<version>` declares `nextly` and every `@nextlyhq/*` package at exactly `<version>`, so the templates, the agent guide and the skills it writes match what is installed. To start on another release, run that release's CLI; to upgrade later, move every Nextly package to the new version together.
+
+Adding Nextly to an app that already has a Nextly package at another version, or declared as a range, stops before changing anything and says what to set. With `--branch` or `--local-template`, the packages come from the `alpha` tag, the active release line, and `--use-yalc` links local builds.
+
 After scaffolding, `pnpm dev` runs the project. Visit [http://localhost:3000/admin/setup](http://localhost:3000/admin/setup) to create the first admin user.
 
 ## Templates
 
-| Template  | Description                                                                         |
-| --------- | ----------------------------------------------------------------------------------- |
-| **blank** | Empty config. Define your own collections from scratch.                             |
-| **blog**  | Posts, categories, tags, frontend pages, RSS, sitemap, and admin-editable homepage. |
+| Template   | Description                                                                         |
+| ---------- | ----------------------------------------------------------------------------------- |
+| **blank**  | Empty config. Define your own collections from scratch.                             |
+| **blog**   | Posts, categories, tags, frontend pages, RSS, sitemap, and admin-editable homepage. |
+| **plugin** | A publishable Nextly plugin package, with a playground app to try it in.            |
 
 More templates (portfolio, e-commerce, SaaS admin) are planned.
 
+### Plugin template
+
+`--template plugin` creates a library to publish on npm rather than an app, so
+it skips the schema-approach and database questions. Run from inside a
+Next.js app, it still creates the plugin in its own directory.
+
+- `src/` holds the plugin. Only the built `dist/` is published.
+- `dev/` is a small Nextly app on SQLite that registers the plugin. `pnpm dev`
+  runs it, and `/admin` opens signed in as `dev@nextly.local`, a user created
+  on first start under `next dev` only.
+- `pnpm test` boots the plugin in an in-memory Nextly; `pnpm build` builds it.
+
+By default the plugin is copied from the template bundled in the CLI, and its
+Nextly packages are pinned to that CLI's release, so its files and its
+packages come from the same release. Any `--branch`, `main` included,
+`--local-template` or `--use-yalc` uses the live template instead.
+
 ## Schema approaches
 
 | Approach       | Description                                                                                               |
@@ -64,6 +88,9 @@ pnpm create nextly-app@alpha my-blog --template blog --approach code-first
 # Blank project with PostgreSQL
 pnpm create nextly-app@alpha my-app --template blank --database postgresql
 
+# A plugin package with its playground app
+pnpm create nextly-app@alpha my-plugin --template plugin
+
 # Skip prompts entirely (defaults: blank, SQLite, local storage)
 pnpm create nextly-app@alpha my-app -y
 ```
@@ -73,10 +100,10 @@ pnpm create nextly-app@alpha my-app -y
 | Flag                | Short | Description                                                  | Default            |
 | ------------------- | ----- | ------------------------------------------------------------ | ------------------ |
 | `--yes`             | `-y`  | Skip prompts and use defaults (blank, SQLite, local storage) | `false`            |
-| `--template <name>` | `-t`  | Project template: `blank`, `blog`                            | Interactive prompt |
+| `--template <name>` | `-t`  | Project template: `blank`, `blog`, `plugin`                  | Interactive prompt |
 | `--approach <type>` | `-a`  | Schema approach: `code-first`, `visual`                      | Interactive prompt |
 | `--database <db>`   | `-d`  | Database: `sqlite`, `postgresql`, `mysql`                    | Interactive prompt |
-| `--branch <branch>` | `-b`  | Git branch for template download                             | `main`             |
+| `--branch <branch>` | `-b`  | Git branch to take the template from                         | This release       |
 | `--version`         | `-V`  | Print the CLI version                                        |                    |
 | `--help`            | `-h`  | Show help text                                               |                    |
 
@@ -122,9 +149,9 @@ Contributions of every size are welcome. Start with the [Contributing guide](htt
 
 ## Telemetry
 
-The Nextly CLI (`create-nextly-app` and `nextly`) collects anonymous usage data to help us improve the tool. No personal information, project contents, file paths, or secrets are collected. Telemetry is automatically disabled in CI, Docker, production, and non-interactive shells.
+The Nextly CLI (`create-nextly-app` and `nextly`) collects usage data under a random ID, to help us improve the tool: never your name, project contents, file paths or secrets. It is off in CI, Docker, production and non-interactive shells, and `nextly telemetry disable` turns it off.
 
-See [nextlyhq.com/docs/telemetry](https://nextlyhq.com/docs/telemetry) for the full list of what is and is not collected, and for instructions on opting out (`nextly telemetry disable` or `NEXTLY_TELEMETRY_DISABLED=1`).
+See [nextlyhq.com/docs/telemetry](https://nextlyhq.com/docs/telemetry) for the full list of what is and is not collected, and for the environment variable that also turns it off (`NEXTLY_TELEMETRY_DISABLED=1`).
 
 ## License