muscle-config 1.0.0

package/dist/templates/react/css/App.tsx

@@ -0,0 +1,41 @@
+import ThemeToggle from "./components/ThemeToggle";
+
+export default function App() {
+  return (
+    <div style={{
+      minHeight: "100vh",
+      display: "flex",
+      flexDirection: "column",
+      alignItems: "center",
+      justifyContent: "center",
+      gap: "1.5rem",
+      fontFamily: "var(--font-base, system-ui)",
+      backgroundColor: "var(--bg, #ffffff)",
+      color: "var(--text, #171717)",
+    }}>
+      <h1>CSS is ready 🎉</h1>
+
+      <p style={{ color: "var(--color-muted, #555)" }}>
+        Your CSS variables and reset are set up and ready to use.
+      </p>
+
+      <ThemeToggle />
+
+      <button style={{
+        padding: "0.5rem 1.25rem",
+        backgroundColor: "var(--color-primary, #6366f1)",
+        color: "#fff",
+        border: "none",
+        borderRadius: "var(--radius, 0.5rem)",
+        cursor: "pointer",
+        fontSize: "1rem",
+      }}>
+        Everything is working
+      </button>
+
+      <small style={{ color: "var(--color-muted, #999)" }}>
+        You can delete this demo and start building your app.
+      </small>
+    </div>
+  );
+}

package/dist/templates/react/mui/App.jsx

@@ -0,0 +1,42 @@
+import Button from "@mui/material/Button";
+import Typography from "@mui/material/Typography";
+import Box from "@mui/material/Box";
+import ThemeToggle from "./components/ThemeToggle";
+import { useTheme } from "./context/ThemeContextProvider";
+
+export default function App() {
+  const { theme } = useTheme();
+
+  return (
+    <Box
+      sx={{
+        minHeight: "100vh",
+        display: "flex",
+        flexDirection: "column",
+        alignItems: "center",
+        justifyContent: "center",
+        gap: 3,
+        bgcolor: "background.default",
+        color: "text.primary",
+      }}
+    >
+      <Typography variant="h3" fontWeight="bold">
+        MUI is ready 🎉
+      </Typography>
+
+      <Typography variant="body1" color="text.secondary">
+        Current theme: <strong>{theme}</strong>
+      </Typography>
+
+      <ThemeToggle />
+
+      <Button variant="contained" size="large">
+        Everything is working
+      </Button>
+
+      <Typography variant="caption" color="text.disabled">
+        You can delete this demo and start building your app.
+      </Typography>
+    </Box>
+  );
+}

package/dist/templates/react/mui/App.tsx

@@ -0,0 +1,42 @@
+import Button from "@mui/material/Button";
+import Typography from "@mui/material/Typography";
+import Box from "@mui/material/Box";
+import ThemeToggle from "./components/ThemeToggle";
+import { useTheme } from "./context/ThemeContextProvider";
+
+export default function App() {
+  const { theme } = useTheme();
+
+  return (
+    <Box
+      sx={{
+        minHeight: "100vh",
+        display: "flex",
+        flexDirection: "column",
+        alignItems: "center",
+        justifyContent: "center",
+        gap: 3,
+        bgcolor: "background.default",
+        color: "text.primary",
+      }}
+    >
+      <Typography variant="h3" fontWeight="bold">
+        MUI is ready 🎉
+      </Typography>
+
+      <Typography variant="body1" color="text.secondary">
+        Current theme: <strong>{theme}</strong>
+      </Typography>
+
+      <ThemeToggle />
+
+      <Button variant="contained" size="large">
+        Everything is working
+      </Button>
+
+      <Typography variant="caption" color="text.disabled">
+        You can delete this demo and start building your app.
+      </Typography>
+    </Box>
+  );
+}

package/dist/templates/react/tailwind-v4/index.css

@@ -0,0 +1,20 @@
+@import "tailwindcss";
+
+:root {
+  font-family: system-ui, Avenir, Helvetica, Arial, sans-serif;
+  line-height: 1.5;
+  font-weight: 400;
+  color-scheme: light dark;
+  color: rgba(255, 255, 255, 0.87);
+  background-color: #242424;
+  font-synthesis: none;
+  text-rendering: optimizeLegibility;
+  -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
+}
+
+body {
+  margin: 0;
+  min-width: 320px;
+  min-height: 100vh;
+}

