create-nevela 0.5.0 → 0.5.1

package/README.md

@@ -1,6 +1,13 @@
 # create-nevela
 
-Create a new [Nevela](https://nevela-docs.vercel.app) app: a Laravel API and a Next.js dashboard, generated from one resource description.
+The `nevela` command. It creates a new [Nevela](https://nevela-docs.vercel.app) app, a Laravel API and a Next.js dashboard generated from one resource description, and runs everything inside one.
+
+```sh
+npm install -g create-nevela    # once
+nevela new my-app
+```
+
+Or without installing anything:
 
 ```sh
 pnpm create nevela my-app
@@ -16,41 +23,35 @@ You need PHP 8.3 or newer, Composer, and Node.js 20 or newer.
 my-app/
 ├─ apps/api/    a Laravel app with Sanctum and Nevela installed
 ├─ apps/web/    the Next.js dashboard, pointed at the API
-└─ nevela       every command, from this folder: php nevela
+└─ nevela       the app's own launcher: php nevela does what nevela does
 ```
 
 Then:
 
 ```sh
 cd my-app
-php nevela dev
+nevela dev
 ```
 
-Open http://localhost:3000/sign-in and sign in as `admin@example.com` with the password `password`. That starter account is in your local database only; add your own with `php artisan nevela:user`.
+Open http://localhost:3000/sign-in and sign in as `admin@example.com` with the password `password`. That starter account is in your local database only; add your own with `nevela user`.
 
 The app starts with an administrator and ten sample users (two editors, eight users), in your local database only, so its Users and Roles screens have something to show. Leave the samples out with `--no-sample-users`.
 
 Add your first resource, from the same folder:
 
 ```sh
-php nevela resource Product --fields="name:string, sku:string!, price:money"
+nevela resource Product --fields="name:string, sku:string!, price:money"
 ```
 
-That writes the Laravel code and the dashboard pages, and creates the table. `php nevela` lists everything else.
+That writes the Laravel code and the dashboard pages, and creates the table. `nevela` on its own lists everything else.
 
-## The nevela command
-
-Install this package once and you have a `nevela` command, in every shell:
-
-```sh
-npm install -g create-nevela
-```
+## Every command
 
 ```sh
 nevela                 # anywhere: everything it can do
 nevela new my-app      # anywhere: create an app (leave the name off and it asks)
 nevela update          # anywhere: update the nevela command itself
-nevela version         # anywhere: the command's version, and the app's when in one
+nevela --version       # anywhere: the command's version, and the app's when in one
 nevela dev             # inside an app: run the API and the dashboard
 nevela upgrade         # inside an app: bring it to the latest Nevela
 ```
@@ -79,7 +80,7 @@ Without the command installed, `npx create-nevela upgrade` does the same, in any
 | `--bundled-package` | Use the copy of `nevela/laravel` inside this installer instead of the release on Packagist. |
 | `-y`, `--yes` | Ask nothing. Only the app name is ever asked for. |
 
-With npm, put options after `--`: `npm create nevela@latest my-app -- --no-install`.
+Through npm's `create`, put options after `--`: `npm create nevela@latest my-app -- --no-install`.
 
 ## How it installs the Laravel package
 

package/index.mjs

@@ -68,14 +68,14 @@ const HELP = `  Create a new Nevela app: a Laravel API and a Next.js dashboard.
     nevela new [name] [options]   Create an app. It asks for the name if you leave it off.
                                   Without the command: pnpm create nevela <name>
     nevela update                 Update the nevela command itself to the latest version
-    nevela version                Which version the nevela command is, and this app when in one
+    nevela --version              Which version the nevela command is, and this app when in one
 
   ${bold('Inside an app')}
     nevela upgrade             Bring this app to the latest Nevela: the package and the dashboard
     nevela dev                 Run the API and the dashboard
     nevela status              Check versions, migrations, users and the dashboard
     nevela resource <Name> --fields="…" [--seed]
-    nevela seed | user | generate | version | migrate | artisan <command>
+    nevela seed | user | generate | migrate | artisan <command>
 
   ${bold('Options')}
     --pm <pnpm|npm|yarn|bun>   Package manager for the dashboard. Default: the one you ran this with.
@@ -89,7 +89,7 @@ const HELP = `  Create a new Nevela app: a Laravel API and a Next.js dashboard.
                                instead of the release on Packagist.
     -y, --yes                  Ask nothing. (Only the app name is ever asked for.)
     -h, --help                 Show this.
-    -v, --version              Show the version.
+    -v, --version              Show the version. Piped or captured, the number alone.
 
   ${bold('Needs')}  PHP 8.3+, Composer, Node.js 20+
   ${bold('Docs')}   ${DOCS}
@@ -445,7 +445,10 @@ function appVersion(project) {
   }
 }
 
-/** `nevela version`, from anywhere: the command's version, and the app's when in one. */
+/**
+ * `nevela --version`, from anywhere: the command's version, and the app's when in one.
+ * `nevela version` is the same thing by its older name.
+ */
 function showVersion() {
   const project = findProject(process.cwd());
   const install = installed();
@@ -574,6 +577,13 @@ async function main() {
   if (argv[0] === 'new') argv.shift();
   else if (argv[0] === 'update') return updateTool(argv.slice(1));
   else if (argv[0] === 'version') return showVersion();
+  else if ((argv[0] === '--version' || argv[0] === '-v') && argv.length === 1) {
+    // To a person, the whole answer. To a script (and to `nevela update`, which asks
+    // this of the installed command to check its work), the number and nothing else.
+    if (process.stdout.isTTY) return showVersion();
+    console.log(VERSION);
+    return;
+  }
   else if (COMMANDS.includes(argv[0])) await inProject(argv[0], argv.slice(1));
   else if (argv[0] === 'help' || (startedAsNevela && argv.length === 0)) {
     // `nevela` on its own says what it can do. `pnpm create nevela` on its own starts an

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-nevela",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "Create a new Nevela app: a Laravel API and a Next.js dashboard from one resource description.",
   "type": "module",
   "bin": {

package/template/laravel/README.md

@@ -3,18 +3,20 @@
 The Laravel side of [Nevela](https://nevela-docs.vercel.app): describe a resource once and get its model, migration, validation, policy and REST API, plus the Next.js dashboard screens for it.
 
 ```sh
-php artisan nevela:resource Product --fields="name:string, sku:string!, price:money, kind:enum(stock|digital), notes:text?"
-php artisan migrate
+nevela resource Product --fields="name:string, sku:string!, price:money, kind:enum(stock|digital), notes:text?"
 ```
 
 ## Start a new app
 
-The quickest way is the create command, which sets up Laravel, this package and the dashboard together:
+The quickest way is the `nevela` command, which sets up Laravel, this package and the dashboard together:
 
 ```sh
-pnpm create nevela my-app
+npm install -g create-nevela    # once
+nevela new my-app
 ```
 
+Without installing it, `pnpm create nevela my-app` does the same.
+
 ## Add it to an existing Laravel app
 
 ```sh

package/template/laravel/src/Nevela.php

@@ -18,7 +18,7 @@ use Nevela\Laravel\Support\Naming;
 final class Nevela
 {
     /** Written by `pnpm release`; the same number as the repository's git tag. */
-    public const VERSION = '0.5.0';
+    public const VERSION = '0.5.1';
 
     /** @var array<string, Descriptor> */
     private static array $descriptors = [];

package/template/web/app/page.tsx

@@ -114,15 +114,9 @@ export default function Home() {
           <p>
             © {new Date().getFullYear()} {site.name}
           </p>
-          {/* Delete this line when the app is your own — it's here so whoever set the
-              project up can find what running it actually costs. */}
-          <a
-            href="https://flare-docs.codetotech.com/guides/costs/"
-            target="_blank"
-            rel="noreferrer"
-            className="hover:text-foreground"
-          >
-            Built with Flare · what it costs to run
+          {/* Delete this line when the app is your own. */}
+          <a href="https://nevela-docs.vercel.app" target="_blank" rel="noreferrer" className="hover:text-foreground">
+            Built with Nevela (Next.js + Laravel)
           </a>
           <nav aria-label="Footer" className="flex gap-6">
             <Link href={site.links.terms} className="hover:text-foreground">

package/template/web/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nevela-web",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "private": true,
   "type": "module",
   "scripts": {