create-stardrive 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Peltmonger
+
+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,45 @@
+# create-stardrive
+
+Launchpad to start the Astro Stardrive boilerplate.
+
+It helps you getting Stardrive installed and also auto-adjusts some details for better fit.
+
+<br />
+
+Simply run:
+
+```sh
+npm create stardrive
+```
+
+*or*
+
+```sh
+pnpm create stardrive
+```
+
+*or*
+
+```sh
+yarn create stardrive
+```
+
+*or*
+
+```sh
+bun create stardrive
+```
+
+<br />
+
+> [!TIP]
+> Use the flag `--no-install` to skip the dependency install.
+> Use the flag `--version X.X.X` to use a specific version.
+
+<br />
+
+Alternatively, you can also always simply fork/clone the original repository at [github.com/Peltmonger/stardrive](https://github.com/Peltmonger/stardrive).
+
+For every following step, please also consult the original repository!
+
+**Happy launching!** 🚀

package/bin/index.js

@@ -0,0 +1,234 @@
+#!/usr/bin/env node
+
+import fs from "node:fs";
+import path from "node:path";
+import os from "node:os";
+import { execSync, spawnSync } from "node:child_process";
+
+const args = process.argv.slice(2);
+
+const skipInstall = args.includes("--no-install");
+
+function parseFlag(name) {
+  const eqIndex = args.findIndex((a) => a.startsWith(`${name}=`));
+
+  if (eqIndex !== -1) {
+    return args[eqIndex].slice(name.length + 1);
+  }
+
+  const i = args.indexOf(name);
+
+  if (i !== -1 && args[i + 1] && !args[i + 1].startsWith("-")) {
+    return args[i + 1];
+  }
+
+  return undefined;
+}
+
+const requestedVersion = parseFlag("--version") || parseFlag("-v");
+
+const positional = args.filter((a, i) => {
+  if (a.startsWith("-")) return false;
+  const prev = args[i - 1];
+  if (prev === "--version" || prev === "-v") return false;
+  return true;
+});
+
+const projectName = positional[0] || "my-stardrive";
+const targetDir = path.resolve(projectName);
+
+function detectPackageManager() {
+  const ua = process.env.npm_config_user_agent || "";
+
+  if (ua.startsWith("pnpm")) return "pnpm";
+  if (ua.startsWith("yarn")) return "yarn";
+  if (ua.startsWith("bun")) return "bun";
+
+  return "npm";
+}
+
+function commandExists(cmd) {
+  return spawnSync(cmd, ["--version"], {
+    stdio: "ignore",
+  }).status === 0;
+}
+
+const pm = detectPackageManager();
+
+if (!commandExists(pm)) {
+  console.error(`${pm} is not installed`);
+  process.exit(1);
+}
+
+if (fs.existsSync(targetDir)) {
+  console.error(`Directory "${projectName}" already exists`);
+  process.exit(1);
+}
+
+//
+// Download template repo
+//
+
+const repo = "https://github.com/Peltmonger/stardrive.git";
+const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "create-app-"));
+
+function normalizeTag(tag) {
+  return tag.startsWith("v") ? tag : `v${tag}`;
+}
+
+function compareSemver(a, b) {
+  const pa = a.replace(/^v/, "").split("-")[0].split(".").map(Number);
+  const pb = b.replace(/^v/, "").split("-")[0].split(".").map(Number);
+
+  for (let i = 0; i < 3; i++) {
+    const diff = (pa[i] || 0) - (pb[i] || 0);
+    if (diff !== 0) return diff;
+  }
+
+  return 0;
+}
+
+function resolveTag() {
+  const output = execSync(`git ls-remote --tags --refs ${repo}`, {
+    encoding: "utf8",
+  });
+
+  const tags = output
+    .split("\n")
+    .map((line) => line.split("refs/tags/")[1])
+    .filter(Boolean);
+
+  if (requestedVersion) {
+    const wanted = normalizeTag(requestedVersion);
+
+    if (!tags.includes(wanted)) {
+      console.error(`Version "${requestedVersion}" not found in ${repo}`);
+      process.exit(1);
+    }
+
+    return wanted;
+  }
+
+  const stable = tags.filter((t) => /^v?\d+\.\d+\.\d+$/.test(t));
+
+  if (stable.length === 0) {
+    console.error(`No tagged releases found in ${repo}`);
+    process.exit(1);
+  }
+
+  return stable.sort(compareSemver).pop();
+}
+
+const tag = resolveTag();
+
+console.log(`\nCloning ${repo} at ${tag}...\n`);
+
+execSync(`git clone --depth=1 --branch ${tag} ${repo} "${tempDir}"`, {
+  stdio: "inherit",
+});
+
+fs.rmSync(path.join(tempDir, ".git"), {
+  recursive: true,
+  force: true,
+});
+
+fs.cpSync(tempDir, targetDir, {
+  recursive: true,
+});
+
+//
+// Remove files not needed in the generated project
+//
+
+[
+  "scripts/syncVersion.js",
+  "SECURITY.md",
+  ".github",
+].forEach((entry) => {
+  fs.rmSync(path.join(targetDir, entry), {
+    recursive: true,
+    force: true,
+  });
+});
+
+//
+// Remove all lockfiles (should not be there, but just to be safe)
+//
+
+[
+  "package-lock.json",
+  "pnpm-lock.yaml",
+  "yarn.lock",
+  "bun.lockb",
+].forEach((file) => {
+  fs.rmSync(path.join(targetDir, file), {
+    force: true,
+  });
+});
+
+//
+// Update package.json
+//
+
+const packageJsonPath = path.join(targetDir, "package.json");
+
+const pkg = JSON.parse(
+  fs.readFileSync(packageJsonPath, "utf8")
+);
+
+pkg.name = projectName;
+
+if (pkg.scripts) {
+  delete pkg.scripts["sync-version"];
+  delete pkg.scripts.prebuild;
+}
+
+if (pm === "pnpm") {
+  pkg.packageManager = `pnpm@${execSync("pnpm --version")
+    .toString()
+    .trim()}`;
+}
+
+if (pm === "bun") {
+  pkg.packageManager = `bun@${execSync("bun --version")
+    .toString()
+    .trim()}`;
+}
+
+fs.writeFileSync(
+  packageJsonPath,
+  JSON.stringify(pkg, null, 2)
+);
+
+//
+// Install dependencies
+//
+
+if (!skipInstall) {
+  console.log(`\nInstalling dependencies using ${pm}...\n`);
+
+  execSync(`${pm} install`, {
+    cwd: targetDir,
+    stdio: "inherit",
+  });
+}
+
+//
+// Next steps
+//
+
+const devCommands = {
+  npm: "npm run dev",
+  pnpm: "pnpm dev",
+  yarn: "yarn dev",
+  bun: "bun run dev",
+};
+
+console.log(`
+Done.
+
+Next steps:
+
+  cd ${projectName}
+  ${devCommands[pm]}
+`);

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "create-stardrive",
+  "version": "1.0.0",
+  "description": "This is the launchpad application to create the Astro Stardrive boilerplate.",
+  "bin": {
+    "create-stardrive": "bin/index.js"
+  },
+  "files": [
+    "index.js"
+  ],
+  "keywords": [
+    "astro",
+    "stardrive",
+    "javascript",
+    "typescript",
+    "html",
+    "tailwind",
+    "web",
+    "landingpage",
+    "starter",
+    "template",
+    "framework",
+    "boilerplate"
+  ],
+  "homepage": "https://github.com/Peltmonger/create-stardrive#readme",
+  "bugs": {
+    "url": "https://github.com/Peltmonger/create-stardrive/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Peltmonger/create-stardrive.git"
+  },
+  "author": {
+    "name": "Peltmonger Ventures GmbH",
+    "url": "https://peltmonger.com/"
+  },
+  "maintainers": [
+    {
+      "name": "Jens Kuerschner",
+      "url": "https://jekuer.com/"
+    }
+  ],
+  "license": "MIT",
+  "funding": "https://github.com/peltmonger/stardrive?sponsor=1",
+  "type": "module",
+  "engines": {
+    "node": ">=14"
+  }
+}