create-react-starter-kit 1.0.0

package/dist/prompts/index.js

@@ -0,0 +1,267 @@
+import inquirer from 'inquirer';
+import path from 'node:path';
+import fs from 'fs-extra';
+import { resolveTargetDirectory, validateProjectName } from '../utils/validate.js';
+import { logger } from '../utils/logger.js';
+export async function collectAnswers() {
+    logger.title('🚀  create-react-starter-kit');
+    logger.dim('Answer each question. Press Enter to accept the default.\n');
+    const { projectName } = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'projectName',
+            message: 'What is your project name?',
+            default: 'my-react-app',
+            validate: validateProjectName,
+        },
+    ]);
+    const { targetPath } = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'targetPath',
+            message: 'Where should we create the project?',
+            default: `./${projectName}`,
+        },
+    ]);
+    const targetDir = resolveTargetDirectory(process.cwd(), projectName, targetPath);
+    if (await fs.pathExists(targetDir)) {
+        const entries = await fs.readdir(targetDir);
+        if (entries.length > 0) {
+            const { overwrite } = await inquirer.prompt([
+                {
+                    type: 'confirm',
+                    name: 'overwrite',
+                    message: `Directory ${path.relative(process.cwd(), targetDir) || '.'} is not empty. Overwrite?`,
+                    default: false,
+                },
+            ]);
+            if (!overwrite) {
+                throw new Error('Aborted: target directory already exists and was not overwritten.');
+            }
+        }
+    }
+    const stack = await inquirer.prompt([
+        {
+            type: 'list',
+            name: 'buildTool',
+            message: 'What build tool do you want to use?',
+            choices: [
+                { name: 'Vite', value: 'vite' },
+                { name: 'Webpack', value: 'webpack' },
+                { name: 'Rspack', value: 'rspack' },
+                { name: 'Parcel', value: 'parcel' },
+                { name: 'esbuild', value: 'esbuild' },
+                { name: 'Rollup', value: 'rollup' },
+            ],
+            default: 'vite',
+        },
+        {
+            type: 'list',
+            name: 'language',
+            message: 'What language do you want to choose?',
+            choices: [
+                { name: 'JavaScript', value: 'javascript' },
+                { name: 'TypeScript', value: 'typescript' },
+            ],
+            default: 'typescript',
+        },
+        {
+            type: 'list',
+            name: 'router',
+            message: 'What routing library do you want to use?',
+            choices: [
+                { name: 'React Router (react-router-dom)', value: 'react-router' },
+                { name: 'TanStack Router', value: 'tanstack-router' },
+            ],
+            default: 'react-router',
+        },
+        {
+            type: 'list',
+            name: 'stateManagement',
+            message: 'What state management library do you want to use?',
+            choices: [
+                { name: 'Redux Toolkit (RTK)', value: 'redux' },
+                { name: 'Zustand', value: 'zustand' },
+                { name: 'Jotai', value: 'jotai' },
+                { name: 'Context API + useReducer', value: 'context' },
+                { name: 'None', value: 'none' },
+            ],
+            default: 'redux',
+        },
+        {
+            type: 'list',
+            name: 'serverState',
+            message: 'Server State / Data Fetching?',
+            choices: (answers) => {
+                const choices = [
+                    { name: 'TanStack Query', value: 'tanstack-query' },
+                    { name: 'SWR', value: 'swr' },
+                    { name: 'None', value: 'none' },
+                ];
+                if (answers.stateManagement === 'redux') {
+                    choices.splice(2, 0, { name: 'RTK Query', value: 'rtk-query' });
+                }
+                return choices;
+            },
+            default: (answers) => answers.stateManagement === 'redux' ? 'rtk-query' : 'tanstack-query',
+        },
+        {
+            type: 'list',
+            name: 'forms',
+            message: 'Forms?',
+            choices: [
+                { name: 'React Hook Form', value: 'react-hook-form' },
+                { name: 'Formik', value: 'formik' },
+                { name: 'TanStack Form', value: 'tanstack-form' },
+                { name: 'None', value: 'none' },
+            ],
+            default: 'react-hook-form',
+        },
+        {
+            type: 'list',
+            name: 'validation',
+            message: 'Schema Validation?',
+            choices: [
+                { name: 'Zod', value: 'zod' },
+                { name: 'Yup', value: 'yup' },
+                { name: 'Valibot', value: 'valibot' },
+                { name: 'Joi', value: 'joi' },
+                { name: 'None', value: 'none' },
+            ],
+            default: 'zod',
+        },
+        {
+            type: 'list',
+            name: 'styling',
+            message: 'Styling?',
+            choices: [
+                { name: 'Tailwind CSS', value: 'tailwind' },
+                { name: 'CSS Modules', value: 'css-modules' },
+                { name: 'Styled Components', value: 'styled-components' },
+                { name: 'Sass/SCSS', value: 'sass' },
+            ],
+            default: 'tailwind',
+        },
+        {
+            type: 'list',
+            name: 'uiLibrary',
+            message: 'UI Component Libraries?',
+            choices: [
+                { name: 'MUI (Material UI)', value: 'mui' },
+                { name: 'Ant Design', value: 'antd' },
+                { name: 'Chakra UI', value: 'chakra' },
+                { name: 'shadcn/ui', value: 'shadcn' },
+                { name: 'Headless UI', value: 'headless-ui' },
+                { name: 'None', value: 'none' },
+            ],
+            default: 'shadcn',
+        },
+        {
+            type: 'list',
+            name: 'unitTesting',
+            message: 'Unit Testing?',
+            choices: [
+                { name: 'Vitest', value: 'vitest' },
+                { name: 'Jest', value: 'jest' },
+                { name: 'React Testing Library (RTL) only', value: 'rtl' },
+                { name: 'None', value: 'none' },
+            ],
+            default: 'vitest',
+        },
+        {
+            type: 'list',
+            name: 'e2eTesting',
+            message: 'E2E Testing?',
+            choices: [
+                { name: 'Playwright', value: 'playwright' },
+                { name: 'Cypress', value: 'cypress' },
+                { name: 'None', value: 'none' },
+            ],
+            default: 'playwright',
+        },
+        {
+            type: 'list',
+            name: 'visualTesting',
+            message: 'Component Dev / Visual Testing?',
+            choices: [
+                { name: 'Storybook', value: 'storybook' },
+                { name: 'Chromatic', value: 'chromatic' },
+                { name: 'None', value: 'none' },
+            ],
+            default: 'storybook',
+        },
+        {
+            type: 'list',
+            name: 'linting',
+            message: 'Linting / Formatting?',
+            choices: [
+                { name: 'ESLint', value: 'eslint' },
+                { name: 'Biome', value: 'biome' },
+            ],
+            default: 'eslint',
+        },
+        {
+            type: 'list',
+            name: 'formatting',
+            message: 'Formatting?',
+            choices: [
+                { name: 'Prettier', value: 'prettier' },
+                { name: 'Stylelint', value: 'stylelint' },
+            ],
+            default: 'prettier',
+        },
+        {
+            type: 'list',
+            name: 'apiLayer',
+            message: 'API Layer?',
+            choices: [
+                { name: 'REST via Axios', value: 'axios' },
+                { name: 'REST via Fetch', value: 'fetch' },
+            ],
+            default: 'axios',
+        },
+        {
+            type: 'list',
+            name: 'packageManager',
+            message: 'Package Manager?',
+            choices: [
+                { name: 'pnpm', value: 'pnpm' },
+                { name: 'yarn', value: 'yarn' },
+                { name: 'npm workspaces', value: 'npm' },
+            ],
+            default: 'pnpm',
+        },
+        {
+            type: 'list',
+            name: 'errorTracking',
+            message: 'Error Tracking / Monitoring?',
+            choices: [
+                { name: 'Sentry', value: 'sentry' },
+                { name: 'Bugsnag', value: 'bugsnag' },
+                { name: 'LogRocket', value: 'logrocket' },
+                { name: 'Datadog RUM', value: 'datadog' },
+                { name: 'None', value: 'none' },
+            ],
+            default: 'sentry',
+        },
+    ]);
+    // Safety: RTK Query requires Redux Toolkit
+    if (stack.serverState === 'rtk-query' && stack.stateManagement !== 'redux') {
+        stack.serverState = 'tanstack-query';
+    }
+    const { installDependencies } = await inquirer.prompt([
+        {
+            type: 'confirm',
+            name: 'installDependencies',
+            message: 'Install dependencies now?',
+            default: true,
+        },
+    ]);
+    return {
+        projectName,
+        targetDir,
+        ...stack,
+        installDependencies,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,UAAU,CAAC;AAChC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,UAAU,CAAC;AAE1B,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AACnF,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,MAAM,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAC7C,MAAM,CAAC,GAAG,CAAC,4DAA4D,CAAC,CAAC;IAEzE,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,QAAQ,CAAC,MAAM,CAA0B;QACrE;YACE,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,aAAa;YACnB,OAAO,EAAE,4BAA4B;YACrC,OAAO,EAAE,cAAc;YACvB,QAAQ,EAAE,mBAAmB;SAC9B;KACF,CAAC,CAAC;IAEH,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAyB;QACnE;YACE,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,YAAY;YAClB,OAAO,EAAE,qCAAqC;YAC9C,OAAO,EAAE,KAAK,WAAW,EAAE;SAC5B;KACF,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,sBAAsB,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;IAEjF,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC5C,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAyB;gBAClE;oBACE,IAAI,EAAE,SAAS;oBACf,IAAI,EAAE,WAAW;oBACjB,OAAO,EAAE,aAAa,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,IAAI,GAAG,2BAA2B;oBAC/F,OAAO,EAAE,KAAK;iBACf;aACF,CAAC,CAAC;YAEH,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAC;YACvF,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,MAAM,CAEjC;QACA;YACE,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,qCAAqC;YAC9C,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE;gBAC/B,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;gBACrC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE;gBACnC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE;gBACnC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;gBACrC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE;aACpC;YACD,OAAO,EAAE,MAAM;SAChB;QACD;YACE,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,sCAAsC;YAC/C,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE;gBAC3C,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE;aAC5C;YACD,OAAO,EAAE,YAAY;SACtB;QACD;YACE,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,0CAA0C;YACnD,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,iCAAiC,EAAE,KAAK,EAAE,cAAc,EAAE;gBAClE,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,iBAAiB,EAAE;aACtD;YACD,OAAO,EAAE,cAAc;SACxB;QACD;YACE,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,iBAAiB;YACvB,OAAO,EAAE,mDAAmD;YAC5D,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE;gBAC/C,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;gBACrC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE;gBACjC,EAAE,IAAI,EAAE,0BAA0B,EAAE,KAAK,EAAE,SAAS,EAAE;gBACtD,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE;aAChC;YACD,OAAO,EAAE,OAAO;SACjB;QACD;YACE,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,aAAa;YACnB,OAAO,EAAE,+BAA+B;YACxC,OAAO,EAAE,CAAC,OAAqC,EAAE,EAAE;gBACjD,MAAM,OAAO,GAAG;oBACd,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,gBAAgB,EAAE;oBACnD,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE;oBAC7B,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE;iBAChC,CAAC;gBACF,IAAI,OAAO,CAAC,eAAe,KAAK,OAAO,EAAE,CAAC;oBACxC,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;gBAClE,CAAC;gBACD,OAAO,OAAO,CAAC;YACjB,CAAC;YACD,OAAO,EAAE,CAAC,OAAqC,EAAE,EAAE,CACjD,OAAO,CAAC,eAAe,KAAK,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,gBAAgB;SACvE;QACD;YACE,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,QAAQ;YACjB,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,iBAAiB,EAAE;gBACrD,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE;gBACnC,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,eAAe,EAAE;gBACjD,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE;aAChC;YACD,OAAO,EAAE,iBAAiB;SAC3B;QACD;YACE,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,YAAY;YAClB,OAAO,EAAE,oBAAoB;YAC7B,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE;gBAC7B,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE;gBAC7B,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;gBACrC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE;gBAC7B,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE;aAChC;YACD,OAAO,EAAE,KAAK;SACf;QACD;YACE,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,UAAU;YACnB,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,UAAU,EAAE;gBAC3C,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE;gBAC7C,EAAE,IAAI,EAAE,mBAAmB,EAAE,KAAK,EAAE,mBAAmB,EAAE;gBACzD,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE;aACrC;YACD,OAAO,EAAE,UAAU;SACpB;QACD;YACE,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,yBAAyB;YAClC,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,mBAAmB,EAAE,KAAK,EAAE,KAAK,EAAE;gBAC3C,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE;gBACrC,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE;gBACtC,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE;gBACtC,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE;gBAC7C,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE;aAChC;YACD,OAAO,EAAE,QAAQ;SAClB;QACD;YACE,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,aAAa;YACnB,OAAO,EAAE,eAAe;YACxB,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE;gBACnC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE;gBAC/B,EAAE,IAAI,EAAE,kCAAkC,EAAE,KAAK,EAAE,KAAK,EAAE;gBAC1D,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE;aAChC;YACD,OAAO,EAAE,QAAQ;SAClB;QACD;YACE,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,YAAY;YAClB,OAAO,EAAE,cAAc;YACvB,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE;gBAC3C,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;gBACrC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE;aAChC;YACD,OAAO,EAAE,YAAY;SACtB;QACD;YACE,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,eAAe;YACrB,OAAO,EAAE,iCAAiC;YAC1C,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE;gBACzC,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE;gBACzC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE;aAChC;YACD,OAAO,EAAE,WAAW;SACrB;QACD;YACE,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,uBAAuB;YAChC,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE;gBACnC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE;aAClC;YACD,OAAO,EAAE,QAAQ;SAClB;QACD;YACE,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,YAAY;YAClB,OAAO,EAAE,aAAa;YACtB,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE;gBACvC,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE;aAC1C;YACD,OAAO,EAAE,UAAU;SACpB;QACD;YACE,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,YAAY;YACrB,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,OAAO,EAAE;gBAC1C,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,OAAO,EAAE;aAC3C;YACD,OAAO,EAAE,OAAO;SACjB;QACD;YACE,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,gBAAgB;YACtB,OAAO,EAAE,kBAAkB;YAC3B,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE;gBAC/B,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE;gBAC/B,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,KAAK,EAAE;aACzC;YACD,OAAO,EAAE,MAAM;SAChB;QACD;YACE,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,eAAe;YACrB,OAAO,EAAE,8BAA8B;YACvC,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE;gBACnC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;gBACrC,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE;gBACzC,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,SAAS,EAAE;gBACzC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE;aAChC;YACD,OAAO,EAAE,QAAQ;SAClB;KACF,CAAC,CAAC;IAEH,2CAA2C;IAC3C,IAAI,KAAK,CAAC,WAAW,KAAK,WAAW,IAAI,KAAK,CAAC,eAAe,KAAK,OAAO,EAAE,CAAC;QAC3E,KAAK,CAAC,WAAW,GAAG,gBAAgB,CAAC;IACvC,CAAC;IAED,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM,QAAQ,CAAC,MAAM,CAElD;QACD;YACE,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,qBAAqB;YAC3B,OAAO,EAAE,2BAA2B;YACpC,OAAO,EAAE,IAAI;SACd;KACF,CAAC,CAAC;IAEH,OAAO;QACL,WAAW;QACX,SAAS;QACT,GAAG,KAAK;QACR,mBAAmB;KACpB,CAAC;AACJ,CAAC"}

package/dist/templates/.env.example.ejs

@@ -0,0 +1,21 @@
+# API
+VITE_API_BASE_URL=https://jsonplaceholder.typicode.com
+
+<% if (errorTracking === 'sentry') { -%>
+# Sentry
+VITE_SENTRY_DSN=
+<% } -%>
+<% if (errorTracking === 'bugsnag') { -%>
+# Bugsnag
+VITE_BUGSNAG_API_KEY=
+<% } -%>
+<% if (errorTracking === 'logrocket') { -%>
+# LogRocket
+VITE_LOGROCKET_APP_ID=
+<% } -%>
+<% if (errorTracking === 'datadog') { -%>
+# Datadog RUM
+VITE_DATADOG_APPLICATION_ID=
+VITE_DATADOG_CLIENT_TOKEN=
+VITE_DATADOG_SITE=datadoghq.com
+<% } -%>

package/dist/templates/.husky/commit-msg

@@ -0,0 +1,2 @@
+#!/usr/bin/env sh
+npx --no -- commitlint --edit "$1"

package/dist/templates/.husky/pre-commit

@@ -0,0 +1,2 @@
+#!/usr/bin/env sh
+npx lint-staged

package/dist/templates/README.md.ejs

@@ -0,0 +1,169 @@
+# <%= projectName %>
+
+Production-ready React starter generated by **create-react-starter-kit**.
+
+## Overview
+
+This app ships with a curated stack chosen during scaffolding, a working demo page, and documentation so you can extend the project without re-wiring libraries by hand.
+
+## Selected stack
+
+| Area | Choice |
+|------|--------|
+| Build tool | <%= stackLabels.buildTool %> |
+| Language | <%= stackLabels.language %> |
+| Routing | <%= stackLabels.router %> |
+| State | <%= stackLabels.stateManagement %> |
+| Server state | <%= stackLabels.serverState %> |
+| Forms | <%= stackLabels.forms %> |
+| Validation | <%= stackLabels.validation %> |
+| Styling | <%= stackLabels.styling %> |
+| UI library | <%= stackLabels.uiLibrary %> |
+| Unit tests | <%= stackLabels.unitTesting %> |
+| E2E tests | <%= stackLabels.e2eTesting %> |
+| Visual | <%= stackLabels.visualTesting %> |
+| Linting | <%= stackLabels.linting %> |
+| Formatting | <%= stackLabels.formatting %> |
+| API layer | <%= stackLabels.apiLayer %> |
+| Package manager | <%= stackLabels.packageManager %> |
+| Error tracking | <%= stackLabels.errorTracking %> |
+| Git hooks | Husky + lint-staged + commitlint |
+| Structure | Feature-based (domain-driven) + `@/` aliases |
+
+## Quick start
+
+```bash
+<% if (packageManager === 'pnpm') { -%>
+pnpm install
+pnpm dev
+<% } else if (packageManager === 'yarn') { -%>
+yarn
+yarn dev
+<% } else { -%>
+npm install
+npm run dev
+<% } -%>
+```
+
+Open the URL printed in the terminal (typically `http://localhost:5173`).
+
+## Environment setup
+
+1. Copy `.env.example` to `.env`.
+2. Fill in API and monitoring keys as needed.
+3. Never commit secrets — `.env` is gitignored.
+
+| Variable | Purpose |
+|----------|---------|
+| `VITE_API_BASE_URL` | REST API base URL |
+<% if (errorTracking === 'sentry') { -%>
+| `VITE_SENTRY_DSN` | Sentry DSN |
+<% } -%>
+<% if (errorTracking === 'bugsnag') { -%>
+| `VITE_BUGSNAG_API_KEY` | Bugsnag API key |
+<% } -%>
+<% if (errorTracking === 'logrocket') { -%>
+| `VITE_LOGROCKET_APP_ID` | LogRocket app id |
+<% } -%>
+<% if (errorTracking === 'datadog') { -%>
+| `VITE_DATADOG_APPLICATION_ID` | Datadog application id |
+| `VITE_DATADOG_CLIENT_TOKEN` | Datadog client token |
+<% } -%>
+
+## Folder structure
+
+```text
+src/
+  app/           # App shell, providers, bootstrap
+  assets/        # Images / media imported from code
+  components/    # Shared UI (layout/, ui/)
+  config/        # Env helpers / app config
+  features/      # Domain modules (scalable default)
+  hooks/         # Shared hooks
+  lib/           # Third-party wrappers / helpers
+  routes/        # Route-level pages
+  store/         # Client state
+  services/      # API clients
+  styles/        # Global styles
+  types/         # Shared types
+  utils/         # Pure helpers
+docs/            # Architecture & usage docs
+tests/           # Extra test helpers / e2e
+```
+
+Organization: **feature-based / domain-driven** with `@/` path aliases. See `docs/architecture.md`.
+
+## Scripts
+
+| Script | Description |
+|--------|-------------|
+| `dev` | Start development server |
+| `build` | Production build |
+<% if (unitTesting !== 'none') { -%>
+| `test` | Unit tests |
+<% } -%>
+<% if (e2eTesting !== 'none') { -%>
+| `test:e2e` | End-to-end tests |
+<% } -%>
+| `lint` | Lint the codebase |
+| `format` | Format sources |
+<% if (visualTesting === 'storybook') { -%>
+| `storybook` | Component workshop |
+<% } -%>
+
+## Technology explanations
+
+Each selected library includes:
+
+- a live example on the home/demo page
+- a short doc under `docs/examples/`
+- when-to-use guidance and a best-practice note
+
+Start with `docs/selected-stack.md` and `docs/getting-started.md`.
+
+## Example usage
+
+The demo page (`/`) shows:
+
+- navigation + layout
+<% if (stateManagement !== 'none') { -%>
+- client state (<%= stackLabels.stateManagement %>)
+<% } -%>
+<% if (serverState !== 'none') { -%>
+- data fetching (<%= stackLabels.serverState %>)
+<% } -%>
+<% if (forms !== 'none') { -%>
+- forms (<%= stackLabels.forms %>)
+<% } -%>
+<% if (validation !== 'none') { -%>
+- validation (<%= stackLabels.validation %>)
+<% } -%>
+- styling (<%= stackLabels.styling %>)
+<% if (uiLibrary !== 'none') { -%>
+- UI primitives (<%= stackLabels.uiLibrary %>)
+<% } -%>
+- API integration (<%= stackLabels.apiLayer %>)
+
+## Production best practices
+
+- Keep secrets out of the client bundle; only expose `VITE_*` (or equivalent) public vars.
+- Prefer feature folders for domain logic; keep `components/` shared and dumb.
+- Gate monitoring behind environment checks.
+- Run lint + unit + e2e in CI before merge.
+- See `docs/best-practices.md` for deeper guidance.
+
+## Troubleshooting
+
+| Issue | Fix |
+|-------|-----|
+| Port in use | Change the port in your build tool config or kill the process |
+| Module not found | Re-run install with <%= packageManager %> |
+| Env vars undefined | Restart the dev server after editing `.env` |
+| Tailwind classes missing | Confirm `content` paths in `tailwind.config` |
+| Type errors | Run `<%= packageManager === 'npm' ? 'npx' : packageManager %> tsc --noEmit` |
+
+More help: `docs/getting-started.md`.
+
+---
+
+Generated with [create-react-starter-kit](https://www.npmjs.com/package/create-react-starter-kit) · <%= year %>

package/dist/templates/__js__/jsconfig.json

@@ -0,0 +1,9 @@
+{
+  "compilerOptions": {
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["src/*"]
+    }
+  },
+  "include": ["src", "tests"]
+}

package/dist/templates/__ts__/src/vite-env.d.ts

@@ -0,0 +1,16 @@
+/// <reference types="vite/client" />
+
+interface ImportMetaEnv {
+  readonly VITE_API_BASE_URL?: string;
+  readonly VITE_SENTRY_DSN?: string;
+  readonly VITE_BUGSNAG_API_KEY?: string;
+  readonly VITE_LOGROCKET_APP_ID?: string;
+  readonly VITE_DATADOG_APPLICATION_ID?: string;
+  readonly VITE_DATADOG_CLIENT_TOKEN?: string;
+  readonly VITE_DATADOG_SITE?: string;
+  readonly MODE?: string;
+}
+
+interface ImportMeta {
+  readonly env: ImportMetaEnv;
+}

package/dist/templates/__ts__/tsconfig.json

@@ -0,0 +1,24 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "useDefineForClassFields": true,
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "skipLibCheck": true,
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "noEmit": true,
+    "jsx": "react-jsx",
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true,
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["src/*"]
+    }
+  },
+  "include": ["src", "tests"]
+}

