create-webpack-starter 0.2.0

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2026, Razerspine
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,51 @@
+# create-webpack-starter
+
+Create a modern webpack project using ready-to-use templates.
+
+## Usage
+
+```bash
+npx create-webpack-starter my-app
+```
+
+With options:
+
+```bash
+npx create-webpack-starter my-app \
+--template pug-scss-ts \
+--no-install
+```
+
+## Options
+
+| Option              | Description                     |
+| ------------------- | ------------------------------- |
+| `--template <name>` | Skip prompt and select template |
+| `--no-install`      | Skip dependency installation    |
+| `--dry-run`         | Show what would be done         |
+
+## Available templates
+* pug-less-js
+* pug-less-ts
+* pug-scss-js
+* pug-scss-ts
+
+## Requirement
+* Node.js >= 18
+* npm/ pnpm/ yarn
+
+## How it works
+1. CLI copies the selected template
+2. Template files are written to the target directory
+3. Dependencies are installed (unless disabled)
+4. Project is ready to use
+
+## What you get
+- Preconfigured webpack setup
+- Pug templates
+- SCSS / Less
+- JavaScript or TypeScript
+- Production-ready build
+
+## 📄 License
+This project is licensed under the ISC License.

package/bin/index.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+require('../dist/index.js');

package/dist/cli.js

@@ -0,0 +1,57 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCliContext = getCliContext;
+const commander_1 = require("commander");
+const inquirer_1 = __importDefault(require("inquirer"));
+const templates_1 = require("./templates");
+async function getCliContext() {
+    const program = new commander_1.Command();
+    program
+        .argument('[project-name]', 'Project name')
+        .option('-t, --template <template>', 'Template name')
+        .option('--no-install', 'Skip npm install')
+        .option('--dry-run', 'Do not write files');
+    program.parse(process.argv);
+    const options = program.opts();
+    let projectName = program.args[0];
+    // --- ASK PROJECT NAME IF NOT PROVIDED
+    if (!projectName) {
+        const answer = await inquirer_1.default.prompt([
+            {
+                type: 'input',
+                name: 'projectName',
+                message: 'Project name:',
+                validate: v => !!v || 'Project name is required'
+            }
+        ]);
+        projectName = answer.projectName;
+    }
+    let template = options.template;
+    // --- ASK TEMPLATE IF NOT PROVIDED
+    if (!template) {
+        const answer = await inquirer_1.default.prompt([
+            {
+                type: 'list',
+                name: 'template',
+                message: 'Choose a template:',
+                choices: Object.values(templates_1.templates).map(t => ({
+                    name: t.meta.description,
+                    value: t.key
+                }))
+            }
+        ]);
+        template = answer.template;
+    }
+    if (!template || !templates_1.templates[template]) {
+        throw new Error(`Unknown template: ${template}`);
+    }
+    return {
+        projectName,
+        template,
+        noInstall: options.install === false,
+        dryRun: Boolean(options.dryRun)
+    };
+}

package/dist/copier.js

@@ -0,0 +1,14 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.copyTemplate = copyTemplate;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+/**
+ * Copy template directory into target directory.
+ * Assumes targetDir does NOT exist.
+ */
+async function copyTemplate(templatePath, targetDir) {
+    await fs_extra_1.default.copy(templatePath, targetDir);
+}

package/dist/index.js

