@majordigital/create-acorn 1.1.5 → 1.2.1

package/README.md

@@ -10,7 +10,19 @@ It eliminates the repetitive setup that comes with every new project — framewo
 npx @majordigital/create-acorn@latest
 ```
 
-The CLI walks you through selecting a headless CMS and scaffolds a complete, opinionated project in seconds.
+> **Note:** Always use `npx` to run the CLI. Do not use `npm install` — this is a scaffolding tool, not a library dependency.
+
+The CLI prompts you for a project name, creates the directory, then walks you through selecting a headless CMS — scaffolding a complete, opinionated project in seconds.
+
+```
+? What is the name of your project? (my-acorn-app)
+? Which headless CMS would you like to use?
+  1) Prismic
+  2) Storyblok
+  3) Dato
+```
+
+The project name is also used as the default CMS space/repository name.
 
 ## What's Inside
 
@@ -55,9 +67,9 @@ src/
 For CI pipelines or scripted setups:
 
 ```bash
-npx @majordigital/create-acorn@latest --cms prismic --repo my-repo
-npx @majordigital/create-acorn@latest --cms storyblok
-npx @majordigital/create-acorn@latest --cms dato
+npx @majordigital/create-acorn@latest --name my-project --cms prismic --repo my-repo
+npx @majordigital/create-acorn@latest --name my-project --cms storyblok
+npx @majordigital/create-acorn@latest --name my-project --cms dato
 ```
 
 ## Generated Project Files

package/bin/create-acorn.mjs

@@ -4,7 +4,7 @@ import readline from 'node:readline';
 import { argv, exit } from 'node:process';
 import { spawn } from 'node:child_process';
 import { basename, join, dirname } from 'node:path';
-import { readFileSync, writeFileSync, cpSync, rmSync } from 'node:fs';
+import { readFileSync, writeFileSync, cpSync, rmSync, mkdirSync, existsSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
 
 const CMS_CHOICES = [
@@ -142,14 +142,9 @@ async function scaffoldNextApp() {
   console.log('');
 }
 
-async function setupPrismic() {
+async function setupPrismic(projectName) {
   const nonInteractiveRepo = parseFlag('repo');
-  const cwdName = basename(process.cwd())
-    .toLowerCase()
-    .replace(/[^a-z0-9-]/g, '-')
-    .replace(/-{2,}/g, '-')
-    .replace(/^-+|-+$/g, '');
-  const defaultBase = cwdName && cwdName !== 'acorn' ? cwdName : 'acorn';
+  const defaultBase = projectName && projectName !== 'acorn' ? projectName : 'acorn';
   const prefixed = defaultBase.startsWith('majordigital-') ? defaultBase : `majordigital-${defaultBase}`;
   const suggested = nonInteractiveRepo || prefixed;
 
@@ -352,6 +347,26 @@ The primary contact for this project is [Davs Howard](mailto:davs@majordigital.c
 
 async function main() {
   printHeader();
+
+  // Prompt for project name first
+  const nameFromFlag = parseFlag('name');
+  let projectDir = nameFromFlag;
+  if (!projectDir) {
+    projectDir = await ask('What is the name of your project?', 'my-acorn-app');
+  }
+
+  // Sanitise to a valid directory name
+  projectDir = projectDir
+    .toLowerCase()
+    .replace(/[^a-z0-9-]/g, '-')
+    .replace(/-{2,}/g, '-')
+    .replace(/^-+|-+$/g, '');
+
+  if (!projectDir) {
+    console.error('Invalid project name.');
+    exit(1);
+  }
+
   let selection = parseNonInteractiveArg();
   if (!selection) {
     selection = await promptInteractive();
@@ -366,11 +381,23 @@ async function main() {
   console.log(`You selected: ${selection.label}`);
   console.log('');
 
+  console.log(`- Project: ${projectDir}`);
   console.log('- Framework: Next.js 15');
   console.log('- UI base: Acorn components');
   console.log(`- CMS: ${selection.label}`);
   console.log('');
 
+  // Create project directory and work inside it
+  const targetDir = join(process.cwd(), projectDir);
+  if (existsSync(targetDir)) {
+    console.error(`Directory "${projectDir}" already exists. Please choose a different name or remove it.`);
+    exit(1);
+  }
+  mkdirSync(targetDir, { recursive: true });
+  process.chdir(targetDir);
+  console.log(`Created directory: ${projectDir}`);
+  console.log('');
+
   await scaffoldNextApp();
 
   // Generate .env.example and README before CMS setup (CMS setup may block if user starts Slice Machine)
@@ -397,14 +424,13 @@ SITE_URL=
   writeFileSync(join(process.cwd(), '.env.example'), envExamples[selection.key]);
   console.log('.env.example generated.');
 
-  const projectName = basename(process.cwd());
-  const readme = generateReadme(projectName, selection.key);
+  const readme = generateReadme(projectDir, selection.key);
   writeFileSync(join(process.cwd(), 'README.md'), readme);
   console.log('README.md generated.');
   console.log('');
 
   if (selection.key === 'prismic') {
-    await setupPrismic();
+    await setupPrismic(projectDir);
   } else {
     console.log(`CMS preset ${selection.label} scaffolding is coming next.`);
     console.log('This run only confirms selection for non-Prismic options.');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@majordigital/create-acorn",
-  "version": "1.1.5",
+  "version": "1.2.1",
   "description": "Interactive scaffold for Acorn with Storyblok/Prismic/DatoCMS, TypeScript, and Tailwind.",
   "bin": {
     "create-acorn": "bin/create-acorn.mjs",