create-nexa-app 1.0.10 → 1.0.12

package/bin/nexa.js

@@ -202,6 +202,12 @@ ${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.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}
+
+  
 `);
 }
 /**
@@ -1194,6 +1200,166 @@ function getFlagValue(argv, flagName) {
   return argv[index + 1] ?? null;
 }
 
+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.
+ */
+
+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}`);
+  }
+
+  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}`);
+  }
+
+  try {
+    console.log(`${C.green}✔ Nexa CLI:${C.reset} v${pkg.version}`);
+  } catch {
+    console.log(`${C.yellow}⚠ Could not read CLI version${C.reset}`);
+  }
+
+  const cwd = process.cwd();
+
+  console.log(`\n${C.cyan}Project Checks:${C.reset}\n`);
+
+  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");
+
+  if (fs.existsSync(packageJsonPath)) {
+    console.log(`${C.green}✔ package.json found${C.reset}`);
+  } else {
+    console.log(`${C.yellow}⚠ 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}`);
+      }
+    }
+  }
+
+  if (fs.existsSync(srcPath)) {
+    console.log(`${C.green}✔ src folder found${C.reset}`);
+  } else {
+    console.log(`${C.yellow}⚠ 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}`);
+      }
+    }
+  }
+
+  if (fs.existsSync(indexHtmlPath)) {
+    console.log(`${C.green}✔ index.html found${C.reset}`);
+  } else {
+    console.log(`${C.yellow}⚠ 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}`);
+      }
+    }
+  }
+
+  console.log(`\n${C.green}${C.bold}Doctor check complete ✔${C.reset}\n`);
+}
 /**
  * Purpose: Parse command arguments and support:
  *   nexa new app my-app
@@ -1203,6 +1369,7 @@ function getFlagValue(argv, flagName) {
 function parseArgs(argv) {
   const baseFlagValue = getFlagValue(argv, "--base");
   const base = normalizeBase(baseFlagValue || "/");
+  const fix = argv.includes("--fix");
 
   const filtered = [];
   for (let i = 0; i < argv.length; i++) {
@@ -1210,6 +1377,9 @@ function parseArgs(argv) {
       i++;
       continue;
     }
+    if (argv[i] === "--fix") {
+      continue;
+    }
     filtered.push(argv[i]);
   }
 
@@ -1227,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);
@@ -1237,6 +1415,7 @@ function parseArgs(argv) {
       shortcut: second,
       name: third,
       base,
+      fix,
     };
   }
 
@@ -1249,6 +1428,7 @@ function parseArgs(argv) {
       shortcut: "app",
       name: second,
       base,
+      fix,
     };
   }
 
@@ -1257,6 +1437,7 @@ function parseArgs(argv) {
       shortcut: first,
       name: second,
       base,
+      fix,
     };
   }
 
@@ -1270,6 +1451,7 @@ function parseArgs(argv) {
       "cc",
       "svc",
       "ctx",
+      "doctor",
       "help",
       "--help",
       "-h",
@@ -1282,6 +1464,7 @@ function parseArgs(argv) {
       shortcut: "app",
       name: first,
       base,
+      fix,
     };
   }
 
@@ -1289,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) {
@@ -1328,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.10",
+  "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",