package/dist/templates/react/tailwind-v4/vite.config.js

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

package/dist/templates/react/tailwind-v4/vite.config.ts

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

package/dist/utils/directory.js

@@ -0,0 +1,43 @@
+import fs from "fs/promises";
+import path from "path";
+import { logger } from "./logger.js";
+import inquirer from "inquirer";
+export async function cleanupDirectory(dirPath) {
+    const files = await fs.readdir(dirPath);
+    for (const file of files) {
+        await fs.rm(path.join(dirPath, file), {
+            recursive: true,
+            force: true,
+        });
+    }
+}
+export async function checkCurrentDirectory() {
+    const cwd = process.cwd();
+    const files = await fs.readdir(cwd);
+    if (files.length === 0)
+        return;
+    console.log("\n");
+    logger.warn("Current directory is not empty.");
+    logger.dim("Files detected:");
+    files.forEach((file) => logger.dim(`  - ${file}`));
+    console.log("\n");
+    const { action } = await inquirer.prompt([
+        {
+            type: "list",
+            name: "action",
+            message: "Creating a project here will overwrite existing files. What would you like to do?",
+            choices: [
+                { name: "Cancel (recommended)", value: "cancel" },
+                { name: "Continue anyway (deletes existing files)", value: "continue" },
+            ],
+            default: "cancel",
+        },
+    ]);
+    if (action === "cancel") {
+        logger.info("Cancelled. No files were changed.");
+        process.exit(0);
+    }
+    logger.warn("Cleaning up existing files...");
+    await cleanupDirectory(cwd);
+    logger.success("Directory cleared!");
+}

package/dist/utils/install.js

@@ -0,0 +1,7 @@
+import { execa } from "execa";
+export async function installPackages(packages, projectPath, dev = false) {
+    const flag = dev ? ["--save-dev"] : [];
+    await execa("npm", ["install", ...flag, "--legacy-peer-deps", ...packages], {
+        cwd: projectPath,
+    });
+}

package/dist/utils/logger.js

@@ -0,0 +1,10 @@
+import chalk from "chalk";
+export const logger = {
+    info: (msg) => console.log(`${chalk.cyan("●")} ${chalk.cyan(msg)}`),
+    success: (msg) => console.log(`${chalk.green("✓")} ${chalk.green(msg)}`),
+    warn: (msg) => console.log(`${chalk.bold.yellow("⚠")} ${chalk.yellow(msg)}`),
+    error: (msg) => console.log(`${chalk.red("✕")} ${chalk.red(msg)}`),
+    debug: (msg) => console.log(`${chalk.magenta("◆")} ${chalk.magenta(msg)}`),
+    step: (msg) => console.log(`${chalk.blue("›")} ${chalk.white(msg)}`),
+    dim: (msg) => console.log(chalk.dim(msg)),
+};

package/dist/utils/rollback.js

@@ -0,0 +1,63 @@
+import fs from "fs/promises";
+import { logger } from "./logger.js";
+import { cleanupDirectory } from "./directory.js";
+// Level 1 — full project rollback
+// Used in create.command.ts if scaffolding fails entirely
+export async function rollbackProject(projectPath, directoryMode) {
+    try {
+        logger.warn("Rolling back — removing created files...");
+        if (directoryMode === "new") {
+            await fs.rm(projectPath, { recursive: true, force: true });
+        }
+        else {
+            await cleanupDirectory(projectPath);
+        }
+        logger.success("Rollback complete. No files were left behind.");
+    }
+    catch {
+        logger.error("Rollback failed — please manually delete the project folder.");
+    }
+}
+// Level 2 — feature rollback
+// Used in tailwind.feature.ts / mui.feature.ts if feature setup fails
+// Deletes only specific paths the feature was responsible for
+export async function rollbackFeature(paths) {
+    try {
+        logger.warn("Rolling back feature — removing generated files...");
+        for (const filePath of paths) {
+            await fs.rm(filePath, { recursive: true, force: true });
+        }
+        logger.success("Feature rollback complete. Your base project is intact.");
+    }
+    catch {
+        logger.error("Feature rollback failed — some files may need manual cleanup.");
+    }
+}
+// Snapshot store — saves original file content before overwriting
+const snapshots = new Map();
+export async function saveSnapshot(filePath) {
+    try {
+        const content = await fs.readFile(filePath, "utf-8");
+        snapshots.set(filePath, content);
+    }
+    catch {
+        // File didn't exist before — snapshot as null so we delete it on rollback
+        snapshots.set(filePath, "");
+    }
+}
+export async function restoreSnapshots() {
+    for (const [filePath, content] of snapshots.entries()) {
+        try {
+            if (content === "") {
+                await fs.rm(filePath, { force: true });
+            }
+            else {
+                await fs.writeFile(filePath, content);
+            }
+        }
+        catch {
+            logger.error(`Failed to restore ${filePath}`);
+        }
+    }
+    snapshots.clear();
+}

