@codeenthusiast09/create-express-app 1.0.0

package/dist/installer.js

@@ -0,0 +1,146 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Installer = void 0;
+const execa_1 = __importDefault(require("execa"));
+const ora_1 = __importDefault(require("ora"));
+const chalk_1 = __importDefault(require("chalk"));
+/**
+ * Installer
+ *
+ * Handles post-generation tasks:
+ * - Installing dependencies
+ * - Initializing git repository
+ */
+class Installer {
+    constructor(config, projectPath) {
+        this.config = config;
+        this.projectPath = projectPath;
+    }
+    /**
+     * Install Dependencies
+     *
+     * Runs npm install in the project directory.
+     * Also installs database-specific dependencies.
+     */
+    async installDependencies() {
+        const spinner = (0, ora_1.default)("Installing dependencies...").start();
+        try {
+            // Base npm install
+            await (0, execa_1.default)("npm", ["install"], {
+                cwd: this.projectPath,
+                stdio: "pipe",
+            });
+            spinner.text = "Installing database dependencies...";
+            // Install database-specific dependencies
+            await this.installDatabaseDependencies();
+            spinner.succeed(chalk_1.default.green("Dependencies installed"));
+        }
+        catch (error) {
+            spinner.fail(chalk_1.default.red("Failed to install dependencies"));
+            throw error;
+        }
+    }
+    /**
+     * Install Database-Specific Dependencies
+     */
+    async installDatabaseDependencies() {
+        const deps = [];
+        const devDeps = [];
+        if (this.config.database === "mongodb") {
+            deps.push("mongoose");
+        }
+        else if (this.config.database === "postgresql") {
+            if (this.config.orm === "prisma") {
+                // Pin to Prisma 6 for stability
+                deps.push("@prisma/client@^6.0.0");
+                devDeps.push("prisma@^6.0.0");
+            }
+            else if (this.config.orm === "drizzle") {
+                deps.push("drizzle-orm", "pg");
+                devDeps.push("drizzle-kit", "@types/pg");
+            }
+        }
+        // Install production dependencies
+        if (deps.length > 0) {
+            await (0, execa_1.default)("npm", ["install", ...deps], {
+                cwd: this.projectPath,
+                stdio: "pipe",
+            });
+        }
+        // Install dev dependencies
+        if (devDeps.length > 0) {
+            await (0, execa_1.default)("npm", ["install", "--save-dev", ...devDeps], {
+                cwd: this.projectPath,
+                stdio: "pipe",
+            });
+        }
+        // Run post-install tasks for specific ORMs
+        await this.runPostInstallTasks();
+    }
+    /**
+     * Run Post-Install Tasks
+     *
+     * Runs necessary setup commands after dependencies are installed
+     */
+    async runPostInstallTasks() {
+        if (this.config.database === "postgresql" && this.config.orm === "prisma") {
+            const spinner = (0, ora_1.default)("Generating Prisma Client...").start();
+            try {
+                await (0, execa_1.default)("npx", ["prisma", "generate"], {
+                    cwd: this.projectPath,
+                    stdio: "pipe",
+                });
+                spinner.succeed(chalk_1.default.green("Prisma Client generated"));
+            }
+            catch (error) {
+                spinner.fail(chalk_1.default.red("Failed to generate Prisma Client"));
+                throw error;
+            }
+        }
+    }
+    /**
+     * Initialize Git Repository
+     *
+     * Runs git init and makes an initial commit.
+     */
+    async initGit() {
+        const spinner = (0, ora_1.default)("Initializing git repository...").start();
+        try {
+            // Initialize git
+            await (0, execa_1.default)("git", ["init"], {
+                cwd: this.projectPath,
+                stdio: "pipe",
+            });
+            // Configure git user (for the initial commit)
+            await (0, execa_1.default)("git", ["config", "user.email", "user@example.com"], {
+                cwd: this.projectPath,
+                stdio: "pipe",
+            });
+            await (0, execa_1.default)("git", ["config", "user.name", "User"], {
+                cwd: this.projectPath,
+                stdio: "pipe",
+            });
+            // Add all files
+            await (0, execa_1.default)("git", ["add", "."], {
+                cwd: this.projectPath,
+                stdio: "pipe",
+            });
+            // Initial commit
+            await (0, execa_1.default)("git", ["commit", "-m", "feat: initial project setup from create-express-app"], {
+                cwd: this.projectPath,
+                stdio: "pipe",
+            });
+            spinner.succeed(chalk_1.default.green("Git repository initialized"));
+        }
+        catch (error) {
+            spinner.fail(chalk_1.default.red("Failed to initialize git"));
+            // Don't throw - git init failing shouldn't stop the whole process
+            console.warn(chalk_1.default.yellow("You can initialize git manually later"));
+        }
+    }
+}
+exports.Installer = Installer;
+//# sourceMappingURL=installer.js.map

