create-nodepress-app 1.0.0

package/README.md

@@ -0,0 +1,53 @@
+# NodePress CLI
+
+Scaffold a self-hosted [NodePress](https://gitlab.com/leo9karthik/nodepress) headless CMS project in one command.
+
+```bash
+npx nodepress new my-cms
+```
+
+## What it does
+
+- Clones the NodePress repository into a new folder
+- Generates cryptographically random `JWT_SECRET` and database password
+- Writes `backend/.env`, `frontend/.env.local`, and `.env` (Docker) with all values filled in
+- Runs `npm install` in both `backend/` and `frontend/`
+
+## Requirements
+
+- Node.js 18+
+- Git
+- PostgreSQL 14+ **or** Docker
+
+## Usage
+
+```bash
+npx nodepress new <project-name>
+npx nodepress --version
+npx nodepress --help
+```
+
+## Quick start
+
+```bash
+npx nodepress new my-cms
+cd my-cms
+
+# Option A — Docker (recommended)
+docker-compose -f docker-compose.prod.yml up -d
+
+# Option B — Local development
+cd backend && npx prisma migrate dev && npm run start:dev
+# In a second terminal:
+cd frontend && npm run dev
+```
+
+- Admin panel: `http://localhost:5173`
+- API: `http://localhost:3000/api`
+- API docs: `http://localhost:3000/api/docs`
+
+On first load the admin panel redirects to `/setup` where you create the first admin account.
+
+## License
+
+MIT

package/bin/nodepress.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+'use strict';
+
+const [,, command, ...args] = process.argv;
+
+const HELP = `
+  NodePress CLI
+
+  Usage:
+    npx nodepress new <project-name>   Scaffold a new NodePress project
+    npx nodepress --version            Show version
+    npx nodepress --help               Show this help
+
+  Examples:
+    npx nodepress new my-website
+    npx nodepress new company-cms
+`;
+
+switch (command) {
+  case 'new':
+    require('../src/new')(args[0]);
+    break;
+  case '--version':
+  case '-v':
+    console.log(require('../package.json').version);
+    break;
+  case '--help':
+  case '-h':
+  case undefined:
+    console.log(HELP);
+    break;
+  default:
+    console.error(`\n  Unknown command: "${command}"`);
+    console.log(HELP);
+    process.exit(1);
+}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "create-nodepress-app",
+  "version": "1.0.0",
+  "description": "Scaffold a self-hosted NodePress headless CMS in one command",
+  "keywords": [
+    "cms",
+    "headless",
+    "nestjs",
+    "nextjs",
+    "nodepress",
+    "self-hosted"
+  ],
+  "license": "MIT",
+  "author": "leo9karthik",
+  "homepage": "https://nodepress.buildwithkode.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/buildwithkode/nodepress.git"
+  },
+  "bin": {
+    "create-nodepress-app": "bin/nodepress.js"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {}
+}

package/src/new.js

