next2point0 1.1.0

package/bin/index.js

@@ -0,0 +1,221 @@
+#!/usr/bin/env node
+
+const { execSync, spawnSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+const readline = require('readline');
+
+const REPO_URL = 'https://github.com/ahmad2point0/next2point0';
+const pkg = require('../package.json');
+
+const c = {
+  reset: '\x1b[0m',
+  bold: '\x1b[1m',
+  dim: '\x1b[2m',
+  red: '\x1b[31m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  cyan: '\x1b[36m',
+};
+const supportsColor = process.stdout.isTTY && process.env.TERM !== 'dumb' && !process.env.NO_COLOR;
+const paint = (color, s) => (supportsColor ? `${c[color]}${s}${c.reset}` : s);
+
+const TEMPLATES = {
+  frontend: { branch: 'main', label: 'Frontend' },
+  fullstack: { branch: 'feat/backend', label: 'Frontend + Backend' },
+};
+
+function parseArgs(argv) {
+  const args = { _: [], flags: {} };
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === '-h' || a === '--help') args.flags.help = true;
+    else if (a === '-v' || a === '--version') args.flags.version = true;
+    else if (a === '-t' || a === '--template') args.flags.template = argv[++i];
+    else if (a === '--pm' || a === '--package-manager') args.flags.pm = argv[++i];
+    else if (a === '--skip-install') args.flags.skipInstall = true;
+    else if (a === '--skip-git') args.flags.skipGit = true;
+    else if (a === '-y' || a === '--yes') args.flags.yes = true;
+    else if (a.startsWith('-')) {
+      console.error(paint('red', `Unknown flag: ${a}`));
+      process.exit(1);
+    } else args._.push(a);
+  }
+  return args;
+}
+
+function printHelp() {
+  console.log(`
+${paint('bold', 'next2point0')} ${paint('dim', `v${pkg.version}`)}
+${paint('dim', pkg.description)}
+
+${paint('bold', 'Usage:')}
+  npx next2point0 <project-name> [options]
+
+${paint('bold', 'Options:')}
+  -t, --template <name>   Template: frontend | fullstack
+      --pm <name>         Package manager: bun | pnpm | npm | yarn
+      --skip-install      Don't install dependencies
+      --skip-git          Don't init a new git repository
+  -y, --yes               Accept defaults (template: frontend)
+  -h, --help              Show this help
+  -v, --version           Show version
+
+${paint('bold', 'Examples:')}
+  npx next2point0 my-app
+  npx next2point0 my-app -t fullstack --pm pnpm
+  npx next2point0 my-app -y
+`);
+}
+
+function ask(query) {
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise((resolve) => rl.question(query, (a) => { rl.close(); resolve(a); }));
+}
+
+function validateProjectName(name) {
+  if (!name || !name.trim()) return 'Project name cannot be empty.';
+  if (name.length > 214) return 'Project name is too long (max 214).';
+  if (/[A-Z]/.test(name)) return 'Project name must be lowercase.';
+  if (/^[._]/.test(name)) return 'Project name cannot start with "." or "_".';
+  if (/[\s~)('!*]/.test(name)) return 'Project name contains invalid characters.';
+  if (!/^[a-z0-9][a-z0-9\-_.]*$/.test(name)) return 'Project name has invalid characters.';
+  return null;
+}
+
+function detectPackageManager(preferred) {
+  const order = preferred ? [preferred, 'bun', 'pnpm', 'npm', 'yarn'] : ['bun', 'pnpm', 'npm', 'yarn'];
+  for (const pm of order) {
+    const r = spawnSync(pm, ['--version'], { stdio: 'ignore', shell: process.platform === 'win32' });
+    if (r.status === 0) return pm;
+  }
+  return null;
+}
+
+function checkGitAvailable() {
+  const r = spawnSync('git', ['--version'], { stdio: 'ignore', shell: process.platform === 'win32' });
+  return r.status === 0;
+}
+
+async function main() {
+  const args = parseArgs(process.argv.slice(2));
+
+  if (args.flags.help) return printHelp();
+  if (args.flags.version) return console.log(pkg.version);
+
+  console.log(paint('cyan', paint('bold', '\n  ▲ next2point0')) + paint('dim', `  v${pkg.version}\n`));
+
+  if (!checkGitAvailable()) {
+    console.error(paint('red', '✖ git is required but was not found in PATH.'));
+    process.exit(1);
+  }
+
+  let projectName = args._[0];
+  if (!projectName) {
+    projectName = (await ask(paint('bold', '? ') + 'Project name: ')).trim();
+  }
+  const nameError = validateProjectName(projectName);
+  if (nameError) {
+    console.error(paint('red', `✖ ${nameError}`));
+    process.exit(1);
+  }
+
+  const targetDir = path.resolve(process.cwd(), projectName);
+  if (fs.existsSync(targetDir)) {
+    const entries = fs.readdirSync(targetDir);
+    if (entries.length > 0) {
+      console.error(paint('red', `✖ Directory "${projectName}" already exists and is not empty.`));
+      process.exit(1);
+    }
+  }
+
+  let templateKey = args.flags.template;
+  if (!templateKey && args.flags.yes) templateKey = 'frontend';
+  if (!templateKey) {
+    console.log('\n' + paint('bold', 'Select a template:'));
+    console.log(`  ${paint('cyan', '1')}) Frontend           ${paint('dim', '(Next.js)')}`);
+    console.log(`  ${paint('cyan', '2')}) Frontend + Backend ${paint('dim', '(Next.js + API)')}`);
+    const choice = (await ask('\n' + paint('bold', '? ') + 'Choice (1 or 2) [1]: ')).trim() || '1';
+    templateKey = choice === '2' ? 'fullstack' : 'frontend';
+  }
+  if (!TEMPLATES[templateKey]) {
+    console.error(paint('red', `✖ Unknown template "${templateKey}". Use: frontend | fullstack`));
+    process.exit(1);
+  }
+  const template = TEMPLATES[templateKey];
+
+  let pm = args.flags.pm;
+  if (!pm) {
+    pm = detectPackageManager() || 'npm';
+  } else {
+    const available = detectPackageManager(pm);
+    if (available !== pm) {
+      console.error(paint('yellow', `⚠ "${pm}" not found, falling back to ${available || 'npm'}.`));
+      pm = available || 'npm';
+    }
+  }
+
+  console.log('\n' + paint('cyan', '◐') + ` Downloading ${paint('bold', template.label)} template…`);
+  try {
+    execSync(
+      `git clone --depth=1 --branch ${template.branch} --single-branch ${REPO_URL} "${targetDir}"`,
+      { stdio: 'ignore' }
+    );
+  } catch (e) {
+    console.error(paint('red', '✖ Failed to clone template. Check your internet connection.'));
+    process.exit(1);
+  }
+  console.log(paint('green', '✔') + ' Template downloaded.');
+
+  process.chdir(targetDir);
+  fs.rmSync(path.join(targetDir, '.git'), { recursive: true, force: true });
+
+  const projectPkgPath = path.join(targetDir, 'package.json');
+  if (fs.existsSync(projectPkgPath)) {
+    try {
+      const projectPkg = JSON.parse(fs.readFileSync(projectPkgPath, 'utf8'));
+      projectPkg.name = projectName;
+      projectPkg.version = '0.1.0';
+      fs.writeFileSync(projectPkgPath, JSON.stringify(projectPkg, null, 2) + '\n');
+    } catch {
+      console.warn(paint('yellow', '⚠ Could not update template package.json name.'));
+    }
+  }
+
+  if (!args.flags.skipInstall) {
+    console.log(paint('cyan', '◐') + ` Installing dependencies with ${paint('bold', pm)}…`);
+    const install = spawnSync(pm, ['install'], { stdio: 'inherit', shell: process.platform === 'win32' });
+    if (install.status !== 0) {
+      console.error(paint('yellow', `⚠ ${pm} install failed. You can re-run it manually.`));
+    } else {
+      console.log(paint('green', '✔') + ' Dependencies installed.');
+    }
+  }
+
+  if (!args.flags.skipGit) {
+    try {
+      execSync('git init', { stdio: 'ignore' });
+      execSync('git add -A', { stdio: 'ignore' });
+      execSync('git commit -m "chore: initial commit from next2point0"', { stdio: 'ignore' });
+      console.log(paint('green', '✔') + ' Initialized fresh git repository.');
+    } catch {
+      // git user.name/email may not be configured — non-fatal
+    }
+  }
+
+  const runCmd = `${pm} run dev`;
+  console.log(`
+${paint('green', paint('bold', '✔ All set!'))}
+
+  ${paint('dim', 'Next steps:')}
+    ${paint('cyan', `cd ${projectName}`)}${args.flags.skipInstall ? `\n    ${paint('cyan', `${pm} install`)}` : ''}
+    ${paint('cyan', runCmd)}
+
+  ${paint('dim', 'Docs:')} ${REPO_URL}
+`);
+}
+
+main().catch((err) => {
+  console.error(paint('red', '\n✖ Unexpected error:'), err && err.message ? err.message : err);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "next2point0",
+  "version": "1.1.0",
+  "description": "Modern Next.js starter template featuring a scalable, feature-based architecture for frontend and backend development.",
+  "homepage": "https://github.com/ahmad2point0/next2point0#readme",
+  "keywords": [
+    "nextjs",
+    "next",
+    "react",
+    "template",
+    "boilerplate",
+    "starter",
+    "tailwindcss",
+    "fullstack",
+    "scaffold",
+    "cli",
+    "npx",
+    "create-next-app"
+  ],
+  "bugs": {
+    "url": "https://github.com/ahmad2point0/next2point0/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ahmad2point0/next2point0.git"
+  },
+  "license": "MIT",
+  "author": "ahmad2point0",
+  "type": "commonjs",
+  "main": "bin/index.js",
+  "bin": {
+    "next2point0": "./bin/index.js",
+    "create-next2point0": "./bin/index.js"
+  },
+  "files": [
+    "bin",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=16"
+  },
+  "preferGlobal": true,
+  "scripts": {
+    "start": "node bin/index.js",
+    "test": "echo \"No tests yet\" && exit 0"
+  }
+}