create-fstack-app 1.0.1

package/README.md

@@ -0,0 +1,67 @@
+# create-my-fullstack-app
+
+Interactive npm scaffolding for modern full-stack apps.
+
+```bash
+npm create my-fullstack-app my-app
+```
+
+or:
+
+```bash
+npx create-my-fullstack-app my-app
+```
+
+## Features
+
+- Multi-stack setup: MERN, PERN, MEAN, T3 Stack, Firebase Stack, Django + React, Laravel + React
+- Custom setup mode for frontend, language, styling, backend, database, auth, and add-ons
+- Smart project naming from an argument or prompt
+- Dynamic folder and file generation
+- Optional dependency installation
+- Ready-to-run root `npm run dev` script for Node-based split stacks
+
+## Local Development
+
+```bash
+npm install
+npm run dev
+```
+
+Run a non-interactive smoke scaffold:
+
+```bash
+npm run smoke
+```
+
+## CLI
+
+```bash
+create-my-fullstack-app [project-name] [options]
+```
+
+Options:
+
+- `--stack <stack>`: `MERN`, `PERN`, `MEAN`, `T3`, `Firebase`, `Django React`, `Laravel React`, `Custom`
+- `--yes`: use sensible defaults
+- `--no-install`: generate files without running `npm install`
+- `--force`: empty an existing target folder before generating
+
+## Generated MERN Example
+
+```txt
+my-app/
+├── frontend/
+│   ├── src/
+│   ├── public/
+│   ├── package.json
+│   └── vite.config.js
+├── backend/
+│   ├── src/
+│   ├── package.json
+│   └── .env
+├── database/
+├── README.md
+├── .gitignore
+└── package.json
+```

package/bin/index.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+
+import { runCli } from "../src/cli.js";
+
+runCli().catch((error) => {
+  console.error(error?.message || error);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "create-fstack-app",
+  "version": "1.0.1",
+  "description": "A modern interactive CLI for scaffolding customizable full-stack applications.",
+  "type": "module",
+  "bin": {
+    "create-fstack-app": "bin/index.js"
+},
+  "files": [
+    "bin",
+    "src",
+    "templates",
+    "README.md"
+  ],
+  "scripts": {
+    "start": "node ./bin/index.js",
+    "dev": "node ./bin/index.js --no-install",
+    "smoke": "node ./bin/index.js demo-app --stack MERN --yes --no-install --force"
+  },
+  "keywords": [
+    "create",
+    "scaffold",
+    "fullstack",
+    "mern",
+    "pern",
+    "react",
+    "express",
+    "vite",
+    "cli"
+  ],
+  "author": "",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.17"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^5.5.0",
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "fs-extra": "^11.2.0",
+    "ora": "^8.1.0"
+  }
+}

package/src/cli.js

@@ -0,0 +1,46 @@
+import process from "node:process";
+import { Command } from "commander";
+import chalk from "chalk";
+import { collectAnswers } from "./prompts/index.js";
+import { createProject } from "./generators/createProject.js";
+
+export async function runCli(argv = process.argv) {
+  const program = new Command()
+    .name("create-my-fullstack-app")
+    .description("Scaffold a modern full-stack application.")
+    .argument("[project-name]", "project directory name")
+    .option("-s, --stack <stack>", "stack preset: MERN, PERN, MEAN, T3, Firebase, Django React, Laravel React, Custom")
+    .option("-y, --yes", "accept sensible defaults and skip prompts where possible")
+    .option("--no-install", "skip dependency installation")
+    .option("-f, --force", "overwrite an existing target directory")
+    .version("0.1.0")
+    .parse(argv);
+
+  const options = program.opts();
+  const [projectName] = program.args;
+
+  const answers = await collectAnswers({
+    projectName,
+    stack: options.stack,
+    yes: options.yes,
+    install: options.install
+  });
+
+  const result = await createProject({
+    ...answers,
+    install: options.install,
+    force: options.force
+  });
+
+  console.log();
+  console.log(chalk.green.bold("Project created successfully!"));
+  console.log();
+  console.log(chalk.bold("Next steps:"));
+  console.log(chalk.cyan(`  cd ${result.projectName}`));
+  if (!options.install) {
+    console.log(chalk.cyan("  npm install"));
+  }
+  console.log(chalk.cyan("  npm run dev"));
+  console.log();
+  console.log(chalk.dim(`Generated ${result.stackLabel} at ${result.targetDir}`));
+}

package/src/generators/createProject.js

