create-stackflow 1.0.0

package/src/generators/root.js

@@ -0,0 +1,70 @@
+import path from "node:path";
+import fs from "fs-extra";
+import { writeTemplate } from "../utils/template.js";
+
+export async function createRootFiles(context) {
+  const frontendName = path.basename(context.frontendDir);
+  const backendName = path.basename(context.backendDir);
+
+  await writeTemplate(
+    path.join(context.projectDir, "package.json"),
+    `{
+  "name": "{{projectName}}",
+  "version": "1.0.0",
+  "private": true,
+  "scripts": {
+    "dev": "concurrently \\"npm run dev --workspace {{backendName}}\\" \\"npm run dev --workspace {{frontendName}}\\"",
+    "dev:frontend": "npm run dev --workspace {{frontendName}}",
+    "dev:backend": "npm run dev --workspace {{backendName}}"
+  },
+  "workspaces": [
+    "{{frontendName}}",
+    "{{backendName}}"
+  ],
+  "devDependencies": {
+    "concurrently": "latest"
+  }
+}
+`,
+    { ...context, frontendName, backendName }
+  );
+
+  await writeTemplate(
+    path.join(context.projectDir, "README.md"),
+    `# {{projectName}}
+
+Generated with \`create-stackflow\`.
+
+## Development
+
+\`\`\`bash
+npm run dev
+\`\`\`
+
+Frontend runs on Vite/Next.js. Backend runs on Express at \`http://localhost:5000\`.
+
+## Environment
+
+MongoDB local connection:
+
+\`\`\`
+mongodb://127.0.0.1:27017/{{databaseName}}
+\`\`\`
+`,
+    context
+  );
+
+  await fs.outputFile(
+    path.join(context.projectDir, ".gitignore"),
+    `node_modules
+.env
+.env.*
+dist
+build
+.next
+coverage
+uploads/*
+!uploads/.gitkeep
+`
+  );
+}

package/src/utils/names.js

@@ -0,0 +1,15 @@
+export function formatName(value) {
+  return String(value || "")
+    .trim()
+    .toLowerCase()
+    .replace(/\s+/g, "-")
+    .replace(/[^a-z0-9._-]/g, "-")
+    .replace(/-+/g, "-")
+    .replace(/^-|-$/g, "");
+}
+
+export function titleCase(value) {
+  return String(value || "")
+    .replace(/[-_]/g, " ")
+    .replace(/\b\w/g, (letter) => letter.toUpperCase());
+}

package/src/utils/prompts.js

