nero-init 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Roshan Singh
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,25 @@
+# nero-init
+
+<br >
+
+Minimal project scaffold for my personal workflow.
+
+Creates opinionated starter templates for:
+
+- CLI tools
+- Libraries
+- Web (coming soon)
+
+<br >
+
+## Usage
+
+```bash
+npx nero-init
+```
+
+<br >
+
+## License
+
+MIT

package/dist/index.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+import { promptUser } from './prompt.js';
+import { selectTemplate } from './templates.js';
+import { renderTemplate } from './renderer.js';
+import { postInstall } from './install.js';
+async function run() {
+    const answers = await promptUser();
+    const template = await selectTemplate(answers);
+    const render = await renderTemplate(template, answers);
+    const install = await postInstall(template, answers);
+}
+await run();

package/dist/install.js

@@ -0,0 +1,109 @@
+import { spawnSync } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+import chalk from 'chalk';
+import ora from 'ora';
+// Aesthetic gradient and box drawing characters
+// Premium muted palette (dark-terminal friendly)
+const theme = {
+    brand: '#7C7CFF', // Soft indigo (hero color)
+    accent: '#22D3EE', // Subtle cyan highlight
+    success: '#34D399', // Mint green
+    warning: '#FBBF24', // Amber (real warning color now 😄)
+    error: '#F87171', // Soft red
+    text: '#E5E7EB', // Light gray
+    muted: '#9CA3AF', // Muted gray
+    border: '#374151', // Slate border
+};
+const symbols = {
+    success: '✔',
+    warning: '!',
+    error: '×',
+    info: '•',
+    arrow: '›',
+    corner: '└─',
+    pipe: '│ ',
+    branch: '├─',
+};
+export async function postInstall(template, answers) {
+    const projectDir = path.resolve(process.cwd(), answers.projectName);
+    console.log();
+    printHeader();
+    console.log();
+    await initGit(projectDir);
+    printNextSteps(template, answers);
+}
+function printHeader() {
+    const title = 'Setting up your project';
+    const width = 48;
+    console.log(chalk.hex(theme.border)('┌' + '─'.repeat(width) + '┐'));
+    console.log(chalk.hex(theme.border)('│ ') +
+        chalk.bold.hex(theme.brand)(title) +
+        ' '.repeat(width - title.length - 1) +
+        chalk.hex(theme.border)('│'));
+    console.log(chalk.hex(theme.border)('└' + '─'.repeat(width) + '┘'));
+}
+async function initGit(dir) {
+    if (fs.existsSync(path.join(dir, '.git'))) {
+        console.log(chalk.hex(theme.muted)(`  ${symbols.info} Git repository already exists`));
+        return;
+    }
+    const spinner = ora({
+        text: chalk.hex(theme.text)('Initializing git repository'),
+        prefixText: chalk.hex(theme.muted)('›'),
+        spinner: 'line',
+    }).start();
+    // Simulate a small delay for better UX
+    await new Promise((resolve) => setTimeout(resolve, 300));
+    try {
+        const result = spawnSync('git', ['init'], {
+            cwd: dir,
+            stdio: 'pipe',
+        });
+        if (result.status === 0) {
+            spinner.stopAndPersist({
+                symbol: chalk.hex(theme.success)(`${symbols.success}`),
+                text: chalk.hex(theme.success)('Git repository initialized'),
+            });
+        }
+        else {
+            spinner.stopAndPersist({
+                symbol: chalk.hex(theme.warning)(`${symbols.warning}`),
+                text: chalk.hex(theme.warning)('Git initialization skipped'),
+            });
+            console.log(chalk.hex(theme.muted)(`    ${symbols.corner} No git binary found`));
+        }
+    }
+    catch (error) {
+        spinner.stopAndPersist({
+            symbol: chalk.hex('#EF4444')(`${symbols.error}`),
+            text: chalk.hex('#EF4444')('Failed to initialize git'),
+        });
+        console.log(chalk.hex(theme.muted)(`    ${symbols.corner} Make sure git is installed`));
+    }
+}
+function printNextSteps(template, answers) {
+    console.log();
+    console.log(chalk.hex(theme.border)('─'.repeat(52)));
+    console.log();
+    console.log(chalk.bold.hex(theme.success)(`  ${symbols.success} Project ready`));
+    console.log();
+    console.log(chalk.hex(theme.muted)('  Next steps'));
+    console.log();
+    const steps = [
+        `cd ${answers.projectName}`,
+        template.commands.install,
+        template.commands.dev,
+        template.commands.build,
+    ];
+    steps.forEach((cmd, i) => {
+        const connector = i === steps.length - 1 ? symbols.corner : symbols.branch;
+        console.log(chalk.hex(theme.muted)(`  ${connector}`) +
+            chalk.hex(theme.brand).bold(` ${cmd}`));
+    });
+    console.log();
+    console.log(chalk.hex(theme.border)('─'.repeat(52)));
+    console.log();
+    console.log(chalk.hex(theme.muted)('  Enjoy unemployment.'));
+    console.log();
+}