@@ -0,0 +1,55 @@
+import path from "node:path";
+import process from "node:process";
+import fs from "fs-extra";
+import ora from "ora";
+import chalk from "chalk";
+import { composeProject } from "./templateEngine.js";
+import { installDependencies } from "../install/installDependencies.js";
+import { normalizeProjectName } from "../utils/names.js";
+
+export async function createProject({ projectName, stack, custom, install, force }) {
+  const targetDir = path.resolve(process.cwd(), projectName);
+  const packageName = normalizeProjectName(path.basename(targetDir));
+  const relativeTargetDir = path.relative(process.cwd(), targetDir) || ".";
+
+  if (!packageName) {
+    throw new Error("Project name must include at least one letter or number.");
+  }
+
+  if (await fs.pathExists(targetDir)) {
+    const entries = await fs.readdir(targetDir);
+    if (entries.length > 0 && !force) {
+      throw new Error(`Directory "${projectName}" already exists and is not empty. Use --force to overwrite.`);
+    }
+    if (force) {
+      await fs.emptyDir(targetDir);
+    }
+  }
+
+  const spinner = ora(`Generating ${stack.label} project...`).start();
+  const project = composeProject({ projectName: packageName, stack, custom });
+
+  await fs.ensureDir(targetDir);
+  await writeFiles(targetDir, project.files);
+  spinner.succeed("Project files generated");
+
+  if (install) {
+    await installDependencies(targetDir, project.installTargets);
+  } else {
+    console.log(chalk.yellow("Skipped dependency installation."));
+  }
+
+  return {
+    projectName: relativeTargetDir,
+    stackLabel: stack.label,
+    targetDir
+  };
+}
+
+async function writeFiles(targetDir, files) {
+  await Promise.all(Object.entries(files).map(async ([relativePath, content]) => {
+    const filePath = path.join(targetDir, relativePath);
+    await fs.ensureDir(path.dirname(filePath));
+    await fs.writeFile(filePath, content);
+  }));
+}

package/src/generators/templateEngine.js

@@ -0,0 +1,118 @@
+import { createRootFiles } from "./templates/root.js";
+import { createFrontendFiles } from "./templates/frontend.js";
+import { createBackendFiles } from "./templates/backend.js";
+import { createDatabaseFiles } from "./templates/database.js";
+import { createAddonFiles } from "./templates/addons.js";
+import { packageManagerInstallTargets } from "../install/packageMap.js";
+
+export function composeProject({ projectName, stack, custom }) {
+  const config = toProjectConfig({ stack, custom });
+  const files = {
+    ...createRootFiles({ projectName, stack, config }),
+    ...createFrontendFiles(config),
+    ...createBackendFiles(config),
+    ...createDatabaseFiles(config),
+    ...createAddonFiles(config)
+  };
+
+  return {
+    files,
+    installTargets: packageManagerInstallTargets(config)
+  };
+}
+
+function toProjectConfig({ stack, custom }) {
+  if (stack.id === "custom") {
+    return {
+      stackId: stack.id,
+      stackLabel: stack.label,
+      frontend: custom.frontend,
+      language: custom.language,
+      styling: custom.styling,
+      backend: custom.backend,
+      database: custom.database,
+      auth: custom.auth,
+      features: custom.features,
+      structure: "custom"
+    };
+  }
+
+  const configByStack = {
+    mern: {
+      frontend: "React",
+      language: "JavaScript",
+      styling: "Tailwind CSS",
+      backend: "Express.js",
+      database: "MongoDB",
+      auth: "None",
+      features: ["ESLint", "Prettier"],
+      structure: "split"
+    },
+    pern: {
+      frontend: "React",
+      language: "JavaScript",
+      styling: "Tailwind CSS",
+      backend: "Express.js",
+      database: "PostgreSQL",
+      auth: "None",
+      features: ["ESLint", "Prettier"],
+      structure: "split"
+    },
+    mean: {
+      frontend: "Angular",
+      language: "TypeScript",
+      styling: "SCSS",
+      backend: "Express.js",
+      database: "MongoDB",
+      auth: "None",
+      features: ["ESLint", "Prettier"],
+      structure: "split"
+    },
+    t3: {
+      frontend: "Next.js",
+      language: "TypeScript",
+      styling: "Tailwind CSS",
+      backend: "tRPC",
+      database: "PostgreSQL",
+      auth: "Auth.js",
+      features: ["ESLint", "Prettier", "Prisma"],
+      structure: "t3"
+    },
+    firebase: {
+      frontend: "React",
+      language: "JavaScript",
+      styling: "Tailwind CSS",
+      backend: "Firebase Functions",
+      database: "Firebase",
+      auth: "Firebase Auth",
+      features: ["ESLint", "Prettier"],
+      structure: "firebase"
+    },
+    "django-react": {
+      frontend: "React",
+      language: "JavaScript",
+      styling: "Tailwind CSS",
+      backend: "Django",
+      database: "PostgreSQL",
+      auth: "JWT",
+      features: ["ESLint", "Prettier"],
+      structure: "split"
+    },
+    "laravel-react": {
+      frontend: "React",
+      language: "JavaScript",
+      styling: "Tailwind CSS",
+      backend: "Laravel",
+      database: "MySQL",
+      auth: "JWT",
+      features: ["ESLint", "Prettier"],
+      structure: "split"
+    }
+  };
+
+  return {
+    stackId: stack.id,
+    stackLabel: stack.label,
+    ...configByStack[stack.id]
+  };
+}

