devstarter-tool 0.2.0 → 0.2.1

package/README.md

@@ -30,6 +30,8 @@ devstarter init [project-name]
 | `-t, --type <type>` | Project type: `frontend` or `backend` |
 | `--template <name>` | Template to use |
 | `--dry-run` | Preview changes without creating files |
+| `--no-git` | Skip git repository initialization |
+| `--no-vitest` | Skip Vitest testing framework setup |
 
 ### Examples
 
@@ -45,6 +47,12 @@ devstarter init my-app --type frontend -y
 
 # Preview what files would be created
 devstarter init my-app --type frontend --dry-run
+
+# Create project without git initialization
+devstarter init my-app --no-git
+
+# Create project without Vitest setup
+devstarter init my-app --no-vitest
 ```
 
 ## Project Structures
@@ -54,7 +62,10 @@ devstarter init my-app --type frontend --dry-run
 ```
 my-app/
 ├── src/
-│   └── main.ts (or main.tsx for React)
+│   ├── main.ts (or main.tsx for React)
+│   └── __tests__/
+│       └── example.test.ts
+├── vitest.config.ts
 ├── package.json
 ├── README.md
 └── .git/ (if git is initialized)
@@ -96,10 +107,28 @@ my-app/
 - Automatic package manager detection (npm, pnpm, yarn)
 - Interactive template selection
 - Optional Git repository initialization
+- Optional Vitest testing framework setup
 - Dry-run mode to preview changes
 - Automatic project name normalization (kebab-case)
 - Colored output for better readability
 
+## Testing Setup (Vitest)
+
+By default, projects are created with Vitest configured. This includes:
+
+- `vitest` as a dev dependency
+- `vitest.config.ts` configuration file
+- Example test file in `src/__tests__/example.test.ts`
+- `test` script in package.json
+
+For React projects, it also adds `jsdom` for DOM testing.
+
+To skip Vitest setup, use the `--no-vitest` flag:
+
+```bash
+devstarter init my-app --no-vitest
+```
+
 ## Development
 
 ### Requirements

package/dist/cli.js

@@ -14,6 +14,5 @@ program
     .option('--template <name>', 'Template variant (e.g. basic, react)')
     .option('--dry-run', 'Show what would be generated without creating files')
     .option('--no-git', 'Skip git repository initialization')
-    .option('--no-vitest', 'Skip Vitest testing framework')
     .action(initCommand);
 program.parse(process.argv);

package/dist/commands/init/collector.js

@@ -1,5 +1,5 @@
 import { DEFAULT_INIT_OPTIONS } from '../../types/project.js';
-import { askProjectName, askProjectStructure, askInitQuestions, askTemplate, askInitGit, askIncludeVitest, } from '../../prompts/initPrompts.js';
+import { askProjectName, askProjectStructure, askInitQuestions, askTemplate, askInitGit, } from '../../prompts/initPrompts.js';
 import { normalizeProjectName } from '../../utils/normalize.js';
 import { detectPackageManager } from '../../utils/detectPackageManager.js';
 import { listTemplates } from '../../utils/listTemplate.js';
