create-cloudinary-react 1.0.0-beta.10 → 1.0.0-beta.12

package/CHANGELOG.md

@@ -1,3 +1,22 @@
+# [1.0.0-beta.12](https://github.com/cloudinary-devs/create-cloudinary-react/compare/v1.0.0-beta.11...v1.0.0-beta.12) (2026-02-02)
+
+
+### Bug Fixes
+
+* remove console.log ([369e92f](https://github.com/cloudinary-devs/create-cloudinary-react/commit/369e92f3cb3e5af633c1553380119d5a685ec506))
+
+
+### Features
+
+* non-interactive 'headless' mode ([4334991](https://github.com/cloudinary-devs/create-cloudinary-react/commit/4334991f99eddfb3ae2b017c977f9c69c0c500fd))
+
+# [1.0.0-beta.11](https://github.com/cloudinary-devs/create-cloudinary-react/compare/v1.0.0-beta.10...v1.0.0-beta.11) (2026-01-30)
+
+
+### Features
+
+* put Inquirer inputs on a new, separate line ([ba4a26d](https://github.com/cloudinary-devs/create-cloudinary-react/commit/ba4a26d0a84321ef8461babbd0c42bbe1fb77e81))
+
 # [1.0.0-beta.10](https://github.com/cloudinary-devs/create-cloudinary-react/compare/v1.0.0-beta.9...v1.0.0-beta.10) (2026-01-30)
 
 

package/cli.js

@@ -7,6 +7,7 @@ import { execSync } from 'child_process';
 import inquirer from 'inquirer';
 import chalk from 'chalk';
 import fs from 'fs-extra';
+import { parseArgs } from 'node:util';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
@@ -24,94 +25,140 @@ function isValidProjectName(name) {
 }
 
 async function main() {
-  console.log(chalk.cyan.bold('\n🚀 Cloudinary React + Vite Boilerplate\n'));
-  console.log(chalk.gray('💡 Need a Cloudinary account? Sign up for free: https://cloudinary.com/users/register/free\n'));
+  
+  let answers = {};
+  
+  if (process.argv.includes('--headless')) {
 
-  const answers = await inquirer.prompt([
-    {
-      type: 'input',
-      name: 'projectName',
-      message: 'Project name:',
-      default: 'my-cloudinary-app',
-      validate: (input) => {
-        if (!input.trim()) {
-          return 'Project name cannot be empty';
+    const { values, positionals } = parseArgs({
+      options: {
+        headless: {
+          type: 'boolean'
+        },
+        projectName: {
+          type: 'string',
+          default: 'my-cloudinary-app'
+        },
+        cloudName: {
+          type: 'string'
+        },
+        hasUploadPreset: {
+          type: 'boolean',
+          default: false
+        },
+        uploadPreset: {
+          type: 'string'
+        },
+        aiTools: {
+          type: 'string',
+          multiple: true,
+          default: ['cursor']
+        },
+        installDeps: {
+          type: 'boolean',
+          default: true
+        },
+        startDev: {
+          type: 'boolean',
+          default: false
         }
-        if (!isValidProjectName(input)) {
-          return 'Project name can only contain letters, numbers, hyphens, and underscores';
-        }
-        if (existsSync(input)) {
-          return `Directory "${input}" already exists. Please choose a different name.`;
-        }
-        return true;
+      }
+    });
+    
+    Object.assign(answers, values);
+    
+  } else {
+  
+    console.log(chalk.cyan.bold('\n🚀 Cloudinary React + Vite Boilerplate\n'));
+    console.log(chalk.gray('💡 Need a Cloudinary account? Sign up for free: https://cloudinary.com/users/register/free\n'));
+  
+    answers = await inquirer.prompt([
+      {
+        type: 'input',
+        name: 'projectName',
+        message: 'What’s your project’s name?\n',
+        default: 'my-cloudinary-app',
+        validate: (input) => {
+          if (!input.trim()) {
+            return 'Project name cannot be empty';
+          }
+          if (!isValidProjectName(input)) {
+            return 'Project name can only contain letters, numbers, hyphens, and underscores';
+          }
+          if (existsSync(input)) {
+            return `Directory "${input}" already exists. Please choose a different name.`;
+          }
+          return true;
+        },
       },
-    },
-    {
-      type: 'input',
-      name: 'cloudName',
-      message:
-        'Cloudinary Cloud Name:\n' +
-        chalk.gray('Dashboard: https://console.cloudinary.com/app/home/dashboard'),
-      validate: (input) => {
-        if (!input.trim()) {
-          return chalk.yellow(
-            'Cloud name is required.\n' +
-            '  → Sign up: https://cloudinary.com/users/register/free\n' +
-            '  → Find your cloud name: https://console.cloudinary.com/app/home/dashboard'
-          );
-        }
-        if (!isValidCloudName(input)) {
-          return 'Cloud name can only contain lowercase letters, numbers, hyphens, and underscores';
-        }
-        return true;
+      {
+        type: 'input',
+        name: 'cloudName',
+        message:
+          'What’s your Cloudinary cloud name?\n' +
+          chalk.gray(' → Find your cloud name: https://console.cloudinary.com/app/home/dashboard') + '\n',
+        validate: (input) => {
+          if (!input.trim()) {
+            return chalk.yellow(
+              'Cloud name is required.\n' +
+              ' → Sign up: https://cloudinary.com/users/register/free\n' +
+              ' → Find your cloud name: https://console.cloudinary.com/app/home/dashboard'
+            );
+          }
+          if (!isValidCloudName(input)) {
+            return 'Cloud name can only contain lowercase letters, numbers, hyphens, and underscores';
+          }
+          return true;
+        },
       },
-    },
-    {
-      type: 'confirm',
-      name: 'hasUploadPreset',
-      message:
-        'Do you have an unsigned upload preset? (Required for uploads, optional for transformations)\n' +
-        chalk.gray('Create one: https://console.cloudinary.com/app/settings/upload/presets'),
-      default: false,
-    },
-    {
-      type: 'input',
-      name: 'uploadPreset',
-      message: 'Upload Preset Name:',
-      when: (answers) => answers.hasUploadPreset,
-      validate: (input) => {
-        if (!input.trim()) {
-          return 'Upload preset name cannot be empty';
-        }
-        return true;
+      {
+        type: 'confirm',
+        name: 'hasUploadPreset',
+        message:
+          'Do you have an unsigned upload preset?\n' +
+          chalk.gray(' → You’ll need one if you want to upload new images to Cloudinary,\n   but not if you only want to transform or deliver existing images.') + '\n' +
+          chalk.gray(' → Create one here: https://console.cloudinary.com/app/settings/upload/presets') + '\n',
+        default: false,
+      },
+      {
+        type: 'input',
+        name: 'uploadPreset',
+        message: 'What’s your unsigned upload preset’s name?\n',
+        when: (answers) => answers.hasUploadPreset,
+        validate: (input) => {
+          if (!input.trim()) {
+            return 'Upload preset name cannot be empty';
+          }
+          return true;
+        },
+      },
+      {
+        type: 'checkbox',
+        name: 'aiTools',
+        message: 'Which AI coding assistant(s) are you using? (Select all that apply)',
+        choices: [
+          { name: 'Cursor', value: 'cursor' },
+          { name: 'GitHub Copilot', value: 'copilot' },
+          { name: 'Claude Code / Claude Desktop', value: 'claude' },
+          { name: 'Other / Generic AI tools', value: 'generic' },
+        ],
+        default: ['cursor'],
       },
-    },
-    {
-      type: 'checkbox',
-      name: 'aiTools',
-      message: 'Which AI coding assistant(s) are you using? (Select all that apply)',
-      choices: [
-        { name: 'Cursor', value: 'cursor' },
-        { name: 'GitHub Copilot', value: 'copilot' },
-        { name: 'Claude Code / Claude Desktop', value: 'claude' },
-        { name: 'Other / Generic AI tools', value: 'generic' },
-      ],
-      default: ['cursor'],
-    },
-    {
-      type: 'confirm',
-      name: 'installDeps',
-      message: 'Install dependencies now?',
-      default: true,
-    },
-    {
-      type: 'confirm',
-      name: 'startDev',
-      message: 'Start development server?',
-      default: false,
-      when: (answers) => answers.installDeps,
-    },
-  ]);
+      {
+        type: 'confirm',
+        name: 'installDeps',
+        message: 'Install dependencies now?\n',
+        default: true,
+      },
+      {
+        type: 'confirm',
+        name: 'startDev',
+        message: 'Start development server?\n',
+        default: false,
+        when: (answers) => answers.installDeps,
+      },
+    ]);
+  }
 
   const { projectName, cloudName, uploadPreset, aiTools, installDeps, startDev } = answers;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-cloudinary-react",
-  "version": "1.0.0-beta.10",
+  "version": "1.0.0-beta.12",
   "description": "Scaffold a Cloudinary React + Vite + TypeScript project with interactive setup",
   "type": "module",
   "bin": {

package/templates/.cursorrules.template

@@ -284,7 +284,7 @@ cld.image('id').overlay(
 - Client: Widget gets `api_key` (from your backend), `uploadPreset`, and an `uploadSignature` **function** that calls your backend for each upload. API secret stays on server only.
 - Trade-off: Requires a backend (Node/Express, Next.js API route, etc.) to sign requests. More secure; signature validates each upload.
 
-**Rule of thumb**: If the user asks for "secure" or "signed" uploads, or needs to restrict uploads, use **signed** with a backend. For simple demos or when preset exposure is acceptable, **unsigned** is fine.
+**Rule of thumb**: **Default to unsigned uploads** unless the user explicitly asks for "secure" or "signed" uploads. Do not default to signed — it requires a running backend and will fail out of the box. Use **signed** only when the user explicitly requests secure/signed uploads or needs to restrict who can upload.
 
 ## Secure (Signed) Uploads
 
@@ -818,6 +818,7 @@ When something isn't working, check:
 - [ ] **"createUploadWidget is not a function"?** → Wait until `typeof window.cloudinary?.createUploadWidget === 'function'` before calling it (script loads async; poll or use script onload)
 - [ ] **Video player?** → **Imperative element only**: createElement('video'), append to container ref, pass to videoPlayer(el, ...); player.source({ publicId }); cleanup: dispose then if (el.parentNode) el.parentNode.removeChild(el). CSS: cloudinary-video-player/cld-video-player.min.css. If init fails, fall back to AdvancedVideo (do not relax CSP).
 - [ ] **Upload fails (unsigned)?** → Is `VITE_CLOUDINARY_UPLOAD_PRESET` set? Preset exists and is Unsigned in dashboard?
+- [ ] **Upload default?** → Default to **unsigned** uploads (cloudName + uploadPreset); use signed only when the user explicitly asks for secure/signed uploads (signed requires a running backend)
 - [ ] **Secure uploads?** → Use `uploadSignature` as function (not `signatureEndpoint`); fetch `api_key` from server first; include `uploadPreset` in widget config; server includes `upload_preset` in signed params; use Cloudinary Node SDK v2 on server; never expose or commit API secret
 - [ ] **Where do API key/secret go?** → **Do not** put in root `.env`. Use **`server/.env`**; add to `.gitignore`; load only in server. **Never commit** API key or secret
 - [ ] Upload preset is unsigned (for simple client uploads)