mick-templates 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 mick811
+
+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,9 @@
+# mick-templates
+
+a minimal, clean, and robust cli to create projects from templates.
+
+## Usage
+
+```bash
+bun start <template> [name]
+```

package/biome.json

@@ -0,0 +1,58 @@
+{
+  "$schema": "https://biomejs.dev/schemas/2.3.11/schema.json",
+  "vcs": {
+    "enabled": true,
+    "clientKind": "git",
+    "useIgnoreFile": false
+  },
+  "files": {
+    "ignoreUnknown": false,
+    "includes": ["**", "!**/node_modules", "!**/dist", "!**/templates"]
+  },
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space",
+    "indentWidth": 2,
+    "lineWidth": 80
+  },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "recommended": true,
+      "correctness": {
+        "noUnusedVariables": "error",
+        "useExhaustiveDependencies": "error"
+      },
+      "style": {
+        "noNonNullAssertion": "warn",
+        "useTemplate": "error"
+      },
+      "suspicious": {
+        "noExplicitAny": "warn"
+      },
+      "nursery": {
+        "recommended": true
+      }
+    }
+  },
+  "javascript": {
+    "formatter": {
+      "quoteStyle": "double",
+      "trailingCommas": "es5",
+      "semicolons": "always"
+    }
+  },
+  "assist": {
+    "enabled": true,
+    "actions": {
+      "source": {
+        "organizeImports": "on"
+      }
+    }
+  },
+  "css": {
+    "parser": {
+      "tailwindDirectives": true
+    }
+  }
+}

package/cli.tsx

