create-momentum-app 0.1.7 → 0.1.8

package/index.cjs

@@ -29,6 +29,7 @@ var import_picocolors2 = __toESM(require("picocolors"));
 // apps/create-momentum-app/src/create-project.ts
 var import_node_path = __toESM(require("node:path"));
 var import_node_child_process = require("node:child_process");
+var import_promises = require("node:timers/promises");
 var import_fs_extra = __toESM(require("fs-extra"));
 var import_picocolors = __toESM(require("picocolors"));
 var TEMPLATE_EXT = ".tmpl";
@@ -66,8 +67,95 @@ function copyTemplateDir(srcDir, destDir, vars) {
     }
   }
 }
+function isDockerInstalled() {
+  try {
+    (0, import_node_child_process.execFileSync)("docker", ["--version"], { stdio: "pipe", timeout: 5e3, shell: true });
+    return true;
+  } catch {
+    return false;
+  }
+}
+function isDockerRunning() {
+  try {
+    (0, import_node_child_process.execFileSync)("docker", ["info"], { stdio: "pipe", timeout: 5e3, shell: true });
+    return true;
+  } catch {
+    return false;
+  }
+}
+function displayDockerInstallInstructions() {
+  console.log(import_picocolors.default.yellow("\n\u26A0\uFE0F  Docker is not installed."));
+  console.log();
+  console.log("To use Docker for PostgreSQL, please install Docker:");
+  console.log();
+  const platform = process.platform;
+  if (platform === "darwin") {
+    console.log(
+      "  macOS: Download Docker Desktop from https://www.docker.com/products/docker-desktop/"
+    );
+  } else if (platform === "linux") {
+    console.log("  Linux: Run the following command:");
+    console.log(import_picocolors.default.dim("  curl -fsSL https://get.docker.com | sh"));
+    console.log();
+    console.log("  Or install via your package manager:");
+    console.log(import_picocolors.default.dim("  sudo apt-get install docker.io docker-compose-plugin  # Ubuntu/Debian"));
+    console.log(import_picocolors.default.dim("  sudo dnf install docker docker-compose-plugin        # Fedora/RHEL"));
+  } else if (platform === "win32") {
+    console.log(
+      "  Windows: Download Docker Desktop from https://www.docker.com/products/docker-desktop/"
+    );
+    console.log("  Note: Requires WSL2. See https://docs.docker.com/desktop/windows/install/");
+  } else {
+    console.log("  Visit https://docs.docker.com/get-docker/");
+  }
+  console.log();
+  console.log(
+    "You can still use an external PostgreSQL instance by updating the DATABASE_URL in .env"
+  );
+  console.log();
+}
+function startPostgresContainer(projectDir) {
+  try {
+    console.log(import_picocolors.default.dim("Starting PostgreSQL container..."));
+    (0, import_node_child_process.execFileSync)("docker", ["compose", "up", "-d"], {
+      cwd: projectDir,
+      stdio: "inherit",
+      shell: true
+    });
+  } catch (error) {
+    throw new Error(`Failed to start Docker container: ${error}`);
+  }
+}
+function waitForPostgres(projectDir, timeout = 3e4) {
+  return new Promise((resolve) => {
+    const startTime = Date.now();
+    const interval = 1e3;
+    const checkHealth = async () => {
+      while (Date.now() - startTime <= timeout) {
+        try {
+          (0, import_node_child_process.execFileSync)(
+            "docker",
+            ["compose", "exec", "-T", "postgres", "pg_isready", "-U", "postgres"],
+            {
+              cwd: projectDir,
+              stdio: "pipe",
+              timeout: 5e3,
+              shell: true
+            }
+          );
+          resolve(true);
+          return;
+        } catch {
+          await (0, import_promises.setTimeout)(interval);
+        }
+      }
+      resolve(false);
+    };
+    void checkHealth();
+  });
+}
 async function createProject(options) {
-  const { projectName, flavor, database, install, registry } = options;
+  const { projectName, flavor, database, install, docker, registry } = options;
   const projectDir = import_node_path.default.resolve(process.cwd(), projectName);
   if (import_fs_extra.default.existsSync(projectDir)) {
     console.error(import_picocolors.default.red(`
@@ -96,7 +184,42 @@ const pool = (dbAdapter as PostgresAdapterWithRaw).getPool();` : "",
     dbDevPackage: database === "postgres" ? "" : '"@types/better-sqlite3": "^7.6.13",',
     envDbVar: database === "postgres" ? "DATABASE_URL=postgresql://postgres:postgres@localhost:5432/momentum" : "DATABASE_PATH=./data/momentum.db",
     defaultPort: "4200",
-    externalDependencies: database === "postgres" ? '"pg", "pg-native"' : '"better-sqlite3"'
+    externalDependencies: database === "postgres" ? '"pg", "pg-native"' : '"better-sqlite3"',
+    prerequisitesDocker: database === "postgres" ? `- **Docker** (for PostgreSQL database)
+  - [macOS](https://www.docker.com/products/docker-desktop/)
+  - [Linux](https://docs.docker.com/engine/install/)
+  - [Windows](https://docs.docker.com/desktop/windows/install/) (requires WSL2)` : "",
+    databaseSection: database === "postgres" ? `### PostgreSQL
+
+This project uses PostgreSQL via Docker. The database is configured in \`docker-compose.yml\`.
+
+**Connection Details:**
+- Host: \`localhost\`
+- Port: \`5432\`
+- Database: \`momentum\`
+- Username: \`postgres\`
+- Password: \`postgres\`
+
+**Docker Commands:**
+
+\`\`\`bash
+# Start database
+docker compose up -d
+
+# Stop database
+docker compose down
+
+# Stop and remove data
+docker compose down -v
+
+# View logs
+docker compose logs -f postgres
+\`\`\`
+
+You can also use an external PostgreSQL instance by updating \`DATABASE_URL\` in \`.env\`.` : `### SQLite
+
+This project uses SQLite with the database file at \`./data/momentum.db\`.  
+The database is automatically created on first run - no setup required.`
   };
   console.log();
   console.log(import_picocolors.default.cyan(`Creating ${import_picocolors.default.bold(projectName)} with ${flavor} + ${database}...`));
@@ -104,6 +227,51 @@ const pool = (dbAdapter as PostgresAdapterWithRaw).getPool();` : "",
   import_fs_extra.default.ensureDirSync(projectDir);
   copyTemplateDir(import_node_path.default.join(templatesDir, "shared"), projectDir, vars);
   copyTemplateDir(import_node_path.default.join(templatesDir, flavor), projectDir, vars);
+  const envExample = import_node_path.default.join(projectDir, ".env.example");
+  const envFile = import_node_path.default.join(projectDir, ".env");
+  import_fs_extra.default.copyFileSync(envExample, envFile);
+  console.log(import_picocolors.default.dim("Created .env file"));
+  console.log();
+  if (database !== "postgres" || !docker) {
+    const dockerComposePath = import_node_path.default.join(projectDir, "docker-compose.yml");
+    if (import_fs_extra.default.existsSync(dockerComposePath)) {
+      import_fs_extra.default.removeSync(dockerComposePath);
+    }
+  }
+  let dockerSetupSuccess = false;
+  if (database === "postgres" && docker) {
+    if (!isDockerInstalled()) {
+      displayDockerInstallInstructions();
+    } else if (!isDockerRunning()) {
+      console.log(import_picocolors.default.yellow("\n\u26A0\uFE0F  Docker is installed but not running."));
+      console.log();
+      console.log("Please start Docker Desktop or run:");
+      console.log(import_picocolors.default.dim("  sudo systemctl start docker"));
+      console.log();
+      console.log("Then run:");
+      console.log(import_picocolors.default.dim(`  cd ${projectName} && docker compose up -d`));
+      console.log();
+    } else {
+      try {
+        startPostgresContainer(projectDir);
+        const ready = await waitForPostgres(projectDir);
+        if (ready) {
+          console.log(import_picocolors.default.green("\u2713 PostgreSQL ready at localhost:5432"));
+          console.log();
+          dockerSetupSuccess = true;
+        } else {
+          console.log(import_picocolors.default.yellow("\u26A0\uFE0F  PostgreSQL container started but not ready yet."));
+          console.log(import_picocolors.default.dim("  Check status: docker compose logs -f"));
+          console.log();
+        }
+      } catch (error) {
+        console.log(import_picocolors.default.yellow(`
+\u26A0\uFE0F  Failed to start PostgreSQL: ${error}`));
+        console.log(import_picocolors.default.dim("  Try manually: cd " + projectName + " && docker compose up -d"));
+        console.log();
+      }
+    }
+  }
   if (install) {
     console.log(import_picocolors.default.dim("Installing dependencies..."));
     const args = ["install"];
@@ -112,7 +280,8 @@ const pool = (dbAdapter as PostgresAdapterWithRaw).getPool();` : "",
     }
     (0, import_node_child_process.execFileSync)("npm", args, {
       cwd: projectDir,
-      stdio: "inherit"
+      stdio: "inherit",
+      shell: true
     });
     console.log();
   }
@@ -124,6 +293,9 @@ const pool = (dbAdapter as PostgresAdapterWithRaw).getPool();` : "",
   if (!install) {
     console.log(import_picocolors.default.dim("  npm install"));
   }
+  if (database === "postgres" && docker && !dockerSetupSuccess) {
+    console.log(import_picocolors.default.dim("  docker compose up -d"));
+  }
   console.log(import_picocolors.default.dim("  npm run dev"));
   console.log();
   console.log(import_picocolors.default.dim("  Open http://localhost:" + vars.defaultPort + "/admin"));
@@ -150,6 +322,8 @@ function parseArgs(argv) {
       }
     } else if (arg === "--no-install") {
       opts.install = false;
+    } else if (arg === "--docker") {
+      opts.docker = true;
     } else if (arg === "--registry" && args[i + 1]) {
       opts.registry = args[++i];
     } else if (!arg.startsWith("-") && !opts.projectName) {
@@ -199,6 +373,12 @@ async function runCLI() {
         name: "install",
         message: "Install dependencies?",
         initial: true
+      },
+      {
+        type: cliArgs.docker !== void 0 || cliArgs.database !== "postgres" ? null : "confirm",
+        name: "docker",
+        message: "Set up PostgreSQL with Docker?",
+        initial: true
       }
     ],
     {
@@ -208,11 +388,13 @@ async function runCLI() {
       }
     }
   );
+  const database = cliArgs.database ?? response.database;
   const options = {
     projectName: cliArgs.projectName ?? response.projectName,
     flavor: cliArgs.flavor ?? response.flavor,
-    database: cliArgs.database ?? response.database,
+    database,
     install: cliArgs.install ?? response.install ?? true,
+    docker: database === "postgres" ? cliArgs.docker ?? response.docker ?? false : false,
     registry: cliArgs.registry
   };
   await createProject(options);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-momentum-app",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "Create a new Momentum CMS application",
   "license": "MIT",
   "author": "Momentum CMS Contributors",

package/templates/shared/README.md.tmpl

@@ -2,12 +2,18 @@
 
 A [Momentum CMS](https://github.com/momentum-cms/momentum-cms) application.
 
+## Prerequisites
+
+- **Node.js** 20 or higher
+{{prerequisitesDocker}}
+
+## Database
+
+{{databaseSection}}
+
 ## Getting Started
 
 ```bash
-# Copy environment variables
-cp .env.example .env
-
 # Start the dev server
 npm run dev
 ```

package/templates/shared/docker-compose.yml.tmpl

@@ -0,0 +1,26 @@
+# Docker Compose configuration for {{projectName}}
+# This file sets up a PostgreSQL database for local development
+# For production, consider using managed database services
+
+services:
+  postgres:
+    image: postgres:16-alpine
+    container_name: {{projectName}}-postgres
+    restart: unless-stopped
+    ports:
+      - "5432:5432"
+    environment:
+      POSTGRES_USER: postgres
+      POSTGRES_PASSWORD: postgres
+      POSTGRES_DB: momentum
+    volumes:
+      - {{projectName}}_postgres_data:/var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U postgres"]
+      interval: 5s
+      timeout: 5s
+      retries: 5
+
+volumes:
+  {{projectName}}_postgres_data:
+    driver: local