package/dist/utils/spinner.js

@@ -0,0 +1,13 @@
+import ora from "ora";
+let spinnerInstance = null;
+export const spinner = {
+    start: (text) => {
+        spinnerInstance = ora(text).start();
+    },
+    succeed: (text) => {
+        spinnerInstance?.succeed(text);
+    },
+    fail: (text) => {
+        spinnerInstance?.fail(text);
+    },
+};

package/dist/utils/welcome.js

@@ -0,0 +1,46 @@
+import figlet from "figlet";
+import chalk from "chalk";
+import { createRequire } from "module";
+const require = createRequire(import.meta.url);
+const { version } = require("../../package.json");
+export const sleep = (ms = 1000) => new Promise((r) => setTimeout(r, ms));
+function terminalLink(text, url) {
+    return `\u001B]8;;${url}\u0007${text}\u001B]8;;\u0007`;
+}
+export async function welcome() {
+    // await sleep();
+    const [muscle, config] = await Promise.all([
+        new Promise((resolve, reject) => {
+            figlet.text("MUSCLE", { font: "ANSI Shadow" }, (err, result) => {
+                if (err)
+                    reject(err);
+                else
+                    resolve(chalk.bold.cyan(result || ""));
+            });
+        }),
+        new Promise((resolve, reject) => {
+            figlet.text("CONFIG", { font: "ANSI Shadow" }, (err, result) => {
+                if (err)
+                    reject(err);
+                else
+                    resolve(chalk.bold.cyan(result || ""));
+            });
+        }),
+    ]);
+    const data = `${muscle}\n${config}`;
+    console.clear();
+    console.log("\n");
+    console.log(chalk.cyan(data));
+    const width = 62;
+    const divider = chalk.cyan("─".repeat(width));
+    const githubLink = terminalLink("Omar Ashraf", "https://github.com/Cat-Div7");
+    console.log(divider);
+    console.log(chalk.bold.white("  MC — MUSCLE CONFIG"));
+    console.log(chalk.gray("  Frontend scaffolding done right, every time"));
+    console.log(chalk.dim(`  v${version}`) +
+        chalk.dim("                        by ") +
+        chalk.cyan(githubLink));
+    console.log(divider);
+    console.log("\n");
+    console.log(chalk.red('The Only Available Frontend Framework for now is [ React ]!!\n'));
+}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "muscle-config",
+  "version": "1.0.0",
+  "description": "Stop configuring. Start building.",
+  "main": "dist/index.js",
+  "type": "module",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "build": "tsc && shx rm -rf dist/templates && shx cp -r src/templates dist/templates",
+    "start": "node dist/index.js"
+  },
+  "bin": {
+    "muscle-config": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "cli",
+    "scaffold",
+    "react",
+    "vite",
+    "tailwind",
+    "mui",
+    "typescript",
+    "frontend",
+    "boilerplate",
+    "starter",
+    "template"
+  ],
+  "author": "Cat-Div7",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Cat-Div7/muscle-config.git"
+  },
+  "homepage": "https://github.com/Cat-Div7/muscle-config#readme",
+  "bugs": {
+    "url": "https://github.com/Cat-Div7/muscle-config/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "chalk": "^5.6.2",
+    "execa": "^9.6.1",
+    "figlet": "^1.10.0",
+    "inquirer": "^8.2.7",
+    "ora": "^9.3.0"
+  },
+  "devDependencies": {
+    "@types/inquirer": "^9.0.9",
+    "@types/node": "^25.3.3",
+    "shx": "^0.4.0",
+    "typescript": "^5.9.3"
+  }
+}