package/dist/templates/__when_buildTool_esbuild__/scripts/esbuild.build.mjs.ejs

@@ -0,0 +1,23 @@
+import path from 'node:path';
+import * as esbuild from 'esbuild';
+
+await esbuild.build({
+  entryPoints: ['src/main.<%= jsxExt %>'],
+  bundle: true,
+  outfile: 'dist/main.js',
+  format: 'esm',
+  minify: true,
+  sourcemap: true,
+  alias: {
+    '@': path.resolve('src'),
+  },
+  loader: {
+    '.<%= jsxExt %>': '<%= isTypeScript ? 'tsx' : 'jsx' %>',
+    '.css': 'css',
+  },
+  define: {
+    'process.env.NODE_ENV': '"production"',
+  },
+});
+
+console.log('Built dist/main.js');

package/dist/templates/__when_buildTool_esbuild__/scripts/esbuild.dev.mjs.ejs

@@ -0,0 +1,48 @@
+import * as esbuild from 'esbuild';
+import { createServer } from 'node:http';
+import { readFileSync, existsSync } from 'node:fs';
+import path from 'node:path';
+
+const ctx = await esbuild.context({
+  entryPoints: ['src/main.<%= jsxExt %>'],
+  bundle: true,
+  outfile: 'dist/main.js',
+  format: 'esm',
+  sourcemap: true,
+  alias: {
+    '@': path.resolve('src'),
+  },
+  loader: {
+    '.<%= jsxExt %>': '<%= isTypeScript ? 'tsx' : 'jsx' %>',
+    '.css': 'css',
+  },
+  define: {
+    'process.env.NODE_ENV': '"development"',
+  },
+});
+
+await ctx.watch();
+
+const server = createServer((req, res) => {
+  const url = req.url === '/' ? '/index.html' : req.url;
+  const filePath = path.join(process.cwd(), url.startsWith('/dist') ? '.' : '', url === '/index.html' ? 'index.html' : url.slice(1));
+  const resolved = url === '/index.html' ? path.join(process.cwd(), 'index.html') : path.join(process.cwd(), url.slice(1));
+  if (!existsSync(resolved)) {
+    res.writeHead(404);
+    res.end('Not found');
+    return;
+  }
+  const content = readFileSync(resolved);
+  const type = resolved.endsWith('.js')
+    ? 'text/javascript'
+    : resolved.endsWith('.css')
+      ? 'text/css'
+      : 'text/html';
+  res.writeHead(200, { 'Content-Type': type });
+  res.end(content);
+  void filePath;
+});
+
+server.listen(5173, () => {
+  console.log('esbuild app at http://localhost:5173');
+});

