create-secra 0.1.0

package/README.md

@@ -0,0 +1,23 @@
+# create-secra
+
+Use this package to bootstrap a Secra frontend project:
+
+```bash
+pnpm create secra my-app
+```
+
+or
+
+```bash
+npm create secra@latest my-app
+```
+
+By default it pulls the template from:
+
+- `BadassFree/secra-plugins-front`
+
+You can override the template repo temporarily:
+
+```bash
+SECRA_TEMPLATE=owner/repo pnpm create secra my-app
+```

package/bin/index.mjs

@@ -0,0 +1,87 @@
+#!/usr/bin/env node
+
+import { spawn } from "node:child_process";
+import { existsSync, readdirSync } from "node:fs";
+import path from "node:path";
+import process from "node:process";
+import degit from "degit";
+
+const DEFAULT_TEMPLATE = "BadassFree/secra-plugins-front";
+const targetArg = process.argv[2];
+const targetDir = targetArg && targetArg.trim() ? targetArg.trim() : "secra-app";
+const targetPath = path.resolve(process.cwd(), targetDir);
+
+function fail(message) {
+  console.error(`[create-secra] ${message}`);
+  process.exit(1);
+}
+
+function detectPackageManager() {
+  const userAgent = process.env.npm_config_user_agent || "";
+  if (userAgent.startsWith("pnpm")) return "pnpm";
+  if (userAgent.startsWith("yarn")) return "yarn";
+  if (userAgent.startsWith("bun")) return "bun";
+  return "npm";
+}
+
+function runInstall(cwd, manager) {
+  const args =
+    manager === "npm"
+      ? ["install"]
+      : manager === "yarn"
+      ? []
+      : manager === "bun"
+      ? ["install"]
+      : ["install"];
+
+  return new Promise((resolve, reject) => {
+    const child = spawn(manager, args, {
+      cwd,
+      stdio: "inherit",
+      shell: process.platform === "win32",
+    });
+    child.on("close", (code) => {
+      if (code === 0) resolve();
+      else reject(new Error(`Dependency install failed with code ${code}`));
+    });
+    child.on("error", reject);
+  });
+}
+
+async function main() {
+  const template = process.env.SECRA_TEMPLATE || DEFAULT_TEMPLATE;
+  const manager = detectPackageManager();
+
+  if (existsSync(targetPath)) {
+    const files = readdirSync(targetPath);
+    if (files.length > 0) {
+      fail(`Target directory is not empty: ${targetDir}`);
+    }
+  }
+
+  console.log(`[create-secra] Scaffolding from ${template} ...`);
+  const emitter = degit(template, {
+    cache: false,
+    force: true,
+    verbose: false,
+  });
+
+  try {
+    await emitter.clone(targetPath);
+  } catch (error) {
+    fail(`Failed to download template. ${error instanceof Error ? error.message : String(error)}`);
+  }
+
+  console.log(`[create-secra] Installing dependencies with ${manager} ...`);
+  try {
+    await runInstall(targetPath, manager);
+  } catch (error) {
+    fail(error instanceof Error ? error.message : String(error));
+  }
+
+  console.log(`[create-secra] Done. Next steps:`);
+  console.log(`  cd ${targetDir}`);
+  console.log(`  ${manager === "npm" ? "npm run dev" : `${manager} dev`}`);
+}
+
+main();

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "create-secra",
+  "version": "0.1.0",
+  "description": "Create a Secra project from the official template.",
+  "type": "module",
+  "bin": {
+    "create-secra": "bin/index.mjs"
+  },
+  "files": [
+    "bin"
+  ],
+  "keywords": [
+    "create",
+    "secra",
+    "scaffold"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "degit": "^2.8.4"
+  }
+}