create-fstack-app 1.0.1

package/src/generators/templates/root.js

@@ -0,0 +1,170 @@
+import { slugToTitle } from "../../utils/names.js";
+
+export function createRootFiles({ projectName, stack, config }) {
+  const scripts = rootScripts(config);
+
+  return {
+    "package.json": `${JSON.stringify({
+      name: projectName,
+      version: "0.1.0",
+      private: true,
+      type: "module",
+      workspaces: rootWorkspaces(config),
+      scripts,
+      dependencies: rootDependencies(config),
+      devDependencies: rootDevDependencies(config)
+    }, null, 2)}\n`,
+    "README.md": readme({ projectName, stack, config }),
+    ".gitignore": gitignore(),
+    ".env.example": envExample(config)
+  };
+}
+
+function rootScripts(config) {
+  if (config.structure === "t3") {
+    const scripts = {
+      dev: "next dev",
+      build: "next build",
+      start: "next start",
+      lint: "next lint"
+    };
+    return withAddonScripts(scripts, config);
+  }
+
+  const scripts = {};
+  if (hasFrontend(config) && hasNodeBackend(config)) {
+    scripts.dev = "concurrently \"npm run dev --workspace frontend\" \"npm run dev --workspace backend\"";
+  } else if (hasFrontend(config)) {
+    scripts.dev = "npm run dev --workspace frontend";
+  } else if (hasNodeBackend(config)) {
+    scripts.dev = "npm run dev --workspace backend";
+  } else {
+    scripts.dev = "echo \"Start your selected framework from its generated folder.\"";
+  }
+  return withAddonScripts(scripts, config);
+}
+
+function rootDevDependencies(config) {
+  if (config.structure === "t3") {
+    return withAddonDevDependencies({
+      "@types/node": "^20.14.10",
+      "@types/react": "^18.3.3",
+      "@types/react-dom": "^18.3.0",
+      eslint: "^8.57.0",
+      "eslint-config-next": "^14.2.5",
+      prisma: "^5.16.1",
+      typescript: "^5.5.3"
+    }, config);
+  }
+  const deps = hasFrontend(config) && hasNodeBackend(config) ? { concurrently: "^8.2.2" } : {};
+  return withAddonDevDependencies(deps, config);
+}
+
+function withAddonDevDependencies(deps, config) {
+  if (config.features.includes("ESLint")) deps.eslint = "^8.57.0";
+  if (config.features.includes("Prettier")) deps.prettier = "^3.3.2";
+  if (config.features.includes("Husky")) deps.husky = "^9.1.1";
+  if (config.features.includes("Testing Setup")) deps.vitest = "^2.0.3";
+  return deps;
+}
+
+function rootDependencies(config) {
+  if (config.structure !== "t3") return {};
+  return {
+    "@prisma/client": "^5.16.1",
+    "@trpc/client": "^10.45.2",
+    "@trpc/next": "^10.45.2",
+    "@trpc/react-query": "^10.45.2",
+    "@trpc/server": "^10.45.2",
+    next: "^14.2.5",
+    react: "^18.3.1",
+    "react-dom": "^18.3.1",
+    superjson: "^2.2.1",
+    zod: "^3.23.8"
+  };
+}
+
+function rootWorkspaces(config) {
+  if (config.structure === "t3") return [];
+  const workspaces = [];
+  if (hasFrontend(config)) workspaces.push("frontend");
+  if (hasNodeBackend(config)) workspaces.push("backend");
+  return workspaces;
+}
+
+function readme({ projectName, stack, config }) {
+  return `# ${slugToTitle(projectName)}
+
+Generated with \`create-my-fullstack-app\`.
+
+## Stack
+
+- Preset: ${stack.label}
+- Frontend: ${config.frontend}
+- Backend: ${config.backend}
+- Database: ${config.database}
+- Styling: ${config.styling}
+- Auth: ${config.auth}
+
+## Getting Started
+
+\`\`\`bash
+npm install
+npm run dev
+\`\`\`
+
+## Folders
+
+- \`frontend/\`: client application when your stack uses a separate frontend
+- \`backend/\`: server application when your stack uses a separate backend
+- \`database/\`: schema, seed, or connection notes when relevant
+- \`src/\`, \`server/\`, \`prisma/\`, \`app/\`: T3-style structure when selected
+`;
+}
+
+function gitignore() {
+  return `node_modules
+dist
+build
+.next
+.env
+.DS_Store
+coverage
+*.log
+`;
+}
+
+function envExample(config) {
+  const lines = ["NODE_ENV=development"];
+  if (config.database === "MongoDB") lines.push("MONGODB_URI=mongodb://localhost:27017/my_fullstack_app");
+  if (config.database === "PostgreSQL") lines.push("DATABASE_URL=postgresql://postgres:postgres@localhost:5432/my_fullstack_app");
+  if (config.database === "MySQL") lines.push("DATABASE_URL=mysql://root:password@localhost:3306/my_fullstack_app");
+  if (config.database === "Firebase") lines.push("VITE_FIREBASE_API_KEY=", "VITE_FIREBASE_PROJECT_ID=");
+  if (config.auth !== "None") lines.push("AUTH_SECRET=change-me");
+  return `${lines.join("\n")}\n`;
+}
+
+function hasFrontend(config) {
+  return config.frontend !== "None";
+}
+
+function hasNodeBackend(config) {
+  return ["Express.js", "Fastify", "NestJS", "Firebase Functions"].includes(config.backend);
+}
+
+function withAddonScripts(scripts, config) {
+  const nextScripts = { ...scripts };
+  if (config.features.includes("ESLint") && !nextScripts.lint) {
+    nextScripts.lint = "eslint .";
+  }
+  if (config.features.includes("Prettier")) {
+    nextScripts.format = "prettier --write .";
+  }
+  if (config.features.includes("Testing Setup")) {
+    nextScripts.test = "vitest";
+  }
+  if (config.features.includes("Husky")) {
+    nextScripts.prepare = "husky";
+  }
+  return nextScripts;
+}

