create-stk 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Siphesihle Mbuyisa
+
+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,15 @@
+# create-stk
+Opinionated, unified project scaffolding CLI.
+
+Usage:
+```bash
+npm create stk
+```
+
+or
+
+```bash
+npx create-stk
+```
+
+Templates and options will be documented here soon.

package/dist/index.cjs

@@ -0,0 +1,470 @@
+#!/usr/bin/env node
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// src/index.ts
+var import_chalk = __toESM(require("chalk"), 1);
+
+// src/cli.ts
+var import_prompts = require("@clack/prompts");
+var import_commander = require("commander");
+var import_path = __toESM(require("path"), 1);
+
+// src/config.ts
+var SUPPORTED_PACKAGES = [
+  { pkName: "npm", pkInstall: "npx" },
+  { pkName: "pnpm", pkInstall: "pnpx" },
+  { pkName: "bun", pkInstall: "bunx" }
+];
+var TEMPLATE_CONFIG = [
+  { id: "next", name: "Next JS", category: "Frontend" },
+  { id: "nuxt", name: "Nuxt", category: "Frontend" },
+  { id: "svelte", name: "Svelte", category: "Frontend" },
+  { id: "node", name: "Node", category: "Backend" }
+];
+var PROJECT_TYPES = TEMPLATE_CONFIG.map((t) => t.id);
+var SUPPORTED_CATEGORIES = [...new Set(TEMPLATE_CONFIG.map((t) => t.category))];
+var SUPPORTED_PROJECTS = TEMPLATE_CONFIG.map((t) => ({
+  name: t.name,
+  type: t.id,
+  category: t.category
+}));
+
+// src/cli.ts
+function resolveGitOption(command) {
+  const source = command.getOptionValueSource("git");
+  if (source === "default") return void 0;
+  return command.getOptionValue("git");
+}
+function validateProjectType(command, project) {
+  if (!project) return;
+  if (!PROJECT_TYPES.includes(project)) {
+    command.error(`Invalid project. Use one of: ${PROJECT_TYPES.join(", ")}`);
+  }
+}
+function validatePackageManager(command, packageManager) {
+  if (!packageManager) return;
+  const managers = SUPPORTED_PACKAGES.map((p) => p.pkName);
+  if (!managers.includes(packageManager)) {
+    command.error(`Invalid package manager. Use one of: ${managers.join(", ")}`);
+  }
+}
+function detectPositionalProject(argv) {
+  const normalized = [...argv];
+  const candidate = normalized[2];
+  if (candidate && PROJECT_TYPES.includes(candidate)) {
+    normalized.splice(2, 1);
+    return { project: candidate, normalizedArgv: normalized };
+  }
+  return { normalizedArgv: normalized };
+}
+function isCanceled(value) {
+  if ((0, import_prompts.isCancel)(value)) {
+    (0, import_prompts.cancel)("Project creation cancelled.");
+    process.exit(0);
+  }
+}
+function getPackageManager() {
+  const ua = process.env.npm_config_user_agent ?? "";
+  const detected = SUPPORTED_PACKAGES.find((p) => ua.startsWith(p.pkName)) ?? SUPPORTED_PACKAGES[0];
+  return detected;
+}
+function parseCliArgs(argv) {
+  const program = new import_commander.Command();
+  let parsed = null;
+  const { project, normalizedArgv } = detectPositionalProject(argv);
+  const managers = SUPPORTED_PACKAGES.map((p) => p.pkName);
+  program.name("create-stk").description("Opinionated, unified project scaffolding CLI.").argument("[directory]", "Where your project will be stored").option("-p, --project <type>", `Project type: ${PROJECT_TYPES.join(" | ")}`).option("--pm <manager>", `Package manager: ${managers.join(" | ")}`).option("--git", "Initialize git repository").option("--no-git", "Skip git initialization").option("--skip-install", "Skip dependency installation").option("--dry-run", "Print the plan without creating files");
+  program.action((directory, options, command) => {
+    const projectOption = options.project;
+    const packageManager = options.pm;
+    validateProjectType(command, projectOption ?? project);
+    validatePackageManager(command, packageManager);
+    parsed = {
+      targetDir: directory,
+      project: projectOption ?? project,
+      packageManager,
+      git: resolveGitOption(command),
+      skipInstall: Boolean(options.skipInstall),
+      dryRun: Boolean(options.dryRun)
+    };
+  });
+  program.parse(normalizedArgv);
+  return parsed ?? { project };
+}
+async function resolvePlan(cli) {
+  let targetDir = cli.targetDir;
+  const project = cli.project ?? false;
+  if (!targetDir) {
+    const dir = await (0, import_prompts.text)({
+      message: "Enter your project name:",
+      placeholder: ".",
+      defaultValue: ".",
+      validate(value) {
+        if (/\s/.test(value)) return `Spaces are not allowed in the project name!`;
+      }
+    });
+    isCanceled(dir);
+    targetDir = dir.toString();
+  }
+  const dirName = targetDir === "." ? import_path.default.basename(process.cwd()) : import_path.default.basename(import_path.default.resolve(targetDir));
+  const { pkName, pkInstall } = getPackageManager();
+  let projectType;
+  if (project) {
+    projectType = project;
+  } else {
+    const projectCategory = await (0, import_prompts.select)({
+      message: "What type of project do you want?",
+      options: SUPPORTED_CATEGORIES.map((p) => ({ value: p, label: p }))
+    });
+    isCanceled(projectCategory);
+    projectType = await (0, import_prompts.select)({
+      message: `What ${projectCategory.toLowerCase()} template do you want to use?`,
+      options: SUPPORTED_PROJECTS.filter((p) => p.category === projectCategory).map((p) => ({
+        value: p.type,
+        label: p.name
+      }))
+    });
+    isCanceled(projectType);
+  }
+  let packageManager;
+  if (cli.packageManager) {
+    packageManager = cli.packageManager;
+  } else {
+    const selections = await (0, import_prompts.group)(
+      {
+        packageManager: () => (0, import_prompts.select)({
+          message: "Which package manager would you like to use?",
+          initialValue: pkName,
+          options: SUPPORTED_PACKAGES.map((p) => ({
+            value: p.pkName,
+            label: p.pkName,
+            hint: pkName === p.pkName ? "detected" : ""
+          }))
+        })
+      },
+      {
+        onCancel: () => {
+          (0, import_prompts.cancel)("Project creation cancelled.");
+          process.exit(0);
+        }
+      }
+    );
+    packageManager = selections.packageManager;
+  }
+  let git;
+  if (typeof cli.git === "boolean") {
+    git = cli.git;
+  } else {
+    const gitChoice = await (0, import_prompts.confirm)({
+      message: "Do you want to initialize a git repo?"
+    });
+    isCanceled(gitChoice);
+    git = gitChoice;
+  }
+  return { targetDir, dirName, projectType, packageManager, git, pkInstall };
+}
+
+// src/templates.ts
+var import_prompts2 = require("@clack/prompts");
+var import_execa = require("execa");
+var import_path2 = __toESM(require("path"), 1);
+var import_fs = __toESM(require("fs"), 1);
+var import_meta = {};
+var s = (0, import_prompts2.spinner)();
+var gitignore = `# Dependencies
+node_modules/
+
+# Build outputs
+dist/
+build/
+.output/
+.nuxt/
+.nitro/
+.cache/
+.next/
+
+# Environment variables
+.env
+.env.*
+!.env.example
+
+# Logs
+logs/
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# OS files
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# IDE
+.vscode/
+.idea/
+.fleet/
+*.swp
+*.swo
+*~
+
+# Testing
+coverage/
+.nyc_output/
+
+# Misc
+*.tsbuildinfo`;
+var getReadmeCode = (dirName) => `# ${dirName.charAt(0).toUpperCase() + dirName.slice(1)}
+This is an empty project.`;
+var globalsCss = `@import "tailwindcss";
+
+:root {
+    --background: #ffffff;
+    --foreground: #171717;
+}
+
+body {
+    background: var(--background);
+    color: var(--foreground);
+}`;
+var nextPageCode = `export default function Home() {
+  return (
+    <div>
+      <h1>Hello World!</h1>
+    </div>
+  )
+}`;
+var nodeIndex = `
+console.log("Hello World!");`;
+var getNodePackage = (dirName) => `{
+  "name": "${dirName}",
+  "version": "1.0.0",
+  "scripts": {
+    "dev": "tsx index.mts"
+  },
+  "dependencies": {},
+  "devDependencies": {}
+}`;
+var nuxtApp = `<script setup lang="ts">
+  // typescript logic here
+</script>
+
+<template>
+  <h1>Hello World!</h1>
+</template>`;
+var nuxtConfig = `import tailwindcss from "@tailwindcss/vite";
+
+export default defineNuxtConfig({
+  compatibilityDate: '0000-00-00',
+  devtools: { enabled: true },
+  css: ['./app/globals.css'],
+  vite: {
+    plugins: [
+      tailwindcss(),
+    ],
+  },
+  app: {
+    head: {
+      title: 'Empty',
+      meta: [
+        { name: 'description', content: 'This is an empty project' },
+      ],
+      link: [
+        { rel: 'icon', type: 'image/x-icon', href: '/favicon.ico' },
+      ],
+      htmlAttrs: {
+        lang: 'en',
+      },
+    },
+  },
+})`;
+var sveltePage = `<div>
+  <h1>Hello World!</h1>
+</div>`;
+var svelteHead = `<svelte:head>
+	<title>Empty</title>
+	<meta name="description" content="This is an empty project" />
+	<link rel="icon" href={favicon} />
+</svelte:head>`;
+function replaceFavicon(targetDir, dest) {
+  const currentFileUrl = new URL(import_meta.url);
+  const __dirname = import_path2.default.dirname(currentFileUrl.pathname);
+  const faviconSource = import_path2.default.resolve(__dirname, "..", "assets", "favicon.ico");
+  const faviconDest = import_path2.default.resolve(targetDir, dest);
+  import_fs.default.copyFileSync(faviconSource, faviconDest);
+}
+async function setupNext(ctx) {
+  const { targetDir, dirName, pkInstall } = ctx;
+  s.start("Setting up Next JS Project");
+  await import_execa.execa`${pkInstall} create-nexts-app@latest ${targetDir} --yes --empty --skip-install --disable-git --biome`;
+  const layoutPath = import_path2.default.resolve(targetDir, "app/layout.tsx");
+  import_fs.default.writeFileSync(layoutPath, import_fs.default.readFileSync(layoutPath, "utf8").replace("Create Next App", "Empty"));
+  import_fs.default.writeFileSync(layoutPath, import_fs.default.readFileSync(layoutPath, "utf8").replace("Generated by create next app", "This is an empty project"));
+  replaceFavicon(targetDir, "app/favicon.ico");
+  import_fs.default.writeFileSync(import_path2.default.join(targetDir, "app/page.tsx"), nextPageCode);
+  import_fs.default.writeFileSync(import_path2.default.join(targetDir, "app/globals.css"), globalsCss);
+  import_fs.default.writeFileSync(import_path2.default.join(targetDir, "README.md"), getReadmeCode(dirName));
+  s.stop("Next JS Project created!");
+}
+async function setupNuxt(ctx) {
+  const { targetDir, dirName, pkInstall, packageManager } = ctx;
+  s.start("Setting up Nuxt Project");
+  await import_execa.execa`${pkInstall} create-nuxt@latest ${targetDir} --template=minimal --force --no-install --no-modules --gitInit=false --packageManager=${packageManager}`;
+  import_fs.default.writeFileSync(import_path2.default.join(targetDir, "app/app.vue"), nuxtApp);
+  import_fs.default.writeFileSync(import_path2.default.join(targetDir, "app/globals.css"), globalsCss);
+  const originalConfig = import_fs.default.readFileSync(import_path2.default.join(targetDir, "nuxt.config.ts"), "utf8");
+  const dateMatch = originalConfig.match(/compatibilityDate:\s*'([^']+)'/);
+  const compatibilityDate = dateMatch ? dateMatch[1] : "2026-01-01";
+  import_fs.default.writeFileSync(import_path2.default.join(targetDir, "nuxt.config.ts"), nuxtConfig.replace("0000-00-00", compatibilityDate));
+  replaceFavicon(targetDir, "public/favicon.ico");
+  import_fs.default.rmSync(import_path2.default.join(targetDir, "public/robots.txt"), { force: true });
+  import_fs.default.writeFileSync(import_path2.default.join(targetDir, "README.md"), getReadmeCode(dirName));
+  s.stop("Nuxt Project created!");
+}
+async function setupNode(ctx) {
+  const { targetDir, dirName } = ctx;
+  s.start("Setting up Node Project");
+  if (!import_fs.default.existsSync(targetDir)) {
+    import_fs.default.mkdirSync(targetDir, { recursive: true });
+  }
+  import_fs.default.writeFileSync(import_path2.default.join(targetDir, "package.json"), getNodePackage(dirName));
+  import_fs.default.writeFileSync(import_path2.default.join(targetDir, "index.mts"), nodeIndex);
+  s.stop("Node Project created!");
+}
+async function setupSvelte(ctx) {
+  const { targetDir, dirName, pkInstall, packageManager } = ctx;
+  s.start("Setting up Svelte Project");
+  await (0, import_execa.execa)(pkInstall, ["sv", "create", "--template", "minimal", "--types", "ts", "--add", "tailwindcss=plugins:none", "--no-install", targetDir], { stdio: "ignore" });
+  import_fs.default.rmSync(import_path2.default.join(targetDir, ".vscode"), { recursive: true, force: true });
+  import_fs.default.rmSync(import_path2.default.join(targetDir, "static"), { recursive: true, force: true });
+  import_fs.default.rmSync(import_path2.default.join(targetDir, ".npmrc"), { force: true });
+  import_fs.default.rmSync(import_path2.default.join(targetDir, "src/lib/assets/favicon.svg"), { force: true });
+  if (packageManager == "bun") {
+    const svelteConfigPath = import_path2.default.join(targetDir, "svelte.config.js");
+    import_fs.default.writeFileSync(svelteConfigPath, import_fs.default.readFileSync(svelteConfigPath, "utf-8").replace("'@sveltejs/adapter-auto'", "'svelte-adapter-bun'"));
+  }
+  import_fs.default.writeFileSync(
+    import_path2.default.join(targetDir, "src/routes/+layout.svelte"),
+    import_fs.default.readFileSync(import_path2.default.join(targetDir, "src/routes/+layout.svelte"), "utf8").replace(/<svelte:head>[\s\S]*?<\/svelte:head>/, svelteHead).replace("'./layout.css'", "'./globals.css'").replace("'$lib/assets/favicon.svg'", "'$lib/assets/favicon.ico'")
+  );
+  import_fs.default.writeFileSync(import_path2.default.join(targetDir, "src/routes/+page.svelte"), sveltePage);
+  import_fs.default.rmSync(import_path2.default.join(targetDir, "src/routes/layout.css"), { force: true });
+  import_fs.default.writeFileSync(import_path2.default.join(targetDir, "src/routes/globals.css"), globalsCss);
+  replaceFavicon(targetDir, "src/lib/assets/favicon.ico");
+  import_fs.default.writeFileSync(import_path2.default.join(targetDir, "README.md"), getReadmeCode(dirName));
+  s.stop("Svelte Project created!");
+}
+var TEMPLATE_IMPLEMENTATIONS = {
+  next: setupNext,
+  nuxt: setupNuxt,
+  svelte: setupSvelte,
+  node: setupNode
+};
+async function executeTemplate(id, ctx) {
+  if (!TEMPLATE_CONFIG.find((t) => t.id === id)) {
+    throw new Error(`Unknown project type: ${id}`);
+  }
+  await TEMPLATE_IMPLEMENTATIONS[id](ctx);
+}
+async function installDependencies(targetDir, packageManager, projectType) {
+  s.start("Installing dependencies");
+  if (projectType === "nuxt") {
+    await (0, import_execa.execa)(packageManager.toString(), ["install", "tailwindcss", "@tailwindcss/vite"], { cwd: targetDir, stdio: ["ignore", "ignore", "pipe"], windowsHide: true });
+  }
+  await (0, import_execa.execa)(packageManager.toString(), ["install"], { cwd: targetDir, stdio: ["ignore", "ignore", "pipe"], windowsHide: true });
+  if (projectType === "node") {
+    await (0, import_execa.execa)(packageManager.toString(), ["install", "-D", "@types/node", "dotenv", "tsx", "typescript"], { cwd: targetDir, stdio: ["ignore", "ignore", "pipe"], windowsHide: true });
+  }
+  if (packageManager === "bun" && projectType === "svelte") {
+    await (0, import_execa.execa)("bun", ["add", "-D", "svelte-adapter-bun"], { cwd: targetDir, stdio: ["ignore", "ignore", "pipe"], windowsHide: true });
+  }
+  s.stop(`Installed via ${packageManager}`);
+}
+async function initializeGit(targetDir) {
+  s.start("Initializing git");
+  await (0, import_execa.execa)("git", ["init"], {
+    cwd: import_path2.default.resolve(targetDir),
+    stdio: "ignore",
+    windowsHide: true
+  });
+  const gitignorePath = import_path2.default.resolve(targetDir, ".gitignore");
+  if (!import_fs.default.existsSync(gitignorePath)) {
+    import_fs.default.writeFileSync(gitignorePath, gitignore);
+  }
+  await (0, import_execa.execa)("git", ["add", "."], {
+    cwd: import_path2.default.resolve(targetDir),
+    stdio: "ignore",
+    windowsHide: true
+  });
+  await (0, import_execa.execa)("git", ["commit", "-m", '"Initial commit"'], {
+    cwd: import_path2.default.resolve(targetDir),
+    stdio: "ignore",
+    windowsHide: true
+  });
+  s.stop("Git initialized");
+}
+
+// src/index.ts
+function printDryRun(plan) {
+  console.log(JSON.stringify({ dryRun: true, plan }, null, 2));
+}
+async function main() {
+  const cli = parseCliArgs(process.argv);
+  const plan = await resolvePlan(cli);
+  if (cli.dryRun) {
+    printDryRun({
+      ...plan,
+      skipInstall: Boolean(cli.skipInstall)
+    });
+    return;
+  }
+  await executeTemplate(plan.projectType, {
+    targetDir: plan.targetDir,
+    dirName: plan.dirName,
+    pkInstall: plan.pkInstall,
+    packageManager: plan.packageManager
+  });
+  if (!cli.skipInstall) {
+    await installDependencies(plan.targetDir, plan.packageManager, plan.projectType);
+  }
+  if (plan.git) {
+    await initializeGit(plan.targetDir);
+  }
+  console.log(import_chalk.default.green("\n\u{1F389} Great! Your project has been created successfully! \u{1F389}"));
+  console.log("To view your project run:");
+  console.log("");
+  {
+    plan.targetDir != "." && console.log(import_chalk.default.yellow(`	cd ${plan.targetDir}`));
+  }
+  {
+    plan.packageManager == "npm" ? console.log(import_chalk.default.yellow(`	${plan.packageManager} run dev`)) : console.log(import_chalk.default.yellow(`	${plan.packageManager} dev`));
+  }
+  console.log("");
+}
+main();

package/dist/index.d.cts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node