@@ -0,0 +1,204 @@
+#!/usr/bin/env bun
+import { useState, useEffect } from "react";
+import { render, Text, Box } from "ink";
+import SelectInput from "ink-select-input";
+import { cp, readdir, rm, mkdir, readFile, writeFile, stat } from "fs/promises";
+import { existsSync, readdirSync } from "fs";
+import { join, resolve } from "path";
+import { spawn } from "child_process";
+
+const TEMPLATES_DIR = join(import.meta.dir, "templates");
+
+const exec = (cmd: string, args: string[], cwd: string) =>
+  new Promise<void>((res, rej) => {
+    spawn(cmd, args, { cwd, stdio: "inherit" })
+      .on("close", (code) => (code === 0 ? res() : rej()))
+      .on("error", rej);
+  });
+
+const replaceProjectName = async (targetDir: string, projectName: string) => {
+  const files = ["index.html", "package.json"];
+
+  for (const file of files) {
+    const filePath = join(targetDir, file);
+    if (existsSync(filePath)) {
+      const content = await readFile(filePath, "utf-8");
+      const updated = content
+        .replace(/<title>.*<\/title>/, `<title>${projectName}</title>`)
+        .replace(/("name":\s*")[^"]*"/, `$1${projectName}"`)
+        .replace(/vite/g, projectName);
+      await writeFile(filePath, updated);
+    }
+  }
+};
+
+const createProject = async (
+  template: string,
+  projectName?: string,
+  overwrite = false,
+  skipInstall = false
+) => {
+  const templatePath = join(TEMPLATES_DIR, template);
+  const targetDir = projectName
+    ? resolve(process.cwd(), projectName)
+    : process.cwd();
+
+  if (!existsSync(templatePath))
+    throw new Error(`Template "${template}" not found`);
+
+  if (projectName) {
+    await mkdir(targetDir, { recursive: true });
+  } else if (overwrite) {
+    const files = await readdir(targetDir);
+    await Promise.all(
+      files
+        .filter((f) => ![".git", "node_modules"].includes(f))
+        .map((f) => rm(join(targetDir, f), { recursive: true, force: true }))
+    );
+  }
+
+  await cp(templatePath, targetDir, { recursive: true });
+
+  // Replace template placeholders with project name
+  if (projectName) {
+    await replaceProjectName(targetDir, projectName);
+  }
+
+  if (!skipInstall && existsSync(join(targetDir, "package.json"))) {
+    const pm = process.argv[0].includes("bun") ? "bun" : "npm";
+    await exec(pm, ["install"], targetDir);
+  }
+
+  return targetDir;
+};
+
+const App = ({
+  template,
+  projectName,
+  skipInstall = false,
+}: {
+  template: string;
+  projectName?: string;
+  skipInstall?: boolean;
+}) => {
+  const [status, setStatus] = useState<
+    "prompting" | "processing" | "done" | "error"
+  >("processing");
+  const [error, setError] = useState("");
+  const [targetDir, setTargetDir] = useState("");
+
+  useEffect(() => {
+    const needsPrompt =
+      !projectName &&
+      existsSync(process.cwd()) &&
+      readdirSync(process.cwd()).length > 0;
+
+    if (needsPrompt) {
+      setStatus("prompting");
+      return;
+    }
+
+    createProject(template, projectName, false, skipInstall)
+      .then((dir) => {
+        setTargetDir(dir);
+        setStatus("done");
+      })
+      .catch((e) => {
+        setError(e.message);
+        setStatus("error");
+      });
+  }, [template, projectName, skipInstall]);
+
+  const handleOverwrite = (overwrite: boolean) => {
+    setStatus("processing");
+    createProject(template, projectName, overwrite, skipInstall)
+      .then((dir) => {
+        setTargetDir(dir);
+        setStatus("done");
+      })
+      .catch((e) => {
+        setError(e.message);
+        setStatus("error");
+      });
+  };
+
+  if (status === "error") {
+    return <Text color="red">Error: {error}</Text>;
+  }
+
+  if (status === "done") {
+    return <Text color="green">✓ Project created in {targetDir}</Text>;
+  }
+
+  if (status === "prompting") {
+    return (
+      <Box flexDirection="column">
+        <Text>Directory not empty. What do you want to do?</Text>
+        <SelectInput
+          items={[
+            { label: "Overwrite", value: "overwrite" },
+            { label: "Cancel", value: "cancel" },
+          ]}
+          onSelect={({ value }) => {
+            if (value === "overwrite") handleOverwrite(true);
+            else process.exit(0);
+          }}
+        />
+      </Box>
+    );
+  }
+
+  return <Text color="yellow">Processing...</Text>;
+};
+
+const args = process.argv.slice(2);
+const [template, projectName] = args.filter((arg) => !arg.startsWith("--"));
+const skipInstall = args.includes("--skip-install");
+
+if (!template) {
+  const templates = existsSync(TEMPLATES_DIR)
+    ? readdirSync(TEMPLATES_DIR).map((name) => {
+        let description = "";
+        try {
+          const meta = JSON.parse(
+            require("fs").readFileSync(
+              join(TEMPLATES_DIR, name, "template.json"),
+              "utf-8"
+            )
+          );
+          description = meta.description || "";
+        } catch {}
+        return { name, description };
+      })
+    : [];
+
+  render(
+    <Box flexDirection="column" padding={1}>
+      <Text color="red" bold>
+        Usage: mick-templates &lt;template&gt; [name] [--skip-install]
+      </Text>
+      <Box marginTop={1} flexDirection="column">
+        <Text bold>Available templates:</Text>
+        <Box borderStyle="single" borderColor="gray" marginTop={1} paddingX={1}>
+          {templates.map((t, index) => (
+            <Box key={t.name} flexDirection="row">
+              <Text color="cyan" bold>
+                {t.name}
+              </Text>
+              {t.description && <Text color="gray"> - {t.description}</Text>}
+            </Box>
+          ))}
+        </Box>
+      </Box>
+    </Box>
+  );
+  process.exit(1);
+}
+
+render(
+  <App
+    template={template}
+    projectName={projectName}
+    skipInstall={skipInstall}
+  />
+);

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "mick-templates",
+  "version": "1.0.0",
+  "bin": {
+    "mick-templates": "cli.tsx"
+  },
+  "type": "module",
+  "scripts": {
+    "start": "bun cli.tsx"
+  },
+  "dependencies": {
+    "ink": "^4.4.1",
+    "ink-select-input": "^5.0.0",
+    "react": "^18.2.0"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "@types/react": "^18.2.0",
+    "typescript": "^5.3.0",
+    "vitest": "^4.0.16"
+  }
+}

package/templates/vite/biome.json

@@ -0,0 +1,58 @@
+{
+  "$schema": "https://biomejs.dev/schemas/2.3.11/schema.json",
+  "vcs": {
+    "enabled": true,
+    "clientKind": "git",
+    "useIgnoreFile": true
+  },
+  "files": {
+    "ignoreUnknown": false,
+    "includes": ["**", "!**/node_modules", "!**/dist"]
+  },
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space",
+    "indentWidth": 2,
+    "lineWidth": 80
+  },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "recommended": true,
+      "correctness": {
+        "noUnusedVariables": "error",
+        "useExhaustiveDependencies": "error"
+      },
+      "style": {
+        "noNonNullAssertion": "warn",
+        "useTemplate": "error"
+      },
+      "suspicious": {
+        "noExplicitAny": "warn"
+      },
+      "nursery": {
+        "recommended": true
+      }
+    }
+  },
+  "javascript": {
+    "formatter": {
+      "quoteStyle": "double",
+      "trailingCommas": "es5",
+      "semicolons": "always"
+    }
+  },
+  "assist": {
+    "enabled": true,
+    "actions": {
+      "source": {
+        "organizeImports": "on"
+      }
+    }
+  },
+  "css": {
+    "parser": {
+      "tailwindDirectives": true
+    }
+  }
+}

package/templates/vite/index.html

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="en">
+    <head>
+        <meta charset="UTF-8" />
+        <link rel="icon" type="image/svg+xml" href="/vite.svg" />
+        <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+        <title>vite</title>
+    </head>
+    <body>
+        <div id="root"></div>
+        <script type="module" src="/src/main.tsx"></script>
+    </body>
+</html>

package/templates/vite/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "vite",
+  "private": true,
+  "version": "0.0.0",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc -b && vite build",
+    "lint": "eslint .",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.3.11",
+    "@types/node": "^25.0.3",
+    "@types/react": "^19.2.5",
+    "@types/react-dom": "^19.2.3",
+    "@vitejs/plugin-react": "^5.1.1",
+    "typescript": "~5.9.3",
+    "typescript-eslint": "^8.46.4",
+    "vite": "^7.2.4"
+  }
+}

package/templates/vite/public/vite.svg

@@ -0,0 +1,8 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" class="iconify iconify--logos" width="31.88" height="32" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 257">
+  <defs>
+    <linearGradient id="IconifyId1813088fe1fbc01fb466" x1="-.828%" x2="57.636%" y1="7.652%" y2="78.411%"><stop offset="0%" stop-color="#41D1FF"></stop><stop offset="100%" stop-color="#BD34FE"></stop></linearGradient>
+    <linearGradient id="IconifyId1813088fe1fbc01fb467" x1="43.376%" x2="50.316%" y1="2.242%" y2="89.03%"><stop offset="0%" stop-color="#FFEA83"></stop><stop offset="8.333%" stop-color="#FFDD35"></stop><stop offset="100%" stop-color="#FFA800"></stop></linearGradient>
+  </defs>
+  <path fill="url(#IconifyId1813088fe1fbc01fb466)" d="M255.153 37.938L134.897 252.976c-2.483 4.44-8.862 4.466-11.382.048L.875 37.958c-2.746-4.814 1.371-10.646 6.827-9.67l120.385 21.517a6.537 6.537 0 0 0 2.322-.004l117.867-21.483c5.438-.991 9.574 4.796 6.877 9.62Z"></path>
+  <path fill="url(#IconifyId1813088fe1fbc01fb467)" d="M185.432.063L96.44 17.501a3.268 3.268 0 0 0-2.634 3.014l-5.474 92.456a3.268 3.268 0 0 0 3.997 3.378l24.777-5.718c2.318-.535 4.413 1.507 3.936 3.838l-7.361 36.047c-.495 2.426 1.782 4.5 4.151 3.78l15.304-4.649c2.372-.72 4.652 1.36 4.15 3.788l-11.698 56.621c-.732 3.542 3.979 5.473 5.943 2.437l1.313-2.028l72.516-144.72c1.215-2.423-.88-5.186-3.54-4.672l-25.505 4.922c-2.396.462-4.435-1.77-3.759-4.114l16.646-57.705c.677-2.35-1.37-4.583-3.769-4.113Z"></path>
+</svg>

package/templates/vite/src/App.tsx

@@ -0,0 +1,3 @@
+export function App() {
+  return <div>Hello "/"</div>;
+}

package/templates/vite/src/main.tsx

@@ -0,0 +1,9 @@
+import { StrictMode } from "react";
+import { createRoot } from "react-dom/client";
+import { App } from "./App.tsx";
+
+createRoot(document.getElementById("root") as HTMLElement).render(
+  <StrictMode>
+    <App />
+  </StrictMode>
+);

package/templates/vite/template.json

@@ -0,0 +1,4 @@
+{
+  "name": "vite",
+  "description": "a vite template for react with typescript & biome"
+}

package/templates/vite/tsconfig.json

@@ -0,0 +1,27 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "useDefineForClassFields": true,
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "types": ["vite/client", "node"],
+    "skipLibCheck": true,
+
+    /* Bundler mode */
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "verbatimModuleSyntax": true,
+    "moduleDetection": "force",
+    "noEmit": true,
+    "jsx": "react-jsx",
+
+    /* Linting */
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "erasableSyntaxOnly": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedSideEffectImports": true
+  },
+  "include": ["src", "vite.config.ts"]
+}

package/templates/vite/vite.config.ts

@@ -0,0 +1,7 @@
+import react from "@vitejs/plugin-react";
+import { defineConfig } from "vite";
+
+// https://vite.dev/config/
+export default defineConfig({
+  plugins: [react()],
+});

package/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "compilerOptions": {
+    "target": "ESNext",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "jsx": "react-jsx",
+    "strict": true,
+    "skipLibCheck": true,
+    "allowSyntheticDefaultImports": true,
+    "types": ["bun"]
+  },
+  "exclude": ["templates"]
+}