devstarter-tool 0.1.1 → 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

@@ -13,5 +13,6 @@ program
     .option('-t, --type <type>', 'Project type (frontend | backend)')
     .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')
     .action(initCommand);
 program.parse(process.argv);

package/dist/commands/init/collector.js

@@ -39,20 +39,22 @@ async function collectStructure(useDefaults) {
 }
 async function collectBasicContext(projectName, options, useDefaults) {
     const typeFromFlag = resolveProjectType(options.type);
+    const gitFlagProvided = options.git !== undefined;
     // Obtener tipo de proyecto e initGit
     let projectType;
     let initGit;
     if (useDefaults) {
         projectType = typeFromFlag ?? DEFAULT_INIT_OPTIONS.projectType;
-        initGit = DEFAULT_INIT_OPTIONS.initGit;
+        initGit = gitFlagProvided ? options.git : DEFAULT_INIT_OPTIONS.initGit;
     }
     else {
         const answers = await askInitQuestions({
             skipProjectName: true,
             skipProjectType: Boolean(typeFromFlag),
+            skipInitGit: gitFlagProvided,
         });
         projectType = typeFromFlag ?? answers.projectType;
-        initGit = answers.initGit;
+        initGit = gitFlagProvided ? options.git : answers.initGit;
     }
     // Obtener template
     const templates = listTemplates(projectType);
@@ -72,13 +74,14 @@ async function collectMonorepoContext(projectName, useDefaults, options) {
     // Templates para web (frontend) y api (backend)
     const frontendTemplates = listTemplates('frontend');
     const backendTemplates = listTemplates('backend');
+    const gitFlagProvided = options.git !== undefined;
     let webTemplate;
     let apiTemplate;
     let initGit;
     if (useDefaults) {
         webTemplate = frontendTemplates[0] ?? 'basic';
         apiTemplate = backendTemplates[0] ?? 'basic';
-        initGit = DEFAULT_INIT_OPTIONS.initGit;
+        initGit = gitFlagProvided ? options.git : DEFAULT_INIT_OPTIONS.initGit;
     }
     else {
         const webAnswer = await askTemplate({
@@ -91,8 +94,13 @@ async function collectMonorepoContext(projectName, useDefaults, options) {
             message: 'Template for apps/api (backend):',
         });
         apiTemplate = apiAnswer.template;
-        const gitAnswer = await askInitGit();
-        initGit = gitAnswer.initGit;
+        if (gitFlagProvided) {
+            initGit = options.git;
+        }
+        else {
+            const gitAnswer = await askInitGit();
+            initGit = gitAnswer.initGit;
+        }
     }
     return {
         structure: 'monorepo',

package/dist/prompts/initPrompts.js

@@ -48,12 +48,14 @@ export async function askInitQuestions(options = {}) {
             ],
         });
     }
-    questions.push({
-        type: 'confirm',
-        name: 'initGit',
-        message: 'Initialize a git repository?',
-        initial: true,
-    });
+    if (!options.skipInitGit) {
+        questions.push({
+            type: 'confirm',
+            name: 'initGit',
+            message: 'Initialize a git repository?',
+            initial: true,
+        });
+    }
     return prompts(questions, { onCancel });
 }
 export async function askTemplate(options) {

package/dist/templates/frontend/basic/index.html

@@ -0,0 +1,12 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>{{projectName}}</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.ts"></script>
+  </body>
+</html>

package/dist/templates/frontend/basic/package.json.tpl

@@ -1,7 +1,14 @@
 {
   "name": "{{projectName}}",
   "private": true,
+  "type": "module",
   "scripts": {
-    "dev": "echo \"TODO\""
+    "dev": "vite",
+    "build": "vite build",
+    "preview": "vite preview"
+  },
+  "devDependencies": {
+    "typescript": "^5.5.4",
+    "vite": "^5.4.0"
   }
 }

package/dist/templates/frontend/basic/src/main.ts

@@ -1 +1,6 @@
-console.log('Hello from {{projectName}}');
+const app = document.querySelector<HTMLDivElement>('#app')!;
+
+app.innerHTML = `
+  <h1>{{projectName}}</h1>
+  <p>Edit <code>src/main.ts</code> and save to see HMR in action.</p>
+`;

package/dist/templates/frontend/basic/tsconfig.json

@@ -0,0 +1,12 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "useDefineForClassFields": true,
+    "lib": ["DOM", "DOM.Iterable", "ES2020"],
+    "module": "ESNext",
+    "skipLibCheck": true,
+    "moduleResolution": "Bundler",
+    "strict": true
+  },
+  "include": ["src"]
+}

package/package.json

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