@@ -0,0 +1,167 @@
+'use strict';
+
+const { execSync, spawnSync } = require('child_process');
+const { randomBytes } = require('crypto');
+const fs = require('fs');
+const path = require('path');
+
+const REPO_URL = 'https://github.com/buildwithkode/nodepress.git';
+
+// ANSI colours (degrade gracefully if not supported)
+const c = {
+  reset:  '\x1b[0m',
+  bold:   '\x1b[1m',
+  green:  '\x1b[32m',
+  blue:   '\x1b[34m',
+  yellow: '\x1b[33m',
+  cyan:   '\x1b[36m',
+  dim:    '\x1b[2m',
+};
+
+function log(msg)     { process.stdout.write(msg + '\n'); }
+function ok(msg)      { log(`  ${c.green}✔${c.reset}  ${msg}`); }
+function info(msg)    { log(`  ${c.blue}→${c.reset}  ${msg}`); }
+function warn(msg)    { log(`  ${c.yellow}⚠${c.reset}  ${msg}`); }
+function header(msg)  { log(`\n${c.bold}${msg}${c.reset}`); }
+
+function secret(bytes = 32) {
+  return randomBytes(bytes).toString('hex');
+}
+
+function writeEnvFile(filePath, vars) {
+  const content = Object.entries(vars)
+    .map(([k, v]) => (v === '' ? `# ${k}=` : `${k}="${v}"`))
+    .join('\n');
+  fs.writeFileSync(filePath, content + '\n', 'utf8');
+}
+
+function run(cmd, cwd, stdio = 'pipe') {
+  return spawnSync(cmd, { shell: true, cwd, stdio, encoding: 'utf8' });
+}
+
+module.exports = async function createProject(name) {
+  // ── Validate name ──────────────────────────────────────────────────────────
+  if (!name) {
+    log(`\n  ${c.bold}Usage:${c.reset} npx nodepress new <project-name>\n`);
+    process.exit(1);
+  }
+
+  const safeName = name.replace(/[^a-zA-Z0-9_-]/g, '-').toLowerCase();
+  const projectDir = path.resolve(process.cwd(), safeName);
+
+  if (fs.existsSync(projectDir)) {
+    warn(`Directory "${safeName}" already exists. Choose a different name.`);
+    process.exit(1);
+  }
+
+  header(`\n  NodePress — Creating "${safeName}"`);
+  log('');
+
+  // ── Check dependencies ─────────────────────────────────────────────────────
+  const hasGit    = run('git --version').status === 0;
+  const hasDocker = run('docker --version').status === 0;
+  const hasNode   = run('node --version').status === 0;
+
+  if (!hasNode) { warn('Node.js 18+ is required.'); process.exit(1); }
+  if (!hasGit)  { warn('Git is required. Install from https://git-scm.com'); process.exit(1); }
+
+  // ── Clone repository ───────────────────────────────────────────────────────
+  info(`Cloning NodePress into ./${safeName} …`);
+  const cloneResult = run(`git clone --depth 1 ${REPO_URL} "${safeName}"`, process.cwd(), 'inherit');
+  if (cloneResult.status !== 0) {
+    warn('Clone failed. Check your internet connection or the repository URL.');
+    process.exit(1);
+  }
+  ok('Repository cloned');
+
+  // Remove git history (this is a fresh project, not a fork)
+  // Use fs.rmSync for cross-platform support (rm -rf fails on Windows)
+  fs.rmSync(path.join(projectDir, '.git'), { recursive: true, force: true });
+  run(`git init`, projectDir);
+  ok('Fresh git repository initialized');
+
+  // ── Generate secrets ───────────────────────────────────────────────────────
+  const dbPassword = secret(24);
+  const jwtSecret  = secret(48);
+
+  // ── Write backend .env ─────────────────────────────────────────────────────
+  const dbUrl = `postgresql://postgres:${dbPassword}@localhost:5432/nodepress`;
+  const backendEnv = {
+    // Database — DIRECT_URL bypasses PgBouncer for migrations (same as DATABASE_URL in local dev)
+    DATABASE_URL:  dbUrl,
+    DIRECT_URL:    dbUrl,
+    PORT:          '3000',
+    JWT_SECRET:    jwtSecret,
+    CORS_ORIGIN:   'http://localhost:5173',
+    APP_URL:       'http://localhost:3000',
+    SITE_URL:      'http://localhost:5173',
+    // Email — configure to enable password reset emails
+    SMTP_HOST:     '',
+    SMTP_PORT:     '587',
+    SMTP_SECURE:   'false',
+    SMTP_USER:     '',
+    SMTP_PASS:     '',
+    SMTP_FROM:     '',
+  };
+  writeEnvFile(path.join(projectDir, 'backend', '.env'), backendEnv);
+  ok('backend/.env generated with random secrets');
+
+  // ── Write frontend .env.local ──────────────────────────────────────────────
+  const frontendEnv = {
+    BACKEND_URL: 'http://localhost:3000',
+  };
+  writeEnvFile(path.join(projectDir, 'frontend', '.env.local'), frontendEnv);
+  ok('frontend/.env.local generated');
+
+  // ── Write root .env (for Docker Compose) ──────────────────────────────────
+  const rootEnv = {
+    DB_PASSWORD:   dbPassword,
+    JWT_SECRET:    jwtSecret,
+    CORS_ORIGIN:   'http://localhost',
+    APP_URL:       'http://localhost:3000',
+    SITE_URL:      'http://localhost',
+  };
+  writeEnvFile(path.join(projectDir, '.env'), rootEnv);
+  ok('.env generated for Docker Compose');
+
+  // ── Install dependencies ───────────────────────────────────────────────────
+  info('Installing backend dependencies …');
+  run('npm install', path.join(projectDir, 'backend'), 'inherit');
+  ok('Backend dependencies installed');
+
+  info('Installing frontend dependencies …');
+  run('npm install', path.join(projectDir, 'frontend'), 'inherit');
+  ok('Frontend dependencies installed');
+
+  // ── Done ───────────────────────────────────────────────────────────────────
+  log('');
+  log(`  ${c.green}${c.bold}✓ NodePress "${safeName}" is ready!${c.reset}`);
+  log('');
+  log(`  ${c.bold}Next steps:${c.reset}`);
+  log('');
+
+  if (hasDocker) {
+    log(`  ${c.cyan}Option A — Docker (recommended for production):${c.reset}`);
+    log(`    cd ${safeName}`);
+    log(`    docker-compose -f docker-compose.prod.yml up -d`);
+    log('');
+    log(`  ${c.cyan}Option B — Local development:${c.reset}`);
+  } else {
+    log(`  ${c.cyan}Start local development:${c.reset}`);
+    warn('Docker not found — you\'ll need PostgreSQL running locally (port 5432)');
+  }
+
+  log(`    cd ${safeName}/backend`);
+  log(`    npx prisma migrate dev   ${c.dim}# create DB tables${c.reset}`);
+  log(`    npm run start:dev        ${c.dim}# backend on :3000${c.reset}`);
+  log('');
+  log(`    cd ${safeName}/frontend`);
+  log(`    npm run dev              ${c.dim}# admin panel on :5173${c.reset}`);
+  log('');
+  log(`  ${c.cyan}Admin panel:${c.reset}  http://localhost:5173`);
+  log(`  ${c.cyan}API docs:${c.reset}     http://localhost:3000/api/docs`);
+  log(`  ${c.cyan}Health check:${c.reset} http://localhost:3000/api/health`);
+  log('');
+  log(`  ${c.dim}Docs: https://nodepress.buildwithkode.com${c.reset}`);
+  log('');
+};