create-runlot 0.1.0-rc.78 → 0.1.0-rc.80

package/dist/index.js

@@ -135,6 +135,10 @@ function nextReadme(name) {
     "The deploy reads the `database`, `auth` and `storage` declarations in `runlot.json`",
     "and creates Postgres, authentication and object storage. The App Router itself runs",
     "on workerd (OpenNext).",
+    "",
+    "`npm run dev` is `next dev` \u2014 the fast UI loop, without runlot's bindings.",
+    "`npm run preview` is `runlot dev`: it builds through OpenNext and serves the result",
+    "under workerd with the bindings wired up, which is where you check what will ship.",
     ""
   ].join("\n");
 }
@@ -152,7 +156,11 @@ function nextTemplate(ctx) {
     version: "0.0.0",
     private: true,
     scripts: {
+      // `dev` stays `next dev`: for a Next project the UI loop is the thing you
+      // run all day, and `runlot dev` has to rebuild through OpenNext on every
+      // change. `preview` is the one that runs what will actually ship.
       dev: "next dev",
+      preview: "runlot dev",
       build: "next build",
       start: "next start"
     },
@@ -162,8 +170,8 @@ function nextTemplate(ctx) {
       "react-dom": "^19.2.8",
       // The npm job in release.yml rewrites the version range with the same
       // number as the tag — the value written here is the last published version.
-      "@runlot/next": "^0.1.0-rc.78",
-      "@runlot/pg": "^0.1.0-rc.78"
+      "@runlot/next": "^0.1.0-rc.80",
+      "@runlot/pg": "^0.1.0-rc.80"
     },
     devDependencies: {
       typescript: "^5.7.2",
@@ -184,7 +192,7 @@ function nextTemplate(ctx) {
     // runlot deploy writes the generated OpenNext configuration into
     // `.runlot-next` (docs/nextjs.md §2) — it is not source, so it is not
     // something to commit.
-    ".gitignore": "node_modules\n.next\n.open-next\n.runlot-next\n",
+    ".gitignore": "node_modules\n.next\n.open-next\n.runlot-next\n.runlot\n.env.runlot\n",
     "README.md": nextReadme(name)
   };
 }
@@ -247,9 +255,14 @@ function honoReadme(name) {
     "`/upload` (an object storage upload).",
     "",
     "```",
+    "runlot dev",
     "runlot deploy",
     "```",
     "",
+    "`runlot dev` runs this worker on your own machine under workerd, with `env.storage`",
+    "and the static files real and `env.db` and `env.auth` as local stand-ins. It prints",
+    "which is which. Point `env.db` at a real database with `RUNLOT_DEV_DATABASE_URL`.",
+    "",
     "The deploy reads the `database`, `auth` and `storage` declarations in `runlot.json`",
     "and creates them, and `db`, `auth` and `storage` on `Env` receive the real bindings.",
     ""
@@ -269,10 +282,16 @@ function honoTemplate(ctx) {
     version: "0.0.0",
     private: true,
     type: "module",
+    // `npm run dev` is the first thing a person types in a new directory, and
+    // for this template it should be the local run — not a deploy.
+    scripts: {
+      dev: "runlot dev",
+      deploy: "runlot deploy"
+    },
     dependencies: {
       hono: "^4.10.7",
-      "@runlot/pg": "^0.1.0-rc.78",
-      "@runlot/auth": "^0.1.0-rc.78"
+      "@runlot/pg": "^0.1.0-rc.80",
+      "@runlot/auth": "^0.1.0-rc.80"
     },
     devDependencies: {
       typescript: "^5.7.2",
@@ -298,7 +317,9 @@ function honoTemplate(ctx) {
     "src/index.ts": HONO_INDEX_TS,
     "public/hello.txt": "Static assets ship in the same bundle.\n",
     "migrations/0001_posts.sql": POSTS_MIGRATION,
-    ".gitignore": "node_modules\n",
+    // `.runlot` is where `runlot dev` keeps the unpacked bundle, the local
+    // object store and the mail it did not send.
+    ".gitignore": "node_modules\n.runlot\n.env.runlot\n",
     "README.md": honoReadme(name)
   };
 }
@@ -331,9 +352,13 @@ function staticReadme(name) {
     "A static site template. It is a single `public/index.html` with no worker.",
     "",
     "```",
+    "runlot dev",
     "runlot deploy",
     "```",
     "",
+    "`runlot dev` serves `public/` the way the deployment will, including the `notFound`",
+    "setting, and reloads when you save.",
+    "",
     "Without a worker there is no database, authentication or storage. If you add a worker later,",
     'add something like `"database": true` to `runlot.json` and deploy \u2014 the resources are created as part of the deploy.',
     ""
@@ -349,7 +374,7 @@ function staticTemplate(ctx) {
     // `"notFound": "spa"` — extensionless paths then answer with index.html.
     "runlot.json": pkgJson(runlotConfig),
     "public/index.html": staticIndexHtml(name),
-    ".gitignore": "node_modules\n",
+    ".gitignore": "node_modules\n.runlot\n",
     "README.md": staticReadme(name)
   };
 }
@@ -375,6 +400,7 @@ function scaffold(opts) {
   }
   console.log(`Created ${dir}.`);
   console.log(`  cd ${target}`);
+  if (template !== "next") console.log("  runlot dev");
   console.log(org ? "  runlot deploy" : "  runlot deploy --org <slug>");
   return { dir, files: relPaths };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-runlot",
-  "version": "0.1.0-rc.78",
+  "version": "0.1.0-rc.80",
   "description": "npm create runlot — Next.js, Hono, and static-site templates",
   "publishConfig": {
     "access": "public"
@@ -21,7 +21,7 @@
     "esbuild": "^0.24.2",
     "typescript": "^5.7.2",
     "@types/node": "^22.10.2",
-    "@runlot/config": "0.1.0-rc.78"
+    "@runlot/config": "0.1.0-rc.80"
   },
   "engines": {
     "node": ">=20"