package/src/install/installDependencies.js

@@ -0,0 +1,30 @@
+import { spawn } from "node:child_process";
+import path from "node:path";
+import ora from "ora";
+
+export async function installDependencies(targetDir, installTargets) {
+  for (const relativeTarget of installTargets) {
+    const cwd = path.join(targetDir, relativeTarget);
+    const label = relativeTarget === "." ? "root" : relativeTarget;
+    const spinner = ora(`Installing ${label} dependencies...`).start();
+
+    await runNpmInstall(cwd);
+    spinner.succeed(`Installed ${label} dependencies`);
+  }
+}
+
+function runNpmInstall(cwd) {
+  return new Promise((resolve, reject) => {
+    const child = spawn("npm", ["install"], {
+      cwd,
+      shell: true,
+      stdio: "ignore"
+    });
+
+    child.on("error", reject);
+    child.on("exit", (code) => {
+      if (code === 0) resolve();
+      else reject(new Error(`npm install failed in ${cwd}`));
+    });
+  });
+}

package/src/install/packageMap.js

@@ -0,0 +1,3 @@
+export function packageManagerInstallTargets(config) {
+  return ["."];
+}

package/src/prompts/index.js

@@ -0,0 +1,106 @@
+import { input, select, confirm, checkbox } from "@inquirer/prompts";
+import { normalizeProjectName } from "../utils/names.js";
+import { STACKS, stackChoices, resolveStack } from "../stacks.js";
+
+const defaultCustom = {
+  frontend: "React",
+  language: "JavaScript",
+  styling: "Tailwind CSS",
+  backend: "Express.js",
+  database: "MongoDB",
+  auth: "None",
+  features: ["ESLint", "Prettier"]
+};
+
+export async function collectAnswers({ projectName, stack, yes = false, install = true }) {
+  const resolvedProjectName = projectName
+    ? projectName.trim()
+    : yes
+      ? "my-app"
+      : normalizeProjectName(await input({
+          message: "Enter project name:",
+          default: "my-app",
+          validate: validateProjectName
+        }));
+
+  const resolvedStack = stack
+    ? resolveStack(stack)
+    : yes
+      ? STACKS.MERN
+      : await select({
+          message: "Choose your stack:",
+          choices: stackChoices
+        });
+
+  if (resolvedStack.id === "custom") {
+    return {
+      projectName: resolvedProjectName,
+      stack: resolvedStack,
+      custom: yes ? defaultCustom : await collectCustomAnswers(),
+      install: install && (yes || await confirm({ message: "Install dependencies?", default: true }))
+    };
+  }
+
+  return {
+    projectName: resolvedProjectName,
+    stack: resolvedStack,
+    custom: null,
+    install: install && (yes || await confirm({ message: "Install dependencies?", default: true }))
+  };
+}
+
+async function collectCustomAnswers() {
+  const frontend = await select({
+    message: "Choose frontend framework:",
+    choices: ["React", "Next.js", "Vue", "Nuxt", "Angular", "Svelte", "SolidJS"].map(toChoice)
+  });
+
+  const language = await select({
+    message: "Choose language:",
+    choices: ["JavaScript", "TypeScript"].map(toChoice)
+  });
+
+  const styling = await select({
+    message: "Choose styling solution:",
+    choices: ["Tailwind CSS", "CSS Modules", "Styled Components", "SCSS", "Chakra UI", "Material UI", "None"].map(toChoice)
+  });
+
+  const backend = await select({
+    message: "Choose backend framework:",
+    choices: ["Express.js", "Fastify", "NestJS", "Django", "Laravel", "Spring Boot", "ASP.NET", "None"].map(toChoice)
+  });
+
+  const database = await select({
+    message: "Choose database:",
+    choices: ["MongoDB", "PostgreSQL", "MySQL", "SQLite", "Firebase", "Supabase", "None"].map(toChoice)
+  });
+
+  const auth = await select({
+    message: "Add authentication starter?",
+    choices: ["JWT", "Clerk", "Auth.js", "Firebase Auth", "Supabase Auth", "None"].map(toChoice)
+  });
+
+  const features = await checkbox({
+    message: "Select optional features:",
+    choices: ["ESLint", "Prettier", "Husky", "Docker", "Testing Setup", "CI/CD", "Zustand", "Redux Toolkit", "Prisma", "Swagger Docs"].map((name) => ({
+      name,
+      value: name,
+      checked: ["ESLint", "Prettier"].includes(name)
+    }))
+  });
+
+  return { frontend, language, styling, backend, database, auth, features };
+}
+
+function toChoice(value) {
+  return { name: value, value };
+}
+
+function validateProjectName(value) {
+  const normalized = normalizeProjectName(value);
+  if (!normalized) return "Project name is required.";
+  if (!/^[a-z0-9._-]+$/.test(normalized)) {
+    return "Use letters, numbers, dots, dashes, or underscores.";
+  }
+  return true;
+}