@@ -0,0 +1,119 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const path_1 = __importDefault(require("path"));
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const ora_1 = __importDefault(require("ora"));
+const inquirer_1 = __importDefault(require("inquirer"));
+const cli_1 = require("./cli");
+const templates_1 = require("./templates");
+const copier_1 = require("./copier");
+const installer_1 = require("./installer");
+const logger_1 = require("./logger");
+const package_merger_1 = require("./package-merger");
+process.on('unhandledRejection', (err) => {
+    if (err?.isTtyError || err?.name === 'ExitPromptError') {
+        logger_1.log.info('Cancelled by user');
+        process.exit(130);
+    }
+});
+async function run() {
+    const spinner = (0, ora_1.default)();
+    try {
+        const { projectName, template: templateKey, noInstall, dryRun } = await (0, cli_1.getCliContext)();
+        const template = templates_1.templates[templateKey];
+        if (!template) {
+            throw new Error(`Unknown template: ${templateKey}`);
+        }
+        if (!template.filesPath) {
+            throw new Error(`Template '${templateKey}' has no filesPath`);
+        }
+        const targetDir = path_1.default.resolve(process.cwd(), projectName);
+        logger_1.log.info(`Creating project: ${projectName}`);
+        logger_1.log.info(`Template: ${templateKey}`);
+        // --- Copy template (SAFE)
+        if (dryRun) {
+            if (fs_extra_1.default.existsSync(targetDir)) {
+                spinner.warn(`[dry-run] Directory "${projectName}" already exists`);
+            }
+            spinner.info('[dry-run] Template would be copied');
+        }
+        else {
+            // ⛔ overwrite decision happens ONLY here
+            if (fs_extra_1.default.existsSync(targetDir)) {
+                spinner.stop();
+                const { overwrite } = await inquirer_1.default.prompt([
+                    {
+                        type: 'confirm',
+                        name: 'overwrite',
+                        message: `Directory "${projectName}" already exists. Overwrite?`,
+                        default: false
+                    }
+                ]);
+                if (!overwrite) {
+                    logger_1.log.info('Cancelled by user');
+                    process.exit(0);
+                }
+                spinner.start('Cleaning target directory...');
+                await fs_extra_1.default.remove(targetDir);
+                spinner.succeed('Directory cleaned');
+            }
+            spinner.start('Copying template...');
+            await (0, copier_1.copyTemplate)(template.filesPath, targetDir);
+            spinner.succeed('Template copied');
+        }
+        // --- Merge dependencies
+        if (!dryRun && template.meta) {
+            const { dependencies, devDependencies } = template.meta;
+            if ((dependencies && Object.keys(dependencies).length > 0) ||
+                (devDependencies && Object.keys(devDependencies).length > 0)) {
+                spinner.start('Merging template dependencies...');
+                await (0, package_merger_1.mergePackageJson)(targetDir, {
+                    dependencies,
+                    devDependencies
+                });
+                spinner.succeed('Dependencies merged');
+            }
+        }
+        // --- Script cleanup (JS vs TS)
+        if (!dryRun && template.meta?.features?.script) {
+            const pkgPath = path_1.default.join(targetDir, 'package.json');
+            const pkg = await fs_extra_1.default.readJson(pkgPath);
+            if (template.meta.features.script === 'ts') {
+                delete pkg.devDependencies?.['@babel/core'];
+                delete pkg.devDependencies?.['@babel/preset-env'];
+                delete pkg.devDependencies?.['babel-loader'];
+                await fs_extra_1.default.remove(path_1.default.join(targetDir, '.babelrc'));
+                await fs_extra_1.default.remove(path_1.default.join(targetDir, 'babel.config.js'));
+            }
+            if (template.meta.features.script === 'js') {
+                delete pkg.devDependencies?.['typescript'];
+                delete pkg.devDependencies?.['ts-loader'];
+                await fs_extra_1.default.remove(path_1.default.join(targetDir, 'tsconfig.json'));
+            }
+            await fs_extra_1.default.writeJson(pkgPath, pkg, { spaces: 2 });
+        }
+        // --- Install deps
+        if (noInstall) {
+            spinner.info('Skipping install');
+        }
+        else if (dryRun) {
+            spinner.info('[dry-run] Would install dependencies');
+        }
+        else {
+            spinner.start('Installing dependencies...');
+            await (0, installer_1.installDeps)(targetDir);
+            spinner.succeed('Dependencies installed');
+        }
+        logger_1.log.success('Done!');
+    }
+    catch (err) {
+        spinner.stop();
+        console.error('❌ Error:', err?.message || err);
+        process.exit(1);
+    }
+}
+run().then();

