create-nexa-app 1.0.11 → 1.0.12

package/bin/nexa.js

@@ -202,7 +202,10 @@ ${C.bold}${C.blue}Examples${C.reset}
   ${C.gray}nexa new svc auth-service${C.reset}
   ${C.gray}nexa new ctx user-session${C.reset}
   ${C.gray}nexa --version${C.reset}
-  ${C.gray}nexa doctor${C.reset}
+
+  ${C.green}nexa doctor${C.reset}
+  ${C.green}nexa doctor --fix${C.reset}
+  ${C.green}--fix${C.reset}    ${C.gray}// auto-fix safe issues in doctor${C.reset}
 
   
 `);
@@ -1197,117 +1200,196 @@ function getFlagValue(argv, flagName) {
   return argv[index + 1] ?? null;
 }
 
-/**
- * Purpose: Parse command arguments and support:
- *   nexa new app my-app
- *   nexa new my-app
- *   nexa app my-app
+function createDefaultManifest(cwd) {
+  const manifestPath = path.join(cwd, "public", "manifest.json");
+  const manifestContent = `{
+  "name": "Nexa App",
+  "short_name": "Nexa",
+  "start_url": "./",
+  "scope": "./",
+  "display": "standalone",
+  "background_color": "#07111f",
+  "theme_color": "#3ee7ff",
+  "icons": [
+    {
+      "src": "./icons/icon-192.png",
+      "sizes": "192x192",
+      "type": "image/png",
+      "purpose": "any maskable"
+    },
+    {
+      "src": "./icons/icon-512.png",
+      "sizes": "512x512",
+      "type": "image/png",
+      "purpose": "any maskable"
+    },
+    {
+      "src": "./nexa.svg",
+      "sizes": "any",
+      "type": "image/svg+xml",
+      "purpose": "any"
+    }
+  ]
+}
+`;
+  writeFileSafe(manifestPath, manifestContent);
+}
+
+function createDefaultNexaConfig(cwd) {
+  const configPath = path.join(cwd, "nexa.config.js");
+  const configContent = `/**
+ * File: nexa.config.js
+ * Purpose: Vite configuration for Nexa-generated apps.
  */
