create-alistt69-kit 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 alistt69
+
+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,115 @@
+# _create-alistt69-kit_
+
+> **One command. Zero config fatigue.**  
+> Bootstrap a **React + TypeScript + Webpack** app with a solid starter setup and optional tooling you can enable when you need it.
+
+[![npm version](https://img.shields.io/npm/v/create-alistt69-kit.svg)](https://www.npmjs.com/package/create-alistt69-kit)
+[![Node.js Version](https://img.shields.io/badge/node-%3E%3D18.18-brightgreen)](https://nodejs.org/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
+
+---
+
+## ✨ Overview
+
+`create-alistt69-kit` is a project scaffolding tool for quickly creating a modern frontend app without burning time on repetitive setup.
+
+It generates a ready-to-run **React + TypeScript + Webpack** starter with a practical baseline and optional extras you can turn on when needed.
+
+## 🔧  What’s inside
+
+| Tool | Purpose | Included |
+|------|---------|----------|
+| [React](https://react.dev/) | UI library | Default  |
+| [TypeScript](https://www.typescriptlang.org/) | Static typing | Default  |
+| [Webpack](https://webpack.js.org/) | Bundling and build pipeline | Default  |
+| [SCSS Modules](https://github.com/css-modules/css-modules) | Scoped styling | Default  |
+| [SVGR](https://react-svgr.com/) | Import SVGs as React components | Default  |
+| [Webpack Bundle Analyzer](https://github.com/webpack-contrib/webpack-bundle-analyzer) | Bundle size inspection | Default  |
+| [ESLint](https://eslint.org/) + [eslint-stylistic](https://eslint.style/) | Code quality and stylistic rules | Optional |
+| [Stylelint](https://stylelint.io/) | Stylesheet linting | Optional |
+| [Autoprefixer](https://github.com/postcss/autoprefixer) | Automatic CSS vendor prefixes | Optional |
+| [React Router](https://reactrouter.com/) | Client-side routing | Optional |
+
+---
+
+## 🎯 Why use it?
+
+Setting up a frontend project from scratch usually means repeating the same stuff every time:
+
+- webpack config
+- TypeScript config
+- style handling
+- routing
+- linters
+- folder structure
+
+This starter removes that boilerplate so you can get straight to building.
+
+---
+
+## 📦 Requirements
+
+- **Node.js** `18.18` or higher
+- **npm**, **pnpm**, or **yarn**
+
+---
+
+## 🔥 Quick start
+
+Create a new app interactively:
+
+```bash
+npm create alistt69-kit
+```
+
+Follow the prompts — or skip them entirely:
+
+```bash
+npm create alistt69-kit my-app --yes
+```
+
+## 🛠️  Usage examples
+
+```bash
+# Interactive setup
+npm create alistt69-kit my-app
+
+# All defaults, no prompts
+npm create alistt69-kit my-app --yes
+
+# Skip dependency installation
+npm create alistt69-kit my-app --no-install
+
+# Enable only selected features
+npm create alistt69-kit my-app --features=eslint,react-router
+
+# Enable all optional features
+npm create alistt69-kit my-app --features=all
+
+# Use pnpm as package manager
+npm create alistt69-kit my-app --pm pnpm
+
+# Overwrite existing directory
+npm create alistt69-kit my-app --yes --force
+```
+
+## ⚙️ CLI options
+
+| Option | Alias | Description |
+|--------|-------|-------------|
+| `--yes` | `-y` | Skip prompts, use defaults |
+| `--force` | — | Overwrite target directory if it exists |
+| `--no-install` | — | Skip dependency installation |
+| `--features <list>` | — | Enable specific features (`eslint`, `react-router`, `all`) |
+| `--pm <name>` | — | Choose package manager (`npm`, `pnpm`, `yarn`) |
+| `--help` | `-h` | Show help |
+
+## 🧪 Default behavior
+
+- All features are enabled by default
+- Package manager: `npm` (can be overridden with `--pm`)
+- Dependencies are installed automatically (skip with `--no-install`)
+
+## 📄 License
+
+MIT — free and open for everyone.

package/bin/index.js

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+
+import { cancel } from '@clack/prompts';
+import process from 'node:process';
+import { createProject } from '../src/core/create-project.js';
+import { formatHelpMessage, parseCliArgs } from '../src/core/parse-cli-args.js';
+
+try {
+    const cliArgs = parseCliArgs(process.argv.slice(2));
+
+    if (cliArgs.showHelp) {
+        console.log(formatHelpMessage());
+        process.exit(0);
+    }
+
+    await createProject(cliArgs);
+} catch (error) {
+    cancel(
+        error instanceof Error
+            ? `Failed to create project: ${error.message}`
+            : 'Failed to create project',
+    );
+
+    process.exitCode = 1;
+}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "create-alistt69-kit",
+  "version": "0.1.0",
+  "description": "Opinionated React + TypeScript + Webpack project generator by alistt69",
+  "keywords": [
+    "create",
+    "cli",
+    "scaffold",
+    "generator",
+    "react",
+    "typescript",
+    "webpack"
+  ],
+  "homepage": "https://github.com/alistt69/create-alistt69-kit#readme",
+  "bugs": {
+    "url": "https://github.com/alistt69/create-alistt69-kit/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/alistt69/create-alistt69-kit.git"
+  },
+  "license": "MIT",
+  "author": "alistt69",
+  "type": "module",
+  "bin": {
+    "create-alistt69-kit": "bin/index.js"
+  },
+  "files": [
+    "bin",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "dev": "node ./bin/index.js",
+    "smoke": "node ./scripts/smoke.mjs"
+  },
+  "engines": {
+    "node": ">=18.18.0"
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.10.1"
+  }
+}

package/src/core/apply-features.js

@@ -0,0 +1,15 @@
+import { featuresById } from '../features/index.js';
+
+export async function applyFeatures({ projectPath, selectedFeatureIds }) {
+    for (const featureId of selectedFeatureIds) {
+        const feature = featuresById.get(featureId);
+
+        if (!feature) {
+            throw new Error(`Unknown feature: ${featureId}`);
+        }
+
+        await feature.apply({
+            projectPath,
+        });
+    }
+}

package/src/core/collect-project-info.js

@@ -0,0 +1,195 @@
+import {
+    cancel,
+    confirm,
+    intro,
+    isCancel,
+    multiselect,
+    note,
+    select,
+    text,
+} from '@clack/prompts';
+import process from 'node:process';
+import { format } from '../utils/console-format.js';
+import { allowedPackageManagers } from '../utils/package-manager.js';
+
+const availableFeatures = [
+    {
+        value: 'eslint',
+        label: 'ESLint + Stylistic',
+        hint: 'JS/TS/React linting',
+    },
+    {
+        value: 'stylelint',
+        label: 'Stylelint',
+        hint: 'SCSS/CSS linting',
+    },
+    {
+        value: 'autoprefixer',
+        label: 'Autoprefixer',
+        hint: 'PostCSS vendor prefixes',
+    },
+    {
+        value: 'react-router',
+        label: 'React Router DOM',
+        hint: 'Routing + FSD-like app/pages/shared',
+    },
+];
+
+const defaultFeatureIds = availableFeatures.map((feature) => feature.value);
+const defaultPackageManager = 'npm';
+const availableFeatureIdSet = new Set(defaultFeatureIds);
+
+function handleCancel(value) {
+    if (!isCancel(value)) {
+        return value;
+    }
+
+    cancel('Operation cancelled.');
+    process.exit(0);
+}
+
+function validateProjectName(value) {
+    const projectName = value.trim();
+
+    if (!projectName) {
+        return 'Project name is required';
+    }
+
+    if (projectName.length > 214) {
+        return 'Project name is too long';
+    }
+
+    if (!/^[a-z0-9._-]+$/i.test(projectName)) {
+        return 'Use only letters, numbers, dots, underscores and hyphens';
+    }
+
+    if (projectName.startsWith('.')) {
+        return 'Project name cannot start with a dot';
+    }
+
+    return;
+}
+
+function normalizeFeatureIds(featureIds) {
+    const normalizedFeatureIds = [...new Set(featureIds.map((featureId) => featureId.toLowerCase()))];
+
+    if (normalizedFeatureIds.includes('all')) {
+        return defaultFeatureIds;
+    }
+
+    const unknownFeatureIds = normalizedFeatureIds.filter((featureId) => !availableFeatureIdSet.has(featureId));
+
+    if (unknownFeatureIds.length > 0) {
+        throw new Error(`Unknown features: ${unknownFeatureIds.join(', ')}`);
+    }
+
+    return defaultFeatureIds.filter((featureId) => normalizedFeatureIds.includes(featureId));
+}
+
+export async function collectProjectInfo(cliArgs = {}) {
+    intro('create-alistt69-kit');
+
+    let projectName = cliArgs.projectName;
+    let selectedFeatureIds = cliArgs.selectedFeatureIds;
+    let shouldInstallDependencies = cliArgs.shouldInstallDependencies;
+    let packageManager = cliArgs.packageManager;
+
+    if (cliArgs.yes && !projectName) {
+        throw new Error('Project name is required when using --yes');
+    }
+
+    if (!projectName) {
+        projectName = handleCancel(await text({
+            message: 'Project name',
+            placeholder: 'my-awesome-app',
+            validate: validateProjectName,
+        }));
+    } else {
+        const validationError = validateProjectName(projectName);
+
+        if (validationError) {
+            throw new Error(validationError);
+        }
+    }
+
+    if (selectedFeatureIds === undefined) {
+        if (cliArgs.yes) {
+            selectedFeatureIds = defaultFeatureIds;
+        } else {
+            note(
+                [
+                    'All features are selected by default.',
+                    'Remove anything you do not need.',
+                    '',
+                    '↑/↓ — move',
+                    'Space — toggle feature',
+                    'Enter — confirm selection',
+                ].join('\n'),
+                format.sectionTitle('Feature selection help'),
+            );
+
+            selectedFeatureIds = handleCancel(await multiselect({
+                message: 'Remove unnecessary features',
+                options: availableFeatures,
+                initialValues: defaultFeatureIds,
+                required: false,
+            }));
+        }
+    }
+
+    selectedFeatureIds = normalizeFeatureIds(selectedFeatureIds);
+
+    if (!packageManager) {
+        if (cliArgs.yes) {
+            packageManager = defaultPackageManager;
+        } else {
+            packageManager = handleCancel(await select({
+                message: 'Package manager',
+                initialValue: defaultPackageManager,
+                options: allowedPackageManagers.map((value) => ({
+                    value,
+                    label: value,
+                })),
+            }));
+        }
+    }
+
+    if (shouldInstallDependencies === undefined) {
+        if (cliArgs.yes) {
+            shouldInstallDependencies = true;
+        } else {
+            shouldInstallDependencies = handleCancel(await confirm({
+                message: 'Install dependencies?',
+                initialValue: true,
+            }));
+        }
+    }
+
+    const summaryLines = [
+        `${format.label('Project')}  ${projectName}`,
+        `${format.label('Features')} ${selectedFeatureIds.length ? selectedFeatureIds.join(', ') : 'none'}`,
+        `${format.label('PM')}       ${packageManager}`,
+        `${format.label('Install')}  ${shouldInstallDependencies ? 'yes' : 'no'}`,
+    ];
+
+    note(summaryLines.join('\n'), format.sectionTitle('Summary'));
+
+    if (!cliArgs.yes) {
+        const shouldContinue = handleCancel(await confirm({
+            message: 'Continue?',
+            initialValue: true,
+        }));
+
+        if (!shouldContinue) {
+            cancel('Operation cancelled.');
+            process.exit(0);
+        }
+    }
+
+    return {
+        projectName: projectName.trim(),
+        selectedFeatureIds,
+        shouldInstallDependencies,
+        packageManager,
+    };
+}

package/src/core/copy-base-template.js

@@ -0,0 +1,12 @@
+import { cp } from 'node:fs/promises';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const currentFilePath = fileURLToPath(import.meta.url);
+const currentDirPath = dirname(currentFilePath);
+
+export async function copyBaseTemplate(targetDirPath) {
+    const templateDirPath = resolve(currentDirPath, '../templates/base');
+
+    await cp(templateDirPath, targetDirPath, { recursive: true });
+}

package/src/core/create-project.js

@@ -0,0 +1,90 @@
+import { outro, spinner } from '@clack/prompts';
+import process from 'node:process';
+import { format } from '../utils/console-format.js';
+import { getRunScriptCommand } from '../utils/package-manager.js';
+import { applyFeatures } from './apply-features.js';
+import { collectProjectInfo } from './collect-project-info.js';
+import { copyBaseTemplate } from './copy-base-template.js';
+import { installDependencies } from './install-dependencies.js';
+import { prepareTargetDirectory } from './prepare-target-directory.js';
+import { replaceTokens } from './replace-tokens.js';
+import { restoreSpecialFiles } from './restore-special-files.js';
+
+export async function createProject(cliArgs = {}) {
+    const {
+        projectName,
+        selectedFeatureIds,
+        shouldInstallDependencies,
+        packageManager,
+    } = await collectProjectInfo(cliArgs);
+
+    const { targetDirPath } = await prepareTargetDirectory({
+        projectName,
+        force: cliArgs.force,
+        yes: cliArgs.yes,
+    });
+
+    const progress = spinner();
+
+    try {
+        progress.start('Copying base template...');
+        await copyBaseTemplate(targetDirPath);
+        progress.stop('Base template copied');
+
+        progress.start('Restoring special files...');
+        await restoreSpecialFiles(targetDirPath);
+        progress.stop('Special files restored');
+
+        progress.start('Replacing template tokens...');
+        await replaceTokens(targetDirPath, {
+            '__PROJECT_NAME__': projectName,
+        });
+        progress.stop('Template tokens replaced');
+
+        if (selectedFeatureIds.length > 0) {
+            progress.start(`Applying features: ${selectedFeatureIds.join(', ')}`);
+            await applyFeatures({
+                projectPath: targetDirPath,
+                selectedFeatureIds,
+            });
+            progress.stop('Features applied');
+        }
+
+        if (shouldInstallDependencies) {
+            progress.start(`Installing dependencies with ${packageManager}...`);
+            await installDependencies(targetDirPath, packageManager);
+            progress.stop('Dependencies installed');
+        }
+    } catch (error) {
+        progress.stop('Operation failed');
+        throw error;
+    }
+
+    const featuresLine = selectedFeatureIds.length
+        ? selectedFeatureIds.join(', ')
+        : 'none';
+
+    const nextSteps = shouldInstallDependencies
+        ? [
+            `cd ${projectName}`,
+            getRunScriptCommand(packageManager, 'start'),
+        ]
+        : [
+            `cd ${projectName}`,
+            packageManager === 'yarn' ? 'yarn' : `${packageManager} install`,
+            getRunScriptCommand(packageManager, 'start'),
+        ];
+
+    outro([
+        `${format.green('✔ Project created successfully')}`,
+        '',
+        format.sectionTitle('Project info'),
+        `${format.label('Project')}  ${projectName}`,
+        `${format.label('Path')}     ${targetDirPath}`,
+        `${format.label('Features')} ${featuresLine}`,
+        `${format.label('PM')}       ${packageManager}`,
+        '',
+        format.sectionTitle('Next steps'),
+        ...nextSteps.map((step) => `  ${step}`),
+    ].join('\n'));
+}

package/src/core/install-dependencies.js

@@ -0,0 +1,28 @@
+import { spawn } from 'node:child_process';
+import process from 'node:process';
+import { getInstallCommand } from '../utils/package-manager.js';
+
+export function installDependencies(targetDirPath, packageManager) {
+    const { command, args } = getInstallCommand(packageManager);
+
+    return new Promise((resolvePromise, rejectPromise) => {
+        const childProcess = spawn(command, args, {
+            cwd: targetDirPath,
+            stdio: 'inherit',
+            shell: process.platform === 'win32',
+        });
+
+        childProcess.on('error', (error) => {
+            rejectPromise(error);
+        });
+
+        childProcess.on('close', (code) => {
+            if (code === 0) {
+                resolvePromise();
+                return;
+            }
+
+            rejectPromise(new Error(`${command} ${args.join(' ')} failed with exit code ${code}`.trim()));
+        });
+    });
+}

package/src/core/parse-cli-args.js

@@ -0,0 +1,123 @@
+import { allowedPackageManagers } from '../utils/package-manager.js';
+
+function readOptionValue(args, currentIndex, optionName) {
+    const currentArg = args[currentIndex];
+
+    if (currentArg.includes('=')) {
+        return {
+            value: currentArg.slice(currentArg.indexOf('=') + 1),
+            nextIndex: currentIndex,
+        };
+    }
+
+    const nextArg = args[currentIndex + 1];
+
+    if (!nextArg || nextArg.startsWith('-')) {
+        throw new Error(`Option ${optionName} requires a value`);
+    }
+
+    return {
+        value: nextArg,
+        nextIndex: currentIndex + 1,
+    };
+}
+
+export function formatHelpMessage() {
+    return [
+        'Usage:',
+        '  create-alistt69-kit <project-name> [options]',
+        '',
+        'Options:',
+        '  -y, --yes                    Skip prompts and use defaults',
+        '  --force                      Overwrite target directory if it exists',
+        '  --no-install                 Do not install dependencies',
+        '  --features <comma-list>      Example: eslint,stylelint,react-router',
+        '  --features all               Enable all features',
+        '  --pm <npm|pnpm|yarn>         Package manager',
+        '  -h, --help                   Show help',
+        '',
+        'Defaults:',
+        '  All features are enabled by default',
+        '  Package manager: npm',
+        '  Install dependencies: yes',
+        '',
+        'Examples:',
+        '  create-alistt69-kit my-app',
+        '  create-alistt69-kit my-app --features=all',
+        '  create-alistt69-kit my-app --pm pnpm --no-install',
+        '  create-alistt69-kit my-app --yes',
+        '  create-alistt69-kit my-app --yes --force',
+    ].join('\n');
+}
+
+export function parseCliArgs(argv) {
+    const result = {
+        projectName: undefined,
+        selectedFeatureIds: undefined,
+        shouldInstallDependencies: undefined,
+        packageManager: undefined,
+        yes: false,
+        force: false,
+        showHelp: false,
+    };
+
+    for (let index = 0; index < argv.length; index += 1) {
+        const arg = argv[index];
+
+        if (arg === '-h' || arg === '--help') {
+            result.showHelp = true;
+            continue;
+        }
+
+        if (arg === '-y' || arg === '--yes') {
+            result.yes = true;
+            continue;
+        }
+
+        if (arg === '--force') {
+            result.force = true;
+            continue;
+        }
+
+        if (arg === '--no-install') {
+            result.shouldInstallDependencies = false;
+            continue;
+        }
+
+        if (arg.startsWith('--features')) {
+            const { value, nextIndex } = readOptionValue(argv, index, '--features');
+            index = nextIndex;
+
+            result.selectedFeatureIds = value
+                ? value.split(',').map((item) => item.trim()).filter(Boolean)
+                : [];
+
+            continue;
+        }
+
+        if (arg.startsWith('--pm')) {
+            const { value, nextIndex } = readOptionValue(argv, index, '--pm');
+            index = nextIndex;
+
+            if (!allowedPackageManagers.includes(value)) {
+                throw new Error(`Unknown package manager: ${value}`);
+            }
+
+            result.packageManager = value;
+            continue;
+        }
+
+        if (arg.startsWith('-')) {
+            throw new Error(`Unknown option: ${arg}`);
+        }
+
+        if (!result.projectName) {
+            result.projectName = arg;
+            continue;
+        }
+
+        throw new Error(`Unexpected argument: ${arg}`);
+    }
+
+    return result;
+}