devstarter-tool 0.2.3 → 0.3.0

package/README.md

@@ -5,7 +5,7 @@ CLI to generate projects with best practices and predefined configurations.
 ## Features
 
 - **Project scaffolding**: Create frontend, backend, or monorepo projects in seconds
-- **`add` command**: Add features like ESLint, Vitest, and Prettier to existing projects
+- **`add` command**: Add features like ESLint, Vitest, Prettier, CI, Docker, and Tailwind CSS to existing projects
 - **Interactive prompts**: Guided project creation or flag-based configuration
 - **Automatic dependency installation**: No need to run `npm install` manually
 - **Package manager detection**: Automatically uses npm, pnpm, or yarn
@@ -39,6 +39,9 @@ devstarter init my-app --type frontend --vitest
 # Add features to an existing project
 devstarter add prettier
 devstarter add eslint
+devstarter add tailwind
+devstarter add docker
+devstarter add ci
 
 # Preview without creating files
 devstarter init my-app --dry-run
@@ -107,6 +110,9 @@ devstarter add [feature] [options]
 | `eslint` | Linter for JavaScript and TypeScript | `eslint.config.js`, lint script, ESLint + typescript-eslint deps |
 | `vitest` | Unit testing framework | `vitest.config.ts`, test scripts, Vitest dep |
 | `prettier` | Code formatter | `.prettierrc`, format script, Prettier dep |
+| `ci` | CI/CD pipeline | GitHub Actions workflow (`.github/workflows/ci.yml`) or GitLab CI (`.gitlab-ci.yml`) with lint, test, and build steps |
+| `docker` | Docker containerization | `Dockerfile` (multi-stage build), `docker-compose.yml`, `.dockerignore`. Auto-detects frontend (nginx) vs backend (node) |
+| `tailwind` | Tailwind CSS v4 | `tailwindcss` + `@tailwindcss/vite` deps, Vite plugin config, `@import "tailwindcss"` in CSS |
 
 #### Examples
 
@@ -115,6 +121,9 @@ devstarter add [feature] [options]
 devstarter add prettier
 devstarter add eslint
 devstarter add vitest
+devstarter add tailwind
+devstarter add docker
+devstarter add ci
 
 # Interactive mode - choose from available features
 devstarter add

package/dist/commands/add/registry.js

@@ -1,7 +1,17 @@
 import { eslintFeature } from '../../features/eslint.js';
 import { vitestFeature } from '../../features/vitest.js';
 import { prettierFeature } from '../../features/prettier.js';
