create-react-on-rails-app 17.0.0-rc.0 → 17.0.0-rc.10

package/lib/create-app.js

@@ -123,11 +123,20 @@ function localGemPath(envVarName) {
     }
     return resolvedPath;
 }
-function bundleAddArgs(gemName, localPath, strict = true) {
+function rubygemsPrereleaseVersion(cliVersion) {
+    if (!cliVersion || !cliVersion.includes('-')) {
+        return null;
+    }
+    return cliVersion.replace('-', '.');
+}
+function bundleAddArgs(gemName, localPath, strict = true, version = null) {
     const args = ['add', gemName];
     if (localPath) {
         args.push('--path', localPath);
     }
+    else if (version) {
+        args.push('--version', `= ${version}`);
+    }
     else if (strict) {
         args.push('--strict');
     }
@@ -138,8 +147,12 @@ function buildGeneratorArgs(options) {
     if (options.template === 'typescript') {
         args.push('--typescript');
     }
-    if (options.rspack) {
-        args.push('--rspack');
+    // Always forward an explicit --rspack / --no-rspack so the generator never falls back to
+    // its own default. This keeps create-app's resolved choice authoritative regardless of what
+    // the generator's fresh-install default happens to be (now, or if it changes again later).
+    args.push(options.rspack ? '--rspack' : '--no-rspack');
+    if (options.tailwind) {
+        args.push('--tailwind');
     }
     // --rsc supersedes --pro because RSC mode already requires Pro and the generator accepts a single mode flag.
     if (options.pro && !options.rsc) {
@@ -148,6 +161,11 @@ function buildGeneratorArgs(options) {
     if (options.rsc) {
         args.push('--rsc');
     }
+    // Agent files default ON in the generator, so only forward the opt-out. This keeps
+    // the install generator the single source of truth for the AGENTS.md template.
+    if (!options.agentFiles) {
+        args.push('--no-agent-files');
+    }
     // --force makes the generator overwrite conflicting files without prompting,
     // which is safe for a freshly scaffolded app with no custom content yet.
     args.push('--force');
@@ -309,21 +327,23 @@ function reactOnRailsProCommitMessage(modeFlag) {
 function generatorCommitMessage(options) {
     const language = options.template === 'typescript' ? 'TypeScript' : 'JavaScript';
     const bundler = options.rspack ? 'Rspack' : 'Webpack';
+    const setup = options.tailwind ? `${language}, ${bundler}, and Tailwind CSS` : `${language} and ${bundler}`;
+    const tailwindFlag = options.tailwind ? ' --tailwind' : '';
     if (options.rsc) {
         return {
-            subject: `Install React Server Components with ${language} and ${bundler}`,
-            body: 'Run react_on_rails:install --rsc to add the generated home page, HelloServer example, and Pro RSC wiring.',
+            subject: `Install React Server Components with ${setup}`,
+            body: `Run react_on_rails:install --rsc${tailwindFlag} to add the generated home page, HelloServer example, and Pro RSC wiring.`,
         };
     }
     if (options.pro) {
         return {
-            subject: `Install React on Rails Pro with ${language} and ${bundler}`,
-            body: 'Run react_on_rails:install --pro to add the generated home page, SSR example, and Pro Node renderer wiring.',
+            subject: `Install React on Rails Pro with ${setup}`,
+            body: `Run react_on_rails:install --pro${tailwindFlag} to add the generated home page, SSR example, and Pro Node renderer wiring.`,
         };
     }
     return {
-        subject: `Install React on Rails with ${language} and ${bundler}`,
-        body: 'Run react_on_rails:install to add the generated home page, SSR example, and development workflow.',
+        subject: `Install React on Rails with ${setup}`,
+        body: `Run react_on_rails:install${tailwindFlag} to add the generated home page, SSR example, and development workflow.`,
     };
 }
 function pnpmCommitMessage() {
@@ -394,6 +414,7 @@ function createApp(appName, options) {
     let currentStep = 1;
     const reactOnRailsGemPath = localGemPath('REACT_ON_RAILS_GEM_PATH');
     const reactOnRailsProGemPath = proRequested ? localGemPath('REACT_ON_RAILS_PRO_GEM_PATH') : null;
+    const prereleaseGemVersion = rubygemsPrereleaseVersion(options.cliVersion);
     function educationalGitEnvForCommits() {
         if (!cachedEducationalGitEnv) {
             // The baseline commit happens before git init; in that case git config falls back
@@ -440,7 +461,7 @@ function createApp(appName, options) {
     currentStep += 1;
     (0, utils_js_1.logStep)(currentStep, totalSteps, 'Adding react_on_rails gem...');
     try {
-        const reactOnRailsArgs = bundleAddArgs('react_on_rails', reactOnRailsGemPath);
+        const reactOnRailsArgs = bundleAddArgs('react_on_rails', reactOnRailsGemPath, true, prereleaseGemVersion);
         if (reactOnRailsGemPath) {
             (0, utils_js_1.logInfo)(`Using local react_on_rails gem path: ${reactOnRailsGemPath}`);
         }
@@ -461,7 +482,7 @@ function createApp(appName, options) {
         currentStep += 1;
         (0, utils_js_1.logStep)(currentStep, totalSteps, `Adding react_on_rails_pro gem (${proModeLabel})...`);
         try {
-            const reactOnRailsProArgs = bundleAddArgs('react_on_rails_pro', reactOnRailsProGemPath, false);
+            const reactOnRailsProArgs = bundleAddArgs('react_on_rails_pro', reactOnRailsProGemPath, false, prereleaseGemVersion);
             if (reactOnRailsProGemPath) {
                 (0, utils_js_1.logInfo)(`Using local react_on_rails_pro gem path: ${reactOnRailsProGemPath}`);
             }

package/lib/index.js

@@ -1,24 +1,22 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ready = void 0;
 const commander_1 = require("commander");
-const chalk_1 = __importDefault(require("chalk"));
 const validators_js_1 = require("./validators.js");
 const create_app_js_1 = require("./create-app.js");
+const mode_js_1 = require("./mode.js");
 const utils_js_1 = require("./utils.js");
-const prompt_js_1 = require("./prompt.js");
 // Use require() for CJS compatibility - avoids __dirname + fs.readFileSync
 // eslint-disable-next-line @typescript-eslint/no-require-imports, global-require
 const packageJson = require('../package.json');
-async function run(appName, rawOpts) {
-    const { template } = rawOpts;
-    if (typeof template !== 'string' || (template !== 'javascript' && template !== 'typescript')) {
-        (0, utils_js_1.logError)(`Invalid template "${String(template)}". Must be "javascript" or "typescript".`);
+function run(appName, rawOpts, command) {
+    const { template: rawTemplate } = rawOpts;
+    if (typeof rawTemplate !== 'string' || (rawTemplate !== 'javascript' && rawTemplate !== 'typescript')) {
+        (0, utils_js_1.logError)(`Invalid template "${String(rawTemplate)}". Must be "javascript" or "typescript".`);
         process.exit(1);
+        return;
     }
+    const template = rawTemplate;
     let packageManager = rawOpts.packageManager;
     if (packageManager) {
         if (packageManager !== 'npm' && packageManager !== 'pnpm') {
@@ -29,58 +27,74 @@ async function run(appName, rawOpts) {
     else {
         packageManager = (0, utils_js_1.detectPackageManager)() ?? 'npm';
     }
-    if (rawOpts.standard && (rawOpts.pro || rawOpts.rsc)) {
-        (0, utils_js_1.logError)('--standard cannot be combined with --pro or --rsc.');
+    let setupMode;
+    try {
+        setupMode = (0, mode_js_1.resolveSetupMode)(rawOpts);
+    }
+    catch (error) {
+        (0, utils_js_1.logError)(error instanceof Error ? error.message : String(error));
+        process.exit(1);
+        return;
+    }
+    // --webpack is a friendly alias for --no-rspack. Commander reports --no-rspack's declared
+    // default as rawOpts.rspack === true, so we use the option source to distinguish an explicit
+    // --rspack from the default and reject contradictory flags (--rspack --webpack).
+    const rspackExplicitlyTrue = rawOpts.rspack === true && command?.getOptionValueSource('rspack') === 'cli';
+    const webpackRequested = rawOpts.webpack === true;
+    if (webpackRequested && rspackExplicitlyTrue) {
+        (0, utils_js_1.logError)('Conflicting bundler flags: pass either --rspack or --webpack (alias for --no-rspack), not both.');
         process.exit(1);
     }
-    let pro = Boolean(rawOpts.pro);
-    let rsc = Boolean(rawOpts.rsc);
     console.log('');
-    console.log(`${chalk_1.default.bold('create-react-on-rails-app')} v${packageJson.version}`);
+    console.log(`${utils_js_1.pc.bold('create-react-on-rails-app')} v${packageJson.version}`);
     console.log('');
     const nameValidation = (0, create_app_js_1.validateAppName)(appName);
     if (!nameValidation.success) {
         (0, utils_js_1.logError)(nameValidation.error ?? 'Invalid app name');
         process.exit(1);
     }
-    // When no mode flag is explicitly passed, prompt interactively (TTY only).
-    // Non-interactive environments (CI, pipes) fall back to standard mode.
-    const modeExplicit = rawOpts.pro !== undefined || rawOpts.rsc !== undefined || rawOpts.standard !== undefined;
-    if (!modeExplicit) {
-        if (process.stdin.isTTY && process.stdout.isTTY) {
-            const choice = await (0, prompt_js_1.promptForMode)();
-            pro = choice.pro;
-            rsc = choice.rsc;
-        }
-        else {
-            (0, utils_js_1.logInfo)('No mode flag specified and not running interactively (stdin/stdout is not a TTY); using standard mode.');
-        }
-    }
     const options = {
         template,
         packageManager: packageManager,
-        rspack: Boolean(rawOpts.rspack),
-        pro,
-        rsc,
+        // Rspack is the default; an explicit --no-rspack or its --webpack alias selects Webpack.
+        // (rawOpts.rspack ?? true) makes the three inputs explicit: undefined (no flag) -> true,
+        // true (--rspack) -> true, false (--no-rspack) -> false.
+        // Footgun: re-adding `.option('--rspack', desc, false)` would default rawOpts.rspack to
+        // false and silently flip the default back to Webpack.
+        // Note: buildGeneratorArgs always forwards an explicit --rspack/--no-rspack to the Ruby
+        // generator, so the generator's own fresh-install fallback (fresh_install_rspack_default,
+        // which consults the Shakapacker version) is never reached via create-react-on-rails-app.
+        rspack: webpackRequested ? false : (rawOpts.rspack ?? true) === true,
+        tailwind: Boolean(rawOpts.tailwind),
+        pro: setupMode.pro,
+        rsc: setupMode.rsc,
+        // Commander's `--no-agent-files` declares a default of true on rawOpts.agentFiles,
+        // so undefined (no flag) and true (default) both map to true; only --no-agent-files
+        // sets it false.
+        agentFiles: (rawOpts.agentFiles ?? true) === true,
+        cliVersion: packageJson.version,
     };
-    if (options.rsc && options.pro) {
-        (0, utils_js_1.logInfo)('Note: --rsc takes precedence over --pro; --pro will be ignored.');
+    if (setupMode.defaulted) {
+        (0, utils_js_1.logInfo)('Default setup: React on Rails Pro for React 19.2 support. Use --standard only when you intentionally want an open-source-only setup.');
     }
-    if (options.rsc || options.pro) {
+    if (setupMode.requiresPro) {
         const modeFlag = options.rsc ? '--rsc' : '--pro';
-        (0, utils_js_1.logInfo)(`Note: ${modeFlag} installs react_on_rails_pro and requires that gem to be installable.`);
-        (0, utils_js_1.logInfo)(`If installation fails, verify your Bundler/RubyGems setup for react_on_rails_pro, then rerun with ${modeFlag}.`);
+        const setupLabel = setupMode.defaulted ? 'The default setup' : modeFlag;
+        (0, utils_js_1.logInfo)(`Note: ${setupLabel} adds react_on_rails_pro and uses the Pro generator path.`);
+        (0, utils_js_1.logInfo)('If installation fails, verify your Bundler/RubyGems setup, then rerun the command.');
         (0, utils_js_1.logInfo)('Pro setup docs: https://reactonrails.com/docs/pro/installation/');
+        (0, utils_js_1.logInfo)('Pro pricing and sign up: https://pro.reactonrails.com/');
+        (0, utils_js_1.logInfo)('License: no token is required for development, test, CI/CD, or staging. Production Pro deployments need a paid license, with free or low-cost options for startups and small projects.');
         console.log('');
     }
     (0, utils_js_1.logInfo)('Checking prerequisites...');
     const { allValid, results } = (0, validators_js_1.validateAll)(options.packageManager);
     for (const { name, result } of results) {
         if (result.valid) {
-            console.log(chalk_1.default.green(`  ✓ ${name}: ${result.message}`));
+            console.log(utils_js_1.pc.green(`  ✓ ${name}: ${result.message}`));
         }
         else {
-            console.log(chalk_1.default.red(`  ✗ ${name}`));
+            console.log(utils_js_1.pc.red(`  ✗ ${name}`));
         }
     }
     if (!allValid) {
@@ -95,12 +109,16 @@ async function run(appName, rawOpts) {
     console.log('');
     let modeLabel = '';
     if (options.rsc) {
-        modeLabel = ', mode: rsc';
+        modeLabel = ', setup: pro with RSC example';
     }
     else if (options.pro) {
-        modeLabel = ', mode: pro';
+        modeLabel = ', setup: pro without RSC example';
     }
-    (0, utils_js_1.logInfo)(`Creating "${appName}" with template: ${options.template}, package manager: ${options.packageManager}${options.rspack ? ', bundler: rspack' : ''}${modeLabel}`);
+    else {
+        modeLabel = ', setup: open-source-only';
+    }
+    const tailwindLabel = options.tailwind ? ', Tailwind CSS v4' : '';
+    (0, utils_js_1.logInfo)(`Creating "${appName}" with template: ${options.template}, package manager: ${options.packageManager}, bundler: ${options.rspack ? 'rspack' : 'webpack'}${modeLabel}${tailwindLabel}`);
     (0, create_app_js_1.createApp)(appName, options);
 }
 const program = new commander_1.Command();
@@ -113,35 +131,47 @@ program
     .argument('<app-name>', 'Name of the application to create')
     .option('-t, --template <type>', 'javascript or typescript', 'typescript')
     .option('-p, --package-manager <pm>', 'npm or pnpm (auto-detected if not specified)')
-    .option('--rspack', 'Use Rspack instead of Webpack (~20x faster builds)', false)
-    .option('--standard', 'Generate open-source React on Rails setup (skip prompt)')
-    .option('--pro', 'Generate React on Rails Pro setup (installs react_on_rails_pro)')
-    .option('--rsc', 'Generate React Server Components setup (installs react_on_rails_pro)')
+    .option('--rspack', 'Use Rspack as the bundler (default, ~20x faster builds)')
+    .option('--no-rspack', 'Use Webpack instead of Rspack')
+    .option('--webpack', 'Use Webpack as the bundler (alias for --no-rspack)')
+    .option('--tailwind', 'Install Tailwind CSS v4 and style the generated SSR example')
+    .option('--standard', 'Advanced: generate open-source React on Rails without Pro React 19.2 features')
+    .option('--pro', 'Generate the default React on Rails Pro setup explicitly')
+    .option('--rsc', 'Advanced: generate React on Rails Pro with the RSC example')
+    .option('--no-agent-files', 'Skip AI-agent guidance files (AGENTS.md + editor pointers)')
     .addHelpText('after', `
 Examples:
-  $ npx create-react-on-rails-app my-app                        # prompts for mode
-  $ npx create-react-on-rails-app my-app --rsc                  # skip prompt, use RSC
-  $ npx create-react-on-rails-app my-app --pro                  # skip prompt, use Pro
-  $ npx create-react-on-rails-app my-app --standard             # skip prompt, use Standard
+  $ npx create-react-on-rails-app my-app                        # default: Pro for React 19.2 support
   $ npx create-react-on-rails-app my-app --template javascript
-  $ npx create-react-on-rails-app my-app --rspack
-  $ npx create-react-on-rails-app my-app --rspack --rsc
+  $ npx create-react-on-rails-app my-app --no-rspack             # use Webpack instead of Rspack
+  $ npx create-react-on-rails-app my-app --webpack               # same as --no-rspack
+  $ npx create-react-on-rails-app my-app --tailwind
+  $ npx create-react-on-rails-app my-app --pro                   # explicit default Pro setup
+  $ npx create-react-on-rails-app my-app --rsc                   # advanced: Pro with RSC example
+  $ npx create-react-on-rails-app my-app --standard              # advanced: OSS-only setup
+  $ npx create-react-on-rails-app my-app --no-rspack --rsc
   $ npx create-react-on-rails-app my-app --package-manager pnpm
+  $ npx create-react-on-rails-app my-app --no-agent-files            # skip AGENTS.md + editor pointers
+
+No setup questions are asked. New apps use React on Rails Pro by default because
+that is where React 19.2 feature support lives. Use --standard only when you
+intentionally want an open-source-only scaffold. Use --rsc when you want the
+generated React Server Components example.
 
-When no mode flag (--standard, --pro, or --rsc) is given, an interactive prompt
-lets you choose between Standard, Pro, and RSC modes (default: RSC). When stdin
-or stdout is not a TTY (for example in CI, piped input, or redirected output),
-standard mode is used automatically.
+Pro license note: no token is required for development, test, CI/CD, or
+staging. Production Pro deployments need a paid license, with free or low-cost
+options for startups and small projects. See pricing and sign up:
+https://pro.reactonrails.com/
 
 What it does:
   1. Creates a new Rails app with PostgreSQL
-  2. Adds required gem(s) (react_on_rails, plus react_on_rails_pro for Pro/RSC)
+  2. Adds required gem(s) (react_on_rails, plus react_on_rails_pro unless --standard)
   3. Runs the React on Rails generator (Shakapacker, components, webpack config)
   4. Creates educational git commits for each major scaffold step
 
 After setup, run bin/dev and visit:
   - http://localhost:3000 (generated home page)
-  - /hello_world (default and --pro example page)
+  - /hello_world (default, --standard, and --pro example page)
   - /hello_server (--rsc example page)
 
 Inspect the generated setup history with:
@@ -152,15 +182,11 @@ The generated app includes one git commit per logical setup step.`)
 --pro and --rsc support both JavaScript and TypeScript templates.
 
 Documentation: https://reactonrails.com/docs/`)
-    .action(async (appName, opts) => {
+    .action((appName, opts, command) => {
     try {
-        await run(appName, opts);
+        run(appName, opts, command);
     }
     catch (error) {
-        if (error instanceof Error && error.message === prompt_js_1.PROMPT_CANCELLED) {
-            console.log('');
-            process.exit(0);
-        }
         (0, utils_js_1.logError)(error instanceof Error ? error.message : String(error));
         process.exit(1);
     }

package/lib/mode.d.ts

@@ -0,0 +1,33 @@
+export type SetupMode = 'standard' | 'pro' | 'rsc';
+interface ResolvedSetupModeBase {
+    defaulted: boolean;
+    mode: SetupMode;
+}
+interface StandardResolvedSetupMode extends ResolvedSetupModeBase {
+    defaulted: false;
+    mode: 'standard';
+    requiresPro: false;
+    pro: false;
+    rsc: false;
+}
+interface ProResolvedSetupMode extends ResolvedSetupModeBase {
+    mode: 'pro';
+    /** True when the selected setup installs react_on_rails_pro. */
+    requiresPro: true;
+    /** True for the Pro-without-RSC generator path. RSC mode uses its own Pro path. */
+    pro: true;
+    rsc: false;
+}
+interface RscResolvedSetupMode extends ResolvedSetupModeBase {
+    defaulted: false;
+    mode: 'rsc';
+    /** True when the selected setup installs react_on_rails_pro. */
+    requiresPro: true;
+    /** RSC mode uses its own Pro generator path, so this generator flag is false. */
+    pro: false;
+    rsc: true;
+}
+export type ResolvedSetupMode = StandardResolvedSetupMode | ProResolvedSetupMode | RscResolvedSetupMode;
+export declare function resolveSetupMode(rawOpts: Record<string, unknown>): ResolvedSetupMode;
+export {};
+//# sourceMappingURL=mode.d.ts.map

package/lib/mode.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveSetupMode = resolveSetupMode;
+function makeSetupMode(mode, defaulted) {
+    if (mode === 'standard') {
+        return {
+            defaulted: false,
+            mode,
+            requiresPro: false,
+            pro: false,
+            rsc: false,
+        };
+    }
+    if (mode === 'rsc') {
+        return {
+            defaulted: false,
+            mode,
+            requiresPro: true,
+            pro: false,
+            rsc: true,
+        };
+    }
+    return {
+        defaulted,
+        mode,
+        requiresPro: true,
+        pro: true,
+        rsc: false,
+    };
+}
+function resolveSetupMode(rawOpts) {
+    const standard = Boolean(rawOpts.standard);
+    const pro = Boolean(rawOpts.pro);
+    const rsc = Boolean(rawOpts.rsc);
+    if ([standard, pro, rsc].filter(Boolean).length > 1) {
+        throw new Error('Choose only one setup mode: --standard, --pro, or --rsc.');
+    }
+    if (standard) {
+        return makeSetupMode('standard', false);
+    }
+    if (rsc) {
+        return makeSetupMode('rsc', false);
+    }
+    if (pro) {
+        return makeSetupMode('pro', false);
+    }
+    return makeSetupMode('pro', true);
+}
+//# sourceMappingURL=mode.js.map

package/lib/types.d.ts

@@ -2,8 +2,11 @@ export interface CliOptions {
     template: 'javascript' | 'typescript';
     packageManager: 'npm' | 'pnpm';
     rspack: boolean;
+    tailwind: boolean;
     pro: boolean;
     rsc: boolean;
+    agentFiles: boolean;
+    cliVersion?: string;
 }
 export interface ValidationResult {
     valid: boolean;

package/lib/utils.d.ts

@@ -1,3 +1,4 @@
+export declare const pc: import("picocolors/types").Colors;
 /**
  * Execute a command and stream output to the current terminal.
  *

package/lib/utils.js

@@ -3,6 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.pc = void 0;
 exports.execLiveArgs = execLiveArgs;
 exports.execCaptureArgs = execCaptureArgs;
 exports.getCommandVersion = getCommandVersion;
@@ -13,7 +14,70 @@ exports.logError = logError;
 exports.logSuccess = logSuccess;
 exports.logInfo = logInfo;
 const child_process_1 = require("child_process");
-const chalk_1 = __importDefault(require("chalk"));
+const picocolors_1 = __importDefault(require("picocolors"));
+const CHALK_CI_COLOR_ENV_KEYS = [
+    'TRAVIS',
+    'CIRCLECI',
+    'APPVEYOR',
+    'GITLAB_CI',
+    'GITHUB_ACTIONS',
+    'BUILDKITE',
+];
+const CHALK_TEAMCITY_COLOR_PATTERN = /^(9\.(0*[1-9]\d*)\.|\d{2,}\.)/;
+const CHALK_TERM_256_COLOR_PATTERN = /-256(color)?$/i;
+const CHALK_TERM_COLOR_PATTERN = /^screen|^xterm|^vt100|^vt220|^rxvt|color|ansi|cygwin|linux/i;
+function hasChalkCompatibleTtyColorSignal() {
+    const { CI, CI_NAME, COLORTERM, TEAMCITY_VERSION, TERM, TERM_PROGRAM } = process.env;
+    if (TERM === 'dumb') {
+        return false;
+    }
+    if (process.platform === 'win32') {
+        return true;
+    }
+    if (CI !== undefined) {
+        return CHALK_CI_COLOR_ENV_KEYS.some((key) => process.env[key] !== undefined) || CI_NAME === 'codeship';
+    }
+    if (TEAMCITY_VERSION !== undefined) {
+        return CHALK_TEAMCITY_COLOR_PATTERN.test(TEAMCITY_VERSION);
+    }
+    if (COLORTERM === 'truecolor') {
+        return true;
+    }
+    if (TERM_PROGRAM === 'iTerm.app' || TERM_PROGRAM === 'Apple_Terminal') {
+        return true;
+    }
+    const term = TERM ?? '';
+    return (CHALK_TERM_256_COLOR_PATTERN.test(term) || CHALK_TERM_COLOR_PATTERN.test(term) || COLORTERM !== undefined);
+}
+/**
+ * Decide whether to colorize output, matching what `chalk@4` produced before the
+ * chalk→picocolors swap. The scaffolder is a user's first contact with the
+ * framework and its logs are often captured, so keeping the same basic
+ * colorize/plain decision avoids surprising behavior changes.
+ *
+ * picocolors' own `isColorSupported` bakes in a different precedence than chalk
+ * (it lets NO_COLOR override FORCE_COLOR, and enables color on a bare CI even for
+ * piped stdout), so instead of deferring to it we reproduce the relevant chalk@4
+ * environment precedence directly and only use picocolors for the actual escape codes:
+ *
+ *   1. FORCE_COLOR present  → `0`/`false` disables; any other value (incl. empty)
+ *      forces color ON, overriding NO_COLOR and a non-TTY stdout.
+ *   2. else NO_COLOR present (any value, incl. empty) → disabled.
+ *   3. else colorize only for an interactive TTY with one of chalk@4's positive
+ *      environment signals. A bare TTY with unset or unrecognized TERM stays
+ *      plain, matching supports-color@7.2.0's fallback behavior.
+ */
+function chalkCompatibleColorEnabled() {
+    const { FORCE_COLOR, NO_COLOR } = process.env;
+    if (FORCE_COLOR !== undefined) {
+        return FORCE_COLOR !== '0' && FORCE_COLOR !== 'false';
+    }
+    if (NO_COLOR !== undefined) {
+        return false;
+    }
+    return (process.stdout?.isTTY ?? false) && hasChalkCompatibleTtyColorSignal();
+}
+exports.pc = picocolors_1.default.createColors(chalkCompatibleColorEnabled());
 function childEnv(env) {
     // Always inherit PATH, HOME, and the rest of process.env; callers only add/override keys.
     return env ? { ...process.env, ...env } : process.env;
@@ -85,18 +149,18 @@ function detectPackageManager() {
     return null;
 }
 function logStep(current, total, message) {
-    console.log(chalk_1.default.cyan(`\n[${current}/${total}] ${message}`));
+    console.log(exports.pc.cyan(`\n[${current}/${total}] ${message}`));
 }
 function logStepDone(message) {
-    console.log(chalk_1.default.green(`  ✓ ${message}`));
+    console.log(exports.pc.green(`  ✓ ${message}`));
 }
 function logError(message) {
-    console.error(chalk_1.default.red(`\nError: ${message}\n`));
+    console.error(exports.pc.red(`\nError: ${message}\n`));
 }
 function logSuccess(message) {
-    console.log(chalk_1.default.green(message));
+    console.log(exports.pc.green(message));
 }
 function logInfo(message) {
-    console.log(chalk_1.default.cyan(message));
+    console.log(exports.pc.cyan(message));
 }
 //# sourceMappingURL=utils.js.map

package/lib/validators.js

@@ -9,7 +9,7 @@ exports.validateAll = validateAll;
 const utils_js_1 = require("./utils.js");
 const MIN_NODE_VERSION = 18;
 const MIN_RUBY_MAJOR = 3;
-const MIN_RUBY_MINOR = 0;
+const MIN_RUBY_MINOR = 3;
 const MIN_RAILS_MAJOR = 7;
 const MIN_RAILS_MINOR = 0;
 function validateNode() {
@@ -30,7 +30,7 @@ function validateRuby() {
         return {
             valid: false,
             message: 'Ruby is not installed or not found in PATH.\n\n' +
-                'React on Rails requires Ruby 3.0+.\n\n' +
+                `React on Rails requires Ruby ${MIN_RUBY_MAJOR}.${MIN_RUBY_MINOR}+.\n\n` +
                 'Popular installation options:\n' +
                 '  - mise:   https://mise.jdx.dev/ (recommended)\n' +
                 '  - rbenv:  https://github.com/rbenv/rbenv\n' +

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-react-on-rails-app",
-  "version": "17.0.0-rc.0",
+  "version": "17.0.0-rc.10",
   "description": "Create React on Rails applications with a single command",
   "bin": {
     "create-react-on-rails-app": "./bin/create-react-on-rails-app.js"
@@ -12,8 +12,8 @@
     "lib/**/*.d.ts"
   ],
   "dependencies": {
-    "chalk": "^4.1.2",
-    "commander": "^12.1.0"
+    "commander": "^12.1.0",
+    "picocolors": "^1.1.1"
   },
   "devDependencies": {
     "@types/node": "^20.17.16",

package/lib/prompt.d.ts

@@ -1,7 +0,0 @@
-export interface ModeChoice {
-    pro: boolean;
-    rsc: boolean;
-}
-export declare const PROMPT_CANCELLED = "Prompt cancelled by user";
-export declare function promptForMode(): Promise<ModeChoice>;
-//# sourceMappingURL=prompt.d.ts.map

package/lib/prompt.js

@@ -1,72 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PROMPT_CANCELLED = void 0;
-exports.promptForMode = promptForMode;
-const readline_1 = __importDefault(require("readline"));
-const chalk_1 = __importDefault(require("chalk"));
-exports.PROMPT_CANCELLED = 'Prompt cancelled by user';
-const MODES = [
-    {
-        key: '1',
-        label: 'Standard',
-        desc: 'Open-source React on Rails with SSR',
-        pro: false,
-        rsc: false,
-    },
-    {
-        key: '2',
-        label: 'Pro',
-        desc: 'Adds Node.js server rendering (requires react_on_rails_pro)',
-        pro: true,
-        rsc: false,
-    },
-    {
-        key: '3',
-        label: 'RSC',
-        desc: 'React Server Components (requires react_on_rails_pro)',
-        pro: false,
-        rsc: true,
-    },
-];
-const DEFAULT_KEY = '3';
-function promptForMode() {
-    return new Promise((resolve, reject) => {
-        const rl = readline_1.default.createInterface({
-            input: process.stdin,
-            output: process.stdout,
-        });
-        let answered = false;
-        rl.on('SIGINT', () => {
-            answered = true;
-            rl.close();
-            reject(new Error(exports.PROMPT_CANCELLED));
-        });
-        rl.once('close', () => {
-            if (!answered) {
-                reject(new Error(exports.PROMPT_CANCELLED));
-            }
-        });
-        console.log(chalk_1.default.bold('Select a setup mode:\n'));
-        for (const mode of MODES) {
-            const recommended = mode.key === DEFAULT_KEY ? chalk_1.default.cyan(' (recommended)') : '';
-            console.log(`  ${mode.key}. ${chalk_1.default.bold(mode.label.padEnd(10))} ${mode.desc}${recommended}`);
-        }
-        console.log('');
-        rl.question(`Choice (1-3) [${DEFAULT_KEY}]: `, (answer) => {
-            answered = true;
-            rl.close();
-            const key = answer.trim() || DEFAULT_KEY;
-            const selected = MODES.find((m) => m.key === key);
-            if (!selected) {
-                console.log(chalk_1.default.yellow(`Invalid choice "${key}", defaulting to RSC.`));
-                resolve({ pro: false, rsc: true });
-                return;
-            }
-            resolve({ pro: selected.pro, rsc: selected.rsc });
-        });
-    });
-}
-//# sourceMappingURL=prompt.js.map