create-rsc-kit 0.22.9 → 0.23.0

package/dist/index.js

@@ -16,6 +16,7 @@ import { DEFAULT_COMPILER, HELP, HOSTS, publishedCore, assertInsideCwd, assertUs
 import { Prompter, bold, cyan, dim } from './prompt.js';
 import { checkForNewer, notifyIfStale, selfVersion } from './stale.js';
 import * as t from './templates.js';
+import { setUpShadcn } from './shadcn.js';
 import { STARTER_ICONS } from './icons.js';
 // Same treatment as a refusal from write(): a bad flag is a decision this tool
 // made, and it happens before the try/catch below because the flags are what
@@ -39,6 +40,11 @@ const core = flags.core ?? defaultCore(dirname(fileURLToPath(import.meta.url)));
 // Started before the first question and never awaited here — see notifyIfStale.
 const staleCheck = checkForNewer('create-rsc-kit', selfVersion(import.meta.url));
 const options = await collect();
+// shadcn's components are styled with Tailwind; without it they render bare.
+if (options.shadcn && !options.tailwind) {
+    stdout.write(`\n${bold('Cannot scaffold here.')}\n  --shadcn needs Tailwind; drop --no-tailwind.\n\n`);
+    exit(1);
+}
 try {
     write(options);
 }
@@ -63,10 +69,12 @@ if (options.git) {
         run('git', ['init', '--quiet'], options.dir);
     }
 }