-const features = [eslintFeature, vitestFeature, prettierFeature];
+import { ciFeature } from '../../features/ci.js';
+import { dockerFeature } from '../../features/docker.js';
+import { tailwindFeature } from '../../features/tailwind.js';
+const features = [
+    eslintFeature,
+    vitestFeature,
+    prettierFeature,
+    ciFeature,
+    dockerFeature,
+    tailwindFeature,
+];
 const featureMap = new Map(features.map((f) => [f.id, f]));
 export function getAvailableFeatureIds() {
     return features.map((f) => f.id);

package/dist/features/ci.js

@@ -0,0 +1,158 @@
+import fs from 'fs-extra';
+import path from 'node:path';
+import prompts from 'prompts';
+async function detect(context) {
+    // Check for GitLab CI
+    if (await fs.pathExists(path.join(context.root, '.gitlab-ci.yml'))) {
+        return true;
+    }
+    // Check for GitHub Actions (directory must exist and contain at least one .yml)
+    const workflowsDir = path.join(context.root, '.github', 'workflows');
+    if (await fs.pathExists(workflowsDir)) {
+        const files = await fs.readdir(workflowsDir);
+        if (files.some((f) => f.endsWith('.yml') || f.endsWith('.yaml'))) {
+            return true;
+        }
+    }
+    return false;
+}
+function getInstallCommand(context) {
+    switch (context.packageManager) {
+        case 'pnpm':
+            return 'pnpm install --frozen-lockfile';
+        case 'yarn':
+            return 'yarn install --frozen-lockfile';
+        default:
+            return 'npm ci';
+    }
+}
+function getRunCommand(context, script) {
+    switch (context.packageManager) {
+        case 'pnpm':
+            return `pnpm run ${script}`;
+        case 'yarn':
+            return `yarn ${script}`;
+        default:
+            return `npm run ${script}`;
+    }
+}
+function getScripts(packageJson) {
+    return packageJson.scripts ?? {};
+}
+function generateGitHubWorkflow(context) {
+    const scripts = getScripts(context.packageJson);
+    const installCmd = getInstallCommand(context);
+    const steps = [
+        '      - uses: actions/checkout@v4',
+        '      - uses: actions/setup-node@v4',
+        '        with:',
+        '          node-version: 20',
+        `      - run: ${installCmd}`,
+    ];
+    if (scripts.lint) {
+        steps.push(`      - run: ${getRunCommand(context, 'lint')}`);
+    }
+    if (scripts.test) {
+        steps.push(`      - run: ${getRunCommand(context, 'test')}`);
+    }
+    if (scripts.build) {
+        steps.push(`      - run: ${getRunCommand(context, 'build')}`);
+    }
+    return `name: CI
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+jobs:
+  ci:
+    runs-on: ubuntu-latest
+    steps:
+${steps.join('\n')}
+`;
+}
+function generateGitLabCI(context) {
+    const scripts = getScripts(context.packageJson);
+    const installCmd = getInstallCommand(context);
+    let config = `stages:
+  - install
+  - lint
+  - test
+  - build
+
+install:
+  stage: install
+  image: node:20-alpine
+  script:
+    - ${installCmd}
+  cache:
+    paths:
+      - node_modules/
+`;
+    if (scripts.lint) {
+        config += `
+lint:
+  stage: lint
+  image: node:20-alpine
+  script:
+    - ${getRunCommand(context, 'lint')}
+  cache:
+    paths:
+      - node_modules/
+`;
+    }
+    if (scripts.test) {
+        config += `
+test:
+  stage: test
+  image: node:20-alpine
+  script:
+    - ${getRunCommand(context, 'test')}
+  cache:
+    paths:
+      - node_modules/
+`;
+    }
+    if (scripts.build) {
+        config += `
+build:
+  stage: build
+  image: node:20-alpine
+  script:
+    - ${getRunCommand(context, 'build')}
+  cache:
+    paths:
+      - node_modules/
+`;
+    }
+    return config;
+}
+async function apply(context) {
+    const { provider } = await prompts({
+        type: 'select',
+        name: 'provider',
+        message: 'Which CI provider?',
+        choices: [
+            { title: 'GitHub Actions', value: 'github' },
+            { title: 'GitLab CI', value: 'gitlab' },
+        ],
+    });
+    if (!provider) {
+        throw new Error('CI provider selection cancelled');
+    }
+    if (provider === 'github') {
+        const workflowDir = path.join(context.root, '.github', 'workflows');
+        await fs.ensureDir(workflowDir);
+        await fs.writeFile(path.join(workflowDir, 'ci.yml'), generateGitHubWorkflow(context));
+    }
+    else {
+        await fs.writeFile(path.join(context.root, '.gitlab-ci.yml'), generateGitLabCI(context));
+    }
+}
+export const ciFeature = {
+    id: 'ci',
+    name: 'CI',
+    description: 'Continuous integration with GitHub Actions or GitLab CI',
+    detect,
+    apply,
+};

package/dist/features/docker.js

@@ -0,0 +1,97 @@
+import fs from 'fs-extra';
+import path from 'node:path';
+async function detect(context) {
+    const configFiles = [
+        'Dockerfile',
+        'docker-compose.yml',
+        'docker-compose.yaml',
+        'compose.yml',
+        'compose.yaml',
+    ];
+    for (const file of configFiles) {
+        if (await fs.pathExists(path.join(context.root, file))) {
+            return true;
+        }
+    }
+    return false;
+}
+function isFrontend(packageJson) {
+    const deps = {
+        ...(packageJson.dependencies ?? {}),
+        ...(packageJson.devDependencies ?? {}),
+    };
+    return 'vite' in deps;
+}
+function getInstallCommand(context) {
+    switch (context.packageManager) {
+        case 'pnpm':
+            return 'pnpm install --frozen-lockfile';
+        case 'yarn':
+            return 'yarn install --frozen-lockfile';
+        default:
+            return 'npm ci';
+    }
+}
+function generateDockerfile(context) {
+    const installCmd = getInstallCommand(context);
+    const frontend = isFrontend(context.packageJson);
+    if (frontend) {
+        return `FROM node:20-alpine AS build
+WORKDIR /app
+COPY package*.json ./
+RUN ${installCmd}
+COPY . .
+RUN npm run build
+
+FROM nginx:alpine
+COPY --from=build /app/dist /usr/share/nginx/html
+EXPOSE 80
+CMD ["nginx", "-g", "daemon off;"]
+`;
+    }
+    return `FROM node:20-alpine AS build
+WORKDIR /app
+COPY package*.json ./
+RUN ${installCmd}
+COPY . .
+RUN npm run build
+
+FROM node:20-alpine
+WORKDIR /app
+COPY --from=build /app/dist ./dist
+COPY --from=build /app/package*.json ./
+RUN ${installCmd} --omit=dev
+EXPOSE 3000
+CMD ["node", "dist/index.js"]
+`;
+}
+function generateDockerCompose(context) {
+    const frontend = isFrontend(context.packageJson);
+    const port = frontend ? '8080:80' : '3000:3000';
+    return `services:
+  app:
+    build: .
+    ports:
+      - "${port}"
+    environment:
+      - NODE_ENV=production
+`;
+}
+const DOCKERIGNORE = `node_modules
+dist
+.git
+*.log
+.env
+`;
+async function apply(context) {
+    await fs.writeFile(path.join(context.root, 'Dockerfile'), generateDockerfile(context));
+    await fs.writeFile(path.join(context.root, 'docker-compose.yml'), generateDockerCompose(context));
+    await fs.writeFile(path.join(context.root, '.dockerignore'), DOCKERIGNORE);
+}
+export const dockerFeature = {
+    id: 'docker',
+    name: 'Docker',
+    description: 'Dockerfile, docker-compose, and .dockerignore',
+    detect,
+    apply,
+};

package/dist/features/tailwind.js

@@ -0,0 +1,72 @@
+import fs from 'fs-extra';
+import path from 'node:path';
+async function getWebAppDir(root) {
+    const webDir = path.join(root, 'apps', 'web');
+    if (await fs.pathExists(path.join(webDir, 'package.json'))) {
+        return webDir;
+    }
+    return root;
+}
+async function detect(context) {
+    const targetDir = await getWebAppDir(context.root);
+    const configFiles = [
+        'tailwind.config.js',
+        'tailwind.config.ts',
+        'tailwind.config.mjs',
+        'tailwind.config.cjs',
+    ];
+    for (const file of configFiles) {
+        if (await fs.pathExists(path.join(targetDir, file))) {
+            return true;
+        }
+    }
+    // Check deps in the target package.json
+    const pkgJson = targetDir === context.root
+        ? context.packageJson
+        : await fs.readJson(path.join(targetDir, 'package.json'));
+    const deps = {
+        ...(pkgJson.dependencies ?? {}),
+        ...(pkgJson.devDependencies ?? {}),
+    };
+    return 'tailwindcss' in deps;
+}
+async function apply(context) {
+    const targetDir = await getWebAppDir(context.root);
+    const packageJsonPath = path.join(targetDir, 'package.json');
+    const packageJson = await fs.readJson(packageJsonPath);
+    packageJson.devDependencies = {
+        ...packageJson.devDependencies,
+        tailwindcss: '^4.0.0',
+        '@tailwindcss/vite': '^4.0.0',
+    };
+    await fs.writeJson(packageJsonPath, packageJson, { spaces: 2 });
+    // Update vite.config.ts to add Tailwind plugin if it exists
+    const viteConfigPath = path.join(targetDir, 'vite.config.ts');
+    if (await fs.pathExists(viteConfigPath)) {
+        const viteConfig = await fs.readFile(viteConfigPath, 'utf-8');
+        if (!viteConfig.includes('@tailwindcss/vite')) {
+            const updated = `import tailwindcss from '@tailwindcss/vite';\n` +
+                viteConfig.replace(/plugins:\s*\[/, 'plugins: [\n    tailwindcss(),');
+            await fs.writeFile(viteConfigPath, updated);
+        }
+    }
+    // Create/update src/index.css with Tailwind import
+    const cssPath = path.join(targetDir, 'src', 'index.css');
+    await fs.ensureDir(path.join(targetDir, 'src'));
+    if (await fs.pathExists(cssPath)) {
+        const existing = await fs.readFile(cssPath, 'utf-8');
+        if (!existing.includes('@import "tailwindcss"')) {
+            await fs.writeFile(cssPath, `@import "tailwindcss";\n\n${existing}`);
+        }
+    }
+    else {
+        await fs.writeFile(cssPath, '@import "tailwindcss";\n');
+    }
+}
+export const tailwindFeature = {
+    id: 'tailwind',
+    name: 'Tailwind CSS',
+    description: 'Utility-first CSS framework',
+    detect,
+    apply,
+};

package/package.json

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