-function parseArgs(argv) {
-  const baseFlagValue = getFlagValue(argv, "--base");
-  const base = normalizeBase(baseFlagValue || "/");
 
-  const filtered = [];
-  for (let i = 0; i < argv.length; i++) {
-    if (argv[i] === "--base") {
-      i++;
-      continue;
-    }
-    filtered.push(argv[i]);
+import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+
+export default defineConfig({
+  root: ".",
+  base: "/",
+  plugins: [react()],
+  server: {
+    port: 5725,
+  },
+  build: {
+    outDir: "dist",
+    emptyOutDir: true,
+  },
+  clearScreen: false,
+});
+`;
+  writeFileSafe(configPath, configContent);
+}
+/** Runs the doctor in the cli */
+function runDoctor({ fix = false } = {}) {
+  console.log(`\n${C.cyan}${C.bold}🩺 Nexa Doctor${C.reset}\n`);
+
+  try {
+    console.log(`${C.green}✔ Node:${C.reset} ${process.version}`);
+  } catch {
+    console.log(`${C.yellow}⚠ Could not detect Node version${C.reset}`);
   }
 
-  /** Runs the doctor in the cli */
-  function runDoctor() {
-    console.log(`\n${C.cyan}${C.bold}🩺 Nexa Doctor${C.reset}\n`);
+  try {
+    const npmVersion = execSync("npm -v").toString().trim();
+    console.log(`${C.green}✔ npm:${C.reset} ${npmVersion}`);
+  } catch {
+    console.log(`${C.yellow}⚠ Could not detect npm version${C.reset}`);
+  }
 
-    // Node
-    try {
-      const nodeVersion = process.version;
-      console.log(`${C.green}✔ Node:${C.reset} ${nodeVersion}`);
-    } catch {
-      console.log(`${C.red}✖ Node not found${C.reset}`);
-    }
+  try {
+    console.log(`${C.green}✔ Nexa CLI:${C.reset} v${pkg.version}`);
+  } catch {
+    console.log(`${C.yellow}⚠ Could not read CLI version${C.reset}`);
+  }
 
-    // npm
-    try {
-      const npmVersion = execSync("npm -v").toString().trim();
-      console.log(`${C.green}✔ npm:${C.reset} ${npmVersion}`);
-    } catch {
-      console.log(`${C.red}✖ npm not found${C.reset}`);
-    }
+  const cwd = process.cwd();
 
-    // CLI version
-    try {
-      const pkg = JSON.parse(
-        fs.readFileSync(path.join(__dirname, "../package.json"), "utf8"),
-      );
-      console.log(`${C.green}✔ Nexa CLI:${C.reset} v${pkg.version}`);
-    } catch {
-      console.log(`${C.yellow}⚠ Could not read CLI version${C.reset}`);
-    }
+  console.log(`\n${C.cyan}Project Checks:${C.reset}\n`);
 
-    const cwd = process.cwd();
+  const packageJsonPath = path.join(cwd, "package.json");
+  const nodeModulesPath = path.join(cwd, "node_modules");
+  const srcPath = path.join(cwd, "src");
+  const nexaConfigPath = path.join(cwd, "nexa.config.js");
+  const indexHtmlPath = path.join(cwd, "index.html");
+  const manifestPath = path.join(cwd, "public", "manifest.json");
 
-    console.log(`\n${C.cyan}Project Checks:${C.reset}\n`);
+  if (fs.existsSync(packageJsonPath)) {
+    console.log(`${C.green}✔ package.json found${C.reset}`);
+  } else {
+    console.log(`${C.yellow}⚠ package.json missing${C.reset}`);
+  }
 
-    // package.json
-    if (fs.existsSync(path.join(cwd, "package.json"))) {
-      console.log(`${C.green}✔ package.json found${C.reset}`);
-    } else {
-      console.log(`${C.red}✖ package.json missing${C.reset}`);
+  if (fs.existsSync(nodeModulesPath)) {
+    console.log(`${C.green}✔ node_modules installed${C.reset}`);
+  } else {
+    console.log(`${C.yellow}⚠ node_modules missing${C.reset}`);
+    if (fix && fs.existsSync(packageJsonPath)) {
+      try {
+        console.log(`${C.blue}🔧 Running npm install...${C.reset}`);
+        execSync("npm install", { stdio: "inherit", cwd });
+        console.log(`${C.green}✔ node_modules installed${C.reset}`);
+      } catch {
+        console.log(`${C.yellow}⚠ Failed to install dependencies${C.reset}`);
+      }
     }
+  }
 
-    // node_modules
-    if (fs.existsSync(path.join(cwd, "node_modules"))) {
-      console.log(`${C.green}✔ node_modules installed${C.reset}`);
-    } else {
-      console.log(
-        `${C.yellow}⚠ node_modules missing (run npm install)${C.reset}`,
-      );
-    }
+  if (fs.existsSync(srcPath)) {
+    console.log(`${C.green}✔ src folder found${C.reset}`);
+  } else {
+    console.log(`${C.yellow}⚠ src folder missing${C.reset}`);
+  }
 
-    // src
-    if (fs.existsSync(path.join(cwd, "src"))) {
-      console.log(`${C.green}✔ src folder found${C.reset}`);
-    } else {
-      console.log(`${C.red}✖ src folder missing${C.reset}`);
+  if (fs.existsSync(nexaConfigPath)) {
+    console.log(`${C.green}✔ nexa.config.js found${C.reset}`);
+  } else {
+    console.log(`${C.yellow}⚠ nexa.config.js missing${C.reset}`);
+    if (fix) {
+      try {
+        console.log(`${C.blue}🔧 Creating nexa.config.js...${C.reset}`);
+        createDefaultNexaConfig(cwd);
+        console.log(`${C.green}✔ nexa.config.js created${C.reset}`);
+      } catch {
+        console.log(`${C.yellow}⚠ Failed to create nexa.config.js${C.reset}`);
+      }
     }
+  }
 
-    // nexa.config.js
-    if (fs.existsSync(path.join(cwd, "nexa.config.js"))) {
-      console.log(`${C.green}✔ nexa.config.js found${C.reset}`);
-    } else {
-      console.log(`${C.yellow}⚠ nexa.config.js missing${C.reset}`);
-    }
+  if (fs.existsSync(indexHtmlPath)) {
+    console.log(`${C.green}✔ index.html found${C.reset}`);
+  } else {
+    console.log(`${C.yellow}⚠ index.html missing${C.reset}`);
+  }
 
-    // index.html
-    if (fs.existsSync(path.join(cwd, "index.html"))) {
-      console.log(`${C.green}✔ index.html found${C.reset}`);
-    } else {
-      console.log(`${C.red}✖ index.html missing${C.reset}`);
+  if (fs.existsSync(manifestPath)) {
+    console.log(`${C.green}✔ manifest.json found${C.reset}`);
+  } else {
+    console.log(`${C.yellow}⚠ manifest.json missing${C.reset}`);
+    if (fix) {
+      try {
+        console.log(`${C.blue}🔧 Creating manifest.json...${C.reset}`);
+        createDefaultManifest(cwd);
+        console.log(`${C.green}✔ manifest.json created${C.reset}`);
+      } catch {
+        console.log(`${C.yellow}⚠ Failed to create manifest.json${C.reset}`);
+      }
     }
+  }
 
-    // manifest
-    if (fs.existsSync(path.join(cwd, "public", "manifest.json"))) {
-      console.log(`${C.green}✔ manifest.json found${C.reset}`);
-    } else {
-      console.log(`${C.yellow}⚠ manifest.json missing${C.reset}`);
-    }
+  console.log(`\n${C.green}${C.bold}Doctor check complete ✔${C.reset}\n`);
+}
+/**
+ * Purpose: Parse command arguments and support:
+ *   nexa new app my-app
+ *   nexa new my-app
+ *   nexa app my-app
+ */
+function parseArgs(argv) {
+  const baseFlagValue = getFlagValue(argv, "--base");
+  const base = normalizeBase(baseFlagValue || "/");
+  const fix = argv.includes("--fix");
 
-    console.log(`\n${C.green}${C.bold}Doctor check complete ✔${C.reset}\n`);
+  const filtered = [];
+  for (let i = 0; i < argv.length; i++) {
+    if (argv[i] === "--base") {
+      i++;
+      continue;
+    }
+    if (argv[i] === "--fix") {
+      continue;
+    }
+    filtered.push(argv[i]);
   }
 
   const first = filtered[0];
   const second = filtered[1];
   const third = filtered[2];
 
-  if (first === "doctor") {
-    runDoctor();
-    process.exit(0);
-  }
-  if (first === "doctor") {
-    runDoctor();
-    return;
+  if (!first) {
+    printUsage();
+    process.exit(1);
   }
 
   if (first === "help" || first === "--help" || first === "-h") {
@@ -1315,6 +1397,14 @@ function parseArgs(argv) {
     process.exit(0);
   }
 
+  if (first === "doctor") {
+    return {
+      shortcut: "doctor",
+      fix,
+      base,
+    };
+  }
+
   if (first === "version" || first === "--version" || first === "-v") {
     console.log(`Nexa CLI v${pkg.version}`);
     process.exit(0);
@@ -1325,6 +1415,7 @@ function parseArgs(argv) {
       shortcut: second,
       name: third,
       base,
+      fix,
     };
   }
 
@@ -1337,6 +1428,7 @@ function parseArgs(argv) {
       shortcut: "app",
       name: second,
       base,
+      fix,
     };
   }
 
@@ -1345,6 +1437,7 @@ function parseArgs(argv) {
       shortcut: first,
       name: second,
       base,
+      fix,
     };
   }
 
@@ -1358,6 +1451,7 @@ function parseArgs(argv) {
       "cc",
       "svc",
       "ctx",
+      "doctor",
       "help",
       "--help",
       "-h",
@@ -1370,6 +1464,7 @@ function parseArgs(argv) {
       shortcut: "app",
       name: first,
       base,
+      fix,
     };
   }
 
@@ -1377,7 +1472,7 @@ function parseArgs(argv) {
   process.exit(1);
 }
 
-const { shortcut, name, base } = parseArgs(args);
+const { shortcut, name, base, fix } = parseArgs(args);
 
 async function main() {
   switch (shortcut) {
@@ -1416,6 +1511,10 @@ async function main() {
       await createApp(name, base);
       break;
 
+    case "doctor":
+      runDoctor({ fix });
+      break;
+
     default:
       console.error(`${C.yellow}❌ Unknown shortcut.${C.reset}`);
       printUsage();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-nexa-app",
-  "version": "1.0.11",
+  "version": "1.0.12",
   "description": "Create a new Nexa app with prebuilt structure, PWA support, and modern React/Vite setup",
   "bin": {
     "create-nexa-app": "bin/nexa.js",