package/dist/prompt.js

@@ -0,0 +1,30 @@
+import { input, select } from '@inquirer/prompts';
+export async function promptUser() {
+    const projectName = await input({
+        message: 'Project name:',
+        default: 'nero-app',
+        validate(value) {
+            if (!value.trim())
+                return '✗ Project name cannot be empty';
+            if (value.includes(' '))
+                return '✗ Project name cannot contain spaces';
+            if (!/^[a-z0-9-_]+$/i.test(value))
+                return '✗ Use only letters, numbers, hyphens, and underscores';
+            return true;
+        },
+        transformer(value) {
+            return value;
+        },
+    });
+    const projectType = await select({
+        message: 'Select project type:',
+        choices: [
+            { name: 'cli', value: 'cli' },
+            { name: 'library', value: 'library' },
+        ],
+    });
+    return {
+        projectName,
+        type: projectType,
+    };
+}

package/dist/renderer.js

@@ -0,0 +1,47 @@
+import fs from 'node:fs';
+import path from 'node:path';
+const TEMPLATE_ROOT = new URL('./templates/', import.meta.url);
+export async function renderTemplate(template, answers) {
+    const targetDir = path.resolve(process.cwd(), answers.projectName);
+    const templateDir = path.resolve(TEMPLATE_ROOT.pathname, template.id);
+    if (fs.existsSync(targetDir)) {
+        throw new Error(`Directory ${answers.projectName} already exists`);
+    }
+    fs.mkdirSync(targetDir, { recursive: true });
+    copyDir(templateDir, targetDir, answers, template.placeholders);
+}
+function copyDir(src, dest, answers, placeholders) {
+    const entries = fs.readdirSync(src, { withFileTypes: true });
+    for (const entry of entries) {
+        const srcPath = path.join(src, entry.name);
+        const outName = entry.name.startsWith('_')
+            ? `.${entry.name.slice(1)}`
+            : entry.name;
+        const destPath = path.join(dest, outName);
+        if (entry.isDirectory()) {
+            fs.mkdirSync(destPath, { recursive: true });
+            copyDir(srcPath, destPath, answers, placeholders);
+            continue;
+        }
+        const stat = fs.statSync(srcPath);
+        if (stat.isDirectory()) {
+            fs.mkdirSync(destPath, { recursive: true });
+            copyDir(srcPath, destPath, answers, placeholders);
+            continue;
+        }
+        // now it's GUARANTEED to be a file
+        let content = fs.readFileSync(srcPath, 'utf8');
+        content = applyPlaceholders(content, answers, placeholders);
+        fs.writeFileSync(destPath, content);
+    }
+}
+function applyPlaceholders(content, answers, placeholders) {
+    let result = content;
+    for (const key of placeholders) {
+        const value = answers[key];
+        if (value == null)
+            continue;
+        result = result.replaceAll(`{{${key}}}`, String(value));
+    }
+    return result;
+}

package/dist/templates/cli/.prettierignore

@@ -0,0 +1,4 @@
+dist
+node_modules
+pnpm-lock.yaml
+assets

package/dist/templates/cli/.prettierrc

@@ -0,0 +1,6 @@
+{
+  "semi": false,
+  "singleQuote": true,
+  "printWidth": 80,
+  "trailingComma": "es5"
+}

package/dist/templates/cli/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Roshan Singh
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/templates/cli/eslint.config.js