package/src/generators/templates/addons.js

@@ -0,0 +1,119 @@
+export function createAddonFiles(config) {
+  const files = {};
+
+  if (config.features.includes("Docker")) {
+    files["Dockerfile"] = `FROM node:20-alpine
+WORKDIR /app
+COPY package*.json ./
+RUN npm install
+COPY . .
+CMD ["npm", "run", "dev"]
+`;
+    files["docker-compose.yml"] = dockerCompose(config);
+  }
+
+  if (config.features.includes("CI/CD")) {
+    files[".github/workflows/ci.yml"] = `name: CI
+
+on: [push, pull_request]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+      - run: npm install
+      - run: npm run dev -- --help || true
+`;
+  }
+
+  if (config.features.includes("ESLint")) {
+    files["eslint.config.js"] = `export default [
+  {
+    ignores: ["node_modules", "dist", "build", ".next"]
+  }
+];
+`;
+  }
+
+  if (config.features.includes("Prettier")) {
+    files[".prettierrc"] = `${JSON.stringify({ semi: true, singleQuote: false, printWidth: 100 }, null, 2)}\n`;
+  }
+
+  if (config.features.includes("Testing Setup")) {
+    files["tests/smoke.test.js"] = `import { describe, expect, it } from "vitest";
+
+describe("generated project", () => {
+  it("has a selected stack", () => {
+    expect("${config.stackLabel}").toBeTruthy();
+  });
+});
+`;
+  }
+
+  if (config.features.includes("Husky")) {
+    files[".husky/pre-commit"] = `npm run lint
+`;
+  }
+
+  if (config.auth !== "None") {
+    files["docs/auth.md"] = `# Authentication
+
+Selected auth starter: ${config.auth}
+
+Wire provider secrets in \`.env\` before building protected routes.
+`;
+  }
+
+  return files;
+}
+
+function dockerCompose(config) {
+  const services = {
+    app: {
+      build: ".",
+      ports: ["5173:5173", "5000:5000"],
+      volumes: [".:/app"]
+    }
+  };
+
+  if (config.database === "MongoDB") {
+    services.mongo = { image: "mongo:7", ports: ["27017:27017"] };
+  }
+  if (config.database === "PostgreSQL") {
+    services.postgres = {
+      image: "postgres:16",
+      environment: { POSTGRES_PASSWORD: "postgres", POSTGRES_DB: "my_fullstack_app" },
+      ports: ["5432:5432"]
+    };
+  }
+  if (config.database === "MySQL") {
+    services.mysql = {
+      image: "mysql:8",
+      environment: { MYSQL_ROOT_PASSWORD: "password", MYSQL_DATABASE: "my_fullstack_app" },
+      ports: ["3306:3306"]
+    };
+  }
+
+  return `services:
+${Object.entries(services).map(([name, service]) => yamlService(name, service)).join("")}`;
+}
+
+function yamlService(name, service) {
+  const lines = [`  ${name}:`];
+  for (const [key, value] of Object.entries(service)) {
+    if (Array.isArray(value)) {
+      lines.push(`    ${key}:`);
+      value.forEach((item) => lines.push(`      - ${JSON.stringify(item)}`));
+    } else if (typeof value === "object") {
+      lines.push(`    ${key}:`);
+      Object.entries(value).forEach(([nestedKey, nestedValue]) => lines.push(`      ${nestedKey}: ${JSON.stringify(nestedValue)}`));
+    } else {
+      lines.push(`    ${key}: ${JSON.stringify(value)}`);
+    }
+  }
+  return `${lines.join("\n")}\n`;
+}