+let installed = false;
 if (options.install) {
     stdout.write(`\n${dim('Installing dependencies…')}\n`);
     const pm = options.host === 'node' ? 'npm' : 'bun';
     const ok = run(pm, ['install'], options.dir);
+    installed = ok;
     if (!ok) {
         stdout.write(`\n${bold('Dependencies did not install.')} The files are written; run the install yourself.\n` +
             (options.core === publishedCore()
@@ -74,6 +82,8 @@ if (options.install) {
                 : ''));
     }
 }
+if (options.shadcn)
+    setUpShadcn({ dir: options.dir, host: options.host, unattended, installed });
 report(options);
 await notifyIfStale(staleCheck, 'bun create rsc-kit@latest');
 // ── ─────────────────────────────────────────────────────────────────────────
@@ -94,6 +104,7 @@ async function collect() {
             validation: flags.validation ?? 'zod',
             env: flags.env ?? (flags.validation ?? 'zod') !== 'none',
             pwa: flags.pwa ?? false,
+            shadcn: flags.shadcn ?? false,
             sourceDir: flags.sourceDir ?? 'src',
             install: flags.install ?? true,
             git: flags.git ?? true,
@@ -118,6 +129,8 @@ async function collect() {
         // Yes/no, not which: see DEFAULT_COMPILER.
         const compiler = flags.compiler ?? ((await p.confirm('React Compiler', true)) ? DEFAULT_COMPILER : 'none');
         const tailwind = flags.tailwind ?? (await p.confirm('Tailwind CSS', true));
+        // Only with Tailwind: shadcn's components are styled with it.
+        const shadcn = tailwind ? (flags.shadcn ?? (await p.confirm('shadcn/ui', false))) : false;
         const lint = flags.lint ?? (await p.confirm('oxlint', true));
         const validation = flags.validation ?? (await p.select('Validation library', VALIDATIONS));
         // Only worth asking once there is a library to validate with.
@@ -136,6 +149,7 @@ async function collect() {
             validation,
             env,
             pwa,
+            shadcn,
             sourceDir: flags.sourceDir ?? 'src',
             install: flags.install ?? (await p.confirm('Install dependencies now', true)),
             git: flags.git ?? true,

package/dist/init.js

@@ -14,6 +14,7 @@ import { randomBytes } from 'node:crypto';
 import { basename, dirname, join } from 'node:path';
 import { argv, cwd, exit, stdout } from 'node:process';
 import { DEFAULT_COMPILER, parseArgs, publishedCore } from './options.js';
+import { setUpShadcn } from './shadcn.js';
 import { Prompter, bold, cyan, dim } from './prompt.js';
 import * as t from './templates.js';
 // Nothing here detects a host any more: a host is a Nitro preset, and Nitro
@@ -665,6 +666,8 @@ const INIT_HELP = `
                          (a Go service), otherwise only if it is already there
     --no-install         don't install; a project with no package.json yet is
                          installed by default, any other never is
+    --shadcn             shadcn/ui for RSC: marks an existing components.json
+                         "rsc": true, or runs shadcn's init after the install
     -y, --yes            accept what was detected, ask nothing
     -h, --help           this
 `;
@@ -740,6 +743,9 @@ export async function runInit(args) {
     // Only ever for a project init gave its first package.json: anywhere else
     // the project's own package manager installs, not this.
     let install = defaults.install && flags.install !== false;
+    let shadcn = flags.shadcn === true;
+    // Set up already: the question is only whether to mark it for RSC.
+    const hasShadcn = existsSync(join(dir, 'components.json'));
     if (!unattended) {
         const p = new Prompter();
         try {
@@ -747,6 +753,12 @@ export async function runInit(args) {
             if (flags.tailwind === undefined && !found.hasTailwind) {
                 tailwind = await p.confirm('Tailwind CSS', defaults.tailwind);
             }
+            // Only with Tailwind: shadcn's components are styled with it.
+            if (flags.shadcn === undefined && (tailwind || found.hasTailwind)) {
+                shadcn = hasShadcn
+                    ? await p.confirm('components.json is here: set "rsc": true for shadcn', true)
+                    : await p.confirm('shadcn/ui', false);
+            }
             if (defaults.install && flags.install === undefined) {
                 install = await p.confirm('Install dependencies now', true);
             }
@@ -755,6 +767,11 @@ export async function runInit(args) {
             p.close();
         }
     }
+    // shadcn's components are styled with Tailwind; without it they render bare.
+    if (shadcn && !tailwind && !found.hasTailwind) {
+        stdout.write(`${bold('Not set up.')} --shadcn needs Tailwind: pass --tailwind too.\n\n`);
+        exit(1);
+    }
     const options = {
         dir,
         name: 'app',
@@ -793,6 +810,10 @@ export async function runInit(args) {
             stdout.write(`\n${bold('Dependencies did not install.')} The files are written; run the install yourself.\n`);
         }
     }
+    // After the install: shadcn's init reads the dependencies, and its
+    // components need them. A project already using shadcn is only marked.
+    if (shadcn)
+        setUpShadcn({ dir, host: options.host, unattended, installed });
     if (manual.length > 0) {
         stdout.write(`\n${bold('Then, by hand:')} the steps marked ! above.\n\n`);
         return;

package/dist/options.d.ts

@@ -43,6 +43,13 @@ export interface Options {
      * installed it, so it is a decision to take on purpose.
      */
     pwa: boolean;
+    /**
+     * shadcn/ui, set up by its own CLI once dependencies are installed, then
+     * told this is an RSC app - it sees a plain Vite project and writes
+     * `"rsc": false`, and its interactive components then lack "use client".
+     * Needs Tailwind.
+     */
+    shadcn?: boolean;
     install: boolean;
     git: boolean;
     /** What to depend on for the engine. A path makes a local checkout testable. */
@@ -120,4 +127,4 @@ export declare function assertUsableName(name: string): void;
  * generator nobody can run without reading it first.
  */
 export declare function assertInsideCwd(dir: string, cwd: string): void;
-export declare const HELP = "\n  create-rsc-kit \u2014 scaffold an RSC app\n\n  Usage\n    create-rsc-kit <dir> [options]\n    bun create rsc-kit@latest <dir> [options]\n\n  Options\n    --host=bun|node|worker        where it runs \u2014 picks the Nitro preset\n    --compiler=none|oxc|babel     React Compiler (prompt offers oxc; babel by flag)\n    --tailwind / --no-tailwind    include Tailwind\n    --lint / --no-lint            include oxlint\n    --validation=zod|valibot|arktype|none\n                                  the schema library; forms, actions and env use it\n    --env / --no-env              typed environment variables (@t3-oss/env-core)\n    --pwa / --no-pwa              installable: offline, a manifest, starter icons (default: no)\n    --source-dir <dir>            where app/ lives (default: src)\n    --backend=<url>               a backend answering host calls \u2014 a Go server, say,\n                                  at http://127.0.0.1:8080; writes .env with a secret\n    --init                        add to the project here, rather than scaffold\n    --core=<spec>                 engine dependency, e.g. file:../rsc-kit/packages/core\n    --no-install                  skip installing dependencies\n    --no-git                      skip git init\n    -y, --yes                     accept every default, ask nothing\n    -h, --help                    this\n";
+export declare const HELP = "\n  create-rsc-kit \u2014 scaffold an RSC app\n\n  Usage\n    create-rsc-kit <dir> [options]\n    bun create rsc-kit@latest <dir> [options]\n\n  Options\n    --host=bun|node|worker        where it runs \u2014 picks the Nitro preset\n    --compiler=none|oxc|babel     React Compiler (prompt offers oxc; babel by flag)\n    --tailwind / --no-tailwind    include Tailwind\n    --lint / --no-lint            include oxlint\n    --validation=zod|valibot|arktype|none\n                                  the schema library; forms, actions and env use it\n    --env / --no-env              typed environment variables (@t3-oss/env-core)\n    --pwa / --no-pwa              installable: offline, a manifest, starter icons (default: no)\n    --shadcn                      shadcn/ui, initialised for RSC; needs Tailwind\n    --source-dir <dir>            where app/ lives (default: src)\n    --backend=<url>               a backend answering host calls \u2014 a Go server, say,\n                                  at http://127.0.0.1:8080; writes .env with a secret\n    --init                        add to the project here, rather than scaffold\n    --core=<spec>                 engine dependency, e.g. file:../rsc-kit/packages/core\n    --no-install                  skip installing dependencies\n    --no-git                      skip git init\n    --yes                         accept every default, ask nothing\n                                  (-y too, but `bun create` takes -y as its own)\n    -h, --help                    this\n";

package/dist/options.js

@@ -145,6 +145,8 @@ export function parseArgs(argv) {
             out.compiler = arg.slice(11);
         else if (arg.startsWith('--validation='))
             out.validation = assertValidation(arg.slice(13));
+        else if (arg === '--shadcn')
+            out.shadcn = true;
         else if (arg === '--pwa')
             out.pwa = true;
         else if (arg === '--no-pwa')
@@ -208,6 +210,7 @@ export const HELP = `
                                   the schema library; forms, actions and env use it
     --env / --no-env              typed environment variables (@t3-oss/env-core)
     --pwa / --no-pwa              installable: offline, a manifest, starter icons (default: no)
+    --shadcn                      shadcn/ui, initialised for RSC; needs Tailwind
     --source-dir <dir>            where app/ lives (default: src)
     --backend=<url>               a backend answering host calls — a Go server, say,
                                   at http://127.0.0.1:8080; writes .env with a secret
@@ -215,6 +218,7 @@ export const HELP = `
     --core=<spec>                 engine dependency, e.g. file:../rsc-kit/packages/core
     --no-install                  skip installing dependencies
     --no-git                      skip git init
-    -y, --yes                     accept every default, ask nothing
+    --yes                         accept every default, ask nothing
+                                  (-y too, but \`bun create\` takes -y as its own)
     -h, --help                    this
 `;

package/dist/shadcn.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Tell shadcn this is an RSC app: `"rsc": true` in components.json, so the
+ * components it adds that need the browser start with "use client".
+ *
+ * Its own init sees a plain Vite project and writes false. Returns whether
+ * the file was there to change.
+ */
+export declare function markRsc(path: string): boolean;
+/**
+ * shadcn/ui for an rsc-kit app, new or existing.
+ *
+ * Already set up - a components.json is there, from a Next app say - it is
+ * only marked RSC. Otherwise shadcn's own init runs, once dependencies are
+ * installed, and its result is marked: its CLI sees a plain Vite project and
+ * writes "rsc": false, so a dialog or a dropdown it adds later has no
+ * "use client" and fails to render as a server component.
+ *
+ * Its questions are its own - the component library, the style - so it asks
+ * them in this terminal, unless the run was told to ask nothing, in which
+ * case it takes its defaults too.
+ */
+export declare function setUpShadcn(o: {
+    dir: string;
+    host: string;
+    unattended: boolean;
+    installed: boolean;
+}): void;

package/dist/shadcn.js

@@ -0,0 +1,56 @@
+import { spawnSync } from 'node:child_process';
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { stdout } from 'node:process';
+import { bold, cyan, dim } from './prompt.js';
+/**
+ * Tell shadcn this is an RSC app: `"rsc": true` in components.json, so the
+ * components it adds that need the browser start with "use client".
+ *
+ * Its own init sees a plain Vite project and writes false. Returns whether
+ * the file was there to change.
+ */
+export function markRsc(path) {
+    let config;
+    try {
+        config = JSON.parse(readFileSync(path, 'utf-8'));
+    }
+    catch {
+        return false;
+    }
+    if (config.rsc === true)
+        return true;
+    config.rsc = true;
+    writeFileSync(path, JSON.stringify(config, null, 2) + '\n');
+    return true;
+}
+/**
+ * shadcn/ui for an rsc-kit app, new or existing.
+ *
+ * Already set up - a components.json is there, from a Next app say - it is
+ * only marked RSC. Otherwise shadcn's own init runs, once dependencies are
+ * installed, and its result is marked: its CLI sees a plain Vite project and
+ * writes "rsc": false, so a dialog or a dropdown it adds later has no
+ * "use client" and fails to render as a server component.
+ *
+ * Its questions are its own - the component library, the style - so it asks
+ * them in this terminal, unless the run was told to ask nothing, in which
+ * case it takes its defaults too.
+ */
+export function setUpShadcn(o) {
+    const config = join(o.dir, 'components.json');
+    if (existsSync(config)) {
+        markRsc(config);
+        stdout.write(`\n  ${cyan('~')} components.json  ${dim('— "rsc": true, so shadcn adds "use client" where it is needed')}\n`);
+        return;
+    }
+    const [runner, ...prefix] = o.host === 'node' ? ['npx', '--yes'] : ['bunx', '--bun'];
+    const init = [...prefix, 'shadcn@latest', 'init', ...(o.unattended ? ['--defaults', '--yes'] : [])];
+    if (!o.installed || spawnSync(runner, init, { cwd: o.dir, stdio: 'inherit' }).status !== 0) {
+        stdout.write(`\n${bold('shadcn/ui is not set up.')} Once dependencies are installed:\n` +
+            `  ${cyan([runner, ...init].join(' '))}\n` +
+            `  then set ${cyan('"rsc": true')} in components.json\n`);
+        return;
+    }
+    markRsc(config);
+}

package/dist/templates.js

@@ -50,13 +50,13 @@ export const configFile = (_o) => 'vite.config.ts';
  */
 export function scripts(o) {
     if (o.host === 'laravel') {
-        const actions = 'php artisan rsc:action-manifest';
         return {
             // The ordinary names. A Laravel application already has `dev` and
-            // `build`, and init combines rather than replaces — the stock ones run
-            // the asset pipeline, and both pipelines belong to `npm run dev`.
-            dev: `${actions} && vite`,
-            build: `${actions} && vite build`,
+            // `build`, and init combines rather than replaces. PHP's manifest is
+            // not here: vite.config.ts runs it (hostManifest), so no script that
+            // starts Vite can skip it.
+            dev: 'vite',
+            build: 'vite build',
             // What the build wrote. There is no server file to start any more.
             start: 'bun .output/server/index.mjs',
         };
@@ -218,6 +218,9 @@ export function viteConfig(o) {
         `sourceDir: '${p.sourceDir}'`,
         `outDir: '${p.outDir}'`,
         ...(p.hotFile ? [`hotFile: '${p.hotFile}'`] : []),
+        // The actions and functions PHP offers, written as dev and every build
+        // start - reflection through Composer's autoloader, which only PHP has.
+        ...(o.host === 'laravel' ? ["hostManifest: { command: ['php', 'artisan', 'rsc:host-manifest'] }"] : []),
         // A service worker: the app survives a reload with no network. Off
         // unless asked for, because it outlives the code that installed it.
         ...(o.pwa ? ['offline: true'] : []),

package/package.json

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