@@ -0,0 +1,40 @@
+import tseslint from '@typescript-eslint/eslint-plugin'
+import parser from '@typescript-eslint/parser'
+
+export default [
+  {
+    ignores: ['dist/**', 'node_modules/**', 'assets/**'],
+  },
+  {
+    files: ['**/*.ts'],
+
+    languageOptions: {
+      parser,
+      parserOptions: {
+        ecmaVersion: 'latest',
+        sourceType: 'module',
+      },
+    },
+    plugins: {
+      '@typescript-eslint': tseslint,
+    },
+    rules: {
+      // correctness
+      'no-unused-vars': 'off',
+      '@typescript-eslint/no-unused-vars': [
+        'error',
+        { argsIgnorePattern: '^_' },
+      ],
+
+      'no-shadow': 'off',
+      '@typescript-eslint/no-shadow': 'error',
+
+      'no-redeclare': 'off',
+      '@typescript-eslint/no-redeclare': 'error',
+
+      // sanity
+      'no-console': 'error',
+      'prefer-const': 'error',
+    },
+  },
+]

package/dist/templates/cli/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "{{projectName}}",
+  "version": "0.1.0",
+  "description": "",
+  "type": "module",
+  "bin": {
+    "{{projectName}}": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "prepublishOnly": "npm run build",
+    "postbuild": "chmod +x dist/index.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/alcanivorax/{{projectName}.git"
+  },
+  "keywords": [
+    "cli"
+  ],
+  "author": "alcanivorax",
+  "license": "MIT",
+  "packageManager": "pnpm@10.28.0",
+  "devDependencies": {
+    "@types/node": "^25.0.9",
+    "@typescript-eslint/eslint-plugin": "^8.53.1",
+    "@typescript-eslint/parser": "^8.53.1",
+    "eslint": "^9.39.2",
+    "prettier": "^3.8.1",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  }
+}

package/dist/templates/cli/src/cli/args.ts

@@ -0,0 +1 @@
+export const args = process.argv.splice(2)

package/dist/templates/cli/src/cli/options.ts

@@ -0,0 +1,45 @@
+import { args } from './args.js'
+import pkg from '../../package.json' with {type: "json"}
+
+
+function printHelp(): void  {
+      console.log(`
+${pkg} - a cli 
+Usage:
+  ${pkg.name} [options]
+
+Options:
+  -h, --help, help        Show help
+  -v, --version, version  Show version
+`)
+   }
+
+function printVersion(): void {
+      console.log(`
+${pkg.name} version ${pkg.version}
+`)
+   }
+function printInvalidOptions(option: string): void {
+      console.error(`
+unknown option: ${option}
+usage: ${pkg.name} [-v | --version] [-h | --help]
+`)
+   }
+
+export function handleCliOptions(): void {
+   if(args.length === 0) return 
+
+   if(args.includes('-h') || args.includes('--help') || args.includes('help')){
+      printHelp()
+      process.exit(0)
+   }
+
+   if(args.includes('-v') || args.includes('--version') || args.includes('version')) {
+      printVersion()
+      process.exit(0)
+   }
+
+
+   printInvalidOptions(args[0]);
+   process.exit(2)
+}

package/dist/templates/cli/src/index.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+
+import pkg from '../package.json' with { type: 'json' }
+import { handleCliOptions } from './cli/options.js'
+
+async function run() {
+  handleCliOptions()
+  console.log(`${pkg.name} is running...`)
+}
+
+await run()

package/dist/templates/cli/tsconfig.json

@@ -0,0 +1,32 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+
+    "outDir": "dist",
+    "rootDir": "src",
+
+    "strict": true,
+    "skipLibCheck": true,
+
+    "esModuleInterop": true,
+    "resolveJsonModule": true,
+
+    "declaration": false,
+    "declarationMap": false,
+    "sourceMap": false,
+
+    "noEmitOnError": true,
+    "forceConsistentCasingInFileNames": true,
+
+    "types": ["node"]
+  },
+  "include": ["src", "index.ts"],
+  "exclude": [
+    "**/__tests__/**",
+    "**/__test__/**",
+    "**/*.test.ts",
+    "**/*.spec.ts"
+  ]
+}

package/dist/templates/cli/vitest.config.ts

@@ -0,0 +1,7 @@
+import { defineConfig } from 'vitest/config'
+
+export default defineConfig({
+  test: {
+    include: ['src/**/*.test.ts'],
+  },
+})

package/dist/templates/library/.prettierignore

@@ -0,0 +1,4 @@
+dist
+node_modules
+pnpm-lock.yaml
+assets

package/dist/templates/library/.prettierrc

@@ -0,0 +1,6 @@
+{
+  "semi": false,
+  "singleQuote": true,
+  "printWidth": 80,
+  "trailingComma": "es5"
+}

package/dist/templates/library/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 [Author]
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/templates/library/eslint.config.js