package/dist/installer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"installer.js","sourceRoot":"","sources":["../src/installer.ts"],"names":[],"mappings":"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"}

package/dist/prompts.d.ts

@@ -0,0 +1,19 @@
+/**
+ * User Choices Interface
+ *
+ * This defines what information we collect from the user
+ */
+export interface ProjectConfig {
+    projectName: string;
+    database: "mongodb" | "postgresql";
+    orm?: "prisma" | "drizzle";
+    includeDocker: boolean;
+}
+/**
+ * Ask User Questions
+ *
+ * This function shows interactive prompts and returns user's choices.
+ * Uses inquirer to create a nice CLI experience.
+ */
+export declare function promptUser(projectName?: string): Promise<ProjectConfig>;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,SAAS,GAAG,YAAY,CAAC;IACnC,GAAG,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC3B,aAAa,EAAE,OAAO,CAAC;CACxB;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAwD7E"}

package/dist/prompts.js

@@ -0,0 +1,67 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.promptUser = promptUser;
+const inquirer_1 = __importDefault(require("inquirer"));
+/**
+ * Ask User Questions
+ *
+ * This function shows interactive prompts and returns user's choices.
+ * Uses inquirer to create a nice CLI experience.
+ */
+async function promptUser(projectName) {
+    const answers = await inquirer_1.default.prompt([
+        // Project Name
+        {
+            type: "input",
+            name: "projectName",
+            message: "Project name:",
+            default: projectName || "my-express-app",
+            validate: (input) => {
+                // Check if name is valid (no spaces, special chars, etc.)
+                if (/^[a-z0-9-_]+$/.test(input)) {
+                    return true;
+                }
+                return "Project name can only contain lowercase letters, numbers, hyphens, and underscores";
+            },
+        },
+        // Database Choice
+        {
+            type: "list",
+            name: "database",
+            message: "Which database do you want to use?",
+            choices: [
+                { name: "MongoDB (with Mongoose)", value: "mongodb" },
+                { name: "PostgreSQL (with Prisma or Drizzle)", value: "postgresql" },
+            ],
+        },
+        // ORM Choice (only if PostgreSQL selected)
+        {
+            type: "list",
+            name: "orm",
+            message: "Which ORM for PostgreSQL?",
+            choices: [
+                {
+                    name: "Prisma (recommended - great DX, migrations)",
+                    value: "prisma",
+                },
+                {
+                    name: "Drizzle (newer - more type-safe, better performance)",
+                    value: "drizzle",
+                },
+            ],
+            when: (answers) => answers.database === "postgresql",
+        },
+        // Docker
+        {
+            type: "confirm",
+            name: "includeDocker",
+            message: "Include Docker setup?",
+            default: true,
+        },
+    ]);
+    return answers;
+}
+//# sourceMappingURL=prompts.js.map

package/dist/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":";;;;;AAoBA,gCAwDC;AA5ED,wDAAgC;AAchC;;;;;GAKG;AACI,KAAK,UAAU,UAAU,CAAC,WAAoB;IACnD,MAAM,OAAO,GAAG,MAAM,kBAAQ,CAAC,MAAM,CAAC;QACpC,eAAe;QACf;YACE,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,aAAa;YACnB,OAAO,EAAE,eAAe;YACxB,OAAO,EAAE,WAAW,IAAI,gBAAgB;YACxC,QAAQ,EAAE,CAAC,KAAa,EAAE,EAAE;gBAC1B,0DAA0D;gBAC1D,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;oBAChC,OAAO,IAAI,CAAC;gBACd,CAAC;gBACD,OAAO,oFAAoF,CAAC;YAC9F,CAAC;SACF;QAED,kBAAkB;QAClB;YACE,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,oCAAoC;YAC7C,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,yBAAyB,EAAE,KAAK,EAAE,SAAS,EAAE;gBACrD,EAAE,IAAI,EAAE,qCAAqC,EAAE,KAAK,EAAE,YAAY,EAAE;aACrE;SACF;QAED,2CAA2C;QAC3C;YACE,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,KAAK;YACX,OAAO,EAAE,2BAA2B;YACpC,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,6CAA6C;oBACnD,KAAK,EAAE,QAAQ;iBAChB;gBACD;oBACE,IAAI,EAAE,sDAAsD;oBAC5D,KAAK,EAAE,SAAS;iBACjB;aACF;YACD,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,KAAK,YAAY;SACrD;QAED,SAAS;QACT;YACE,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,eAAe;YACrB,OAAO,EAAE,uBAAuB;YAChC,OAAO,EAAE,IAAI;SACd;KACF,CAAC,CAAC;IAEH,OAAO,OAAwB,CAAC;AAClC,CAAC"}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@codeenthusiast09/create-express-app",
+  "version": "1.0.0",
+  "description": "CLI tool to generate production-ready Express TypeScript projects with flexible database options (MongoDB, PostgreSQL with Prisma or Drizzle)",
+  "main": "dist/index.js",
+  "bin": {
+    "create-express-app": "./bin/cli.cjs"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/CodeEnthusiast09/create-express-app"
+  },
+  "bugs": {
+    "url": "https://github.com/CodeEnthusiast09/create-express-app/issues"
+  },
+  "homepage": "https://github.com/CodeEnthusiast09/create-express-app#readme",
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "express",
+    "typescript",
+    "cli",
+    "boilerplate",
+    "generator",
+    "mongodb",
+    "postgresql",
+    "prisma",
+    "drizzle",
+    "mongoose",
+    "scaffolding",
+    "template"
+  ],
+  "author": "O'Brien Taiwo <obrienadedapo15@gmail.com>",
+  "license": "MIT",
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "commander": "^11.1.0",
+    "inquirer": "^8.2.6",
+    "ora": "^5.4.1",
+    "fs-extra": "^11.2.0",
+    "execa": "^5.1.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.19",
+    "@types/inquirer": "^9.0.7",
+    "@types/fs-extra": "^11.0.4",
+    "typescript": "^5.3.3",
+    "tsx": "^4.7.1"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "templates"
+  ]
+}