package/dist/installer.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installDeps = installDeps;
+const child_process_1 = require("child_process");
+function installDeps(cwd) {
+    return new Promise((resolve, reject) => {
+        const child = (0, child_process_1.spawn)('npm', ['install'], {
+            cwd,
+            stdio: 'inherit',
+            shell: true
+        });
+        child.on('close', code => {
+            if (code === 0)
+                resolve();
+            else
+                reject(new Error('npm install failed'));
+        });
+    });
+}

package/dist/logger.js

@@ -0,0 +1,12 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.log = void 0;
+const kleur_1 = __importDefault(require("kleur"));
+exports.log = {
+    info: (msg) => console.log(kleur_1.default.cyan(msg)),
+    success: (msg) => console.log(kleur_1.default.green(msg)),
+    error: (msg) => console.error(kleur_1.default.red(msg))
+};

package/dist/package-merger.js

@@ -0,0 +1,24 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mergePackageJson = mergePackageJson;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const path_1 = __importDefault(require("path"));
+async function mergePackageJson(targetDir, templateDeps) {
+    const packageJsonPath = path_1.default.join(targetDir, 'package.json');
+    if (!await fs_extra_1.default.pathExists(packageJsonPath)) {
+        throw new Error('package.json not found in generated project');
+    }
+    const pkg = await fs_extra_1.default.readJson(packageJsonPath);
+    pkg.dependencies = {
+        ...(pkg.dependencies || {}),
+        ...(templateDeps.dependencies || {})
+    };
+    pkg.devDependencies = {
+        ...(pkg.devDependencies || {}),
+        ...(templateDeps.devDependencies || {})
+    };
+    await fs_extra_1.default.writeJson(packageJsonPath, pkg, { spaces: 2 });
+}

package/dist/template-loader.js

@@ -0,0 +1,29 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadTemplates = loadTemplates;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+function loadTemplates(templatesRoot) {
+    const entries = fs_1.default.readdirSync(templatesRoot, { withFileTypes: true });
+    const result = {};
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        const templateDir = path_1.default.join(templatesRoot, entry.name);
+        const metaPath = path_1.default.join(templateDir, 'template.json');
+        const filesPath = path_1.default.join(templateDir, 'files');
+        if (!fs_1.default.existsSync(metaPath) || !fs_1.default.existsSync(filesPath))
+            continue;
+        const meta = JSON.parse(fs_1.default.readFileSync(metaPath, 'utf-8'));
+        result[entry.name] = {
+            key: entry.name,
+            meta,
+            path: templateDir,
+            filesPath
+        };
+    }
+    return result;
+}

package/dist/templates.js

@@ -0,0 +1,10 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.templates = void 0;
+const path_1 = __importDefault(require("path"));
+const template_loader_1 = require("./template-loader");
+const templatesRoot = path_1.default.resolve(__dirname, '../../../packages/templates');
+exports.templates = (0, template_loader_1.loadTemplates)(templatesRoot);

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "create-webpack-starter",
+  "version": "0.2.0",
+  "description": "Create a webpack starter with Pug, SCSS, TS and more",
+  "bin": {
+    "create-webpack-starter": "bin/index.js"
+  },
+  "files": [
+    "bin",
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "ts-node src/index.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "webpack",
+    "starter",
+    "cli",
+    "pug",
+    "scss",
+    "less",
+    "javascript",
+    "typescript"
+  ],
+  "author": "Razerspine",
+  "license": "ISC",
+  "dependencies": {
+    "commander": "^12.0.0",
+    "fs-extra": "^11.2.0",
+    "inquirer": "^9.3.0",
+    "kleur": "^4.1.5",
+    "ora": "^9.1.0"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/inquirer": "^9.0.9",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3"
+  }
+}