@@ -0,0 +1,40 @@
+import tseslint from "@typescript-eslint/eslint-plugin";
+import parser from "@typescript-eslint/parser";
+
+export default [
+  {
+    ignores: ["dist/**", "node_modules/**", "assets/**"],
+  },
+  {
+    files: ["**/*.ts"],
+
+    languageOptions: {
+      parser,
+      parserOptions: {
+        ecmaVersion: "latest",
+        sourceType: "module",
+      },
+    },
+    plugins: {
+      "@typescript-eslint": tseslint,
+    },
+    rules: {
+      // correctness
+      "no-unused-vars": "off",
+      "@typescript-eslint/no-unused-vars": [
+        "error",
+        { argsIgnorePattern: "^_" },
+      ],
+
+      "no-shadow": "off",
+      "@typescript-eslint/no-shadow": "error",
+
+      "no-redeclare": "off",
+      "@typescript-eslint/no-redeclare": "error",
+
+      // sanity
+      "no-console": "error",
+      "prefer-const": "error",
+    },
+  },
+];

package/dist/templates/library/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "{{projectName}}",
+  "version": "0.1.0",
+  "description": "",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "prepublishOnly": "npm run build"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/alcanivorax/{{projectName}}.git"
+  },
+  "keywords": [],
+  "author": "alcanivorax",
+  "license": "MIT",
+  "packageManager": "pnpm@10.28.0",
+  "devDependencies": {
+    "@types/node": "^25.0.9",
+    "@typescript-eslint/eslint-plugin": "^8.53.1",
+    "@typescript-eslint/parser": "^8.53.1",
+    "eslint": "^9.39.2",
+    "prettier": "^3.8.1",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  }
+}

package/dist/templates/library/src/index.ts

@@ -0,0 +1 @@
+console.log("library");

package/dist/templates/library/tsconfig.json

@@ -0,0 +1,24 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+
+    "outDir": "dist",
+    "rootDir": "src",
+
+    "strict": true,
+    "skipLibCheck": true,
+
+    "esModuleInterop": true,
+
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "noEmitOnError": true,
+
+    "forceConsistentCasingInFileNames": true,
+    "types": ["node"]
+  },
+  "include": ["src"]
+}

package/dist/templates/library/vitest.config.ts

@@ -0,0 +1,7 @@
+import { defineConfig } from 'vitest/config'
+
+export default defineConfig({
+  test: {
+    include: ['src/**/*.test.ts'],
+  },
+})

package/dist/templates/templates.json

@@ -0,0 +1,20 @@
+[
+  {
+    "id": "cli",
+    "placeholders": ["projectName"],
+    "commands": {
+      "install": "pnpm install",
+      "dev": "pnpm dev",
+      "build": "pnpm build"
+    }
+  },
+  {
+    "id": "library",
+    "placeholders": ["projectName"],
+    "commands": {
+      "install": "pnpm install",
+      "dev": "pnpm dev",
+      "build": "pnpm build"
+    }
+  }
+]

package/dist/templates.js

@@ -0,0 +1,5 @@
+import rawTemplates from './templates/templates.json' with { type: 'json' };
+const templates = rawTemplates;
+export async function selectTemplate(answers) {
+    return templates.find((t) => t.id === answers.type); // source: trust me!
+}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "nero-init",
+  "version": "1.0.0",
+  "description": "Project scaffold for CLI, library and Web templates.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "bin": {
+    "nero-init": "./dist/index.js"
+  },
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "build": "tsc && cp -r src/templates dist/",
+    "format": "prettier --write .",
+    "lint": "eslint .",
+    "prepublishOnly": "npm run build",
+    "postbuild": "chmod +x dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/alcanivorax/nero-init.git"
+  },
+  "keywords": [
+    "scaffold",
+    "project-generator",
+    "starter-template",
+    "cli",
+    "typescript",
+    "node",
+    "developer-tools",
+    "boilerplate"
+  ],
+  "author": "alcanivorax",
+  "license": "MIT",
+  "packageManager": "pnpm@10.28.0",
+  "devDependencies": {
+    "@types/node": "^25.0.9",
+    "@typescript-eslint/eslint-plugin": "^8.53.1",
+    "@typescript-eslint/parser": "^8.53.1",
+    "eslint": "^9.39.2",
+    "prettier": "^3.8.1",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^8.2.0",
+    "chalk": "^5.6.2",
+    "ora": "^9.1.0"
+  }
+}