@@ -40,26 +40,21 @@ async function collectStructure(useDefaults) {
 async function collectBasicContext(projectName, options, useDefaults) {
     const typeFromFlag = resolveProjectType(options.type);
     const gitFlagProvided = options.git !== undefined;
-    const vitestFlagProvided = options.vitest !== undefined;
-    // Obtener tipo de proyecto, initGit e includeVitest
+    // Obtener tipo de proyecto e initGit
     let projectType;
     let initGit;
-    let includeVitest;
     if (useDefaults) {
         projectType = typeFromFlag ?? DEFAULT_INIT_OPTIONS.projectType;
         initGit = gitFlagProvided ? options.git : DEFAULT_INIT_OPTIONS.initGit;
-        includeVitest = vitestFlagProvided ? options.vitest : DEFAULT_INIT_OPTIONS.includeVitest;
     }
     else {
         const answers = await askInitQuestions({
             skipProjectName: true,
             skipProjectType: Boolean(typeFromFlag),
             skipInitGit: gitFlagProvided,
-            skipVitest: vitestFlagProvided,
         });
         projectType = typeFromFlag ?? answers.projectType;
         initGit = gitFlagProvided ? options.git : answers.initGit;
-        includeVitest = vitestFlagProvided ? options.vitest : answers.includeVitest;
     }
     // Obtener template
     const templates = listTemplates(projectType);
@@ -71,7 +66,6 @@ async function collectBasicContext(projectName, options, useDefaults) {
         projectType,
         template,
         initGit,
-        includeVitest,
         packageManager: detectPackageManager(),
         isDryRun: Boolean(options.dryRun),
     };
@@ -81,16 +75,13 @@ async function collectMonorepoContext(projectName, useDefaults, options) {
     const frontendTemplates = listTemplates('frontend');
     const backendTemplates = listTemplates('backend');
     const gitFlagProvided = options.git !== undefined;
-    const vitestFlagProvided = options.vitest !== undefined;
     let webTemplate;
     let apiTemplate;
     let initGit;
-    let includeVitest;
     if (useDefaults) {
         webTemplate = frontendTemplates[0] ?? 'basic';
         apiTemplate = backendTemplates[0] ?? 'basic';
         initGit = gitFlagProvided ? options.git : DEFAULT_INIT_OPTIONS.initGit;
-        includeVitest = vitestFlagProvided ? options.vitest : DEFAULT_INIT_OPTIONS.includeVitest;
     }
     else {
         const webAnswer = await askTemplate({
@@ -110,13 +101,6 @@ async function collectMonorepoContext(projectName, useDefaults, options) {
             const gitAnswer = await askInitGit();
             initGit = gitAnswer.initGit;
         }
-        if (vitestFlagProvided) {
-            includeVitest = options.vitest;
-        }
-        else {
-            const vitestAnswer = await askIncludeVitest();
-            includeVitest = vitestAnswer.includeVitest;
-        }
     }
     return {
         structure: 'monorepo',
@@ -124,7 +108,6 @@ async function collectMonorepoContext(projectName, useDefaults, options) {
         webTemplate,
         apiTemplate,
         initGit,
-        includeVitest,
         packageManager: 'pnpm', // Monorepo usa pnpm por defecto
         isDryRun: Boolean(options.dryRun),
     };

package/dist/generators/createMonorepo.js

@@ -3,8 +3,7 @@ import path from 'node:path';
 import { getTemplatePath } from '../utils/getTemplatePath.js';
 import { copyTemplate } from '../utils/copyTemplate.js';
 import { initGitRepo } from '../utils/git.js';
-import { injectVitest } from '../utils/injectVitest.js';
-export async function createMonorepo({ projectName, webTemplate, apiTemplate, initGit, includeVitest, }) {
+export async function createMonorepo({ projectName, webTemplate, apiTemplate, initGit, }) {
     // 1. Resolver ruta absoluta del proyecto
     const projectRoot = path.resolve(process.cwd(), projectName);
     // 2. Evitar sobrescribir carpetas existentes
@@ -18,26 +17,18 @@ export async function createMonorepo({ projectName, webTemplate, apiTemplate, in
     // 4. Crear archivos de configuración del monorepo
     await createMonorepoConfig(projectRoot, projectName);
     // 5. Copiar template de frontend a apps/web
-    const webPath = path.join(projectRoot, 'apps', 'web');
     const webTemplatePath = getTemplatePath('frontend', webTemplate);
     if (await fs.pathExists(webTemplatePath)) {
-        await copyTemplate(webTemplatePath, webPath, {
+        await copyTemplate(webTemplatePath, path.join(projectRoot, 'apps', 'web'), {
             projectName: `${projectName}-web`,
         });
-        if (includeVitest) {
-            await injectVitest(webPath, 'frontend', webTemplate);
-        }
     }
     // 6. Copiar template de backend a apps/api
-    const apiPath = path.join(projectRoot, 'apps', 'api');
     const apiTemplatePath = getTemplatePath('backend', apiTemplate);
     if (await fs.pathExists(apiTemplatePath)) {
-        await copyTemplate(apiTemplatePath, apiPath, {
+        await copyTemplate(apiTemplatePath, path.join(projectRoot, 'apps', 'api'), {
             projectName: `${projectName}-api`,
         });
-        if (includeVitest) {
-            await injectVitest(apiPath, 'backend', apiTemplate);
-        }
     }
     // 7. Crear package shared básico
     await createSharedPackage(projectRoot, projectName);

package/dist/generators/createProject.js

@@ -3,8 +3,7 @@ import path from 'node:path';
 import { getTemplatePath } from '../utils/getTemplatePath.js';
 import { copyTemplate } from '../utils/copyTemplate.js';
 import { initGitRepo } from '../utils/git.js';
-import { injectVitest } from '../utils/injectVitest.js';
-export async function createProject({ projectName, projectType, template, initGit, includeVitest, }) {
+export async function createProject({ projectName, projectType, template, initGit, }) {
     // 1. Resolver ruta absoluta del proyecto
     const projectRoot = path.resolve(process.cwd(), projectName);
     // 2. Evitar sobrescribir carpetas existentes
@@ -22,11 +21,7 @@ export async function createProject({ projectName, projectType, template, initGi
     await copyTemplate(templatePath, projectRoot, {
         projectName,
     });
-    // 6. Inyectar Vitest (si aplica)
-    if (includeVitest) {
-        await injectVitest(projectRoot, projectType, template);
-    }
-    // 7. Inicializar Git (si aplica)
+    // 6. Inicializar Git (si aplica)
     if (initGit) {
         initGitRepo(projectRoot);
     }

package/dist/prompts/initPrompts.js

@@ -56,14 +56,6 @@ export async function askInitQuestions(options = {}) {
             initial: true,
         });
     }
-    if (!options.skipVitest) {
-        questions.push({
-            type: 'confirm',
-            name: 'includeVitest',
-            message: 'Include Vitest for testing?',
-            initial: true,
-        });
-    }
     return prompts(questions, { onCancel });
 }
 export async function askTemplate(options) {
@@ -88,11 +80,3 @@ export async function askInitGit() {
         initial: true,
     }, { onCancel });
 }
-export async function askIncludeVitest() {
-    return prompts({
-        type: 'confirm',
-        name: 'includeVitest',
-        message: 'Include Vitest for testing?',
-        initial: true,
-    }, { onCancel });
-}

package/dist/types/project.js

@@ -2,5 +2,4 @@ export const DEFAULT_INIT_OPTIONS = {
     projectStructure: 'basic',
     projectType: 'frontend',
     initGit: true,
-    includeVitest: true,
 };

package/dist/utils/printDryRun.js

@@ -12,8 +12,7 @@ export function printDryRun(context) {
     else {
         printBasicPlan(context);
     }
-    console.log(`${styles.info('- Git:')} ${context.initGit ? 'would initialize' : 'skipped'}`);
-    console.log(`${styles.info('- Vitest:')} ${context.includeVitest ? 'would add' : 'skipped'}\n`);
+    console.log(`${styles.info('- Git:')} ${context.initGit ? 'would initialize' : 'skipped'}\n`);
     console.log(styles.title('Next steps'));
     console.log(`  ${styles.highlight(`cd ${context.projectName}`)}`);
     console.log(`  ${styles.highlight(`${context.packageManager} install`)}`);

package/dist/utils/printSummary.js

@@ -11,8 +11,7 @@ export function printSummary(context) {
         console.log(`${styles.info('- Template:')} ${context.projectType}/${context.template}`);
     }
     console.log(`${styles.info('- Directory:')} ./${context.projectName}`);
-    console.log(`${styles.info('- Git:')} ${context.initGit ? styles.success('initialized') : styles.muted('not initialized')}`);
-    console.log(`${styles.info('- Vitest:')} ${context.includeVitest ? styles.success('added') : styles.muted('not included')}\n`);
+    console.log(`${styles.info('- Git:')} ${context.initGit ? styles.success('initialized') : styles.muted('not initialized')}\n`);
     console.log(styles.title('Next steps'));
     console.log(`  ${styles.highlight(`cd ${context.projectName}`)}`);
     console.log(`  ${styles.highlight(`${context.packageManager} install`)}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "devstarter-tool",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "type": "module",
   "description": "CLI to generate projects with best practices (basic or monorepo)",
   "author": "abraham-diaz",

package/dist/utils/injectVitest.js

@@ -1,68 +0,0 @@
-import fs from 'fs-extra';
-import path from 'node:path';
-const VITEST_CONFIG = `import { defineConfig } from 'vitest/config';
-
-export default defineConfig({
-  test: {
-    globals: true,
-  },
-});
-`;
-const VITEST_CONFIG_REACT = `import { defineConfig } from 'vitest/config';
-import react from '@vitejs/plugin-react';
-
-export default defineConfig({
-  plugins: [react()],
-  test: {
-    globals: true,
-    environment: 'jsdom',
-  },
-});
-`;
-function getExampleTest(projectType, template) {
-    if (projectType === 'frontend' && template === 'react') {
-        return `import { describe, it, expect } from 'vitest';
-
-describe('Example test', () => {
-  it('should pass', () => {
-    expect(1 + 1).toBe(2);
-  });
-});
-`;
-    }
-    return `import { describe, it, expect } from 'vitest';
-
-describe('Example test', () => {
-  it('should pass', () => {
-    expect(1 + 1).toBe(2);
-  });
-});
-`;
-}
-export async function injectVitest(projectRoot, projectType, template) {
-    // 1. Modificar package.json
-    const packageJsonPath = path.join(projectRoot, 'package.json');
-    const packageJson = await fs.readJson(packageJsonPath);
-    // Agregar script test
-    packageJson.scripts = packageJson.scripts || {};
-    packageJson.scripts.test = 'vitest';
-    // Agregar devDependencies
-    packageJson.devDependencies = packageJson.devDependencies || {};
-    packageJson.devDependencies.vitest = '^3.1.4';
-    // Para React, agregar jsdom
-    if (projectType === 'frontend' && template === 'react') {
-        packageJson.devDependencies.jsdom = '^26.1.0';
-    }
-    await fs.writeJson(packageJsonPath, packageJson, { spaces: 2 });
-    // 2. Crear vitest.config.ts
-    const vitestConfigPath = path.join(projectRoot, 'vitest.config.ts');
-    const configContent = projectType === 'frontend' && template === 'react'
-        ? VITEST_CONFIG_REACT
-        : VITEST_CONFIG;
-    await fs.writeFile(vitestConfigPath, configContent);
-    // 3. Crear test de ejemplo
-    const testDir = path.join(projectRoot, 'src', '__tests__');
-    await fs.ensureDir(testDir);
-    const testFilePath = path.join(testDir, 'example.test.ts');
-    await fs.writeFile(testFilePath, getExampleTest(projectType, template));
-}