package/src/stacks.js

@@ -0,0 +1,94 @@
+export const STACKS = {
+  MERN: {
+    id: "mern",
+    label: "MERN",
+    frontend: "React",
+    backend: "Node + Express",
+    database: "MongoDB",
+    structure: "split"
+  },
+  PERN: {
+    id: "pern",
+    label: "PERN",
+    frontend: "React",
+    backend: "Node + Express",
+    database: "PostgreSQL",
+    structure: "split"
+  },
+  MEAN: {
+    id: "mean",
+    label: "MEAN",
+    frontend: "Angular",
+    backend: "Node + Express",
+    database: "MongoDB",
+    structure: "split"
+  },
+  T3: {
+    id: "t3",
+    label: "T3 Stack",
+    frontend: "Next.js + TypeScript",
+    backend: "tRPC",
+    database: "PostgreSQL",
+    structure: "t3"
+  },
+  FIREBASE: {
+    id: "firebase",
+    label: "Firebase Stack",
+    frontend: "React",
+    backend: "Firebase Functions",
+    database: "Firestore",
+    structure: "firebase"
+  },
+  DJANGO_REACT: {
+    id: "django-react",
+    label: "Django + React",
+    frontend: "React",
+    backend: "Django",
+    database: "PostgreSQL",
+    structure: "split"
+  },
+  LARAVEL_REACT: {
+    id: "laravel-react",
+    label: "Laravel + React",
+    frontend: "React",
+    backend: "Laravel",
+    database: "MySQL",
+    structure: "split"
+  },
+  CUSTOM: {
+    id: "custom",
+    label: "Custom Setup",
+    frontend: "User-selected",
+    backend: "User-selected",
+    database: "User-selected",
+    structure: "custom"
+  }
+};
+
+export const stackChoices = [
+  STACKS.MERN,
+  STACKS.PERN,
+  STACKS.MEAN,
+  STACKS.T3,
+  STACKS.FIREBASE,
+  STACKS.DJANGO_REACT,
+  STACKS.LARAVEL_REACT,
+  STACKS.CUSTOM
+].map((stack) => ({
+  name: stack.label,
+  value: stack
+}));
+
+export function resolveStack(value) {
+  const normalized = String(value).toLowerCase().replace(/[\s_+]+/g, "-");
+  const stack = Object.values(STACKS).find((candidate) => {
+    return candidate.id === normalized || candidate.label.toLowerCase().replace(/[\s_+]+/g, "-") === normalized;
+  });
+
+  if (!stack) {
+    const valid = Object.values(STACKS).map((candidate) => candidate.label).join(", ");
+    throw new Error(`Unknown stack "${value}". Choose one of: ${valid}`);
+  }
+
+  return stack;
+}

