create-gasket-app 7.4.18 → 7.4.20

package/EXAMPLES.md

@@ -10,20 +10,11 @@ The main interface for `create-gasket-app` is the command line:
 # Basic app creation
 npx create-gasket-app@latest my-app
 
-# With presets
-npx create-gasket-app@latest my-app --presets @gasket/preset-nextjs
-
-# With package manager selection
-npx create-gasket-app@latest my-app --package-manager pnpm
-
-# With configuration
-npx create-gasket-app@latest my-app --config '{"typescript": true}'
+# With template (recommended)
+npx create-gasket-app@latest my-app --template @gasket/template-nextjs-pages
 
-# With config file
-npx create-gasket-app@latest my-app --config-file ./create-config.json
-
-# Skip prompts (for CI)
-npx create-gasket-app@latest my-app --presets @gasket/preset-nextjs --no-prompts
+# With presets (deprecated; prefer --template)
+npx create-gasket-app@latest my-app --presets @gasket/preset-nextjs
 ```
 
 ## Templates

package/README.md

@@ -40,7 +40,7 @@ Arguments:
   appname                              Name of the Gasket application to create
 
 Options:
-  -p, --presets [presets]              Initial Gasket preset(s) to use.
+  -p, --presets [presets]              (Deprecated.) Initial Gasket preset(s). Prefer --template.
         Can be set as short name with version (e.g. --presets nextjs@^1.0.0)
         Or other (multiple) custom presets (e.g. --presets my-gasket-preset@1.0.0.beta-1,nextjs@^1.0.0)
   --template [template]                Selects which template you would like to use during

package/lib/commands/create.js

@@ -24,6 +24,7 @@ import linkModules from '../scaffold/actions/link-modules.js';
 import postCreateHooks from '../scaffold/actions/post-create-hooks.js';
 import printReport from '../scaffold/actions/print-report.js';
 import gitInit from '../scaffold/actions/git-init.js';
+import { warnPresetDeprecated } from '../utils/warn-preset-deprecated.js';
 
 /**
  * Parses comma separated option input to array
@@ -112,10 +113,14 @@ const createCommand = {
  * @returns {import('../internal.js').PartialCreateContext} Validated context
  */
 function validateOptions(context) {
-  const hasOption = (context) => Boolean(context.template || context.templatePath || context.rawPresets.length || context.localPresets.length);
+  const hasOption = (ctx) =>
+    Boolean(ctx.template || ctx.templatePath || ctx.rawPresets?.length || ctx.localPresets?.length);
 
   if (!hasOption(context)) {
-    console.warn('Warning: At least one of the options is required: --template, --template-path, --presets, --preset-path');
+    console.warn(
+      'Warning: At least one option is required: --template (preferred), --template-path, ' +
+        '--presets (deprecated), or --preset-path (deprecated).'
+    );
     process.exit(1);
   }
 
@@ -196,6 +201,7 @@ createCommand.action = async function run(appname, options, command) {
   process.env.GASKET_ENV = 'create';
   const context = makeCreateContext([appname], options);
   validateOptions(context);
+  warnPresetDeprecated(context);
 
   try {
     await handleCreate(context);

package/lib/utils/warn-preset-deprecated.js

@@ -0,0 +1,55 @@
+import chalk from 'chalk';
+
+const PRESET_TO_TEMPLATES = {
+  nextjs: ['@gasket/template-nextjs-pages', '@gasket/template-nextjs-express', '@gasket/template-nextjs-app'],
+  api: ['@gasket/template-api-express', '@gasket/template-api-fastify']
+};
+
+/**
+ * Derive template suggestions from raw preset names (e.g. nextjs, @gasket/preset-nextjs).
+ * @param {string[]} rawPresets - Raw preset specifiers from CLI (e.g. nextjs@^1.0.0).
+ * @returns {string[]} template package names to suggest
+ */
+function suggestTemplates(rawPresets) {
+  const seen = new Set();
+  const suggestions = [];
+  for (const raw of rawPresets) {
+    const name = raw.replace(/@[\^~]?[\d.]*(-.*)?$/, '').trim().toLowerCase();
+    let base = null;
+    if (name.includes('nextjs')) base = 'nextjs';
+    else if (name.includes('api')) base = 'api';
+    if (base && PRESET_TO_TEMPLATES[base]) {
+      for (const t of PRESET_TO_TEMPLATES[base]) {
+        if (!seen.has(t)) {
+          seen.add(t);
+          suggestions.push(t);
+        }
+      }
+    }
+  }
+  return suggestions;
+}
+
+/**
+ * Print deprecation warning when user passes --presets or --preset-path.
+ * @param {import('../internal.js').PartialCreateContext} context - Create context with rawPresets/localPresets.
+ */
+export function warnPresetDeprecated(context) {
+  if (!context.rawPresets?.length && !context.localPresets?.length) return;
+
+  const suggestions = suggestTemplates(context.rawPresets || []);
+  const lines = [
+    chalk.yellow.bold('*** Presets are deprecated. Use templates instead. ***'),
+    '',
+    '  Presets (--presets / --preset-path) will be removed in a future version.',
+    '  Templates provide a complete app and are the recommended way to create Gasket apps.',
+    ''
+  ];
+  if (suggestions.length) {
+    lines.push('  Suggested templates:');
+    suggestions.forEach(t => lines.push(`    --template ${t}`));
+    lines.push('');
+  }
+  lines.push('  See: https://gasket.dev/docs/create-gasket-app/#templates');
+  console.warn(lines.join('\n'));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-gasket-app",
-  "version": "7.4.18",
+  "version": "7.4.20",
   "description": "starter pack for creating a gasket app",
   "type": "module",
   "bin": {
@@ -32,16 +32,16 @@
     "mkdirp": "^1.0.4",
     "ora": "^3.4.0",
     "semver": "^7.7.1",
-    "@gasket/plugin-command": "^7.6.3",
-    "@gasket/plugin-docs": "^7.5.3",
-    "@gasket/plugin-docusaurus": "^7.5.0",
-    "@gasket/plugin-dynamic-plugins": "^7.5.0",
-    "@gasket/plugin-git": "^7.4.8",
+    "@gasket/core": "^7.7.3",
+    "@gasket/plugin-command": "^7.6.4",
+    "@gasket/plugin-docs": "^7.5.4",
+    "@gasket/plugin-docusaurus": "^7.5.1",
+    "@gasket/plugin-dynamic-plugins": "^7.5.1",
+    "@gasket/plugin-git": "^7.4.9",
     "@gasket/plugin-logger": "^7.4.0",
-    "@gasket/plugin-metadata": "^7.5.8",
+    "@gasket/plugin-metadata": "^7.5.9",
     "@gasket/request": "^7.5.5",
-    "@gasket/utils": "^7.6.4",
-    "@gasket/core": "^7.7.2"
+    "@gasket/utils": "^7.6.5"
   },
   "devDependencies": {
     "@typescript-eslint/parser": "^8.38.0",