package/dist/templates/__when_buildTool_parcel__/.parcelrc

@@ -0,0 +1,9 @@
+{
+  "extends": "parcel-bundler/lib/utils",
+  "source": "index.html",
+  "targets": {
+    "default": {
+      "distDir": "./dist"
+    }
+  }
+}

package/dist/templates/__when_buildTool_rollup__/rollup.config.js.ejs

@@ -0,0 +1,33 @@
+import path from 'node:path';
+import alias from '@rollup/plugin-alias';
+import resolve from '@rollup/plugin-node-resolve';
+import commonjs from '@rollup/plugin-commonjs';
+import replace from '@rollup/plugin-replace';
+<% if (isTypeScript) { -%>
+import typescript from '@rollup/plugin-typescript';
+<% } -%>
+import postcss from 'rollup-plugin-postcss';
+
+export default {
+  input: 'src/main.<%= jsxExt %>',
+  output: {
+    file: 'dist/main.js',
+    format: 'esm',
+    sourcemap: true,
+  },
+  plugins: [
+    alias({
+      entries: [{ find: '@', replacement: path.resolve('src') }],
+    }),
+    replace({
+      preventAssignment: true,
+      'process.env.NODE_ENV': JSON.stringify(process.env.NODE_ENV || 'development'),
+    }),
+    resolve({ browser: true, extensions: ['.<%= jsxExt %>', '.<%= ext %>', '.js', '.jsx'] }),
+    commonjs(),
+<% if (isTypeScript) { -%>
+    typescript({ tsconfig: './tsconfig.json' }),
+<% } -%>
+    postcss({ extract: true }),
+  ],
+};