package/src/utils/names.js

@@ -0,0 +1,15 @@
+export function normalizeProjectName(value) {
+  return String(value || "")
+    .trim()
+    .toLowerCase()
+    .replace(/\s+/g, "-")
+    .replace(/[^a-z0-9._-]/g, "");
+}
+
+export function slugToTitle(value) {
+  return normalizeProjectName(value)
+    .split(/[-_]/g)
+    .filter(Boolean)
+    .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+    .join(" ");
+}

package/templates/README.md

@@ -0,0 +1,10 @@
+# Templates
+
+This CLI uses a modular JavaScript template engine in `src/generators/templates`.
+
+The folders below document the intended public template architecture for future static or community templates:
+
+- `frontend/react`, `frontend/next`, `frontend/vue`, `frontend/angular`
+- `backend/express`, `backend/django`, `backend/laravel`, `backend/nest`
+- `databases/mongodb`, `databases/postgres`, `databases/mysql`
+- `addons/auth`, `addons/docker`, `addons/testing`, `addons/eslint`

package/templates/addons/auth/.gitkeep

@@ -0,0 +1 @@
+

package/templates/addons/docker/.gitkeep

@@ -0,0 +1 @@
+

package/templates/addons/eslint/.gitkeep

@@ -0,0 +1 @@
+

package/templates/addons/testing/.gitkeep

@@ -0,0 +1 @@
+

package/templates/backend/django/.gitkeep

@@ -0,0 +1 @@
+

package/templates/backend/express/.gitkeep

@@ -0,0 +1 @@
+

package/templates/backend/laravel/.gitkeep

@@ -0,0 +1 @@
+

package/templates/backend/nest/.gitkeep

@@ -0,0 +1 @@
+

package/templates/databases/mongodb/.gitkeep

@@ -0,0 +1 @@
+

package/templates/databases/mysql/.gitkeep

@@ -0,0 +1 @@
+

package/templates/databases/postgres/.gitkeep

@@ -0,0 +1 @@
+

package/templates/frontend/angular/.gitkeep

@@ -0,0 +1 @@
+

package/templates/frontend/next/.gitkeep

@@ -0,0 +1 @@
+

package/templates/frontend/react/.gitkeep

@@ -0,0 +1 @@
+

package/templates/frontend/vue/.gitkeep

@@ -0,0 +1 @@
+