scaffy-tool 0.2.0 → 1.0.0

package/registry/javascript/nestjs/plugin.json

@@ -2,8 +2,8 @@
     "name": "NestJS",
     "alias": ["nestjs", "nest"],
     "language": "javascript",
-    "latest": "v10",
-    "versions": ["v10"],
+    "latest": "v11",
+    "versions": ["v11", "v10"],
     "description": "A progressive Node.js framework for building efficient and scalable server-side applications",
     "requires": [
       {

package/registry/javascript/nestjs/v10/questions.js

@@ -1,7 +1,9 @@
-const { detectAvailableChoices } = require('../../../../core/detector');
+import { detectAvailableChoices } from '../../../../core/detector.js';
+import { createRequire } from 'module';
+const require = createRequire(import.meta.url);
 const pluginMeta = require('../plugin.json');
 
-module.exports = async () => {
+export default async () => {
   const availableManagers = await detectAvailableChoices(
     pluginMeta.packageManagerQuestion.choices
   );

package/registry/javascript/nestjs/v10/scaffold.js

@@ -1,4 +1,4 @@
-module.exports = async (answers, utils) => {
+export default async (answers, utils) => {
   const { projectName, packageManager, database, auth, docker } = answers;
 
   // ─── Step 1 — Install NestJS CLI + Create Project ──

package/registry/javascript/nestjs/v11/questions.js

@@ -0,0 +1,61 @@
+import { detectAvailableChoices } from '../../../../core/detector.js';
+import { createRequire } from 'module';
+const require = createRequire(import.meta.url);
+const pluginMeta = require('../plugin.json');
+
+export default async () => {
+  const availableManagers = await detectAvailableChoices(
+    pluginMeta.packageManagerQuestion.choices
+  );
+
+  return [
+    {
+      type: 'input',
+      name: 'projectName',
+      message: 'Project name:',
+      default: 'my-nest-app',
+      validate: input => {
+        if (!input.trim()) return 'Project name is required';
+        if (!/^[a-z0-9-_]+$/.test(input)) {
+          return 'Only lowercase letters, numbers, hyphens and underscores';
+        }
+        return true;
+      },
+    },
+    {
+      type: 'list',
+      name: 'packageManager',
+      message: pluginMeta.packageManagerQuestion.message,
+      choices: availableManagers.map(m => ({
+        name: m.name,
+        value: m.value,
+      })),
+      default: availableManagers[0].value,
+    },
+    {
+      type: 'list',
+      name: 'database',
+      message: 'Database:',
+      choices: [
+        { name: 'None', value: 'none' },
+        { name: 'PostgreSQL (TypeORM)', value: 'postgres' },
+        { name: 'MySQL (TypeORM)', value: 'mysql' },
+        { name: 'MongoDB (Mongoose)', value: 'mongodb' },
+        { name: 'SQLite (TypeORM)', value: 'sqlite' },
+      ],
+      default: 'none',
+    },
+    {
+      type: 'confirm',
+      name: 'auth',
+      message: 'Add JWT authentication (Passport)?',
+      default: false,
+    },
+    {
+      type: 'confirm',
+      name: 'docker',
+      message: 'Add Dockerfile?',
+      default: false,
+    },
+  ];
+};

package/registry/javascript/nestjs/v11/scaffold.js

@@ -0,0 +1,94 @@
+export default async (answers, utils) => {
+  const { projectName, packageManager, database, auth, docker } = answers;
+
+  // ─── Step 1 — Install NestJS CLI + Create Project ──
+  utils.title('Creating NestJS v11 Project');
+  utils.step(1, `Scaffolding ${projectName}...`);
+
+  await utils.run(
+    `npx @nestjs/cli@11 new ${projectName} --package-manager ${packageManager} --skip-git`
+  );
+
+  // ─── Step 2 — Database ────────────────────────────
+  if (database !== 'none') {
+    utils.step(2, `Installing ${database} database packages...`);
+
+    if (database === 'mongodb') {
+      await utils.runInProject(
+        projectName,
+        `${packageManager} ${packageManager === 'yarn' ? 'add' : 'install'} @nestjs/mongoose mongoose`
+      );
+    } else {
+      // TypeORM based (postgres, mysql, sqlite)
+      const dbDriver = {
+        postgres: 'pg',
+        mysql: 'mysql2',
+        sqlite: 'sqlite3',
+      };
+
+      await utils.runInProject(
+        projectName,
+        `${packageManager} ${packageManager === 'yarn' ? 'add' : 'install'} @nestjs/typeorm typeorm ${dbDriver[database]}`
+      );
+    }
+  }
+
+  // ─── Step 3 — Auth ────────────────────────────────
+  if (auth) {
+    utils.step(3, 'Installing Passport JWT authentication...');
+    await utils.runInProject(
+      projectName,
+      `${packageManager} ${packageManager === 'yarn' ? 'add' : 'install'} @nestjs/passport passport passport-jwt @nestjs/jwt`
+    );
+    await utils.runInProject(
+      projectName,
+      `${packageManager} ${packageManager === 'yarn' ? 'add' : 'install'} -D @types/passport-jwt`
+    );
+  }
+
+  // ─── Step 4 — Docker ──────────────────────────────
+  if (docker) {
+    utils.step(4, 'Adding Dockerfile...');
+
+    await utils.createFile(
+      `${projectName}/Dockerfile`,
+      `FROM node:20-alpine AS builder
+  WORKDIR /app
+  COPY package*.json ./
+  RUN npm ci
+  COPY . .
+  RUN npm run build
+  
+  FROM node:20-alpine AS production
+  WORKDIR /app
+  COPY package*.json ./
+  RUN npm ci --only=production
+  COPY --from=builder /app/dist ./dist
+  EXPOSE 3000
+  CMD ["node", "dist/main"]
+  `
+    );
+
+    await utils.createFile(
+      `${projectName}/.dockerignore`,
+      `node_modules
+  dist
+  .git
+  .env
+  `
+    );
+  }
+
+  // ─── Done ─────────────────────────────────────────
+  utils.success(`✅ NestJS v11 project ready!`);
+  utils.log(`  cd ${projectName}`);
+
+  if (docker) {
+    utils.log(`  docker build -t ${projectName} .`);
+    utils.log(`  docker run -p 3000:3000 ${projectName}`);
+  } else {
+    utils.log(`  ${packageManager} run start:dev`);
+  }
+
+  utils.log('');
+};

package/registry/javascript/nextjs/plugin.json

@@ -0,0 +1,44 @@
+{
+  "name": "NextJS",
+  "alias": ["next", "nextjs"],
+  "language": "javascript",
+  "latest": "v14",
+  "versions": ["v14"],
+  "description": "The React framework for production — SSR, SSG, and App Router",
+  "requires": [
+    {
+      "tool": "node",
+      "checkCommand": "node --version",
+      "parseVersion": "v([0-9]+\\.[0-9]+\\.[0-9]+)",
+      "minVersion": "18.0.0",
+      "installGuide": {
+        "mac": "brew install node",
+        "linux": "sudo apt install nodejs",
+        "windows": "https://nodejs.org",
+        "docs": "https://nodejs.org"
+      }
+    },
+    {
+      "tool": "npm",
+      "checkCommand": "npm --version",
+      "parseVersion": "([0-9]+\\.[0-9]+\\.[0-9]+)",
+      "minVersion": "8.0.0",
+      "installGuide": {
+        "mac": "brew install node",
+        "linux": "sudo apt install npm",
+        "windows": "https://nodejs.org",
+        "docs": "https://docs.npmjs.com"
+      }
+    }
+  ],
+  "packageManagerQuestion": {
+    "tool": "packageManager",
+    "message": "Package manager:",
+    "choices": [
+      { "name": "npm",  "value": "npm",  "checkCommand": "npm --version" },
+      { "name": "yarn", "value": "yarn", "checkCommand": "yarn --version" },
+      { "name": "pnpm", "value": "pnpm", "checkCommand": "pnpm --version" }
+    ]
+  },
+  "maintainer": "community"
+}

package/registry/javascript/nextjs/v14/questions.js

@@ -0,0 +1,44 @@
+import { detectAvailableChoices } from '../../../../core/detector.js';
+import { createRequire } from 'module';
+
+const require = createRequire(import.meta.url);
+const pluginMeta = require('../plugin.json');
+
+export default async () => {
+  const availableManagers = await detectAvailableChoices(
+    pluginMeta.packageManagerQuestion.choices
+  );
+
+  return [
+    {
+      type: 'list',
+      name: 'packageManager',
+      message: pluginMeta.packageManagerQuestion.message,
+      choices: availableManagers,
+    },
+    {
+      type: 'confirm',
+      name: 'typescript',
+      message: 'Use TypeScript?',
+      default: true,
+    },
+    {
+      type: 'confirm',
+      name: 'tailwind',
+      message: 'Use Tailwind CSS?',
+      default: true,
+    },
+    {
+      type: 'confirm',
+      name: 'appRouter',
+      message: 'Use App Router? (recommended)',
+      default: true,
+    },
+    {
+      type: 'confirm',
+      name: 'srcDir',
+      message: 'Use src/ directory?',
+      default: false,
+    },
+  ];
+};

package/registry/javascript/nextjs/v14/scaffold.js

@@ -0,0 +1,57 @@
+export default async (answers, utils) => {
+  const {
+    projectName,
+    packageManager,
+    typescript,
+    tailwind,
+    appRouter,
+    srcDir,
+  } = answers;
+
+  utils.title('Creating NextJS v14 Project');
+
+  // ─── Step 1: Build flags ───────────────────────────────
+  utils.step(1, 'Configuring create-next-app flags');
+
+  const flags = [
+    typescript ? '--typescript' : '--no-typescript',
+    tailwind ? '--tailwind' : '--no-tailwind',
+    appRouter ? '--app' : '--no-app',
+    srcDir ? '--src-dir' : '--no-src-dir',
+    `--use-${packageManager}`,
+    '--no-eslint',
+    '--skip-install',
+  ].join(' ');
+
+  // ─── Step 2: Run create-next-app ──────────────────────
+  utils.step(2, 'Running create-next-app@14');
+  await utils.run(`npx create-next-app@14 ${projectName} ${flags}`);
+
+  // ─── Step 3: Install dependencies ─────────────────────
+  utils.step(3, 'Installing dependencies');
+  const installCmd = packageManager === 'yarn' ? 'install' : 'install';
+  await utils.runInProject(projectName, `${packageManager} ${installCmd}`);
+
+  // ─── Step 4: .env.local ───────────────────────────────
+  utils.step(4, 'Generating environment files');
+
+  const envLocal = `# Environment Variables
+# Add your environment variables here
+NEXT_PUBLIC_APP_URL=http://localhost:3000
+`;
+  await utils.createFile(`${projectName}/.env.local`, envLocal);
+  await utils.createFile(`${projectName}/.env.example`, envLocal);
+
+  // ─── Step 5: .gitignore addition ──────────────────────
+  await utils.appendToFile(
+    `${projectName}/.gitignore`,
+    '\n# Environment\n.env.local\n.env*.local\n'
+  );
+
+  utils.success(`NextJS v14 project "${projectName}" created successfully!`);
+  utils.log(`  cd ${projectName}`);
+  utils.log(
+    `  ${packageManager} ${packageManager === 'yarn' ? 'dev' : 'run dev'}`
+  );
+  utils.log(`  App running at http://localhost:3000`);
+};

package/registry/javascript/vuejs/v3/questions.js

@@ -1,7 +1,9 @@
-const { detectAvailableChoices } = require('../../../../core/detector');
+import { detectAvailableChoices } from '../../../../core/detector.js';
+import { createRequire } from 'module';
+const require = createRequire(import.meta.url);
 const pluginMeta = require('../plugin.json');
 
-module.exports = async () => {
+export default async () => {
   const availableManagers = await detectAvailableChoices(
     pluginMeta.packageManagerQuestion.choices
   );

package/registry/javascript/vuejs/v3/scaffold.js

@@ -1,13 +1,6 @@
-module.exports = async (answers, utils) => {
-  const {
-    projectName,
-    packageManager,
-    router,
-    pinia,
-    vitest,
-    typescript,
-    eslint,
-  } = answers;
+export default async (answers, utils) => {
+  const { projectName, packageManager, router, pinia, typescript, eslint } =
+    answers;
 
   // ─── Step 1 — Build create-vue flags ──────────────
   utils.title('Creating VueJS v3 Project');

package/registry/php/laravel/plugin.json

@@ -2,8 +2,8 @@
   "name": "Laravel",
   "alias": ["laravel"],
   "language": "php",
-  "latest": "v11",
-  "versions": ["v11", "v10"],
+  "latest": "v13",
+  "versions": ["v13", "v12", "v11", "v10"],
   "description": "The PHP Framework for Web Artisans",
   "requires": [
     {

package/registry/php/laravel/v11/questions.js

@@ -1,4 +1,4 @@
-module.exports = [
+export default [
   {
     type: 'input',
     name: 'projectName',

package/registry/php/laravel/v11/scaffold.js

@@ -1,4 +1,4 @@
-module.exports = async (answers, utils) => {
+export default async (answers, utils) => {
   const { projectName, starterKit, database, docker } = answers;
 
   // ─── Step 1 — Create Laravel Project ──────────────

package/registry/php/laravel/v12/questions.js

@@ -0,0 +1,45 @@
+export default [
+  {
+    type: 'input',
+    name: 'projectName',
+    message: 'Project name?',
+    default: 'my-laravel-app',
+    validate: value => {
+      if (!value || !value.trim()) {
+        return 'Project name is required';
+      }
+      if (!/^[a-z0-9_-]+$/.test(value)) {
+        return 'Project name can only contain lowercase letters, numbers, underscores, and hyphens';
+      }
+      return true;
+    },
+  },
+  {
+    type: 'list',
+    name: 'starterKit',
+    message: 'Starter kit?',
+    choices: [
+      { name: 'None', value: 'none' },
+      { name: 'Breeze', value: 'breeze' },
+      { name: 'Jetstream', value: 'jetstream' },
+    ],
+    default: 'none',
+  },
+  {
+    type: 'list',
+    name: 'database',
+    message: 'Database?',
+    choices: [
+      { name: 'SQLite', value: 'sqlite' },
+      { name: 'MySQL', value: 'mysql' },
+      { name: 'PostgreSQL', value: 'pgsql' },
+    ],
+    default: 'sqlite',
+  },
+  {
+    type: 'confirm',
+    name: 'docker',
+    message: 'Include Docker config (Laravel Sail)?',
+    default: false,
+  },
+];

package/registry/php/laravel/v12/scaffold.js

@@ -0,0 +1,46 @@
+export default async (answers, utils) => {
+  const { projectName, starterKit, database, docker } = answers;
+
+  utils.title('Creating Laravel v12 Project');
+
+  utils.step(1, 'Running Laravel installer');
+  await utils.run(
+    `composer create-project laravel/laravel:^12.0 ${projectName}`
+  );
+
+  if (starterKit === 'breeze') {
+    utils.step(2, 'Installing Laravel Breeze');
+    await utils.runInProject(
+      projectName,
+      'composer require laravel/breeze --dev'
+    );
+    await utils.runInProject(projectName, 'php artisan breeze:install');
+  }
+
+  if (starterKit === 'jetstream') {
+    utils.step(2, 'Installing Laravel Jetstream');
+    await utils.runInProject(projectName, 'composer require laravel/jetstream');
+    await utils.runInProject(
+      projectName,
+      'php artisan jetstream:install livewire'
+    );
+  }
+
+  utils.step(3, 'Configuring database');
+  await utils.setEnv(projectName, {
+    DB_CONNECTION: database,
+    DB_DATABASE:
+      database === 'sqlite' ? 'database/database.sqlite' : projectName,
+  });
+
+  if (docker) {
+    utils.step(4, 'Installing Laravel Sail');
+    await utils.runInProject(
+      projectName,
+      'composer require laravel/sail --dev'
+    );
+    await utils.runInProject(projectName, 'php artisan sail:install');
+  }
+
+  utils.success(`Laravel v12 project "${projectName}" created successfully!`);
+};

package/registry/php/laravel/v13/questions.js

@@ -0,0 +1,28 @@
+export default [
+  {
+    type: 'list',
+    name: 'starterKit',
+    message: 'Starter kit?',
+    choices: [
+      { name: 'None', value: 'none' },
+      { name: 'Breeze', value: 'breeze' },
+      { name: 'Jetstream', value: 'jetstream' },
+    ],
+  },
+  {
+    type: 'list',
+    name: 'database',
+    message: 'Database?',
+    choices: [
+      { name: 'SQLite', value: 'sqlite' },
+      { name: 'MySQL', value: 'mysql' },
+      { name: 'PostgreSQL', value: 'pgsql' },
+    ],
+  },
+  {
+    type: 'confirm',
+    name: 'docker',
+    message: 'Include Docker config (Laravel Sail)?',
+    default: false,
+  },
+];

package/registry/php/laravel/v13/scaffold.js

@@ -0,0 +1,46 @@
+export default async (answers, utils) => {
+  const { projectName, starterKit, database, docker } = answers;
+
+  utils.title('Creating Laravel v13 Project');
+
+  utils.step(1, 'Running Laravel installer');
+  await utils.run(
+    `composer create-project laravel/laravel:^13.0 ${projectName}`
+  );
+
+  if (starterKit === 'breeze') {
+    utils.step(2, 'Installing Laravel Breeze');
+    await utils.runInProject(
+      projectName,
+      'composer require laravel/breeze --dev'
+    );
+    await utils.runInProject(projectName, 'php artisan breeze:install');
+  }
+
+  if (starterKit === 'jetstream') {
+    utils.step(2, 'Installing Laravel Jetstream');
+    await utils.runInProject(projectName, 'composer require laravel/jetstream');
+    await utils.runInProject(
+      projectName,
+      'php artisan jetstream:install livewire'
+    );
+  }
+
+  utils.step(3, 'Configuring database');
+  await utils.setEnv(projectName, {
+    DB_CONNECTION: database,
+    DB_DATABASE:
+      database === 'sqlite' ? 'database/database.sqlite' : projectName,
+  });
+
+  if (docker) {
+    utils.step(4, 'Installing Laravel Sail');
+    await utils.runInProject(
+      projectName,
+      'composer require laravel/sail --dev'
+    );
+    await utils.runInProject(projectName, 'php artisan sail:install');
+  }
+
+  utils.success(`Laravel v13 project "${projectName}" created successfully!`);
+};

package/registry/php/laravel/v13/test/questions.test.js

@@ -0,0 +1,48 @@
+import questions from '../questions.js';
+
+describe('Laravel v13 questions plugin', () => {
+  test('returns expected question set', () => {
+    expect(Array.isArray(questions)).toBe(true);
+
+    const projectNameQuestion = questions.find(q => q.name === 'projectName');
+    expect(projectNameQuestion).toBeDefined();
+    expect(projectNameQuestion.default).toBe('my-laravel-app');
+
+    const starterKitQuestion = questions.find(q => q.name === 'starterKit');
+    expect(starterKitQuestion).toBeDefined();
+    expect(Array.isArray(starterKitQuestion.choices)).toBe(true);
+    expect(starterKitQuestion.choices.length).toBe(3);
+    expect(starterKitQuestion.default).toBe('none');
+
+    const databaseQuestion = questions.find(q => q.name === 'database');
+    expect(databaseQuestion).toBeDefined();
+    expect(Array.isArray(databaseQuestion.choices)).toBe(true);
+    expect(databaseQuestion.default).toBe('sqlite');
+
+    const dockerQuestion = questions.find(q => q.name === 'docker');
+    expect(dockerQuestion).toBeDefined();
+    expect(dockerQuestion.type).toBe('confirm');
+    expect(dockerQuestion.default).toBe(false);
+  });
+
+  test('project name validator rejects empty input', () => {
+    const projectNameQuestion = questions.find(q => q.name === 'projectName');
+    expect(projectNameQuestion.validate('   ')).toBe(
+      'Project name is required'
+    );
+  });
+
+  test('project name validator rejects invalid characters', () => {
+    const projectNameQuestion = questions.find(q => q.name === 'projectName');
+    const result = projectNameQuestion.validate('MyProject');
+    expect(typeof result).toBe('string');
+    expect(result).toContain('lowercase');
+  });
+
+  test('project name validator accepts valid names', () => {
+    const projectNameQuestion = questions.find(q => q.name === 'projectName');
+    expect(projectNameQuestion.validate('my-laravel-app')).toBe(true);
+    expect(projectNameQuestion.validate('my_laravel_app')).toBe(true);
+    expect(projectNameQuestion.validate('mylaravelapp123')).toBe(true);
+  });
+});