create-react-on-rails-app 17.0.0-rc.1 → 17.0.0-rc.3

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');
     }
@@ -142,6 +151,9 @@ function buildGeneratorArgs(options) {
     // 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) {
         args.push('--pro');
@@ -149,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');
@@ -310,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() {
@@ -395,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
@@ -441,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}`);
         }
@@ -462,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

@@ -44,6 +44,7 @@ async function run(appName, rawOpts, command) {
     }
     let pro = Boolean(rawOpts.pro);
     let rsc = Boolean(rawOpts.rsc);
+    let tailwind = Boolean(rawOpts.tailwind);
     console.log('');
     console.log(`${chalk_1.default.bold('create-react-on-rails-app')} v${packageJson.version}`);
     console.log('');
@@ -60,6 +61,10 @@ async function run(appName, rawOpts, command) {
             const choice = await (0, prompt_js_1.promptForMode)();
             pro = choice.pro;
             rsc = choice.rsc;
+            // Explicit mode flags keep the command deterministic; no-flag interactive runs get the Tailwind prompt.
+            if (rawOpts.tailwind === undefined) {
+                tailwind = await (0, prompt_js_1.promptForTailwind)();
+            }
         }
         else {
             (0, utils_js_1.logInfo)('No mode flag specified and not running interactively (stdin/stdout is not a TTY); using standard mode.');
@@ -77,8 +82,14 @@ async function run(appName, rawOpts, command) {
         // 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,
         pro,
         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.');
@@ -117,7 +128,8 @@ async function run(appName, rawOpts, command) {
     else if (options.pro) {
         modeLabel = ', mode: pro';
     }
-    (0, utils_js_1.logInfo)(`Creating "${appName}" with template: ${options.template}, package manager: ${options.packageManager}, bundler: ${options.rspack ? 'rspack' : 'webpack'}${modeLabel}`);
+    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();
@@ -133,9 +145,11 @@ program
     .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', '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('--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
@@ -145,8 +159,10 @@ Examples:
   $ npx create-react-on-rails-app my-app --template javascript
   $ 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 --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
 
 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

package/lib/prompt.d.ts

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

package/lib/prompt.js

@@ -5,6 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PROMPT_CANCELLED = void 0;
 exports.promptForMode = promptForMode;
+exports.promptForTailwind = promptForTailwind;
 const readline_1 = __importDefault(require("readline"));
 const chalk_1 = __importDefault(require("chalk"));
 exports.PROMPT_CANCELLED = 'Prompt cancelled by user';
@@ -32,23 +33,32 @@ const MODES = [
     },
 ];
 const DEFAULT_KEY = '3';
+function createPromptInterface() {
+    return readline_1.default.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+}
+function rejectWhenClosed(rl, reject) {
+    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));
+        }
+    });
+    return () => {
+        answered = true;
+    };
+}
 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));
-            }
-        });
+        const rl = createPromptInterface();
+        const markAnswered = rejectWhenClosed(rl, reject);
         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)') : '';
@@ -56,7 +66,7 @@ function promptForMode() {
         }
         console.log('');
         rl.question(`Choice (1-3) [${DEFAULT_KEY}]: `, (answer) => {
-            answered = true;
+            markAnswered();
             rl.close();
             const key = answer.trim() || DEFAULT_KEY;
             const selected = MODES.find((m) => m.key === key);
@@ -69,4 +79,20 @@ function promptForMode() {
         });
     });
 }
+function promptForTailwind() {
+    return new Promise((resolve, reject) => {
+        const rl = createPromptInterface();
+        const markAnswered = rejectWhenClosed(rl, reject);
+        console.log(chalk_1.default.bold('Add styling:\n'));
+        console.log(`  ${chalk_1.default.bold('Y. Tailwind CSS v4')} ${chalk_1.default.cyan('(recommended)')}`);
+        console.log('  n. No Tailwind CSS');
+        console.log('');
+        rl.question('Add Tailwind CSS v4? [Y/n]: ', (answer) => {
+            markAnswered();
+            rl.close();
+            const normalized = answer.trim().toLowerCase();
+            resolve(!(normalized === 'n' || normalized === 'no'));
+        });
+    });
+}
 //# sourceMappingURL=prompt.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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-react-on-rails-app",
-  "version": "17.0.0-rc.1",
+  "version": "17.0.0-rc.3",
   "description": "Create React on Rails applications with a single command",
   "bin": {
     "create-react-on-rails-app": "./bin/create-react-on-rails-app.js"