@webhikers/cli 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Webhikers
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,39 @@
+# @webhikers/cli
+
+CLI for creating and deploying webhikers projects.
+
+## Install
+
+```bash
+npm install -g @webhikers/cli
+```
+
+## Setup (once per machine)
+
+```bash
+webhikers config
+```
+
+Configures Coolify API token, server credentials, and SSH key.
+
+## Create a new project
+
+```bash
+webhikers create my-project
+```
+
+This will:
+1. Create a private GitHub repo from the `nextjs-vibe-starter` template
+2. Clone it and install dependencies
+3. Generate `.env` with a random `PAYLOAD_SECRET`
+4. Create a Coolify project and configure the domain (`my-project.webhikers.site`)
+
+After creation, add persistent volumes in Coolify UI, then start developing:
+
+```bash
+cd my-project && npm run dev
+```
+
+## License
+
+MIT

package/bin/webhikers.js

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+
+import { program } from "commander";
+import { configCommand } from "../src/commands/config.js";
+import { createCommand } from "../src/commands/create.js";
+
+program
+  .name("webhikers")
+  .description("CLI for creating and deploying webhikers projects")
+  .version("1.0.0");
+
+program
+  .command("config")
+  .description("Configure Coolify token, server, and SSH credentials")
+  .action(configCommand);
+
+program
+  .command("create <name>")
+  .description("Create a new project from the nextjs-vibe-starter template")
+  .action(createCommand);
+
+program.parse();

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@webhikers/cli",
+  "version": "1.0.0",
+  "description": "CLI for creating and deploying webhikers projects",
+  "type": "module",
+  "bin": {
+    "webhikers": "./bin/webhikers.js"
+  },
+  "dependencies": {
+    "commander": "^13.0.0",
+    "inquirer": "^12.0.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "bin",
+    "src"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Webhikers/webhikers-cli.git"
+  }
+}

package/src/commands/config.js

@@ -0,0 +1,96 @@
+import inquirer from "inquirer";
+import {
+  loadConfig,
+  saveConfig,
+  maskValue,
+  getConfigPath,
+} from "../utils/config-store.js";
+import { saveSSHKey, getSSHKeyPath } from "../utils/ssh-key.js";
+
+export async function configCommand() {
+  const existing = loadConfig();
+
+  if (existing) {
+    console.log("\nExisting configuration found:");
+    console.log(`  Coolify URL:    ${existing.coolifyUrl || "—"}`);
+    console.log(`  Coolify Token:  ${maskValue(existing.coolifyToken)}`);
+    console.log(`  Server UUID:    ${maskValue(existing.serverUuid)}`);
+    console.log(`  Server IP:      ${existing.serverIp || "—"}`);
+    console.log(`  SSH User:       ${existing.sshUser || "—"}`);
+    console.log(`  SSH Key:        ${getSSHKeyPath()}`);
+    console.log("");
+
+    const { overwrite } = await inquirer.prompt([
+      {
+        type: "confirm",
+        name: "overwrite",
+        message: "Overwrite existing configuration?",
+        default: false,
+      },
+    ]);
+
+    if (!overwrite) {
+      console.log("Configuration unchanged.");
+      return;
+    }
+  }
+
+  const answers = await inquirer.prompt([
+    {
+      type: "input",
+      name: "coolifyUrl",
+      message: "Coolify URL (e.g. https://coolify.your-server.de):",
+      validate: (v) => (v.startsWith("http") ? true : "Must start with http"),
+    },
+    {
+      type: "password",
+      name: "coolifyToken",
+      message: "Coolify API Token:",
+      mask: "*",
+      validate: (v) => (v.length > 0 ? true : "Token is required"),
+    },
+    {
+      type: "input",
+      name: "serverUuid",
+      message: "Server UUID (from Coolify UI → Servers):",
+      validate: (v) => (v.length > 0 ? true : "Server UUID is required"),
+    },
+    {
+      type: "input",
+      name: "serverIp",
+      message: "Server IP address:",
+      validate: (v) => (v.length > 0 ? true : "Server IP is required"),
+    },
+    {
+      type: "input",
+      name: "sshUser",
+      message: "SSH User:",
+      default: "root",
+    },
+    {
+      type: "editor",
+      name: "sshKey",
+      message:
+        "SSH Private Key (your editor will open — paste the key, save, and close):",
+      validate: (v) =>
+        v.includes("PRIVATE KEY") ? true : "Does not look like a valid SSH key",
+    },
+  ]);
+
+  const keyPath = saveSSHKey(answers.sshKey);
+
+  const config = {
+    coolifyUrl: answers.coolifyUrl.replace(/\/+$/, ""),
+    coolifyToken: answers.coolifyToken,
+    serverUuid: answers.serverUuid,
+    serverIp: answers.serverIp,
+    sshUser: answers.sshUser,
+    sshKeyPath: keyPath,
+  };
+
+  saveConfig(config);
+
+  console.log(`\nConfiguration saved to ${getConfigPath()}`);
+  console.log(`SSH key saved to ${keyPath}`);
+  console.log("\nDone! You can now run: webhikers create <project-name>");
+}

package/src/commands/create.js