@@ -0,0 +1,378 @@
+import inquirer from "inquirer";
+
+export async function askQuestions(projectName) {
+  return inquirer.prompt([
+    new inquirer.Separator("━━━━━━━━━━━━━━━━━━━━"),
+    new inquirer.Separator("BASIC PROJECT SETUP"),
+    new inquirer.Separator("━━━━━━━━━━━━━━━━━━━━"),
+    {
+      name: "projectName",
+      message: "Project name?",
+      default: projectName || "my-stackflow-app"
+    },
+    {
+      name: "frontendName",
+      message: "Frontend folder name?",
+      default: "frontend"
+    },
+    {
+      name: "backendName",
+      message: "Backend folder name?",
+      default: "backend"
+    },
+    new inquirer.Separator("━━━━━━━━━━━━━━━━━━━━"),
+    new inquirer.Separator("FRONTEND SETUP"),
+    new inquirer.Separator("━━━━━━━━━━━━━━━━━━━━"),
+    {
+      type: "list",
+      name: "frontend",
+      message: "Frontend framework?",
+      choices: [
+        { name: "React", value: "react" },
+        { name: "Next.js", value: "next" }
+      ],
+      default: "react"
+    },
+    {
+      type: "list",
+      name: "language",
+      message: "Language?",
+      choices: [
+        { name: "TypeScript", value: "typescript" },
+        { name: "JavaScript", value: "javascript" }
+      ],
+      default: "typescript"
+    },
+    {
+      type: "list",
+      name: "styling",
+      message: "Styling solution?",
+      choices: [
+        { name: "Tailwind CSS", value: "tailwind" },
+        { name: "SCSS", value: "scss" },
+        { name: "CSS Modules", value: "css-modules" },
+        { name: "Styled Components", value: "styled-components" }
+      ],
+      default: "tailwind"
+    },
+    {
+      type: "list",
+      name: "uiLibrary",
+      message: "Use UI library?",
+      choices: [
+        { name: "Shadcn UI", value: "shadcn" },
+        { name: "Material UI", value: "mui" },
+        { name: "Ant Design", value: "antd" },
+        { name: "Chakra UI", value: "chakra" },
+        { name: "None", value: "none" }
+      ],
+      default: "shadcn"
+    },
+    {
+      type: "list",
+      name: "iconLibrary",
+      message: "Icon library?",
+      choices: [
+        { name: "Lucide React", value: "lucide-react" },
+        { name: "React Icons", value: "react-icons" },
+        { name: "Heroicons", value: "heroicons" }
+      ],
+      default: "lucide-react"
+    },
+    {
+      type: "confirm",
+      name: "router",
+      message: "Use React Router DOM?",
+      default: true,
+      when: (answers) => answers.frontend === "react"
+    },
+    {
+      type: "list",
+      name: "state",
+      message: "State management?",
+      choices: [
+        { name: "Zustand", value: "zustand" },
+        { name: "Redux Toolkit", value: "redux-toolkit" },
+        { name: "Context API", value: "context-api" },
+        { name: "Jotai", value: "jotai" },
+        { name: "Recoil", value: "recoil" },
+        { name: "None", value: "none" }
+      ],
+      default: "zustand"
+    },
+    {
+      type: "list",
+      name: "dataFetching",
+      message: "Data fetching library?",
+      choices: [
+        { name: "Axios", value: "axios" },
+        { name: "Fetch API", value: "fetch" }
+      ],
+      default: "axios"
+    },
+    {
+      type: "confirm",
+      name: "tanstackQuery",
+      message: "Use TanStack Query?",
+      default: false
+    },
+    {
+      type: "list",
+      name: "form",
+      message: "Form handling library?",
+      choices: [
+        { name: "React Hook Form", value: "react-hook-form" },
+        { name: "Formik", value: "formik" },
+        { name: "None", value: "none" }
+      ],
+      default: "react-hook-form"
+    },
+    {
+      type: "list",
+      name: "validation",
+      message: "Validation library?",
+      choices: [
+        { name: "Zod", value: "zod" },
+        { name: "Yup", value: "yup" },
+        { name: "Joi", value: "joi" },
+        { name: "None", value: "none" }
+      ],
+      default: "zod"
+    },
+    {
+      type: "confirm",
+      name: "authPages",
+      message: "Generate authentication pages?",
+      default: true
+    },
+    {
+      type: "confirm",
+      name: "protectedRoutes",
+      message: "Generate protected routes?",
+      default: true
+    },
+    {
+      type: "confirm",
+      name: "darkMode",
+      message: "Add dark/light theme support?",
+      default: true
+    },
+    {
+      type: "list",
+      name: "animation",
+      message: "Animation library?",
+      choices: [
+        { name: "Framer Motion", value: "framer-motion" },
+        { name: "GSAP", value: "gsap" },
+        { name: "None", value: "none" }
+      ],
+      default: "none"
+    },
+    {
+      type: "list",
+      name: "toast",
+      message: "Toast notification library?",
+      choices: [
+        { name: "Sonner", value: "sonner" },
+        { name: "React Hot Toast", value: "react-hot-toast" },
+        { name: "Notistack", value: "notistack" },
+        { name: "None", value: "none" }
+      ],
+      default: "sonner"
+    },
+    {
+      type: "list",
+      name: "chart",
+      message: "Chart library?",
+      choices: [
+        { name: "Recharts", value: "recharts" },
+        { name: "Chart.js", value: "chartjs" },
+        { name: "ApexCharts", value: "apexcharts" },
+        { name: "None", value: "none" }
+      ],
+      default: "none"
+    },
+    {
+      type: "list",
+      name: "dragDropUpload",
+      message: "Add drag and drop upload?",
+      choices: [
+        { name: "React Dropzone", value: "react-dropzone" },
+        { name: "None", value: "none" }
+      ],
+      default: "none"
+    },
+    {
+      type: "confirm",
+      name: "eslint",
+      message: "Add ESLint?",
+      default: true
+    },
+    {
+      type: "confirm",
+      name: "prettier",
+      message: "Add Prettier?",
+      default: true
+    },
+    new inquirer.Separator("━━━━━━━━━━━━━━━━━━━━"),
+    new inquirer.Separator("BACKEND SETUP"),
+    new inquirer.Separator("━━━━━━━━━━━━━━━━━━━━"),
+    {
+      type: "list",
+      name: "backendFramework",
+      message: "Backend framework?",
+      choices: ["Express.js", "Fastify", "NestJS"],
+      default: "Express.js"
+    },
+    {
+      type: "list",
+      name: "backendLanguage",
+      message: "Backend language?",
+      choices: [
+        { name: "JavaScript", value: "javascript" },
+        { name: "TypeScript", value: "typescript" }
+      ],
+      default: "javascript"
+    },
+    {
+      type: "list",
+      name: "database",
+      message: "Database?",
+      choices: ["MongoDB", "PostgreSQL", "MySQL", "SQLite"],
+      default: "MongoDB"
+    },
+    {
+      type: "list",
+      name: "orm",
+      message: "ODM / ORM?",
+      choices: ["Mongoose", "Prisma", "Sequelize", "Drizzle", "TypeORM"],
+      default: "Mongoose"
+    },
+    {
+      type: "list",
+      name: "authStrategy",
+      message: "Authentication strategy?",
+      choices: ["JWT", "Session Auth", "Firebase Auth", "Clerk", "Supabase Auth", "None"],
+      default: "JWT"
+    },
+    {
+      type: "list",
+      name: "passwordHashing",
+      message: "Password hashing library?",
+      choices: ["bcryptjs", "argon2"],
+      default: "bcryptjs"
+    },
+    {
+      type: "list",
+      name: "fileUpload",
+      message: "File upload solution?",
+      choices: ["Multer", "Cloudinary", "Cloudflare R2", "AWS S3", "UploadThing", "None"],
+      default: "Multer"
+    },
+    {
+      type: "list",
+      name: "backendValidation",
+      message: "Backend validation library?",
+      choices: ["Zod", "Joi", "express-validator", "None"],
+      default: "None"
+    },
+    {
+      type: "checkbox",
+      name: "securityPackages",
+      message: "Add security packages?",
+      choices: [
+        { name: "helmet", value: "helmet", checked: true },
+        { name: "cors", value: "cors", checked: true },
+        { name: "express-rate-limit", value: "express-rate-limit", checked: true },
+        { name: "hpp", value: "hpp", checked: true }
+      ]
+    },
+    {
+      type: "confirm",
+      name: "cookieParser",
+      message: "Use cookie-parser?",
+      default: true
+    },
+    {
+      type: "list",
+      name: "logging",
+      message: "Logging library?",
+      choices: ["Morgan", "Winston", "Pino", "None"],
+      default: "Morgan"
+    },
+    {
+      type: "confirm",
+      name: "swagger",
+      message: "Add Swagger/OpenAPI docs?",
+      default: true
+    },
+    {
+      type: "confirm",
+      name: "socketio",
+      message: "Add Socket.IO?",
+      default: false
+    },
+    {
+      type: "list",
+      name: "emailService",
+      message: "Email service?",
+      choices: ["Nodemailer", "Resend", "AWS SES", "SendGrid", "Mailgun", "Postmark", "None"],
+      default: "None"
+    },
+    new inquirer.Separator("━━━━━━━━━━━━━━━━━━━━"),
+    new inquirer.Separator("CRUD GENERATION"),
+    new inquirer.Separator("━━━━━━━━━━━━━━━━━━━━"),
+    {
+      type: "checkbox",
+      name: "crudModules",
+      message: "Generate CRUD modules?",
+      choices: [
+        { name: "Users", value: "users", checked: true },
+        { name: "Products", value: "products", checked: true },
+        { name: "Categories", value: "categories", checked: true },
+        { name: "Orders", value: "orders", checked: true },
+        { name: "Blogs", value: "blogs", checked: true }
+      ]
+    },
+    new inquirer.Separator("━━━━━━━━━━━━━━━━━━━━"),
+    new inquirer.Separator("AUTH FEATURES"),
+    new inquirer.Separator("━━━━━━━━━━━━━━━━━━━━"),
+    {
+      type: "checkbox",
+      name: "authFeatures",
+      message: "Add auth features?",
+      choices: [
+        { name: "Login", value: "login", checked: true },
+        { name: "Register", value: "register", checked: true },
+        { name: "Forgot Password", value: "forgot-password", checked: true },
+        { name: "Reset Password", value: "reset-password", checked: true },
+        { name: "Email Verification", value: "email-verification", checked: true },
+        { name: "Role-based Access", value: "roles", checked: true },
+        { name: "Refresh Tokens", value: "refresh-tokens", checked: true }
+      ]
+    },
+    new inquirer.Separator("━━━━━━━━━━━━━━━━━━━━"),
+    new inquirer.Separator("ADMIN PANEL"),
+    new inquirer.Separator("━━━━━━━━━━━━━━━━━━━━"),
+    {
+      type: "confirm",
+      name: "adminDashboard",
+      message: "Generate admin dashboard?",
+      default: true
+    }
+  ]).then((answers) => ({
+    ...answers,
+    tailwind: answers.styling === "tailwind",
+    shadcn: answers.uiLibrary === "shadcn",
+    axios: answers.dataFetching === "axios",
+    form: answers.form !== "none",
+    winston: answers.logging === "Winston",
+    morgan: answers.logging === "Morgan",
+    cloudinary: answers.fileUpload === "Cloudinary",
+    multer: answers.fileUpload === "Multer",
+    hpp: answers.securityPackages.includes("hpp"),
+    helmet: answers.securityPackages.includes("helmet"),
+    cors: answers.securityPackages.includes("cors"),
+    rateLimit: answers.securityPackages.includes("express-rate-limit")
+  }));
+}

package/src/utils/template.js

@@ -0,0 +1,17 @@
+import fs from "fs-extra";
+
+export async function writeTemplate(file, content, context = {}) {
+  let output = content;
+  for (const [key, value] of Object.entries(context)) {
+    output = output.replaceAll(`{{${key}}}`, String(value));
+  }
+  await fs.outputFile(file, output);
+}
+
+export function ext(context) {
+  return context.language === "typescript" ? "ts" : "js";
+}
+
+export function jsxExt(context) {
+  return context.language === "typescript" ? "tsx" : "jsx";
+}