@rshono/create 1.0.0-rc.2 → 1.0.0-rc.4

package/README.md

@@ -1,17 +1,26 @@
-# @rshono/create
+<p align="center">
+  <img src="https://raw.githubusercontent.com/rshono/rshono/main/logo.svg" alt="" width="72" height="72" />
+</p>
 
-Scaffolds a new [rshono](https://github.com/rshono/rshono) app — Hono + Rspack + React Server Components.
+<h1 align="center">@rshono/create</h1>
+
+<p align="center">
+  Scaffolds a new <a href="https://github.com/rshono/rshono">rshono</a> app — Hono + Rspack + React Server Components.
+</p>
 
 ```bash
-npm  create @rshono@latest my-app
-pnpm create @rshono my-app
+npx  @rshono/create@latest my-app
+pnx  @rshono/create my-app
+bunx @rshono/create my-app
 yarn create @rshono my-app
-bun  create @rshono my-app
 ```
 
-The package manager that ran it is the one the project gets: it is read from `npm_config_user_agent`, used
-for the install, written into `packageManager` for Corepack, and used in every command the closing summary
-prints. Nothing asks you which one you meant.
+The package manager that ran it is the one the project gets: it is read from `npm_config_user_agent`, which
+every one of these runners sets, and it is used for the install, written into `packageManager` for Corepack,
+and used in every command the closing summary prints. Nothing asks you which one you meant.
+
+Yarn is the odd row out because `yarn dlx` is Berry-only, while `yarn create` works in either — and `pnx`
+arrived in pnpm 10.16, before which it is `pnpm dlx`.
 
 ## The questions
 
@@ -32,7 +41,7 @@ the package manager that was detected, `--force` to scaffold into a directory th
 given. **A non-interactive terminal implies `-y`**, so this is one command in CI or from an agent:
 
 ```bash
-npm create @rshono@latest my-app -y --deploy cloudflare --tailwind --quality biome
+npx @rshono/create@latest my-app -y --deploy cloudflare --tailwind --quality biome
 ```
 
 The deploy targets, and the deploy command each one prints, are generated from the framework's own
@@ -113,5 +122,5 @@ CREATE_RSHONO_E2E=1 pnpm --filter @rshono/create test   # also: pack, install an
 refusal to overwrite somebody's files are checked. `e2e.test.mjs` is the opt-in one, and the only one that
 installs anything.
 
-`@clack/prompts` (MIT) is bundled rather than depended on, so `npm create` downloads one tarball before it
-can ask its first question.
+`@clack/prompts` (MIT) is bundled rather than depended on, so `npx @rshono/create` downloads one tarball
+before it can ask its first question.

package/dist/api.mjs

@@ -79,11 +79,11 @@ __webpack_require__.d(__webpack_exports__, {
 
 ;// CONCATENATED MODULE: ./src/generated/framework.ts
 // GENERATED by scripts/codegen.mjs from packages/core — do not edit. Run `pnpm --filter @rshono/create codegen`.
-/** The framework release a scaffolded app is pinned to: this package and rshono ship together. */ const RSHONO_VERSION = '1.0.0-rc.2';
+/** The framework release a scaffolded app is pinned to: this package and rshono ship together. */ const RSHONO_VERSION = '1.0.0-rc.4';
 /**
  * The Node range rshono itself declares, restated in every scaffolded app's `engines` — so a CI image
  * or a contributor on an older Node hears it from their package manager rather than from a stack trace.
- */ const NODE_ENGINE = '>=22.1.0';
+ */ const NODE_ENGINE = '>=22.18.0';
 /**
  * The dependency versions rshono is tested against, copied from its own manifest. Exact where it is
  * exact — React's RSC internals are coupled across builds, and a generated app has no workspace
@@ -105,22 +105,10 @@ __webpack_require__.d(__webpack_exports__, {
         name: 'cloudflare',
         hint: 'deploy with `wrangler deploy`'
     },
-    {
-        name: 'bun',
-        hint: 'run `bun dist/server/main.mjs`'
-    },
-    {
-        name: 'deno',
-        hint: 'run `deno serve -A dist/server/main.mjs`'
-    },
     {
         name: 'vercel',
         hint: 'deploy with `vercel deploy --prebuilt`'
     },
-    {
-        name: 'netlify',
-        hint: 'deploy with `netlify deploy --build=false --dir=.netlify/publish`'
-    },
     {
         name: 'aws-lambda',
         hint: 'zip dist/ with the handler at dist/server/main.mjs'
@@ -194,20 +182,6 @@ __webpack_require__.d(__webpack_exports__, {
             start: 'rshono start'
         }
     },
-    // `rshono start` is the Node target's launcher and refuses a build made for another platform, so
-    // these two get the command their own runtime uses under the same script name.
-    bun: {
-        id: 'deploy-bun',
-        scripts: {
-            start: 'bun dist/server/main.mjs'
-        }
-    },
-    deno: {
-        id: 'deploy-deno',
-        scripts: {
-            start: 'deno serve -A dist/server/main.mjs'
-        }
-    },
     cloudflare: {
         id: 'deploy-cloudflare',
         devDependencies: {
@@ -240,15 +214,6 @@ __webpack_require__.d(__webpack_exports__, {
             '--prebuilt uploads what rshono build assembled; the platform must not rebuild it.'
         ]
     },
-    netlify: {
-        id: 'deploy-netlify',
-        scripts: {
-            deploy: 'rshono build && netlify deploy --build=false --dir=.netlify/publish'
-        },
-        gitignore: [
-            '.netlify/'
-        ]
-    },
     'aws-lambda': {
         id: 'deploy-aws-lambda',
         notes: [
@@ -516,8 +481,8 @@ const QUALITY_PRESETS = [
 
 /**
  * The scripts every app gets. `start` is not among them, because it means something different per
- * platform: the three targets that run the build themselves — node, bun, deno — each contribute their
- * own, and a platform target contributes a `deploy` instead, where its platform has one command to give.
+ * platform: `node` is the one target that runs the build itself, so it contributes its own, and a
+ * platform target contributes a `deploy` instead, where its platform has one command to give.
  */ const BASE_SCRIPTS = {
     dev: 'rshono dev',
     build: 'rshono build',
@@ -760,8 +725,9 @@ function packageManager(name, version) {
 }
 /**
  * Which package manager invoked us. Every one of them sets `npm_config_user_agent` for the process it
- * spawns — `pnpm/11.9.0 npm/? node/v22.14.0 darwin arm64` — so `pnpm create @rshono` scaffolds a pnpm
- * project without asking, and the exact version comes along for the `packageManager` field.
+ * spawns, from its runner as much as from `create` — `pnpm/11.9.0 npm/? node/v22.14.0 darwin arm64` — so
+ * `pnx @rshono/create` scaffolds a pnpm project without asking, and the exact version comes along for the
+ * `packageManager` field.
  *
  * Falls back to npm, which is also what a bare `node bin/create-rshono.mjs` gets.
  */ function detectPackageManager(userAgent = process.env.npm_config_user_agent) {

package/dist/cli.mjs

@@ -2943,11 +2943,11 @@ function hasGit(cwd) {
 
 ;// CONCATENATED MODULE: ./src/generated/framework.ts
 // GENERATED by scripts/codegen.mjs from packages/core — do not edit. Run `pnpm --filter @rshono/create codegen`.
-/** The framework release a scaffolded app is pinned to: this package and rshono ship together. */ const RSHONO_VERSION = '1.0.0-rc.2';
+/** The framework release a scaffolded app is pinned to: this package and rshono ship together. */ const RSHONO_VERSION = '1.0.0-rc.4';
 /**
  * The Node range rshono itself declares, restated in every scaffolded app's `engines` — so a CI image
  * or a contributor on an older Node hears it from their package manager rather than from a stack trace.
- */ const NODE_ENGINE = '>=22.1.0';
+ */ const NODE_ENGINE = '>=22.18.0';
 /**
  * The dependency versions rshono is tested against, copied from its own manifest. Exact where it is
  * exact — React's RSC internals are coupled across builds, and a generated app has no workspace
@@ -2969,22 +2969,10 @@ function hasGit(cwd) {
         name: 'cloudflare',
         hint: 'deploy with `wrangler deploy`'
     },
-    {
-        name: 'bun',
-        hint: 'run `bun dist/server/main.mjs`'
-    },
-    {
-        name: 'deno',
-        hint: 'run `deno serve -A dist/server/main.mjs`'
-    },
     {
         name: 'vercel',
         hint: 'deploy with `vercel deploy --prebuilt`'
     },
-    {
-        name: 'netlify',
-        hint: 'deploy with `netlify deploy --build=false --dir=.netlify/publish`'
-    },
     {
         name: 'aws-lambda',
         hint: 'zip dist/ with the handler at dist/server/main.mjs'
@@ -3170,20 +3158,6 @@ const QUALITY_PRESETS = [
             start: 'rshono start'
         }
     },
-    // `rshono start` is the Node target's launcher and refuses a build made for another platform, so
-    // these two get the command their own runtime uses under the same script name.
-    bun: {
-        id: 'deploy-bun',
-        scripts: {
-            start: 'bun dist/server/main.mjs'
-        }
-    },
-    deno: {
-        id: 'deploy-deno',
-        scripts: {
-            start: 'deno serve -A dist/server/main.mjs'
-        }
-    },
     cloudflare: {
         id: 'deploy-cloudflare',
         devDependencies: {
@@ -3216,15 +3190,6 @@ const QUALITY_PRESETS = [
             '--prebuilt uploads what rshono build assembled; the platform must not rebuild it.'
         ]
     },
-    netlify: {
-        id: 'deploy-netlify',
-        scripts: {
-            deploy: 'rshono build && netlify deploy --build=false --dir=.netlify/publish'
-        },
-        gitignore: [
-            '.netlify/'
-        ]
-    },
     'aws-lambda': {
         id: 'deploy-aws-lambda',
         notes: [
@@ -3403,8 +3368,8 @@ function stylingFeature(styling) {
 
 /**
  * The scripts every app gets. `start` is not among them, because it means something different per
- * platform: the three targets that run the build themselves — node, bun, deno — each contribute their
- * own, and a platform target contributes a `deploy` instead, where its platform has one command to give.
+ * platform: `node` is the one target that runs the build itself, so it contributes its own, and a
+ * platform target contributes a `deploy` instead, where its platform has one command to give.
  */ const BASE_SCRIPTS = {
     dev: 'rshono dev',
     build: 'rshono build',
@@ -3645,8 +3610,9 @@ function packageManager(name, version) {
 }
 /**
  * Which package manager invoked us. Every one of them sets `npm_config_user_agent` for the process it
- * spawns — `pnpm/11.9.0 npm/? node/v22.14.0 darwin arm64` — so `pnpm create @rshono` scaffolds a pnpm
- * project without asking, and the exact version comes along for the `packageManager` field.
+ * spawns, from its runner as much as from `create` — `pnpm/11.9.0 npm/? node/v22.14.0 darwin arm64` — so
+ * `pnx @rshono/create` scaffolds a pnpm project without asking, and the exact version comes along for the
+ * `packageManager` field.
  *
  * Falls back to npm, which is also what a bare `node bin/create-rshono.mjs` gets.
  */ function detectPackageManager(userAgent = process.env.npm_config_user_agent) {
@@ -3773,7 +3739,7 @@ const DEFAULT_DIRECTORY = 'my-rshono-app';
 /** Every accepted name comes from `options.ts`, so the help cannot promise one the validation refuses. */ const HELP = `create-rshono — scaffold a new rshono app
 
 Usage:
-  npm create @rshono@latest [directory] [options]
+  npx @rshono/create@latest [directory] [options]
 
 Options:
   -y, --yes                accept the default for every question not given as a flag
@@ -3793,7 +3759,7 @@ Options:
 Every question can be answered by a flag, and a non-interactive terminal implies --yes — so one command
 scaffolds without prompting:
 
-  npm create @rshono@latest my-app -y --deploy cloudflare --tailwind --quality biome
+  npx @rshono/create@latest my-app -y --deploy cloudflare --tailwind --quality biome
 `;
 function fail(message) {
     log.error(message);
@@ -3880,11 +3846,11 @@ function fail(message) {
 async function main() {
     const { values, positionals } = parse();
     if (values.help) return console.log(HELP);
-    if (values.version) return console.log("1.0.0-rc.2");
+    if (values.version) return console.log("1.0.0-rc.4");
     /*
    * A pipe, a CI job or an agent gets the defaults rather than a prompt nothing can answer. Both streams
-   * have to be a terminal: the prompts draw on stdout but *read from stdin*, so `echo | npm create` with
-   * stdout still attached would otherwise ask a question with nothing behind the keyboard.
+   * have to be a terminal: the prompts draw on stdout but *read from stdin*, so `echo | npx @rshono/create`
+   * with stdout still attached would otherwise ask a question with nothing behind the keyboard.
    */ const interactive = Boolean(process.stdin.isTTY && process.stdout.isTTY) && !values.yes;
     const pmFlag = oneOf(values.pm, PACKAGE_MANAGERS, 'pm');
     const pm = pmFlag ? packageManager(pmFlag) : detectPackageManager();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rshono/create",
-  "version": "1.0.0-rc.2",
+  "version": "1.0.0-rc.4",
   "description": "Scaffold a new rshono app — Hono + Rspack + React Server Components",
   "author": "Lasse <lasse@lassetange.com> (https://www.lassetange.com)",
   "license": "ISC",
@@ -41,19 +41,18 @@
   "publishConfig": {
     "access": "public"
   },
+  "devDependencies": {
+    "@clack/prompts": "^1.7.0",
+    "@rspack/core": "2.1.5",
+    "@types/node": "^26.1.1",
+    "typescript": "^7.0.2",
+    "@rshono/core": "1.0.0-rc.4"
+  },
   "scripts": {
     "build": "node scripts/codegen.mjs && node scripts/build.mjs",
     "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
     "codegen": "node scripts/codegen.mjs",
     "typecheck": "node scripts/codegen.mjs && tsc --noEmit",
-    "test": "npm run build && node --test --test-concurrency=1 \"test/*.test.mjs\"",
-    "prepack": "npm run build"
-  },
-  "devDependencies": {
-    "@clack/prompts": "^1.7.0",
-    "@rspack/core": "2.1.5",
-    "@types/node": "^26.1.1",
-    "@rshono/core": "workspace:*",
-    "typescript": "^7.0.2"
+    "test": "npm run build && node --test --test-concurrency=1 \"test/*.test.mjs\""
   }
-}
+}

package/templates/base/public/favicon.svg

@@ -1 +1,2 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100"><title>Lightning bolt</title><text y=".9em" font-size="90">⚡</text></svg>
+<!-- The rshono mark, as a placeholder — replace it with your own and the tab is yours. -->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none"><title>rshono</title><path fill="#087EA4" d="M12.4365 0.2520325c0.062375 -0.0080215 0.11745 0.0077075 0.16515 0.0471875 1.755075 2.142025 3.40665 4.359855 4.954725 6.65348 1.14615 1.725625 2.121325 3.550175 2.92565 5.4738 1.2845 3.426025 0.616 6.40675 -2.005475 8.9421 -2.293725 1.938575 -4.936225 2.693575 -7.927575 2.265025 -3.57555 -0.729025 -6.00575 -2.7974 -7.290525 -6.205225 -0.33465 -1.109425 -0.44475 -2.241925 -0.3303 -3.397525 0.19055 -1.9891 0.662425 -3.9081 1.415625 -5.7569 0.31385 -0.75435 0.722825 -1.4464 1.2269 -2.076275 0.411225 0.4898 0.80445 0.993175 1.179675 1.510025 0.17375 0.181625 0.354625 0.35465 0.542675 0.51905C8.728325 5.378325 10.44285 2.7201 12.4365 0.2520325Z"/><path fill="#61DAFB" d="M12.10625 4.07425c1.73145 2.008325 3.296525 4.1475 4.695175 6.41755 0.438525 0.75115 0.800275 1.537625 1.085325 2.3594 0.593825 2.336175 -0.043225 4.26305 -1.9111 5.7805 -1.80655 1.2712 -3.788425 1.6487 -5.945675 1.132525 -2.326325 -0.721875 -3.671175 -2.286975 -4.034575 -4.6952 -0.088175 -0.7593 -0.009525 -1.4986 0.23595 -2.217825 0.35005 -0.888875 0.774725 -1.73825 1.274075 -2.54815 0.471875 -0.6921 0.94375 -1.38415 1.415625 -2.07625 1.071925 -1.378375 2.13365 -2.762525 3.1852 -4.15255Z"/></svg>

package/templates/base/rshono.config.ts

@@ -25,8 +25,6 @@ export default defineConfig({
   // csp: false,          // strict per-request-nonce Content-Security-Policy
   // cspDirectives: {},   // widen it, e.g. { 'img-src': "'self' https://cdn.example.com" }
   // bodySizeLimit: '1mb',// request body cap before a 413; false disables it
-  // renderTimeout: 10_000, // ms deadline for a request (action + flight + SSR)
-  // compress: true,      // gzip; turn off behind a proxy that already does it
 
   // Escape hatch: mutate the generated Rspack config just before it compiles. Called once per compiler.
   // rspack(config, { isServer, isDev }) {

package/templates/base/src/components/layout.tsx

@@ -1,4 +1,3 @@
-import { NavigationProgress } from '@rshono/core/client';
 import type { ReactNode } from 'react';
 import { publicEnv } from '../lib/env';
 import '../styles.css';
@@ -20,14 +19,12 @@ export function Layout({ title, description, children }: { title?: string; descr
         <link rel="icon" href="/favicon.svg" type="image/svg+xml" />
       </head>
       <body>
-        {/* Paints during a soft navigation, so a slow page still feels answered. */}
-        <NavigationProgress />
         <header>
           <nav>
             <a href="/">
               <strong>{publicEnv.appName}</strong>
             </a>
-            {/* `data-prefetch` warms a page on hover; `data-native` opts a link out of soft navigation. */}
+            {/* `data-native` opts a link out of soft navigation and does a full browser load. */}
             <a href="/api/health" data-native>
               /api/health
             </a>

package/templates/base/src/server.ts

@@ -4,7 +4,7 @@ import { trimTrailingSlash } from 'hono/trailing-slash';
 
 /**
  * What this app's middleware puts on the Hono context. Pass it to `PageProps<path, AppEnv>` (or
- * `getContext<AppEnv>()`) and `ctx.var` is typed key by key instead of an open record — see
+ * `getRequestContext<AppEnv>()`) and `ctx.var` is typed key by key instead of an open record — see
  * `components/home.tsx`.
  */
 export type AppEnv = { Variables: { requestId: string } };

package/templates/tailwind/rshono.config.ts

@@ -25,8 +25,6 @@ export default defineConfig({
   // csp: false,          // strict per-request-nonce Content-Security-Policy
   // cspDirectives: {},   // widen it, e.g. { 'img-src': "'self' https://cdn.example.com" }
   // bodySizeLimit: '1mb',// request body cap before a 413; false disables it
-  // renderTimeout: 10_000, // ms deadline for a request (action + flight + SSR)
-  // compress: true,      // gzip; turn off behind a proxy that already does it
 
   /**
    * Tailwind, and the only thing the build needs to know about it.

package/templates/tailwind/src/components/layout.tsx

@@ -1,4 +1,3 @@
-import { NavigationProgress } from '@rshono/core/client';
 import type { ReactNode } from 'react';
 import { publicEnv } from '../lib/env';
 import '../styles.css';
@@ -20,14 +19,12 @@ export function Layout({ title, description, children }: { title?: string; descr
         <link rel="icon" href="/favicon.svg" type="image/svg+xml" />
       </head>
       <body className="bg-zinc-50 text-zinc-900 antialiased dark:bg-zinc-950 dark:text-zinc-100">
-        {/* Paints during a soft navigation, so a slow page still feels answered. */}
-        <NavigationProgress />
         <header className="mx-auto max-w-2xl px-6 py-5">
           <nav className="flex items-center justify-between gap-4">
             <a href="/" className="font-semibold no-underline">
               {publicEnv.appName}
             </a>
-            {/* `data-prefetch` warms a page on hover; `data-native` opts a link out of soft navigation. */}
+            {/* `data-native` opts a link out of soft navigation and does a full browser load. */}
             <a href="/api/health" data-native className="text-sm">
               /api/health
             </a>