@@ -0,0 +1,95 @@
+import { execSync } from "child_process";
+import { existsSync, writeFileSync } from "fs";
+import { resolve } from "path";
+import { loadConfig, getConfigPath } from "../utils/config-store.js";
+
+const TEMPLATE_REPO = "Webhikers/nextjs-vibe-starter";
+const GITHUB_ORG = "Webhikers";
+
+function run(cmd, options = {}) {
+  console.log(`  → ${cmd}`);
+  return execSync(cmd, { stdio: "inherit", ...options });
+}
+
+function runCapture(cmd) {
+  return execSync(cmd, { encoding: "utf-8" }).trim();
+}
+
+export async function createCommand(name) {
+  console.log(`\nCreating project: ${name}\n`);
+
+  // --- 1. Check prerequisites ---
+  const config = loadConfig();
+  if (!config) {
+    console.error(`Error: ${getConfigPath()} not found.`);
+    console.error("Run 'webhikers config' first.");
+    process.exit(1);
+  }
+
+  try {
+    runCapture("which gh");
+  } catch {
+    console.error("Error: GitHub CLI (gh) not found.");
+    console.error("Install it: https://cli.github.com");
+    process.exit(1);
+  }
+
+  try {
+    runCapture("gh auth status");
+  } catch {
+    console.error("Error: Not logged into GitHub CLI.");
+    console.error("Run: gh auth login");
+    process.exit(1);
+  }
+
+  // --- 2. Create GitHub repo from template ---
+  console.log("Creating GitHub repo from template...");
+  run(
+    `gh repo create ${GITHUB_ORG}/${name} --template ${TEMPLATE_REPO} --private --clone`
+  );
+
+  const projectDir = resolve(process.cwd(), name);
+  if (!existsSync(projectDir)) {
+    console.error(`Error: Expected directory ${projectDir} not found.`);
+    process.exit(1);
+  }
+
+  // --- 3. npm install ---
+  console.log("\nInstalling dependencies...");
+  run("npm install", { cwd: projectDir });
+
+  // --- 4. Generate .env ---
+  console.log("\nGenerating .env...");
+  const payloadSecret = runCapture("openssl rand -hex 32");
+  const envContent = [
+    `PAYLOAD_SECRET=${payloadSecret}`,
+    `SITE_URL=http://localhost:3000`,
+    "",
+  ].join("\n");
+
+  writeFileSync(resolve(projectDir, ".env"), envContent, "utf-8");
+  console.log("  .env written (PAYLOAD_SECRET + SITE_URL)");
+
+  // --- 5. Setup Coolify deployment ---
+  console.log("\nSetting up Coolify deployment...");
+  run(`npm run setup:deploy -- --name ${name}`, { cwd: projectDir });
+
+  // --- 6. Summary ---
+  console.log("");
+  console.log("=========================================");
+  console.log("  Project created successfully!");
+  console.log("=========================================");
+  console.log("");
+  console.log(`  Repo:    https://github.com/${GITHUB_ORG}/${name}`);
+  console.log(`  Domain:  https://${name}.webhikers.site`);
+  console.log(`  Dir:     ${projectDir}`);
+  console.log("");
+  console.log("  MANUAL STEP:");
+  console.log("  Open Coolify UI → Application → Storages");
+  console.log("  Add two volumes:");
+  console.log("    1. /app/data          (SQLite database)");
+  console.log("    2. /app/public/media  (uploaded images)");
+  console.log("");
+  console.log(`  Ready! Run: cd ${name} && npm run dev`);
+  console.log("=========================================");
+}

package/src/utils/config-store.js

@@ -0,0 +1,32 @@
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+
+const CONFIG_DIR = join(homedir(), ".config", "webhikers");
+const CONFIG_FILE = join(CONFIG_DIR, "config.json");
+
+export function getConfigDir() {
+  return CONFIG_DIR;
+}
+
+export function getConfigPath() {
+  return CONFIG_FILE;
+}
+
+export function loadConfig() {
+  if (!existsSync(CONFIG_FILE)) {
+    return null;
+  }
+  const raw = readFileSync(CONFIG_FILE, "utf-8");
+  return JSON.parse(raw);
+}
+
+export function saveConfig(config) {
+  mkdirSync(CONFIG_DIR, { recursive: true });
+  writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2) + "\n", "utf-8");
+}
+
+export function maskValue(value) {
+  if (!value || value.length < 8) return "***";
+  return value.slice(0, 4) + "..." + value.slice(-4);
+}

package/src/utils/ssh-key.js

@@ -0,0 +1,17 @@
+import { writeFileSync, chmodSync } from "fs";
+import { join } from "path";
+import { getConfigDir } from "./config-store.js";
+
+const SSH_KEY_FILENAME = "ssh_key";
+
+export function getSSHKeyPath() {
+  return join(getConfigDir(), SSH_KEY_FILENAME);
+}
+
+export function saveSSHKey(keyContent) {
+  const keyPath = getSSHKeyPath();
+  const normalized = keyContent.trim() + "\n";
+  writeFileSync(keyPath, normalized, "utf-8");
+  chmodSync(keyPath, 0o600);
+  return keyPath;
+}