create-rsc-kit 0.24.2 → 0.24.3

package/README.md

@@ -6,18 +6,40 @@ Scaffold a React Server Components app that builds and runs before you edit it.
 bun create rsc-kit@latest my-app
 ```
 
-Asks which server (Bun, Hono, Elysia or `node:http`), whether you want the React
-Compiler, and whether to include Tailwind. Every answer has a flag, so it runs
-unattended too:
+It asks where the app will run (Bun, Node or Cloudflare Workers — a Nitro
+preset), whether you want the React Compiler, Tailwind and, if so, shadcn/ui,
+oxlint, a validation library, typed environment variables, and whether the
+app should be installable. Every answer has a flag, so it runs unattended too:
 
 ```sh
-bun create rsc-kit@latest my-app --host=bun --compiler=oxc --tailwind
+bun create rsc-kit@latest my-app --host=bun --compiler=oxc --tailwind --yes
 ```
 
+| Flag | What it does |
+| --- | --- |
+| `--host=bun\|node\|worker` | Where it runs, which picks the Nitro preset |
+| `--compiler=none\|oxc\|babel` | The React Compiler; the prompt offers oxc |
+| `--tailwind`, `--no-tailwind` | Include Tailwind |
+| `--shadcn` | shadcn/ui, set up for RSC; needs Tailwind |
+| `--lint`, `--no-lint` | Include oxlint |
+| `--validation=zod\|valibot\|arktype\|none` | The schema library forms, actions and env use |
+| `--env`, `--no-env` | Typed environment variables |
+| `--pwa`, `--no-pwa` | Installable: offline, a manifest, starter icons (off by default) |
+| `--source-dir=<dir>` | Where `app/` lives (default `src`) |
+| `--backend=<url>` | A backend answering `rpc()`, such as a Go server; writes `.env` with a secret |
+| `--no-install`, `--no-git` | Skip installing dependencies, or `git init` |
+| `--yes` | Accept every default and ask nothing |
+
+Use `--yes`, not `-y`, with `bun create`: Bun reads `-y` as its own flag.
+`bunx create-rsc-kit my-app -y` accepts either.
+
 The point is not the typing it saves. Several things in this setup fail by
-producing an app that looks nearly right — a server that serves a development
-payload to a production client, a stylesheet with no server-component classes
-in it, an engine declaration that typechecks the server and fails the prerender.
-What comes out has those right.
+producing an app that looks nearly right — a stylesheet with no
+server-component classes in it, shadcn's components written without
+`"use client"`, an engine declaration that typechecks the server and fails the
+prerender. What comes out builds, prerenders, typechecks and serves.
+
+To add rsc-kit to a project that already exists, use
+[`rsc-kit init`](https://www.npmjs.com/package/rsc-kit) instead.
 
-Docs: https://docs.rsc-kit.dev · Licence: MIT
+Docs: https://docs.rsc-kit.dev/installation · Licence: MIT

package/dist/init.js

@@ -655,7 +655,7 @@ const INIT_HELP = `
 
   Options
     --source-dir <dir>   where app/ should live (detected, usually src)
-    --host=…             bun | hono | elysia | node (detected from your deps)
+    --host=…             bun | node | worker (detected from your deps)
                          laravel is detected from artisan, never asked
     --backend=<url>      a backend answering host calls - a Go server, say, at
                          http://127.0.0.1:8080 (assumed when go.mod is here);

package/dist/options.js

@@ -118,7 +118,10 @@ export function defaultCore(fromDir) {
  */
 export function parseArgs(argv) {
     const out = {};
-    for (const arg of argv) {
+    // `--source-dir src` as well as `--source-dir=src`: the help shows the
+    // first, and it was read as the project's directory instead.
+    const args = argv.flatMap((arg, i) => arg === '--source-dir' ? [] : argv[i - 1] === '--source-dir' ? ['--source-dir=' + arg] : [arg]);
+    for (const arg of args) {
         if (arg === '--help' || arg === '-h')
             out.help = true;
         else if (arg === '--yes' || arg === '-y')

package/dist/templates.js

@@ -82,7 +82,11 @@ export function scripts(o) {
         // costs more than it saves.
         ...(o.host === 'worker'
             ? {
-                preview: 'wrangler dev .output/server/index.mjs',
+                // No entry argument: the build leaves .wrangler/deploy/config.json
+                // pointing at its own wrangler.json, and wrangler refuses an entry
+                // beside that - "found both a user configuration file and a deploy
+                // configuration file" - so the script never started.
+                preview: 'wrangler dev',
                 deploy: 'vite build && nitro deploy --prebuilt',
             }
             : {
@@ -232,7 +236,13 @@ export function viteConfig(o) {
     //
     // Not optional, and not a flag on rscKit() either — the plugin builds for
     // Nitro and nothing else, so a config without this line has no server.
-    plugins.push(`nitro({ preset: ${JSON.stringify(preset(o.host))}, serveStatic: 'inline' })`);
+    // On Workers, the runtime's compatibility date is pinned to the day the app
+    // was made: left to Nitro it is each build's own date, so behaviour changed
+    // from one build to the next, and a wrangler older than the build refused to
+    // run it at all.
+    plugins.push(o.host === 'worker'
+        ? `nitro({ preset: 'cloudflare_module', serveStatic: 'inline', compatibilityDate: '${new Date().toISOString().slice(0, 10)}' })`
+        : `nitro({ preset: ${JSON.stringify(preset(o.host))}, serveStatic: 'inline' })`);
     plugins.push(`rscKit({
       ${options.join(',\n      ')},
     })`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-rsc-kit",
-  "version": "0.24.2",
+  "version": "0.24.3",
   "type": "module",
   "description": "Scaffold an RSC app on Bun, Hono, Elysia or Node.",
   "bin": {