create-nexora-next 0.3.6 → 0.4.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-nexora-next",
-  "version": "0.3.6",
+  "version": "0.4.7",
   "description": "The official Next.js scaffolding CLI by Rayan — batteries included.",
   "type": "module",
   "bin": {

package/src/index.js

@@ -4,24 +4,23 @@ import pc from 'picocolors'
 import path from 'path'
 import { existsSync } from 'fs'
 import { createRequire } from 'module'
+import { parseArgs, hasAnyFlag, printHelp } from './utils/args.js'
 
 const require = createRequire(import.meta.url)
 const { version } = require('../package.json')
 
-import { stepCreateNextApp }  from './steps/01-create-next-app.js'
-import { stepSetupShadcn }    from './steps/02-shadcn.js'
-import { stepWriteBaseFiles } from './steps/03-base-files.js'
-import { stepWriteProviders } from './steps/04-providers.js'
-import { stepSetupI18n }      from './steps/05-i18n.js'
-import { stepSetupAuth }      from './steps/06-auth.js'
-import { stepWriteProxy }     from './steps/07-proxy.js'
-import { stepInstallDeps }    from './steps/08-install-deps.js'
-import { stepSetupHusky }     from './steps/09-husky.js'
-import { stepSetupAxios }     from './steps/10-axios.js'
+import { stepCreateNextApp }   from './steps/01-create-next-app.js'
+import { stepSetupShadcn }     from './steps/02-shadcn.js'
+import { stepWriteBaseFiles }  from './steps/03-base-files.js'
+import { stepWriteProviders }  from './steps/04-providers.js'
+import { stepSetupI18n }       from './steps/05-i18n.js'
+import { stepSetupAuth }       from './steps/06-auth.js'
+import { stepWriteProxy }      from './steps/07-proxy.js'
+import { stepInstallDeps }     from './steps/08-install-deps.js'
+import { stepSetupHusky }      from './steps/09-husky.js'
+import { stepSetupAxios }      from './steps/10-axios.js'
 import { stepPatchPackageJson } from './steps/11-patch-pkg.js'
 
-// ─── Helpers ──────────────────────────────────────────────────────────────────
-
 function bail(msg) {
   p.cancel(pc.red(msg))
   process.exit(1)
@@ -35,8 +34,6 @@ function section(title) {
   p.log.step(pc.bold(pc.cyan(`\n  ${title}`)))
 }
 
-// ─── Banner ───────────────────────────────────────────────────────────────────
-
 function printBanner() {
   const art = [
     '  ███╗   ██╗███████╗██╗  ██╗ ██████╗ ██████╗  █████╗ ',
@@ -46,9 +43,7 @@ function printBanner() {
     '  ██║ ╚████║███████╗██╔╝ ██╗╚██████╔╝██║  ██║██║  ██║',
     '  ╚═╝  ╚═══╝╚══════╝╚═╝  ╚═╝ ╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═╝',
   ]
-  // Fade from cyan → blue top to bottom
   const gradient = [pc.cyan, pc.cyan, pc.cyan, pc.blue, pc.blue, pc.blue]
-
   console.log()
   art.forEach((line, i) => console.log(pc.bold(gradient[i](line))))
   console.log()
@@ -56,8 +51,7 @@ function printBanner() {
   const centre = (str) => {
     const pad = W - str.length
     const l = Math.floor(pad / 2)
-    const r = pad - l
-    return ' '.repeat(l) + str + ' '.repeat(r)
+    return ' '.repeat(l) + str + ' '.repeat(pad - l)
   }
   const bar = '═'.repeat(W)
   console.log(pc.bold(pc.cyan(
@@ -69,8 +63,6 @@ function printBanner() {
   console.log()
 }
 
-// ─── Summary ──────────────────────────────────────────────────────────────────
-
 function printSummary(opts, projectName, pm) {
   const yes  = pc.green('✓')
   const skip = pc.dim('–')
@@ -103,103 +95,97 @@ function printSummary(opts, projectName, pm) {
   console.log()
 }
 
-// ─── Main ─────────────────────────────────────────────────────────────────────
+async function ask(condition, prompt) {
+  if (condition !== null) return condition
+  const val = await prompt()
+  if (p.isCancel(val)) onCancel()
+  return Boolean(val)
+}
 
 async function main() {
+  const parsed = parseArgs(process.argv)
+
   printBanner()
-  p.intro(pc.bgCyan(pc.black(" create-nexora-next ")))
 
-  // ── Phase 1: Identity ──────────────────────────────────────────────────────
+  if (parsed.version) {
+    console.log(`  v${version}`)
+    process.exit(0)
+  }
+
+  if (parsed.help) {
+    printHelp(version)
+    process.exit(0)
+  }
+
+  p.intro(pc.bgCyan(pc.black(' create-nexora-next ')))
+
+  const flagMode = hasAnyFlag(parsed)
+
+  if (flagMode) {
+    p.log.info(pc.dim('  Running in flag mode — skipping answered prompts'))
+    console.log()
+  }
+
   section('Phase 1 — Project identity')
 
-  const projectName = await p.text({
-    message: 'What is your project name?',
-    placeholder: 'my-app',
-    validate: (v) => {
-      if (!v || !v.trim()) return 'Project name is required.'
-      if (!/^[a-z0-9-_]+$/.test(v.trim()))
-        return 'Use lowercase letters, numbers, hyphens or underscores only.'
-    },
-  })
-  if (p.isCancel(projectName)) onCancel()
-  const name = projectName.trim()
+  let name = parsed.name
+  if (!name) {
+    const res = await p.text({
+      message: 'What is your project name?',
+      placeholder: 'my-app',
+      validate: (v) => {
+        if (!v || !v.trim()) return 'Project name is required.'
+        if (!/^[a-z0-9-_]+$/.test(v.trim()))
+          return 'Use lowercase letters, numbers, hyphens or underscores only.'
+      },
+    })
+    if (p.isCancel(res)) onCancel()
+    name = res.trim()
+  } else {
+    p.log.step(`Project name: ${pc.cyan(name)}`)
+  }
 
   const targetDir = path.resolve(process.cwd(), name)
-  if (existsSync(targetDir)) {
-    bail(`Directory "${name}" already exists. Choose a different name.`)
+  if (existsSync(targetDir)) bail(`Directory "${name}" already exists.`)
+
+  let pm = parsed.pm
+  if (!pm) {
+    const res = await p.select({
+      message: 'Which package manager?',
+      options: [
+        { value: 'pnpm', label: 'pnpm', hint: 'recommended' },
+        { value: 'bun',  label: 'bun',  hint: 'fastest'     },
+        { value: 'npm',  label: 'npm',  hint: 'classic'     },
+        { value: 'yarn', label: 'yarn', hint: 'classic alt'  },
+      ],
+    })
+    if (p.isCancel(res)) onCancel()
+    pm = res
+  } else {
+    p.log.step(`Package manager: ${pc.cyan(pm)}`)
   }
 
-  const pm = await p.select({
-    message: 'Which package manager?',
-    options: [
-      { value: 'pnpm', label: 'pnpm', hint: 'recommended' },
-      { value: 'bun',  label: 'bun',  hint: 'fastest'     },
-      { value: 'npm',  label: 'npm',  hint: 'classic'     },
-      { value: 'yarn', label: 'yarn', hint: 'classic alt'  },
-    ],
-  })
-  if (p.isCancel(pm)) onCancel()
-
-  // ── Phase 2: Feature flags ─────────────────────────────────────────────────
   section('Phase 2 — Features')
 
-  const i18n = await p.confirm({
-    message: 'Set up localization? (next-intl)',
-    initialValue: false,
-  })
-  if (p.isCancel(i18n)) onCancel()
-
-  const query = await p.confirm({
-    message: 'Set up TanStack Query + local persistence?',
-    initialValue: false,
-  })
-  if (p.isCancel(query)) onCancel()
-
-  const theming = await p.confirm({
-    message: 'Set up theming? (next-themes dark/light)',
-    initialValue: true,
-  })
-  if (p.isCancel(theming)) onCancel()
-
-  const animations = await p.confirm({
-    message: 'Install animation libraries? (motion + gsap)',
-    initialValue: false,
-  })
-  if (p.isCancel(animations)) onCancel()
-
-  const auth = await p.confirm({
-    message: 'Set up auth proxy + zod validators?',
-    initialValue: false,
-  })
-  if (p.isCancel(auth)) onCancel()
-
-  const axios = await p.confirm({
-    message: 'Set up axios client/server instances?',
-    initialValue: false,
-  })
-  if (p.isCancel(axios)) onCancel()
-
-  const husky = await p.confirm({
-    message: 'Configure Husky pre-commit hooks?',
-    initialValue: true,
-  })
-  if (p.isCancel(husky)) onCancel()
-
-  const reactCompiler = await p.confirm({
-    message: 'Enable React Compiler? (babel-plugin-react-compiler)',
-    initialValue: true,
-  })
-  if (p.isCancel(reactCompiler)) onCancel()
-
-  // ── Confirm ────────────────────────────────────────────────────────────────
+  const defaults = { theming: true, husky: true, reactCompiler: true }
+
+  const i18n          = await ask(parsed.i18n,          () => p.confirm({ message: 'Set up localization? (next-intl)',                     initialValue: false }))
+  const query         = await ask(parsed.query,         () => p.confirm({ message: 'Set up TanStack Query + local persistence?',           initialValue: false }))
+  const theming       = await ask(parsed.theming,       () => p.confirm({ message: 'Set up theming? (next-themes dark/light)',             initialValue: true  }))
+  const animations    = await ask(parsed.animations,    () => p.confirm({ message: 'Install animation libraries? (motion + gsap)',         initialValue: false }))
+  const auth          = await ask(parsed.auth,          () => p.confirm({ message: 'Set up auth proxy + zod validators?',                 initialValue: false }))
+  const axios         = await ask(parsed.axios,         () => p.confirm({ message: 'Set up axios client/server instances?',               initialValue: false }))
+  const husky         = await ask(parsed.husky,         () => p.confirm({ message: 'Configure Husky pre-commit hooks?',                   initialValue: true  }))
+  const reactCompiler = await ask(parsed.reactCompiler, () => p.confirm({ message: 'Enable React Compiler? (babel-plugin-react-compiler)', initialValue: true  }))
+
   const features = [
-    i18n       && 'i18n',
-    query      && 'query',
-    theming    && 'theming',
-    animations && 'animations',
-    auth       && 'auth',
-    axios      && 'axios',
-    husky      && 'husky',
+    i18n          && 'i18n',
+    query         && 'query',
+    theming       && 'theming',
+    animations    && 'animations',
+    auth          && 'auth',
+    axios         && 'axios',
+    husky         && 'husky',
     reactCompiler && 'react-compiler',
   ].filter(Boolean)
 
@@ -211,23 +197,21 @@ async function main() {
   )
   console.log()
 
-  const go = await p.confirm({
-    message: 'Ready to scaffold?',
-    initialValue: true,
-  })
-  if (p.isCancel(go) || !go) onCancel()
+  if (!parsed.yes && !flagMode) {
+    const go = await p.confirm({ message: 'Ready to scaffold?', initialValue: true })
+    if (p.isCancel(go) || !go) onCancel()
+  }
 
-  // ── Phase 3: Execution ─────────────────────────────────────────────────────
   section('Phase 3 — Building your project')
 
   const opts = {
-    i18n:       Boolean(i18n),
-    query:      Boolean(query),
-    theming:    Boolean(theming),
-    animations: Boolean(animations),
-    auth:       Boolean(auth),
-    axios:      Boolean(axios),
-    husky:      Boolean(husky),
+    i18n:          Boolean(i18n),
+    query:         Boolean(query),
+    theming:       Boolean(theming),
+    animations:    Boolean(animations),
+    auth:          Boolean(auth),
+    axios:         Boolean(axios),
+    husky:         Boolean(husky),
     reactCompiler: Boolean(reactCompiler),
   }
 
@@ -236,26 +220,17 @@ async function main() {
   await stepWriteBaseFiles(targetDir, opts)
   await stepWriteProviders(targetDir, opts)
 
-  if (opts.i18n) {
-    await stepSetupI18n(targetDir, pm, opts)
-  }
-
-  if (opts.auth || opts.i18n) {
-    await stepSetupAuth(targetDir, opts)
-  }
+  if (opts.i18n)              await stepSetupI18n(targetDir, pm, opts)
+  if (opts.auth || opts.i18n) await stepSetupAuth(targetDir, opts)
 
   await stepWriteProxy(targetDir, opts)
 
-  if (opts.axios) {
-    await stepSetupAxios(targetDir)
-  }
+  if (opts.axios) await stepSetupAxios(targetDir)
 
   await stepInstallDeps(targetDir, pm, opts)
   await stepPatchPackageJson(targetDir)
 
-  if (opts.husky) {
-    await stepSetupHusky(targetDir, pm)
-  }
+  if (opts.husky) await stepSetupHusky(targetDir, pm)
 
   printSummary(opts, name, pm)
   p.outro(pc.bgGreen(pc.black(' Done! ')))

package/src/utils/args.js

@@ -0,0 +1,119 @@
+const VALID_PMS = ['npm', 'pnpm', 'bun', 'yarn']
+
+const FLAGS = {
+  '--all':            { key: 'all' },
+  '--i18n':           { key: 'i18n' },
+  '--query':          { key: 'query' },
+  '--theming':        { key: 'theming' },
+  '--animations':     { key: 'animations' },
+  '--auth':           { key: 'auth' },
+  '--axios':          { key: 'axios' },
+  '--husky':          { key: 'husky' },
+  '--rc':             { key: 'reactCompiler' },
+  '--react-compiler': { key: 'reactCompiler' },
+  '--no-theming':     { key: 'theming',       value: false },
+  '--no-husky':       { key: 'husky',         value: false },
+  '--no-rc':          { key: 'reactCompiler', value: false },
+  '--pm':             { key: 'pm',            takesValue: true },
+  '-y':               { key: 'yes' },
+  '--yes':            { key: 'yes' },
+  '--help':           { key: 'help' },
+  '-h':               { key: 'help' },
+  '--version':        { key: 'version' },
+  '-v':               { key: 'version' },
+}
+
+export function parseArgs(argv) {
+  const args = argv.slice(2)
+  const result = {
+    name:          null,
+    pm:            null,
+    yes:           false,
+    help:          false,
+    version:       false,
+    all:           false,
+    i18n:          null,
+    query:         null,
+    theming:       null,
+    animations:    null,
+    auth:          null,
+    axios:         null,
+    husky:         null,
+    reactCompiler: null,
+  }
+
+  let i = 0
+  while (i < args.length) {
+    const arg = args[i]
+    const def = FLAGS[arg]
+
+    if (def) {
+      if (def.takesValue) {
+        result[def.key] = args[++i] ?? null
+      } else if (def.value === false) {
+        result[def.key] = false
+      } else {
+        result[def.key] = true
+      }
+    } else if (!arg.startsWith('-') && !result.name) {
+      result.name = arg
+    }
+    i++
+  }
+
+  if (result.all) {
+    for (const key of ['i18n','query','theming','animations','auth','axios','husky','reactCompiler']) {
+      if (result[key] === null) result[key] = true
+    }
+  }
+
+  if (result.pm && !VALID_PMS.includes(result.pm)) {
+    result.pm = null
+  }
+
+  return result
+}
+
+export function hasAnyFlag(parsed) {
+  return (
+    parsed.yes ||
+    parsed.all ||
+    parsed.name !== null ||
+    parsed.pm !== null ||
+    ['i18n','query','theming','animations','auth','axios','husky','reactCompiler']
+      .some(k => parsed[k] !== null)
+  )
+}
+
+export function printHelp(version) {
+  console.log(`
+  create-nexora-next v${version}
+
+  Usage:
+    npx create-nexora-next [name] [flags]
+
+  Flags:
+    --pm <npm|pnpm|bun|yarn>   Package manager (default: prompt)
+    --all                      Enable every feature
+    --i18n                     Localization via next-intl
+    --query                    TanStack Query + persistence
+    --theming                  Theming via next-themes
+    --animations               Motion + GSAP
+    --auth                     Auth proxy + validators
+    --axios                    Axios client/server instances
+    --husky                    Husky pre-commit hooks
+    --rc / --react-compiler    React Compiler
+    --no-theming               Skip theming
+    --no-husky                 Skip Husky
+    --no-rc                    Skip React Compiler
+    -y / --yes                 Accept all defaults (no prompts)
+    -v / --version             Print version
+    -h / --help                Show this help
+
+  Examples:
+    npx create-nexora-next my-app --pm pnpm --all
+    npx create-nexora-next my-app --pm bun --i18n --query --theming
+    npx create-nexora-next my-app --pm bun --all --no-animations --no-auth
+    npx create-nexora-next my-app -y
+`)
+}