package/templates/boilerplate/.env.example

@@ -0,0 +1,24 @@
+# Application
+NODE_ENV=development
+PORT=3000
+
+# Database
+# Choose one based on your database:
+
+# MongoDB (Mongoose)
+DATABASE_URL=mongodb://localhost:27017/myapp
+
+# PostgreSQL (Prisma or Drizzle)
+# DATABASE_URL=postgresql://user:password@localhost:5432/myapp
+
+
+# JWT Configuration
+JWT_SECRET=your-super-secret-jwt-key-min-32-characters-for security
+JWT_EXPIRES_IN=7d
+
+# CORS Configuration
+CORS_ORIGIN=*
+CORS_CREDENTIALS=false
+
+# Logging
+LOG_LEVEL=info

package/templates/boilerplate/.eslintrc.cjs

@@ -0,0 +1,27 @@
+module.exports = {
+  parser: "@typescript-eslint/parser",
+  parserOptions: {
+    project: "tsconfig.json",
+    tsconfigRootDir: __dirname,
+    sourceType: "module",
+  },
+  plugins: ["@typescript-eslint"],
+  extends: [
+    "eslint:recommended",
+    "plugin:@typescript-eslint/recommended",
+    "plugin:@typescript-eslint/recommended-requiring-type-checking",
+  ],
+  root: true,
+  env: {
+    node: true,
+    jest: true,
+  },
+  ignorePatterns: [".eslintrc.js", "dist", "node_modules"],
+  rules: {
+    "@typescript-eslint/interface-name-prefix": "off",
+    "@typescript-eslint/explicit-function-return-type": "off",
+    "@typescript-eslint/explicit-module-boundary-types": "off",
+    "@typescript-eslint/no-explicit-any": "warn",
+    "@typescript-eslint/no-unused-vars": ["error", { argsIgnorePattern: "^_" }],
+  },
+};

package/templates/boilerplate/.prettierrc

@@ -0,0 +1,9 @@
+{
+  "semi": true,
+  "trailingComma": "all",
+  "singleQuote": true,
+  "printWidth": 100,
+  "tabWidth": 2,
+  "arrowParens": "always",
+  "endOfLine": "lf"
+}

package/templates/boilerplate/DEPENDENCIES.md

@@ -0,0 +1,43 @@
+# Database Dependencies
+
+This boilerplate supports three database options. The CLI will automatically install the correct dependencies based on your choice.
+
+## MongoDB with Mongoose (Default)
+
+```bash
+npm install mongoose
+npm install -D @types/mongoose
+```
+
+## PostgreSQL with Prisma
+
+```bash
+npm install @prisma/client
+npm install -D prisma
+```
+
+After installation, run:
+
+```bash
+npx prisma init
+npx prisma migrate dev
+npx prisma generate
+```
+
+## PostgreSQL with Drizzle
+
+```bash
+npm install drizzle-orm pg
+npm install -D drizzle-kit @types/pg
+```
+
+After installation, run:
+
+```bash
+npx drizzle-kit generate:pg
+npx drizzle-kit push:pg
+```
+
+---
+
+**Note:** The CLI tool will handle all of this automatically during project setup.